Subject: Re: [boost] Improving Boost Docs
From: Robert Ramey (ramey_at_[hidden])
Date: 2017-08-15 04:08:50
On 8/14/17 5:34 PM, Glen Fernandes via Boost wrote:
> On Mon, Aug 14, 2017 at 8:31 PM, Robert Ramey via Boost wrote:
>> On 8/14/17 10:37 AM, John Maddock via Boost wrote:
>>> BTW is there any reason to continue using the Boostbook customisation
>>> layer? Is anyone actually using it? I'm fairly sure quickbook doesn't, and
>>> it would sure simplify the build process to leave out one level of XSL
>>> transformation. Sadly we would need an XSL expert to sort that mess out I
>>> suspect :(
>> I think there's a little more to this:
>> a) There are special tags like class, struct, etc. etc. Which permit
>> tagging for different aspects of C++ syntax. Somehow I doubt anyone is
>> using this stuff. It would be pain to edit it and it would presume that
>> every class,struct etc would have the same documentation structure which
>> might be inconvenient. Also the documentation for this is reference and
>> doesn't give much in the way of sample output etc. Upshot I'm doubtful that
>> anyone is using it.
> Is the Boost.Array documentation not using this?
Yep - there it is!
> Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk