1
0
Fork 0
mirror of https://github.com/git/git.git synced 2024-05-09 18:26:08 +02:00

pretty-options.txt: describe supported encoding

Please fix the manual for git log.  It should say what encoding is recognised
(namely if supported by iconv(1), except that POSIX character maps of
iconv(1p) are not supported), and that an unrecognised encoding is ignored.

Signed-off-by:  <ne01026@shark.2a.pl>
This commit is contained in:
Christopher Yeleighton 2021-08-26 19:49:08 +02:00 committed by Krzysztof Żelechowski
parent c4203212e3
commit d50e273e1b

View File

@ -36,9 +36,13 @@ people using 80-column terminals.
The commit objects record the encoding used for the log message
in their encoding header; this option can be used to tell the
command to re-code the commit log message in the encoding
preferred by the user. For non plumbing commands this
defaults to UTF-8. Note that if an object claims to be encoded
in `X` and we are outputting in `X`, we will output the object
preferred by the user.
The encoding must be a system encoding supported by iconv(1),
otherwise this option will be ignored.
POSIX character maps used by iconv(1p) are not supported.
For non-plumbing commands this defaults to UTF-8.
Note that if an object claims to be encoded in `X`
and we are outputting in `X`, we shall output the object
verbatim; this means that invalid sequences in the original
commit may be copied to the output.