ls-files: guide folks to --exclude-standard over other --exclude* options
Signed-off-by: Elijah Newren <newren@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Elijah Newren committed
Jan 13, 2023 at 04:41 UTC
e750951e74fc3fc2b40a8601b70cdf6e69ec6cf2
1 file changed
+5
-2
Documentation/git-ls-files.txt
+5
-2
@@ -119,7 +119,8 @@ OPTIONS
119
120
--exclude-per-directory=<file>::
121
Read additional exclude patterns that apply only to the
122
- directory and its subdirectories in <file>.
122
+ directory and its subdirectories in <file>. Deprecated; use
123
+ --exclude-standard instead.
124
125
--exclude-standard::
126
Add the standard Git exclusions: .git/info/exclude, .gitignore
@@ -291,7 +292,9 @@ traversing the directory tree and finding files to show when the
292
flags --others or --ignored are specified. linkgit:gitignore[5]
293
specifies the format of exclude patterns.
294
294
-These exclude patterns come from these places, in order:
295
+Generally, you should just use --exclude-standard, but for historical
296
+reasons the exclude patterns can be specified from the following
297
+places, in order:
298
299
1. The command-line flag --exclude=<pattern> specifies a
300
single pattern. Patterns are ordered in the same order