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: Andrew Pinski <pinskia at physics dot uc dot edu>
- To: kenner at vlsi1 dot ultra dot nyu dot edu (Richard Kenner)
- Cc: dnovillo at redhat dot com, gcc at gcc dot gnu dot org, Andrew Pinski <pinskia at physics dot uc dot edu>
- Date: Mon, 19 Jan 2004 20:28:18 -0800
- Subject: Re: [RFC] Contributing tree-ssa to mainline
- References: <10401200425.AA04863@vlsi1.ultra.nyu.edu>
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