Re: [Boost-docs] Including a few lines from another file in BoostBook?

Subject: Re: [Boost-docs] Including a few lines from another file in BoostBook?
From: Eric Niebler (eric_at_[hidden])
Date: 2008-07-07 18:22:44

Boris wrote:
> I've been converting a Quickbook documentation to DocBook. 

Do you mind if I ask why?

> In some 
> Quickbook files I've seen some references to source files where only a 
> part of the source file seems to be included - something like this:
> 
> [include ../example/tutorial.cpp c++ include-headers]
> 
> This sounds like a good idea as the source file is complete (and can be 
> automatically built and tested) but only the few lines are included 
> which are relevant. I wonder though if this can be done with DocBook, 
> too (or BoostBook)?

I don't think so. DocBook (and BoostBook) are just XML. You can 
xi:include other XML files and select bits of them with XPointer, but 
XML doesn't know anything about C++ source.

-- 
Eric Niebler
BoostPro Computing
http://www.boostpro.com