On 16 Aug 2017 5:09 pm, "Vinnie Falco via Boost"
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