Subject: Re: [PATCH v4 5/5] format-rev: introduce builtin for on-demand pretty formatting

From: "Kristoffer Haugsbakk" <[email-masked]>
Date: Mon, 11 May 2026 15:25:57 +0200

On Thu, May 7, 2026, at 21:34, [email-masked] wrote:
> From: Kristoffer Haugsbakk <[email-masked]>
>
> Introduce a new builtin for pretty formatting one revision expression
> per line or commit object names found in running text.
>
>[snip]
>
> diff --git a/Documentation/git-format-rev.adoc
>[snip]
> +OPTIONS
> +-------
> +
> +`--stdin-mode=<mode>`::
> +	How to interpret standard input data:
> ++
> +--
> +`revs`:: Each line or record (see the <<io,INPUT AND OUTPUT FORMATS>>
> +	section) is interpreted as a commit. Any kind of revision
> +	expression can be used (see linkgit:gitrevisions[7]). Annotated
> +	tags are peeled (see linkgit:gitglossary[7]).
> ++
> +The argument `rev` is also accepted.
> +`text`:: Formats all commit object names found in freeform text. These
> +	must the full object names, i.e. abbreviated hexidecimal object
> +	names will not be interpreted.
> ++
> +Anything that is parsed as an object name but that is not found to be a
> +commit object name is left alone (echoed).
> +--

This nested definition list is malformed. I’ll need to fix that.

> +
> +`--format=<pretty>`::
> +	Pretty format string.
>[snip]