This patch adds the words "when possible" to make clear that it is not always possible to use attributes to replace the effects of -fno-toplevel-reorder. I also fixed a typo s/includes files/include files/ I noticed a while ago. Bootstrapped on x86_64-unknown-linux-gnu. Committed to mainline.
Ian 2013-10-21 Ian Lance Taylor <i...@google.com> * doc/invoke.texi (Optimize Options): For -fno-toplevel-reorder, don't imply that attributes can solve all problems. (Directory Options): Fix typo.
Index: doc/invoke.texi =================================================================== --- doc/invoke.texi (revision 203893) +++ doc/invoke.texi (working copy) @@ -8364,7 +8364,7 @@ statements. Output them in the same ord input file. When this option is used, unreferenced static variables are not removed. This option is intended to support existing code that relies on a particular ordering. For new code, it is better to -use attributes. +use attributes when possible. Enabled at level @option{-O0}. When disabled explicitly, it also implies @option{-fno-section-anchors}, which is otherwise enabled at @option{-O0} on some @@ -10367,7 +10367,7 @@ separator character at the end of the pa @option{-B} prefixes that effectively specify directory names also apply to libraries in the linker, because the compiler translates these options into @option{-L} options for the linker. They also apply to -includes files in the preprocessor, because the compiler translates these +include files in the preprocessor, because the compiler translates these options into @option{-isystem} options for the preprocessor. In this case, the compiler appends @samp{include} to the prefix.