Re: [Boost-docs] Quickbook/Docbook document types

Subject: Re: [Boost-docs] Quickbook/Docbook document types
From: Daniel James (dnljms_at_[hidden])
Date: 2011-02-04 18:15:42

On 4 February 2011 17:04, John Maddock <boost.regex_at_[hidden]> wrote:
> The quickbook docs specify that the following document types are allowed:
>
> boost/article/library/chapter/part/appendix/preface/qandadiv/qandaset/reference/set.
>
> However, since quickbook deals with *sections*, and can't be used to insert
> other block-markup using escapes (because it puts the block inside a
> paragraph), then in reality only:
>
> article/library/chapter/appendix/preface
>
> Will actually generate valid XML.  I realize that the XSL stylesheets don't
> care too much about that, but PDF generation does because the FO gets
> validated by tools like XEP.
>
> Thoughts?

What we really should do is let you define, say a 'book', and then
include quickbook files with documentation type 'chapter', 'appendix'.
But I'm not going to implement that any time soon. Could probably add
a warning. I'm going to write some more detailed documentation about
the info block pretty soon, so I'll add something then.

Daniel