diff options
author | Manuel López-Ibáñez <manu@gcc.gnu.org> | 2007-10-20 19:32:20 +0000 |
---|---|---|
committer | Manuel López-Ibáñez <manu@gcc.gnu.org> | 2007-10-20 19:32:20 +0000 |
commit | 2b60abb7734348ce6d88c5c2141006340e2e0400 (patch) | |
tree | ea183df761e63b06d4d6aa549b7a052fd7d33df8 | |
parent | e40a0ebe95735f0a9566429ab9e1abf2e1f9495c (diff) | |
download | gcc-2b60abb7734348ce6d88c5c2141006340e2e0400.zip gcc-2b60abb7734348ce6d88c5c2141006340e2e0400.tar.gz gcc-2b60abb7734348ce6d88c5c2141006340e2e0400.tar.bz2 |
invoke.texi (Warning Options): Move -w, -Werror, -Werror= and -Wfatal-errors together.
2007-10-20 Manuel Lopez-Ibanez <manu@gcc.gnu.org>
* doc/invoke.texi (Warning Options): Move -w, -Werror, -Werror=
and -Wfatal-errors together.
From-SVN: r129513
-rw-r--r-- | gcc/ChangeLog | 5 | ||||
-rw-r--r-- | gcc/doc/invoke.texi | 88 |
2 files changed, 50 insertions, 43 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 0c7b102..ca44e00 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,8 @@ +2007-10-20 Manuel Lopez-Ibanez <manu@gcc.gnu.org> + + * doc/invoke.texi (Warning Options): Move -w, -Werror, -Werror= + and -Wfatal-errors together. + 2007-10-20 Alan Modra <amodra@bigpond.net.au> PR target/33812 diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 3374914..deb5461 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -2524,17 +2524,8 @@ Warnings are diagnostic messages that report constructions which are not inherently erroneous but which are risky or suggest there may have been an error. -You can request many specific warnings with options beginning @samp{-W}, -for example @option{-Wimplicit} to request warnings on implicit -declarations. Each of these specific warning options also has a -negative form beginning @samp{-Wno-} to turn off warnings; -for example, @option{-Wno-implicit}. This manual lists only one of the -two forms, whichever is not the default. - -The following options control the amount and kinds of warnings produced -by GCC; for further, language-specific options also refer to -@ref{C++ Dialect Options} and @ref{Objective-C and Objective-C++ Dialect -Options}. +The following language-independent options do not enable specific +warnings but control the kinds of diagnostics produced by GCC. @table @gcctabopt @cindex syntax checking @@ -2542,6 +2533,48 @@ Options}. @opindex fsyntax-only Check the code for syntax errors, but don't do anything beyond that. +@item -w +@opindex w +Inhibit all warning messages. + +@item -Werror +@opindex Werror +Make all warnings into errors. + +@item -Werror= +@opindex Werror= +Make the specified warning into an error. The specifier for a warning +is appended, for example @option{-Werror=switch} turns the warnings +controlled by @option{-Wswitch} into errors. This switch takes a +negative form, to be used to negate @option{-Werror} for specific +warnings, for example @option{-Wno-error=switch} makes +@option{-Wswitch} warnings not be errors, even when @option{-Werror} +is in effect. You can use the @option{-fdiagnostics-show-option} +option to have each controllable warning amended with the option which +controls it, to determine what to use with this option. + +Note that specifying @option{-Werror=}@var{foo} automatically implies +@option{-W}@var{foo}. However, @option{-Wno-error=}@var{foo} does not +imply anything. + +@item -Wfatal-errors +@opindex Wfatal-errors +This option causes the compiler to abort compilation on the first error +occurred rather than trying to keep going and printing further error +messages. + +@end table + +You can request many specific warnings with options beginning +@samp{-W}, for example @option{-Wimplicit} to request warnings on +implicit declarations. Each of these specific warning options also +has a negative form beginning @samp{-Wno-} to turn off warnings; for +example, @option{-Wno-implicit}. This manual lists only one of the +two forms, whichever is not the default. For further, +language-specific options also refer to @ref{C++ Dialect Options} and +@ref{Objective-C and Objective-C++ Dialect Options}. + +@table @gcctabopt @item -pedantic @opindex pedantic Issue all the warnings demanded by strict ISO C and ISO C++; @@ -2588,10 +2621,6 @@ nothing to warn about.) Like @option{-pedantic}, except that errors are produced rather than warnings. -@item -w -@opindex w -Inhibit all warning messages. - @item -Wall @opindex Wall This enables all the warnings about constructions that some users @@ -2655,8 +2684,7 @@ name is still supported, but the newer name is more descriptive.) -Wsign-compare @gol -Wtype-limits @gol -Wuninitialized @r{(only with} @option{-O1} @r{and above)} @gol --Wunused-parameter @r{(only with} @option{-Wunused} @r{or} -@option{-Wall}@r{)} @gol +-Wunused-parameter @r{(only with} @option{-Wunused} @r{or} @option{-Wall}@r{)} @gol } The option @option{-Wextra} also prints warning messages for the @@ -2709,12 +2737,6 @@ Warn whenever a comment-start sequence @samp{/*} appears in a @samp{/*} comment, or whenever a Backslash-Newline appears in a @samp{//} comment. This warning is enabled by @option{-Wall}. -@item -Wfatal-errors -@opindex Wfatal-errors -This option causes the compiler to abort compilation on the first error -occurred rather than trying to keep going and printing further error -messages. - @item -Wformat @opindex Wformat @opindex ffreestanding @@ -3901,26 +3923,6 @@ This option is only supported for C and Objective-C@. It is implied by @option{-Wall} and by @option{-pedantic}, which can be disabled with @option{-Wno-pointer-sign}. -@item -Werror -@opindex Werror -Make all warnings into errors. - -@item -Werror= -@opindex Werror= -Make the specified warning into an errors. The specifier for a -warning is appended, for example @option{-Werror=switch} turns the -warnings controlled by @option{-Wswitch} into errors. This switch -takes a negative form, to be used to negate @option{-Werror} for -specific warnings, for example @option{-Wno-error=switch} makes -@option{-Wswitch} warnings not be errors, even when @option{-Werror} -is in effect. You can use the @option{-fdiagnostics-show-option} -option to have each controllable warning amended with the option which -controls it, to determine what to use with this option. - -Note that specifying @option{-Werror=}@var{foo} automatically implies -@option{-W}@var{foo}. However, @option{-Wno-error=}@var{foo} does not -imply anything. - @item -Wstack-protector @opindex Wstack-protector This option is only active when @option{-fstack-protector} is active. It |