On 15/08/2017 02:13, Soul Studios via Boost wrote:
The only thing you have to learn is Quickbook and doxygen. I see nothing "ridiculous" in that. You can ignore boostbook/docbook completely.
From what I recall there were about 12 different dependencies you had to set up in order to render anything from quickbook, with unclear guidelines, and no standard path for authoring quickbook. At any rate, I just thought I'd offer my impression as someone new to boosts doc process. I'm not interested in an argument.
12? Please see: https://svn.boost.org/trac10/wiki/BoostDocs/GettingStarted, OK it looks a little intimidating at first, but there are only three required installs: xsltproc (you will almost certainly have this already on Linux). DocBook DTD DocBook XSL stylesheets After that Quickbook will build itself for you (from a Jamfile), so will auto_index if you want automatic indexing. But yes, we need to improve the getting started stuff.... John.
If there had been an insistence on a particular look-and-feel with a supplied .css, I would've been fine with that. Instead I gave up.
No one forces you to use Quickbook or doxygen. But your emotional response to both is very surprising.
I don't agree with that.
_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost .
--- This email has been checked for viruses by AVG. http://www.avg.com