From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gcc-return-89515-listarch-gcc=gcc.gnu.org@gcc.gnu.org>
Received: (qmail 24754 invoked by alias); 20 Jan 2004 11:15:06 -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 24741 invoked from network); 20 Jan 2004 11:15:04 -0000
Received: from unknown (HELO mx1.redhat.com) (66.187.233.31)
  by sources.redhat.com with SMTP; 20 Jan 2004 11:15:04 -0000
Received: from int-mx1.corp.redhat.com (int-mx1.corp.redhat.com [172.16.52.254])
	by mx1.redhat.com (8.11.6/8.11.6) with ESMTP id i0KBE3l14272;
	Tue, 20 Jan 2004 06:14:03 -0500
Received: from pobox.toronto.redhat.com (pobox.toronto.redhat.com [172.16.14.4])
	by int-mx1.corp.redhat.com (8.11.6/8.11.6) with ESMTP id i0KBE3a25267;
	Tue, 20 Jan 2004 06:14:03 -0500
Received: from dnovillo.cipe.redhat.com (dnovillo.cipe.redhat.com [10.0.0.106])
	by pobox.toronto.redhat.com (8.12.8/8.12.8) with ESMTP id i0KBE1Xd027017;
	Tue, 20 Jan 2004 06:14:02 -0500
Subject: Re: [RFC] Contributing tree-ssa to mainline
From: Diego Novillo <dnovillo@redhat.com>
To: Richard Kenner <kenner@vlsi1.ultra.nyu.edu>
Cc: "gcc@gcc.gnu.org" <gcc@gcc.gnu.org>
In-Reply-To: <10401200425.AA04863@vlsi1.ultra.nyu.edu>
References: <10401200425.AA04863@vlsi1.ultra.nyu.edu>
Content-Type: text/plain
Organization: Red Hat Canada
Message-Id: <1074597216.25137.220.camel@frodo.toronto.redhat.com>
Mime-Version: 1.0
Date: Tue, 20 Jan 2004 11:15:00 -0000
Content-Transfer-Encoding: 7bit
X-SW-Source: 2004-01/txt/msg01470.txt.bz2

On Mon, 2004-01-19 at 23:25, Richard Kenner wrote:
>     The API documentation is published nightly, created directly from the
>     source code comments.  
> 
> I don't follow.  The source code comments within a function describe the
> *implementation* of a function: the API documentation needs to describe
> the *specification* of a function.  These are two different things.
>
I never said the comments were inside each function.

http://people.redhat.com/dnovillo/pub/tree-ssa/doc/html/tree-ssa_8c.html#a63

I also never said the documentation was perfect.  I want folks outside
the project to offer feedback in the form of bugzilla reports (adding to
PR13756 should suffice).


Diego.