Re: [boost] HTML docs include of examples

From: Jeremy Siek (jsiek_at_[hidden])
Date: 2001-09-15 18:26:43

Hi Beman,

Last week I put some work into extending my literate programming tool to
work with HTML. It's currently working for some simple examples. A little
more work and it could be ready for "prime time".

Cheers,
Jeremy

On Sat, 15 Sep 2001, Beman Dawes wrote:

bdawes> It would really be nice for Boost Documentation (and a lot of other
bdawes> documentation too) if there was an easy way to be able to compile example
bdawes> code to make sure it is correct.
bdawes>
bdawes> One simple way to do this would be to keep the example code in a regular
bdawes> .cpp file.  Then it could be compiled and tested like any other C++ code.
bdawes>
bdawes> The documentation HTML file would then need the ability to include the .cpp
bdawes> file as if it were supplied inline.
bdawes>
bdawes> Simple.  Effective.
bdawes>
bdawes> But HTML doesn't seem to have an equivalent to the C/C++ preprocessor's
bdawes> #include.  Or am I missing something?  (Has to be a client-side include
bdawes> since Boost docs get downloaded and put on local servers which don't have
bdawes> special server-side includes.)
bdawes>
bdawes> Surely #include is such a common need someone has figured out how to do it
bdawes> in HTML?  Could it be done with a plug-in?
bdawes>
bdawes> --Beman
bdawes>
bdawes>
bdawes> Info: http://www.boost.org  Unsubscribe: <mailto:boost-unsubscribe_at_[hidden]>
bdawes>
bdawes> Your use of Yahoo! Groups is subject to http://docs.yahoo.com/info/terms/
bdawes>
bdawes>

----------------------------------------------------------------------
 Jeremy Siek                          http://php.indiana.edu/~jsiek/
 Ph.D. Student, Indiana Univ. B'ton   email: jsiek_at_[hidden]
 C++ Booster (http://www.boost.org)   office phone: [phone]
----------------------------------------------------------------------