Re: [PATCH] Prune references to removed -d{letters} options in invoke.texi (PR middle-end/35853)

["Richard Guenther" <richard dot guenther at gmail dot com>]

On Tue, Oct 21, 2008 at 12:20 PM, Jakub Jelinek <jakub@redhat.com> wrote:
> 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?

Ok.

Thanks,
Richard.

> 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
>