On 11 October 2013 17:08, Niall Douglas
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 :)
Good idea.
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. Best regards, -- Mateusz Loskot, http://mateusz.loskot.net