Re: [PATCH v4 5/5] format-rev: introduce builtin for on-demand pretty formatting
On Thu, May 7, 2026, at 21:34, kristofferhaugsbakk@fastmail.com wrote:
Show 29 quoted lines
> From: Kristoffer Haugsbakk <code@khaugsbakk.name>
>
> 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]
Kristoffer Haugsbakk <code@khaugsbakk.name>