Re: [boost] [BoostBook] how to automatically test code examples?

Subject: Re: [boost] [BoostBook] how to automatically test code examples?
From: Daniel James (dnljms_at_[hidden])
Date: 2017-10-19 09:43:37

On 19 October 2017 at 09:01, Hans Dembinski via Boost
<boost_at_[hidden]> wrote:
> Hello again,
>
>> It says in the BoostBook documentation http://www.boost.org/doc/libs/1_65_1/doc/html/boostbook.html
>> "The BoostBook format allows testcases to be generated by weaving together program fragments from example programs in the documentation. This capability is integrated with testsuite generation so that example programs are normal tests in BoostBook."
>>
>> That's awesome, I would love to use this feature, but the documentation is not explaining how to actually do that. I found the element "testsuite" which probably does what I want. I went on to scan the Boost repository for this BoostBook element, but couldn't find an example to copy from.
>>
>> Could someone help me out? How do I modify my BoostBook and Jam files to generate tests out of the code examples in the documentation?
>
> I didn't get any reply so far… was my question stupid? Or is it simply that no one knows? Is the author of BoostBook, Douglas Gregor, not around anymore?

Sorry, I was looking into this but a power cut got in the way. It
looks like the xsl script at tools/boostbook/xsl/testing/Jamfile.xsl
will generate a jamfile and test cases from tests marked up in xml,
and you can find the xml schema details in the boostbook reference
documentation. There doesn't seem to be any support for running this
from boost build though.