Clarify actual behavior of 'git add' and ignored files
Signed-off-by: Brian Downing <bdowning@lavos.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Brian Downing committed
Aug 16, 2007 at 17:56 UTC
d1d028ea16af27158f5d77154cfa60dbd9143314
1 file changed
+6
-4
Documentation/git-add.txt
+6
-4
@@ -28,10 +28,12 @@ you must run 'git add' again to add the new content to the index.
28
The 'git status' command can be used to obtain a summary of which
29
files have changes that are staged for the next commit.
30
31
-The 'add' command can be used to add ignored files with `-f` (force)
32
-option, but they have to be explicitly and exactly specified from the
33
-command line. File globbing and recursive behaviour do not add ignored
34
-files.
31
+The 'git add' command will not add ignored files by default. If any
32
+ignored files were explicitly specified on the command line, 'git add'
33
+will fail with a list of ignored files. Ignored files reached by
34
+directory recursion or filename globbing will be silently ignored.
35
+The 'add' command can be used to add ignored files with the `-f`
36
+(force) option.
37
38
Please see gitlink:git-commit[1] for alternative ways to add content to a
39
commit.