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

Subject: [Boost-commit] svn:boost r63764 - trunk/tools/quickbook/doc
From: daniel_james_at_[hidden]
Date: 2010-07-08 16:49:53

Author: danieljames
Date: 2010-07-08 16:49:52 EDT (Thu, 08 Jul 2010)
New Revision: 63764
URL: http://svn.boost.org/trac/boost/changeset/63764

Log:
Organise the quickbook release notes a bit better.
Text files modified: 
   trunk/tools/quickbook/doc/quickbook.qbk |    27 ++++++++++++++++-----------             
   1 files changed, 16 insertions(+), 11 deletions(-)

Modified: trunk/tools/quickbook/doc/quickbook.qbk
==============================================================================
--- trunk/tools/quickbook/doc/quickbook.qbk	(original)
+++ trunk/tools/quickbook/doc/quickbook.qbk	2010-07-08 16:49:52 EDT (Thu, 08 Jul 2010)
@@ -191,22 +191,27 @@
 
 [h3 Version 1.5.2 - Boost 1.44.0]
 
-* Generate more valid boostbook (still invalid in a few places).
-* Warn about invalid doc_info members.
-* Support multiple categories in library doc_info.
 * Use the cygwin 1.7 API for better path handling.
-* Fix some corner cases for paragraph detection:
+* Improved boostbook generation:
+  * XML encode the documentation info correctly.
+  * Avoid generating empty paragraphs.
+  * No longer wraps block templates in paragraphs.
+  * Doesn't generate invalid doc_info members for docbook document types,
+    warns if you use any.
+  * Fixes some other causes of invalid boostbook, although it still
+    generates invalid boostbook in places.
+* Improved grammar:
+  * Supports multiple categories in library doc_info.
+  * No longer requires commas between authors in docinfo.
+  * Allows empty document bodies.
   * A line containing only a comment is no longer interpreted as a
     paragraph break.
   * If a line starts with a comment, interpret it as a paragraph even if it's
     followed by whitespace or a list character.
-  * Don't treat 4+ consecutive blank lines as multiple paragraph breaks.
-* Don't require commas between authors in docinfo.
-* Allow empty document bodies.
-* Less empty paragraphs.
-* XML encode the documentation info correctly.
-* Fix duplicate image attribute detection.
-* Preparing for quickbook 1.6:
+  * Doesn't treat several consecutive blank lines as multiple paragraph breaks.
+* Fixes duplicate image attribute detection.
+* Early work on quickbook 1.6, available using the `[quickbook 1.6]` version switch,
+  but liable to change in future versions.
   * When automatically generating ids for headers, use the quickbook
     source, rather than the generated docbook.
   * Fix id generation in included files. It wasn't correctly using the