Document that 'git add -A/--all' can remove files no longer present in the working tree from the index, and also document the behavior with and without path arguments on the command line. Also update the intro paragraph (as suggested by Junio, with some minor edits) to make it clear that 'git add' is able to delete and to also cover the -p option. Signed-off-by: Björn Gustavsson <bgustavsson@xxxxxxxxx> --- Thanks, Junio, for reviewing my patch, and for suggesting a much better intro paragraph. I have cut out the mention of rsync and the reference from git-rm. I also realized that the documentation was not clear on whether any path arguments were allowed, so I have clarified that too. Documentation/git-add.txt | 20 ++++++++++++++------ 1 files changed, 14 insertions(+), 6 deletions(-) diff --git a/Documentation/git-add.txt b/Documentation/git-add.txt index e93e606..6d3e76f 100644 --- a/Documentation/git-add.txt +++ b/Documentation/git-add.txt @@ -14,8 +14,12 @@ SYNOPSIS DESCRIPTION ----------- -This command adds the current content of new or modified files to the -index, thus staging that content for inclusion in the next commit. +This command updates the index using the current content found in +the working tree, to prepare the content staged for the next commit. +It typically adds the current content of existing paths as a whole, +but with some options it can also be used to add content with +only part of the changes made to the working tree files applied, or +remove paths that do not exist in the work tree anymore. The "index" holds a snapshot of the content of the working tree, and it is this snapshot that is taken as the contents of the next commit. Thus @@ -102,10 +106,14 @@ apply. -A:: --all:: - Update files that git already knows about (same as '\--update') - and add all untracked files that are not ignored by '.gitignore' - mechanism. - + Update files that git already knows about (same as '\--update'), + add all untracked files that are not ignored by the '.gitignore' + mechanism and remove files from the index that are no longer + present in the working tree. ++ +If no paths are given on the command line, `git add -A` will operate +on the current directory and its subdirectories. If paths are given, +it will operate on those paths and their subdirectories. -N:: --intent-to-add:: -- 1.6.6.rc1.31.g1a56b -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html