[Boost-docs] quickbook code import

Subject: [Boost-docs] quickbook code import
From: John Maddock (john_at_[hidden])
Date: 2007-08-01 18:03:29

Just in case Joel hasn't enough to do already at present :-)

I've been giving the code import feature a good workout - writing docs in
the source and then just importing the lot into quickbook - makes writing
tutorials really nice :-)

If the imported section begins with a /*` comment then we go straight into
quickbook markup and there's no initial empty code block. Good. However,
if the source file terminates like this:

some text

//] end of quickbook import

Then we get an empty code block at the end of the imported section in the
final docs :-(

Any way this can be suppressed? I've tried moving the //] inside the
/*`...*/ section, but then nothing gets expanded (no errors from quickbook
either), also tried removing the blank line between */ and // which also
still produces a final empty code block, as does finishing with */ //] all
on one line.

Any workarounds?

Many thanks,


PS, bjam doesn't detect changed dependencies in code imports either :-(

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:40 UTC