Re: [Boost-docs] [boost-docs] general boostbook docs

From: John Maddock (john_at_[hidden])
Date: 2007-06-06 12:27:29

Matias Capeletto wrote:
> Which is the rationale of this decision?
> IMHO css layout and admonitions images must be the same because it is
> one book, but I do not understand the imposition of a general chunk
> layout. Many libs docs are design for a particular chunk layout.

Agree 100%, but if the docs are built as one "book" then that means they are 
built as a single XML file: the docbook xml generated for your lib gets 
included by the master XML document, and that's what gets chunked.  You can 
have you're own chunk settings, but then you have to be in a separate 
"book".  Incidently, the current system doesn't scale at all well: it takes 
a fearsomely long time to build in the doc directory: if you're just trying 
to test a minor change it's no fun at all :-(

John.