On Fri, Jan 14, 2011 at 6:07 PM, Richard Kenner <ken...@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).
