This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
[PATCH] Prune references to removed -d{letters} options in invoke.texi (PR middle-end/35853)
- From: Jakub Jelinek <jakub at redhat dot com>
- To: gcc-patches at gcc dot gnu dot org
- Cc: Jan Hubicka <jh at suse dot cz>
- Date: Tue, 21 Oct 2008 12:20:01 +0200
- Subject: [PATCH] Prune references to removed -d{letters} options in invoke.texi (PR middle-end/35853)
- Reply-to: Jakub Jelinek <jakub at redhat dot com>
Hi!
Honza mailed this patch already in June:
http://gcc.gnu.org/ml/gcc-patches/2008-06/msg01000.html
but hasn't committed it. I've added a couple of other changes where
non-working -d options were mentioned.
Ok for trunk?
2008-10-21 Jan Hubicka <jh@suse.cz>
Jakub Jelinek <jakub@redhat.com>
PR middle-end/35853
* doc/invoke.texi: Remove references to obsoleted -d dumps.
--- gcc/doc/invoke.texi.jj 2008-10-14 10:17:48.000000000 +0200
+++ gcc/doc/invoke.texi 2008-10-21 12:10:20.000000000 +0200
@@ -97,8 +97,8 @@ options for compiling C++ programs.
@cindex options, grouping
The @command{gcc} program accepts options and file names as operands. Many
options have multi-letter names; therefore multiple single-letter options
-may @emph{not} be grouped: @option{-dr} is very different from @w{@samp{-d
--r}}.
+may @emph{not} be grouped: @option{-dv} is very different from @w{@samp{-d
+-v}}.
@cindex order of options
@cindex options, order
@@ -4515,8 +4515,8 @@ an executable, otherwise it is the basen
switches may have different effects when @option{-E} is used for
preprocessing.
-Most debug dumps can be enabled either passing a letter to the @option{-d}
-option, or with a long @option{-fdump-rtl} switch; here are the possible
+Debug dumps can be enabled with a @option{-fdump-rtl} switch or some
+@option{-d} option @var{letters}. Here are the possible
letters for use in @var{letters} and @var{pass}, and their meanings:
@table @gcctabopt
@@ -4605,7 +4605,7 @@ Dump after local register allocation, to
@item -fdump-rtl-loop2
@opindex fdump-rtl-loop2
-@option{-dL} and @option{-fdump-rtl-loop2} enable dumping after the
+@option{-fdump-rtl-loop2} enables dumping after the
loop optimization pass, to @file{@var{file}.119r.loop2},
@file{@var{file}.120r.loop2_init},
@file{@var{file}.121r.loop2_invariant}, and
@@ -4705,14 +4705,14 @@ Also turns on @option{-dp} annotation.
@item -dv
@opindex dv
-For each of the other indicated dump files (either with @option{-d} or
-@option{-fdump-rtl-@var{pass}}), dump a representation of the control flow
-graph suitable for viewing with VCG to @file{@var{file}.@var{pass}.vcg}.
+For each of the other indicated dump files (@option{-fdump-rtl-@var{pass}}),
+dump a representation of the control flow graph suitable for viewing with VCG
+to @file{@var{file}.@var{pass}.vcg}.
@item -dx
@opindex dx
Just generate RTL for a function instead of compiling it. Usually used
-with @samp{r} (@option{-fdump-rtl-expand}).
+with @option{-fdump-rtl-expand}.
@item -dy
@opindex dy
@@ -4721,17 +4721,17 @@ Dump debugging information during parsin
@item -fdump-noaddr
@opindex fdump-noaddr
-When doing debugging dumps (see @option{-d} option above), suppress
-address output. This makes it more feasible to use diff on debugging
-dumps for compiler invocations with different compiler binaries and/or
-different text / bss / data / heap / stack / dso start locations.
+When doing debugging dumps, suppress address output. This makes it more
+feasible to use diff on debugging dumps for compiler invocations with
+different compiler binaries and/or different
+text / bss / data / heap / stack / dso start locations.
@item -fdump-unnumbered
@opindex fdump-unnumbered
-When doing debugging dumps (see @option{-d} option above), suppress instruction
-numbers and address output. This makes it more feasible to
-use diff on debugging dumps for compiler invocations with different
-options, in particular with and without @option{-g}.
+When doing debugging dumps, suppress instruction numbers and address output.
+This makes it more feasible to use diff on debugging dumps for compiler
+invocations with different options, in particular with and without
+@option{-g}.
@item -fdump-translation-unit @r{(C++ only)}
@itemx -fdump-translation-unit-@var{options} @r{(C++ only)}
@@ -5002,18 +5002,19 @@ The @var{string} should be different for
@opindex fsched-verbose
On targets that use instruction scheduling, this option controls the
amount of debugging output the scheduler prints. This information is
-written to standard error, unless @option{-dS} or @option{-dR} is
-specified, in which case it is output to the usual dump
-listing file, @file{.sched} or @file{.sched2} respectively. However
-for @var{n} greater than nine, the output is always printed to standard
-error.
+written to standard error, unless @option{-fdump-rtl-sched1} or
+@option{-fdump-rtl-sched2} is specified, in which case it is output
+to the usual dump listing file, @file{.sched} or @file{.sched2}
+respectively. However for @var{n} greater than nine, the output is
+always printed to standard error.
For @var{n} greater than zero, @option{-fsched-verbose} outputs the
-same information as @option{-dRS}. For @var{n} greater than one, it
-also output basic block probabilities, detailed ready list information
-and unit/insn info. For @var{n} greater than two, it includes RTL
-at abort point, control-flow and regions info. And for @var{n} over
-four, @option{-fsched-verbose} also includes dependence info.
+same information as @option{-fdump-rtl-sched1} and @option{-fdump-rtl-sched2}.
+For @var{n} greater than one, it also output basic block probabilities,
+detailed ready list information and unit/insn info. For @var{n} greater
+than two, it includes RTL at abort point, control-flow and regions info.
+And for @var{n} over four, @option{-fsched-verbose} also includes
+dependence info.
@item -save-temps
@opindex save-temps
Jakub