This is the mail archive of the
libstdc++@gcc.gnu.org
mailing list for the libstdc++ project.
Re: Standard header format.
On Tue, Jun 08, 2004 at 09:32:24AM -0400, Steven T. Hatton wrote:
> On Tuesday 08 June 2004 01:57, llewelly@xmission.com wrote:
> >
> > If the above is intended to inform programmers as the the interface of
> > the library, it belongs in the *documentation*, not in the header
> > files. Most programmers only look at the header files when the
> > documentation is woefully inadequate.
>
> I haven't taken a scientific poll, but my experience has been most C++
> programmers with whom I have discussed this issue have been been quite
> forceful in stating their belief that header files should present the API to
> the user, and that should serve as a human readable reference for the user of
> the API.
And yet, none of those programmers have ever tried implementing a C++
standard library as portable as this one.
The ones who /have/ implemented such a library have spent the last few
days telling you that it doesn't work like that.
Perhaps some observations and tentative conclusions could be drawn from
this pattern? Hmmmm...
--
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