git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] pretty-options.txt: describe supported encoding

From
Bagas Sanjaya <bagasdotme@gmail.com>
Date
Aug 27, 2021, 10:46 UTC
Message-ID
<0877bb5d-da4b-125d-7beb-c3138903f468@gmail.com>
In-Reply-To
<pull.1079.git.git.1630013668862.gitgitgadget@gmail.com>
On 27/08/21 04.34, Christopher Yeleighton via GitGitGadget wrote:
Show 8 quoted lines
> From: Christopher Yeleighton <ne01026@shark.2a.pl>
> 
> 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>
> ---

The commit message should be: "git log recognizes only system encodings supported by iconv(1), but not POSIX character maps used by iconv(1p). Document it.".

Show 16 quoted lines
>   	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.
>   

I think POSIX character maps and encoding are the same, what are their differences? Reading iconv(1p) [1] doesn't give definition of the former.

[1]: https://man7.org/linux/man-pages/man1/iconv.1p.html
-- 
An old man doll... just what I always wanted! - Clara
Previous: Christopher Yeleighton via GitGitGadgetNext: Krzysztof Żelechowski
Message 2 of 7 in “pretty-options.txt: describe supported encoding”
  1. pretty-options.txt: describe supported encodingChristopher Yeleighton via GitGitGadget, Aug 26, 2021
  2. Bagas SanjayaAug 27, 2021
  3. Krzysztof ŻelechowskiAug 27, 2021
  4. pretty-options.txt: describe supported encodingKrzysztof Żelechowski, Aug 27, 2021
  5. Junio C HamanoAug 27, 2021
  6. Jeff KingAug 27, 2021
  7. Krzysztof ŻelechowskiAug 27, 2021

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.