Asciidoc

--------------------------
.Additions and changes
- Replaced the `install.sh` script with Ben Walton's updated autoconf
scripts -- see {website}INSTALL.html[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).
- Listing delimited blocks in DocBook outputs now support IDs; IDs of
titled Listing and Literal delimited blocks have been moved to the
enclosing DocBook example tag (thanks to Vijay Kumar for this
patch).
- Replaced vertical typewriter apostrophe with punctuation apostrophe
(thanks to Noah Slater).

.Bug fixes
- Regression: Excluding double-quotes from unquoted attribute values
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.

to the previous 8.2.7 release:

- The old table syntax is still processed but a 'DEPRECATED' warning
is 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 list 'compact' style has been dropped and is now a list option
(use `options="compact"` in attribute lists).
- AsciiDoc version 6 syntax no longer supported.
- Linuxdoc been removed from the distribution.
- The unsupported experimental 'latex' backend has not been tested on
this release.
- The introduction of single-quote quoting requires that double-quote
quoting is escaped with two backslashes.

--------------------------
.Additions and changes
- Added `dvi`, `ps` and `tex` output format options to a2x(1).
- Added `--dblatex` option to a2x(1) so `dblatex(1)` can be used to
generate PDFs.
- Added custom `dblatex(1)` configuration files (in distribution
`./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
'http', 'https', 'ftp', 'file' URLs and email addresses without any
special 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
http://asciidoc.org/source-highlight-filter.html[the
online docs]).
- 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
'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 '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 -- 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'
macro. They apply to DocBook outputs (specifically for PDF
documents). 'scaledwidth' sets the image size as a percent of the
available page width; 'align' applies 'left', 'center' or 'right'
horizontal image justification.
- 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
(previously had to use FOP 0.20.5).
- The User Guide has been updated and outdated FOP configuration and
installation sections removed.

.Bug fixes
- Fixed `stylesheets/xhtml11-manpage.css` not being included when
'linkcss' attribute was used.
- Configuration file `*-style` attributes are now dumped correctly.
- Fixed 'FAILED: malformed section entry' LaTeX backend error.

See the also the https://sharesource.org/hg/asciidoc/[AsciiDoc
repository changelog].

--------------------------
.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
http://en.wikipedia.org/wiki/Data:_URI_scheme[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
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
VMiklos.
- 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:
* Replaced `realpath()` with Python 2.2 `os.path.realpath()` library
function.
* Replaced old string library functions with string methods.
* Use file generators instead of `readlines()`.
* Renamed entities that shadowed builtins.
* Standardized string quoting.
* Dropped `readlines()` function.

.Bug fixes
- Fixed broken CSS for decimal ordered lists nested in alpha ordered
list, thanks to Alex Efros.
- 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.
- 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.

--------------------------
.Additions and changes

.Bug fixes
- Fixed exception thrown by illegal command-line arguments.
- Rolled back the 'with' warning bug fix introduced in 8.2.4 -- it was
incompatible with Python <2.5.

--------------------------
.Additions and changes
- You can now use the `lang` attribute to set the DocBook language
attribute.
- Attribute values can now contain attribute references.
- If the `lang` attribute is defined then configuration files named
like `lang-<lang>.conf` will be loaded automatically.
- The help file name `help-<lang>.conf` is based on the AsciiDoc
`lang` attribute, defaults to `help.conf` (English).
- Admonition, figure and table captions have been factored into a
predefined set of `caption_*` attributes. They only apply to
directly generated (X)HTML outputs (DocBook stylesheets generate
their own language specific captions based on the `lang` attribute).
- Dropped platform dependent `doc/asciidoc.chm` file from
distribution documentation formats.

.Bug fixes
- The spurious warning 'with will become a reserved keyword
in Python 2.6' has been suppressed.