From: Adam Johnson via GitGitGadget Date: Sat, 11 Mar 2023 09:19:15 GMT Subject: [PATCH] ls-files: document that pathspecs are supported Message-ID: From: Adam Johnson The command has taken pathspecs, not just filenames, since f0096c06bcd (Convert read_tree{,_recursive} to support struct pathspec, 2011-03-25). Signed-off-by: Adam Johnson --- ls-files: document that pathspecs are supported The command has taken pathspecs, not just filenames, since f0096c06bcd (Convert read_tree{,_recursive} to support struct pathspec, 2011-03-25). Signed-off-by: Adam Johnson me@adamj.eu Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-1466%2Fadamchainz%2Fdoc-ls-files-pathspecs-v1 Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-1466/adamchainz/doc-ls-files-pathspecs-v1 Pull-Request: https://github.com/git/git/pull/1466 Documentation/git-ls-files.txt | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt index 1abdd3c21c5..2f62374062c 100644 --- a/Documentation/git-ls-files.txt +++ b/Documentation/git-ls-files.txt @@ -21,7 +21,7 @@ SYNOPSIS [--exclude-standard] [--error-unmatch] [--with-tree=] [--full-name] [--recurse-submodules] - [--abbrev[=]] [--format=] [--] [...] + [--abbrev[=]] [--format=] [--] [...] DESCRIPTION ----------- @@ -127,12 +127,12 @@ OPTIONS in each directory, and the user's global exclusion file. --error-unmatch:: - If any does not appear in the index, treat this as an + If any does not appear in the index, treat this as an error (return 1). --with-tree=:: When using --error-unmatch to expand the user supplied - (i.e. path pattern) arguments to paths, pretend + (i.e. path pattern) arguments to paths, pretend that paths which were removed in the index since the named are still present. Using this option with `-s` or `-u` options does not make any sense. @@ -225,9 +225,12 @@ followed by the ("attr/"). \--:: Do not interpret any more arguments as options. -:: +:: Files to show. If no files are given all files which match the other specified criteria are shown. ++ +For details on the syntax, see the 'pathspec' entry in +linkgit:gitglossary[7]. OUTPUT ------ base-commit: 725f57037d81e24eacfda6e59a19c60c0b4c8062 -- gitgitgadget