Boost logo

Boost-Commit :

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.


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk