[patch] Copy-edit the Option Summary in invoke.texi

Jonathan Wakely jwakely@redhat.com
Fri Nov 27 18:40:00 GMT 2015


On 27/11/15 09:45 +0100, Bernd Schmidt wrote:
>On 11/26/2015 01:16 PM, Jonathan Wakely wrote:
>>At https://gcc.gnu.org/onlinedocs/gcc/Option-Summary.html we document
>>-Waggressive-loop-optimizations but you can't find that option at
>>https://gcc.gnu.org/onlinedocs/gcc/Optimize-Options.html because we
>>document -Wno-aggressive-loop-optimizations instead. Similarly, you
>>can't find -Wpedantic-ms-format in the full listing, because we
>>document the negative form, -Wno-pedantic-ms-format, but list *both*
>>in the summary. This patches fixes those mistakes.
>
>I'm guessing we want the negative form documented for anything that 
>has Init(1)? Ok.

Yep:

"Each of these specific warning options also has a negative form
beginning ‘-Wno-’ to turn off warnings; for example, -Wno-implicit.
This manual lists only one of the two forms, whichever is not the
default."

>>I've also tried to put the list back into alphabetical order, and
>>re-justified the list a bit to avoid some especially short lines (I
>>don't understand the inconsistent use of single or double spaces
>>between options, so if there's some logic to that I've not followed
>>it, but I think this is an improvement).
>
>No idea about single vs double spaces. One line has two @gol which 
>seems like an error, you can fix that too if you like.

Good catch, fixed in this version, which I've committed to trunk,
thanks.


-------------- next part --------------
A non-text attachment was scrubbed...
Name: patch.txt
Type: text/x-patch
Size: 4735 bytes
Desc: not available
URL: <http://gcc.gnu.org/pipermail/gcc-patches/attachments/20151127/b791ddf9/attachment.bin>


More information about the Gcc-patches mailing list