This is the mail archive of the
libstdc++@gcc.gnu.org
mailing list for the libstdc++ project.
Re: Standard header format.
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