From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gcc-return-89490-listarch-gcc=gcc.gnu.org@gcc.gnu.org>
Received: (qmail 8817 invoked by alias); 20 Jan 2004 04:28:29 -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 8808 invoked from network); 20 Jan 2004 04:28:29 -0000
Received: from unknown (HELO smtp3.fuse.net) (216.68.8.173)
  by sources.redhat.com with SMTP; 20 Jan 2004 04:28:29 -0000
Received: from dellpi.pinski.fam ([66.42.149.214]) by smtp3.fuse.net
          (InterMail vM.6.00.05.02 201-2115-109-103-20031105) with ESMTP
          id <20040120042827.UJH3237.smtp3.fuse.net@dellpi.pinski.fam>;
          Mon, 19 Jan 2004 23:28:27 -0500
Received: from [127.0.0.1] (IDENT:pinskia@localhost.pinski.fam [127.0.0.1])
	by dellpi.pinski.fam (8.12.2/8.12.1) with ESMTP id i0K4SLLI015622;
	Mon, 19 Jan 2004 23:28:27 -0500 (EST)
In-Reply-To: <10401200425.AA04863@vlsi1.ultra.nyu.edu>
References: <10401200425.AA04863@vlsi1.ultra.nyu.edu>
Mime-Version: 1.0 (Apple Message framework v609)
Content-Type: text/plain; charset=US-ASCII; format=flowed
Message-Id: <12C3639D-4B01-11D8-8143-000393A6D2F2@physics.uc.edu>
Content-Transfer-Encoding: 7bit
Cc: dnovillo@redhat.com, gcc@gcc.gnu.org,
   Andrew Pinski <pinskia@physics.uc.edu>
From: Andrew Pinski <pinskia@physics.uc.edu>
Subject: Re: [RFC] Contributing tree-ssa to mainline
Date: Tue, 20 Jan 2004 04:28:00 -0000
To: kenner@vlsi1.ultra.nyu.edu (Richard Kenner)
X-SW-Source: 2004-01/txt/msg01445.txt.bz2


On Jan 19, 2004, at 20: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.

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.

If this is not true in your Ada sources, then you are not following the 
coding
style and every patch should be rejected here forth until you or 
another Ada
person fixes this.


Thanks,
Andrew Pinski