This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: [RFC] Contributing tree-ssa to mainline
- From: Steven Bosscher <s dot bosscher at student dot tudelft dot nl>
- To: kenner at vlsi1 dot ultra dot nyu dot edu (Richard Kenner),pinskia at physics dot uc dot edu
- Cc: gcc at gcc dot gnu dot org
- Date: Tue, 20 Jan 2004 12:55:16 +0100
- Subject: Re: [RFC] Contributing tree-ssa to mainline
- References: <10401201149.AA05743@vlsi1.ultra.nyu.edu>
On Tuesday 20 January 2004 12:49, Richard Kenner wrote:
> But the comments from the beginning of each function is the
> *specification* of the function and not the *implementation*, this is
> where the documentation comes from.
>
> That's correct, so I think we're talking about two different things.
> The issue that was being raised was documentation *in the source* and
> it sounded like you were saying that the documentation specification
> of the function was derived from that of the implementation.
>
> So what *is* the documentation that's derived from this?
>
Go have a look:
http://people.redhat.com/dnovillo/pub/tree-ssa/doc/html/index.html
It's not a replacement for real documentation (that we're also working
on) but it makes the code much easier to understand. And you don't
have to grep so much, if you see a functions you don't know yet, just
follow a link and see what it does.
Gr.
Steven