Re: [PATCH v3 2/2] doc: format-rev: use [synopsis] on code block
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Aug 14, 2026, 01:01 UTC
- Message-ID
- <xmqqfr0hqzvl.fsf@gitster.g>
- In-Reply-To
- <V3_synopsis_block.b66@msgid.xyz>
kristofferhaugsbakk@fastmail.com writes:
Show 22 quoted lines
> From: Kristoffer Haugsbakk <code@khaugsbakk.name> > > This code block uses the placeholder `<subject>`. Let’s highlight this > placeholder properly by using the `synopsis` block definition which was > introduced in a34d1d53 (doc: convert git-show to synopsis style, > 2026-02-06). > > Yes, note that code blocks since commit a34d1d53 can, on synopsis-style > docs like this one, be immediately preceded by `[synopsis]`, just like > the command synopsis is: > > [synopsis] > (EXPERIMENTAL!) git format-rev - [...] > > Cf. verse-style: > > [verse] > 'git name-rev' [...] > > Acked-by: Patrick Steinhardt <ps@pks.im> > Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name> > ---
Has this been tested with both AsciiDoc and AsciiDoctor?
https://github.com/git/git/actions/runs/31751206776/job/94617158587#step:4:4886
Curiously, it does not fail for me locally (by default my builds use AsciiDoctor).