Re: [PATCH 2/2] doc: apply new format to git-branch man page

From: Junio C Hamano <gitster@pobox.com>
Date: Mar 17, 2025, 21:34 UTC
Message-ID: <xmqqjz8n8hol.fsf@gitster.g>
In-Reply-To: <b2e7867006e1800eb6dc52902006998afd5800cc.1742056310.git.gitgitgadget@gmail.com>

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

Show 8 quoted lines

> From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= <jn.avila@free.fr>
>
> - Switch the synopsis to a synopsis block which automatically
>   formats placeholders in italics and keywords in monospace
> - Use _<placeholder>_ instead of <placeholder> in the description
> - Use `backticks` for keywords and more complex option
> descriptions. The new rendering engine applies synopsis rules to
> these spans.

And the one effective reformatting in this patch that is not covered by the list is that the possible values for some variables, that were mentioned in the description prose, are now made into enumerated list.

Nicely done.