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.