Subject: Re: [boost] Improving Documentation
From: Mateusz Loskot (mateusz_at_[hidden])
Date: 2013-10-11 12:38:23
On 11 October 2013 17:08, Niall Douglas <s_sourceforge_at_[hidden]> wrote:
> On 10 Oct 2013 at 23:26, Mateusz Loskot wrote:
>> > Boost.Geometry contains a utility called doxygen_xml2qbk which
>> > converts Doxygen XML into Quickbook.
>> Initially, for Boost.Geometry I ported Boost.Asio XSLT sheet to
>> generate API reference. The work proved the XSLT application
>> is scary and highly prone to the bus factor :-)
>> So, Barend decided to write a custom utility in C++ that is
>> much easier to reason about, hence maintain.
> Did you or Barend merge my patchset to doxygen_xml2qbk which I
> submitted on the boost issue tracker?
Yes, Barend has applied it about ~2 months ago. Thanks!
> I'd really like it if you split out doxygen_xml2qbk into a standalone
> tool in Boost tools instead of hogging to yourselves in Geometry :)
> doxygen_xml2qbk produced the best output of all the Boost
> documentation tools I tried.
Good to hear.
> It has many problems, bugs and
> brittleness, but until it's standalone I can see there being some
> confusion (as evidenced by this thread) about what the tool does,
> that it exists, that it's useful and that yes it can be improved.
> Even with its warts, it's still the best out of anything I tried.
Ok, I will try to make it a standalone tool during next weeks.
-- Mateusz Loskot, http://mateusz.loskot.net
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk