Asciidoc

--------------------------
.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:
http://groups.google.com/group/asciidoc/browse_frm/thread/a23fea28394c8ca9
- 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
http://groups.google.com/group/asciidoc/browse_frm/thread/50b28f6941de111a
- CSS tweaks so that tables processed by DocBook XSL Stylesheets have
the default asciidoc xhtml11 backend styling. See
http://groups.google.com/group/asciidoc/browse_frm/thread/dfe5204d5b2c9685
- Block titles take precedence over section titles to avoid titled
delimited blocks being mistaken for two line section titles (see
http://groups.google.com/group/asciidoc/browse_frm/thread/f0b6f9989f828c3).
- 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
http://groups.google.com/group/asciidoc/browse_frm/thread/14aefc1cb6bd85f5).
- 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
http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b7694bbc82a6
- *FIXED*: Regression issue with inline data-uri images. See
http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b7694bbc82a6
- *FIXED*: An unexpected error occurred when processing a table
containing CSV data if the 'cols' attribute was not explicitly
specified. See
http://groups.google.com/group/asciidoc/browse_frm/thread/4b0f364b477ec165

--------------------------
.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
http://groups.google.com/group/asciidoc/browse_frm/thread/e5e61823ff4203cd
- Added AsciiDoc 'role' attribute to quoted text. Sets 'class'
attribute in HTML outputs; 'role' attribute in DocBook outputs. See:
http://groups.google.com/group/asciidoc/browse_frm/thread/2aa3e5711d243045
- 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.
- Superseded `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
http://groups.google.com/group/asciidoc/browse_frm/thread/5215c99dcc865e7d).
- *FIXED:* An error occurred if a directory in current path with same
name as executable.

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 superseded 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:

. The onload event expression changed.
. The new `<div id="content">...</div>` div envelopes document
content.
. You need to add `<div id="footnotes">...</div>` div to the
`[footnotes]` section for footnotes to work.
. 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:
http://hg.sharesource.org/asciidoc/diff/55a5999bfd04/xhtml11.conf

--------------------------
.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
http://groups.google.com/group/asciidoc/browse_frm/thread/b276a927fdc87995
- Titled listing and literal blocks (DocBook outputs) no longer default
to examples. See
http://groups.google.com/group/asciidoc/browse_frm/thread/f4df7c9eec01a9bd
- 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
http://groups.google.com/group/asciidoc/browse_frm/thread/f4df7c9eec01a9bd
- 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
http://groups.google.com/group/asciidoc/browse_frm/thread/d29924043e21cb6a.
- Added 'max-width' attribute to the 'xhtml11' backend to set maximum
display width. See
http://groups.google.com/group/asciidoc/browse_frm/thread/74d9a542b79ccd50.
- 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
http://groups.google.com/group/asciidoc/browse_frm/thread/ea3a8ea399ae5d2a
and
http://groups.google.com/group/asciidoc/browse_frm/thread/69b3183fdab7c6a5
- 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
(http://groups.google.com/group/asciidoc/browse_frm/thread/a254cf949ea7c6c5).
- 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,
http://groups.google.com/group/asciidoc/browse_frm/thread/e1dcb7ee0efc17b5).
- Normalized path in `safe_filename` function (submitted by Todd
Zullinger,
http://groups.google.com/group/asciidoc/browse_frm/thread/69b3183fdab7c6a5).
- 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
http://groups.google.com/group/asciidoc/browse_frm/thread/1badad21ff9447ac.
- '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:
http://groups.google.com/group/asciidoc/browse_frm/thread/a42db6bc54c2c537.
- 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
http://groups.google.com/group/asciidoc/browse_frm/thread/b9c63be67dd1d11c
- *FIXED:* Only the first occurrence of passthrough macro was
substituted. Patch submitted by Peter Johnson. See
http://groups.google.com/group/asciidoc/browse_frm/thread/1269dc2feb1a482c
- *FIXED:* asciidoc now runs on Jython 2.5.0.
- *FIXED:* Wordpress margins and pads in a number of block
elements
(http://groups.google.com/group/asciidoc/browse_frm/thread/36ff073c79cbc20a).

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 {website}userguide.htmlX89[DocBook table widths].

--------------------------
.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
http://groups.google.com/group/asciidoc/browse_thread/thread/62278a054188a038[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
http://groups.google.com/group/asciidoc/browse_thread/thread/4bdcdfb0af773e2
- 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
http://groups.google.com/group/asciidoc/browse_thread/thread/c93bb4db025225d8
- *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.
\bloggsmail was processed inside
\mailto:joe-bloggsmail-server.com[Mail].
- *FIXED:* User name in FTP URI generated incorrect FTP link. See
http://groups.google.com/group/asciidoc/browse_thread/thread/1d796a9c9ddb2855
- *FIXED:* Source highlighter now works with Wordpress backend (see
http://groups.google.com/group/asciidoc/browse_thread/thread/6d8c716748b109e3).

[[X2]]
Regression issues
~~~~~~~~~~~~~~~~~
. 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.

--------------------------
.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.

--------------------------
.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:
. the configuration file is missing.
. an illegal backend is specified.
. an illegal test number is specified.

.Bug fixes
- Fixed
http://groups.google.com/group/asciidoc/browse_thread/thread/fd27add515597c06[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.