Change Log

First version to be included in boost.

Quickbook file inclusion [include].
Better xml output (pretty layout). Check out the generated XML.
Regression testing facility: to make sure your document will always be compatible (full backward compatibility) regardless of changes to QuickBook.
Code cleanup and refactoring.
Allow phrase markup in the doc-info.
Preformatted code blocks via ``code`` (double ticks) allows code in tables and lists, for example.
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.
Better (intuitive) paragraph termination. Some markups may terminate a paragraph. Example:
```
[section x]
blah...
[endsect]
```
Fully qualified section and headers. Subsection names are concatenated to the ID to avoid clashing. Example: doc_name.sect_name.sub_sect_name.sub_sub_sect_name
Better   and whitespace handling in code snippets.
[xinclude] fixes up the relative path to the target XML file when input_directory is not the same as the output_directory.
Allow untitled tables.
Allow phrase markups in section titles.
Allow escaping back to QuickBook from code, code blocks and inline code.
Footnotes, with the [footnote This is the footnote] syntax.
Post-processor bug fix for escaped XML code that it does not recognize.
Replaceable, with the [~replacement] syntax.

Generic Headers
Code changes to allow full recursion (i.e. Collectors and push/pop functions)
Various code cleanup/maintenance
Templates!
[conceptref] for referencing BoostBook <concept> entities.
Allow escape of spaces. The escaped space is removed from the output. Syntax: \ .
Nested comments are now allowed.
Quickbook blocks can nest inside comments.
Import facility.
Callouts on imported code
Simple markups can now span a whole block.
Blurbs, Admonitions and table cells (see Tables) may now contain paragraphs.
\n and [br] are now deprecated.
Conditional Generation. Ala C++ #ifdef.
Searching of included and imported files in an extensible search path with --include-path (-I) option.

Support multiple copyright entrys in document info.
Improved SVG support.
[globalref] for referencing BoostBook <global> entities.
Fail on error.
Fix crash for templates with too many arguments or trailing space.
Improved handling of unexpected characters in code blocks.
Improved handling of unmatched escape in code blocks.
Support for python snippets.
teletype source mode.
Use static scoping in templates, should be a lot more intuitive.
Accept a space between section: and the section id.
Support table ids.

Improve the post processor's list of block elements. table, entry and varlistentry are treated as blocks. replaceable is treated as an inline element.
Check that [section] and [endsect] tags are balanced in templates.
Add unicode escape characters, eg. \u03B1 for α.
Support UTF-8 files with a unicode byte order mark.
Disallow [ in simple markup. Fixes some errors with mismatched punctuation.
Add command line flag to define macros at the command line, e.g. quickbook "-D__italic_foo__=/foo/".

Use the cygwin 1.7 API for better path handling.
Improved boostbook generation:
- XML encode the documentation info correctly.
- Avoid generating empty paragraphs.
- No longer wraps block templates in paragraphs.
- Warns if you use invalid doc_info members for docbook document types.
- 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.
- Doesn't treat several consecutive blank lines as multiple paragraph breaks.
Fixes duplicate image attribute detection.
Fixes using code snippets more than once.
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 main document's documentation id.
- Correctly restore the quickbook version switch after including a file with a different version.

Fix command line flag for defining macros.
Fix a couple of issues with the code block parser:
- A comment with no indentation will now end a code block.
- Code blocks no longer have to be followed by a blank line.
Improved tracking of file position in templates and imported code blocks.
Better generated markup for callout lists.
In docbook, variable list entries can only have one listitem, so if an entry has multiple values, merge them into one listitem.
Support nested code snippets.
Support nested blocks in document info comments.
Revert xml escaping document info, it broke some documentation files (now a 1.6 feature).
Further work on quickbook 1.6, still not stable.
- Allow heading to have ids, using the syntax: [heading:id title].
- XML escape documentation fields, with escapes to allow encoding unicode in ASCII.

Add support for lang attribute in documentation info.
Improved anchor implementation. Especially for using an anchor before a section or heading.
Fixed some more issues where lines containing comments were treated as blank lines.
Allow import, include and xinclude in conditional phrases. Will allow more block elements in a future version.
Rearrange the structure of the grammar.
Use filesystem 3. Remove cygwin 1.5 support.

Work around optimization bug in g++ 4.4 on 64 bit linux.

Tweak anchor placement for titles.
Hard code the quickbook path into the quickbook testing tools. This means that they can be used from multiple locations.
Generate an id for boostbook bridgehead elements. This results in more consistent html, since docbook generates a random id if they don't have one.
Improved unicode support on windows. Unicode can now be used from the command line, and unicode filenames are supported. Unicode output is a bit weak.
Check for windows paths, and warn about them.
Fix relative path detection on windows.
Reverse deprecation of [br], printing a single warning about generating invalid boostbook.
Fix handling empty category attributes.
Store data from the parser in a dynamic data structure. This simplifies the implementation and makes it easier to parse more complicated data structures.
Improved error messages for unknown doc info attributes.
Richer copyright syntax. Now understands: [copyright 2001-2006, 2010 One person, 2008 Another person].
Fix delimeter checking for simple markup.
Allow more block elements to be nested.
Go back to using invalid markup for lists. It generates better html.
Better anchor placement for lists.
Pass-thru comments in code snippets.
Use relative paths for __FILENAME__ macro.
Rewrite xinclude path generator so that it doesn't use deprecated filesystem functions.
Allow quickbook escapes inside comments in syntax highlighted code.
Quickbook 1.6:
- Scope source mode changes to the file they're made in.
- Explicit markup for lists. e.g. [ordered_list [item1][item2]] or [itemized_list [item1][item2]].

Xml encode escaped punctuation (eg. \< is correctly encodes to <).
Rename duplicate generated ids.
Close open sections at end of document (still warns about them).
New anchor markup for headers, will hopefully generate better pdfs.
Remove some whitespace around code from post processed output.

Several internal changes.
Some improved error messages.
Better handling of block templates expanded in a phrase context.
Avoids empty simple markup (i.e. // is not treated as an italic empty space.
Better anchor markup for headers, which should be better for printing - suggested by John Maddock.
Further improvements to the id generator.
If sections are left unopened at the end of a document, then close them in the generated markup.
Try to handle whitespace better at the beginning and end of code blocks.
Handle lists that come immediately after an anchor.
Make horizontal rules followed by multi-line comments a little more sensible.
Better support for empty ids and titles in docinfo.
Fix some minor regressions in SVG handling.
Better handling of invalid command line macros.
When auto-building quickbook, build the release version.
Lots of changes for 1.6:
- Scope templates in included files.
- Support import of templates and macros.
- Including top level quickbook blocks from source files.
- Use doc info blocks in included quickbook files.
- Better handling of macros with the same name.
- block element.
- Better handling of significant punctuation (e.g. escapes, square brackets).
- Support escapes in links, anchors, images, includes etc.
- Improved table title syntax.
- Paragraphs nested in lists.
- New docinfo attributes:
  - compatibility-mode to make it possible to upgrade documents without breaking ids.
  - xmlbase for escaped xi:includes.
- Allow some docinfo attributes to be used before, or without, a doc info block (quickbook, compatibility-mode, source-mode).
- Only add explicit alt text to images.
- Don't put 'inline' code blocks inside paragraphs.

Change Log

Version 1.1 - Boost 1.33.0

Version 1.3 - Boost 1.34.0 to 1.34.1

Version 1.4 - Boost 1.35.0 to 1.40.0

Version 1.5 - Boost 1.41.0 to 1.42.0

Version 1.5.1 - Boost 1.43.0

Version 1.5.2 - Boost 1.44.0

Version 1.5.3 - Boost 1.45.0

Version 1.5.4 - Boost 1.46.1

Version 1.5.5 - Boost 1.47

Version 1.5.6 - Boost 1.48

Version 1.5.7 - Boost 1.49