This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: Proposal for automatic generation of c++ header files
On Fri, Jan 14, 2011 at 6:07 PM, Richard Kenner
<kenner@vlsi1.ultra.nyu.edu> wrote:
>> And as an implementer of large C/C++ based embedded systems, I tend to the
>> view that, while some programmers don't think of headers as specifications,
>> ?they should, and doing so is helpful to achieving high quality.
>
> Back many years ago when I was doing VLSI design, there was one large
> CAD system written in C (I forget which one now) that had extensive
> documentation in their header files. ?I think that was a major part of
> the quality of that tool.
>
The same documentation can be put in the implementation file.
The Qt source code contains all the documentation in the
implementation files (for a good reason: headers are parsed again and
again).