threads / patch / 9559

patchClarify actual behavior of 'git add' and ignored files

Subject: [PATCH] Clarify actual behavior of 'git add' and ignored files

## tl;dr

One message between Aug 16, 2007 and Aug 16, 2007. Diffs are folded; open one to read it.

replies: 0people: 1as markdown or json

Brian Downing· Aug 16, 2007, 22:56 UTC · lore
Signed-off-by: Brian Downing <bdowning@lavos.net>
---
 Documentation/git-add.txt |   10 ++++++----
 1 files changed, 6 insertions(+), 4 deletions(-)
Show changes to Documentation/git-add.txt +6 −4
diff --git a/Documentation/git-add.txt b/Documentation/git-add.txt
index dee38f8..3383aca 100644
--- a/Documentation/git-add.txt
+++ b/Documentation/git-add.txt
@@ -28,10 +28,12 @@ you must run 'git add' again to add the new content to the index.
 The 'git status' command can be used to obtain a summary of which
 files have changes that are staged for the next commit.
 
-The 'add' command can be used to add ignored files with `-f` (force)
-option, but they have to be explicitly and exactly specified from the
-command line.  File globbing and recursive behaviour do not add ignored
-files.
+The 'git add' command will not add ignored files by default.  If any
+ignored files were explicitly specified on the command line, 'git add'
+will fail with a list of ignored files.  Ignored files reached by
+directory recursion or filename globbing will be silently ignored.
+The 'add' command can be used to add ignored files with the `-f`
+(force) option.
 
 Please see gitlink:git-commit[1] for alternative ways to add content to a
 commit.
-- 
1.5.3.GIT

← back to recent threads