Re: [boost] Improving Boost Docs

Subject: Re: [boost] Improving Boost Docs
From: Mateusz Loskot (mateusz_at_[hidden])
Date: 2017-08-16 17:39:55

On 16 Aug 2017 5:09 pm, "Vinnie Falco via Boost" <boost_at_[hidden]>
wrote:

On Wed, Aug 16, 2017 at 8:03 AM, Robert Ramey via Boost
<boost_at_[hidden]> wrote:
> b) The inclusion of all the specialized tags for C++ like class, struct,
is
> meant to automate the production of boiler plate output for those C++
> constructs.  I understand the appeal of this - we're computer programmers
> and want to automate everything - but in this case it's a bridge too far.
> quickbook doesn't use these - a good choice in my opinion.  A few hand
> edited boost book do uses these but the results are not satisfying in my
> opinion.  To improve them, one would have to wade into XSL language - a
> place were few people want to go.

And again I will use this opportunity to point out that I have "gone
there" by creating "docca", an XSL library which provides the
component for transforming Doxygen XML output into QuickBook:

<https://github.com/vinniefalco/docca>

How does it compare to, or is it based on, the XSLT tools used by Boost
Asio?

Boost Geometry used to use it briefly  with promising results but
(maintenance)  complexity overkill killed it.

-- 
Mateusz Łoskot