[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,

John.

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