From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gcc-return-89489-listarch-gcc=gcc.gnu.org@gcc.gnu.org>
Received: (qmail 7121 invoked by alias); 20 Jan 2004 04:23:26 -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 7113 invoked from network); 20 Jan 2004 04:23:26 -0000
Received: from unknown (HELO vlsi1.ultra.nyu.edu) (128.122.140.213)
  by sources.redhat.com with SMTP; 20 Jan 2004 04:23:26 -0000
Received: by vlsi1.ultra.nyu.edu (4.1/1.34)
	id AA04863; Mon, 19 Jan 04 23:25:39 EST
Date: Tue, 20 Jan 2004 04:23:00 -0000
From: kenner@vlsi1.ultra.nyu.edu (Richard Kenner)
Message-Id: <10401200425.AA04863@vlsi1.ultra.nyu.edu>
To: dnovillo@redhat.com
Subject: Re: [RFC] Contributing tree-ssa to mainline
Cc: gcc@gcc.gnu.org
X-SW-Source: 2004-01/txt/msg01444.txt.bz2

    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.