David Abrahams wrote:
Joel de Guzman <[EMAIL PROTECTED]> writes:
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.
That would be really great, but my system hasn't been configured to to
do that, so I wouldn't characterize that as a requirement. I've been
Alright. How about if we start with a list of requirements,
or if that's too formal, a wishlist perhaps?
I've been playing mind games on the issue and might have some
ideas of my own. I've noticed that a lot of processing has
to do with text manipulation. FYI, Hartmut is working on a
thing called Karma which is the reverse of Spirit, where you
have rules that guide the formatting and manipulation of
output. I think it is possible to have a dynamic ouput processor
that will work on snippets (collectors). It might be possible
to have a simplified dynamic Karma into QuickBook, where Karma
like rules are embedded in QuickBook.
Then, offlist, there was also some discussion about beefing up
QuickBook's macro system. My proposal was to make the macro
system a little more powerful by adding arguments, instead of
plain text substitution. I think this alone could be a powerful
facility for text manipulation.
My goal is to reduce the amount of scripting needed to practically
use QuickBook. In as much as "you should not need to know anything
about DocBook/BoostBook in order to use QuickBook", it follows that
"you should not need to know anything about <place-your-favorite-
scriping-language-here> in order to use QuickBook". A scripting
language will still be available, sure, but I think that should
be used only as a fallback similar to "escaping" to XML BoostBook
when we really need to.
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
