Re: [boost] [Ann]: Dox - a C++ documentation tool

From: Eric Goebelbecker (egoebelbecker_at_[hidden])
Date: 2005-06-12 14:20:44

I have web space. I'll love to host it. (I would probably end up being
a heavy user.)

It would be hosted under something like http://www.ominor.net/boost/docs

On 6/10/05, Narech Koumar <narechk_at_[hidden]> wrote:
> Hi,
> 
> > Are you going to submit this as a boost tool?
> >
> 
> I have nothing against it. If there is a general interest in using Dox
> amongst the boost community I'll gladly submit it. The question is how
> do I do that?
> 
> 
> > I am not extremely familiar with the whole documentation generation
> > aspect of boost, so I am not sure how this would fit in.
> >
> > If you are planning to submit this, I suggest you:
> >
> > * Pay careful attention to anyone who responds to this mail who knows
> > more about how the doc gen stuff works
> > * "Go the last mile"- i.e. do whatever extra work needed to fully
> > integrate this tool based on the feedback and thoughts you get (i.e.
> > don't expect someone to do it for you)
> 
> Thanks for the suggestions.
> 
> 
> >
> > Maybe if you ran doxygen on boost, and then ran your tool on that and
> > put it up on a web server somewhere, you could post a link here and
> > people could see "the big picture".
> 
> Boost is one of the regression/performance tests for Dox :) . At this
> point the majority of the boosts' libs can be documented as is;
> unfortunately there are some major eeky quirks in the current version of
> Doxygen which hinder boost to be documented in its entirety.
> 
> The currently produced documentation of boost API is far too large for
> me to host (ca 60Meg of HTML). If someone has a webspace to offer I'll
> gladly send them a .zip, alternatively someone can run Dox locally and
> post the results. The following libs/directories are known to pass
> through Doxygen->Dox fairly unmaimed:
> 
> algorithm
> archive
> assign
> bind
> dynamic_bitset
> filesystem
> format
> integer
> io
> iterator
> logic
> multi_array
> preprocessor
> program_options
> random
> range
> serialization
> test
> thread
> utility
> variant
> 
> 
> Cheers,
> 
> - NK
> 
> _______________________________________________
> Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
> 

-- 
"Should array indices start at 0 or 1? My compromise of 0.5 was rejected 
without, I thought, proper consideration."   - Stan Kelly-Bootle
------------------------------------
Eric Goebelbecker
eric_at_[hidden]
http://eric.ominor.net