From 75609a0d44d02878e6260a7a4bf2dda5310a9dd9 Mon Sep 17 00:00:00 2001 From: Jay Soffian Date: Wed, 15 Sep 2010 19:56:48 -0400 Subject: git-ls-files.txt: clarify -x/--exclude option Since b5227d8, -x/--exclude does not apply to cached files. This is easy to miss unless you read the discussion in the EXCLUDE PATTERNS section. Clarify that the option applies to untracked files and direct the reader to EXCLUDE PATTERNS. Signed-off-by: Jay Soffian Signed-off-by: Junio C Hamano diff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt index 8985915..c05e7a5 100644 --- a/Documentation/git-ls-files.txt +++ b/Documentation/git-ls-files.txt @@ -79,8 +79,9 @@ OPTIONS -x :: --exclude=:: - Skips files matching pattern. - Note that pattern is a shell wildcard pattern. + Skips untracked files matching pattern. + Note that pattern is a shell wildcard pattern. See EXCLUDE PATTERNS + below for more information. -X :: --exclude-from=:: -- cgit v0.10.2-6-g49f6 From 4c608520ed58301de99024e47a0579b058db0a65 Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Wed, 15 Sep 2010 17:34:20 -0700 Subject: ls-files documentation: reword for consistency Similar to descriptions of other options, state what -x does in imperative mood. Start sentences for -X and --exclude-per-directory options in capital letters. Signed-off-by: Junio C Hamano diff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt index c05e7a5..44b6480 100644 --- a/Documentation/git-ls-files.txt +++ b/Documentation/git-ls-files.txt @@ -79,16 +79,16 @@ OPTIONS -x :: --exclude=:: - Skips untracked files matching pattern. + Skip untracked files matching pattern. Note that pattern is a shell wildcard pattern. See EXCLUDE PATTERNS below for more information. -X :: --exclude-from=:: - exclude patterns are read from ; 1 per line. + Read exclude patterns from ; 1 per line. --exclude-per-directory=:: - read additional exclude patterns that apply only to the + Read additional exclude patterns that apply only to the directory and its subdirectories in . --exclude-standard:: @@ -178,7 +178,7 @@ These exclude patterns come from these places, in order: file containing a list of patterns. Patterns are ordered in the same order they appear in the file. - 3. command line flag --exclude-per-directory= specifies + 3. The command line flag --exclude-per-directory= specifies a name of the file in each directory 'git-ls-files' examines, normally `.gitignore`. Files in deeper directories take precedence. Patterns are ordered in the -- cgit v0.10.2-6-g49f6