diff options
author | Andreas Heiduk <asheiduk@gmail.com> | 2017-03-02 20:03:52 +0100 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2017-03-02 11:40:51 -0800 |
commit | 860cd699c285f02937a2edbdb78e8231292339a5 (patch) | |
tree | 9864d172cd90185f4af9c7ffcd218f8f50cf4a0e /Documentation/git-ls-files.txt | |
parent | 3bc53220cb2dcf709f7a027a3f526befd021d858 (diff) | |
download | git-860cd699c285f02937a2edbdb78e8231292339a5.tar.gz |
Documentation: improve description for core.quotePathah/doc-ls-files-quotepath
Linking the description for pathname quoting to the configuration
variable "core.quotePath" removes inconstistent and incomplete
sections while also giving two hints how to deal with it: Either with
"-c core.quotePath=false" or with "-z".
Signed-off-by: Andreas Heiduk <asheiduk@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.txt | 10 |
1 files changed, 6 insertions, 4 deletions
diff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt index 446209e206..1cab703f73 100644 --- a/Documentation/git-ls-files.txt +++ b/Documentation/git-ls-files.txt @@ -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>:: @@ -196,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 |