David Abrahams wrote:
Joel de Guzman <[EMAIL PROTECTED]> writes:
The main objective was to get some automated testing for the code
examples in our book. Really, that's all! ;-)
And my point all along was that this is the domain of bjam.
Now, I realize (below) that you need a facility not only for
testing, but also for gathering the outputs back into your docs.
and how it addresses that. Oh sure, it's a literate programming
system, but I do not see the connection with that and having the
ability to preprocess
Well, we have code examples that show the Boost PP lib. We need to be
able to test that they do what we thought.
Ok, this is a different matter then, and well within the
borders of the documentation tool. I agree that this is a
good requirement. The spirit docs has some candidates for this.
or check for specific strings in the output,
We have examples whose correctness can only be tested well by
verifying that they produce a particular output on stdio. Standard
code testing stuff. Only this time, most of the code and all the
instructions about what to do with it are embedded in the source text
of the book.
Shouldn't this be delegated to another tool like Boost.Test
driven by bjam?
[...]
There must be some disconnect here, because to me this all looks so
obvious that there seems to be no better way to explain it than what
I've already said. If someone else can understand what you're
confused about and translate for us, that might help. Anyone?
Pardon me for sounding stubborn and slow, I do understand. I
just want to be sure I covered all the issues involved. Give
me some more time to grok all this and Joao and I will come
up with a revised proposal.
Regards,
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net
-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
