This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: [driver, doc] Support escaping special characters in specs
- From: Rainer Orth <ro at CeBiTec dot Uni-Bielefeld dot DE>
- To: Sandra Loosemore <sandra at codesourcery dot com>
- Cc: <gcc-patches at gcc dot gnu dot org>, "Joseph S. Myers" <joseph at codesourcery dot com>, Jeff Downs <heydowns at somuchpressure dot net>
- Date: Mon, 16 Jan 2017 11:54:27 +0100
- Subject: Re: [driver, doc] Support escaping special characters in specs
- Authentication-results: sourceware.org; auth=none
- References: <yddziiv86ag.fsf@CeBiTec.Uni-Bielefeld.DE> <587C3182.9010604@codesourcery.com>
Hi Sandra,
> On 01/13/2017 05:59 AM, Rainer Orth wrote:
>> diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
>> --- a/gcc/doc/invoke.texi
>> +++ b/gcc/doc/invoke.texi
>> @@ -26391,6 +26391,13 @@ be as many clauses as you need. This ma
>>
>> @end table
>>
>> +The switch matching text @code{S} in a %@{@code{S}@},
>> +%@{@code{S}:@code{X}@} or similar construct can use a backslash to
>> +ignore the special meaning of the character following it, thus allowing
>> +literal matching of a character that is otherwise specially treated.
>> +For example, %@{@code{std=iso9899\:1999}:@code{X}@} would substitute
>> +@code{X} if the @option{-std=iso9899:1999} option were given.
>> +
>
> I see this "%@{@code{..." markup appears in the paragraph just before this,
> but it's wrong. The whole thing needs to be wrapped in @samp and the
> nested @codes removed, like
>
> s/%@{@code{S}:@code{X}@}/@samp{%@{S:X@}}/
>
> etc.
I see, fixed. I assume this applies to the uses inside @item, too, and
irrespective of %{S:X} or %{S}?
> I also suggest using the present tense here instead of the subjunctive...
>
> s/would substitute/substitutes/
> s/were given/is given/
Makes sense: fixed both in gcc.c and invoke.texi.
Thanks.
Rainer
--
-----------------------------------------------------------------------------
Rainer Orth, Center for Biotechnology, Bielefeld University