[Boost-commit] svn:boost r86668 - trunk/tools/quickbook/doc

Subject: [Boost-commit] svn:boost r86668 - trunk/tools/quickbook/doc
From: dnljms_at_[hidden]
Date: 2013-11-12 15:35:37

Author: danieljames
Date: 2013-11-12 15:35:37 EST (Tue, 12 Nov 2013)
New Revision: 86668
URL: http://svn.boost.org/trac/boost/changeset/86668

Log:
Document the new source mode changes.

Text files modified: 
   trunk/tools/quickbook/doc/1_7.qbk        |    13 ++++++++-----                           
   trunk/tools/quickbook/doc/change_log.qbk |     9 +++++++++                               
   2 files changed, 17 insertions(+), 5 deletions(-)

Modified: trunk/tools/quickbook/doc/1_7.qbk
==============================================================================
--- trunk/tools/quickbook/doc/1_7.qbk	Tue Nov 12 15:35:14 2013	(r86667)
+++ trunk/tools/quickbook/doc/1_7.qbk	2013-11-12 15:35:37 EST (Tue, 12 Nov 2013)	(r86668)
@@ -46,12 +46,15 @@
 ]
 ```
 
-When used before a section, it sets the source mode for the section element,
-not the whole section.
+When used before a section, it sets the source mode for the whole section.
 
-Currently it does not support other syntactic entities such as paragraphs
-and lists. It will currently be used to the next code block or element.
-This is a bit messy, but I'm not sure what would be a good idea.
+If it appears at the beginning of a paragraph, it will be used for the
+whole paragraph only if there's a newline, eg.
+
+```
+[!c++]
+A declaration `void foo();` and a definition `void foo() {}`.
+```
 
 [endsect]
 

Modified: trunk/tools/quickbook/doc/change_log.qbk
==============================================================================
--- trunk/tools/quickbook/doc/change_log.qbk	Tue Nov 12 15:35:14 2013	(r86667)
+++ trunk/tools/quickbook/doc/change_log.qbk	2013-11-12 15:35:37 EST (Tue, 12 Nov 2013)	(r86668)
@@ -317,3 +317,12 @@
     in a phrase template.
 * Internal changes:
   * Clean up the id manager implementation.
+
+[heading Version 1.6.1]
+
+* 1.7 changes:
+  * Improved source mode tagging:
+    * Works for lists and paragraphs.
+    * If the source mode is changed inside a tagged element, that change
+      will now persist after the element.
+    * Tagged sections will now use the source mode for the whole section.