Asciidoc

--------------------------
.Additions and changes
- Support for
http://www1.chapman.edu/~jipsen/mathml/asciimath.html[ASCIIMathML]
has been added. See 'Appendix I: ASCIIMathML Support' in the User
Guide and the examples at
http://asciidoc.org/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 inline attributes to be applied to normal text.
- 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
link:userguide.htmlX33[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 mailto:francisdaoine.org[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.

--------------------------
.Additions and changes
- The `caption` attribute can be used to customize admonition captions
as well as image, table and example block element title prefixes
(`xhtml11` and `html4` backends).
- You can now override the default icon image using the `icon`
attribute to specify the path of the linked image (xhtml11 and html4
backends only).
- The deprecated `imagesdir` attribute is no longer recognized (use
`iconsdir` instead).
- Added 'Appendix H: Using AsciiDoc with non-English Languages' to the
AsciiDoc User Guide.
- Added 'Admonition Icons and Captions' subsection to the User Guide
explaining how to customize Admonition elements.

.Bug fixes
- `a2x(1)` failed when configuration files were installed in the
global `/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
admonition `caption` attribute (previously displayed the `style`
attribute).

--------------------------
.Additions and changes
- `a2x(1)` toolchain wrapper utility. This overcomes the biggest
hurdle for new users which seems to be assembling and using a
working DocBook XML toolchain. With `a2x(1)` you can generate XHTML
(chunked and unchunked), PDF, man page, HTML Help and text file
outputs from an AsciiDoc input file with a single command. All you
need to install (in addition to AsciiDoc) is xsltproc(1), DocBook XSL
Stylesheets and optionally FOP (if you want PDF) or lynx(1) (if you
want text).
- Block titles can now start with any non-space character (previously
where not allowed to start with `.~-_` characters).
- `./stylesheets/docbook.css` renamed to
`./stylesheets/docbook-xsl.css` to clarify its function.
- Renamed `./docbook-xsl/manpages.xsl` to `./docbook-xsl/manpage.xsl`
for consistency.
- Admonition and navigation icons moved to `./images/icons/` to
clarify usage and conform with a2x(1) usage.
- Renamed xhtml11 intrinsic attribute `imagesdir` to `iconsdir` to
keep vocab consistent and changed default value to `./images/icons`
(previously `./images`). `imagesdir` attribute still accepted but
deprecated.
- Unused image files have been weeded out of the distribution.
- 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{nbsp}iconsdir="your_icons_path"` option in
your asciidoc commands.

.Bug fixes
- Backslash line continuation is now observed in verbatim paragraphs.
- Fixed errors generated by example
`./examples/website/build-website.sh` script.

--------------------------
.Additions and changes
- Added ternary conditional attributes
`{<name><regexp>:<value1>[:<value2>]}` and
`{<name>$<regexp>:<value1>[:<value2>]}`.
- Safety violations now generate errors (they previously generated
warnings).
- asciidoc(1) now defaults to safe mode, consequently the
`[miscellaneous]` safe mode entry and `--safe` command-line option
are no longer necessary (though for backward compatibility
asciidoc(1) 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
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
against unsafe input files not unsafe configuration). As with all
filters, before installing, you should verify that they can't be
coerced into generating malicious output or exposing sensitive
information.

.Bug fixes
- Fixed a lot of glaring grammatical and factual errors in the User
Guide.

--------------------------
.Additions and changes
- 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
link:userguide.htmlX39[Appendix C in the AsciiDoc User Guide]).
- Included link:source-highlight-filter.html[source-highlight filter]
in the distribution `./examples/source-highlight-filter/` directory
(based on filter submitted by mailto:trolocsisgmail.com[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/`
directory).
- AsciiDoc DocBook XSL Stylesheet drivers moved from `./doc/` to
`./docbook-xsl/`.
- Modified `./doc/manpages.xsl` so only URL content is displayed in
manpages.

.Bug fixes
- Explicitly set table CSS border style (`xhtml11` backend) to `solid`
because default border styles vary from browser to browser.

--------------------------
.Additions and changes
- There are now long versions of all AsciiDoc options.
- If the `--backend` is not specified it defaults to `xhtml11`.
- Added CSS simulated frames layout to the examples website (see
`./examples/website/layout2/README-website.txt`). This layout does
not work with IE6 and the original tables based layout is still the
default.
- Support page added to AsciiDoc website.

.Bug fixes
- Invalid options are now trapped gracefully.
- Documentation errata.