]> git.ipfire.org Git - thirdparty/git.git/commitdiff
doc: git-add: simplify discussion of ignored files
authorJulia Evans <julia@jvns.ca>
Tue, 19 Aug 2025 20:46:10 +0000 (20:46 +0000)
committerJunio C Hamano <gitster@pobox.com>
Tue, 19 Aug 2025 23:04:54 +0000 (16:04 -0700)
- Mention the --force option earlier
- Remove the explanation of shell globbing vs git's internal glob
  system, since users are confused by it and there's a clearer
  discussion in the EXAMPLES section.

Signed-off-by: Julia Evans <julia@jvns.ca>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-add.adoc

index 19f99b0e7f6f09a3814d8d346b1a40c23f2f60b3..bf793d2894933997ef99ea70352cabd5af7dadd6 100644 (file)
@@ -37,12 +37,10 @@ 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 `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 performed by Git (quote your
-globs before the shell) will be silently ignored.  The `git add` command can
-be used to add ignored files with the `-f` (force) option.
+The `git add` command will not add ignored files by default. You can
+use the `--force` option to add ignored files. If you specify the exact
+filename of an ignored file, `git add` will fail with a list of ignored
+files. Otherwise it will silently ignore the file.
 
 Please see linkgit:git-commit[1] for alternative ways to add content to a
 commit.