From c3e50bc4e45a3429b8a97bee03dd967cf0c7311f Mon Sep 17 00:00:00 2001 From: Sandra Loosemore Date: Sat, 7 Jan 2017 20:42:26 -0500 Subject: [PATCH] re PR preprocessor/54124 (GCC 4.7.1 manual: -dM and similar options hard to find) 2017-01-07 Sandra Loosemore PR preprocessor/54124 gcc/ * doc/cppopts.texi: Reformat -d subtable to list the full name of the options. Add cross-reference to the docs for the general compiler -d options. * doc/invoke.texi (Developer Options): Add cross-reference to the preprocessor-specific -d option documentation. From-SVN: r244205 --- gcc/ChangeLog | 10 ++++++++++ gcc/doc/cppopts.texi | 31 ++++++++++++++++++------------- gcc/doc/invoke.texi | 7 +++++-- 3 files changed, 33 insertions(+), 15 deletions(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 9627372ce55..9d710df5ab1 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,13 @@ +2017-01-07 Sandra Loosemore + + PR preprocessor/54124 + + * doc/cppopts.texi: Reformat -d subtable to list the full name + of the options. Add cross-reference to the docs for the general + compiler -d options. + * doc/invoke.texi (Developer Options): Add cross-reference to the + preprocessor-specific -d option documentation. + 2017-01-07 Sandra Loosemore PR preprocessor/13498 diff --git a/gcc/doc/cppopts.texi b/gcc/doc/cppopts.texi index 44e714940e1..80f3ba374b1 100644 --- a/gcc/doc/cppopts.texi +++ b/gcc/doc/cppopts.texi @@ -458,15 +458,20 @@ activities. Each name is indented to show how deep in the printed, even if they are found to be invalid; an invalid precompiled header file is printed with @samp{...x} and a valid one with @samp{...!} . -@item -dCHARS -@var{CHARS} is a sequence of one or more of the following characters, -and must not be preceded by a space. Other characters are interpreted +@item -d@var{letters} +@opindex d +Says to make debugging dumps during compilation as specified by +@var{letters}. The flags documented here are those relevant to the +preprocessor. Other @var{letters} are interpreted by the compiler proper, or reserved for future versions of GCC, and so -are silently ignored. If you specify characters whose behavior +are silently ignored. If you specify @var{letters} whose behavior conflicts, the result is undefined. +@ifclear cppmanual +@xref{Developer Options}, for more information. +@end ifclear -@table @samp -@item M +@table @gcctabopt +@item -dM @opindex dM Instead of the normal output, generate a list of @samp{#define} directives for all the macros defined during the execution of the @@ -487,25 +492,25 @@ interpreted as a synonym for @option{-fdump-rtl-mach}. @xref{Developer Options, , ,gcc}. @end ifclear -@item D +@item -dD @opindex dD -Like @samp{M} except in two respects: it does @emph{not} include the +Like @option{-dM} except in two respects: it does @emph{not} include the predefined macros, and it outputs @emph{both} the @samp{#define} directives and the result of preprocessing. Both kinds of output go to the standard output file. -@item N +@item -dN @opindex dN -Like @samp{D}, but emit only the macro names, not their expansions. +Like @option{-dD}, but emit only the macro names, not their expansions. -@item I +@item -dI @opindex dI Output @samp{#include} directives in addition to the result of preprocessing. -@item U +@item -dU @opindex dU -Like @samp{D} except that only macros that are expanded, or whose +Like @option{-dD} except that only macros that are expanded, or whose definedness is tested in preprocessor directives, are output; the output is delayed until the use or test of the macro; and @samp{#undef} directives are also output for macros tested but diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 83a0222ce49..d954f52db91 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -12541,8 +12541,11 @@ passes that are otherwise registered after all the other passes are numbered higher than a pass named "final", even if they are executed earlier. @var{dumpname} is generated from the name of the output file if explicitly specified and not an executable, otherwise it is -the basename of the source file. These switches may have different -effects when @option{-E} is used for preprocessing. +the basename of the source file. + +Some @option{-d@var{letters}} switches have different meaning when +@option{-E} is used for preprocessing. @xref{Preprocessor Options}, +for information about preprocessor-specific dump options. Debug dumps can be enabled with a @option{-fdump-rtl} switch or some @option{-d} option @var{letters}. Here are the possible -- 2.30.2