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