Re: [boost] [quickbook] Including source files in the document

From: Joel de Guzman (joel_at_[hidden])
Date: 2006-08-01 17:50:31

Giovanni Piero Deretta wrote:

>> Anyway, as Eric said it may be better to make [include] more
>> intelligent.  What about making it take two arguments, one specifying
>> the file name and the other the format?  E.g.
>>
>> [include somefile.xml xml]
>> [include code.cpp c++]
>> [include foo.qbk quickbook]
> 
> 
> What about including only *part* of a file?
> i.e. marking a file with with comments with something like
> 
> 
> --- in file source.cpp ---
> ...
> //  quickbook:begin("section name")
> ...
> // quickbook:end("section name")
> ...
> --------
> 
> [include source.cpp C++ "section name"]
> would include only that part of the file.
> 
> Useful if you want to pull for example only a function prototype, or a
> single
> class declaration...

Yes. These are what I had in mind when I asked Julio if he's
interested to do more coding. Eric and Giovanni summed it all
up. There was something like this before but it got out of
sync with the code and got lost. I do not even recall now
who wrote it.

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