Standard header format.

[Phil Edwards]

On Sun, Jun 06, 2004 at 10:40:27AM -0400, Jason Merrill wrote:
> On Sun, 6 Jun 2004 05:16:45 -0400, "Steven T. Hatton" <hattons@globalsymmetry.com> wrote:
> > If there are actually header files in the traditional sense that look like 
> > this:
> >
> > [snip textbook output]
> >
> 
> If people want something that looks like that, there's the standard; we
> don't need our implementation to look like it as well.

Exactly.  This is one of the things standards are /for/.


> > I believe the 
> > people who have suggested looking at the Standard Headers were expecting me 
> > to find them in the form presented above.  I am not saying they /should/ 
> > expect that.  I'm saying they /do/ expect that.
> 
> I haven't encountered this expectation before.  What I expect to find in
> the libstdc++ headers is implementation details.

I'll go farther and say that I expect real-world implementations to
/never/ look like they came out of a textbook or Doxygen-like extractor.
Implementations have too many details to consider.


-- 
Behind everything some further thing is found, forever; thus the tree behind
the bird, stone beneath soil, the sun behind Urth.  Behind our efforts, let
there be found our efforts.
              - Ascian saying, as related by Loyal to the Group of Seventeen