undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

log: document --encoding behavior on iconv() failure

Browse Source 
We already note that we may produce invalid output when we skip calling
iconv() altogether. But we may also do so if iconv() fails, and we have
no good alternative. Let's document this to avoid surprising users.

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Jeff King 2021-10-29 17:10:03 -04:00 committed by Junio C Hamano
parent 0988e665e9
commit 9e8fe7b1c7
1 changed files with 3 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Documentation/pretty-options.txt
View File

@ -40,7 +40,9 @@ people using 80-column terminals.
defaults to UTF-8. Note that if an object claims to be encoded 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 in `X` and we are outputting in `X`, we will output the object
verbatim; this means that invalid sequences in the original verbatim; this means that invalid sequences in the original
commit may be copied to the output. commit may be copied to the output. Likewise, if iconv(3) fails
to convert the commit, we will quietly output the original
object verbatim.
--expand-tabs=<n>:: --expand-tabs=<n>::
--expand-tabs:: --expand-tabs::