Re: Add more tree dump options, remove inconsistencies

[Fergus Henderson <fjh at cs dot mu dot oz dot au>]

On 27-May-2001, Nathan Sidwell <nathan@codesourcery.com> wrote:
> Hi,
> I attach a patch which does several things
> 1) adds generic machinery to deal with -fdump-tree-like-thingy switches
> 2) removes inconsistency between C and C++ -fdump-translation-unit behaviour
> 3) brings those new switches into line with the rtl dump switches
> 4) adds an additional user flag mechanism for dump control
> 5) adds pre and post optimize function decl tree dumpers.
> 
> ok for mainline?

I don't have authority to approve it, but it looks good to me,
bar a couple of minor issues with the texinfo documentation.

> Index: invoke.texi
...
> ! @item -fdump-translation-unit (C and C++ only)
> ! @item -fdump-translation-unit-@var{number} (C and C++ only)
>   Dump a representation of the tree structure for the entire translation
> ! unit to a file. The file name is made by appending @file{.tu} to the
> ! source file name. If the -@var{number} form is used, @var{number}
> ! controls the details of the dump.

How exactly does @var{number} control the details?
If the semantics are the same as for -fdump-tree-@var{switch}-@var{number},
then IMHO you should say so, or at very least add ", as described below"
or something like that.

> ! @item -fdump-class-hierarchy (C++ only)
> ! @item -fdump-class-hierarchy-@var{number} (C++ only)
> ! Dump a representation of each class's hierarchy to a file. The file name
> ! is made by appending @file{.class} to the source file name. If the
> ! -@var{number} form is used, @var{number} controls the details of the
> ! dump.

Likewise here.

-- 
Fergus Henderson <fjh@cs.mu.oz.au>  |  "I have always known that the pursuit
                                    |  of excellence is a lethal habit"
WWW: <http://www.cs.mu.oz.au/~fjh>  |     -- the last words of T. S. Garp.