Doxygen (was Re: Proposed man pages: <vector> sample, RFC)

[george@moberg.com]

Benjamin Kosnik wrote:
> 
> > http://www.research.att.com/sw/tools/graphviz/
> 
> thanks.
> 
> > > Also, is there
> > > anyway you could provide an example image for either or both of the
> > > graphs?
> >
> > Check the attached files.  Note that this is from 2.90.8 snapshot, and that I
> > didn't add _any_ code documentation in the form of javadoc/QT comments so the
> > only thing that's meaningful are the graphs.
> 
> Wow. That's definitely the kind of stuff I'd like to see. Please, let's
> figure out a way to use this tool.

Though I'm not really plugged into libstdc++-v3 development (I use
snapshots of it in my project, as v2 didn't have thread-safe strings),
it seems to me that you could start with the defaults, and maybe write a
script that converts the comments in the libstdc++ code to javadoc-style
or QT-style comments.  This is discussed here:

	http://www.stack.nl/~dimitri/doxygen/docblocks.html#docblocks

If I come up with a decent script to do automated conversion of the code
comments for my project, I'll post it to the list.

--
George T. Talbot
<george at moberg dot com>