From 104e02e991c288a4f428c3e2a44674fab5b5cd8d Mon Sep 17 00:00:00 2001 From: =?utf8?q?Manuel=20L=C3=B3pez-Ib=C3=A1=C3=B1ez?= Date: Sat, 18 Oct 2014 16:10:25 +0000 Subject: [PATCH] invoke.texi (Options to Request or Suppress Warnings): Explain options precedence. MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit 2014-10-18 Manuel López-Ibáñez * doc/invoke.texi (Options to Request or Suppress Warnings): Explain options precedence. (Wtrampolines): Do not indent paragraph. From-SVN: r216429 --- gcc/ChangeLog | 6 ++++++ gcc/doc/invoke.texi | 24 ++++++++++++++++-------- 2 files changed, 22 insertions(+), 8 deletions(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 2e24871d658..896e77f7ecf 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,9 @@ +2014-10-18 Manuel López-Ibáñez + + * doc/invoke.texi (Options to Request or Suppress Warnings): + Explain options precedence. + (Wtrampolines): Do not indent paragraph. + 2014-10-18 John David Anglin * doc/invoke.texi: Update documentation of hppa -mjump-in-delay option. diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 9f02888353c..23f272f4a1f 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -3263,6 +3263,15 @@ 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}. +Some options, such as @option{-Wall} and @option{-Wextra}, turn on other +options, such as @option{-Wunused}, which may turn on further options, +such as @option{-Wunused-value}. The combined effect of positive and +negative forms is that more specific options have priority over less +specific ones, independently of their position in the command-line. For +options of the same specificity, the last one takes effect. Options +enabled or disabled via pragmas (@pxref{Diagnostic Pragmas}) take effect +as if they appeared at the end of the command-line. + When an unrecognized warning option is requested (e.g., @option{-Wunknown-warning}), GCC emits a diagnostic stating that the option is not recognized. However, if the @option{-Wno-} form @@ -4294,14 +4303,13 @@ headers---for that, @option{-Wunknown-pragmas} must also be used. @item -Wtrampolines @opindex Wtrampolines @opindex Wno-trampolines - Warn about trampolines generated for pointers to nested functions. - - A trampoline is a small piece of data or code that is created at run - time on the stack when the address of a nested function is taken, and - is used to call the nested function indirectly. For some targets, it - is made up of data only and thus requires no special treatment. But, - for most targets, it is made up of code and thus requires the stack - to be made executable in order for the program to work properly. +Warn about trampolines generated for pointers to nested functions. +A trampoline is a small piece of data or code that is created at run +time on the stack when the address of a nested function is taken, and is +used to call the nested function indirectly. For some targets, it is +made up of data only and thus requires no special treatment. But, for +most targets, it is made up of code and thus requires the stack to be +made executable in order for the program to work properly. @item -Wfloat-equal @opindex Wfloat-equal -- 2.30.2