tree-ssa/13756 Documentation issues

[Geert Bosch <bosch at gnat dot com>]

On Jan 19, 2004, at 22:27, Diego Novillo wrote:
> This goes again to my request for peer review.  All the API
> documentation is available online.  You don't need to even check-out 
> the
> branch.  Follow the links from http://gcc.gnu.org/projects/tree-ssa/
> You will find high-level design documents and API documentation.  We
> need bugzilla reports that point out specific bits that are missing.  I
> have created PR13756 to begin tracking documentation issues.  Feel free
> to add what you think is missing.

First comment:

There is no global overview of tree-ssa. The "main page" of the
documentation is empty, and there is no single place that describes
what tree-ssa is and what the overall structure is.

The most useful piece of high-level info is in the proceedings of
the 2003 GCC Summit, page 171-195, but I agree with Richard Kenner that
most of this information should be contained in the various files that
make up tree-ssa.

Unfortunately, the referenced information is in PDF format, so I cannot
easily cut and paste some of it to illustrate my point.

  -Geert