doc: clarify the filename encoding in git diff

AFAICT parsing the output of `git diff --name-only master...feature`
is the intended way of programmatically getting the list of files
modified
by a feature branch. It is impossible to parse text unless you know what
encoding it is in. The output encoding of diff --name-only and

Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Andrey Bienkowski 2021-04-20 11:24:37 +00:00 committed by Junio C Hamano
parent 48bf2fa8ba
commit 9364bf465d
1 changed files with 4 additions and 1 deletions

View File

@ -293,11 +293,14 @@ explained for the configuration variable `core.quotePath` (see
linkgit:git-config[1]). linkgit:git-config[1]).


--name-only:: --name-only::
Show only names of changed files. Show only names of changed files. The file names are often encoded in UTF-8.
For more information see the discussion about encoding in the linkgit:git-log[1]
manual page.


--name-status:: --name-status::
Show only names and status of changed files. See the description Show only names and status of changed files. See the description
of the `--diff-filter` option on what the status letters mean. of the `--diff-filter` option on what the status letters mean.
Just like `--name-only` the file names are often encoded in UTF-8.


--submodule[=<format>]:: --submodule[=<format>]::
Specify how differences in submodules are shown. When specifying Specify how differences in submodules are shown. When specifying