AsciiDoc 8.5.2 - Changelog

What's new in AsciiDoc 8.4.5:

May 27th, 2009

· FIXED: Multiple manpage names are now handled correctly when
· generating DocBook output, each name now generates a separate
· DocBook element. See
· [3]http://groups.google.com/group/asciidoc/browse_thread/thread/c93
· bb4db025225d8
· 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.
· bloggs@mail was processed inside
· mailto:joe-bloggs@mail-server.com[Mail].
· FIXED: User name in FTP URI generated incorrect FTP link. See
· [4]http://groups.google.com/group/asciidoc/browse_thread/thread/1d7
· 96a9c9ddb2855
· FIXED: Source highlighter now works with Wordpress backend (see
· 5]http://groups.google.com/group/asciidoc/browse_thread/thread/6d8
· c716748b109e3).

What's new in AsciiDoc 8.4.2:

March 19th, 2009

· Added [1]testasciidoc, a tool to verify AsciiDoc conformance.
· A warning is issued if nested inline passthroughs are encountered.
· asciidocapi: setting an attribute value to None will undefine (delete) the attribute (this in addition to the name! attribute name format that the asciidoc(1) command uses).

What's new in AsciiDoc 8.4.1:

March 10th, 2009

Additions and changes:
· AsciiDoc now has a [1]Python API.
· Backtick quoting for monospaced text is now implemented as an inline literal passthrough. This makes more sense since monospace text is usually intended to be rendered literally.
· Added --doctest option to asciidoc(1) command.
· Added an optional second argument to BlockId element, this sets the {reftext} attribute which in turn is used to set the xreflabel attribute in DocBook elements.
· Added lists to --help syntax summary.
· {infile} and {indir} attributes reflect the current input file (previously always referred to the root document).
· {docfile} (new) and {docdir} (previously deprecated) attributes refer to the root document specified on the asciidoc(1) command-line.
· Vim syntax highlighter improvements.
· Syntax summary command (asciidoc -h syntax) additions.
· Admonition icons now have transparent backgrounds.
· Changed yellow W3C badges to blue ones in page footers.

Bug fixes:
· Dropped asciidoc(1) broken undocumented --profile option.
· Em dash replacement now recognized at start of block.

What's new in AsciiDoc 8.3.5:

February 2nd, 2009

Additions and changes:
· Cached compiled regular expression delimiters (speed up User Manual compilation by 250%).
· Created distinct list definitions for each numbered list style to allow nesting of all styles.
· Roman numbers in numbered lists are followed by a closing parenthesis instead of a period to eliminate i, v, x item ambiguity with respect to alpha numbered list items.
· Added **, ***, ****, ***** bulleted lists.
· Added ..., ...., ..... implicit numbered lists.
· Added :::, :::: labeled lists.
· Updated User Guide for new list syntaxes.
· Optimized paragraph and list termination detection with separate precompiled regular expressions for performance and to prevent reaching Python 100 named group limit.
· Updated Vim syntax highlighter for new list syntaxes.
· Allow template::[] macros in conf file entries sections (not just in template sections).
· Dropped unused [listdef-numbered2] conf file sections.
· Renamed ListBlock to more appropriate OpenBlock.
· Implemented single-line versions of ifdef::[] and ifndef::[] macros.
html4 backend styling:
· Underlined admonition captions.
· Added side border to Example Blocks.
xhtml11 backend styling:
· Dropped right hand margin from all but quote and verse blocks.
· html4 backend: corrected over-sized width of caption in admonition block.

Bug fixes:
· Fixed broken numbered list nesting.

What's new in AsciiDoc 8.3.4:

January 21st, 2009

Additions and changes:
· Implemented a title float style. A floating title (or bridgehead) is rendered just like a normal section but is not formally associated with a text body and is not part of the regular section hierarchy so the normal ordering rules do not apply.
· Implemented inline comment macro so comment lines can now appear inside block elements.
· Comment lines are sent to the output if the showcomments attribute is defined (comment blocks are never sent to the output).
· Single quoting attribute values in AttributeList elements causes them to be substituted like normal inline text (without single quoting only attribute substitution is performed).
· Rewrote list item processing (was very crufty). List continuation and list blocks now work as expected. Updated and clarified list documentation in User Guide.
· The revision attribute now recognizes the RCS $Id$ marker format.
· An RCS $Id$ marker formatted revision line in the header does not need to be preceded by an author line.
· If an RCS $Id$ formatted revision is specified and the author name has not already been set then the author name in the $Id$ marker will be used.
· Updated Gouichi Iisaka's Graphviz filter to version 1.1.3.
· Added autowidth table attribute option for (X)HTML outputs.
· DocBook backend now puts orgname optional attribute in DocBook header.
· Deprecated undocumented companyname attribute in favor of DocBook's corpname.
· Removed explicit closing backslash from HTML4 self-closing tags to comply with WC3 recommendation.

Bug fixes:
· Fixed 8.3.3 regression whereby adjacent lists with the same syntax but different list styles were incorrectly treated as a single list.

What's new in AsciiDoc 8.3.3:

January 5th, 2009

· The broken and confusing numeration and numeration2 numbered list attributes have been dropped, use the style attribute instead.

What's new in AsciiDoc 8.3.2:

January 5th, 2009

Additions and changes:
· Added Gouichi Iisaka's Graphviz filter to distribution.
· The SidebarBlock element can now be rendered with an abstract style.
· Reorganized filters into a separate subdirectory for each filter.
· Updated Makefile.in and MANIFEST files to reflect new filters organization.
· Added listing style to LiteralBlock element so listings with nested listing blocks can be rendered as a listing block.
· Changed example code filter to use preferred ListingBlock syntax (the old ~ delimited filter syntax is no longer used).
· Implemented enumeration and enumeration2 numbered list attributes for specifying the list numbering style (arabic, loweralpha, upperalpha, lowerroman and upperroman).
· AsciiDoc now recognizes upperalpha, lowerroman and upperroman numbers in listdef-numbered2 numbered lists and sets the number style based on the style of the first numbered list item (alternative to setting enumeration2 attribute).
· Updated formatlistpat definition in .vimrc example in User Guide.
· You can now backslash escape system block macros.
· Added Pychart FAQ.
· Drop paragraph text and list text, index and label match groups from attributes -- they are included in the element's text and we don't want them processed a second time as attributes.
· Changed comment line block macro to a passthrough block macro to ensure no substitutions.
· A subslist no longer has to be appended to a PassthroughBlock macro definition, if omitted no substitutions are performed.
· Code tidy up: replaced deprecated operator with !=.
· Removed unused linuxdoc code.
· Code tidy ups: dropped old types module reference; replaced has_key() with preferred in operator.

Bug fixes:
· Old syntax source highlight filter regression: special characters where not escaped in DocBook outputs.

What's new in AsciiDoc 8.3.1:

December 19th, 2008

Additions and changes:
· Replaced the install.sh script with Ben Walton's updated autoconf scripts -- see [1]INSTALL for details.
· Added a generalized AttributeEntry syntax to allow arbitrary configuration file entries to be set from within an AsciiDoc document (suggested by Henrik Maier).
· Listing delimited blocks in DocBook outputs now support IDs; IDs of titled Listing and Literal delimited blocks have been moved to the enclosing DocBook example tag (thanks to Vijay Kumar for this patch).
· Replaced vertical typewriter apostrophe with punctuation apostrophe (thanks to Noah Slater).

Bug fixes:
· Regression: Excluding double-quotes from unquoted attribute values resulted in backward incompatibility, double-quotes in unquoted attribute values has been reinstated.
· Regression: Text like &...; was sometimes mistaken for an entity reference -- tightened up entity reference matching.

What's new in AsciiDoc 8.3.0:

December 8th, 2008

Additions and changes:
· [1]AsciiDoc new tables is a complete redesign of the tables syntax and generation. The new syntax and features are a huge improvement over the old tables. The old tables syntax has been deprecated but is currently still processed.
· [2]Lists can now be styled like other block elements. This allows a single list syntax for glossary, qanda (Question and Answer) and bibliography lists instead of having to remember a different syntax for each type.
· Inline passthroughs macros have been improved and block passthrough macros added. Attribute substitution can be optionally specified when the macro is called.
· The passthrough block has a fully transparent passthrough delimited block block style called pass.
· The asciimath and latexmath [3]passthrough macros along with asciimath and latexmath [4]passthrough blocks provide a (backend dependent) mechanism for rendering mathematical formulas. There are [5]LaTeX Math, [6]AsciiMathML and [7]LaTeXMathML examples on the AsciiDoc website.
· Reimplemented and cleaned up filter processing based on a patch submitted by Kelly Anderson. Uses the newer subprocess module instead of the deprecated popen2 module. Now works in Win32 command shell.
· Addition FAQs, more documentation updates.
· Arbitrary HTML/XML entities can be entered in AsciiDoc source.
· Did away with the need for the shaded-literallayout.patch (thanks to Henrik Maier for this patch).
· Implemented page break block macro.
· Added line breaks and ruler processing instructions to DocBook outputs (thanks to Henrik Maier for this patch).
· Added deg (degree) and wj (word joiner) entity attributes (thanks to Henrik Maier).
· Tweaked DocBook indexterm2 macro to avoid white space preceding the term when used in table cells (thanks to Henrik Maier for this patch).
· Title elements now process the options attribute like other block elements.
· Added `single quoted' element.
· Spaces on both sides of a -- em-dash are translated to thin space characters.
· Improved detection and reporting of malformed attribute lists.
· The list compact style is now a list option.
· Added strong labeled list option which makes the labels bold (HTML outputs only).
· Dropped unsupported linuxdoc backend.
· Dropped deprecated xhtml-deprecated (version 6) backend.
· Added breakable and unbreakable attribute options to tables to control table breaking across page boundaries (DocBook XSL/FO outputs). By and in collaboration with Henrik Maier.
· Added pgwide attribute option to tables to table, block image, horizontal labeled lists. Specifies that the element should be rendered across the full text width of the page irrespective of the current indentation (DocBook XSL/FO outputs). Thanks to Henrik Maier for this patch.
· Vim syntax highlighter: spaces before/after bullets no longer highlighted (which is ugly if using a theme that highlights with underlines). Thanks to Donald Chai for this patch.
· Added a2x(1) --fop option.
· Added a2x(1) --no-xmllint option.
· Highlighted labelled list terms with the navy color in XHTML outputs.
· Use w3m(1) as default a2x(1) text format generator (fallback to lynx(1)).
· Changed callout formats in html4 and xhtml11 outputs to angle brackets to match source highlighter rendering.
· Macros now inject user defined -option attributes into markup.
· Added IRC URLs to AsciiDoc inline macros.
· Added depth attribute to include::[] system macro.
· Added footnoteref inline macro.
· Added stylesheet XHTML attribute to specify additional custom CSS stylesheet.
· If a paragraph style is specified it will be added to the XHTML class attribute and DocBook role attribute.
· Replacements can be set in a document using the reserved AttributeEntry name replacement.
· The prefix for auto-generated section name IDs can be set with the idprefix attribute.

Bug fixes:
· Escaped quote skipped over leading and trailing quote instead of just the leading quote.
· Fixed bug that was causing false negative safe mode warnings (patch submitted by Julien Palmas).
· Placed priority of AttributeEntry, AttributeList and BlockTitle above Title. This ensures an AttributeEntry, AttributeList or BlockTitle followed by a same length leading ListingBlock delimiter is not mistaken for a two-line title.
· Vim syntax highlighter: fixed multi-line quoted text.
· Contstrained quote termination after non-space character enforced.
· Vim syntax highlighter: unterminated quoted text is no longer highlighted.
· Vim syntax highlighter: passthroughs now exactly match AsciiDoc semantics.
· Vim syntax highlighter: escaped quoted text, attribute references and inline macros are not highlighted.
· Vim syntax highlighter: TODO's highlighted in CommentBlocks (thanks to Scott Wall); non-greedy $$...$$.
· Vim syntax highlighter: Comment lines mistaken for vertical list labels (thanks to Scott Wall).
· Vim syntax highlighter: Single unmatched $$ mistakenly highlighted remaining text (patch contributed by Scott Wall).
· Callouts now work in source highlighted listing generated by dblatex.
· Fixed exception that occured if undefined attribute was present in filter command.
· AttributeList block can now follow a paragraph without intervening blank line.
· The include macro tabsize attribute is no longer propagated to nested includes.

Omissions:
The following features were implemented but then but removed from this release:
· pi, cdata and comment passthrough macros and passthrough block styles (creeping featurism, use pass macros instead).
· Generic tag inline macro (creeping featurism, use pass macros instead).