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

Subject: [Boost-commit] svn:boost r85287 - trunk/tools/quickbook/doc
From: dnljms_at_[hidden]
Date: 2013-08-10 15:17:51

Author: danieljames
Date: 2013-08-10 15:17:51 EDT (Sat, 10 Aug 2013)
New Revision: 85287
URL: http://svn.boost.org/trac/boost/changeset/85287

Log:
Some notes about recent quickbook changes.

Text files modified: 
   trunk/tools/quickbook/doc/1_6.qbk        |    26 +++++++++++++++++++++++++-              
   trunk/tools/quickbook/doc/change_log.qbk |    12 ++++++++++++                            
   2 files changed, 37 insertions(+), 1 deletions(-)

Modified: trunk/tools/quickbook/doc/1_6.qbk
==============================================================================
--- trunk/tools/quickbook/doc/1_6.qbk	Sat Aug 10 15:17:21 2013	(r85286)
+++ trunk/tools/quickbook/doc/1_6.qbk	2013-08-10 15:17:51 EDT (Sat, 10 Aug 2013)	(r85287)
@@ -246,6 +246,30 @@
 
 [endsect] [/xmlbase]
 
+[section:template_parser Improved template parser]
+
+There's a new parser for template declarations and parameters which does
+a better job of understanding escaped and bracketed text. Unfortunately
+it does not understand element names so there are some cases where it
+could go wrong. For example:
+
+    [template doesnt_work[]
+    [ordered_list
+        [`code phrase`]
+    ]
+    ]
+
+In this case it will think the `[\`` is a template call and give a parse
+error. To work around this put an escaped space before the code phrase:
+
+    [template works[]
+    [ordered_list
+        [\ `code phrase`]
+    ]
+    ]
+
+[endsect]
+
 [section:elements New Elements]
 
 [section:block `block`]
@@ -455,7 +479,7 @@
 
 [endsect]
 
-[section:phrase_block_templates Allow block lements in phrase templates]
+[section:phrase_block_templates Allow block elements in phrase templates]
 
 Block elements can now be used in phrase templates, but paragraphs breaks aren't
 allowed, so this is an error:

Modified: trunk/tools/quickbook/doc/change_log.qbk
==============================================================================
--- trunk/tools/quickbook/doc/change_log.qbk	Sat Aug 10 15:17:21 2013	(r85286)
+++ trunk/tools/quickbook/doc/change_log.qbk	2013-08-10 15:17:51 EDT (Sat, 10 Aug 2013)	(r85287)
@@ -303,3 +303,15 @@
   (Can still nest block elements in lists though).
 * Don't break out of lists after a nested block element.
 * Check for errors when writing dependency files.
+* Improved markup for lists.
+* Make escaping templates with a punctuation identifier illegal.
+  Escaping templates with an alphanumeric identifier is still fine.
+* 1.7 changes:
+  * Make it an error to use an element in the wrong context.
+  * Error if the body of a phrase element doesn't parse.
+  * List markup in nested blocks.
+  * Allow block elements in phrase templates.
+  * Make it an error to put a paragraph break (i.e. a blank line)
+    in a phrase template.
+* Internal changes:
+  * Clean up the id manager implementation.