Re: [PATCH v3 0/9] doc: convert git log man page to new synopsis format

From: Junio C Hamano <gitster@pobox.com>
Date: Jul 7, 2025, 20:59 UTC
Message-ID: <xmqqzfdf3efc.fsf@gitster.g>
In-Reply-To: <pull.1933.v3.git.1751914412.gitgitgadget@gmail.com>

"Jean-Noël Avila via GitGitGadget" <gitgitgadget@gmail.com> writes:

Show 14 quoted lines

> This series converts the man page of git log to the synopsis format style.
> Git log is the second largest manpage after git config, which makes the
> changes quite large.
>
> A special note about the log format description which required escaping the
> synopsis processing of parentheses.
>
> Changes since V1:
>
>  * rework the grammar style when refering to plural placeholders . The text
>    is more descriptive and does not rely on puns. Puns may be difficult to
>    understand and to translate.
>  * change commit message to reflect the conversion of inline description of
>    several option to a list.

Changes since v2 is a minor but necessary mark-up fix, as we do not want to leave `enclosing` mark-up elements unclosed.

Will queue.  Shall we mark the topic for 'next' now?

Thanks.