[Boost-docs] [Quickbook]

Subject: [Boost-docs] [Quickbook]
From: Beman Dawes (bdawes_at_[hidden])
Date: 2011-10-06 10:47:10

In looking at .../tools/quickbook/doc/Jamfile.v2, I see:

        <xsl:param>generate.section.toc.level=3
        <xsl:param>chunk.section.depth=1
        <xsl:param>chunk.first.sections=1
        ...

Googling for what these might mean turns up:
http://docbook.sourceforge.net/release/xsl/current/doc/html/index.html

Is that the best reference for these params?

Why are they there? The output looks OK if they are commented out.

Should someone who is trying to learn how to use Quickbook (1) Learn
DocBook first, or (2) Spend a few minutes reading about DocBook, but
then only reference DocBook docs when needed, or (3) Ignore DocBook
and look somewhere else for <xsl:param> docs, (4) some other approach?
If the answer is (2), are there some specific DocBook features that a
new QuickBook user should study?

Thanks,

--Beman