[PATCH] Port GCC documentation to Sphinx

Martin Liška mliska@suse.cz
Thu Jul 1 12:31:32 GMT 2021


On 6/30/21 5:43 PM, Eli Zaretskii wrote:
>> Cc: joseph@codesourcery.com, gcc@gcc.gnu.org, gcc-patches@gcc.gnu.org
>> From: Martin Liška <mliska@suse.cz>
>> Date: Wed, 30 Jun 2021 16:04:32 +0200
>>
>>> Thanks, but does that mean @var will no longer stand out in the
>>> produced Info format?  That'd be sub-optimal, I think, because a clear
>>> reference to a meta-syntactic variable will be lost.
>>
>> Yes. An alternative approach for:
>> Show :samp:`Samp with a {variable}.`
>>
>> can be using @var{variable}, resulting with the following info output:
>> Show ‘Samp with a VARIABLE.’
>>
>> Does it seem reasonable?
> 
> Yes, the latter sounds reasonable.
> 
> Thanks.
> 

Good, I modified the existing pull request for it:
https://github.com/sphinx-doc/sphinx/pull/9391

Martin


More information about the Gcc mailing list