[PATCH] Port GCC documentation to Sphinx

Martin Liška mliska@suse.cz
Wed Jun 30 14:04:32 GMT 2021


On 6/30/21 3:38 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 15:28:40 +0200
>>
>>>     ‘@`file'’
>>>
>>>          Read command-line options from ‘`file'’.  The options read are
>>>          inserted in place of the original ‘@`file'’ option.  If ‘`file'’
>>>          does not exist, or cannot be read, then the option will be treated
>>>          literally, and not removed.
>>
>> For this one, I've just created the following pull request:
>> https://github.com/sphinx-doc/sphinx/pull/9391
> 
> 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?
Thanks,
Martin





More information about the Gcc-patches mailing list