Document ls-files --with-tree=<tree-ish>

Signed-off-by: Junio C Hamano <gitster@pobox.com>

diff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt
index 997594549fbf5a1e50a7d187c3cebcbe93461455..9e454f0a4da465606afbed1720b7bd10cca8b241 100644 (file)
--- a/Documentation/git-ls-files.txt
+++ b/Documentation/git-ls-files.txt
@@ -15,7 +15,7 @@ SYNOPSIS
                [-x <pattern>|--exclude=<pattern>]
                [-X <file>|--exclude-from=<file>]
                [--exclude-per-directory=<file>]
                [-x <pattern>|--exclude=<pattern>]
                [-X <file>|--exclude-from=<file>]
                [--exclude-per-directory=<file>]

-               [--error-unmatch]
+               [--error-unmatch] [--with-tree=<tree-ish>]

                [--full-name] [--abbrev] [--] [<file>]\*
 
 DESCRIPTION
                [--full-name] [--abbrev] [--] [<file>]\*
 
 DESCRIPTION


@@ -81,6 +81,13 @@ OPTIONS
        If any <file> does not appear in the index, treat this as an
        error (return 1).
 
        If any <file> does not appear in the index, treat this as an
        error (return 1).
 

+--with-tree=<tree-ish>::
+       When using --error-unmatch to expand the user supplied
+       <file> (i.e. path pattern) arguments to paths, pretend
+       that paths which were removed in the index since the
+       named <tree-ish> are still present.  Using this option
+       with `-s` or `-u` options does not make any sense.
+

 -t::
        Identify the file status with the following tags (followed by
        a space) at the start of each line:
 -t::
        Identify the file status with the following tags (followed by
        a space) at the start of each line: