<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> <title>Change Log</title> <link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css"> <meta name="generator" content="DocBook XSL Stylesheets V1.75.2"> <link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> <link rel="up" href="../quickbook.html" title="Chapter 31. Quickbook 1.5"> <link rel="prev" href="../quickbook.html" title="Chapter 31. Quickbook 1.5"> <link rel="next" href="syntax.html" title="Syntax Summary"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table cellpadding="2" width="100%"><tr> <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td> <td align="center"><a href="../../../index.html">Home</a></td> <td align="center"><a href="../../../libs/libraries.htm">Libraries</a></td> <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> <td align="center"><a href="../../../more/index.htm">More</a></td> </tr></table> <hr> <div class="spirit-nav"> <a accesskey="p" href="../quickbook.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quickbook.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="syntax.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> </div> <div class="section"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> <a name="quickbook.change_log"></a><a class="link" href="change_log.html" title="Change Log"> Change Log</a> </h2></div></div></div> <a name="quickbook.change_log.version_1_3"></a><h4> <a name="id3243085"></a> <a class="link" href="change_log.html#quickbook.change_log.version_1_3">Version 1.3</a> </h4> <div class="itemizedlist"><ul class="itemizedlist" type="disc"> <li class="listitem"> Quickbook file inclusion [include]. </li> <li class="listitem"> Better xml output (pretty layout). Check out the generated XML. </li> <li class="listitem"> Regression testing facility: to make sure your document will always be compatible (full backward compatibility) regardless of changes to QuickBook. </li> <li class="listitem"> Code cleanup and refactoring. </li> <li class="listitem"> Allow phrase markup in the doc-info. </li> <li class="listitem"> Preformatted code blocks via ``code`` (double ticks) allows code in tables and lists, for example. </li> <li class="listitem"> Quickbook versioning; allows full backward compatibility. You have to add [quickbook 1.3] to the doc-info header to enable the new features. Without this, QuickBook will assume that the document is a pre-1.3 document. </li> <li class="listitem"> Better (intuitive) paragraph termination. Some markups may terminate a paragraph. Example: <pre class="programlisting"><span class="special">[</span><span class="identifier">section</span> <span class="identifier">x</span><span class="special">]</span> <span class="identifier">blah</span><span class="special">...</span> <span class="special">[</span><span class="identifier">endsect</span><span class="special">]</span></pre> </li> <li class="listitem"> Fully qualified section and headers. Subsection names are concatenated to the ID to avoid clashing. Example: <code class="computeroutput"><span class="identifier">doc_name</span><span class="special">.</span><span class="identifier">sect_name</span><span class="special">.</span><span class="identifier">sub_sect_name</span><span class="special">.</span><span class="identifier">sub_sub_sect_name</span></code> </li> <li class="listitem"> Better &nbsp; and whitespace handling in code snippets. </li> <li class="listitem"> [xinclude] fixes up the relative path to the target XML file when input_directory is not the same as the output_directory. </li> <li class="listitem"> Allow untitled tables. </li> <li class="listitem"> Allow phrase markups in section titles. </li> <li class="listitem"> Allow escaping back to QuickBook from code, code blocks and inline code. </li> <li class="listitem"> Footnotes, with the [footnote This is the footnote] syntax. </li> <li class="listitem"> Post-processor bug fix for escaped XML code that it does not recognize. </li> <li class="listitem"> Replaceable, with the [~replacement] syntax. </li> </ul></div> <a name="quickbook.change_log.version_1_4"></a><h4> <a name="id3243334"></a> <a class="link" href="change_log.html#quickbook.change_log.version_1_4">Version 1.4</a> </h4> <div class="itemizedlist"><ul class="itemizedlist" type="disc"> <li class="listitem"> Generic Headers </li> <li class="listitem"> Code changes to allow full recursion (i.e. Collectors and push/pop functions) </li> <li class="listitem"> Various code cleanup/maintenance </li> <li class="listitem"> Templates! </li> <li class="listitem"> [conceptref] for referencing BoostBook <concept> entities. </li> <li class="listitem"> Allow escape of spaces. The escaped space is removed from the output. Syntax: <code class="computeroutput"><span class="special">\</span> </code>. </li> <li class="listitem"> Nested comments are now allowed. </li> <li class="listitem"> Quickbook blocks can nest inside comments. </li> <li class="listitem"> <a class="link" href="syntax.html#quickbook.syntax.block.import" title="Import">Import</a> facility. </li> <li class="listitem"> Callouts on imported code </li> <li class="listitem"> Simple markups can now span a whole block. </li> <li class="listitem"> <a class="link" href="syntax.html#quickbook.syntax.block.blurbs" title="Blurbs">Blurbs</a>, <a class="link" href="syntax.html#quickbook.syntax.block.admonitions" title="Admonitions">Admonitions</a> and table cells (see <a class="link" href="syntax.html#quickbook.syntax.block.tables" title="Tables">Tables</a>) may now contain paragraphs. </li> <li class="listitem"> <code class="computeroutput"><span class="special">\</span><span class="identifier">n</span></code> and <code class="computeroutput"><span class="special">[</span><span class="identifier">br</span><span class="special">]</span></code> are now deprecated. </li> <li class="listitem"> <a class="link" href="syntax.html#quickbook.syntax.phrase.cond" title="Conditional Generation">Conditional Generation</a>. Ala C++ #ifdef. </li> <li class="listitem"> Searching of included and imported files in an extensible search path with <code class="computeroutput"><span class="special">--</span><span class="identifier">include</span><span class="special">-</span><span class="identifier">path</span></code> (<code class="computeroutput"><span class="special">-</span><span class="identifier">I</span></code>) option. </li> </ul></div> <a name="quickbook.change_log.version_1_5"></a><h4> <a name="id3243589"></a> <a class="link" href="change_log.html#quickbook.change_log.version_1_5">Version 1.5</a> </h4> <div class="itemizedlist"><ul class="itemizedlist" type="disc"> <li class="listitem"> Support multiple copyright entrys in document info. </li> <li class="listitem"> Improved SVG support. </li> <li class="listitem"> [globalref] for referencing BoostBook <global> entities. </li> <li class="listitem"> Fail on error. </li> <li class="listitem"> Fix crash for templates with too many arguments or trailing space. </li> <li class="listitem"> Improved handling of unexpected characters in code blocks. </li> <li class="listitem"> Improved handling of unmatched escape in code blocks. </li> <li class="listitem"> Support for python snippets. </li> <li class="listitem"> <code class="computeroutput"><span class="identifier">teletype</span></code> source mode. </li> <li class="listitem"> Use static scoping in templates, should be a lot more intuitive. </li> <li class="listitem"> Accept a space between <code class="computeroutput"><span class="identifier">section</span><span class="special">:</span></code> and the section id. </li> <li class="listitem"> Support table ids. </li> </ul></div> <a name="quickbook.change_log.version_1_5_1___boost_1_43_0"></a><h4> <a name="id3243726"></a> <a class="link" href="change_log.html#quickbook.change_log.version_1_5_1___boost_1_43_0">Version 1.5.1 - Boost 1.43.0</a> </h4> <div class="itemizedlist"><ul class="itemizedlist" type="disc"> <li class="listitem"> Improve the post processor's list of block elements. <code class="computeroutput"><span class="identifier">table</span></code>, <code class="computeroutput"><span class="identifier">entry</span></code> and <code class="computeroutput"><span class="identifier">varlistentry</span></code> are treated as blocks. <code class="computeroutput"><span class="identifier">replaceable</span></code> is treated as an inline element. </li> <li class="listitem"> Check that <code class="computeroutput"><span class="special">[</span><span class="identifier">section</span><span class="special">]</span></code> and <code class="computeroutput"><span class="special">[</span><span class="identifier">endsect</span><span class="special">]</span></code> tags are balanced in templates. </li> <li class="listitem"> Add unicode escape characters, eg. <code class="computeroutput"><span class="special">\</span><span class="identifier">u03B1</span></code> for α. </li> <li class="listitem"> Support UTF-8 files with a unicode byte order mark. </li> <li class="listitem"> Disallow <code class="computeroutput"><span class="special">[</span></code> in simple markup. Fixes some errors with mismatched punctuation. </li> <li class="listitem"> Add command line flag to define macros at the command line, e.g. <code class="computeroutput"><span class="identifier">quickbook</span> <span class="string">"-D__italic_foo__=/foo/"</span></code>. </li> </ul></div> <a name="quickbook.change_log.version_1_5_2___boost_1_44_0"></a><h4> <a name="id3243909"></a> <a class="link" href="change_log.html#quickbook.change_log.version_1_5_2___boost_1_44_0">Version 1.5.2 - Boost 1.44.0</a> </h4> <div class="itemizedlist"><ul class="itemizedlist" type="disc"> <li class="listitem"> Use the cygwin 1.7 API for better path handling. </li> <li class="listitem"> Improved boostbook generation: <div class="itemizedlist"><ul class="itemizedlist" type="circle"> <li class="listitem"> XML encode the documentation info correctly. </li> <li class="listitem"> Avoid generating empty paragraphs. </li> <li class="listitem"> No longer wraps block templates in paragraphs. </li> <li class="listitem"> Warns if you use invalid doc_info members for docbook document types. </li> <li class="listitem"> Fixes some other causes of invalid boostbook, although it still generates invalid boostbook in places. </li> </ul></div> </li> <li class="listitem"> Improved grammar: <div class="itemizedlist"><ul class="itemizedlist" type="circle"> <li class="listitem"> Supports multiple categories in library doc_info. </li> <li class="listitem"> No longer requires commas between authors in docinfo. </li> <li class="listitem"> Allows empty document bodies. </li> <li class="listitem"> A line containing only a comment is no longer interpreted as a paragraph break. </li> <li class="listitem"> If a line starts with a comment, interpret it as a paragraph even if it's followed by whitespace or a list character. </li> <li class="listitem"> Doesn't treat several consecutive blank lines as multiple paragraph breaks. </li> </ul></div> </li> <li class="listitem"> Fixes duplicate image attribute detection. </li> <li class="listitem"> Fixes using code snippets more than once. </li> <li class="listitem"> Early work on quickbook 1.6, available using the <code class="computeroutput"><span class="special">[</span><span class="identifier">quickbook</span> <span class="number">1.6</span><span class="special">]</span></code> version switch, but liable to change in future versions. <div class="itemizedlist"><ul class="itemizedlist" type="circle"> <li class="listitem"> When automatically generating ids for headers, use the quickbook source, rather than the generated docbook. </li> <li class="listitem"> Fix id generation in included files. It wasn't correctly using the main document's documentation id. </li> <li class="listitem"> Correctly restore the quickbook version switch after including a file with a different version. </li> </ul></div> </li> </ul></div> </div> <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> <td align="left"></td> <td align="right"><div class="copyright-footer">Copyright © 2002, 2004, 2006 Joel de Guzman, Eric Niebler<p> Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>) </p> </div></td> </tr></table> <hr> <div class="spirit-nav"> <a accesskey="p" href="../quickbook.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quickbook.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="syntax.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> </div> </body> </html>