1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html> 3<head> 4<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 5<title>Change Log</title> 6<link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css"> 7<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 8<link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> 9<link rel="up" href="../quickbook.html" title="Chapter 50. Quickbook 1.7"> 10<link rel="prev" href="../quickbook.html" title="Chapter 50. Quickbook 1.7"> 11<link rel="next" href="command_line.html" title="Command Line Usage"> 12</head> 13<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 14<table cellpadding="2" width="100%"><tr> 15<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td> 16<td align="center"><a href="../../../index.html">Home</a></td> 17<td align="center"><a href="../../../libs/libraries.htm">Libraries</a></td> 18<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> 19<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> 20<td align="center"><a href="../../../more/index.htm">More</a></td> 21</tr></table> 22<hr> 23<div class="spirit-nav"> 24<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="command_line.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> 25</div> 26<div class="section"> 27<div class="titlepage"><div><div><h2 class="title" style="clear: both"> 28<a name="quickbook.change_log"></a>Change Log</h2></div></div></div> 29<h3> 30<a name="quickbook.change_log.h0"></a> 31 <span class="phrase"><a name="quickbook.change_log.version_1_1"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_1">Version 32 1.1 - Boost 1.33.0</a> 33 </h3> 34<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> 35 First version to be included in boost. 36 </li></ul></div> 37<h3> 38<a name="quickbook.change_log.h1"></a> 39 <span class="phrase"><a name="quickbook.change_log.version_1_3"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_3">Version 40 1.3 - Boost 1.34.0 to 1.34.1</a> 41 </h3> 42<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 43<li class="listitem"> 44 Quickbook file inclusion [include]. 45 </li> 46<li class="listitem"> 47 Better xml output (pretty layout). Check out the generated XML. 48 </li> 49<li class="listitem"> 50 Regression testing facility: to make sure your document will always be 51 compatible (full backward compatibility) regardless of changes to QuickBook. 52 </li> 53<li class="listitem"> 54 Code cleanup and refactoring. 55 </li> 56<li class="listitem"> 57 Allow phrase markup in the doc-info. 58 </li> 59<li class="listitem"> 60 Preformatted code blocks via ``code`` (double ticks) allows code in tables 61 and lists, for example. 62 </li> 63<li class="listitem"> 64 Quickbook versioning; allows full backward compatibility. You have to add 65 [quickbook 1.3] to the doc-info header to enable the new features. Without 66 this, QuickBook will assume that the document is a pre-1.3 document. 67 </li> 68<li class="listitem"> 69<p class="simpara"> 70 Better (intuitive) paragraph termination. Some markups may terminate a 71 paragraph. Example: 72 </p> 73<pre class="programlisting">[section x] 74blah... 75[endsect]</pre> 76</li> 77<li class="listitem"> 78 Fully qualified section and headers. Subsection names are concatenated 79 to the ID to avoid clashing. Example: <code class="computeroutput">doc_name.sect_name.sub_sect_name.sub_sub_sect_name</code> 80 </li> 81<li class="listitem"> 82 Better &nbsp; and whitespace handling in code snippets. 83 </li> 84<li class="listitem"> 85 [xinclude] fixes up the relative path to the target XML file when input_directory 86 is not the same as the output_directory. 87 </li> 88<li class="listitem"> 89 Allow untitled tables. 90 </li> 91<li class="listitem"> 92 Allow phrase markups in section titles. 93 </li> 94<li class="listitem"> 95 Allow escaping back to QuickBook from code, code blocks and inline code. 96 </li> 97<li class="listitem"> 98 Footnotes, with the [footnote This is the footnote] syntax. 99 </li> 100<li class="listitem"> 101 Post-processor bug fix for escaped XML code that it does not recognize. 102 </li> 103<li class="listitem"> 104 Replaceable, with the [~replacement] syntax. 105 </li> 106</ul></div> 107<h3> 108<a name="quickbook.change_log.h2"></a> 109 <span class="phrase"><a name="quickbook.change_log.version_1_4"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_4">Version 110 1.4 - Boost 1.35.0 to 1.40.0</a> 111 </h3> 112<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 113<li class="listitem"> 114 Generic Headers 115 </li> 116<li class="listitem"> 117 Code changes to allow full recursion (i.e. Collectors and push/pop functions) 118 </li> 119<li class="listitem"> 120 Various code cleanup/maintenance 121 </li> 122<li class="listitem"> 123 Templates! 124 </li> 125<li class="listitem"> 126 [conceptref] for referencing BoostBook <concept> entities. 127 </li> 128<li class="listitem"> 129 Allow escape of spaces. The escaped space is removed from the output. Syntax: 130 <code class="computeroutput">\ </code>. 131 </li> 132<li class="listitem"> 133 Nested comments are now allowed. 134 </li> 135<li class="listitem"> 136 Quickbook blocks can nest inside comments. 137 </li> 138<li class="listitem"> 139 <a class="link" href="syntax/block.html#quickbook.ref.import">Import</a> facility. 140 </li> 141<li class="listitem"> 142 Callouts on imported code 143 </li> 144<li class="listitem"> 145 Simple markups can now span a whole block. 146 </li> 147<li class="listitem"> 148 <a class="link" href="syntax/block.html#quickbook.ref.blurbs">Blurbs</a>, <a class="link" href="syntax/block.html#quickbook.ref.admonitions">Admonitions</a> 149 and table cells (see <a class="link" href="syntax/block.html#quickbook.ref.tables">Tables</a>) 150 may now contain paragraphs. 151 </li> 152<li class="listitem"> 153 <code class="computeroutput">\n</code> and <code class="computeroutput">[br]</code> are now deprecated. 154 </li> 155<li class="listitem"> 156 <a class="link" href="syntax/phrase.html#quickbook.ref.cond">Conditional Generation</a>. Ala C++ 157 #ifdef. 158 </li> 159<li class="listitem"> 160 Searching of included and imported files in an extensible search path with 161 <code class="computeroutput">--include-path</code> (<code class="computeroutput">-I</code>) option. 162 </li> 163</ul></div> 164<h3> 165<a name="quickbook.change_log.h3"></a> 166 <span class="phrase"><a name="quickbook.change_log.version_1_5"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_5">Version 167 1.5 - Boost 1.41.0 to 1.42.0</a> 168 </h3> 169<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 170<li class="listitem"> 171 Support multiple copyright entrys in document info. 172 </li> 173<li class="listitem"> 174 Improved SVG support. 175 </li> 176<li class="listitem"> 177 [globalref] for referencing BoostBook <global> entities. 178 </li> 179<li class="listitem"> 180 Fail on error. 181 </li> 182<li class="listitem"> 183 Fix crash for templates with too many arguments or trailing space. 184 </li> 185<li class="listitem"> 186 Improved handling of unexpected characters in code blocks. 187 </li> 188<li class="listitem"> 189 Improved handling of unmatched escape in code blocks. 190 </li> 191<li class="listitem"> 192 Support for python snippets. 193 </li> 194<li class="listitem"> 195 <code class="computeroutput">teletype</code> source mode. 196 </li> 197<li class="listitem"> 198 Use static scoping in templates, should be a lot more intuitive. 199 </li> 200<li class="listitem"> 201 Accept a space between <code class="computeroutput">section:</code> and the section id. 202 </li> 203<li class="listitem"> 204 Support table ids. 205 </li> 206</ul></div> 207<h3> 208<a name="quickbook.change_log.h4"></a> 209 <span class="phrase"><a name="quickbook.change_log.version_1_5_1___boost_1_43_0"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_5_1___boost_1_43_0">Version 210 1.5.1 - Boost 1.43.0</a> 211 </h3> 212<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 213<li class="listitem"> 214 Improve the post processor's list of block elements. <code class="computeroutput">table</code>, 215 <code class="computeroutput">entry</code> and <code class="computeroutput">varlistentry</code> are treated as blocks. 216 <code class="computeroutput">replaceable</code> is treated as an inline element. 217 </li> 218<li class="listitem"> 219 Check that <code class="computeroutput">[section]</code> and <code class="computeroutput">[endsect]</code> tags are balanced 220 in templates. 221 </li> 222<li class="listitem"> 223 Add unicode escape characters, eg. <code class="computeroutput">\u03B1</code> for α. 224 </li> 225<li class="listitem"> 226 Support UTF-8 files with a unicode byte order mark. 227 </li> 228<li class="listitem"> 229 Disallow <code class="computeroutput">[</code> in simple markup. Fixes some errors with mismatched 230 punctuation. 231 </li> 232<li class="listitem"> 233 Add command line flag to define macros at the command line, e.g. <code class="computeroutput">quickbook 234 "-D__italic_foo__=/foo/"</code>. 235 </li> 236</ul></div> 237<h3> 238<a name="quickbook.change_log.h5"></a> 239 <span class="phrase"><a name="quickbook.change_log.version_1_5_2___boost_1_44_0"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_5_2___boost_1_44_0">Version 240 1.5.2 - Boost 1.44.0</a> 241 </h3> 242<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 243<li class="listitem"> 244 Use the cygwin 1.7 API for better path handling. 245 </li> 246<li class="listitem"> 247 Improved boostbook generation: 248 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 249<li class="listitem"> 250 XML encode the documentation info correctly. 251 </li> 252<li class="listitem"> 253 Avoid generating empty paragraphs. 254 </li> 255<li class="listitem"> 256 No longer wraps block templates in paragraphs. 257 </li> 258<li class="listitem"> 259 Warns if you use invalid doc_info members for docbook document types. 260 </li> 261<li class="listitem"> 262 Fixes some other causes of invalid boostbook, although it still generates 263 invalid boostbook in places. 264 </li> 265</ul></div> 266 </li> 267<li class="listitem"> 268 Improved grammar: 269 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 270<li class="listitem"> 271 Supports multiple categories in library doc_info. 272 </li> 273<li class="listitem"> 274 No longer requires commas between authors in docinfo. 275 </li> 276<li class="listitem"> 277 Allows empty document bodies. 278 </li> 279<li class="listitem"> 280 A line containing only a comment is no longer interpreted as a paragraph 281 break. 282 </li> 283<li class="listitem"> 284 If a line starts with a comment, interpret it as a paragraph even 285 if it's followed by whitespace or a list character. 286 </li> 287<li class="listitem"> 288 Doesn't treat several consecutive blank lines as multiple paragraph 289 breaks. 290 </li> 291</ul></div> 292 </li> 293<li class="listitem"> 294 Fixes duplicate image attribute detection. 295 </li> 296<li class="listitem"> 297 Fixes using code snippets more than once. 298 </li> 299<li class="listitem"> 300 Early work on quickbook 1.6, available using the <code class="computeroutput">[quickbook 1.6]</code> 301 version switch, but liable to change in future versions. 302 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 303<li class="listitem"> 304 When automatically generating ids for headers, use the quickbook 305 source, rather than the generated docbook. 306 </li> 307<li class="listitem"> 308 Fix id generation in included files. It wasn't correctly using the 309 main document's documentation id. 310 </li> 311<li class="listitem"> 312 Correctly restore the quickbook version switch after including a 313 file with a different version. 314 </li> 315</ul></div> 316 </li> 317</ul></div> 318<h3> 319<a name="quickbook.change_log.h6"></a> 320 <span class="phrase"><a name="quickbook.change_log.version_1_5_3___boost_1_45_0"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_5_3___boost_1_45_0">Version 321 1.5.3 - Boost 1.45.0</a> 322 </h3> 323<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 324<li class="listitem"> 325 Fix command line flag for defining macros. 326 </li> 327<li class="listitem"> 328 Fix a couple of issues with the code block parser: 329 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 330<li class="listitem"> 331 A comment with no indentation will now end a code block. 332 </li> 333<li class="listitem"> 334 Code blocks no longer have to be followed by a blank line. 335 </li> 336</ul></div> 337 </li> 338<li class="listitem"> 339 Improved tracking of file position in templates and imported code blocks. 340 </li> 341<li class="listitem"> 342 Better generated markup for callout lists. 343 </li> 344<li class="listitem"> 345 In docbook, variable list entries can only have one <code class="computeroutput">listitem</code>, 346 so if an entry has multiple values, merge them into one <code class="computeroutput">listitem</code>. 347 </li> 348<li class="listitem"> 349 Support nested code snippets. 350 </li> 351<li class="listitem"> 352 Support nested blocks in document info comments. 353 </li> 354<li class="listitem"> 355 Revert xml escaping document info, it broke some documentation files (now 356 a 1.6 feature). 357 </li> 358<li class="listitem"> 359 Further work on quickbook 1.6, still not stable. 360 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 361<li class="listitem"> 362 Allow heading to have ids, using the syntax: <code class="computeroutput">[heading:id title]</code>. 363 </li> 364<li class="listitem"> 365 XML escape documentation fields, with escapes to allow encoding unicode 366 in ASCII. 367 </li> 368</ul></div> 369 </li> 370</ul></div> 371<h3> 372<a name="quickbook.change_log.h7"></a> 373 <span class="phrase"><a name="quickbook.change_log.version_1_5_4___boost_1_46_1"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_5_4___boost_1_46_1">Version 374 1.5.4 - Boost 1.46.1</a> 375 </h3> 376<p> 377 Boost 1.46.0: 378 </p> 379<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 380<li class="listitem"> 381 Add support for <code class="computeroutput">lang</code> attribute in documentation info. 382 </li> 383<li class="listitem"> 384 Improved anchor implementation. Especially for using an anchor before a 385 section or heading. 386 </li> 387<li class="listitem"> 388 Fixed some more issues where lines containing comments were treated as 389 blank lines. 390 </li> 391<li class="listitem"> 392 Allow import, include and xinclude in conditional phrases. Will allow more 393 block elements in a future version. 394 </li> 395<li class="listitem"> 396 Rearrange the structure of the grammar. 397 </li> 398<li class="listitem"> 399 Use filesystem 3. Remove cygwin 1.5 support. 400 </li> 401</ul></div> 402<p> 403 Boost 1.46.1: 404 </p> 405<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> 406 Work around optimization bug in g++ 4.4 on 64 bit linux. 407 </li></ul></div> 408<h3> 409<a name="quickbook.change_log.h8"></a> 410 <span class="phrase"><a name="quickbook.change_log.version_1_5_5___boost_1_47"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_5_5___boost_1_47">Version 411 1.5.5 - Boost 1.47</a> 412 </h3> 413<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 414<li class="listitem"> 415 Tweak anchor placement for titles. 416 </li> 417<li class="listitem"> 418 Hard code the quickbook path into the quickbook testing tools. This means 419 that they can be used from multiple locations. 420 </li> 421<li class="listitem"> 422 Generate an id for boostbook <code class="computeroutput">bridgehead</code> elements. This results 423 in more consistent html, since docbook generates a random id if they don't 424 have one. 425 </li> 426<li class="listitem"> 427 Improved unicode support on windows. Unicode can now be used from the command 428 line, and unicode filenames are supported. Unicode output is a bit weak. 429 </li> 430<li class="listitem"> 431 Check for windows paths, and warn about them. 432 </li> 433<li class="listitem"> 434 Fix relative path detection on windows. 435 </li> 436<li class="listitem"> 437 Reverse deprecation of <code class="computeroutput">[br]</code>, printing a single warning about 438 generating invalid boostbook. 439 </li> 440<li class="listitem"> 441 Fix handling empty category attributes. 442 </li> 443<li class="listitem"> 444 Store data from the parser in a dynamic data structure. This simplifies 445 the implementation and makes it easier to parse more complicated data structures. 446 </li> 447<li class="listitem"> 448 Improved error messages for unknown doc info attributes. 449 </li> 450<li class="listitem"> 451 Richer copyright syntax. Now understands: <code class="computeroutput">[copyright 2001-2006, 2010 452 One person, 2008 Another person]</code>. 453 </li> 454<li class="listitem"> 455 Fix delimeter checking for simple markup. 456 </li> 457<li class="listitem"> 458 Allow more block elements to be nested. 459 </li> 460<li class="listitem"> 461 Go back to using invalid markup for lists. It generates better html. 462 </li> 463<li class="listitem"> 464 Better anchor placement for lists. 465 </li> 466<li class="listitem"> 467 Pass-thru comments in code snippets. 468 </li> 469<li class="listitem"> 470 Use relative paths for <code class="computeroutput">__FILENAME__</code> macro. 471 </li> 472<li class="listitem"> 473 Rewrite xinclude path generator so that it doesn't use deprecated filesystem 474 functions. 475 </li> 476<li class="listitem"> 477 Allow quickbook escapes inside comments in syntax highlighted code. 478 </li> 479<li class="listitem"> 480 Quickbook 1.6: 481 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 482<li class="listitem"> 483 Scope source mode changes to the file they're made in. 484 </li> 485<li class="listitem"> 486 Explicit markup for lists. e.g. <code class="computeroutput">[ordered_list [item1][item2]]</code> 487 or <code class="computeroutput">[itemized_list [item1][item2]]</code>. 488 </li> 489</ul></div> 490 </li> 491</ul></div> 492<h3> 493<a name="quickbook.change_log.h9"></a> 494 <span class="phrase"><a name="quickbook.change_log.version_1_5_6___boost_1_48"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_5_6___boost_1_48">Version 495 1.5.6 - Boost 1.48</a> 496 </h3> 497<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 498<li class="listitem"> 499 Xml encode escaped punctuation (eg. <code class="computeroutput">\<</code> is correctly encodes 500 to <). 501 </li> 502<li class="listitem"> 503 Rename duplicate generated ids. 504 </li> 505<li class="listitem"> 506 Close open sections at end of document (still warns about them). 507 </li> 508<li class="listitem"> 509 New anchor markup for headers, will hopefully generate better pdfs. 510 </li> 511<li class="listitem"> 512 Remove some whitespace around code from post processed output. 513 </li> 514</ul></div> 515<h3> 516<a name="quickbook.change_log.h10"></a> 517 <span class="phrase"><a name="quickbook.change_log.version_1_5_7___boost_1_49"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_5_7___boost_1_49">Version 518 1.5.7 - Boost 1.49</a> 519 </h3> 520<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 521<li class="listitem"> 522 Several internal changes. 523 </li> 524<li class="listitem"> 525 Some improved error messages. 526 </li> 527<li class="listitem"> 528 Better handling of block templates expanded in a phrase context. 529 </li> 530<li class="listitem"> 531 Avoids empty simple markup (i.e. // is not treated as an italic empty space. 532 </li> 533<li class="listitem"> 534 Better anchor markup for headers, which should be better for printing - 535 suggested by John Maddock. 536 </li> 537<li class="listitem"> 538 Further improvements to the id generator. 539 </li> 540<li class="listitem"> 541 If sections are left unopened at the end of a document, then close them 542 in the generated markup. 543 </li> 544<li class="listitem"> 545 Try to handle whitespace better at the beginning and end of code blocks. 546 </li> 547<li class="listitem"> 548 Handle lists that come immediately after an anchor. 549 </li> 550<li class="listitem"> 551 Make horizontal rules followed by multi-line comments a little more sensible. 552 </li> 553<li class="listitem"> 554 Better support for empty ids and titles in docinfo. 555 </li> 556<li class="listitem"> 557 Fix some minor regressions in SVG handling. 558 </li> 559<li class="listitem"> 560 Better handling of invalid command line macros. 561 </li> 562<li class="listitem"> 563 When auto-building quickbook, build the release version. 564 </li> 565<li class="listitem"> 566 Lots of changes for 1.6: 567 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 568<li class="listitem"> 569 Scope templates in included files. 570 </li> 571<li class="listitem"> 572 Support import of templates and macros. 573 </li> 574<li class="listitem"> 575 Including top level quickbook blocks from source files. 576 </li> 577<li class="listitem"> 578 Use doc info blocks in included quickbook files. 579 </li> 580<li class="listitem"> 581 Better handling of macros with the same name. 582 </li> 583<li class="listitem"> 584 <code class="computeroutput">block</code> element. 585 </li> 586<li class="listitem"> 587 Better handling of significant punctuation (e.g. escapes, square 588 brackets). 589 </li> 590<li class="listitem"> 591 Support escapes in links, anchors, images, includes etc. 592 </li> 593<li class="listitem"> 594 Improved table title syntax. 595 </li> 596<li class="listitem"> 597 Paragraphs nested in lists. 598 </li> 599<li class="listitem"> 600 New docinfo attributes: 601 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: square; "> 602<li class="listitem"> 603 <code class="computeroutput">compatibility-mode</code> to make it possible to upgrade 604 documents without breaking ids. 605 </li> 606<li class="listitem"> 607 <code class="computeroutput">xmlbase</code> for escaped <code class="computeroutput">xi:include</code>s. 608 </li> 609</ul></div> 610 </li> 611<li class="listitem"> 612 Allow some docinfo attributes to be used before, or without, a doc 613 info block (<code class="computeroutput">quickbook</code>, <code class="computeroutput">compatibility-mode</code>, 614 <code class="computeroutput">source-mode</code>). 615 </li> 616<li class="listitem"> 617 Only add explicit alt text to images. 618 </li> 619<li class="listitem"> 620 Don't put 'inline' code blocks inside paragraphs. 621 </li> 622</ul></div> 623 </li> 624</ul></div> 625<h3> 626<a name="quickbook.change_log.h11"></a> 627 <span class="phrase"><a name="quickbook.change_log.version_1_5_8___boost_1_50"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_5_8___boost_1_50">Version 628 1.5.8 - Boost 1.50</a> 629 </h3> 630<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 631<li class="listitem"> 632 Write dependencies to a file, using <code class="computeroutput">--output-deps</code> (<a href="https://svn.boost.org/trac/boost/ticket/6691" target="_top">#6691</a>). 633 </li> 634<li class="listitem"> 635 Fix handling of section tags in lists. 636 </li> 637<li class="listitem"> 638 Fix indented code blocks in lists. 639 </li> 640<li class="listitem"> 641 Fix handling UTF-8 code points in the syntax highlighter. Was treating 642 each individual byte as a character. Still doesn't deal with combining 643 code points. 644 </li> 645<li class="listitem"> 646 Internal changes: 647 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 648<li class="listitem"> 649 A lot of restructuring. 650 </li> 651<li class="listitem"> 652 Stop using 'v3' filesystem paths and namespaces, it's now the default 653 version. 654 </li> 655<li class="listitem"> 656 Remove awkward intrusive reference counting implementation, avoids 657 a gcc internal compiler error (<a href="http://svn.boost.org/trac/boost/ticket/6794" target="_top">#6794</a>), 658 but is also a cleaner implementation. 659 </li> 660</ul></div> 661 </li> 662<li class="listitem"> 663 1.6 changes: 664 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 665<li class="listitem"> 666 Better handling of brackets in link values. 667 </li> 668<li class="listitem"> 669 Improved handling of escaped characters in include paths. 670 </li> 671</ul></div> 672 </li> 673<li class="listitem"> 674 Starting to develop 1.7: 675 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 676<li class="listitem"> 677 Source mode for single entities. 678 </li> 679<li class="listitem"> 680 Callouts in code blocks. 681 </li> 682<li class="listitem"> 683 Escaped docbook in docinfo blocks. 684 </li> 685<li class="listitem"> 686 Starting to implement calling templates from link values. 687 </li> 688</ul></div> 689 </li> 690</ul></div> 691<h3> 692<a name="quickbook.change_log.h12"></a> 693 <span class="phrase"><a name="quickbook.change_log.version_1_5_9___boost_1_54"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_5_9___boost_1_54">Version 694 1.5.9 - Boost 1.54</a> 695 </h3> 696<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 697<li class="listitem"> 698 When code blocks are indented using a mixture of tabs and spaces, convert 699 indentation to spaces. 700 </li> 701<li class="listitem"> 702 In the C++ systax highlighter, fix syntax highlighting for <code class="computeroutput">#</code>, 703 so that it's used for preprocessor statements at the start of a line, and 704 as a 'special' character elsewhere (<a href="https://svn.boost.org/trac/boost/ticket/8510" target="_top">#8510</a>, 705 <a href="https://svn.boost.org/trac/boost/ticket/8511" target="_top">#8511</a>). 706 </li> 707<li class="listitem"> 708 Add C++11 keywords to syntax highlighter (<a href="https://svn.boost.org/trac/boost/ticket/8541" target="_top">#8541</a>). 709 </li> 710<li class="listitem"> 711 Hidden options for formatting of <code class="computeroutput">--output-deps</code>. Not really 712 for public use 713 </li> 714<li class="listitem"> 715 yet. 716 </li> 717<li class="listitem"> 718 1.6 changes: 719 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 720<li class="listitem"> 721 Better template argument parsing, so that it understands things like 722 escaped markup. 723 </li> 724<li class="listitem"> 725 Support for using macros in the doc info block. 726 </li> 727</ul></div> 728 </li> 729<li class="listitem"> 730 Internal changes: 731 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 732<li class="listitem"> 733 Convert to use <code class="computeroutput">boost::string_ref</code>. 734 </li> 735<li class="listitem"> 736 Clean up the source map implementation (used to get the correct location 737 for error messages in things like templates and snippets). 738 </li> 739</ul></div> 740 </li> 741</ul></div> 742<h3> 743<a name="quickbook.change_log.h13"></a> 744 <span class="phrase"><a name="quickbook.change_log.version_1_6_0___boost_1_55"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_6_0___boost_1_55">Version 745 1.6.0 - Boost 1.55</a> 746 </h3> 747<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 748<li class="listitem"> 749 Remove nested blocks in lists from 1.6, move to 1.7. (Can still nest block 750 elements in lists though). 751 </li> 752<li class="listitem"> 753 Don't break out of lists after a nested block element. 754 </li> 755<li class="listitem"> 756 Check for errors when writing dependency files. 757 </li> 758<li class="listitem"> 759 Improved markup for lists. 760 </li> 761<li class="listitem"> 762 Make escaping templates with a punctuation identifier illegal. Escaping 763 templates with an alphanumeric identifier is still fine. 764 </li> 765<li class="listitem"> 766 Fix detection of code blocks at the start of a file. 767 </li> 768<li class="listitem"> 769 XML encode the contents of the <code class="computeroutput">change_log.qbk</code> macro. 770 </li> 771<li class="listitem"> 772 1.7 changes: 773 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 774<li class="listitem"> 775 Make it an error to use an element in the wrong context. 776 </li> 777<li class="listitem"> 778 Error if the body of a phrase element doesn't parse. 779 </li> 780<li class="listitem"> 781 List markup in nested blocks. 782 </li> 783<li class="listitem"> 784 Allow block elements in phrase templates. 785 </li> 786<li class="listitem"> 787 Make it an error to put a paragraph break (i.e. a blank line) in 788 a phrase template. 789 </li> 790</ul></div> 791 </li> 792<li class="listitem"> 793 Internal changes: 794 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"> 795 Clean up the id manager implementation. 796 </li></ul></div> 797 </li> 798</ul></div> 799<h3> 800<a name="quickbook.change_log.h14"></a> 801 <span class="phrase"><a name="quickbook.change_log.version_1_6_1"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_6_1">Version 802 1.6.1</a> 803 </h3> 804<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 805<li class="listitem"> 806 Better URI encoding of links. 807 </li> 808<li class="listitem"> 809 Extra validation of attribute values. 810 </li> 811<li class="listitem"> 812 1.7 changes: 813 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "> 814<li class="listitem"> 815 Improved source mode tagging: 816 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: square; "> 817<li class="listitem"> 818 Works for lists and paragraphs. 819 </li> 820<li class="listitem"> 821 If the source mode is changed inside a tagged element, that 822 change will now persist after the element. 823 </li> 824<li class="listitem"> 825 Tagged sections will now use the source mode for the whole 826 section. 827 </li> 828</ul></div> 829 </li> 830<li class="listitem"> 831 Template calls from anchor, role and include elements. 832 </li> 833<li class="listitem"> 834 Stricter handling of templates called in attribute values. 835 </li> 836<li class="listitem"> 837 Glob support. 838 </li> 839</ul></div> 840 </li> 841</ul></div> 842<h3> 843<a name="quickbook.change_log.h15"></a> 844 <span class="phrase"><a name="quickbook.change_log.version_1_6_2___boost_1_61"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_6_2___boost_1_61">Version 845 1.6.2 - Boost 1.61</a> 846 </h3> 847<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> 848 Better file URL generation for <code class="computeroutput">xinclude</code>. 849 </li></ul></div> 850<h3> 851<a name="quickbook.change_log.h16"></a> 852 <span class="phrase"><a name="quickbook.change_log.version_1_6_3___boost_1_64"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_6_3___boost_1_64">Version 853 1.6.3 - Boost 1.64</a> 854 </h3> 855<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 856<li class="listitem"> 857 Improved some error messages. 858 </li> 859<li class="listitem"> 860 Fix <code class="computeroutput">--no-self-linked-headers</code> options. 861 </li> 862<li class="listitem"> 863 Hide 'debug' command line option in help text. 864 </li> 865<li class="listitem"> 866 Changes to test and build setup to support continuous integration. 867 </li> 868<li class="listitem"> 869 Fix a crash when templates are called with no arguments. Only affected 870 files with quickbook version less than 1.5. 871 </li> 872</ul></div> 873<h3> 874<a name="quickbook.change_log.h17"></a> 875 <span class="phrase"><a name="quickbook.change_log.version_1_6_4___boost_1_65"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_6_4___boost_1_65">Version 876 1.6.4 - Boost 1.65</a> 877 </h3> 878<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 879<li class="listitem"> 880 Changes to all language versions: 881 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"> 882 <code class="computeroutput">endsect</code> can now have an id, if it doesn't match the 883 current section it's an error. 884 </li></ul></div> 885 </li> 886<li class="listitem"> 887 1.7 changes: 888 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"> 889 Can now write out conditional content if a macro isn't defined, using 890 <code class="computeroutput">[?!macro_name content]</code>. 891 </li></ul></div> 892 </li> 893<li class="listitem"> 894 Support for strict parsing using the <code class="computeroutput">--strict</code> paramters. This 895 is still under development so new errors could be added. 896 </li> 897<li class="listitem"> 898 <code class="computeroutput">--no-output</code> command line parameter to process the quickbook 899 documents but not actually generate any files. 900 </li> 901</ul></div> 902<h3> 903<a name="quickbook.change_log.h18"></a> 904 <span class="phrase"><a name="quickbook.change_log.version_1_7_0___boost_1_66"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_7_0___boost_1_66">Version 905 1.7.0 - Boost 1.66</a> 906 </h3> 907<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 908<li class="listitem"> 909 Last version to compile with C++03. 910 </li> 911<li class="listitem"> 912 Minor improvements to some warning and error messages. 913 </li> 914<li class="listitem"> 915 Stopped normalizing paths in dependency lists. 916 </li> 917<li class="listitem"> 918 Fix xmlbase when it's the same directory as the existing xinclude base. 919 </li> 920</ul></div> 921<h3> 922<a name="quickbook.change_log.h19"></a> 923 <span class="phrase"><a name="quickbook.change_log.version_1_7_1___boost_1_67"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_7_1___boost_1_67">Version 924 1.7.1 - Boost 1.67</a> 925 </h3> 926<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 927<li class="listitem"> 928 Now uses C++11, no longer tested with C++03 compilers. 929 </li> 930<li class="listitem"> 931 Fix parsing escaped docbook with the new version of Spirit. 932 </li> 933<li class="listitem"> 934 Reformatted code with clang-format. 935 </li> 936</ul></div> 937<h3> 938<a name="quickbook.change_log.h20"></a> 939 <span class="phrase"><a name="quickbook.change_log.version_1_7_2___boost_1_68"></a></span><a class="link" href="change_log.html#quickbook.change_log.version_1_7_2___boost_1_68">Version 940 1.7.2 - Boost 1.68</a> 941 </h3> 942<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 943<li class="listitem"> 944 More use of C++11 features. 945 </li> 946<li class="listitem"> 947<p class="simpara"> 948 Some basic direct generation of HTML (i.e. without using BoostBook). At 949 the command line use <code class="computeroutput">--output-format html</code> to generate chunked 950 HTML, <code class="computeroutput">--output-format onehtml</code> to generate a single HTML page. 951 </p> 952<p class="simpara"> 953 It's also useful to pass the path to the root of the boost distribution 954 using the <code class="computeroutput">--boost-root path</code> option. Or to use outside of boost, 955 the <code class="computeroutput">--css-path</code> and <code class="computeroutput">--graphics-path</code> options. 956 </p> 957<p class="simpara"> 958 While this isn't ready for production, it might be useful to quickly preview 959 changes to quickbook documentation, especially if you don't have boostbook 960 set up. 961 </p> 962</li> 963</ul></div> 964</div> 965<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> 966<td align="left"></td> 967<td align="right"><div class="copyright-footer">Copyright © 2002, 2004, 2006 Joel de Guzman, 968 Eric Niebler<br>Copyright © 2010-2017 Daniel James<p> 969 Distributed under the Boost Software License, Version 1.0. (See accompanying 970 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>) 971 </p> 972</div></td> 973</tr></table> 974<hr> 975<div class="spirit-nav"> 976<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="command_line.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> 977</div> 978</body> 979</html> 980
