mizuho 0.9.6 → 0.9.8

data/README.markdown

@@ -29,13 +29,15 @@ multi-page XHTML output support and support for multiple templates.
  * hpricot (`gem install hpricot`)
  * Python (because Asciidoc is written in Python)
  * [GNU Source-highlight](http://www.gnu.org/software/src-highlite/), if you
-   want syntax highlighting support
+   want syntax highlighting support. If you're on OS X then it's not necessary
+   to install this yourself; we've bundled a precompiled source-highlight
+   binary for OS X for your convenience.
 
 ## Installation
 
 Run the following command as root:
 
-    gem install FooBarWidget-mizuho
+    gem install mizuho
 
 ## Usage
 

data/Rakefile

@@ -1,41 +1,4 @@
-require 'rake/gempackagetask'
-
 desc "Run unit tests"
 task :test do
 	ruby "-S spec -f s -c test/*_spec.rb"
 end
-
-desc "Build a gem and install it"
-task :install => :gem do
-	File.read("mizuho.gemspec") =~ /s\.version = \"(.*?)\"/
-	version = $1
-	ruby "-S gem install mizuho-#{version}.gem"
-end
-
-spec = Gem::Specification.new do |s|
-	s.name = "mizuho"
-	s.version = "0.9.6"
-	s.summary = "Mizuho documentation formatting tool"
-	s.email = "hongli@phusion.nl"
-	s.homepage = "http://github.com/FooBarWidget/mizuho/tree/master"
-	s.description = "A documentation formatting tool. Mizuho converts Asciidoc input files into nicely outputted HTML, possibly one file per chapter. Multiple templates are supported, so you can write your own."
-	s.has_rdoc = false
-	s.executables = ["mizuho", "mizuho-asciidoc"]
-	s.authors = ["Hongli Lai"]
-	s.add_dependency("hpricot")
-	
-	s.files = FileList[
-		"README.markdown", "LICENSE.txt", "Rakefile",
-		"bin/*",
-		"lib/**/*",
-		"test/*",
-		"templates/*",
-		"asciidoc/**/*",
-		"source-highlight/**/*"
-	]
-end
-
-Rake::GemPackageTask.new(spec) do |pkg|
-	pkg.need_zip = false
-	pkg.need_tar = false
-end

data/asciidoc/BUGS

@@ -1,33 +1,24 @@
                             Bugs and Known Problems
 
-   version 8.3.3, 2 January 2009
+   version 8.6.5, 20 May 2011
      __________________________________________________________________
 
 1. AsciiDoc
 
+     * Configuration attribute entries are not passed to table asciidoc
+       filters because configuration attribute entries cannot be passed to
+       the --attributes command-line parameter.
      * A benign warning with will become a reserved keyword in Python 2.6
-       sometimes occurs when using Python 2.5 -- it's harmless and will
+       sometimes occurs when using Python 2.5 — it’s harmless and will
        disappear with Python 3.
-     * The toc attribute will be ignored if it's set in a custom user or
-       document configuration file. This is because the default
-       configuration file containing the document [header] is sourced
-       before custom configuration files and the toc attribute is
-       processed using conditional inclusion macros.
      * Reported line numbers in diagnostic messages are sometimes wrong.
-     * Embedding open brace characters { in argument values can cause
-       incorrect argument substitution.
-     * Attribute references in macro attribute lists can't be unescaped
+     * Attribute references in macro attribute lists can’t be unescaped
        (with the exception of attribute list entry {0}).
      * Section numbering is incorrect when outputting HTML from a
        multi-part book type document. This is not a biggy since multi-part
        books are generally processed to DocBook.
      * A row of apostrophes in an inline context throws AsciiDoc into an
-       endless loop.
-     * Multiple comma separated command names in the manpage NAME section
-       translate to a single DocBook refname instead of multiple refname
-       elements.
-     * Escaping quoted text and macros is sometimes tricky owing to some
-       macro and quoting ambiguities.
+       endless loop. The problem seems to be in the input file Reader.
      __________________________________________________________________
 
 2. dblatex
@@ -35,5 +26,5 @@
    See ./dblatex/dblatex-readme.txt.
      __________________________________________________________________
 
-   Version 8.3.3
-   Last updated 2009-01-02 12:45:15 NZDT
+   Version 8.6.5
+   Last updated 2011-05-02 10:15:25 NZST

data/asciidoc/BUGS.txt

@@ -3,29 +3,20 @@ Bugs and Known Problems
 
 AsciiDoc
 --------
+- Configuration attribute entries are not passed to table asciidoc
+  filters because configuration attribute entries cannot be passed to
+  the `--attributes` command-line parameter.
 - A benign warning 'with will become a reserved keyword
   in Python 2.6' sometimes occurs when using Python 2.5 -- it's
   harmless and will disappear with Python 3.
-- The `toc` attribute will be ignored if it's set in a custom user or
-  document configuration file. This is because the default
-  configuration file containing the document `[header]` is sourced
-  before custom configuration files and the `toc` attribute is
-  processed using conditional inclusion macros.
 - Reported line numbers in diagnostic messages are sometimes wrong.
-- Embedding open brace characters `{` in argument values can cause
-  incorrect argument substitution.
 - Attribute references in macro attribute lists can't be unescaped
-  (with the exception of attribute list entry `\{0}`).
+  (with the exception of attribute list entry `{0}`).
 - Section numbering is incorrect when outputting HTML from a
   multi-part book type document. This is not a biggy since multi-part
   books are generally processed to DocBook.
 - A row of apostrophes in an inline context throws AsciiDoc into an
-  endless loop.
-- Multiple comma separated command names in the manpage NAME section
-  translate to a single DocBook `refname` instead of multiple
-  `refname` elements.
-- Escaping quoted text and macros is sometimes tricky owing to some
-  macro and quoting ambiguities.
+  endless loop. The problem seems to be in the input file 'Reader'.
 
 dblatex
 -------

data/asciidoc/CHANGELOG

@@ -1,21 +1,1089 @@
                                AsciiDoc ChangeLog
 
-   version 8.3.3, 2 January 2009
+   version 8.6.5, 20 May 2011
      __________________________________________________________________
 
-1. Version 8.3.3 (2009-01-02)
+1. Version 8.6.5 (2011-05-08)
 
-   This release supercedes 8.3.2.
+   Additions and changes
+     * A new flask theme for xhtml11 and html5 backends. A shameless
+       knock-off of the [1]Flask website styling.
+     * Added HTML 5 article with toc2 table of contents to the example on
+       the AsciiDoc website home page.
+     * Added filters and topics help topics. Fixed documentation errors in
+       help text. Patch submitted by Lionel Orry, see:
+       [2]http://groups.google.com/group/asciidoc/browse_thread/thread/9da
+       9d48a6461ff14
+     * Pass parent configuration files, command-line attributes and header
+       attributes to table asciidoc filters. Based on patch submitted by
+       Simon Ruderich, see:
+       [3]http://groups.google.com/group/asciidoc/browse_thread/thread/5c7
+       92cbb395b753b
+     * Allow a title attribute entry in the document header so that HTML
+       backends can set the title element separately from the displayed
+       document title (the doctitle attribute).
+     * Pass lang attribute to asciidoc table style filter. Patch submitted
+       by Simon Ruderich, see:
+       [4]http://groups.google.com/group/asciidoc/browse_thread/thread/e21
+       00b7cb29283ce
+     * xhtml11,html5: Added toc2 attribute which generates a scrollable
+       table of contents in the left hand margin. Based on customized CSS
+       written by Suraj Kurapati, see
+       [5]http://groups.google.com/group/asciidoc/browse_thread/thread/c5e
+       30ee5555877f5
+     * Added asciidoc-confdir intrinsic attribute which expands to the
+       global conf directory.
+     * Documented that you can specify multiple CSS files with the a2x(1)
+       --stylesheet command option. See:
+       [6]http://groups.google.com/group/asciidoc/browse_thread/thread/baf
+       3218551d05a05
+     * Improved xhtml11 backend’s table of contents generation latency.
+       Patch submitted by Hongli Lai. See:
+       [7]http://groups.google.com/group/asciidoc/browse_thread/thread/5a7
+       fe64fbfd65ad
+     * Added html5 backend.
+     * For consistency converted all DOS formatted configuration and text
+       files to UNIX format.
+     * html4: Added ability to use role attribute with most block
+       elements. Patch contributed by Simon Ruderich. See
+       [8]http://groups.google.com/group/asciidoc/browse_thread/thread/562
+       0ba634fdb030a
+     * Added Dutch language configuration file and accompanying test file
+       (contributed by Dag Wieers, see
+       [9]http://groups.google.com/group/asciidoc/browse_thread/thread/f96
+       9b9ce987d7f5d).
+     * Configuration files are loaded in two passes when the -e
+       command-line option is used (the same behavior as when the -e
+       option is not used). Patch submitted by haad. See
+       [10]http://groups.google.com/group/asciidoc/browse_thread/thread/cd
+       0f47495fd04181 and
+       [11]http://code.google.com/p/asciidoc/issues/detail?id=6&q=label%3A
+       Priority-Medium
+     * Documented how to include embedded fonts in an EPUB document.
+     * a2x: Added .<ext>=<mimetype> resource specifier syntax.
+     * a2x: Enable admonition icons in example EPUBs.
+     * a2x: allow environment variables and tilde home directories in
+       resource manifest files.
+     * a2x: don’t process non-existent resource directories.
+     * a2x: assume resource option is a directory if the name ends with a
+       directory separator.
+     * a2x: Added a new syntax to the --resource option specifier which
+       allows the destination path to be specified.
+     * a2x: Copy resources referenced in the OPF and resources referenced
+       by the generated HTML (in theory DocBook XSL should ensure they are
+       identical but this is not always the case e.g.
+       [12]http://sourceforge.net/tracker/?func=detail&atid=373747&aid=285
+       4075&group_id=21935).
+     * Drop border from callout list image links.
+     * html4: Moved manpage NAME section out of header so that the name
+       section is rendered when the asciidoc(1) --no-header-footer option
+       is specified (so that manpages processed blogpost include the NAME
+       section).
+     * Vim syntax highlighter: TODO markers now appear in list items and
+       literal paragraphs and blocks.
+     * Constrained quotes can now be bounded on the left by a } character.
+       See:
+       [13]http://groups.google.com/group/asciidoc/browse_thread/thread/b2
+       4cc3362f35b801
+     * Added text-decoration roles (underline, overline, line-through,
+       blink) for xhtml11 and html5 outputs.
+
+   Bug fixes
+     * FIXED: epubcheck 1.1 previously issued a warning for files not
+       registered in the manifest (epubcheck 1.0.5 did not). This resulted
+       in a problem compiling the adventures-of-sherlock-holmes.txt
+       example (the underline.png resource was not in the manifest).
+     __________________________________________________________________
+
+2. Version 8.6.4 (2011-02-20)
+
+   Additions and changes
+     * Added text foreground and background color along with text size CSS
+       styles for XHTML outputs, see
+       [14]http://www.methods.co.nz/asciidoc/userguide.html#X96.
+     * Vim syntax highlighter: highlight macros that start with an
+       attribute reference (a common idiom).
+     * Vim syntax highlighter: highlight attribute references in macro
+       attribute lists.
+     * Attribute entries can be used to set configuration markup
+       templates.
+     * Double-width East Asian characters in titles now correctly match
+       the title underline widths. Submitted by Changjian Gao (see
+       [15]http://groups.google.com/group/asciidoc/browse_thread/thread/77
+       f28b0dfe60d262).
+     * Implemented [16]asciidoc(1) filter commands, see:
+       [17]http://groups.google.com/group/asciidoc/browse_thread/thread/40
+       c64cd33ee1905c
+     * User’s home directory now calculated in a platform independent
+       manner.
+     * Added double-quote characters to French language file. Patch
+       contributed Yves-Alexis Perez, see:
+       [18]http://groups.google.com/group/asciidoc/browse_thread/thread/e1
+       5282f072413940
+     * Vim Syntax highlighter: Highlight closing OpenBlocks which
+       immediately follow a literal paragraph.
+     * Changed UNIX /dev/null to OS independent os.devnull in filters
+       code. Suggested by Henrik Maier:
+       [19]http://groups.google.com/group/asciidoc/browse_thread/thread/5a
+       c8e8ea895147e9
+     * Vim syntax highlighter: Single and double quoted text now
+       highlights correctly when preceded by an attributes list.
+     * Added Ukrainian language file (lang-uk.conf). Added double-quote
+       characters to Russian language file.conf). Patches contributed by
+       Lavruschenko Oleksandr, see
+       [20]http://groups.google.com/group/asciidoc/browse_thread/thread/e1
+       5282f072413940
+     * Single and double quote characters are now set using the {lsquo},
+       {rsquo}, {ldquo} and {rdquo} attributes. This makes is easy to
+       customise language specific quotes. See:
+       [21]http://groups.google.com/group/asciidoc/browse_thread/thread/e1
+       5282f072413940
+     * Implemented conf-files attribute to allow configuration files to be
+       specified in the source document. Suggested by Lex Trotman, see:
+       [22]http://groups.google.com/group/asciidoc/browse_thread/thread/b1
+       1066a828ab45b9
+
+   Bug fixes
+     * FIXED: Auto-generated section title ids are now Unicode aware.
+     * FIXED: Setting quotes configuration entries using document
+       attribute entries failed if the attribute entry was not in the
+       document header. See:
+       [23]http://groups.google.com/group/asciidoc/browse_thread/thread/a1
+       dd0562dee8b939
+     * FIXED: If the input and output file names were different then the
+       output file name was incorrectly used to synthesize docinfo file
+       names. Reported by Christian Zuckschwerdt.
+     * FIXED: An error can occur when more than one consecutive quotes are
+       defined as a blank string. Reported by Peggy Russell.
+     * FIXED: Encoding error in automatically generated author initials.
+       Patch submitted by Xin Wang. See:
+       [24]http://groups.google.com/group/asciidoc/browse_thread/thread/f4
+       4615dca0b834e9
+     __________________________________________________________________
+
+3. Version 8.6.3 (2010-11-14)
+
+   Additions and changes
+     * Added and unbreakable option to bulleted and numbered lists (thanks
+       to Henrik Maier for this patch).
+     * Added ifeval::[] system macro (thanks to Henrik Maier for
+       suggesting this feature).
+     * The image scale attribute sets the DocBook imagedata element scale
+       attribute. Patch submitted by Henrik Maier.
+     * DocBook preface, colophon and dedication style section titles now
+       work. Based on patch submitted by Henrik Maier.
+     * a2x: Do not inject xsltproc parameters if they were specified on
+       the command-line (parameter double-ups generate xsltproc Global
+       parameter already defined errors).
+     * a2x: Refactored xsltproc parameter injection.
+     * a2x: articles chunked at section level by default.
+     * attributes, titles and specialcharacters sections are now read from
+       the local asciidoc.conf file before the header is parsed. This
+       fixes a regression problem. See
+       [25]http://groups.google.com/group/asciidoc/browse_thread/thread/1b
+       3f88f1f8118ab3
+     * Document header attributes take precedence over configuration file
+       attributes.
+     * Refactored music, graphviz and latex filter configurations.
+     * Refactored source filter configuration and added literal paragraph
+       source style.
+     * Separated paragraph styles from paragraph syntax — any style can be
+       applied to any syntax.
+     * Added listing and quote paragraph styles.
+     * Renamed paragraph default style to normal.
+     * Updated --help option text.
+     * a2x: The asciidoc_opts, dblatex_opts, fop_opts and xsltproc_opts
+       command-line options can be specified multiple times. This makes
+       embedding multiple a2x options in document headers easier to manage
+       and less error prone.
+     * Added ASCIIMathML and LaTeXMathML support to slidy backend.
+     * Pass the encoding attribute to the Pygments source highlight filter
+       command.
+     * a2x: HTML Help .hhk file named after AsciiDoc source file.
+     * a2x: Added --xsl-file option to allow custom XSL stylesheets to be
+       specified.
+     * Make builds the man pages. Patch submitted by Sebastian Pipping.
+       See
+       [26]http://groups.google.com/group/asciidoc/browse_thread/thread/c2
+       1c2902c29bae64
+
+   Bug fixes
+     * FIXED: Sometimes double backquotes were misinterpreted as inline
+       literal macros. See:
+       [27]http://groups.google.com/group/asciidoc/browse_thread/thread/f5
+       10ea82a88aaee8
+     * FIXED: Regression in 8.6.2: command-line attributes were not
+       available to the global asciidoc.conf.
+     * FIXED: Postponed document title substitutions until backend conf
+       files have been loaded (8.6.2 regression). See
+       [28]http://groups.google.com/group/asciidoc/browse_thread/thread/42
+       b63ce90c2563b8
+     * FIXED: The XSL Stylesheets customizations were preventing chapter
+       and section level TOCs from being generated when using XSL
+       Stylesheets via a2x. See
+       [29]http://groups.google.com/group/asciidoc/browse_thread/thread/42
+       b63ce90c2563b8
+     * FIXED: “UnicodeDecodeError: 'ascii' codec can’t decode byte” error.
+       This error is due to a limitation in the Python HTMLParser module,
+       see: [30]http://bugs.python.org/issue3932
+     * FIXED: Broken --no-conf option (8.6.2 regression).
+     * FIXED: Regression in 8.6.2: configuration attribute entries set in
+       the document header may cause a FAILED: incomplete configuration
+       files error.
+     * FIXED: html4: corrected self closed meta tags.
+     * FIXED: a2x regression in 8.6.2: HTML Help .hhp file name had
+       reverted to default name instead of the AsciiDoc source file name.
+       See:
+       [31]http://groups.google.com/group/asciidoc/browse_thread/thread/de
+       dc961b23e9ac56
+     * FIXED: Attributes in man page title caused it to be dropped
+       resulting in invalid DocBook output.
+     * FIXED: make uninstall now deletes the asciidoc.1 and a2x.1 man
+       pages.
+     __________________________________________________________________
+
+4. Version 8.6.2 (2010-10-03)
+
+   Additions and changes
+     * docbook45: Enclosed bibliographic lists in a bibliodiv — you can
+       now include block titles with bibliographic lists.
+     * Added optional keywords, description and title document header
+       meta-data attributes to HTML backends for SEO.
+     * AttributeEntry values can span multiple lines with a ' +' line
+       continuation.
+     * Added slidy backend (based on Phillip Lord’s slidy backend
+       [32]https://phillordbio-asciidoc-fixes.googlecode.com/hg/).
+     * Implemented OpenBlock partintro style for book part introductions.
+     * Comment lines substitute special characters only.
+     * Backend specific global configuration files (all except
+       asciidoc.conf) are loaded after the header has been parsed —
+       virtually any attribute can now be specified in the document
+       header.
+     * xhtml11: Volnitsky theme: allow bulleted lists to have intervening
+       children.
+     * xhtml11: refactored CSS font-family rules to start of file.
+     * xhtml11: list bullets colored gray.
+     * ifdef and ifndef system block macros accept multiple attribute
+       names: multiple names separated by commas are ored; multiple
+       attribute names separated by pluses are anded.
+     * xhtml11: Volnitsky theme: set max-width on labeled lists.
+     * Vim syntax highlighter: Entities inside quoted text are now
+       highlighted.
+     * Added role and id attributes to HTML outputs generated by
+       OpenBlocks.
+     * Allow floating titles to generate h1 (level 0) titles in HTML
+       outputs.
+     * Added a start attribute to numbered lists to set the start number.
+       See:
+       [33]http://groups.google.com/group/asciidoc/browse_thread/thread/c1
+       4a4c3b1e4f6dc5
+     * Added two more docinfo attributes docinfo1 and docinfo2 to allow
+       and control inclusion of a shared docinfo file. See
+       [34]http://groups.google.com/group/asciidoc/browse_thread/thread/c9
+       48697943432e24
+     * Vim syntax highlighter highlights multi-name conditional
+       attributes.
+     * LaTeX backend patch submitted by Andreas Hermann Braml (see
+       [35]http://groups.google.com/group/asciidoc/browse_thread/thread/1c
+       415fc4540ce5e5).
+     * Implemented backend aliases; renamed docbook.conf to docbook45.conf
+       and aliased docbook45 backend to docbook; aliased xhtml11 to html.
+
+   Bug fixes
+     * FIXED: Filter commands located in filter directories local to the
+       source document that where not in the search PATH where not found.
+     * FIXED: Volnitsky theme: Verseblock font set normal instead of
+       monospaced.
+     * FIXED: xhtml11: Callout icons were not rendered as Data URIs when
+       icons and data-uri attributes were specified.
+     * FIXED: Long standing bug: nested include macros did not restore the
+       parent document infile and indir attributes. See:
+       [36]http://groups.google.com/group/asciidoc/browse_thread/thread/87
+       12a95e95a292a7
+     * FIXED: html4: set preamble ID anchor.
+     * FIXED: xhtml11: dropped unusable id and role attributes from
+       preamble template.
+     * FIXED: Bug in multi-name conditional attributes e.g. {x,y#} fails
+       if x or y is undefined.
+     * FIXED: latex filter not being installed by Makefile. Thanks to
+       Grant Edwards for this patch. See
+       [37]http://groups.google.com/group/asciidoc/browse_thread/thread/c4
+       427a3902d130a8
+     * FIXED: a2x: Long-standing bug in a2x which always passes
+       --string-param navig.graphics 0 to xsltproc, regardless of whether
+       icons are enabled or not. Reported by Michael Wild:
+       [38]http://groups.google.com/group/asciidoc/browse_thread/thread/59
+       a610068e4acb58
+     __________________________________________________________________
+
+5. Version 8.6.1 (2010-08-22)
+
+   Additions and changes
+     * a2x: --resource-dir option renamed to --resource.
+     * a2x: --resource option accepts both file and directory names.
+     * a2x: Added -m,--resource-manifest option.
+     * Added Vim syntax highlighting for quote attribute lists.
+     * Load asciidoc.conf from all configuration directories before any
+       other configuration files. This ensures that attributes used for
+       conditional inclusion are set before backend configuration files
+       are processed. Previously if you wanted to control global conf file
+       inclusion your only choice was to modify the global asciidoc.conf
+       file.
+     * AsciiDoc Quote element attributes have been simplified and
+       generalized — positional color and size attributes and named role
+       attribute have been replaced by a single positional attribute.
+
+   Bug fixes
+     * FIXED: testasciidoc.py: BACKEND command argument was being ignored.
+     * FIXED: Broken docinfo file functionality in html4 and xhtml11
+       backends (previously the docinfo file was included in the body
+       instead of the header).
+
+  5.1. Regression issues
+
+   This release breaks compatibility with quoted element positional color
+   and size attributes (HTML backends). To revert to the deprecated quote
+   behavior define the deprecated-quotes attribute in the global
+   asciidoc.conf file or on the command-line. For a more detailed
+   explanation of the rationale behind this change see
+   [39]http://groups.google.com/group/asciidoc/browse_thread/thread/b22603
+   bfb879418c.
+     __________________________________________________________________
+
+6. Version 8.6.0 (2010-08-16)
+
+   Additions and changes
+     * The AsciiDoc distribution can now be built “out of the box” from
+       the distribution tarball or the Mercurial repository (provided you
+       have the requisite build applications installed).
+     * The global configuration files directory is ignored by both
+       asciidoc and a2x if AsciiDoc configuration files are installed in
+       the same directory as the asciidoc executable. This change allows
+       both a system wide copy and multiple local copies of AsciiDoc to
+       coexist on the same host PC.
+     * CSS quirks mode is no longer the default xhtml11 output
+       ([40]http://groups.google.com/group/asciidoc/browse_thread/thread/1
+       c02d27d49221aa2).
+     * Relaxed anchor ID name syntax
+       ([41]http://groups.google.com/group/asciidoc/browse_thread/thread/5
+       f3e825c74ed30c).
+     * Added document files: doc/epub-notes.txt,
+       doc/publishing-ebooks-with-asciidoc.txt.
+     * a2x: If all other resource locations are exhausted then recursively
+       search directories named images and stylesheets in the asciidoc
+       configuration files directory.
+     * a2x: options can also be set in the AsciiDoc source file. If the
+       source file contains a line beginning with // a2x: then the
+       remainder of the line will be treated as a2x command-line options.
+     * Added dblatex table-width processing instruction — tables generated
+       by dblatex now observe the AsciiDoc table width as a percentage
+       (thanks to Gustav Broberg for suggesting this enhancement).
+     * a2x: Don’t exit if the --epubcheck option is set and epubcheck is
+       missing, issue warning and continue.
+     * Added a global plaintext attribute for dealing with large amounts
+       of imported text.
+     * The author name format has been relaxed, if the the author does not
+       match the formal specification then it is assigned to the firstname
+       attribute (previously asciidoc exited with an error message).
+     * FAQ and documentation updates.
+     * Refactored chunked.xsl and epub.xsl files.
+     * Exchanged article.epub for more relevant book.epub on website.
+     * Put asciidoc.epub User Guide on website.
+     * a2x: Chunking EPUB and HTML outputs set to a per chapter basis and
+       the first chapter is separate from preceding contents.
+     * Changed dates format in example article and books to suppress EPUB
+       validation error.
+     * Added style and role CSS classes to xhtml11 section templates.
+     * Added the role element to xhtml11 backend block templates.
+     * Suppressed md5 module deprecation warning from music and Graphviz
+       filters.
+     * Pygments ([42]http://pygments.org/) option added to source code
+       highlight filter. Based on Pygments source code filter written by
+       David Hajage
+       ([43]http://groups.google.com/group/asciidoc/browse_thread/thread/d
+       8d042f5a3021369/8934ebbb8cb7144b).
+     * xhtml11: Added a new theme (volnitsky). Written and contributed by
+       Leonid V. Volnitsky.
+     * xhtml11: Set body element class name to document type.
+     * Added refentryinfo element and contents (including revdate) to man
+       page DocBook output. Man pages are now dated using the revdate
+       attribute value if it has been defined. Based on patch supplied by
+       Rainer Muller
+       [44]http://groups.google.com/group/asciidoc/browse_frm/thread/319e5
+       cd94493e330/3fcb83fab067af42.
+     * Added {template:...} system attribute.
+     * Table of contents attribute toc can now be specified in the
+       document header.
+     * Reimplemented music and latex filter -m option functionality when
+       the input is stdin using MD5 checksums.
+     * Added latex filter.
+     * Added auto file name generation to image generating filters
+       (latex,music, graphviz).
+     * Added counter2 and set2 system attributes (to implement image auto
+       file name generation).
+     * Undefined attribute in filter command generates error but does not
+       exit.
+     * Attribute substitution proceeds from start line to end line
+       (previously was in reverse order which was really confusing).
+     * Tidied up music filter code:
+          + Format option is optional and default to abc unless Lilypond
+            notation detected.
+          + The -m option does not apply to stdin input.
+     * Added paragraph styles to music and graphviz filters.
+     * Documented dynamic template names. 753: Graphviz filter can now
+       generate SVG format images. Patch submitted by Elmo Todurov, see:
+       [45]http://groups.google.com/group/asciidoc/browse_frm/thread/fe9b3
+       3d8f5f1e0af The xhtml11 SVG Graphviz template marked EXPERIMENTAL.
+       No SVG support for other backends.
+     * AsciiDoc template names can now contain embedded attribute
+       references.
+     * Added legalnotice tag to doc/article-docinfo.xml example.
+     * xhtml11 backend: Callouts and callout lists display callout icons
+       when the icons attribute is defined. See
+       [46]http://groups.google.com/group/asciidoc/browse_frm/thread/8eda3
+       ea812968854
+     * Document attribute names are case insensitive everywhere, this
+       makes using attribute entries more consistent e.g. previously
+       :VERS: had to be refered to
+     * Hungarian translation of footer-text (submitted by Miklos Vajna).
+       See
+       [47]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c
+       b7598993c72#
+     * asciidocapi.py 0.1.2: Can now load AsciiDoc script named asciidoc.
+       See
+       [48]http://groups.google.com/group/asciidoc/browse_frm/thread/66e7b
+       59d12cd2f91 Based on patch submitted by Phillip Lord.
+     * German translation of footer-text (submitted by Simon Ruderich).
+       See
+       [49]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c
+       b7598993c72
+     * Pushed HTML footer text into language conf files with the
+       introduction of a [footer-text] configuration file template
+       section. See
+       [50]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c
+       b7598993c72
+
+   Bug fixes
+     * FIXED: Sometimes multiple double quoted text elements in the same
+       paragraph were mistakenly seen as starting with an inline literal.
+       See
+       [51]http://groups.google.com/group/asciidoc/browse_frm/thread/219c8
+       6ae25b79a21
+     * FIXED: localtime and doctime attributes calculated incorrect
+       daylight saving / non daylight saving timezones and consequently so
+       did HTML footers. Patch submitted by Slawomir Testowy. See
+       [52]http://groups.google.com/group/asciidoc/browse_frm/thread/af652
+       507caf6cec9
+     * FIXED: Missing selector for List of examples title in DocBook CSS
+       file. Patch submitted by Laurent Laville. See
+       [53]http://groups.google.com/group/asciidoc/browse_frm/thread/3f969
+       00f7fbf5620
+     * FIXED: Broken accents in lang-hu.conf. See:
+       [54]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c
+       b7598993c72
+     * FIXED: DocBook XSL generated HTML callout lists are properly
+       aligned. Submitted by Lionel Orry. See
+       [55]http://groups.google.com/group/asciidoc/browse_frm/thread/2ff80
+       2547b6a75ea
+     * FIXED: Filter execution now occurs prior to filter markup template
+       substitution to ensure image data URI encoding happens after image
+       generation (see
+       [56]http://groups.google.com/group/asciidoc/browse_thread/thread/14
+       e8fcb289a135b).
+     * FIXED: The section numbers no longer increment when the numbered
+       attribute is undefined (see
+       [57]http://groups.google.com/group/asciidoc/browse_thread/thread/fa
+       a36e9e5c7da019/d24cab3fe363e58d).
+     __________________________________________________________________
+
+7. Version 8.5.3 (2010-01-18)
+
+   Additions and changes
+     * a2x: Added a2x configuration file options ASCIIDOC_OPTS,
+       DBLATEX_OPTS, FOP_OPTS, XSLTPROC_OPTS (appended to same-named
+       command-line options). See
+       [58]http://groups.google.com/group/asciidoc/browse_frm/thread/ac4b9
+       bfa2116db28
+     * Dropped .hgignore from the repository. See
+       [59]http://groups.google.com/group/asciidoc/browse_frm/thread/c17ab
+       d175778f5ea
+     * Don’t pass verbose options to asciidoc table filter so that
+       asciidocapi messages are not discarded. See:
+       [60]http://groups.google.com/group/asciidoc/browse_frm/thread/c17ab
+       d175778f5ea
+     * Added ./tests/data/lang-pt-BR-test.txt file to the repository.
+     * xhtml11: Verse block and verse paragraph content enveloped in a pre
+       tag (instead of a div) so it renders better in text-only browsers.
+       See:
+       [61]http://groups.google.com/group/asciidoc/browse_frm/thread/1b6b6
+       6adb24e710
+     * User Guide: Clarified Passthrough Blocks (suggested by Simon
+       Ruderich).
+     * FAQ: How can I include lines of dashes inside a listing block?
+     * FAQ errata and updates (submitted by Simon Ruderich).
+     * User Guide errata.
+     * Simplified asciidoc-toc processing instruction and included lists
+       of figures, tables, examples and equations in books (i.e. revert to
+       pre-8.5.0 behavior).
+     * Attempted to have dblatex recognise the asciidoc-toc processing
+       instruction but couldn’t get it to work.
+     * Added notitle attribute to allow the document title to be hidden.
+
+   Bug fixes
+     * FIXED: Regression: system attribute escaping did not work.
+     * FIXED: Website: broken image links in chunked User Guide.
+     __________________________________________________________________
+
+8. Version 8.5.2 (2009-12-07)
+
+   Additions and changes
+     * Updated example article and book documents with the recommended
+       explicit section name syntax (see the Special section titles vs.
+       explicit template names sidebar in the AsciiDoc User Guide).
+     * Added Italian language configuration file (contributed by Fabio
+       Inguaggiato).
+     * Added header table style. See:
+       [62]http://groups.google.com/group/asciidoc/browse_frm/thread/a23fe
+       a28394c8ca9
+     * Pass icons, data-uri, imagesdir, iconsdir attributes to asciidoc
+       table style filter so that images are rendered in table cells.
+     * Pass trace and verbose attributes to asciidoc table style filter so
+       diagnostic information is printed from table cell source.
+     * The eval system attribute can be nested inside other system
+       attributes.
+     * HTML outputs: Table and figure caption punctuation set to more
+       usual syntax.
+     * docbook backend: footnotes can now contain embedded images. See
+       [63]http://groups.google.com/group/asciidoc/browse_frm/thread/50b28
+       f6941de111a
+     * CSS tweaks so that tables processed by DocBook XSL Stylesheets have
+       the default asciidoc xhtml11 backend styling. See
+       [64]http://groups.google.com/group/asciidoc/browse_frm/thread/dfe52
+       04d5b2c9685
+     * Block titles take precedence over section titles to avoid titled
+       delimited blocks being mistaken for two line section titles (see
+       [65]http://groups.google.com/group/asciidoc/browse_frm/thread/f0b6f
+       9989f828c3).
+     * Section title trace displays level and title text.
+     * FAQ additions.
+     * Added {zwsp} (zero width space) attribute.
+     * Undefined paragraph styles are reported (previously threw a runtime
+       error).
+     * Eliminated empty preamble generation.
+     * Floating titles now processed in all contexts.
+     * Implemented auto-lettered appendix names and updated example
+       documents.
+     * Section numbering can be disabled in HTML outputs with a
+       :numbered!: AttributeEntry.
+     * xhtml11: Nicer default quote block styling.
+     * Exclude floating titles from xhtml11 table of contents. Patch
+       submitted by Mark Burton (see
+       [66]http://groups.google.com/group/asciidoc/browse_frm/thread/14aef
+       c1cb6bd85f5).
+     * Enhanced doc/article-docinfo.xml example docinfo file.
+     * Vim syntax highlighter improvements.
+
+   Bug fixes
+     * FIXED: Absolute imagesdir and iconsdir attribute path names do not
+       work with the xhtml11 data-uri encoding. See
+       [67]http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b7
+       694bbc82a6
+     * FIXED: Regression issue with inline data-uri images. See
+       [68]http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b7
+       694bbc82a6
+     * FIXED: An unexpected error occurred when processing a table
+       containing CSV data if the cols attribute was not explicitly
+       specified. See
+       [69]http://groups.google.com/group/asciidoc/browse_frm/thread/4b0f3
+       64b477ec165
+     __________________________________________________________________
+
+9. Version 8.5.1 (2009-10-31)
+
+   Additions and changes
+     * If an AsciiDoc document file begins with a UTF-8 BOM (byte order
+       mark) then it is passed transparently through to the output file.
+       The BOM is stripped from included files. See
+       [70]http://groups.google.com/group/asciidoc/browse_frm/thread/e5e61
+       823ff4203cd
+     * Added AsciiDoc role attribute to quoted text. Sets class attribute
+       in HTML outputs; role attribute in DocBook outputs. See:
+       [71]http://groups.google.com/group/asciidoc/browse_frm/thread/2aa3e
+       5711d243045
+     * Conditional attribute syntax extended: they now accept multiple
+       ORed or ANDed attribute names.
+     * The xhtml11 backend dynamically processes footnotes using
+       JavaScript.
+     * Tidied up and namespaced xhtml11 JavaScript.
+     * Superceded javascripts/toc.js with javascripts/asciidoc-xhtml11.js.
+     * Added disable-javascript attribute (xhtml11 backend).
+     * Styled HTML footnotes.
+     * Added links to HTML footnote refs.
+     * Added title attribute to inline image macros to display popup
+       “tooltip” (HTML outputs only).
+     * Single-quoted attribute values are substituted in block macros
+       (just like the AttributeList element).
+     * For consistency changed underscores to dashes in attribute names.
+       Public attributes with underscores retained for compatibility.
+     * Added Brazilian Portuguese language configuration file (contributed
+       by Thiago Farina).
+     * Added leveloffset attribute to make it easier to combine documents.
+
+   Bug fixes
+     * FIXED: a2x: --dblatex-opts is now processed last so
+       asciidoc-dblatex.xsl params can be overridden. Patch submitted by
+       Mark Fernandes (see
+       [72]http://groups.google.com/group/asciidoc/browse_frm/thread/5215c
+       99dcc865e7d).
+     * FIXED: An error occurred if a directory in current path with same
+       name as executable.
+
+  9.1. Regression issues
+
+   There’s been quite a bit of tiding up to the xhtml11 JavaScript. The
+   most obvious change is that the toc.js script has been superceded by
+   asciidoc-xhtml11.js so if you’re linking you’ll need get a copy of the
+   new file from the distribution javascripts directory.
+
+   If you use customised xhtml11 configuration file [header] and [footer]
+   sections and you want them to use the new footnotes feature then you’ve
+   got a bit more work to do:
+    1. The onload event expression changed.
+    2. The new <div id="content">...</div> div envelopes document content.
+    3. You need to add <div id="footnotes">...</div> div to the
+       [footnotes] section for footnotes to work.
+    4. Drop the ifdef::toc[] macro that surround JavaScript inclusion.
+
+   Take a look at the [header] and [footer] changes in the xhtml11.conf
+   diff to see what’s going on:
+   [73]http://hg.sharesource.org/asciidoc/diff/55a5999bfd04/xhtml11.conf
+     __________________________________________________________________
+
+10. Version 8.5.0 (2009-10-04)
+
+   Additions and changes
+     * Implemented a float attribute for tables and block images (HTML
+       outputs only).
+     * Added unfloat::[] block macro to cancel floating.
+     * Added table align attribute to (HTML outputs only).
+     * The image align attribute now works with HTML backends.
+     * Renamed table cell align attribute to halign so it doesn’t clash
+       with the new table align attribute.
+     * Added breakable and unbreakable options to AsciiDoc example and
+       block image elements.
+     * [miscellaneous] section entries now update properly when set from a
+       document AttributeEntry.
+     * [miscellaneous] section pagewidth entry accepts fractional values.
+     * Fractional column widths are now calculated correctly when using
+       fractional pageunits (DocBook tables).
+     * Use DocBook XSL table width processing instructions.
+     * asciidoc KeyboardInterrupt exits with error code 1.
+     * Added set system attribute to allow attributes to be set from
+       configuration file templates.
+     * Allow constrained quotes to be bounded on the left by a colons and
+       semicolons, see
+       [74]http://groups.google.com/group/asciidoc/browse_frm/thread/b276a
+       927fdc87995
+     * Titled listing and literal blocks (DocBook outputs) no longer
+       default to examples. See
+       [75]http://groups.google.com/group/asciidoc/browse_frm/thread/f4df7
+       c9eec01a9bd
+     * Updated language file table, figure and example captions to
+       accommodate new auto-numbering in html4 and xhtml11 backends.
+     * Titled source highlight filter listings generated by docbook
+       backend are now rendered as examples. See
+       [76]http://groups.google.com/group/asciidoc/browse_frm/thread/f4df7
+       c9eec01a9bd
+     * Implemented counter system attribute.
+     * Use counter system attributes to number titled tables and block
+       images in HTML backends.
+     * Added program name suffix to console messages.
+     * Added substitution to the AttributeEntry passthrough syntax, this
+       replaces the now unnecessary attributeentry-subs attribute.
+     * Allow passthrough inline macro syntax to be used in
+       AttributeEntrys.
+     * Reinstated 8.4.4 default lang attribute behavior. See
+       [77]http://groups.google.com/group/asciidoc/browse_frm/thread/d2992
+       4043e21cb6a.
+     * Added max-width attribute to the xhtml11 backend to set maximum
+       display width. See
+       [78]http://groups.google.com/group/asciidoc/browse_frm/thread/74d9a
+       542b79ccd50.
+     * Added a2x.py, a rewritten and much enhanced version of the old a2x
+       bash script.
+     * The new a2x can output EPUB formatted documents.
+     * Added --safe option and deprecated --unsafe option. Patch submitted
+       by Todd Zullinger. See
+       [79]http://groups.google.com/group/asciidoc/browse_frm/thread/ea3a8
+       ea399ae5d2a and
+       [80]http://groups.google.com/group/asciidoc/browse_frm/thread/69b31
+       83fdab7c6a5
+     * Added CHECK and TEST todo highlight words to Vim syntax
+       highlighter.
+     * Line breaks, page breaks, and horizontal rulers are now processed
+       by dblatex, thanks to a patch submitted by Mark Fernandes
+       ([81]http://groups.google.com/group/asciidoc/browse_frm/thread/a254
+       cf949ea7c6c5).
+     * Allow footnote macros hard up against the preceding word so the
+       rendered footnote mark can be placed against the noted text without
+       an intervening space (patch submitted by Stas Bushuev,
+       [82]http://groups.google.com/group/asciidoc/browse_frm/thread/e1dcb
+       7ee0efc17b5).
+     * Normalized path in safe_filename function (submitted by Todd
+       Zullinger,
+       [83]http://groups.google.com/group/asciidoc/browse_frm/thread/69b31
+       83fdab7c6a5).
+     * The Asciidoc numbered and toc attributes cause DocBook outputs to
+       include asciidoc-numbered and asciidoc-toc processing instructions,
+       these are used by DocBook XSL to include section numbering and
+       table of contents (like Asciidoc HTML backends). For backward
+       compatibility both numbered and toc attributes are defined by
+       default when the docbook backend is used. See
+       [84]http://groups.google.com/group/asciidoc/browse_frm/thread/1bada
+       d21ff9447ac.
+     * data-uri attribute is now evaluated dynamically and can be set in
+       document body (previously could only be set from command-line).
+     * Added sys3 and eval3 system attributes to passthrough generated
+       output, this fixes the data-uri inline image problem:
+       [85]http://groups.google.com/group/asciidoc/browse_frm/thread/a42db
+       6bc54c2c537.
+     * Missing language file generates a warning instead of an error.
+     * Updated Spanish language file (updates contributed by Gustavo
+       Andrés Gómez Farhat).
+
+   Bug fixes
+     * FIXED: Options in an AttributeList option attribute are merged with
+       (rather than replace) configuration file options.
+     * FIXED: Comment blocks and comment block macros no longer consume
+       preceding block titles and attribute lists.
+     * FIXED: examples/website/layout1.conf and
+       examples/website/layout2.conf TOC problem. Submitted by Mark
+       (burtoogle). See
+       [86]http://groups.google.com/group/asciidoc/browse_frm/thread/b9c63
+       be67dd1d11c
+     * FIXED: Only the first occurrence of passthrough macro was
+       substituted. Patch submitted by Peter Johnson. See
+       [87]http://groups.google.com/group/asciidoc/browse_frm/thread/1269d
+       c2feb1a482c
+     * FIXED: asciidoc now runs on Jython 2.5.0.
+     * FIXED: Wordpress margins and pads in a number of block elements
+       ([88]http://groups.google.com/group/asciidoc/browse_frm/thread/36ff
+       073c79cbc20a).
+
+  10.1. Regression issues
+
+     * Tables generated by dblatex occupy 100% of the available space
+       regardless of the width attribute setting. To restore width
+       behavior change the pageunits miscellaneous parameter to pt. You
+       can do this from the command-line with the -a pageunits=pt option.
+       See [89]DocBook table widths.
+     __________________________________________________________________
+
+11. Version 8.4.5 (2009-05-24)
+
+   Additions and changes
+     * Added manpage Name and Synopsis section title customization to
+       languages configuration files.
+     * Synopsis manpage section no longer mandatory.
+     * Section markup templates can be specified by setting the title’s
+       first positional attribute or template attribute.
+     * The article and book document header can now include a revision
+       remark.
+     * A role attribute can now be applied to block elements. This adds
+       the role attribute to DocBook elements. Patch submitted by [90]Noah
+       Slater).
+     * Renamed revision and date attributes to more sensible and
+       consistent revnumber and revdate (old names deprecated but still
+       recognized).
+     * Moved backend specific attributes to Appendix H in User Guide.
+     * Renamed and generalized the docbook backend revision history
+       inclusion mechanism to docinfo to reflect the use of all article or
+       book information elements. The old revision history names still
+       work but have been deprecated.
+     * Refactored docbook.conf headers.
+     * Moved line break replacement from [replacements] to [replacements2]
+       so the replacement occurs after the mailto macro. This fixes bug
+       [91]http://groups.google.com/group/asciidoc/browse_thread/thread/4b
+       dcdfb0af773e2
+     * The typewriter to punctuation apostrophe replacement can be escaped
+       with a backslash.
+     * Graphviz filter outputs images to imagesdir if it is defined.
+     * Made the block image macro generic so that it can be used for
+       filter outputs. As a result Music and Graphviz filters:
+          + Have been greatly simplified.
+          + Honor the data-uri attribute.
+          + html4 outputs no longer generate W3C validation warning.
+     * The iconsdir attribute no longer requires a trailing directory
+       separator character.
+     * Removed borders around linked html4 images.
+     * Added html4 specific HTML output for music filter.
+     * a2x: Added --unsafe option (shortcut for --asciidoc-opts=--unsafe).
+     * a2x: The FOP executable can now be named fop (this is the default
+       name in some distributions).
+     * Attributes are now substituted in the system macro attribute list.
+     * If the output is set to stdout (i.e. no output directory is
+       defined) then Music and Graphviz filters will output included
+       images to the source file directory.
+     * Added name directive to testasciidoc.
+     * Added lots of testasciidoc new tests.
+     * Moved language specific configuration parameters into lang-en.conf
+       file.
+     * lang attribute entry can be specified in the AsciiDoc source file
+       (preceding the header).
+     * Removed cruft from A-A-P scripts and documented them.
+     * Added German language config file (lang-de.conf) contributed by
+       Michael Wild.
+     * Added French language config file (lang-fr.conf) contributed by
+       Yves-Alexis Perez.
+     * Added Russian language config file (lang-ru.conf) contributed by
+       Artem Zolochevskiy.
+     * Added Hungarian language config file (lang-hu.conf) contributed by
+       Miklos Vajna.
+
+   Bug fixes
+     * FIXED: Multiple manpage names are now handled correctly when
+       generating DocBook output, each name now generates a separate
+       DocBook <refname> element. See
+       [92]http://groups.google.com/group/asciidoc/browse_thread/thread/c9
+       3bb4db025225d8
+     * FIXED: A problem that caused AttributeEntries preceding the header
+       to be overwritten when the language conf file loaded.
+     * FIXED: Possible inline macro name ambiguity e.g. link matches
+       olink.
+     * FIXED: The documented macro definition deletion behavior had been
+       broken for a long time.
+     * FIXED: Email addresses not recognized when followed by a period
+       character.
+     * FIXED: Hyphens in mailto macros can delimit nested addresses e.g.
+       bloggs@mail was processed inside
+       mailto:joe-bloggs@mail-server.com[Mail].
+     * FIXED: User name in FTP URI generated incorrect FTP link. See
+       [93]http://groups.google.com/group/asciidoc/browse_thread/thread/1d
+       796a9c9ddb2855
+     * FIXED: Source highlighter now works with Wordpress backend (see
+       [94]http://groups.google.com/group/asciidoc/browse_thread/thread/6d
+       8c716748b109e3).
+
+  11.1. Regression issues
+
+    1. A colon following the date in the AsciiDoc header is treated as a
+       revision remark delimiter — this could be an issue if you have used
+       a colon in the header date.
+     __________________________________________________________________
+
+12. Version 8.4.4 (2009-04-26)
+
+   Additions and changes
+     * Added table column and row spanning.
+     * Table styles can now be applied per cell.
+     * Vertical cell alignment can be applied to columns and individual
+       cells.
+     * Added table align attribute to set horizontal alignment for entire
+       table.
+     * Included Geoff Eddy’s update of the experimental LaTeX backend.
+     * A new attribute named trace controls the output of diagnostic
+       information. If the trace attribute is defined then
+       element-by-element diagnostic messages detailing output markup
+       generation are printed to stderr.
+     * Added literal paragraph style (allows literal style to be applied
+       to normal paragraphs).
+     * Deleted unused replacements2 from xhtml11.conf.
+     * Added replacements2 to default substitutions.
+     * testasciidoc.py: messages to stdout, only diffs to stderr.
+     * Added transparency to smallnew.png image.
+
+   Bug fixes
+     * All combinations of leading comments and attribute entries at the
+       start of a document are now skipped correctly.
+     * FIXED: ./configure doesn’t support --docdir as expected (patch
+       submitted by Artem Zolochevskiy)
+     * FIXED: Constrained quotes were incorrectly matched across line
+       boundaries e.g. the string +\nabc+ incorrectly matched a monospace
+       quote.
+     __________________________________________________________________
+
+13. Version 8.4.3 (2009-04-13)
+
+   Additions and changes
+     * DocBook outputs default to DocBook version 4.5 doctype (previously
+       4.2).
+     * Configuration file [specialsections] definitions can be undefined
+       by setting their configuration entry values blank.
+     * The Makefile install target depends on the all target to ensure
+       pre-install patches are applied.
+     * testasciidoc.py now emits user friendly messages if:
+         1. the configuration file is missing.
+         2. an illegal backend is specified.
+         3. an illegal test number is specified.
+
+   Bug fixes
+     * Fixed [95]missing template section error.
+     * The testasciidoc.py --force option no longer deletes test data
+       files that were not specified.
+     * Dropped second quotes substitution in table cells — it had
+       effectively disabled quote escaping in table cells.
+     __________________________________________________________________
+
+14. Version 8.4.2 (2009-03-19)
+
+   Additions and changes
+     * Added [96]testasciidoc, a tool to verify AsciiDoc conformance.
+     * A warning is issued if nested inline passthroughs are encountered.
+     * asciidocapi: setting an attribute value to None will undefine
+       (delete) the attribute (this in addition to the name! attribute
+       name format that the asciidoc(1) command uses).
+     __________________________________________________________________
+
+15. Version 8.4.1 (2009-03-10)
+
+   Additions and changes
+     * AsciiDoc now has a [97]Python API. The following minimal example
+       compiles mydoc.txt to mydoc.html:
+
+       from asciidocapi import AsciiDocAPI asciidoc = AsciiDocAPI()
+       asciidoc.execute('mydoc.txt')
+
+     * Backtick quoting for monospaced text is now implemented as an
+       inline literal passthrough. This makes more sense since monospace
+       text is usually intended to be rendered literally. See
+       [98]Regression issues below for the impact this may have on
+       existing documents. Here are some examples that would previously
+       have had to be escaped:
+  The `++i` and `++j` auto-increments.
+  Paths `~/.vim` and `~/docs`.
+  The `__init__` method.
+  The `{id}` attribute.
+     * Added --doctest option to asciidoc(1) command.
+     * Added an optional second argument to BlockId element, this sets the
+       {reftext} attribute which in turn is used to set the xreflabel
+       attribute in DocBook elements.
+     * Added lists to --help syntax summary.
+     * {infile} and {indir} attributes reflect the current input file
+       (previously always referred to the root document).
+     * {docfile} (new) and {docdir} (previously deprecated) attributes
+       refer to the root document specified on the asciidoc(1)
+       command-line.
+     * Vim syntax highlighter improvements.
+     * Syntax summary command (asciidoc -h syntax) additions.
+     * Admonition icons now have transparent backgrounds.
+     * Changed yellow W3C badges to blue ones in page footers.
+
+   Bug fixes
+     * Dropped asciidoc(1) broken undocumented --profile option.
+     * Em dash replacement now recognized at start of block.
+
+  15.1. Regression issues
+
+   Replacing backtick quoting with the inline literal passthrough raises
+   two regression scenarios for existing documents:
+    1. You have escaped the expansion of enclosed inline elements, for
+       example: \{id}. You would need to delete the backslashes: {id} (if
+       you don’t the backslashes will be printed). Mostly it’s just a case
+       of interactively finding and replacing of all occurrences of `\.
+    2. There are enclosed inline elements, for example: some *bold*
+       monospaced. You would need to switch to plus character monospace
+       quoting: +some *bold* monospaced+ (if you don’t the enclosed
+       elements won’t be expanded).
+
+   If your existing documents include these cases and you don’t want to
+   upgrade then use the -a no-inline-literal command-line option,
+   alternatively put this in ~/.asciidoc/asciidoc.conf:
+  [attributes]
+  no-inline-literal=
+     __________________________________________________________________
+
+16. Version 8.3.5 (2009-02-02)
+
+   Additions and changes
+     * Cached compiled regular expression delimiters (speed up User Manual
+       compilation by 250%).
+     * Created distinct list definitions for each numbered list style to
+       allow nesting of all styles.
+     * Roman numbers in numbered lists are followed by a closing
+       parenthesis instead of a period to eliminate i, v, x item ambiguity
+       with respect to alpha numbered list items.
+     * Added **, ***, ****, ***** bulleted lists.
+     * Added ..., ...., ..... implicit numbered lists.
+     * Added :::, :::: labeled lists.
+     * Updated User Guide for new list syntaxes.
+     * Optimized paragraph and list termination detection with separate
+       precompiled regular expressions for performance and to prevent
+       reaching Python 100 named group limit.
+     * Updated Vim syntax highlighter for new list syntaxes.
+     * Allow template::[] macros in conf file entries sections (not just
+       in template sections).
+     * Dropped unused [listdef-numbered2] conf file sections.
+     * Renamed ListBlock to more appropriate OpenBlock.
+     * Implemented single-line versions of ifdef::[] and ifndef::[]
+       macros.
+     * html4 backend styling:
+          + Underlined admonition captions.
+          + Added side border to Example Blocks.
+     * xhtml11 backend styling:
+          + Dropped right hand margin from all but quote and verse blocks.
+          + html4 backend: corrected over-sized width of caption in
+            admonition block.
+
+   Bug fixes
+     * Fixed broken numbered list nesting.
+
+  16.1. Compatibility issues
+
+   The roman numbered list parenthesis syntax is incompatible with the
+   potentially ambiguous roman period syntax introduced in 8.3.2.
+     __________________________________________________________________
+
+17. Version 8.3.4 (2009-01-20)
+
+   Additions and changes
+     * Implemented a title float style. A floating title (or bridgehead)
+       is rendered just like a normal section but is not formally
+       associated with a text body and is not part of the regular section
+       hierarchy so the normal ordering rules do not apply.
+     * Implemented inline comment macro so comment lines can now appear
+       inside block elements.
+     * Comment lines are sent to the output if the showcomments attribute
+       is defined (comment blocks are never sent to the output).
+     * Single quoting attribute values in AttributeList elements causes
+       them to be substituted like normal inline text (without single
+       quoting only attribute substitution is performed).
+     * Rewrote list item processing (was very crufty). List continuation
+       and list blocks now work as expected. Updated and clarified list
+       documentation in User Guide.
+     * The revision attribute now recognizes the RCS $Id$ marker format.
+     * An RCS $Id$ marker formatted revision line in the header does not
+       need to be preceded by an author line.
+     * If an RCS $Id$ formatted revision is specified and the author name
+       has not already been set then the author name in the $Id$ marker
+       will be used.
+     * Updated Gouichi Iisaka’s Graphviz filter to version 1.1.3.
+     * Added autowidth table attribute option for (X)HTML outputs.
+     * DocBook backend now puts orgname optional attribute in DocBook
+       header.
+     * Deprecated undocumented companyname attribute in favor of DocBook’s
+       corpname.
+     * Removed explicit closing backslash from HTML4 self-closing tags to
+       comply with WC3 recommendation.
+
+   Bug fixes
+     * Fixed 8.3.3 regression whereby adjacent lists with the same syntax
+       but different list styles were incorrectly treated as a single
+       list.
+     __________________________________________________________________
+
+18. Version 8.3.3 (2009-01-02)
+
+   This release supersedes 8.3.2.
 
    Bug fixes
      * The broken and confusing numeration and numeration2 numbered list
        attributes have been dropped, use the style attribute instead.
      __________________________________________________________________
 
-2. Version 8.3.2 (2009-01-01)
+19. Version 8.3.2 (2009-01-01)
 
    Additions and changes
-     * Added Gouichi Iisaka's Graphviz filter to distribution.
+     * Added Gouichi Iisaka’s Graphviz filter to distribution.
      * The SidebarBlock element can now be rendered with an abstract
        style.
      * Reorganized filters into a separate subdirectory for each filter.
@@ -36,8 +1104,8 @@
      * You can now backslash escape system block macros.
      * Added Pychart FAQ.
      * Drop paragraph text and list text, index and label match groups
-       from attributes -- they are included in the element's text and we
-       don't want them processed a second time as attributes.
+       from attributes — they are included in the element’s text and we
+       don’t want them processed a second time as attributes.
      * Changed comment line block macro to a passthrough block macro to
        ensure no substitutions.
      * A subslist no longer has to be appended to a PassthroughBlock macro
@@ -52,11 +1120,11 @@
        where not escaped in DocBook outputs.
      __________________________________________________________________
 
-3. Version 8.3.1 (2008-12-14)
+20. Version 8.3.1 (2008-12-14)
 
    Additions and changes
-     * Replaced the install.sh script with Ben Walton's updated autoconf
-       scripts -- see [1]INSTALL for details.
+     * Replaced the install.sh script with Ben Walton’s updated autoconf
+       scripts — see [99]INSTALL for details.
      * Added a generalized AttributeEntry syntax to allow arbitrary
        configuration file entries to be set from within an AsciiDoc
        document (suggested by Henrik Maier).
@@ -72,18 +1140,18 @@
        resulted in backward incompatibility, double-quotes in unquoted
        attribute values has been reinstated.
      * Regression: Text like &...; was sometimes mistaken for an entity
-       reference -- tightened up entity reference matching.
+       reference — tightened up entity reference matching.
      __________________________________________________________________
 
-4. Version 8.3.0 (2008-11-29)
+21. Version 8.3.0 (2008-11-29)
 
    Additions and changes
-     * [2]AsciiDoc new tables is a complete redesign of the tables syntax
-       and generation. The new syntax and features are a huge improvement
-       over the old tables. The old tables syntax has been deprecated but
-       is currently still processed.
-     * [3]Lists can now be styled like other block elements. This allows a
-       single list syntax for glossary, qanda (Question and Answer) and
+     * [100]AsciiDoc new tables is a complete redesign of the tables
+       syntax and generation. The new syntax and features are a huge
+       improvement over the old tables. The old tables syntax has been
+       deprecated but is currently still processed.
+     * [101]Lists can now be styled like other block elements. This allows
+       a single list syntax for glossary, qanda (Question and Answer) and
        bibliography lists instead of having to remember a different syntax
        for each type.
      * Inline passthroughs macros have been improved and block passthrough
@@ -91,11 +1159,11 @@
        when the macro is called.
      * The passthrough block has a fully transparent passthrough delimited
        block block style called pass.
-     * The asciimath and latexmath [4]passthrough macros along with
-       asciimath and latexmath [5]passthrough blocks provide a (backend
+     * The asciimath and latexmath [102]passthrough macros along with
+       asciimath and latexmath [103]passthrough blocks provide a (backend
        dependent) mechanism for rendering mathematical formulas. There are
-       [6]LaTeX Math, [7]AsciiMathML and [8]LaTeXMathML examples on the
-       AsciiDoc website.
+       [104]LaTeX Math, [105]AsciiMathML and [106]LaTeXMathML examples on
+       the AsciiDoc website.
      * Reimplemented and cleaned up filter processing based on a patch
        submitted by Kelly Anderson. Uses the newer subprocess module
        instead of the deprecated popen2 module. Now works in Win32 command
@@ -114,8 +1182,8 @@
        patch).
      * Title elements now process the options attribute like other block
        elements.
-     * Added `single quoted' element.
-     * Spaces on both sides of a -- em-dash are translated to thin space
+     * Added ‘single quoted’ element.
+     * Spaces on both sides of a — em-dash are translated to thin space
        characters.
      * Improved detection and reporting of malformed attribute lists.
      * The list compact style is now a list option.
@@ -173,7 +1241,7 @@
        semantics.
      * Vim syntax highlighter: escaped quoted text, attribute references
        and inline macros are not highlighted.
-     * Vim syntax highlighter: TODO's highlighted in CommentBlocks (thanks
+     * Vim syntax highlighter: TODO’s highlighted in CommentBlocks (thanks
        to Scott Wall); non-greedy $$...$$.
      * Vim syntax highlighter: Comment lines mistaken for vertical list
        labels (thanks to Scott Wall).
@@ -196,7 +1264,7 @@
      * Generic tag inline macro (creeping featurism, use pass macros
        instead).
 
-  4.1. Compatibility issues
+  21.1. Compatibility issues
 
    Version 8.3.0 has a number of backward incompatibilities with respect
    to the previous 8.2.7 release:
@@ -204,8 +1272,8 @@
        issued.
      * Entity references have to be escaped with a backslash.
      * You have to explicitly precede horizontal style labeled lists with
-       the [horizontal] style attribute -- by default all labeled lists
-       are rendered vertically.
+       the [horizontal] style attribute — by default all labeled lists are
+       rendered vertically.
      * The list compact style has been dropped and is now a list option
        (use options="compact" in attribute lists).
      * AsciiDoc version 6 sytnax no longer supported.
@@ -216,7 +1284,7 @@
        quoting is escaped with two backslashes.
      __________________________________________________________________
 
-5. Version 8.2.7 (2008-07-04)
+22. Version 8.2.7 (2008-07-04)
 
    Additions and changes
      * Added dvi, ps and tex output format options to a2x(1).
@@ -226,30 +1294,30 @@
        ./dblatex directory) that are used by a2x(1).
      * dblatex(1) is now used to generate the distributed PDF version of
        the AsciiDoc User Guide.
-     * If you don't need a customized the link caption you can enter the
+     * If you don’t need a customized the link caption you can enter the
        http, https, ftp, file URLs and email addresses without any special
-       macro syntax -- you get the links by just cutting and pasting URLs
+       macro syntax — you get the links by just cutting and pasting URLs
        and emails addresses. This also makes it easier to open links
        directly form AsciiDoc source ( most editors allow you to open URLs
        directly). The Vim syntax highlighter has been updated to reflect
        these changes.
-     * Highlighted source code paragraphs have been implemented -- it's a
-       much more convenient way to enter short code examples (see [9]the
+     * Highlighted source code paragraphs have been implemented — it’s a
+       much more convenient way to enter short code examples (see [107]the
        online docs).
-     * The source highlighter and music filter syntax has changed -- they
+     * The source highlighter and music filter syntax has changed — they
        now used the ListingBlock syntax customized with source and music
        style attribute values. This follows the Paragraph styling
        convention introduced by the source paragraph (previous item) and
        is easier to read. The old syntax still works but has been
        deprecated.
-     * QuoteBlocks now have a verse style -- you no longer have to nest a
+     * QuoteBlocks now have a verse style — you no longer have to nest a
        verse LiteralBlock inside a QuoteBlock for verses. The verse style
        on the LiteralBlock has been deprecated (still works though) and
        the style attribute is positional attribute 1, pushing attribution
-       and citetitle attributes to the right (you'll need to insert a
+       and citetitle attributes to the right (you’ll need to insert a
        quote attribute into your existing QuoteBlocks).
      * It is no up to the DocBook processor to highlight source code
-       syntax in <programlisting> elements rather than GNU Highlighter --
+       syntax in <programlisting> elements rather than GNU Highlighter —
        this is the correct way to handle it, plus dblatex(1) makes a much
        better job.
      * scaledwidth and align attributes have been added to the image
@@ -260,8 +1328,8 @@
      * Added a2x(1) --fop-opts=FOP_OPTS option (patch submitted by Miklos
        Vajna).
      * Added a2x(1) --dblatex-opts=DBLATEX_OPTS option.
-     * Added Mikhail Yakshin's FOP 0.95 patch which fixes a long-standing
-       fo.xsl problem and allows PDF's to be generated with FOP 0.95
+     * Added Mikhail Yakshin’s FOP 0.95 patch which fixes a long-standing
+       fo.xsl problem and allows PDF’s to be generated with FOP 0.95
        (previously had to use FOP 0.20.5).
      * The User Guide has been updated and outdated FOP configuration and
        installation sections removed.
@@ -272,32 +1340,31 @@
      * Configuration file *-style attributes are now dumped correctly.
      * Fixed FAILED: malformed section entry LaTeX backend error.
 
-   See the also the [10]AsciiDoc repository changelog.
+   See the also the [108]AsciiDoc repository changelog.
      __________________________________________________________________
 
-6. Version 8.2.6 (2008-04-29)
+23. Version 8.2.6 (2008-04-29)
 
    Additions and changes
      * Enhancements to the Vim AsciiDoc syntax highlighter, for example,
        quoted text is now highlighted in titles and macro captions.
      * If you define the data-uri intrinsic attribute images referenced by
-       image macros will be embedded in XHTML using the [11]data: URI
+       image macros will be embedded in XHTML using the [109]data: URI
        scheme. NOTE: Microsoft browser support for the data: URI scheme is
        currently limited to MSIE 8 beta 1.
      * Added toc-title attribute to allow custom table of contents titles.
-     * Added references to Alex Efros's AsciiDoc Cheatsheet to AsciiDoc
+     * Added references to Alex Efros’s AsciiDoc Cheatsheet to AsciiDoc
        website.
      * asciidoc(1) and a2x(1) man pages formatted to conform to
        man-pages(7) recommendations.
      * Old code-filter syntax (pre-8.1.0) is no longer recognized so that
        malformed two-line level 2 titles are no longer confused with
        code-filter block delimiters.
-     * Added -> <- => <= arrow replacements from the Arrows block of
-       Unicode.
-     * Added DocBook refentry lang attribute -- patch contributed by
+     * Added → ← ⇒ ⇐ arrow replacements from the Arrows block of Unicode.
+     * Added DocBook refentry lang attribute — patch contributed by
        VMiklos.
-     * AttributeEntry names can now be numeric ("named macro targets").
-     * Hide Table of Contents title if Table of Contents empty -- patch
+     * AttributeEntry names can now be numeric (“named macro targets”).
+     * Hide Table of Contents title if Table of Contents empty — patch
        contributed by Alex Efros.
      * Various XHTML CSS tweaks.
      * Code cleanup:
@@ -315,22 +1382,22 @@
      * A missing closing block delimiter now reports the opening delimiter
        line number instead of the end of file line number.
      * Fixed an error generated by the asciidoc -e option when there are
-       no block definitions -- patch contributed by Alejandro Mery.
+       no block definitions — patch contributed by Alejandro Mery.
      * Handle both \r\n (as well as \n) line separators that may be
        returned by {sys} attribute evaluation.
      * Numbered attribute names no longer interfere with positional
        attribute list values.
      __________________________________________________________________
 
-7. Version 8.2.5 (2007-11-18)
+24. Version 8.2.5 (2007-11-18)
 
    Bug fixes
      * Fixed exception thrown by illegal command-line arguments.
-     * Rolled back the with warning bug fix introduced in 8.2.4 -- it was
+     * Rolled back the with warning bug fix introduced in 8.2.4 — it was
        incompatible with Python <2.5.
      __________________________________________________________________
 
-8. Version 8.2.4 (2007-11-10)
+25. Version 8.2.4 (2007-11-10)
 
    Additions and changes
      * You can now use the lang attribute to set the DocBook language
@@ -352,15 +1419,15 @@
        2.6 has been suppressed.
      __________________________________________________________________
 
-9. Version 8.2.3 (2007-09-12)
+26. Version 8.2.3 (2007-09-12)
 
    Additions and changes
-     * Added VMiklos's permalink patch for auto-generated section IDs
+     * Added VMiklos’s permalink patch for auto-generated section IDs
        (enabled by default by the sectids attribute).
-     * Added [12]FAQ to website.
+     * Added [110]FAQ to website.
      * Changed format of {localdate} attribute to ISO 8601 (%Y-%m-%d).
      * Added abc2ly --beams=None option to make music2png.py conform to
-       ABC's notion of beams.
+       ABC’s notion of beams.
      * XHTML level 2 section headings are now styled with an underlining
        border.
      * XHTML links to AsciiDoc title elements are now implemented with
@@ -386,11 +1453,11 @@
        attribute substitution problems).
      __________________________________________________________________
 
-10. Version 8.2.2 (2007-07-22)
+27. Version 8.2.2 (2007-07-22)
 
    Additions and changes
-     * [13]LaTeXMathML capability has been added for users who are more
-       familiar with or prefer LaTeX math formulas to the [14]ASCIIMathML
+     * [111]LaTeXMathML capability has been added for users who are more
+       familiar with or prefer LaTeX math formulas to the [112]ASCIIMathML
        notation (thanks to Arthur Sakellariou for the patch).
      * The source highlight and code filters now process embedded
        callouts.
@@ -402,47 +1469,48 @@
 
    Bug fixes
      * Fixed an assertion error that occurred when a configuration file
-       containing an \include::[] macro was loaded using the --conf-file
+       containing an include::[] macro was loaded using the --conf-file
        option and the configuration file name did not include an explicit
-       directory path -- patch submitted by Dmitry Potapov.
+       directory path — patch submitted by Dmitry Potapov.
      * Asciidoc titles are only converted to lower case if all characters
-       are upper case otherwise case is left unchanged -- patch submitted
+       are upper case otherwise case is left unchanged — patch submitted
        by Dmitry Potapov.
      * Added a missing check that input is not stdin before loading
-       configuration files from the document directory -- patch submitted
+       configuration files from the document directory — patch submitted
        by Dmitry Potapov.
      * Attribute list items must evaluate to strings, numbers or None
        (previously it was possible to evaluate to other object types which
        resulted in surprising attribute values).
      * If an AsciiDoc document has no title an empty XHTML 1.1 title
-       element is created -- previously the title element was dropped
-       which resulted in invalid XHTML 1.1.
+       element is created — previously the title element was dropped which
+       resulted in invalid XHTML 1.1.
      * The Vim syntax file no longer highlights escaped callouts.
      * The Vim syntax highlighter now correctly highlights Double-dollar
        passthroughs when they enclose dollar delimited ASCIIMathML and
        LaTeXMathML formulas.
      __________________________________________________________________
 
-11. Version 8.2.1 (2007-04-06)
+28. Version 8.2.1 (2007-04-06)
 
    Additions and changes
      * A number of improvements have been made to the Vim syntax
        highlighter, for example the word C++ is no longer mistaken for the
        start of an unconstrained monospace quote.
-     * Labeled list definitions have been tightened -- a list label can no
+     * Labeled list definitions have been tightened — a list label can no
        longer containing trailing spaces. The following example is no
        longer recognized as a valid list label:
-  Lorum ipsum ::
-       This change implements the originally intended behavior (as per the
-       AsciiDoc documentation and examples) so there should be very few
-       compatibility issues.
+
+        Lorum ipsum
+                This change implements the originally intended behavior
+                (as per the AsciiDoc documentation and examples) so there
+                should be very few compatibility issues.
      __________________________________________________________________
 
-12. Version 8.2.0 (2007-04-04)
+29. Version 8.2.0 (2007-04-04)
 
    Additions and changes
      * A Vim syntax file is now included in the AsciiDoc distribution
-       (inspired by Felix Obenhuber's asciidoc.vim script). You can find
+       (inspired by Felix Obenhuber’s asciidoc.vim script). You can find
        it (along with a Vim filetype detection script in the distribution
        ./vim/ directory (the scripts are installed automatically by the
        AsciiDoc installer ./install.sh). See Appendix J of the AsciiDoc
@@ -454,7 +1522,7 @@
      * Added a listindex attribute which is the current list item index
        (1..). If this attribute appears outside a list its value is the
        number of items in the most recently closed list.
-     * The single line titles syntax now accepts trailing suffixes -- this
+     * The single line titles syntax now accepts trailing suffixes — this
        syntax matches the title line syntax of a number of popular Wiki
        markups.
      * If a QuoteBlock has no attribution or citetitle then the DocBook
@@ -472,24 +1540,25 @@
      * If a2x(1) --doctype option is not specified it defaults to manpage
        if --format=manpage else defaults to article (previously --doctype
        always defaulted to article).
-     * Added an External Resources section to the [15]AsciiDoc home page.
+     * Added an External Resources section to the [113]AsciiDoc home page.
      __________________________________________________________________
 
-13. Version 8.1.0 (2006-10-22)
+30. Version 8.1.0 (2006-10-22)
 
    Additions and changes
      * AsciiDoc generated XHTML documents now display a table of contents
        if the toc attribute is defined (JavaScript needs to be enabled for
        this to work). Thanks to Troy Hanson who contributed this feature
-       based on a JavaScript by Mihai Bazon. I've simplified things
-       somewhat to match Docbook XSL Stylesheets style, see Troy's [16]tpl
-       User Guide for a fancier layout. Use the -a toc -a numbered
-       command-line options to produce a number table of contents.
-     * A [17]music filter is included in the distribution ./filters/
-       directory. It translates music in [18]LilyPond or [19]ABC notation
-       to standard classical notation in the form of a trimmed PNG image
-       which is inserted into the AsciiDoc output document.
-     * Incorporated Paul Melis's Win32 filter patch. This workaround
+       based on a JavaScript by Mihai Bazon. I’ve simplified things
+       somewhat to match Docbook XSL Stylesheets style, see Troy’s
+       [114]tpl User Guide for a fancier layout. Use the -a toc -a
+       numbered command-line options to produce a number table of
+       contents.
+     * A [115]music filter is included in the distribution ./filters/
+       directory. It translates music in [116]LilyPond or [117]ABC
+       notation to standard classical notation in the form of a trimmed
+       PNG image which is inserted into the AsciiDoc output document.
+     * Incorporated Paul Melis’s Win32 filter patch. This workaround
        allows AsciiDoc to run filters under Windows.
      * Added uninstall.sh script.
      * Rather than proliferate a confusing number of filter block
@@ -511,13 +1580,13 @@
      * Added {verbose} intrinsic attribute (useful for passing verbose
        flag to filters).
      * Added {outdir} intrinsic attribute.
-     * Renamed {docdir} intrinsic attribute to unambiguous`{indir}
-       ({docdir}` still works but may be removed in future release).
+     * Renamed {docdir} intrinsic attribute to unambiguous {indir}
+       ({docdir} still works but may be removed in future release).
      * If asciidoc(1) outputs to stdout then intrinsic attribute {docname}
        is extracted from the input file name.
      __________________________________________________________________
 
-14. Version 8.0.0 (2006-08-27)
+31. Version 8.0.0 (2006-08-27)
 
    This is a major release because changes to quoting and index entry
    handling may break existing documents (see Additions and changes below
@@ -525,7 +1594,7 @@
 
    Please report any problems you encounter.
 
-   [20]Stuart Rackham
+   [118]Stuart Rackham
 
    Additions and changes
      * Quoting can can occur within words (based on patch submitted by
@@ -536,7 +1605,7 @@
        arguably better choices than the apostrophe and backtick as they
        are not confused with punctuation.
      * The syntax for index entry macros have have been deprecated from
-       +...+ and +...+ to ((...)) and (((...))) respectively. Rationale:
+       +...+ and ++...++ to ((...)) and (((...))) respectively. Rationale:
           + Bracketing is consistent other with [[...]] and <<...>>
             reference macros.
           + To easily confused with triple plus passthroughs.
@@ -559,10 +1628,10 @@
      * Experimental rows attribute (number of source lines in table)
        available in table markup templates (used by experimental LaTeX
        backend).
-     * Included install shell script written by [21]Jacob Mandelson for
+     * Included install shell script written by [119]Jacob Mandelson for
        installing the tarball distribution.
      * Added INSTALL documentation file.
-     * Added replacements2 substitution options -- a second replacements
+     * Added replacements2 substitution options — a second replacements
        section.
      * Added the ability to redefine normal and verbatim substitutions
        with subsnormal and subsverbatim entries in configuration file
@@ -574,7 +1643,7 @@
        a backslash, just escape the trailing backslash with a backslash.
        For example:
   abc\\=xyz
-       Results in name=abc\ and value=xyz --  previously this would have
+       Results in name=abc\ and value=xyz —  previously this would have
        escaped the = character.
      * A blank configuration file section deletes any preceding section
        with the same name (applies to non-markup template sections).
@@ -583,19 +1652,19 @@
        command-line attributes have precedence over document and
        configuration file attributes).
      * localtime attribute is now encoded from the native system encoding
-       to the output encoding. Patch submitted by [22]FKtPp -- here's his
+       to the output encoding. Patch submitted by [120]FKtPp — here’s his
        description of the problem:
-       "I am a Chinese user of AsciiDoc and I find that when I use UTF-8
+       “I am a Chinese user of AsciiDoc and I find that when I use UTF-8
        (the default encoding) to write asciidoc documents in Windows
        platform the resulting html footer line will get screwed. It was
        caused by a localized tzname that was always encoded in the windows
-       native encoding, which in my case is cp936."
-     * a2x(1) can generate Open Document Text files using [23]docbook2odf.
-       Currently docbook2odf(1) only processes a subset of DocBook,
-       unimplemented elements are skipped.
+       native encoding, which in my case is cp936.”
+     * a2x(1) can generate Open Document Text files using
+       [121]docbook2odf. Currently docbook2odf(1) only processes a subset
+       of DocBook, unimplemented elements are skipped.
      * The a2x(1) format option defaults to xhtml (previously a format had
        to be specified explicitly).
-     * The -d, --doctype=DOCTYPE option has been added to a2x(1) which is
+     * The -d, \--doctype=DOCTYPE option has been added to a2x(1) which is
        a shortcut for --asciidoc-options="--doctype=DOCTYPE".
      * Replaced a2x(1) --no-icons and --no-copy options with their negated
        equivalents: --icons and --copy respectively. The default behavior
@@ -618,33 +1687,33 @@
        output file was missing or older than the source file.
      __________________________________________________________________
 
-15. Version 7.1.2 (2006-03-07)
+32. Version 7.1.2 (2006-03-07)
 
    Additions and changes
-     * Support for [24]ASCIIMathML has been added. See Appendix I:
+     * Support for [122]ASCIIMathML has been added. See Appendix I:
        ASCIIMathML Support in the User Guide and the examples at
-       [25]http://www.methods.co.nz/asciidoc/asciimath.html.
+       [123]http://www.methods.co.nz/asciidoc/asciimath.html.
      * You can now prefix quoted text with inline attributes lists. You
        can use this to set font size and color (XHTML and HTML outputs).
-     * Added #...\# quoting -- it does nothing -- it's purpose is to allow
+     * Added ##...## quoting — it does nothing — it’s purpose is to allow
        inline attributes to be applied to normal text.
-     * An [26]inline passthrough mechanism has been implemented.
-     * Configuration file comment lines can be escaped with a backslash --
-        this is to allows the inclusion of configuration lines that start
+     * An inline passthrough mechanism has been implemented.
+     * Configuration file comment lines can be escaped with a backslash —
+       this is to allows the inclusion of configuration lines that start
        with a hash character.
      * The scriptsdir attribute can be used to specify the name of the
-       directory containing linked JavaScripts (see the [27]User Guide for
-       details.
+       directory containing linked JavaScripts (see the [124]User Guide
+       for details.
      * The BackendBlock has been renamed PassthroughBlock for consistency
        with the new inline passthrough naming.
      * a2x(1) now works with the older bash(1) version 2.05b. Patch
-       submitted by [28]Francis Daly.
-     * Content included by the \include1::[] system macro is no longer
+       submitted by [125]Francis Daly.
+     * Content included by the include1::[] system macro is no longer
        subject to attribute substitution so that ambiguities no longer
        arise when used to include CSS or JavaScript files.
      __________________________________________________________________
 
-16. Version 7.1.1 (2006-02-24)
+33. Version 7.1.1 (2006-02-24)
 
    Additions and changes
      * The caption attribute can be used to customize admonition captions
@@ -662,7 +1731,7 @@
 
    Bug fixes
      * a2x(1) failed when configuration files were installed in the global
-       /etc/asciidoc/ directory -- it was only searching the directory
+       /etc/asciidoc/ directory — it was only searching the directory
        containing the asciidoc executable (thanks to Christian Wiese for
        finding and submitting a patch this bug).
      * The html4 backend admonition caption now correctly displays the
@@ -670,7 +1739,7 @@
        attribute).
      __________________________________________________________________
 
-17. Version 7.1.0 (2006-01-13)
+34. Version 7.1.0 (2006-01-13)
 
    Additions and changes
      * a2x(1) toolchain wrapper utility. This overcomes the biggest hurdle
@@ -697,12 +1766,13 @@
      * Packager notes (appendix B) have been updated to reflect the needs
        of a2x(1).
 
-   Important: The renaming of the xhtml11 backend imagesdir intrinsic
-   attribute and it's new default value introduces a backward
-   compatibility issue: if you use the icons attribute you will need to
-   either move your icons to the new default ./images/icons location or
-   include an --attribute iconsdir="your_icons_path" option in your
-   asciidoc commands.
+ Important
+          The renaming of the xhtml11 backend imagesdir intrinsic attribute and
+          it’s new default value introduces a backward compatibility issue: if
+          you use the icons attribute you will need to either move your icons to
+          the new default ./images/icons location or include an
+          --attribute{nbsp}iconsdir="your_icons_path" option in your asciidoc
+          commands.
 
    Bug fixes
      * Backslash line continuation is now observed in verbatim paragraphs.
@@ -710,7 +1780,7 @@
        ./examples/website/build-website.sh script.
      __________________________________________________________________
 
-18. Version 7.0.4 (2005-12-08)
+35. Version 7.0.4 (2005-12-08)
 
    Additions and changes
      * Added ternary conditional attributes
@@ -724,13 +1794,13 @@
        still accepts the --safe option).
      * Backend Blocks are now flagged unsafe (they could be used to
        include arbitrary and hence potentially unsafe output content).
-     * Filters are no longer considered unsafe. There's not much point in
+     * Filters are no longer considered unsafe. There’s not much point in
        insisting on filter safety since the installation of an unsafe
        filter would require the introduction of new or modified
-       configuration files -- if your application configurations can be
-       compromised you're in all sorts of trouble (safe mode protects
+       configuration files — if your application configurations can be
+       compromised you’re in all sorts of trouble (safe mode protects
        against unsafe input files not unsafe configuration). As with all
-       filters, before installing, you should verify that they can't be
+       filters, before installing, you should verify that they can’t be
        coerced into generating malicious output or exposing sensitive
        information.
 
@@ -739,16 +1809,16 @@
        Guide.
      __________________________________________________________________
 
-19. Version 7.0.3 (2005-12-01)
+36. Version 7.0.3 (2005-12-01)
 
    Additions and changes
-     * Added --safe and --unsafe command-line options -- AsciiDoc can now
+     * Added --safe and --unsafe command-line options — AsciiDoc can now
        be executed in a safe mode which disallows the execution of
        arbitrary code or the inclusion of arbitrary files (see
-       [29]Appendix C in the AsciiDoc User Guide).
-     * Included [30]source-highlight filter in the distribution
+       [126]Appendix C in the AsciiDoc User Guide).
+     * Included [127]source-highlight filter in the distribution
        ./examples/source-highlight-filter/ directory (based on filter
-       submitted by [31]Ryan Phillips).
+       submitted by [128]Ryan Phillips).
      * Included the DocBook XSL Stylesheets 1.69.1 customizations used to
        generate the distributed AsciiDoc documentation (read the
        asciidoc-docbook-xsl.txt file in the distribution ./docbook-xsl/
@@ -763,7 +1833,7 @@
        because default border styles vary from browser to browser.
      __________________________________________________________________
 
-20. Version 7.0.2 (2005-08-28)
+37. Version 7.0.2 (2005-08-28)
 
    Additions and changes
      * There are now long versions of all AsciiDoc options.
@@ -779,19 +1849,19 @@
      * Documentation errata.
      __________________________________________________________________
 
-21. Version 7.0.1 (2005-06-24)
+38. Version 7.0.1 (2005-06-24)
 
    Additions and changes
-     * Reverted to use of strong, em, tt XHTML tags -- they're more
-       obvious and no less correct than span tags, besides, the generated
-       file sizes are smaller (the User Guide was 11% smaller).
+     * Reverted to use of strong, em, tt XHTML tags — they’re more obvious
+       and no less correct than span tags, besides, the generated file
+       sizes are smaller (the User Guide was 11% smaller).
      * Table title rendered with caption tag rather than a separate div.
      * The AsciiDoc stylesdir attribute (if specified) is now recognized
        when searching for embedded stylesheets (previously only searched
        default ./stylesheets directory).
-     * Default charset encoding changed from ISO-8859-1 to UTF-8 -- it's
+     * Default charset encoding changed from ISO-8859-1 to UTF-8 — it’s
        less language specific and displays most common languages.
-     * \template::[] macros now expand in all configuration file sections
+     * template::[] macros now expand in all configuration file sections
        previously only in markup template sections.
      * Cleaned up example website layout CSS and configuration
        (presentation has not been changed).
@@ -807,32 +1877,32 @@
      * AsciiDoc table format attribute in table attribute lists were not
        recognized.
      * The nested horizontal labeled list example in the AsciiDoc User
-       Guide has been dropped -- it generated invalid DocBook markup.
+       Guide has been dropped — it generated invalid DocBook markup.
      __________________________________________________________________
 
-22. Version 7.0.0 (2005-06-06)
+39. Version 7.0.0 (2005-06-06)
 
    This is a major release with many code and documentation changes.
    Please report any problems you encounter.
 
-   [32]Stuart Rackham
+   [129]Stuart Rackham
 
    Additions and changes
      * A new xhtml11 backend generates XHTML 1.1 with integrated CSS2
        replacing the previous xhtml, css, and css-embedded backends.
      * The CSS stylesheets have finally been rewritten.
-     * The asciidoc(1) command help now includes user [33]customizable
+     * The asciidoc(1) command help now includes user [130]customizable
        help topics. When asciidoc is invoked with the --help option the
        command argument is interpreted as a help topic.
      * The previous example website has been replaced by the actual
        AsciiDoc website (see ./examples/website/.
      * XHTML generation options now controlled by the following
        attributes: badges, linkcss, icons, numbered, quirks, theme,
-       stylesdir, imagesdir (see the [34]User Guide for details.
+       stylesdir, imagesdir (see the [131]User Guide for details.
      * By default HTML and XHTML are output as stand-alone documents (no
        embedded CSS and no linked admonition icon images).
      * Documents encoded with the UTF-8 Unicode character set are now
-       processed thanks to a patch supplied by [35]Viktor Vasilev.
+       processed thanks to a patch supplied by [132]Viktor Vasilev.
      * The -a ^name command-line syntax to undefine an attribute has been
        deprecated in favor of the -a name! syntax.
      * AttributeEntry syntax addition: :name!: to undefine name attribute.
@@ -861,7 +1931,7 @@
      * The section-numbers section numbering attribute has be renamed
        numbered.
      * Dropped the #UNDER CONSTRUCTION# block macro.
-     * Rewrote Paragraph and DelimitedBlock handlers adding a [36]styles
+     * Rewrote Paragraph and DelimitedBlock handlers adding a [133]styles
        configuration entry.
 
    Bug fixes
@@ -869,12 +1939,12 @@
        content.
      * Manpage command names containing dashes (in the manpage NAME
        section) were misinterpreted as the spaced dash command
-       name/purpose separator. Bug report and patch supplied by [37]David
+       name/purpose separator. Bug report and patch supplied by [134]David
        Greaves.
      * Unexpected error following malformed author line error.
      __________________________________________________________________
 
-23. Version 6.0.3 (2005-04-20)
+40. Version 6.0.3 (2005-04-20)
 
    Additions and changes
      * Special characters are now substituted in AttributeEntry element
@@ -888,8 +1958,8 @@
      * Single lines starting with two forward slashes hard up against the
        left margin are treated as comments and are not processed.
      * Renamed section delimited block option to sectionbody to more
-       accurately reflect it's role.
-     * Added a List Continuation block -- a specialized delimited block
+       accurately reflect it’s role.
+     * Added a List Continuation block — a specialized delimited block
        that is functionally equivalent to the List Item Continuation
        feature except that the list contained within the block does not
        require explicit + list item continuation lines.
@@ -902,10 +1972,10 @@
        exceptions to occur.
      __________________________________________________________________
 
-24. Version 6.0.2 (2005-03-30)
+41. Version 6.0.2 (2005-03-30)
 
    Additions and changes
-     * Three new system block macros have been added -- eval, sys and sys2
+     * Three new system block macros have been added — eval, sys and sys2
        which are the block macro equivalents to the same named system
        attributes.
      * Intrinsic macros have been renamed system macros along with action
@@ -918,14 +1988,14 @@
      * Asciidoc now searches in /etc/asciidoc/filters for filters.
      __________________________________________________________________
 
-25. Version 6.0.1 (2005-03-06)
+42. Version 6.0.1 (2005-03-06)
 
    Additions and changes
      * A global configuration file location /etc/asciidoc has been added
        and is now processed before all other locations (patch supplied by
-       [38]Fredrik Steen).
+       [135]Fredrik Steen).
      * Recoded tempfile.mktemp() and other artifacts that are no longer
-       necessary or desirable (patches supplied by [39]Fredrik Steen).
+       necessary or desirable (patches supplied by [136]Fredrik Steen).
      * Added BUGS file to the distribution.
 
    Bug fixes
@@ -933,29 +2003,30 @@
        illegal CSS in files generated by the css-embedded backend.
      __________________________________________________________________
 
-26. Version 6.0.0 (2005-01-28)
+43. Version 6.0.0 (2005-01-28)
 
    This release has had some fairly major code and documentation changes.
    Please report any problems you encounter.
 
-   [40]Stuart Rackham
+   [137]Stuart Rackham
 
-   A lot of new stuff. A new major version number -- some regression
+   A lot of new stuff. A new major version number — some regression
    incompatibility (hopefully mitigated by deprecated warnings).
 
-   Went mad trying to rein in the current feature anarchy -- established a
+   Went mad trying to rein in the current feature anarchy — established a
    unified notion of document attributes. Attempted to introduce a
-   consistent vocabulary -- renamed many poorly or inconsistently named
+   consistent vocabulary — renamed many poorly or inconsistently named
    entities.
 
    Actually, deprecated syntax is still processed correctly in almost all
    cases. One source of incompatibility that may arise if you have
    customized CSS stylesheets is the change of AsciiDoc CSS class names
-   (see below). I guess the moral is if you've done a lot of configuration
+   (see below). I guess the moral is if you’ve done a lot of configuration
    file customization and are happy with version 5 then you may want to
    stay put.
 
-   Note: This version requires Python 2.3 or better to run.
+   Note
+       This version requires Python 2.3 or better to run.
 
    Additions and changes
      * Glossary entries have been renamed attributes. This eliminates
@@ -970,7 +2041,7 @@
      * Quoted text can now span multiple lines (thanks to James Bowlin for
        this patch).
      * Inline macros can now span multiple lines.
-     * ``double backtick / apostrophe'' quotes generate "curly quotes".
+     * ‘`double backtick / apostrophe’' quotes generate “curly quotes”.
      * A warning is now emitted for out of order list item (applies to
        explicitly enumerated numbered list items).
      * Added include action attribute.
@@ -983,7 +2054,8 @@
      * An {stylesdir} attribute specifies the location of CSS stylesheets
        when generating styled HTML (the default location for configured
        markup is .).
-     * list entry has been deprecated, use {0} instead.
+     * The use of the (often inappropriately named) {caption} attribute
+       list entry has been deprecated, use {0} instead.
      * New ExampleBlock delimited block along with associated variants
        Note, Tip, Warning, Caution and Important.
      * The docbook.conf file now facilitates the optional inclusion of a
@@ -994,10 +2066,10 @@
        BackendBlock; SimpleSection to SectionBody. Any corresponding CSS
        class names have also been changed which could result in backward
        incompatibility in customized stylesheets.
-     * Swapped plain DocBook admonition icons for Jimmac's DocBook icons
-       ([41]http://jimmac.musichall.cz/ikony.php3). The original plain
+     * Swapped plain DocBook admonition icons for Jimmac’s DocBook icons
+       ([138]http://jimmac.musichall.cz/ikony.php3). The original plain
        icons have been moved to ./images/plain.
-     * Renamed html backend to xhtml to better reflect it's function
+     * Renamed html backend to xhtml to better reflect it’s function
        (former html-4 backend renamed to html).
      * A new inline anchor macro syntax [[[<id>]]] is available, it
        displays [<id>] at the anchor location and is for anchoring
@@ -1010,7 +2082,7 @@
        the preceding list item element with a line containing a single
        plus character.
      * A new Horizontal Labeled List list type has been added. Generates
-       two column list -- the first column contains the list element
+       two column list — the first column contains the list element
        labels, the second contains the element text. Same syntax as
        Vertical Labeled Lists except the double colon label suffix is
        followed by the start of the list item text.
@@ -1027,10 +2099,10 @@
        now indents text correctly.
      __________________________________________________________________
 
-27. Version 5.1.1 (2004-10-10)
+44. Version 5.1.1 (2004-10-10)
 
    15-December-2004: Interim update: Updated asciidoc.py to fix broken
-   join_lines function -- no other changes.
+   join_lines function — no other changes.
      * PDF documentation is now produced from DocBook XML using XSLTLib
        and FOP. Previously we processed DocBook SGML with jw(1) (which
        used Dvips to convert DVI files to PDF). FOP has come a long way in
@@ -1044,13 +2116,13 @@
      * Special characters are emitted using decimal Unicode character
        codes (previously used named character entities which cannot be
        assumed included in non-HTML documents).
-     * Added registered trademark � to [replacements].
+     * Added registered trademark ® to [replacements].
      * CSS stylesheet tweaks.
      * Admonitions (Note, Tip, Important, Warning, Caution) include icons
        when generating css output.
      __________________________________________________________________
 
-28. Version 5.1.0 (2004-09-18)
+45. Version 5.1.0 (2004-09-18)
 
      * Callouts have been implemented (see the Callouts section of the
        AsciiDoc User Guide for details).
@@ -1059,7 +2131,7 @@
      * Added CSS stylesheet for HTML generated from DocBook XML using XSL
        stylesheets.
      * Distribution contains HTML Help formatted User Guide
-       (./doc/asciidoc.chm), the User Guide tells you how it's generated.
+       (./doc/asciidoc.chm), the User Guide tells you how it’s generated.
      * Images referred to by distributed stylesheets are now located in
        the ./images subdirectory (previously located in .).
      * Filters path names are now handled properly under Cygwin.
@@ -1067,23 +2139,23 @@
        polishing.
      __________________________________________________________________
 
-29. Version 5.0.9 (2004-09-09)
+46. Version 5.0.9 (2004-09-09)
 
      * The convention of using a .asc file extension for AsciiDoc files
        has been dropped in favor of the familiar .txt extension. It makes
        more sense in that AsciiDoc is a text presentation format and
        because .asc clashed with the same extension used by other
-       applications. It's only a naming convention -- you don't have to
-       switch if you don't want to.
+       applications. It’s only a naming convention — you don’t have to
+       switch if you don’t want to.
      * Changed the subscript formatting character from underline to tilde
        since underscores in file names are reasonably common (especially
        in link and image macros).
      * An alternative syntax for the index term inline macro has been
-       added: <primary>,<secondary>,<tertiary>.
+       added: ++<primary>,<secondary>,<tertiary>++.
      * Index terms that have secondary and tertiary entries now
        additionally generate separate index terms for the secondary and
        tertiary entries.
-     * A <primary> index term inline macro has been added which displays
+     * A +<primary>+ index term inline macro has been added which displays
        the term in the primary text flow.
      * Added alternative variable list definition using double semi-colon
        terminator as opposed to the standard double colon terminator so
@@ -1092,7 +2164,7 @@
        outputs.
      * Python version compatibility is checked at startup.
      * Preface and appendix section titles in multi-part Book documents
-       are meant to be out of sequence -- warnings are no longer emitted
+       are meant to be out of sequence — warnings are no longer emitted
        when outputting HTML.
      * Empty section warnings have been replaced by error messages and are
        emitted only if invalid markup would result.
@@ -1111,7 +2183,7 @@
      * Documentation additions and corrections.
      __________________________________________________________________
 
-30. Version 5.0.8 (2004-05-15)
+47. Version 5.0.8 (2004-05-15)
 
      * Spurious out of sequence level 2 warnings no longer appear when
        processing book document multi-part book top level Preface and
@@ -1124,12 +2196,12 @@
        documents.
      * Added superscripts and subscripts to the standard PRS configuration
        files.
-     * Adjusted CSS stylesheets so list titles don't have so much space
+     * Adjusted CSS stylesheets so list titles don’t have so much space
        between title and first list item (broken in IE6 due to poor CSS
        compliance). Lessened sidebar title top margin.
      __________________________________________________________________
 
-31. Version 5.0.7 (2004-04-22)
+48. Version 5.0.7 (2004-04-22)
 
      * The version 5.0.6 README incorrectly stated that AsciiDoc would run
        under Python 2.0, in fact it requires Python 2.1 or better. The
@@ -1150,7 +2222,7 @@
        with with white space.
      __________________________________________________________________
 
-32. Version 5.0.6 (2004-03-07)
+49. Version 5.0.6 (2004-03-07)
 
      * New image macro implements optional image scaling and linking and
        works in both inline and block contexts. The image macro obsolesces
@@ -1176,17 +2248,17 @@
      * Section titles can be optionally suffixed with title arguments
        enclosed in double square brackets.
      * A replacement has been added to asciidoc.conf to replace inline
-       double dashes with the -- entity.
-     * Changed the .UNDER-CONSTRUCTION. macro syntax to UNDER-CONSTRUCTION
-       so it is not mistaken for a BlockTitle. Similarly changed the .NEW.
-       replacement with #NEW#.
-     * &35;NEW# and #UNDER-CONSTRUCTION macros are now included in the
-       DocBook backend.
+       double dashes with the &mdash; entity.
+     * Changed the .UNDER-CONSTRUCTION. macro syntax to
+       #UNDER-CONSTRUCTION# so it is not mistaken for a BlockTitle.
+       Similarly changed the .NEW. replacement with &#35;NEW&#35;.
+     * &#35;NEW&#35; and #UNDER-CONSTRUCTION# macros are now included in
+       the DocBook backend.
      * Replaced shipped smallnew.gif with smallnew.png.
      * Documentation tidy ups.
      __________________________________________________________________
 
-33. Version 5.0.5 (2004-02-25)
+50. Version 5.0.5 (2004-02-25)
 
      * Fixed the disappearing paragraph titles problem that was caused by
        Inline macros (incorrectly) processing BlockTitles.
@@ -1195,7 +2267,7 @@
        invalid output markup.
      __________________________________________________________________
 
-34. Version 5.0.4 (2004-02-09)
+51. Version 5.0.4 (2004-02-09)
 
      * Reinstated missing infile, outfile, filetype and
        filetype-<filetype> glossary entries.
@@ -1203,7 +2275,7 @@
        this has now been documented.
      __________________________________________________________________
 
-35. Version 5.0.3 (2004-01-23)
+52. Version 5.0.3 (2004-01-23)
 
      * Fixed problem that caused any filters directory file containing
        .conf (not just those with the .conf extension) from being loaded.
@@ -1220,7 +2292,7 @@
        from configuration file substitution sections.
      __________________________________________________________________
 
-36. Version 5.0.2 (2003-12-18)
+53. Version 5.0.2 (2003-12-18)
 
      * New (alternative) anchor and xref macro syntax (old syntax still
        valid).
@@ -1234,17 +2306,17 @@
      * Documentation updates and corrections.
      __________________________________________________________________
 
-37. Version 5.0.1 (2003-12-09)
+54. Version 5.0.1 (2003-12-09)
 
      * Fixed problem with anchor tag when generating CSS styled HTML.
      __________________________________________________________________
 
-38. Version 5.0 (2003-12-08)
+55. Version 5.0 (2003-12-08)
 
    This release has had some fairly major code and documentation changes.
    Please report any problems you encounter.
 
-   [42]Stuart Rackham
+   [139]Stuart Rackham
 
      * AsciiDoc can now produce a full-blown multi-part DocBook book
        including dedication, abstract, preface, colophon, glossary,
@@ -1294,7 +2366,7 @@
        .docbook to .xml (.sgml for the docbook-sgml backend).
      __________________________________________________________________
 
-39. Version 4.2 (2003-11-26)
+56. Version 4.2 (2003-11-26)
 
      * The default HTML output is now XHTML 1.0 markup. To output the
        former HTML 4 markup specify the html-4 backend.
@@ -1312,7 +2384,7 @@
        This is in preference to the existing delimiter embedded arguments.
        Reasons:
           + The syntax is in keeping with the Tables arguments syntax.
-          + It's easier to enter and implements line continuation.
+          + It’s easier to enter and implements line continuation.
      * A new QuoteBlock DelimitedBlock definition has been added to the
        distribution configuration files.
      * The table arguments lines can be continued using the backslash line
@@ -1322,7 +2394,7 @@
        arguments.
      __________________________________________________________________
 
-40. Version 4.1 (2003-11-13)
+57. Version 4.1 (2003-11-13)
 
      * Added DSV (Delimiter Separated Values) tables format.
      * {eval:<expr>} glossary references drop the containing line if
@@ -1342,11 +2414,11 @@
      * Fixed: CSS styled HTML tables are now fully XHTML 1.0 conformant.
      * Fixed: tablewidth was processed incorrectly when passed as table
        argument.
-     * Fixed: Glossary references like {x={y}} were one character off if
+     * Fixed: Glossary references like {x=\{y}} were one character off if
        {x] was defined and {y} was not.
      __________________________________________________________________
 
-41. Version 4.0 (2003-11-08)
+58. Version 4.0 (2003-11-08)
 
    This release has had some fairly major code and documentation changes.
    Please report any problems you encounter.
@@ -1394,7 +2466,7 @@
      * Many documentation changes/additions/corrections.
      __________________________________________________________________
 
-42. Version 3.2.2 (2003-10-26)
+59. Version 3.2.2 (2003-10-26)
 
      * Added -n option (synonym for -g section-numbers).
      * Dropped the processing commentary (hey, this is Unix).
@@ -1427,7 +2499,7 @@
      * Documentation changes/additions/corrections.
      __________________________________________________________________
 
-43. Version 3.2 (2003-05-26)
+60. Version 3.2 (2003-05-26)
 
      * Added a -s command-line option to suppress the output of [header]
        and [footer] sections.
@@ -1457,7 +2529,7 @@
      * Internal code tidy up.
      __________________________________________________________________
 
-44. Version 3.1 (2003-05-18)
+61. Version 3.1 (2003-05-18)
 
      * In version 3.0 a [macros] section entry of the form name was
        equivalent to name=. An entry of the form name now undefines the
@@ -1487,7 +2559,7 @@
        option).
      __________________________________________________________________
 
-45. Version 3.0 (2003-05-13)
+62. Version 3.0 (2003-05-13)
 
    This version is the culmination of work begun in the 2.x releases
    whereby fixed policy has been replaced by extensible mechanisms.
@@ -1523,14 +2595,14 @@
        configuration files.
      __________________________________________________________________
 
-46. Version 2.2 (2003-04-07)
+63. Version 2.2 (2003-04-07)
 
      * The master.conf configuration file name has been deprecated in
        favor of asciidoc.conf.
      * The standard configuration files set is now loaded from the
        .asciidoc folder in the users home directory (if it exists) and
        then from the source document directory. Configuration files that
-       don't exist are silently skipped.
+       don’t exist are silently skipped.
      * Configuration files named like the source file will be
        automatically loaded if they are found in the source file
        directory. For example if the source file is mydoc.asc and the -b
@@ -1560,22 +2632,21 @@
      * Corrected {infile} and {outfile} glossary entry documentation.
      * File inclusion is now limited to a depth of 5 to catch recursion
        loops.
-     * Inline tags have been deprecated, they're not necessary and they
+     * Inline tags have been deprecated, they’re not necessary and they
        immediately make the source document backend specific. Use
        CustomBlocks or Substitutions instead.
      __________________________________________________________________
 
-47. Version 2.1 (2003-03-17)
+64. Version 2.1 (2003-03-17)
 
      * Added section auto numbering {sectnum} glossary entry
        (auto-numbering function contributed by Ludovico Magnocavallo).
      * asciidoc(1) now correctly returns non-zero exit status if an error
        occurs.
      * An AsciiDoc example website has been included in the AsciiDoc
-       distribution examples/website directory (also online at
-       [43]http://www.methods.co.nz/asciidoc/examples/website/).
+       distribution examples/website directory.
      * NOTE: The asciidoc wrapper script included in the 2.0 distribution
-       has been dropped, if you've symlinked or aliased to asciidoc you'll
+       has been dropped, if you’ve symlinked or aliased to asciidoc you’ll
        need to change them to point directly to asciidoc.py instead.
      * An RCS $Id$ marker can be used as the document header revision line
        (based on a patch submitted by Ludovico Magnocavallo).
@@ -1595,7 +2666,7 @@
        {asciidoc-version} (to it consistent with other entries).
      __________________________________________________________________
 
-48. Version 2.0 (2003-02-24)
+65. Version 2.0 (2003-02-24)
 
      * The emphasized, strong and monospaced words options have been
        generalized with the introduction of macro based special words
@@ -1649,14 +2720,14 @@
      * Added author and author-mail meta tags to HTML configuration files.
      __________________________________________________________________
 
-49. Version 1.5 (2003-01-08)
+66. Version 1.5 (2003-01-08)
 
      * Implemented sidebar document elements.
      * Explicit checks for user specified configuration files and input
        file (rather than throwing exception).
      __________________________________________________________________
 
-50. Version 1.4 (2003-01-04)
+67. Version 1.4 (2003-01-04)
 
      * New configuration file options emphasizedwords and strongwords.
        These allow the definition of words that will always be emphasized
@@ -1676,7 +2747,7 @@
      * More documentation additions and tidy ups.
      __________________________________________________________________
 
-51. Version 1.3 (2003-01-01)
+68. Version 1.3 (2003-01-01)
 
      * A new strong text formatting convention has been implemented: Word
        phrases enclosed in pairs of single quote characters (acute
@@ -1705,7 +2776,7 @@
      * Code, configuration file and documentation tidy ups.
      __________________________________________________________________
 
-52. Version 1.2 (2002-12-28)
+69. Version 1.2 (2002-12-28)
 
      * Implemented include URL to allow file inclusion.
      * fileextension configuration file [option] renamed to more sensible
@@ -1720,7 +2791,7 @@
      * Bug fixes.
      __________________________________________________________________
 
-53. Version 1.1 (2002-12-03)
+70. Version 1.1 (2002-12-03)
 
      * Added css (cascading style sheets) backend
      * Implemented IndentedBlock document element.
@@ -1737,60 +2808,156 @@
      * Fixed error that occurred when == title underline was used.
      __________________________________________________________________
 
-54. Version 1.0 (2002-11-25)
+71. Version 1.0 (2002-11-25)
 
    First AsciiDoc public release along with AsciiDoc web site
-   ([44]http://www.methods.co.nz/asciidoc/) and SourceForge.net project
-   registration ([45]https://sourceforge.net/projects/asciidoc/).
+   ([140]http://www.methods.co.nz/asciidoc/) and SourceForge.net project
+   registration ([141]https://sourceforge.net/projects/asciidoc/).
      __________________________________________________________________
 
-   Version 8.3.3
-   Last updated 2009-01-02 12:59:07 NZDT
+   Version 8.6.5
+   Last updated 2011-05-19 12:14:31 NZST
 
 References
 
-   1. http://www.methods.co.nz/asciidoc/INSTALL.html
-   2. http://www.methods.co.nz/asciidoc/newtables.html
-   3. http://www.methods.co.nz/asciidoc/newlists.html
-   4. http://www.methods.co.nz/asciidoc/userguide.html#X77
-   5. http://www.methods.co.nz/asciidoc/userguide.html#X76
-   6. http://www.methods.co.nz/asciidoc/latexmath.pdf
-   7. http://www.methods.co.nz/asciidoc/asciimathml.html
-   8. http://www.methods.co.nz/asciidoc/latexmathml.html
-   9. http://www.methods.co.nz/asciidoc/source-highlight-filter.html
-  10. https://sharesource.org/hg/asciidoc/
-  11. http://en.wikipedia.org/wiki/Data:_URI_scheme
-  12. http://www.methods.co.nz/asciidoc/faq.html
-  13. http://www.maths.nottingham.ac.uk/personal/drw/lm.html
-  14. http://www.methods.co.nz/asciidoc/asciimath.html
-  15. http://www.methods.co.nz/asciidoc/index.html
-  16. http://tpl.sourceforge.net/userguide.html
-  17. http://www.methods.co.nz/asciidoc/music-filter.html
-  18. http://lilypond.org/
-  19. http://abcnotation.org.uk/
-  20. mailto:srackham@gmail.com
-  21. mailto:jlm@ofb.net
-  22. mailto:m_pupil@yahoo.com.cn
-  23. http://open.comsultia.com/docbook2odf/
-  24. http://www1.chapman.edu/~jipsen/mathml/asciimath.html
-  25. http://www.methods.co.nz/asciidoc/asciimath.html
-  26. file://localhost/tmp/lynxXXXXydLULz/userguide.html#X50
-  27. file://localhost/tmp/lynxXXXXydLULz/userguide.html#X33
-  28. mailto:francis@daoine.org
-  29. file://localhost/tmp/lynxXXXXydLULz/userguide.html#X39
-  30. file://localhost/tmp/lynxXXXXydLULz/source-highlight-filter.html
-  31. mailto:trolocsis@gmail.com
-  32. mailto:srackham@gmail.com
-  33. file://localhost/tmp/lynxXXXXydLULz/userguide.html#X36
-  34. file://localhost/tmp/lynxXXXXydLULz/userguide.html#X33
-  35. mailto:viktor@rbg.informatik.tu-darmstadt.de
-  36. file://localhost/tmp/lynxXXXXydLULz/userguide.html#X23
-  37. mailto:david@dgreaves.com
-  38. mailto:stone@debian.org
-  39. mailto:stone@debian.org
-  40. mailto:srackham@gmail.com
-  41. http://jimmac.musichall.cz/ikony.php3
-  42. mailto:srackham@gmail.com
-  43. http://www.methods.co.nz/asciidoc/examples/website/
-  44. http://www.methods.co.nz/asciidoc/
-  45. https://sourceforge.net/projects/asciidoc/
+   1. http://flask.pocoo.org/docs/
+   2. http://groups.google.com/group/asciidoc/browse_thread/thread/9da9d48a6461ff14
+   3. http://groups.google.com/group/asciidoc/browse_thread/thread/5c792cbb395b753b
+   4. http://groups.google.com/group/asciidoc/browse_thread/thread/e2100b7cb29283ce
+   5. http://groups.google.com/group/asciidoc/browse_thread/thread/c5e30ee5555877f5
+   6. http://groups.google.com/group/asciidoc/browse_thread/thread/baf3218551d05a05
+   7. http://groups.google.com/group/asciidoc/browse_thread/thread/5a7fe64fbfd65ad
+   8. http://groups.google.com/group/asciidoc/browse_thread/thread/5620ba634fdb030a
+   9. http://groups.google.com/group/asciidoc/browse_thread/thread/f969b9ce987d7f5d
+  10. http://groups.google.com/group/asciidoc/browse_thread/thread/cd0f47495fd04181
+  11. http://code.google.com/p/asciidoc/issues/detail?id=6&q=label%3APriority-Medium
+  12. http://sourceforge.net/tracker/?func=detail&atid=373747&aid=2854075&group_id=21935
+  13. http://groups.google.com/group/asciidoc/browse_thread/thread/b24cc3362f35b801
+  14. http://www.methods.co.nz/asciidoc/userguide.html#X96
+  15. http://groups.google.com/group/asciidoc/browse_thread/thread/77f28b0dfe60d262
+  16. http://www.methods.co.nz/asciidoc/manpage.html
+  17. http://groups.google.com/group/asciidoc/browse_thread/thread/40c64cd33ee1905c
+  18. http://groups.google.com/group/asciidoc/browse_thread/thread/e15282f072413940
+  19. http://groups.google.com/group/asciidoc/browse_thread/thread/5ac8e8ea895147e9
+  20. http://groups.google.com/group/asciidoc/browse_thread/thread/e15282f072413940
+  21. http://groups.google.com/group/asciidoc/browse_thread/thread/e15282f072413940
+  22. http://groups.google.com/group/asciidoc/browse_thread/thread/b11066a828ab45b9
+  23. http://groups.google.com/group/asciidoc/browse_thread/thread/a1dd0562dee8b939
+  24. http://groups.google.com/group/asciidoc/browse_thread/thread/f44615dca0b834e9
+  25. http://groups.google.com/group/asciidoc/browse_thread/thread/1b3f88f1f8118ab3
+  26. http://groups.google.com/group/asciidoc/browse_thread/thread/c21c2902c29bae64
+  27. http://groups.google.com/group/asciidoc/browse_thread/thread/f510ea82a88aaee8
+  28. http://groups.google.com/group/asciidoc/browse_thread/thread/42b63ce90c2563b8
+  29. http://groups.google.com/group/asciidoc/browse_thread/thread/42b63ce90c2563b8
+  30. http://bugs.python.org/issue3932
+  31. http://groups.google.com/group/asciidoc/browse_thread/thread/dedc961b23e9ac56
+  32. https://phillordbio-asciidoc-fixes.googlecode.com/hg/
+  33. http://groups.google.com/group/asciidoc/browse_thread/thread/c14a4c3b1e4f6dc5
+  34. http://groups.google.com/group/asciidoc/browse_thread/thread/c948697943432e24
+  35. http://groups.google.com/group/asciidoc/browse_thread/thread/1c415fc4540ce5e5
+  36. http://groups.google.com/group/asciidoc/browse_thread/thread/8712a95e95a292a7
+  37. http://groups.google.com/group/asciidoc/browse_thread/thread/c4427a3902d130a8
+  38. http://groups.google.com/group/asciidoc/browse_thread/thread/59a610068e4acb58
+  39. http://groups.google.com/group/asciidoc/browse_thread/thread/b22603bfb879418c
+  40. http://groups.google.com/group/asciidoc/browse_thread/thread/1c02d27d49221aa2
+  41. http://groups.google.com/group/asciidoc/browse_thread/thread/5f3e825c74ed30c
+  42. http://pygments.org/
+  43. http://groups.google.com/group/asciidoc/browse_thread/thread/d8d042f5a3021369/8934ebbb8cb7144b
+  44. http://groups.google.com/group/asciidoc/browse_frm/thread/319e5cd94493e330/3fcb83fab067af42
+  45. http://groups.google.com/group/asciidoc/browse_frm/thread/fe9b33d8f5f1e0af
+  46. http://groups.google.com/group/asciidoc/browse_frm/thread/8eda3ea812968854
+  47. http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72
+  48. http://groups.google.com/group/asciidoc/browse_frm/thread/66e7b59d12cd2f91
+  49. http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72
+  50. http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72
+  51. http://groups.google.com/group/asciidoc/browse_frm/thread/219c86ae25b79a21
+  52. http://groups.google.com/group/asciidoc/browse_frm/thread/af652507caf6cec9
+  53. http://groups.google.com/group/asciidoc/browse_frm/thread/3f96900f7fbf5620
+  54. http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72
+  55. http://groups.google.com/group/asciidoc/browse_frm/thread/2ff802547b6a75ea
+  56. http://groups.google.com/group/asciidoc/browse_thread/thread/14e8fcb289a135b
+  57. http://groups.google.com/group/asciidoc/browse_thread/thread/faa36e9e5c7da019/d24cab3fe363e58d
+  58. http://groups.google.com/group/asciidoc/browse_frm/thread/ac4b9bfa2116db28
+  59. http://groups.google.com/group/asciidoc/browse_frm/thread/c17abd175778f5ea
+  60. http://groups.google.com/group/asciidoc/browse_frm/thread/c17abd175778f5ea
+  61. http://groups.google.com/group/asciidoc/browse_frm/thread/1b6b66adb24e710
+  62. http://groups.google.com/group/asciidoc/browse_frm/thread/a23fea28394c8ca9
+  63. http://groups.google.com/group/asciidoc/browse_frm/thread/50b28f6941de111a
+  64. http://groups.google.com/group/asciidoc/browse_frm/thread/dfe5204d5b2c9685
+  65. http://groups.google.com/group/asciidoc/browse_frm/thread/f0b6f9989f828c3
+  66. http://groups.google.com/group/asciidoc/browse_frm/thread/14aefc1cb6bd85f5
+  67. http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b7694bbc82a6
+  68. http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b7694bbc82a6
+  69. http://groups.google.com/group/asciidoc/browse_frm/thread/4b0f364b477ec165
+  70. http://groups.google.com/group/asciidoc/browse_frm/thread/e5e61823ff4203cd
+  71. http://groups.google.com/group/asciidoc/browse_frm/thread/2aa3e5711d243045
+  72. http://groups.google.com/group/asciidoc/browse_frm/thread/5215c99dcc865e7d
+  73. http://hg.sharesource.org/asciidoc/diff/55a5999bfd04/xhtml11.conf
+  74. http://groups.google.com/group/asciidoc/browse_frm/thread/b276a927fdc87995
+  75. http://groups.google.com/group/asciidoc/browse_frm/thread/f4df7c9eec01a9bd
+  76. http://groups.google.com/group/asciidoc/browse_frm/thread/f4df7c9eec01a9bd
+  77. http://groups.google.com/group/asciidoc/browse_frm/thread/d29924043e21cb6a
+  78. http://groups.google.com/group/asciidoc/browse_frm/thread/74d9a542b79ccd50
+  79. http://groups.google.com/group/asciidoc/browse_frm/thread/ea3a8ea399ae5d2a
+  80. http://groups.google.com/group/asciidoc/browse_frm/thread/69b3183fdab7c6a5
+  81. http://groups.google.com/group/asciidoc/browse_frm/thread/a254cf949ea7c6c5
+  82. http://groups.google.com/group/asciidoc/browse_frm/thread/e1dcb7ee0efc17b5
+  83. http://groups.google.com/group/asciidoc/browse_frm/thread/69b3183fdab7c6a5
+  84. http://groups.google.com/group/asciidoc/browse_frm/thread/1badad21ff9447ac
+  85. http://groups.google.com/group/asciidoc/browse_frm/thread/a42db6bc54c2c537
+  86. http://groups.google.com/group/asciidoc/browse_frm/thread/b9c63be67dd1d11c
+  87. http://groups.google.com/group/asciidoc/browse_frm/thread/1269dc2feb1a482c
+  88. http://groups.google.com/group/asciidoc/browse_frm/thread/36ff073c79cbc20a
+  89. http://www.methods.co.nz/asciidoc/userguide.html#X89
+  90. http://groups.google.com/group/asciidoc/browse_thread/thread/62278a054188a038
+  91. http://groups.google.com/group/asciidoc/browse_thread/thread/4bdcdfb0af773e2
+  92. http://groups.google.com/group/asciidoc/browse_thread/thread/c93bb4db025225d8
+  93. http://groups.google.com/group/asciidoc/browse_thread/thread/1d796a9c9ddb2855
+  94. http://groups.google.com/group/asciidoc/browse_thread/thread/6d8c716748b109e3
+  95. http://groups.google.com/group/asciidoc/browse_thread/thread/fd27add515597c06
+  96. http://www.methods.co.nz/asciidoc/testasciidoc.html
+  97. http://www.methods.co.nz/asciidoc/asciidocapi.html
+  98. file://localhost/tmp/lynxXXXX9DvHNC/L3892-3814TMP.html#X2
+  99. http://www.methods.co.nz/asciidoc/INSTALL.html
+ 100. http://www.methods.co.nz/asciidoc/newtables.html
+ 101. http://www.methods.co.nz/asciidoc/newlists.html
+ 102. http://www.methods.co.nz/asciidoc/userguide.html#X77
+ 103. http://www.methods.co.nz/asciidoc/userguide.html#X76
+ 104. http://www.methods.co.nz/asciidoc/latexmath.pdf
+ 105. http://www.methods.co.nz/asciidoc/asciimathml.html
+ 106. http://www.methods.co.nz/asciidoc/latexmathml.html
+ 107. http://www.methods.co.nz/asciidoc/source-highlight-filter.html
+ 108. https://sharesource.org/hg/asciidoc/
+ 109. http://en.wikipedia.org/wiki/Data:_URI_scheme
+ 110. http://www.methods.co.nz/asciidoc/faq.html
+ 111. http://www.maths.nottingham.ac.uk/personal/drw/lm.html
+ 112. http://www.methods.co.nz/asciidoc/asciimathml.html
+ 113. http://www.methods.co.nz/asciidoc/index.html
+ 114. http://tpl.sourceforge.net/userguide.html
+ 115. http://www.methods.co.nz/asciidoc/music-filter.html
+ 116. http://lilypond.org/
+ 117. http://abcnotation.org.uk/
+ 118. mailto:srackham@gmail.com
+ 119. mailto:jlm@ofb.net
+ 120. mailto:m_pupil@yahoo.com.cn
+ 121. http://open.comsultia.com/docbook2odf/
+ 122. http://www1.chapman.edu/~jipsen/mathml/asciimath.html
+ 123. http://www.methods.co.nz/asciidoc/asciimath.html
+ 124. file://localhost/tmp/lynxXXXX9DvHNC/userguide.html#X33
+ 125. mailto:francis@daoine.org
+ 126. file://localhost/tmp/lynxXXXX9DvHNC/userguide.html#X39
+ 127. file://localhost/tmp/lynxXXXX9DvHNC/source-highlight-filter.html
+ 128. mailto:trolocsis@gmail.com
+ 129. mailto:srackham@gmail.com
+ 130. file://localhost/tmp/lynxXXXX9DvHNC/userguide.html#X36
+ 131. file://localhost/tmp/lynxXXXX9DvHNC/userguide.html#X33
+ 132. mailto:viktor@rbg.informatik.tu-darmstadt.de
+ 133. file://localhost/tmp/lynxXXXX9DvHNC/userguide.html#X23
+ 134. mailto:david@dgreaves.com
+ 135. mailto:stone@debian.org
+ 136. mailto:stone@debian.org
+ 137. mailto:srackham@gmail.com
+ 138. http://jimmac.musichall.cz/ikony.php3
+ 139. mailto:srackham@gmail.com
+ 140. http://www.methods.co.nz/asciidoc/
+ 141. https://sourceforge.net/projects/asciidoc/