aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/git-ls-files.txt
diff options
context:
space:
mode:
authorElijah Newren <newren@gmail.com>2023-01-13 04:41:54 +0000
committerJunio C Hamano <gitster@pobox.com>2023-01-13 11:55:17 -0800
commite750951e74fc3fc2b40a8601b70cdf6e69ec6cf2 (patch)
treeb876f047c82e5da3246ed7b78ec0d7887a3d6083 /Documentation/git-ls-files.txt
parent4173b806c75dbcf4406c7a5ad6158dcbfa2beb2f (diff)
downloadgit-e750951e74fc3fc2b40a8601b70cdf6e69ec6cf2.tar.gz
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>
Diffstat (limited to 'Documentation/git-ls-files.txt')
-rw-r--r--Documentation/git-ls-files.txt7
1 files changed, 5 insertions, 2 deletions
diff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt
index 3886d58d17..1abdd3c21c 100644
--- a/Documentation/git-ls-files.txt
+++ b/Documentation/git-ls-files.txt
@@ -119,7 +119,8 @@ OPTIONS
--exclude-per-directory=<file>::
Read additional exclude patterns that apply only to the
- directory and its subdirectories in <file>.
+ directory and its subdirectories in <file>. Deprecated; use
+ --exclude-standard instead.
--exclude-standard::
Add the standard Git exclusions: .git/info/exclude, .gitignore
@@ -291,7 +292,9 @@ traversing the directory tree and finding files to show when the
flags --others or --ignored are specified. linkgit:gitignore[5]
specifies the format of exclude patterns.
-These exclude patterns come from these places, in order:
+Generally, you should just use --exclude-standard, but for historical
+reasons the exclude patterns can be specified from the following
+places, in order:
1. The command-line flag --exclude=<pattern> specifies a
single pattern. Patterns are ordered in the same order