> 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.