Joel de Guzman <[EMAIL PROTECTED]> writes:I'd also want to know the objectives of the system
The main objective was to get some automated testing for the code examples in our book. Really, that's all! ;-)
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.
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.
Well, here's a very rudimentary and not very thought out proposal that may get us started on the processing of doc-related-code...
[process command args]
... content ...
[endprocess]
The 'process' directive shall execute 'command' passing it the specified 'args' as command line arguments. The content of the process directive will be used as standard input for the command.
'command' shall be a platform and toolset independent command (I'm imagining some promiscuity between bjam and quickbook here... perhaps quickbook can invoke bjam for these steps).
'args' may include names of external files (this includes collector's with a file name) and names of collectors.
Both stdout and stderr of the invoked command may be made available for inclusion in the docs in an as yet unspecified manner (proposals welcome!) or may be output to quickbook's stdout/stderr also in an as yet unspecified manner.
There might also be interest in redirecting stdout/stderr through another processing step.
Would something like this (but actually working and with a nice syntax ;) ) do?
Jo�o
------------------------------------------------------- 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
