Re: [Boost-docs] quickbook code import

Subject: Re: [Boost-docs] quickbook code import
From: Joel de Guzman (joel_at_[hidden])
Date: 2007-08-01 23:49:54

John Maddock wrote:
> 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?

The final blank line gets generated as a snippet. Duh!
Fixed in SVN. All empty code snippets are now inhibited
from output.

> Many thanks,
> 
> John.
> 
> PS, bjam doesn't detect changed dependencies in code imports either :-( 

Ah, Rene's expertise :-)

Regards,
-- 
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net