From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 10 Oct 2025 15:52:59 GMT
Subject: Re: [PATCH 1/3] doc: convert git-stash.adoc to synopis style
Message-ID: <xmqqsefqah44.fsf@gitster.g>
In-Reply-To: <bb0f530b-96f3-4655-8448-1d322413cd1f@free.fr>

Jean-Noël Avila <jn.avila@free.fr> writes:

>>> diff --git a/Documentation/config/stash.adoc b/Documentation/config/stash.adoc
>>> index e556105a15..7fc32027f7 100644
>>> --- a/Documentation/config/stash.adoc
>>> +++ b/Documentation/config/stash.adoc
>>> @@ -1,19 +1,28 @@
>>> -stash.index::
>>> +ifndef::git-stash[]
>>> +:see-show: See the description of the 'show' command in linkgit:git-stash[1].
>> 
>> Okay, here you use 'show' and not `show` because this conditional
>> attribute will pass on `show` and render it as such, not as
>> inline-verbatim “show”. Bare 'show' is indeed better than bare `show`.
>
> TBH I did not spot the issue when I did this. I wasn't aware that
> Asciidoc does not automatically handle inline formatting in attributes.
> But it seems we can force it. This "show" keyword should definitely be
> inline verbatim.
>
> Wil try and reroll.

This is already in 'next', isn't it, though?