AsciiDoc ChangeLog
==================

Version 8.2.7 (2008-07-04)
--------------------------
See the http://hg.sharesource.org/asciidoc/shortlog[AsciiDoc Mercurial
repository] for a full list of changes.

.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) which 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://www.methods.co.nz/asciidoc/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].


Version 8.2.6 (2008-04-29)
--------------------------
See the http://hg.sharesource.org/asciidoc/shortlog[AsciiDoc Mercurial
repository] for a full list of changes.

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


Version 8.2.5 (2007-11-18)
--------------------------
.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.


Version 8.2.4 (2007-11-10)
--------------------------
.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.


Version 8.2.3 (2007-09-12)
--------------------------
.Additions and changes
- Added VMiklos's 'permalink' patch for auto-generated section IDs
  (enabled by default by the `sectids` attribute).
- Added http://www.methods.co.nz/asciidoc/faq.html[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.
- XHTML level 2 section headings are now styled with an underlining
  border.
- XHTML links to AsciiDoc title elements are now implemented with
  title ID attributes (previously separate `<a>` element targets were
  generated.
- Multi-word first, middle and last names can be entered in the header
  author line using the underscore as a word separator.
- The nested inline macros restriction has now been lifted, for
  example you can now include links and inline images inside
  footnotes.
- Help topic names can be shortened (so long as they are not
  ambiguous). For example `asciidoc -hm` will print the AsciiDoc man
  page.
- Added `\{two_colons}` and `\{two_semicolons}` attributes for
  escaping labeled list ambiguity.
- If quirks mode is disabled the XHTML Mime Type is set to the
  recommended `application/xhtml+xml` (rather than `text/html`).

.Bug fixes
- Author information is now correctly set when using attribute entries
  in the header instead of an author line (previously the 'author'
  attribute was not being calculated correctly and there were
  attribute substitution problems).


Version 8.2.2 (2007-07-22)
--------------------------
.Additions and changes
- http://www.maths.nottingham.ac.uk/personal/drw/lm.html[LaTeXMathML]
  capability has been added for users who are more familiar with or
  prefer LaTeX math formulas to the
  http://www.methods.co.nz/asciidoc/asciimath.html[ASCIIMathML]
  notation (thanks to Arthur Sakellariou for the patch).
- The 'source highlight' and 'code' filters now process embedded
  callouts.
- Added an `--attribute=ATTRIBUTE` option to `a2x(1)` for passing
  attribute values to asciidoc(1) (a shortcut for `--asciidoc-opts="-a
  ATTRIBUTE"`).
- Image block and inline macros prepend optional `\{imagesdir}`
  attribute to image link targets.


.Bug fixes
- Fixed an assertion error that occurred when a configuration 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.
- Asciidoc titles are only converted to lower case if all characters
  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
  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.
- 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.


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

.Bug fixes


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
  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 User Guide' for details.
- Added 'toclevel' attribute (1..4) which sets the number of title
  levels reported in the table of contents.  Defaults to 2 and must be
  used with the 'toc' attribute. Example usage:

  $ asciidoc -a toc -a toclevels=3 doc/asciidoc.txt

- 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
  syntax matches the title line syntax of a number of popular Wiki
  markups.
- If a QuoteBlock has no attribution or citetitle then the DocBook
  `<attribution>` element is not generated (previously generated empty
  `<attribution>` element).
- If the text of a labeled list item is blank then no `texttag` is
  written.
- An end of line backslash performs line continuation for horizontal
  labeled list items.
- The Revision line now accommodates Subversion `$Id` markers (in
  addition to CVS and RCS markers). Thanks to Tiago Sturmer Daitx for
  this patch.
- Implemented `a2x(1)` option `--skip-asciidoc` which allows `a2x(1)`
  to convert DocBook XML files not derived from AsciiDoc sources.
- 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
  http://www.methods.co.nz/asciidoc/index.html[AsciiDoc home page].

.Bug fixes


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
  http://tpl.sourceforge.net/userguide.html[tpl User Guide] for a
  fancier layout. Use the `-a toc -a numbered` command-line options to
  produce a number table of contents.
- A http://www.methods.co.nz/asciidoc/music-filter.html[music filter]
  is included in the distribution `./filters/` directory.  It
  translates music in http://lilypond.org/[LilyPond] or
  http://abcnotation.org.uk/[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
  delimiters the following convention has been adopted: delimiters
  belonging to DelimitedBlock filters distributed with AsciiDoc will
  consist of a word (normally a noun identifying the block content)
  followed by four or more tilde characters.  This has necessitated
  changing existing filter delimiters (the old delimiters still work
  but may be deprecated in future versions):

  * The example code filter block delimiter is now the word `code`
    followed by four or more tilde characters.
  * The source highlight filter block delimiter is now the word
    `source` followed by four or more tilde characters.

- Conditionally redefined subscript and superscripting so they use the
  old replacements mechanism when asciidoc7compatible is defined
  rather than the asciidoc 8 default unconstrained quoting (patch for
  affected files attached).
- Moved the source highlight filter from `./examples/` to `./filter/`.
- 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).
- If `asciidoc(1)` outputs to stdout then intrinsic attribute
  `\{docname}` is extracted from the input file name.


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 and 'Appendix A: Migration Notes' in the AsciiDoc User Guide).

Please report any problems you encounter.

mailto:srackham@gmail.com['Stuart Rackham']
*********************************************************************

.Additions and changes
- Quoting can can occur within words (based on patch submitted by
  Benjamin Klum). See the 'Unconstrained Quotes' sub-section in the
  User Guide.

- The underline and plus characters can be used as alternatives to the
  existing apostrophe and backtick quote characters. They are 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:
  * Bracketing is consistent other with `[[...]]` and `<<...>>`
    reference macros.
  * To easily confused with triple plus passthroughs.
  * To make way for the new monospace quoting.

- Superscripts and subscripts are implemented as constrained quotes so
  they can now be escaped with a leading backslash and prefixed with
  with an attribute list.

- An experimental LaTeX backend has been written by Benjamin Klum (a
  number additions in this release are to accommodate the LaTeX
  backend).
- `include` macro file names now expand environment variables and
  tilde expansions.
- A configuration file `[quotes]` entry can be undefined by setting to
  a blank value.
- Added `callto` inline macro for Skype 'callto' links.
- Added `colnumber` attribute for table data markup.
- A leading comment block or comment lines are now skipped (previously
  a document had to start with either attribute entries or a document
  Title).
- 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 mailto:jlm@ofb.net[Jacob
  Mandelson] for installing the tarball distribution.
- Added INSTALL documentation file.
- 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
  `[miscellaneous]` section.
- By default `AttributeEntry` values are substituted for
  `specialcharacters` and `attributes`, if you want a different
  AttributeEntry substitution set the `attributeentry-subs` attribute.
- The `name` in `name=value` configuration file entries can now end
  with 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
escaped the `=` character.

- A blank configuration file section deletes any preceding section
  with the same name (applies to non-markup template sections).
- A command-line attribute value with a `@` suffix does not override
  existing document and configuration file attributes (normally
  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
  mailto:m_pupil@yahoo.com.cn[FKtPp] -- here's his description of the
  problem:
+
``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
  http://open.comsultia.com/docbook2odf/[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 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 has also changed: copying and use of icons is
  disabled by default. Rationale:
  * To make the default behavior more consistent since use of icons
    and CSS stylesheets does not apply to all formats.
  * To make the default behavior less surprising (the creation of icon
    and stylesheet output files must now be explicit).

- a2x(1) has been bumped from version 0.1.1 to version 1.0.0.


.Bug fixes
- Removed duplicate `./doc/a2x.1.txt` from distribution tarball.
- Documentation errata.
- Attribute replacement is no longer performed twice in Titles and
  AttributeEntrys.
- a2x(1) skipped asciidoc(1) execution when rerun with different
  `\--asciidoc-options` options, it now always executes asciidoc(1).
  The problem was that previously asciidoc(1) was executed only if the
  output file was missing or older than the source file.


Version 7.1.2 (2006-03-07)
--------------------------
.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://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 inline attributes to be applied to normal text.
- An link:userguide.html#X50[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.html#X33[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:francis@daoine.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.


Version 7.1.1 (2006-02-24)
--------------------------
.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).


Version 7.1.0 (2006-01-13)
--------------------------
.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.


Version 7.0.4 (2005-12-08)
--------------------------
.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.


Version 7.0.3 (2005-12-01)
--------------------------
.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.html#X39[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:trolocsis@gmail.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.


Version 7.0.2 (2005-08-28)
--------------------------
.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.


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).
- 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
  less language specific and displays most common languages.
- `\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).
- Refactored `xhtml11.conf` configuration file.
- Set consistent and sensible permissions on distributed files.
- White space is now stripped from DSV formatted table cell data.
- `class="tableblock"` attribute added to tables generated by
  `xhtml-deprecated-css.conf` to assist CSS.

.Bug fixes
- Illegal character set encoder (specified by the AsciiDoc `encoding`
  attribute) and character data are trapped gracefully.
- 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.


Version 7.0.0 (2005-06-06)
--------------------------
***************************************************
This is a major release with many code and
documentation changes.
Please report any problems you encounter.

mailto:srackham@gmail.com['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
  link:userguide.html#X36[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 link:userguide.html#X33[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
  mailto:viktor@rbg.informatik.tu-darmstadt.de[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.
- Added `template` system block macro to allow the inclusion of one
  configuration file template section within another.
- A 'verse' style attribute can now be applied to literal paragraphs
  and blocks to reproduce line breaks and white space from the source
  document.
- Replacements and Special Words can now be escaped with leading
  backslashes.
- Replacements are now processed in configuration file order (previous
  ordering was indeterminate).
- System macros can now be used in the base `asciidoc.conf`
  configuration file.
- Deprecated features that emitted warnings in prior versions are no
  longer tolerated.
- The `eval` system attribute expression evaluates to `False` the
  attribute is undefined, if it evaluates to `True` the result is an
  empty string.
- The Paragraph and DelimitedBlock 'presubs' parameter can be aliased
  as 'subs'.
- Added 'verbatim' substitutions option.
- Renamed 'List Continuation Block' to 'List Block' and renamed the
  'listcontinuation' option to 'list'.
- Deprecated 'default' substitutions option (use 'normal' instead).
- The 'section-numbers' section numbering attribute has be renamed
  'numbered'.
- Dropped the '\#UNDER CONSTRUCTION#' block macro.
- Rewrote Paragraph and DelimitedBlock handlers adding a
  link:userguide.html#X23[styles] configuration entry.

.Bug fixes
- Included files are no longer read inside conditionally excluded
  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
  mailto:david@dgreaves.com[David Greaves].
- Unexpected error following malformed author line error.


Version 6.0.3 (2005-04-20)
--------------------------
.Additions and changes
- Special characters are now substituted in AttributeEntry element
  values.
- Spaced and unspaced em dashes are now recognized (previously only
  spaced em dashes were recognized).
- Replaced the table 'noborders' option with richer 'frame' and 'grid'
  attributes.
- The `duplicate macro` warning message now only occurs when the
  verbose (`-v`) option is enabled.
- 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
  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.
- Dropped deprecated `<u>` tags from generated HTML.
- Literal Block delimiters must now consist of at least four points
  (previously three) to avoid lone ellipsis ambiguity.

.Bug fixes
- Some system attribute evaluation failures caused unexpected
  exceptions to occur.


Version 6.0.2 (2005-03-30)
--------------------------
.Additions and changes
- 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' attributes which have been renamed 'system' attributes:
  * To reflect their common (though contextually different) behavior.
  * To avoid confusion with 'intrinsic attributes'.

.Bug fixes
- Asciidoc now searches in `/etc/asciidoc/filters` for filters.


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
  mailto:stone@debian.org[Fredrik Steen]).
- Recoded `tempfile.mktemp()` and other artifacts that are no longer
  necessary or desirable (patches supplied by
  mailto:stone@debian.org[Fredrik Steen]).
- Added BUGS file to the distribution.

.Bug fixes
- Illegal comment syntax in `css-embedded-stylesheet.conf` resulted in
  illegal CSS in files generated by the `css-embedded` backend.


Version 6.0.0 (2005-01-28)
--------------------------
***************************************************
This release has had some fairly major code and
documentation changes. Please report any problems
you encounter.

mailto:srackham@gmail.com['Stuart Rackham']
***************************************************

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 unified notion of document attributes. Attempted to introduce a
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 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.

.Additions and changes
- 'Glossary entries' have been renamed 'attributes'. This eliminates
  confusion with the accepted meaning of glossary.
- An `AttributeEntry` block element has been added so that document
  attributes can be assigned from within an AsciiDoc document.
- The `AttributeList` block element has been added which is a more
  general solution than the (now deprecated) DelimitedBlock arguments.
- An BlockId element has been added for setting block element anchor
  (link target) IDs.
- 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''.
- A warning is now emitted for out of order list item (applies to
  explicitly enumerated numbered list items).
- Added `include` action attribute.
- A line of three or more apostrophes generates an HTML horizontal
  ruler (`<hr/>` tag). You will get a warning if processed with
  non-HTML backend.
- An `\{imagesdir}` attribute specifies image file location for images
  referenced in configuration files when generating HTML (the default
  location is `images`).
- An `\{stylesdir}` attribute specifies the location of CSS
  stylesheets when generating styled HTML (the default location for
  configured markup is `.`).
- 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
  DocBook revision history file.
- To better reflect their purpose the following block elements have
  been renamed: `VerbatimBlock` to `ListingBlock`; `IndentedBlock` to
  `LiteralBlock`; `IndentedParagraph` to `LiteralParagraph`;
  `CustomBlock` to `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
  (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
  (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
  bibliography list entries.
- An optional 'single-line titles' syntax can be used.
- Tweaks to distributed CSS stylesheets and FOP `fo.xsl` customization
  file.
- 'List Item Continuation' has been implemented which allows
  additional block elements to be included in list items by separating
  them from 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
  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.

.Bug fixes
- Fixed broken backslash line continuation.
- Labeled list end tags were not undergoing attribute substitution.
- Documents without any author information now generate legitimate
  DocBook (previously if the author line was not included in the
  document header then an empty (illegal) DocBook `author` element was
  generated).
- Multiple spaces in filter command arguments were replaced by a
  single space. The `./examples/asciidoc2text/asciidoc2text.sh` script
  now indents text correctly.


Version 5.1.1 (2004-10-10)
--------------------------
*15-December-2004: Interim update:* Updated `asciidoc.py` to fix
broken `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 the
  last 12 months and produces very acceptable PDF under both Linux and
  Windows.
- Sections detailing how to install and use the DocBook XSL
  Stylesheets, xsltproc, FOP toolchain and the AsciiDoc XSLT drivers
  have been added to the User Guide.
- The PDF output from the he example article template has been
  included in the distribution (`./doc/article.pdf`).
- 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 (R) to `[replacements]`.
- CSS stylesheet tweaks.
- Admonitions (Note, Tip, Important, Warning, Caution) include icons
  when generating css output.


Version 5.1.0 (2004-09-18)
--------------------------
- Callouts have been implemented (see the 'Callouts' section of the
  AsciiDoc User Guide for details).
- Added XSL drivers for generating XHTML, chunked XHTML and HTML Help
  from DocBook XML using XSL stylesheets and xsltproc(1).
- 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.
- 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.
- The usual documentation and examples additions, updates and
  polishing.


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.
- 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>++`.
- 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 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
  variable lists can be nested to two levels.
- Footnotes now appear on a separate line in HTML and Linuxdoc
  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 when
  outputting HTML.
- Empty section warnings have been replaced by error messages and are
  emitted only if invalid markup would result.
- Missing macro sections or invalid macro name warnings are only
  generated at startup if the `-v` (verbose) option is set. Otherwise
  they are deferred until a matching macro is encountered in the input
  file.
- Missing or invalid table definition warnings are only generated at
  startup if the `-v` (verbose) option is set. Otherwise they are
  deferred until a matching table is encountered in the input file.
- AsciiDoc now makes more of an effort to continue in the face of
  errors.
- Fixed broken `./examples/website/main.aap` script.
- Converted distribution text files DOS text format as a sop to
  Windows users with challenged text editors.
- Documentation additions and corrections.


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
  Appendix sub-sections since they are (correctly) out of sequence.
- A warning is no longer emitted for empty Index sections since this
  is normal when generating DocBook outputs.
- Fixed: `[quotes]` configuration file entries where not being
  overridden by downstream configuration file entries.
- Footnote text is now output enclosed in square brackets in HTML
  documents.
- Added superscripts and subscripts to the standard PRS configuration
  files.
- 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.


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
  README has been corrected.
- Documented techniques for combining and splitting AsciiDoc documents
  and processing the combined and split parts (see the 'Tips and
  Tricks' section of the User Guide).
- An example of marking up superscripts and subscripts is documented
  in the 'Tips and Tricks' section of the User Guide (the example
  configuration file is in the AsciiDoc `examples` directory).
- Added ellipsis to shipped `[replacements]`; three periods output an
  ellipsis entity.
- Removed unused 'SectionClose' class.
- The AsciiDoc 'Preamble' element is output as a DocBook 'Preface'
  when processed as a 'book' document type (in older AsciiDoc versions
  a warning was issued and processing stopped).
- Fixed a quoting anomaly: quoted text can no longer begin or end with
  with white space.


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
  the existing 'graphic' block macro and 'icon' inline macro.
- Macro substitution section names now have `-inlinemacro` and
  `-blockmacro` suffixes to resolve context ambiguity, make their
  purpose clearer and relieve section namespace congestion.
- Header derived glossary entries can now be overridden from the
  command-line.
- Special character substitution is now performed on AuthorLine
  derived author names.
- A macro or block argument called 'options' can be used as a shortcut
  for a list named arguments with zero length string values.
- Tables can be output without borders using the `options="noborders"`
  argument.
- Table data lines that do not immediately follow a table section
  underline can now be blank. This allows CSV data with embedded blank
  lines to be processed correctly.
- Blank DSV format table data lines are silently skipped.
- Tightened up on enforcement of configuration file section names to
  reduce the possibility of section content being seen as a section
  header line.
- 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 `&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
  `{amp}\#35;NEW{amp}#35;`.
- `{amp}\#35;NEW{amp}#35;` and `\#UNDER-CONSTRUCTION#` macros are now
  included in the DocBook backend.
- Replaced shipped `smallnew.gif` with `smallnew.png`.
- Documentation tidy ups.


Version 5.0.5 (2004-02-25)
--------------------------
- Fixed the disappearing paragraph titles problem that was caused by
  Inline macros (incorrectly) processing BlockTitles.
- Tightened AuthorLine validation.  Previously invalid email addresses
  and embedded special characters in the AuthorLine resulted in
  invalid output markup.


Version 5.0.4 (2004-02-09)
--------------------------
- Reinstated missing `infile`, `outfile`, `filetype` and
  `filetype-<filetype>` glossary entries.
- As of version 5.0.3 asciidoc(1) now requires Python 2.0 or greater,
  this has now been documented.


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.
- All `[miscellaneous]` configuration file entries can now be
  referenced like glossary entries (they are now processed internally
  as glossary entries).
- The output file line terminator (previously hardwired to `\r\n` is
  now set using the `newline` entry in the configuration file
  `[miscellaneous]` section.
- The misspelt `blocktitles` configuration file entry name has been
  corrected (to `blocktitle`).
- An `\{empty}` glossary entry has been added to the default
  configuration which is useful for outputting trailing blank lines
  from configuration file substitution sections.


Version 5.0.2 (2003-12-18)
--------------------------
- New (alternative) 'anchor' and 'xref' macro syntax (old syntax still
  valid).
- DocBook `mediaobject` and `inlinemediaobject` tags are generated in
  place of `graphic` and `inlinegraphic` tags by the AsciiDoc
  `graphic` and `icon` macros. If a macro argument is specified it is
  the alternative text output if the target document format does not
  support the specified graphic file format.
- Dropped the LinuxDoc left and right square bracket special character
  substitutions as they interfered with macro substitution.
- Documentation updates and corrections.


Version 5.0.1 (2003-12-09)
--------------------------
- Fixed problem with anchor tag when generating CSS styled HTML.


Version 5.0 (2003-12-08)
------------------------
***************************************************
This release has had some fairly major code and
documentation changes. Please report any problems
you encounter.

mailto:srackham@gmail.com['Stuart Rackham']
***************************************************

- AsciiDoc can now produce a full-blown multi-part DocBook book
  including dedication, abstract, preface, colophon, glossary,
  appendix, bibliography and book part elements using the new
  `specialsections` configuration file section.
- All Section element children (Paragraph, DelimitedBlock, List,
  Table, BlockMacro) can now be titled using the BlockTitle element.
  A BlockTitle element is a single line containing a title and
  beginning with a period.
- The `index` and `backmatter` macros have been dropped, superseded by
  `specialsections`.
- The AsciiDoc 'Preface' element has been renamed 'Preamble' (to avoid
  confusion with the DocBook book preface element).
- Out of sequence titles are now tolerated with a warning. This allows
  book document level 0 sections to be processed.
- An 'anchor' inline macro has been added for document link target
  creation.
- 'Note', 'Tip', 'Important' and 'Warning' paragraph types have been
  added to support the corresponding DocBook elements.
- Title substitution is now performed in SidebarBlock titles.
- DocBook graphics now output as `figure` and `informalfigure`
  elements rather than `mediaobjects`. This ensures numbered figures
  and a lists of figures are produced by the DocBook toolchain.
- You can now escape block argument lines by appending a backslash.
  Alternatively, if you embed arguments in the delimiter line AsciiDoc
  does not check for an arguments line.
- The default DocBook backend file extension has been changed from
  `.docbook` to `.xml` (`.sgml` for the 'docbook-sgml' backend).
- Warnings are output by default (previously they only printed when
  verbose option enabled).
- A Question and Answer variable list definition has been added to the
  shipped configuration files, primarily to create DocBook `qanda`
  DocBook elements.
- Fixed broken code-filter `-b linuxdoc` option. The asciidoc.asc User
  Guide can now be processed by linuxdoc(1) (although tables are
  dropped because LinuxDoc does not implement tables).

.Compatibility issues:
1. Table titles are no longer in the arguments line, use the new
   BlockTitles.
2. Graphic titles are no longer in the 'graphic' block macro caption,
   use the new BlockTitles.
3. The code-filter title must be placed in a preceding BlockTitle.
4. SidebarBlock titles must be placed in a preceding BlockTitle.
5. The DelimitedBlock option 'sidebar' has been renamed to 'section'.
6. The default DocBook backend file extension has been changed from
`.docbook` to `.xml` (`.sgml` for the 'docbook-sgml' backend).


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.
- The default DocBook output is now DocBook XML. To output the former
  DocBook SGML specify the `docbook-sgml` backend. The associated
  `docbook-sgml.conf` file illustrates how to support minor DTD
  variations. Examples of using the `xmlto(1)` command for DocBook
  conversion have been added to the User Guide.
- Glossary entries set using the command-line -g option can now be
  referenced in configuration files.
- Configuration dumps (`-c` command-line option) no longer output
  redundant undefined glossary entries.
- DelimitedBlock arguments can now be specified in a separate arguments
  line immediately following the leading delimiter line, 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.
- A new QuoteBlock DelimitedBlock definition has been added to the
  distribution configuration files.
- The table arguments lines can be continued using the backslash line
  continuation character.
- Added new calculated glossary reference type `\{<name>%<value>}`.
- Double-quote characters can now appear in unquoted positional
  arguments.


Version 4.1 (2003-11-13)
------------------------
- Added DSV (Delimiter Separated Values) tables format.
- `\{eval:<expr>}` glossary references drop the containing line if
  `<expr>` evaluates to `None`.
- Block, Table and Macro arguments can now be positional (quoted or
  unquoted).
- Vocabulary change: DelimitedBlock, Table and Macro 'attributes' are
  now referred to as 'arguments'. This makes more sense in light of the
  extended syntax and avoids confusion with backend markup tag
  attributes.
- 'tablewidth' table ruler parameter can now be expressed in percent
  units (0..100). If between 0 and 1 then the original fractional unit
  measure is applied.
- The use of quoting for generating footnotes and index entries has
  been dropped in favor of 'footnote' and 'indexterm' inline macros.
- 'backmatter' inline macro included in distribution.
- 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 \{x] was defined and `\{y}` was not.


Version 4.0 (2003-11-08)
------------------------
***************************************************
This release has had some fairly major code and
documentation changes. Please report any problems
you encounter.

'Stuart Rackham'
***************************************************

- Added tables to AsciiDoc.
- Added two special 'subs' options: 'default' specifies the default
  substitution options and 'none' specifies no substitution.  These
  options can only appear singly.
- Line continuation using a trailing backslash character is available
  in Paragraphs, ListItems, Tables.
- The left and right quotes for quoted text can now be specified
  separately.
- Shipped configuration files implement footnotes (only useful for
  DocBook output) using \[[]] quoting.
- Shipped configuration files implement index terms (only useful for
  DocBook and LinuxDoc output) using \(()) quoting.
- The shipped 'html' backend configuration now emits valid 'HTML 4.01
  Transitional'.
- Added new calculated glossary reference types `\{<name>!<value>}`
  and `\{<name>#<value>}`.
- The DelimitedBlock 'params' option has been dropped in favor of the
  new 'block attributes' mechanism. If you have customized block
  params options you may need to adjust source files to use the
  'block attributes' syntax. The example code filter has been updated
  to reflect these changes.
- The code filter now has a `-t tabsize` option.
- Replaced `-w` option with `-v` (verbose) option. The warnings option
  was just to confusing.
- Named attributes can now be specified in macro calls.
- The 'tabsize' attribute is recognized in the built-in `include`
  macros. A tabsize of zero suppresses tab expansion.
- The configuration file `[options]` section has been split into
  `[miscellaneous]` and `[titles]`. If you have customized any of
  these settings you will need to adjust the affected configuration
  files.
- Configuration file `[miscellaneous]` entries can now also be set
  using the command-line `-g` option.
- Fixed: error that occurred when attempting to use zero length
  configuration and source files.
- Fixed: blocking filter halt problem.
- Fixed: inline macro escape prefix problem.
- Fixed: missing macros from configuration dump problem.
- Fixed: named macros were dumped incorrectly.
- Many documentation changes/additions/corrections.


Version 3.2.2 (2003-10-26)
--------------------------
- Added `-n` option (synonym for `-g section-numbers`).
- Dropped the processing commentary (hey, this is Unix).
- Added new calculated glossary reference type `\{<name>?<value>}`.
  `<name>` is the glossary entry name and `<value>` is the text
  substituted if the glossary entry is defined. `<value>` can only
  contain literal text (no glossary references allowed).
- Added `asciidoc2text` to distribution `examples/asciidoc2text`
  directory (converts AsciiDoc source to text file with section
  numbering).
- Fixed incorrect nesting of Simple lists inside Variable lists.
- List definitions have been modified so that list items can be
  indented. This allows a more intuitive indentation of nested lists
  in AsciiDoc source.
- Lists must be separated from preceding paragraphs by a blank line.
  This is to avoid paragraph lines being mistaken for list items.
- Corrected asciidoc man page documentation error: the`-f` option does
  *not* search relative to source document directory for the
  configuration file.
- Minor updates to various distribution `.conf` files.
- Included `badges.conf` in `examples` directory.
- `css-embedded-stylesheet.conf` now supports footer badges.
- The default in-line element processing order has been changed:
  Glossary References are now processed before Inline Macros. This
  allows glossary expansions to occur inside macro references.
- Glossary entries are now allowed in Author and Revision lines.
- Default List `subs` options and Paragraph `presubs` options are
  assigned the following default value if not specified:

  specialcharacters,quotes,specialwords,replacements,glossary,macros

- Documentation changes/additions/corrections.


Version 3.2 (2003-05-26)
------------------------
- Added a `-s` command-line option to suppress the output of
  `[header]` and `[footer]` sections.
- Article document headers are no longer mandatory: this allows
  AsciiDoc to process arbitrary chunks of text. When used in
  conjunction with the new `-s` command-line option corresponding
  chunks of backend markup can be generated.
- AsciiDoc now emits a warning message and continues when an out of
  sequence section title is detected (previously it failed and
  halted). This allows document sections to be processed separately.
- Optional 'presubs' and 'postsubs' entries have been added to
  'DelimitedBlock' and 'Paragraph' definitions. As a consequence
  substitution options are no longer legal in 'options' entries.
- 'presubs' and 'postsubs' substitutions are processed in the order
  the options are specified (rather than the fixed 'options' order of
  previous versions).
- ./filters subdirectories are automatically searched for filter
  commands.
- A 'title-subs' configuration option specifies the substitutions
  performed on document Header and Section titles.
- A 'subs' entry in now included in List configuration file
  definitions that specified substitutions performed on list entry
  text.
- Configuration files are auto-loaded from ./filters subdirectories.
- Added example code filter (see ./examples/filters).
- Bug fix: if section was empty you may have got erroneous 'missing
  tag "paragraph"' error.
- Internal code tidy up.


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
  entry (to bring it in line with the behavior of other special
  sections).
- Paragraphs have now been generalized (in the same way as Lists and
  DelimitedBlocks).
- The 'indentsize' option has been dropped as as consequence of
  paragraph generalization.
- Pipe | characters can be included in substituted tag and
  substitution section text using the \{brvbar} (broken vertical bar)
  glossary reference.
- Removed the restriction requiring substitution section text
  placeholders | to be on a separate line.
- Added an `-e` asciidoc(1) command option that excludes implicit
  configuration files (used in conjunction with `-c` generated
  configuration files).
- Version 3.0 documentation has undergone a considerable cleanup.
- The dumping of quoted section entries (see `-c` option) now works
  correctly.
- The format of special section entries has been made consistent:
  `name` undefines the entry; `name=` sets the entry value to a blank
  string; `name=value` sets the entry value to `value`.
- As a consequence of the previous change the caret prefix is no
  longer used in glossary configuration file entries (although it is
  still used when undefining an entry using the `-g` command-line
  option).


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.

- Added `-c` command-line option to dump a composite asciidoc(1)
  configuration file to stdout.
- Lists and Delimited Blocks are now defined by a set of configuration
  file parameter sections.  The user can modify the default
  definitions or add new ones.
- Block content can now be processed through external filters.
- The default behavior for Custom Blocks is to perform glossary
  substitution (previously there was no substitution inside Custom
  Blocks).
- The old 2.x style macros have been reimplemented; as with Lists and
  Delimited Blocks there syntax and behavior can be configured by the
  user. The default macro syntax remains the same but the semantics
  are now (hopefully) a bit more intelligible.
- Block and Builtin macros use :: delimiter instead of the 2.x single
  colon delimit (to distinguish them from inline macros). The 2.x
  syntax is still supported for backward compatibility.
- Nested lists are now supported and IndentedParagraphs can be
  included in list items.
- Conditional source inclusion can be specified using built in `ifdef`,
  `ifndef` and `endif` macros.
- The new conditional source inclusion feature has been used to reduce
  the number of default configuration files down to one per backend.
- A change of name: 2.x 'Substitutions' are now called 'Replacements'
  and the 2.x `[substitutions]` configuration file section is now
  called `[replacements]` (the old name is still recognized for
  backward compatibility).
- The line break is now implemented as a 'Replacements' substitution.
- Inline 'icon' macro for inline images has been added to default
  configuration files.

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.
- 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 html` option is used
  then asciidoc(1) will look for `mydoc.conf` and `mydoc-html.conf` in
  that order.
- The characters used to quote formatted text can be configured and
  extended by the user (see the master.conf [quotes] section).
- Quoted text can now be escaped by prefixing a backslash character to
  the leading quote.
- The double single-quote '' strong text quote has been deprecated in
  favor of an asterisk * character.
- Added \{eval:expression}, \{sys:command} and \{sys2:command}
  glossary reference actions.
- Trailing brace characters `}` are now allowed inside glossary
  references provided they are escaped with a backslash character.
- Glossary entries can now be escaped by prefixing a backslash
  character to the leading brace character (use this in preference to
  placing the backslash inside the brace).
- The output macro has been deprecated (use the new include1 macro
  inside a CustomBlock).
- The default document type is `article` (asciidoc no longer attempts
  to guess).
- Files included within DelimitedBlocks are not searched for block
  termination underlines. This ensures the entire file is part of the
  DelimitedBlock.
- `include` macros can now be used in configuration files.
- 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
  immediately make the source document backend specific. Use
  CustomBlocks or Substitutions instead.

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
  http://www.methods.co.nz/asciidoc/examples/website/).
- NOTE: The `asciidoc` wrapper script included in the 2.0 distribution
  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).
- In addition to the `name=value` glossary entry format two new ones
  have been introduced: `name` (the default value is set to an empty
  string) and `^name` (the glossary entry is undefined).
- The `-q` command-line option has been deprecated and the `-w level`
  command-line option added. +
  NOTE: By default skipped substitution warnings are now suppressed.
- If a configuration file specified with the `-f` command-line option
  is not found relative to the current working directory then the
  search is repeated relative to the asciidoc(1) directory. This
  allows global configuration files to be used.
- Added `\{infile}`, `\{outfile}` predefined glossary entries.
- Added `under-construction` macro to HTML article configuration
  files.
- Deprecated `\{asciidoc_version}` glossary entry in favor of
  `\{asciidoc-version}` (to it consistent with other entries).

Version 2.0 (2003-02-24)
------------------------
- The emphasized, strong and monospaced words options have been
  generalized with the introduction of macro based 'special words'
  lists.
- Glossary references can now appear in both the document and macro
  bodies.
- All output files use `crlf` line termination (previously used UNIX
  `lf` (newline) termination).
- Added [substitutions] section which implements arbitrary regular
  expression based substitutions.
- An optional `master.conf` configuration file can be used for entries
  that are not backend or document type specific.
- Special character definitions moved from the code to the new
  [special_characters] configuration file section.
- Configuration file glossary added.
- Command-line -g glossary entry added.
- A new 'book' document type has been implemented for the 'docbook'
  backend. It outputs DocBook 'book' documents.
- A major internal change has been the implementation of parametrized
  user definable 'macros'. Internally most document elements are now
  processed as macros.
- Configuration file macro variables can be specified with default
  values (literals or other macro variables).
- An attempt has been made to tighten up the vocabulary used to
  describe the AsciiDoc document syntax.
- The term abstract has been replaced by the more general term
  'preface' and a new preface section introduced into article
  configuration files (replacing the synopsis sections).
- Any section elements can now be put in the document preface
  (previous versions only allowed paragraphs).
- AsciiDoc Blocks have been unified and their behavior can be user
  defined and parametrized.
- An 'output' inclusion allows an external file to be written directly
  to the backend output file.
- A new CustomBlock has been added. Default behavior is to insert the
  enveloped AsciiDoc source lines directly into the output file.
- A 'line break' tag can be inserted by terminating a line with a '+'
  character (only really useful for HTML backends).
- An fourth section level has been introduced.
- The SidebarBlock delimiter line characters have been changed. The
  deprecated underline is still accepted.
- Levels 2 and 3 title underline characters have been changed.  The
  deprecated underlines are still accepted.
- Lines with backend specific inline tags can be inserted into
  AsciiDoc source files.
- Single words enveloped by underscores are no longer emphasized. This
  feature was deprecated as it is redundant (use single quotes
  instead) and was being applied to file names with underscores.
- A `-q` quiet option has been added to suppress warning messages.
- Badge images sourced locally.
- Added 'author' and 'author-mail' meta tags to HTML configuration
  files.

Version 1.5 (2003-01-08)
------------------------
- Implemented sidebar document elements.
- Explicit checks for user specified configuration files and input
  file (rather than throwing exception).

Version 1.4 (2003-01-04)
------------------------
- New configuration file options 'emphasizedwords' and 'strongwords'.
  These allow the definition of words that will always be emphasized
  or rendered in a strong font without inline formatting.
- Document and section titles are no long subject to inline
  formatting.
- Multiple configuration files can be overlaid in a single command.
- Configuration file tags and options entries can now be overridden on
  an entry by entry basis (previously the entire section was
  overloaded).
- Configuration file tags and options entries are now cached this has
  resulted in around 37% performance improvement over version 1.3.
- Variable lists can now contain multiple terms per list item.
- Placeholder paragraph eliminated from empty sections that contain
  subsections.
- Added \{asciidoc_version} substitution variable.
- More documentation additions and tidy ups.

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
  accents) are rendered in a strong font (usually bold).
- Paragraphs can now be followed immediately by Simple lists and
  Ordered lists without an intervening blank line.
- A user specified configuration file (`asciidoc(1)` -f option)
  overlays the default configuration file rather than replacing it.
  Custom configuration files need only contain those sections
  that have been customized.
- Comment Block delimiters have been relaxed slightly. They must start
  with three forward slashes /// but the remainder can contain any
  characters, this allows comments to be embedded in the delimiter line.
- Leading non-digit characters preceding revision number are now
  ignored.
- Set default indentsize [option] from 2 to documented default value
  of zero in HTML backend html-article.conf and html-manpage.conf
  files.
- Fixed error that occurred when taking input from stdin without
  explicitly specifying a document type.
- Restored file name and line number error message information.
- Changed deprecated -t option to -d in asciidoc --help and usage
  command output.
- CSS styles tweaking.
- Code, configuration file and documentation tidy ups.

Version 1.2 (2002-12-28)
------------------------
- Implemented 'include' URL to allow file inclusion.
- `fileextension` configuration file [option] renamed to more sensible
  `outfilesuffix` (`fileextension` still accepted by this version but
  will be dropped in future).
- Improved error reporting.
- CSS backends generate valid XHTML.
- New `css-embedded` backend generates HTML with embedded stylesheets
  (use the `css` backend for linked stylesheets). The css-embedded
  backend output contains no linked images so the generated html files
  are completely self contained.
- Bug fixes.

Version 1.1 (2002-12-03)
------------------------
- Added css (cascading style sheets) backend
- Implemented IndentedBlock document element.
- Tabsize command-line option has been deprecated in
  favor of configuration file.
- Default indent width changed to zero.
- Added \{localdate} and \{localtime} substitution variables.
- Added optional [options] configuration file section with
  fileextension, tabsize and indentsize options.
- Implemented \{authorinitials} substitution variable.
- Added https link type.
- Corrected [graphic] substitution from \{title} to \{caption}
  in linuxdoc-article.conf configuration file.
- Fixed error that occurred when '==' title underline was
  used.

Version 1.0 (2002-11-25)
------------------------
First AsciiDoc public release along with AsciiDoc web site
(http://www.methods.co.nz/asciidoc/) and SourceForge.net project registration
(https://sourceforge.net/projects/asciidoc/[]).

// vim: set syntax=asciidoc:
