aboutsummaryrefslogtreecommitdiff
path: root/gcc
diff options
context:
space:
mode:
authorManuel López-Ibáñez <manu@gcc.gnu.org>2014-10-18 16:10:25 +0000
committerManuel López-Ibáñez <manu@gcc.gnu.org>2014-10-18 16:10:25 +0000
commit104e02e991c288a4f428c3e2a44674fab5b5cd8d (patch)
treee6adf5517017f5df17f503e47d3a9fe12212a7be /gcc
parentbf95e88b668dde68de8c5512980eca6c5c9b315b (diff)
downloadgcc-104e02e991c288a4f428c3e2a44674fab5b5cd8d.zip
gcc-104e02e991c288a4f428c3e2a44674fab5b5cd8d.tar.gz
gcc-104e02e991c288a4f428c3e2a44674fab5b5cd8d.tar.bz2
invoke.texi (Options to Request or Suppress Warnings): Explain options precedence.
2014-10-18 Manuel López-Ibáñez <manu@gcc.gnu.org> * doc/invoke.texi (Options to Request or Suppress Warnings): Explain options precedence. (Wtrampolines): Do not indent paragraph. From-SVN: r216429
Diffstat (limited to 'gcc')
-rw-r--r--gcc/ChangeLog6
-rw-r--r--gcc/doc/invoke.texi24
2 files changed, 22 insertions, 8 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 2e24871..896e77f 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,9 @@
+2014-10-18 Manuel López-Ibáñez <manu@gcc.gnu.org>
+
+ * doc/invoke.texi (Options to Request or Suppress Warnings):
+ Explain options precedence.
+ (Wtrampolines): Do not indent paragraph.
+
2014-10-18 John David Anglin <danglin@gcc.gnu.org>
* doc/invoke.texi: Update documentation of hppa -mjump-in-delay option.
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 9f02888..23f272f 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