Asciidoc

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

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

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

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

--------------------------
- Fixed problem with anchor tag when generating CSS styled HTML.

------------------------
***************************************************
This release has had some fairly major code and
documentation changes. Please report any problems
you encounter.

mailto:srackhamgmail.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).