[Boost-commit] svn:boost r75533 - branches/quickbook-dev/tools/quickbook/doc

Subject: [Boost-commit] svn:boost r75533 - branches/quickbook-dev/tools/quickbook/doc
From: dnljms_at_[hidden]
Date: 2011-11-17 16:05:34

Author: danieljames
Date: 2011-11-17 16:05:33 EST (Thu, 17 Nov 2011)
New Revision: 75533
URL: http://svn.boost.org/trac/boost/changeset/75533

Log:
Quickbook: 1.6 note.
Text files modified: 
   branches/quickbook-dev/tools/quickbook/doc/1_6.qbk |     9 ++++++++-                               
   1 files changed, 8 insertions(+), 1 deletions(-)

Modified: branches/quickbook-dev/tools/quickbook/doc/1_6.qbk
==============================================================================
--- branches/quickbook-dev/tools/quickbook/doc/1_6.qbk	(original)
+++ branches/quickbook-dev/tools/quickbook/doc/1_6.qbk	2011-11-17 16:05:33 EST (Thu, 17 Nov 2011)
@@ -124,6 +124,13 @@
 files just containing templates, which don't really need a document info
 block.
 
+If you don't specify `compatibility-mode`, the behaviour depends on whether or
+not you have a docinfo block. If you do it uses the file's quickbook version,
+if you don't it inherits the parent's compatibility mode even if you specify
+a quickbook version. This is the right thing to do - mixing compatibility modes
+within documents is problematic. It might actually be a mistake to allow them
+to specified outside docinfo blocks.
+
 This change is also backdated to older versions. So when including from an
 older version, the included file's version can be set (older versions
 ignore document info in included files).
@@ -233,4 +240,4 @@
 
 [endsect]
 
-[endsect] [/1_6]
\ No newline at end of file
+[endsect] [/1_6]