HTML docs include of examples

From: Beman Dawes (bdawes_at_[hidden])
Date: 2001-09-15 07:22:28

It would really be nice for Boost Documentation (and a lot of other 
documentation too) if there was an easy way to be able to compile example 
code to make sure it is correct.

One simple way to do this would be to keep the example code in a regular 
.cpp file.  Then it could be compiled and tested like any other C++ code.

The documentation HTML file would then need the ability to include the .cpp 
file as if it were supplied inline.

Simple.  Effective.

But HTML doesn't seem to have an equivalent to the C/C++ preprocessor's 
#include.  Or am I missing something?  (Has to be a client-side include 
since Boost docs get downloaded and put on local servers which don't have 
special server-side includes.)

Surely #include is such a common need someone has figured out how to do it 
in HTML?  Could it be done with a plug-in?

--Beman