Re: [Boost-docs] Sphinx integration

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

on Tue Oct 11 2011, Mateusz Loskot <> wrote:

> On 11/10/11 14:40, Dave Abrahams wrote:
>> on Tue Oct 11 2011, Mateusz Loskot<> 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.
> Yes, that's what I have in mind.
> Now, regarding the implementation of such translator:
> - is there anything already available in current doc tools in Boost,
> Vault,...?
> - if not, where it should go? separate cmd line tool like quickbook?
> - what's best way to parse XML for BoostDoc for ? libxml, Boost.Tree,
> Spirit?

I don't think I know the answers oto these questions. There's
*something* in Boost.Build for this, but that's as much as I remember.

Dave Abrahams
BoostPro Computing

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC