From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gcc-return-89519-listarch-gcc=gcc.gnu.org@gcc.gnu.org>
Received: (qmail 13323 invoked by alias); 20 Jan 2004 11:57:09 -0000
Mailing-List: contact gcc-help@gcc.gnu.org; run by ezmlm
Precedence: bulk
List-Archive: <http://gcc.gnu.org/ml/gcc/>
List-Post: <mailto:gcc@gcc.gnu.org>
List-Help: <http://gcc.gnu.org/ml/>
Sender: gcc-owner@gcc.gnu.org
Received: (qmail 13313 invoked from network); 20 Jan 2004 11:57:08 -0000
Received: from unknown (HELO mailhost2.tudelft.nl) (130.161.180.2)
  by sources.redhat.com with SMTP; 20 Jan 2004 11:57:08 -0000
Received: from 127.0.0.1 (localhost [127.0.0.1])
	by rav.antivirus (Postfix) with SMTP
	id A599F17F8A; Tue, 20 Jan 2004 12:57:07 +0100 (MET)
Received: from listserv.tudelft.nl (listserv.tudelft.nl [130.161.180.33])
	by mailhost2.tudelft.nl (Postfix) with ESMTP
	id 5DD9A17F7C; Tue, 20 Jan 2004 12:57:07 +0100 (MET)
Received: from steven.lr-s.tudelft.nl (hekje1.shuis.tudelft.nl [145.94.192.78])
	by listserv.tudelft.nl (8.12.10/8.12.8) with ESMTP id i0KBv6QP027051;
	Tue, 20 Jan 2004 12:57:06 +0100 (MET)
Received: by steven.lr-s.tudelft.nl (Postfix, from userid 500)
	id 311A93AC85; Tue, 20 Jan 2004 12:55:17 +0100 (CET)
From: Steven Bosscher <s.bosscher@student.tudelft.nl>
To: kenner@vlsi1.ultra.nyu.edu (Richard Kenner),
	pinskia@physics.uc.edu
Subject: Re: [RFC] Contributing tree-ssa to mainline
Date: Tue, 20 Jan 2004 11:57:00 -0000
User-Agent: KMail/1.5.4
Cc: gcc@gcc.gnu.org
References: <10401201149.AA05743@vlsi1.ultra.nyu.edu>
In-Reply-To: <10401201149.AA05743@vlsi1.ultra.nyu.edu>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200401201255.16825.s.bosscher@student.tudelft.nl>
X-SW-Source: 2004-01/txt/msg01474.txt.bz2

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