[libstdc++] Docs, comments, and formatting tweaks

[Benjamin Kosnik]

> The run_doxygen script does a lot of cleanup and rearranging after the pages
> are generated.  Fortunately it doesn't need to be super-duper-extra-portable;
> this is something that would probably only be run by:
> 
>     - system vendors/integrators
>     - me  :-)

Yes. That's fine. I'm representing one of the vendors that is planning on 
using this, so please let me know if there are substantial issues.

> I've a couple more minor nits to pick, and then I want to roll another
> tarball of generated HTML docs, and (for the first time) generated man pages.
> It's been a while since anything was put up on the FTP site.

Sounds great.

> Hm, are we still going to be doing library snapshots?

Yeah. I've been planning on doing this for about two months now. 

My thought is:

3.0.95 - gnulocale complete, default to on
3.0.96 - wide io
3.0.97 - optimization, bug fixes

etc till 3.1. Obviously there are other priorities and plans, so I'd like 
to hear them. I was thinking 3.0.95 no later than Dec 15, 2001. 

I figure we could tag the CVS sources with the release, and provide a 
tarball that could replace the gcc-3.0.x libstdc++-v3 directory, and 
provide a way for people using stable compilers to try the new library. 
Call me crazy..

-benjamin