Re: [Boost-docs] Sphinx integration

Subject: Re: [Boost-docs] Sphinx integration
From: Dave Abrahams (dave_at_[hidden])
Date: 2011-10-11 13:40:24

on Tue Oct 11 2011, Mateusz Loskot <mateusz-AT-loskot.net> wrote:

>> Sorry, I don't know what you mean by "implement the unification for use
>> and processing of Doxygen in Boost."  Could you explain?
>
> I mean that, presumably, it is a good idea if all Boost libraries
> documented using Doxygen use exactly the same tool to transform the
> Doxygen comments into API reference in BoostBook or QuickBook format.
>
> This way, look & feel of all API references would be consistent
> and authors would probably be encouraged to update comments for better
> Boost API documentation coverage.

+1

In fact, it shouldn't be up to the individual libraries; the
transformation should be part of the documentation build process.

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com