wrapper.c: add and use fopen_or_warn()

diff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt
index ea01d45e5c49a80cf73aec062ef0f6f6471df9d9..d153c17e0660d8ab9edb0b10a53172007d355510 100644 (file)
--- a/Documentation/git-ls-files.txt
+++ b/Documentation/git-ls-files.txt
@@ -57,7 +57,7 @@ OPTIONS
 
 -s::
 --stage::
-       Show staged contents' object name, mode bits and stage number in the output.
+       Show staged contents' mode bits, object name and stage number in the output.
 
 --directory::
        If a whole directory is classified as "other", show just its
@@ -77,7 +77,8 @@ OPTIONS
        succeed.
 
 -z::
-       \0 line termination on output.
+       \0 line termination on output and do not quote filenames.
+       See OUTPUT below for more information.
 
 -x <pattern>::
 --exclude=<pattern>::
@@ -140,8 +141,7 @@ a space) at the start of each line:
 
 --recurse-submodules::
        Recursively calls ls-files on each submodule in the repository.
-       Currently there is only support for the --cached mode without a
-       pathspec.
+       Currently there is only support for the --cached mode.
 
 --abbrev[=<n>]::
        Instead of showing the full 40-byte hexadecimal object
@@ -197,9 +197,10 @@ the index records up to three such pairs; one from tree O in stage
 the user (or the porcelain) to see what should eventually be recorded at the
 path. (see linkgit:git-read-tree[1] for more information on state)
 
-When `-z` option is not used, TAB, LF, and backslash characters
-in pathnames are represented as `\t`, `\n`, and `\\`,
-respectively.
+Without the `-z` option, pathnames with "unusual" characters are
+quoted as explained for the configuration variable `core.quotePath`
+(see linkgit:git-config[1]).  Using `-z` the filename is output
+verbatim and the line is terminated by a NUL byte.
 
 
 Exclude Patterns