[prev in list] [next in list] [prev in thread] [next in thread] 

List:       gcc
Subject:    Re: Feature idea for gcc
From:       Matthias Benkmann <matthias () winterdrache ! de>
Date:       2002-11-30 16:49:01
[Download RAW message or body]

On Sat, 30 Nov 2002 16:54:59 +0100 Marc Espie <espie@quatramaran.ens.fr>
wrote:

> In C, to allow for any kind of automated API generation, one would need
> to thoroughly annotate the source file in the first place.

Which is certainly a good idea. If you use a javadoc-like system you can
just extract those declarations for the .h file that have a documentation
comment. That way you're only exporting functions for which proper public
documentation has been written, which IMHO is a very good policy.

MSB

-- 
If everything seems to be going well, you have obviously overlooked
something.

[prev in list] [next in list] [prev in thread] [next in thread]