Re: Tree documentation

[Joe Buck <jbuck at racerx dot synopsys dot com>]

David Dolan wrote:
> > Does any documentation of the different nodes in the GCC tree
> > structure and their fields exist? (other than the code itself) If
> > so, where can I get it.

Mike Stump wrote:
> Yes, there is a 543+ page manual.
> 
> If you haven't seen it, more `find . -name *.texi -print`...  Also on
> the web site, see http://gcc.gnu.org/ and look under Docs:Manual:gcc.

Mike, you've repeatedly posted messages like this to the gcc list.
These messages are frequently insulting, and in this case, simply wrong,
as the manual has no relevant information.

(it wouldn't be insulting to point someone to the manual when there is
good information there, but even in that case it could be done with less
sarcasm than is your usual style)

It makes the gcc list a more unpleasant place that you do this so much.
Since we (the SC) promised Mark Mitchell that we'd try to stamp out rude
behavior on the gcc list as one of the conditions for him taking the job,
I'm calling you on this.  You need to clean up your act.  It's especially
counterproductive to insult people who are trying to learn enough about
gcc internals to make significant contributions.  Before hitting "send"
on gcc messages, please ask yourself whether you would feel insulted
if you were the recipient, not the sender, of one of your missives.

Before telling someone to RTFM, please make sure that there is something
relevant in the FM.  In this case, had you yourself read the FM, you would
have found the following text (the last paragraph of gcc/rtl.texi):

> The proper way to interface GNU CC to a new language front end is with
> the ``tree'' data structure.  There is no manual for this data
> structure, but it is described in the files @file{tree.h} and
> @file{tree.def}.