RE: man

[Phil Edwards <pedwards at disaster dot jaj dot com>]

> now, perhaps because there was no standard so not much of a point of having
> proper documentation.

That's it exactly.

Some vendors do ship man pages for the C++ library (Sun does, I believe SGI
does), and some have been shipping them for a couple of years.  The downside
is that many of them are now outdated by the standard.  For example,
"man vector" on a Solaris box gives me a page from Rogue Wave included
with Sun's compiler, but from 1998, with some older syntax.


> sorry for the ranting, but i hope its clearer now what i meant. if there is
> no work in this field at the moment, i'm interested in doing something about
> it as i find the situation most annoying. because i wasn't sure if someone
> else was doing it, i didnt write my initial drafts for the page format
> (which sections i consider important, mainly); if this list is the place to
> do it, please let me know. 

There is currently no such effort in the libstdc++-v3 project, but only
because GNU doesn't believe in man pages (yeah, I know, I agree with you
on this one).  And for that reason, I doubt if you will get much support
for such an idea as an official GNU-ish "GCC subsidized" project.

But you might could start such a project at sourceforge, basing the
documentation only on standard stuff and not any GNU extensions.


My two timeslices,
Phil