Subject: [Boost-docs] Hopefully helpful 'docs about docs'
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2011-03-09 12:31:34
I've finally put some work into preparing a template for anyone preparing
Boost docs using the Quickbook, Doxygen, AutoIndex toolchain.
And I've written an expanded version that tries to give lots of hints and
tips, lots of references, and lists the many pits into which I have plopped
in using this rather unforgiving system.
It includes an index (prepared using John Maddock's AutoIndex) - because one
of the major problems I have found is that, even knowing there is a way to
do something or a cause of an error, finding *where* in the existing
documents or on the lists, remains a major problem, even with the ever
I've provisionally committed the template version (an expanded version of
Daniel James sandbox /example template) at
But I am uncertain that this is the best place to put it.
Should I create a new sandbox item at
Similarly where should I put the much fuller version called
Both create html and PDF versions of course.
Should I commit the full HTML and PDF versions? (So they are easily read and
indexed by Google?)
--- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow_at_[hidden]
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC