All of lore.kernel.org
 help / color / mirror / Atom feed
From: "Krzysztof Żelechowski" <giecrilj@stegny.2a.pl>
To: Christopher Yeleighton via GitGitGadget <gitgitgadget@gmail.com>,
	git@vger.kernel.org, Bagas Sanjaya <bagasdotme@gmail.com>
Cc: Christopher Yeleighton <ne01026@shark.2a.pl>
Subject: [PATCH v2] pretty-options.txt: describe supported encoding
Date: Fri, 27 Aug 2021 13:51:34 +0200	[thread overview]
Message-ID: <2247912.lYO0ccLKhl@localhost.localdomain> (raw)
In-Reply-To: <0877bb5d-da4b-125d-7beb-c3138903f468@gmail.com>

git log recognises only system encodings supported by iconv(1), but not 
POSIX character maps used by iconv(1p). Document it.

Signed-off-by:  <ne01026@shark.2a.pl>

diff --git a/Documentation/pretty-options.txt b/Documentation/pretty-
options.txt
index 27ddaf84a19..4f8376d681b 100644
--- a/Documentation/pretty-options.txt
+++ b/Documentation/pretty-options.txt
@@ -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.
 



  parent reply	other threads:[~2021-08-27 11:51 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-08-26 21:34 [PATCH] pretty-options.txt: describe supported encoding Christopher Yeleighton via GitGitGadget
2021-08-27 10:46 ` Bagas Sanjaya
2021-08-27 11:47   ` Krzysztof Żelechowski
2021-08-27 11:51   ` Krzysztof Żelechowski [this message]
2021-08-27 17:03     ` [PATCH v2] " Junio C Hamano
2021-08-27 18:03       ` Jeff King
2021-08-27 23:20       ` Krzysztof Żelechowski

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=2247912.lYO0ccLKhl@localhost.localdomain \
    --to=giecrilj@stegny.2a.pl \
    --cc=bagasdotme@gmail.com \
    --cc=git@vger.kernel.org \
    --cc=gitgitgadget@gmail.com \
    --cc=ne01026@shark.2a.pl \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.