[PATCH] Port GCC documentation to Sphinx
Wed Jun 30 13:28:40 GMT 2021
On 6/29/21 6:57 PM, Eli Zaretskii wrote:
> 2. The translation of @var produces double-quoting in Info, here's an
> The usual way to run GCC is to run the executable called ‘gcc’, or
> ‘`machine'-gcc’ when cross-compiling, or ‘`machine'-gcc-`version'’ to
> run a specific version of GCC.
> vs, the old
> The usual way to run GCC is to run the executable called 'gcc', or
> 'MACHINE-gcc' when cross-compiling, or 'MACHINE-gcc-VERSION' to run a
> specific version of GCC.
> I think the new variant is less readable and more confusing, because
> it isn't clear whether the quotes are part of the text. Here's an
> extreme example:
> 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:
More information about the Gcc-patches