David Abrahams wrote:
"Eric Niebler" <[EMAIL PROTECTED]> writes:


IMO, for the next+1 release, we should consider upping the
chunk.section.depth and encourage people to organize their
documentation more hierarchically. It makes a big difference for the
larger libraries. Consider the difference in xpressive's documentation
at a chunk depth of 1: http://tinyurl.com/882t8, and at a chunk depth
of 3: http://tinyurl.com/48kv5.


Hear hear!

With the fusion docs, we are using:

        <xsl:param>chunk.section.depth=4
        <xsl:param>chunk.first.sections=1
        <xsl:param>toc.section.depth=3
        <xsl:param>toc.max.depth=2

which basically gives us the same level of granularity as that
of the MPL docs.

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



-------------------------------------------------------
This SF.Net email is sponsored by xPML, a groundbreaking scripting language
that extends applications into web and mobile media. Attend the live webcast
and join the prime developer group breaking into this new coding territory!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to