diff options
Diffstat (limited to 'doc/asciidoc/CHANGELOG')
| -rw-r--r-- | doc/asciidoc/CHANGELOG | 3291 |
1 files changed, 3291 insertions, 0 deletions
diff --git a/doc/asciidoc/CHANGELOG b/doc/asciidoc/CHANGELOG new file mode 100644 index 0000000..8d260e5 --- /dev/null +++ b/doc/asciidoc/CHANGELOG @@ -0,0 +1,3291 @@ + AsciiDoc ChangeLog + + version 8.6.8, 17 July 2012 + __________________________________________________________________ + +1. Version 8.6.8 (2012-07-17) + + Release highlights + Added full complement of styles to Open Blocks and Normal Paragraphs — + those with a minimalist bent could construct virtually any document + using just Title, Normal Paragraph and Open Block syntaxes. + + Other additions and changes + * Increased default maximum include depth from 5 to 10. + * Emit warning if maximum include depth is exceeded. + * Suppress repeated console messages. + * Music filter: removed --beams=None option from abc2ly invocation + because it is broken on LilyPond 2.14 (Ubuntu 12.04). + * Replaced obsolete <tt> tag with <code> in HTML backends. + * Allow configuration attribute entries to create a new section + (previously you could only modify existing sections). See: + [1]discussion list. + * Documented {wj} (word-joiner) attribute and updated FAQ. See: + [2]discussion list. + * FAQ: Added How can I place a footnote immediately following quoted + text? See [3]discussion list. + * Added Greek language configuration file. Contributed by Michael + Dourmousoglou. See [4]discussion list. + * FAQ: Added Using roles to select fonts for PDF. Submitted by Lex + Trotman and based on solution by Antonio Borneo. See: [5]discussion + list. + * Apply same monospaced font size to all monospaced text. + * Changed 0 number padding to spaces in numbered GNU source-highlight + outputs. + * Allow highlight source highlighter to use python for Python + {language} name. r1142: Update the AsciiDoc source filter to allow + the use of the highlight source code highlighter. See [6]discussion + list. + + Note + The pygments attribute has been deprecated in favor of the new + source-highlighter attribute. + * Vim syntax highlighter: Don’t confuse trailing open block delimiter + with section underline. + * Added skip option to paragraphs (c.f. Delimited Block skip option). + + Bug fixes + * FIXED: latex, music and graphviz filters: When the filter output + image is data-uri encoded write it to the indir (instead of the + outdir) so that encoder can find it. See [7]discussion list. + * FIXED: Escape the ] character inside inline macros. See + [8]discussion list. + * FIXED: source highlighter filter: Pass role attribute to HTML + backends. + * FIXED: source highlight filter: docbook backend: role attribute was + not passed to listings without a title. Patch submitted by Lex + Trotman. See [9]discussion list. + * FIXED: music2png.py: FOPException: Raster ByteInterleavedRaster + error (FOP 1.0, ImageMagick 6.6.9-7). + __________________________________________________________________ + +2. Version 8.6.7 (2012-03-17) + + Release highlights + No major enhancements but quite a few bug fixes which, among other + things, fixes Jython compatibility and improves Windows compatibility. + + All additions and changes + * Vim syntax highlighter: highlight entity refs in macro arguments. + * Added files with .asciidoc extension to Vim file type detection. + [10]Patch submitted by Dag Wiers. + * Added replacement3 substitution to enable [11]ODT whitespace + processing. + * Added unbreakable option to XHTML and HTML 5 backends. + * Implemented toc::[] block macro and toc-placement attribute for + HTML backends to allow the Table of Contents placement to be set + manually by the author. + * Added FAQs: How can I control page breaks when printing HTML + outputs? and Is it possible to reposition the Table of Contents in + HTML outputs?. + * Added --backend and --backend-opts options to the a2x command to + allow a2x to use backend plugin code extensions. [12]Patch + submitted by Lex Trotman. + * Added [13]args block attribute to source highlight blocks to allow + arbitrary parameters to be passed to the source highlighters. + * If the ascii-ids attribute is defined then non-ascii characters in + auto-generated IDs [14]are replaced by their nearest ascii + equivalents (to work around DocBook processor limitations). + * Added global blockname attribute which is dynamically updated to + identify the current block. See [15]discussion list. + * xhtml11, html5 backends: Include book part TOC entries for + multi-part books. Patch submitted by Loïc Paillotin. + * Removed code filter example from the AsciiDoc User Guide so that + backends implemented as external plugins can compile the manual. + See [16]discussion list. + * If the delimited block skip option is set then do not consume block + title and attributes. This makes it possible for the comment + delimited blocks to use an attribute list (previously the comment + delimited block was hardwired to skip preceding attributes and + titles). See [17]discussion list. + * Added backend-confdir intrinsic attribute. + + Bug fixes + * FIXED: slidy backend: broken stylesheet attribute. [18]Patch + submitted by Micheal Hackett. + * FIXED: Restored [19]missing themes to zip file distribution + archive. + * FIXED: Grammatical error in error messages. [20]Patch submitted by + Dag Wieers. + * FIXED: Use configured normal substitution in preference to the + default one. + * FIXED: The eval block macro would execute multiple times if it + evaluated to None. + * FIXED: Duplicated entries in TOC of large document. [21]Patch + submitted by Sebastien Helleu. + * FIXED: Python 2.4 backward [22]incompatibility. + * FIXED: 8.6.6 regression broke Jython compatibility. See + [23]discussion list. + * FIXED: Leaky file handles in a2x and music and latex filters which + created incompatibility problems for Jython. + * FIXED: All Python filters are executed with the same Python + interpreter that executes the asciidoc parent (previously filters + were hardwired to execute the python interpreter). This prevents + [24]Python mix-ups. + * FIXED: Microsoft Windows shelled command-line truncation that + caused shelled commands to fail e.g. the data-uri attribute + failure. + __________________________________________________________________ + +3. Version 8.6.6 (2011-09-04) + + Release highlights + * The AsciiDoc plugin architecture has been enhanced, unified and + extended: + + Plugin commands have been added to the asciidoc(1) --backend + option. + + An asciidoc(1) --theme option has been implemented to specify + a theme and to manage theme plugins. + + A plugin build command (for creating plugins) added. + + build, install, list and remove plugin commands are all + recognized by asciidoc(1) --backend, --filter and --theme + options. + * A security update by Kenny MacDermid removes the use of eval() on + untrusted input (to disallow code malicious execution). + + All additions and changes + * xhtml11, html5: Made verse and quote block text darker to print + legibly in Google Chrome browser. + * Added plugin build command for plugin file creation. + * Merged --help plugins back to --help manpage so it matches the + asciidoc(1) manpage. + * The --filter command-line option can specify the name of filters + that will be unconditionally loaded. + * If a filter directory contains a file named __noautoload__ then the + filter is not automatically loaded (you can used the --filter + command-line option to override this behavior). + * tests: Add Italian language tests. Patch submitted by Simon + Ruderich. See: + [25]http://groups.google.com/group/asciidoc/browse_thread/thread/5e + 2e6f4dd740d51a + * tests: Add tests for localized man pages. Patch submitted by Simon + Ruderich. See: + [26]http://groups.google.com/group/asciidoc/browse_thread/thread/5e + 2e6f4dd740d51a + * If the section name is prefixed with a + character then the section + contents is appended to the contents of an already existing + same-named section (the default behavior is to replace the the + section). + * If a configuration file section named docinfo is loaded then it + will be included in the document header. Typically the docinfo + section name will be prefixed with a + character so that it is + appended to (rather than replace) other docinfo sections. + * Added {sp} intrinsic attribute for single space character. See + [27]http://groups.google.com/group/asciidoc/browse_thread/thread/a8 + 39aa01db0765d2 + * Fixed TOC and footnotes generator. Patch submitted by Will. See + [28]http://groups.google.com/group/asciidoc/browse_thread/thread/73 + 4ac5afed736987 + * The asciidoc-confdir attribute is set to the asciidoc executable + directory if it contains global configuration files i.e. a local + asciidoc installation. + * asciidoc now throws an error instead of just a warning of the + backend configuration file is not found. + * latex filter: write MD5 file after successful PNG file generation. + Always delete temp files irrespective of outcome. + * Added truecolor option to LaTeX filter. Patch submitted by Michel + Krämer. See: + [29]http://groups.google.com/group/asciidoc/browse_thread/thread/64 + 36788a10561851 + * Unit test for table column specifiers with merged cells. Patch + submitted by Simon Ruderich. See: + [30]http://groups.google.com/group/asciidoc/browse_thread/thread/c9 + 238380a1f2507a + * Added verbose message for ifeval::[] macro evaluation. + * Added test case for ifeval::[] evaluation. + * Security update to remove the use of eval() on untrusted input (to + disallow code malicious execution). Patch submitted by Kenny + MacDermid. + * Changed web site layout from table to CSS based. See + [31]http://groups.google.com/group/asciidoc/browse_thread/thread/ec + 8e8481eb0e27b0/d1c035092b5bb7a4?lnk=gst&q=caption+option#d1c035092b + 5bb7a4 + * a2x: Pass --format option value to asciidoc as a2x-format + attribute. Patch submitted by Lex Trotman + ([32]http://groups.google.com/group/asciidoc/browse_thread/thread/3 + e177b84bc133ca9/659796dfadad30ea?lnk=gst&q=a2x+format#659796dfadad3 + 0ea). + * Added two FAQs submitted by Lex Trotman. See: + [33]http://groups.google.com/group/asciidoc/browse_thread/thread/16 + d3fb9672a408e7 + * html5,xhtml11: Implemented themes directory structure. + * html5,xhtml11: Implemented asciidoc --theme management option + (install, list, build and remove commands). + * html5,xhtml11: A theme can now optionally include a JavaScript file + <theme>.js + * html5,xhtml11: If the data-uri attribute is defined then icons from + the theme icons directory (if they exist) will be embedded in the + generated document. + * Added optional warnings argument to include macros. + * The asciidoc --verbose option now prints file inclusion messages. + * xhtml11, html5: Remove necessity for separate manpage CSS files. + * Added css-signature attribute to tests. + * Add css-signature attribute to set a CSS signature for the + document. Patch submitted by Peg Russell, see: + [34]http://groups.google.com/group/asciidoc/browse_thread/thread/ba + cbf8aeb8ad6a3a + * White background for toc2 TOC viewport so that horizontally + scrolled content does not obscure the the TOC. Patch submitted by + Lionel Orry, see: + [35]http://code.google.com/p/asciidoc/issues/detail?id=8 + + Bug fixes + * FIXED: Plugin install command: Delete backend directory is install + fails. + * FIXED: Plugin install command: Fixed bug extracting binary files on + Windows (reported by Jean-Michel Inglebert). + * FIXED: tests: Skip blank sections in testasciidoc.conf test + configuration file instead of throwing an exception (reported by + Jean-Michel Inglebert). + * FIXED: If a plugin Zip file does not contain file permissions + (probably because it was created under Windows) then install it + using the default permissions. + * FIXED: Fixed missing quote in preceding LaTeX filter patch. Fix + submitted by Simon Ruderich. See: + [36]http://groups.google.com/group/asciidoc/browse_thread/thread/64 + 36788a10561851 + * FIXED: Some path attributes were processed as escaped Python + strings which could result in corrupted path names with backslash + separated Windows path names. Reported by Will. See: + [37]http://groups.google.com/group/asciidoc/browse_thread/thread/e8 + f3938bcb4c8bb4/44d13113a35738ef + * FIXED: Vertically spanned table cells resulted in incorrect column + styles being applied to some cells. Reported by Will: + [38]http://groups.google.com/group/asciidoc/browse_thread/thread/c9 + 238380a1f2507a/9afc4559d51e1dbd + * FIXED: LaTeX backend: fixed bad escapes. Patch submitted by Mark + McCurry: + [39]http://groups.google.com/group/asciidoc/browse_thread/thread/8c + 111f1046b33691/158a944cf4d5ff0d?lnk=gst&q=latex+escapes#158a944cf4d + 5ff0d + * FIXED: When using slidy backend, display of characters with accents + is wrong because of meta http-equiv line missing. Reported by + Fabrice Flore-Thebault. See: + [40]http://groups.google.com/group/asciidoc/browse_thread/thread/ea + f25f21d1da180a + __________________________________________________________________ + +4. Version 8.6.5 (2011-05-20) + + Release highlights + * The addition of an html5 backend to generate HTML 5 output. Apart + from the inclusion of audio and video block macros the html5 + backend is functionally identical to the xhtml11 backend. + * A new flask theme for xhtml11 and html5 backends inspired by the + [41]Flask website styling (see toc2 example in the next item + below). + * The new toc2 attribute generates a table of contents in the left + hand margin (xhtml11 and html5 backends). [42]This example was + generated using the following command: + asciidoc -b html5 -a icons -a toc2 -a theme=flask article.txt + * a2x(1) now has a flexible mechanism for copying arbitrary resource + files to HTML based outputs — this is very handy for generating + EPUB files with embedded fonts and other resources. + + The a2x(1) --resource option can be used to inject any file + into EPUB output documents e.g. CSS resources such as fonts + and background images. + + Explicitly specified resources are added to the EPUB OPF + manifest automatically. + + You can explicitly specify file extension MIME types. + + The enhanced resource processing works around a couple of + DocBook XSL bugs (see [43]EPUB Notes). + + All additions and changes + * A new flask theme for xhtml11 and html5 backends. A shameless + knock-off of the [44]Flask website styling. + * Added HTML 5 article with toc2 table of contents to the example on + the AsciiDoc website home page. + * Added filters and topics help topics. Fixed documentation errors in + help text. Patch submitted by Lionel Orry, see: + [45]http://groups.google.com/group/asciidoc/browse_thread/thread/9d + a9d48a6461ff14 + * Pass parent configuration files, command-line attributes and header + attributes to table asciidoc filters. Based on patch submitted by + Simon Ruderich, see: + [46]http://groups.google.com/group/asciidoc/browse_thread/thread/5c + 792cbb395b753b + * Allow a title attribute entry in the document header so that HTML + backends can set the title element separately from the displayed + document title (the doctitle attribute). + * Pass lang attribute to asciidoc table style filter. Patch submitted + by Simon Ruderich, see: + [47]http://groups.google.com/group/asciidoc/browse_thread/thread/e2 + 100b7cb29283ce + * xhtml11,html5: Added toc2 attribute which generates a scrollable + table of contents in the left hand margin. Based on customized CSS + written by Suraj Kurapati, see + [48]http://groups.google.com/group/asciidoc/browse_thread/thread/c5 + e30ee5555877f5 + * Added asciidoc-confdir intrinsic attribute which expands to the + global conf directory. + * Documented that you can specify multiple CSS files with the a2x(1) + --stylesheet command option. See: + [49]http://groups.google.com/group/asciidoc/browse_thread/thread/ba + f3218551d05a05 + * Improved xhtml11 backend’s table of contents generation latency. + Patch submitted by Hongli Lai. See: + [50]http://groups.google.com/group/asciidoc/browse_thread/thread/5a + 7fe64fbfd65ad + * Added html5 backend. + * For consistency converted all DOS formatted configuration and text + files to UNIX format. + * html4: Added ability to use role attribute with most block + elements. Patch contributed by Simon Ruderich. See + [51]http://groups.google.com/group/asciidoc/browse_thread/thread/56 + 20ba634fdb030a + * Added Dutch language configuration file and accompanying test file + (contributed by Dag Wieers, see + [52]http://groups.google.com/group/asciidoc/browse_thread/thread/f9 + 69b9ce987d7f5d). + * Configuration files are loaded in two passes when the -e + command-line option is used (the same behavior as when the -e + option is not used). Patch submitted by haad. See + [53]http://groups.google.com/group/asciidoc/browse_thread/thread/cd + 0f47495fd04181 and + [54]http://code.google.com/p/asciidoc/issues/detail?id=6&q=label%3A + Priority-Medium + * Documented how to include embedded fonts in an EPUB document. + * a2x: Added .<ext>=<mimetype> resource specifier syntax. + * a2x: Enable admonition icons in example EPUBs. + * a2x: allow environment variables and tilde home directories in + resource manifest files. + * a2x: don’t process non-existent resource directories. + * a2x: assume resource option is a directory if the name ends with a + directory separator. + * a2x: Added a new syntax to the --resource option specifier which + allows the destination path to be specified. + * a2x: Copy resources referenced in the OPF and resources referenced + by the generated HTML (in theory DocBook XSL should ensure they are + identical but this is not always the case e.g. + [55]http://sourceforge.net/tracker/?func=detail&atid=373747&aid=285 + 4075&group_id=21935). + * Drop border from callout list image links. + * html4: Moved manpage NAME section out of header so that the name + section is rendered when the asciidoc(1) --no-header-footer option + is specified (so that manpages processed blogpost include the NAME + section). + * Vim syntax highlighter: TODO markers now appear in list items and + literal paragraphs and blocks. + * Constrained quotes can now be bounded on the left by a } character. + See: + [56]http://groups.google.com/group/asciidoc/browse_thread/thread/b2 + 4cc3362f35b801 + * Added text-decoration roles (underline, overline, line-through, + blink) for xhtml11 and html5 outputs. + + Bug fixes + * FIXED: epubcheck 1.1 previously issued a warning for files not + registered in the manifest (epubcheck 1.0.5 did not). This resulted + in a problem compiling the adventures-of-sherlock-holmes.txt + example (the underline.png resource was not in the manifest). + __________________________________________________________________ + +5. Version 8.6.4 (2011-02-20) + + Additions and changes + * Added text foreground and background color along with text size CSS + styles for XHTML outputs, see + [57]http://www.methods.co.nz/asciidoc/userguide.html#X96. + * Vim syntax highlighter: highlight macros that start with an + attribute reference (a common idiom). + * Vim syntax highlighter: highlight attribute references in macro + attribute lists. + * Attribute entries can be used to set configuration markup + templates. + * Double-width East Asian characters in titles now correctly match + the title underline widths. Submitted by Changjian Gao (see + [58]http://groups.google.com/group/asciidoc/browse_thread/thread/77 + f28b0dfe60d262). + * Implemented [59]asciidoc(1) filter commands, see: + [60]http://groups.google.com/group/asciidoc/browse_thread/thread/40 + c64cd33ee1905c + * User’s home directory now calculated in a platform independent + manner. + * Added double-quote characters to French language file. Patch + contributed Yves-Alexis Perez, see: + [61]http://groups.google.com/group/asciidoc/browse_thread/thread/e1 + 5282f072413940 + * Vim Syntax highlighter: Highlight closing OpenBlocks which + immediately follow a literal paragraph. + * Changed UNIX /dev/null to OS independent os.devnull in filters + code. Suggested by Henrik Maier: + [62]http://groups.google.com/group/asciidoc/browse_thread/thread/5a + c8e8ea895147e9 + * Vim syntax highlighter: Single and double quoted text now + highlights correctly when preceded by an attributes list. + * Added Ukrainian language file (lang-uk.conf). Added double-quote + characters to Russian language file.conf). Patches contributed by + Lavruschenko Oleksandr, see + [63]http://groups.google.com/group/asciidoc/browse_thread/thread/e1 + 5282f072413940 + * Single and double quote characters are now set using the {lsquo}, + {rsquo}, {ldquo} and {rdquo} attributes. This makes is easy to + customise language specific quotes. See: + [64]http://groups.google.com/group/asciidoc/browse_thread/thread/e1 + 5282f072413940 + * Implemented conf-files attribute to allow configuration files to be + specified in the source document. Suggested by Lex Trotman, see: + [65]http://groups.google.com/group/asciidoc/browse_thread/thread/b1 + 1066a828ab45b9 + + Bug fixes + * FIXED: Auto-generated section title ids are now Unicode aware. + * FIXED: Setting quotes configuration entries using document + attribute entries failed if the attribute entry was not in the + document header. See: + [66]http://groups.google.com/group/asciidoc/browse_thread/thread/a1 + dd0562dee8b939 + * FIXED: If the input and output file names were different then the + output file name was incorrectly used to synthesize docinfo file + names. Reported by Christian Zuckschwerdt. + * FIXED: An error can occur when more than one consecutive quotes are + defined as a blank string. Reported by Peggy Russell. + * FIXED: Encoding error in automatically generated author initials. + Patch submitted by Xin Wang. See: + [67]http://groups.google.com/group/asciidoc/browse_thread/thread/f4 + 4615dca0b834e9 + __________________________________________________________________ + +6. Version 8.6.3 (2010-11-14) + + Additions and changes + * Added and unbreakable option to bulleted and numbered lists (thanks + to Henrik Maier for this patch). + * Added ifeval::[] system macro (thanks to Henrik Maier for + suggesting this feature). + * The image scale attribute sets the DocBook imagedata element scale + attribute. Patch submitted by Henrik Maier. + * DocBook preface, colophon and dedication style section titles now + work. Based on patch submitted by Henrik Maier. + * a2x: Do not inject xsltproc parameters if they were specified on + the command-line (parameter double-ups generate xsltproc Global + parameter already defined errors). + * a2x: Refactored xsltproc parameter injection. + * a2x: articles chunked at section level by default. + * attributes, titles and specialcharacters sections are now read from + the local asciidoc.conf file before the header is parsed. This + fixes a regression problem. See + [68]http://groups.google.com/group/asciidoc/browse_thread/thread/1b + 3f88f1f8118ab3 + * Document header attributes take precedence over configuration file + attributes. + * Refactored music, graphviz and latex filter configurations. + * Refactored source filter configuration and added literal paragraph + source style. + * Separated paragraph styles from paragraph syntax — any style can be + applied to any syntax. + * Added listing and quote paragraph styles. + * Renamed paragraph default style to normal. + * Updated --help option text. + * a2x: The asciidoc_opts, dblatex_opts, fop_opts and xsltproc_opts + command-line options can be specified multiple times. This makes + embedding multiple a2x options in document headers easier to manage + and less error prone. + * Added ASCIIMathML and LaTeXMathML support to slidy backend. + * Pass the encoding attribute to the Pygments source highlight filter + command. + * a2x: HTML Help .hhk file named after AsciiDoc source file. + * a2x: Added --xsl-file option to allow custom XSL stylesheets to be + specified. + * Make builds the man pages. Patch submitted by Sebastian Pipping. + See + [69]http://groups.google.com/group/asciidoc/browse_thread/thread/c2 + 1c2902c29bae64 + + Bug fixes + * FIXED: Sometimes double backquotes were misinterpreted as inline + literal macros. See: + [70]http://groups.google.com/group/asciidoc/browse_thread/thread/f5 + 10ea82a88aaee8 + * FIXED: Regression in 8.6.2: command-line attributes were not + available to the global asciidoc.conf. + * FIXED: Postponed document title substitutions until backend conf + files have been loaded (8.6.2 regression). See + [71]http://groups.google.com/group/asciidoc/browse_thread/thread/42 + b63ce90c2563b8 + * FIXED: The XSL Stylesheets customizations were preventing chapter + and section level TOCs from being generated when using XSL + Stylesheets via a2x. See + [72]http://groups.google.com/group/asciidoc/browse_thread/thread/42 + b63ce90c2563b8 + * FIXED: “UnicodeDecodeError: 'ascii' codec can’t decode byte” error. + This error is due to a limitation in the Python HTMLParser module, + see: [73]http://bugs.python.org/issue3932 + * FIXED: Broken --no-conf option (8.6.2 regression). + * FIXED: Regression in 8.6.2: configuration attribute entries set in + the document header may cause a FAILED: incomplete configuration + files error. + * FIXED: html4: corrected self closed meta tags. + * FIXED: a2x regression in 8.6.2: HTML Help .hhp file name had + reverted to default name instead of the AsciiDoc source file name. + See: + [74]http://groups.google.com/group/asciidoc/browse_thread/thread/de + dc961b23e9ac56 + * FIXED: Attributes in man page title caused it to be dropped + resulting in invalid DocBook output. + * FIXED: make uninstall now deletes the asciidoc.1 and a2x.1 man + pages. + __________________________________________________________________ + +7. Version 8.6.2 (2010-10-03) + + Additions and changes + * docbook45: Enclosed bibliographic lists in a bibliodiv — you can + now include block titles with bibliographic lists. + * Added optional keywords, description and title document header + meta-data attributes to HTML backends for SEO. + * AttributeEntry values can span multiple lines with a ' +' line + continuation. + * Added slidy backend (based on Phillip Lord’s slidy backend + [75]https://phillordbio-asciidoc-fixes.googlecode.com/hg/). + * Implemented OpenBlock partintro style for book part introductions. + * Comment lines substitute special characters only. + * Backend specific global configuration files (all except + asciidoc.conf) are loaded after the header has been parsed — + virtually any attribute can now be specified in the document + header. + * xhtml11: Volnitsky theme: allow bulleted lists to have intervening + children. + * xhtml11: refactored CSS font-family rules to start of file. + * xhtml11: list bullets colored gray. + * ifdef and ifndef system block macros accept multiple attribute + names: multiple names separated by commas are ored; multiple + attribute names separated by pluses are anded. + * xhtml11: Volnitsky theme: set max-width on labeled lists. + * Vim syntax highlighter: Entities inside quoted text are now + highlighted. + * Added role and id attributes to HTML outputs generated by + OpenBlocks. + * Allow floating titles to generate h1 (level 0) titles in HTML + outputs. + * Added a start attribute to numbered lists to set the start number. + See: + [76]http://groups.google.com/group/asciidoc/browse_thread/thread/c1 + 4a4c3b1e4f6dc5 + * Added two more docinfo attributes docinfo1 and docinfo2 to allow + and control inclusion of a shared docinfo file. See + [77]http://groups.google.com/group/asciidoc/browse_thread/thread/c9 + 48697943432e24 + * Vim syntax highlighter highlights multi-name conditional + attributes. + * LaTeX backend patch submitted by Andreas Hermann Braml (see + [78]http://groups.google.com/group/asciidoc/browse_thread/thread/1c + 415fc4540ce5e5). + * Implemented backend aliases; renamed docbook.conf to docbook45.conf + and aliased docbook45 backend to docbook; aliased xhtml11 to html. + + Bug fixes + * FIXED: Filter commands located in filter directories local to the + source document that where not in the search PATH where not found. + * FIXED: Volnitsky theme: Verseblock font set normal instead of + monospaced. + * FIXED: xhtml11: Callout icons were not rendered as Data URIs when + icons and data-uri attributes were specified. + * FIXED: Long standing bug: nested include macros did not restore the + parent document infile and indir attributes. See: + [79]http://groups.google.com/group/asciidoc/browse_thread/thread/87 + 12a95e95a292a7 + * FIXED: html4: set preamble ID anchor. + * FIXED: xhtml11: dropped unusable id and role attributes from + preamble template. + * FIXED: Bug in multi-name conditional attributes e.g. {x,y#} fails + if x or y is undefined. + * FIXED: latex filter not being installed by Makefile. Thanks to + Grant Edwards for this patch. See + [80]http://groups.google.com/group/asciidoc/browse_thread/thread/c4 + 427a3902d130a8 + * FIXED: a2x: Long-standing bug in a2x which always passes + --string-param navig.graphics 0 to xsltproc, regardless of whether + icons are enabled or not. Reported by Michael Wild: + [81]http://groups.google.com/group/asciidoc/browse_thread/thread/59 + a610068e4acb58 + __________________________________________________________________ + +8. Version 8.6.1 (2010-08-22) + + Additions and changes + * a2x: --resource-dir option renamed to --resource. + * a2x: --resource option accepts both file and directory names. + * a2x: Added -m,--resource-manifest option. + * Added Vim syntax highlighting for quote attribute lists. + * Load asciidoc.conf from all configuration directories before any + other configuration files. This ensures that attributes used for + conditional inclusion are set before backend configuration files + are processed. Previously if you wanted to control global conf file + inclusion your only choice was to modify the global asciidoc.conf + file. + * AsciiDoc Quote element attributes have been simplified and + generalized — positional color and size attributes and named role + attribute have been replaced by a single positional attribute. + + Bug fixes + * FIXED: testasciidoc.py: BACKEND command argument was being ignored. + * FIXED: Broken docinfo file functionality in html4 and xhtml11 + backends (previously the docinfo file was included in the body + instead of the header). + + 8.1. Regression issues + + This release breaks compatibility with quoted element positional color + and size attributes (HTML backends). To revert to the deprecated quote + behavior define the deprecated-quotes attribute in the global + asciidoc.conf file or on the command-line. For a more detailed + explanation of the rationale behind this change see + [82]http://groups.google.com/group/asciidoc/browse_thread/thread/b22603 + bfb879418c. + __________________________________________________________________ + +9. Version 8.6.0 (2010-08-16) + + Additions and changes + * The AsciiDoc distribution can now be built “out of the box” from + the distribution tarball or the Mercurial repository (provided you + have the requisite build applications installed). + * The global configuration files directory is ignored by both + asciidoc and a2x if AsciiDoc configuration files are installed in + the same directory as the asciidoc executable. This change allows + both a system wide copy and multiple local copies of AsciiDoc to + coexist on the same host PC. + * CSS quirks mode is no longer the default xhtml11 output + ([83]http://groups.google.com/group/asciidoc/browse_thread/thread/1 + c02d27d49221aa2). + * Relaxed anchor ID name syntax + ([84]http://groups.google.com/group/asciidoc/browse_thread/thread/5 + f3e825c74ed30c). + * Added document files: doc/epub-notes.txt, + doc/publishing-ebooks-with-asciidoc.txt. + * a2x: If all other resource locations are exhausted then recursively + search directories named images and stylesheets in the asciidoc + configuration files directory. + * a2x: options can also be set in the AsciiDoc source file. If the + source file contains a line beginning with // a2x: then the + remainder of the line will be treated as a2x command-line options. + * Added dblatex table-width processing instruction — tables generated + by dblatex now observe the AsciiDoc table width as a percentage + (thanks to Gustav Broberg for suggesting this enhancement). + * a2x: Don’t exit if the --epubcheck option is set and epubcheck is + missing, issue warning and continue. + * Added a global plaintext attribute for dealing with large amounts + of imported text. + * The author name format has been relaxed, if the the author does not + match the formal specification then it is assigned to the firstname + attribute (previously asciidoc exited with an error message). + * FAQ and documentation updates. + * Refactored chunked.xsl and epub.xsl files. + * Exchanged article.epub for more relevant book.epub on website. + * Put asciidoc.epub User Guide on website. + * a2x: Chunking EPUB and HTML outputs set to a per chapter basis and + the first chapter is separate from preceding contents. + * Changed dates format in example article and books to suppress EPUB + validation error. + * Added style and role CSS classes to xhtml11 section templates. + * Added the role element to xhtml11 backend block templates. + * Suppressed md5 module deprecation warning from music and Graphviz + filters. + * Pygments ([85]http://pygments.org/) option added to source code + highlight filter. Based on Pygments source code filter written by + David Hajage + ([86]http://groups.google.com/group/asciidoc/browse_thread/thread/d + 8d042f5a3021369/8934ebbb8cb7144b). + * xhtml11: Added a new theme (volnitsky). Written and contributed by + Leonid V. Volnitsky. + * xhtml11: Set body element class name to document type. + * Added refentryinfo element and contents (including revdate) to man + page DocBook output. Man pages are now dated using the revdate + attribute value if it has been defined. Based on patch supplied by + Rainer Muller + [87]http://groups.google.com/group/asciidoc/browse_frm/thread/319e5 + cd94493e330/3fcb83fab067af42. + * Added {template:...} system attribute. + * Table of contents attribute toc can now be specified in the + document header. + * Reimplemented music and latex filter -m option functionality when + the input is stdin using MD5 checksums. + * Added latex filter. + * Added auto file name generation to image generating filters + (latex,music, graphviz). + * Added counter2 and set2 system attributes (to implement image auto + file name generation). + * Undefined attribute in filter command generates error but does not + exit. + * Attribute substitution proceeds from start line to end line + (previously was in reverse order which was really confusing). + * Tidied up music filter code: + + Format option is optional and default to abc unless Lilypond + notation detected. + + The -m option does not apply to stdin input. + * Added paragraph styles to music and graphviz filters. + * Documented dynamic template names. 753: Graphviz filter can now + generate SVG format images. Patch submitted by Elmo Todurov, see: + [88]http://groups.google.com/group/asciidoc/browse_frm/thread/fe9b3 + 3d8f5f1e0af The xhtml11 SVG Graphviz template marked EXPERIMENTAL. + No SVG support for other backends. + * AsciiDoc template names can now contain embedded attribute + references. + * Added legalnotice tag to doc/article-docinfo.xml example. + * xhtml11 backend: Callouts and callout lists display callout icons + when the icons attribute is defined. See + [89]http://groups.google.com/group/asciidoc/browse_frm/thread/8eda3 + ea812968854 + * Document attribute names are case insensitive everywhere, this + makes using attribute entries more consistent e.g. previously + :VERS: had to be refered to + * Hungarian translation of footer-text (submitted by Miklos Vajna). + See + [90]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c + b7598993c72# + * asciidocapi.py 0.1.2: Can now load AsciiDoc script named asciidoc. + See + [91]http://groups.google.com/group/asciidoc/browse_frm/thread/66e7b + 59d12cd2f91 Based on patch submitted by Phillip Lord. + * German translation of footer-text (submitted by Simon Ruderich). + See + [92]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c + b7598993c72 + * Pushed HTML footer text into language conf files with the + introduction of a [footer-text] configuration file template + section. See + [93]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c + b7598993c72 + + Bug fixes + * FIXED: Sometimes multiple double quoted text elements in the same + paragraph were mistakenly seen as starting with an inline literal. + See + [94]http://groups.google.com/group/asciidoc/browse_frm/thread/219c8 + 6ae25b79a21 + * FIXED: localtime and doctime attributes calculated incorrect + daylight saving / non daylight saving timezones and consequently so + did HTML footers. Patch submitted by Slawomir Testowy. See + [95]http://groups.google.com/group/asciidoc/browse_frm/thread/af652 + 507caf6cec9 + * FIXED: Missing selector for List of examples title in DocBook CSS + file. Patch submitted by Laurent Laville. See + [96]http://groups.google.com/group/asciidoc/browse_frm/thread/3f969 + 00f7fbf5620 + * FIXED: Broken accents in lang-hu.conf. See: + [97]http://groups.google.com/group/asciidoc/browse_frm/thread/7174c + b7598993c72 + * FIXED: DocBook XSL generated HTML callout lists are properly + aligned. Submitted by Lionel Orry. See + [98]http://groups.google.com/group/asciidoc/browse_frm/thread/2ff80 + 2547b6a75ea + * FIXED: Filter execution now occurs prior to filter markup template + substitution to ensure image data URI encoding happens after image + generation (see + [99]http://groups.google.com/group/asciidoc/browse_thread/thread/14 + e8fcb289a135b). + * FIXED: The section numbers no longer increment when the numbered + attribute is undefined (see + [100]http://groups.google.com/group/asciidoc/browse_thread/thread/f + aa36e9e5c7da019/d24cab3fe363e58d). + __________________________________________________________________ + +10. Version 8.5.3 (2010-01-18) + + Additions and changes + * a2x: Added a2x configuration file options ASCIIDOC_OPTS, + DBLATEX_OPTS, FOP_OPTS, XSLTPROC_OPTS (appended to same-named + command-line options). See + [101]http://groups.google.com/group/asciidoc/browse_frm/thread/ac4b + 9bfa2116db28 + * Dropped .hgignore from the repository. See + [102]http://groups.google.com/group/asciidoc/browse_frm/thread/c17a + bd175778f5ea + * Don’t pass verbose options to asciidoc table filter so that + asciidocapi messages are not discarded. See: + [103]http://groups.google.com/group/asciidoc/browse_frm/thread/c17a + bd175778f5ea + * Added ./tests/data/lang-pt-BR-test.txt file to the repository. + * xhtml11: Verse block and verse paragraph content enveloped in a pre + tag (instead of a div) so it renders better in text-only browsers. + See: + [104]http://groups.google.com/group/asciidoc/browse_frm/thread/1b6b + 66adb24e710 + * User Guide: Clarified Passthrough Blocks (suggested by Simon + Ruderich). + * FAQ: How can I include lines of dashes inside a listing block? + * FAQ errata and updates (submitted by Simon Ruderich). + * User Guide errata. + * Simplified asciidoc-toc processing instruction and included lists + of figures, tables, examples and equations in books (i.e. revert to + pre-8.5.0 behavior). + * Attempted to have dblatex recognise the asciidoc-toc processing + instruction but couldn’t get it to work. + * Added notitle attribute to allow the document title to be hidden. + + Bug fixes + * FIXED: Regression: system attribute escaping did not work. + * FIXED: Website: broken image links in chunked User Guide. + __________________________________________________________________ + +11. Version 8.5.2 (2009-12-07) + + Additions and changes + * Updated example article and book documents with the recommended + explicit section name syntax (see the Special section titles vs. + explicit template names sidebar in the AsciiDoc User Guide). + * Added Italian language configuration file (contributed by Fabio + Inguaggiato). + * Added header table style. See: + [105]http://groups.google.com/group/asciidoc/browse_frm/thread/a23f + ea28394c8ca9 + * Pass icons, data-uri, imagesdir, iconsdir attributes to asciidoc + table style filter so that images are rendered in table cells. + * Pass trace and verbose attributes to asciidoc table style filter so + diagnostic information is printed from table cell source. + * The eval system attribute can be nested inside other system + attributes. + * HTML outputs: Table and figure caption punctuation set to more + usual syntax. + * docbook backend: footnotes can now contain embedded images. See + [106]http://groups.google.com/group/asciidoc/browse_frm/thread/50b2 + 8f6941de111a + * CSS tweaks so that tables processed by DocBook XSL Stylesheets have + the default asciidoc xhtml11 backend styling. See + [107]http://groups.google.com/group/asciidoc/browse_frm/thread/dfe5 + 204d5b2c9685 + * Block titles take precedence over section titles to avoid titled + delimited blocks being mistaken for two line section titles (see + [108]http://groups.google.com/group/asciidoc/browse_frm/thread/f0b6 + f9989f828c3). + * Section title trace displays level and title text. + * FAQ additions. + * Added {zwsp} (zero width space) attribute. + * Undefined paragraph styles are reported (previously threw a runtime + error). + * Eliminated empty preamble generation. + * Floating titles now processed in all contexts. + * Implemented auto-lettered appendix names and updated example + documents. + * Section numbering can be disabled in HTML outputs with a + :numbered!: AttributeEntry. + * xhtml11: Nicer default quote block styling. + * Exclude floating titles from xhtml11 table of contents. Patch + submitted by Mark Burton (see + [109]http://groups.google.com/group/asciidoc/browse_frm/thread/14ae + fc1cb6bd85f5). + * Enhanced doc/article-docinfo.xml example docinfo file. + * Vim syntax highlighter improvements. + + Bug fixes + * FIXED: Absolute imagesdir and iconsdir attribute path names do not + work with the xhtml11 data-uri encoding. See + [110]http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b + 7694bbc82a6 + * FIXED: Regression issue with inline data-uri images. See + [111]http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b + 7694bbc82a6 + * FIXED: An unexpected error occurred when processing a table + containing CSV data if the cols attribute was not explicitly + specified. See + [112]http://groups.google.com/group/asciidoc/browse_frm/thread/4b0f + 364b477ec165 + __________________________________________________________________ + +12. Version 8.5.1 (2009-10-31) + + Additions and changes + * If an AsciiDoc document file begins with a UTF-8 BOM (byte order + mark) then it is passed transparently through to the output file. + The BOM is stripped from included files. See + [113]http://groups.google.com/group/asciidoc/browse_frm/thread/e5e6 + 1823ff4203cd + * Added AsciiDoc role attribute to quoted text. Sets class attribute + in HTML outputs; role attribute in DocBook outputs. See: + [114]http://groups.google.com/group/asciidoc/browse_frm/thread/2aa3 + e5711d243045 + * Conditional attribute syntax extended: they now accept multiple + ORed or ANDed attribute names. + * The xhtml11 backend dynamically processes footnotes using + JavaScript. + * Tidied up and namespaced xhtml11 JavaScript. + * Superceded javascripts/toc.js with javascripts/asciidoc-xhtml11.js. + * Added disable-javascript attribute (xhtml11 backend). + * Styled HTML footnotes. + * Added links to HTML footnote refs. + * Added title attribute to inline image macros to display popup + “tooltip” (HTML outputs only). + * Single-quoted attribute values are substituted in block macros + (just like the AttributeList element). + * For consistency changed underscores to dashes in attribute names. + Public attributes with underscores retained for compatibility. + * Added Brazilian Portuguese language configuration file (contributed + by Thiago Farina). + * Added leveloffset attribute to make it easier to combine documents. + + Bug fixes + * FIXED: a2x: --dblatex-opts is now processed last so + asciidoc-dblatex.xsl params can be overridden. Patch submitted by + Mark Fernandes (see + [115]http://groups.google.com/group/asciidoc/browse_frm/thread/5215 + c99dcc865e7d). + * FIXED: An error occurred if a directory in current path with same + name as executable. + + 12.1. Regression issues + + There’s been quite a bit of tiding up to the xhtml11 JavaScript. The + most obvious change is that the toc.js script has been superceded by + asciidoc-xhtml11.js so if you’re linking you’ll need get a copy of the + new file from the distribution javascripts directory. + + If you use customised xhtml11 configuration file [header] and [footer] + sections and you want them to use the new footnotes feature then you’ve + got a bit more work to do: + 1. The onload event expression changed. + 2. The new <div id="content">...</div> div envelopes document content. + 3. You need to add <div id="footnotes">...</div> div to the + [footnotes] section for footnotes to work. + 4. Drop the ifdef::toc[] macro that surround JavaScript inclusion. + + Take a look at the [header] and [footer] changes in the xhtml11.conf + diff to see what’s going on: + [116]http://hg.sharesource.org/asciidoc/diff/55a5999bfd04/xhtml11.conf + __________________________________________________________________ + +13. Version 8.5.0 (2009-10-04) + + Additions and changes + * Implemented a float attribute for tables and block images (HTML + outputs only). + * Added unfloat::[] block macro to cancel floating. + * Added table align attribute to (HTML outputs only). + * The image align attribute now works with HTML backends. + * Renamed table cell align attribute to halign so it doesn’t clash + with the new table align attribute. + * Added breakable and unbreakable options to AsciiDoc example and + block image elements. + * [miscellaneous] section entries now update properly when set from a + document AttributeEntry. + * [miscellaneous] section pagewidth entry accepts fractional values. + * Fractional column widths are now calculated correctly when using + fractional pageunits (DocBook tables). + * Use DocBook XSL table width processing instructions. + * asciidoc KeyboardInterrupt exits with error code 1. + * Added set system attribute to allow attributes to be set from + configuration file templates. + * Allow constrained quotes to be bounded on the left by a colons and + semicolons, see + [117]http://groups.google.com/group/asciidoc/browse_frm/thread/b276 + a927fdc87995 + * Titled listing and literal blocks (DocBook outputs) no longer + default to examples. See + [118]http://groups.google.com/group/asciidoc/browse_frm/thread/f4df + 7c9eec01a9bd + * Updated language file table, figure and example captions to + accommodate new auto-numbering in html4 and xhtml11 backends. + * Titled source highlight filter listings generated by docbook + backend are now rendered as examples. See + [119]http://groups.google.com/group/asciidoc/browse_frm/thread/f4df + 7c9eec01a9bd + * Implemented counter system attribute. + * Use counter system attributes to number titled tables and block + images in HTML backends. + * Added program name suffix to console messages. + * Added substitution to the AttributeEntry passthrough syntax, this + replaces the now unnecessary attributeentry-subs attribute. + * Allow passthrough inline macro syntax to be used in + AttributeEntrys. + * Reinstated 8.4.4 default lang attribute behavior. See + [120]http://groups.google.com/group/asciidoc/browse_frm/thread/d299 + 24043e21cb6a. + * Added max-width attribute to the xhtml11 backend to set maximum + display width. See + [121]http://groups.google.com/group/asciidoc/browse_frm/thread/74d9 + a542b79ccd50. + * Added a2x.py, a rewritten and much enhanced version of the old a2x + bash script. + * The new a2x can output EPUB formatted documents. + * Added --safe option and deprecated --unsafe option. Patch submitted + by Todd Zullinger. See + [122]http://groups.google.com/group/asciidoc/browse_frm/thread/ea3a + 8ea399ae5d2a and + [123]http://groups.google.com/group/asciidoc/browse_frm/thread/69b3 + 183fdab7c6a5 + * Added CHECK and TEST todo highlight words to Vim syntax + highlighter. + * Line breaks, page breaks, and horizontal rulers are now processed + by dblatex, thanks to a patch submitted by Mark Fernandes + ([124]http://groups.google.com/group/asciidoc/browse_frm/thread/a25 + 4cf949ea7c6c5). + * Allow footnote macros hard up against the preceding word so the + rendered footnote mark can be placed against the noted text without + an intervening space (patch submitted by Stas Bushuev, + [125]http://groups.google.com/group/asciidoc/browse_frm/thread/e1dc + b7ee0efc17b5). + * Normalized path in safe_filename function (submitted by Todd + Zullinger, + [126]http://groups.google.com/group/asciidoc/browse_frm/thread/69b3 + 183fdab7c6a5). + * The Asciidoc numbered and toc attributes cause DocBook outputs to + include asciidoc-numbered and asciidoc-toc processing instructions, + these are used by DocBook XSL to include section numbering and + table of contents (like Asciidoc HTML backends). For backward + compatibility both numbered and toc attributes are defined by + default when the docbook backend is used. See + [127]http://groups.google.com/group/asciidoc/browse_frm/thread/1bad + ad21ff9447ac. + * data-uri attribute is now evaluated dynamically and can be set in + document body (previously could only be set from command-line). + * Added sys3 and eval3 system attributes to passthrough generated + output, this fixes the data-uri inline image problem: + [128]http://groups.google.com/group/asciidoc/browse_frm/thread/a42d + b6bc54c2c537. + * Missing language file generates a warning instead of an error. + * Updated Spanish language file (updates contributed by Gustavo + Andrés Gómez Farhat). + + Bug fixes + * FIXED: Options in an AttributeList option attribute are merged with + (rather than replace) configuration file options. + * FIXED: Comment blocks and comment block macros no longer consume + preceding block titles and attribute lists. + * FIXED: examples/website/layout1.conf and + examples/website/layout2.conf TOC problem. Submitted by Mark + (burtoogle). See + [129]http://groups.google.com/group/asciidoc/browse_frm/thread/b9c6 + 3be67dd1d11c + * FIXED: Only the first occurrence of passthrough macro was + substituted. Patch submitted by Peter Johnson. See + [130]http://groups.google.com/group/asciidoc/browse_frm/thread/1269 + dc2feb1a482c + * FIXED: asciidoc now runs on Jython 2.5.0. + * FIXED: Wordpress margins and pads in a number of block elements + ([131]http://groups.google.com/group/asciidoc/browse_frm/thread/36f + f073c79cbc20a). + + 13.1. Regression issues + + * Tables generated by dblatex occupy 100% of the available space + regardless of the width attribute setting. To restore width + behavior change the pageunits miscellaneous parameter to pt. You + can do this from the command-line with the -a pageunits=pt option. + See [132]DocBook table widths. + __________________________________________________________________ + +14. Version 8.4.5 (2009-05-24) + + Additions and changes + * Added manpage Name and Synopsis section title customization to + languages configuration files. + * Synopsis manpage section no longer mandatory. + * Section markup templates can be specified by setting the title’s + first positional attribute or template attribute. + * The article and book document header can now include a revision + remark. + * A role attribute can now be applied to block elements. This adds + the role attribute to DocBook elements. Patch submitted by + [133]Noah Slater). + * Renamed revision and date attributes to more sensible and + consistent revnumber and revdate (old names deprecated but still + recognized). + * Moved backend specific attributes to Appendix H in User Guide. + * Renamed and generalized the docbook backend revision history + inclusion mechanism to docinfo to reflect the use of all article or + book information elements. The old revision history names still + work but have been deprecated. + * Refactored docbook.conf headers. + * Moved line break replacement from [replacements] to [replacements2] + so the replacement occurs after the mailto macro. This fixes bug + [134]http://groups.google.com/group/asciidoc/browse_thread/thread/4 + bdcdfb0af773e2 + * The typewriter to punctuation apostrophe replacement can be escaped + with a backslash. + * Graphviz filter outputs images to imagesdir if it is defined. + * Made the block image macro generic so that it can be used for + filter outputs. As a result Music and Graphviz filters: + + Have been greatly simplified. + + Honor the data-uri attribute. + + html4 outputs no longer generate W3C validation warning. + * The iconsdir attribute no longer requires a trailing directory + separator character. + * Removed borders around linked html4 images. + * Added html4 specific HTML output for music filter. + * a2x: Added --unsafe option (shortcut for --asciidoc-opts=--unsafe). + * a2x: The FOP executable can now be named fop (this is the default + name in some distributions). + * Attributes are now substituted in the system macro attribute list. + * If the output is set to stdout (i.e. no output directory is + defined) then Music and Graphviz filters will output included + images to the source file directory. + * Added name directive to testasciidoc. + * Added lots of testasciidoc new tests. + * Moved language specific configuration parameters into lang-en.conf + file. + * lang attribute entry can be specified in the AsciiDoc source file + (preceding the header). + * Removed cruft from A-A-P scripts and documented them. + * Added German language config file (lang-de.conf) contributed by + Michael Wild. + * Added French language config file (lang-fr.conf) contributed by + Yves-Alexis Perez. + * Added Russian language config file (lang-ru.conf) contributed by + Artem Zolochevskiy. + * Added Hungarian language config file (lang-hu.conf) contributed by + Miklos Vajna. + + Bug fixes + * FIXED: Multiple manpage names are now handled correctly when + generating DocBook output, each name now generates a separate + DocBook <refname> element. See + [135]http://groups.google.com/group/asciidoc/browse_thread/thread/c + 93bb4db025225d8 + * 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 + [136]http://groups.google.com/group/asciidoc/browse_thread/thread/1 + d796a9c9ddb2855 + * FIXED: Source highlighter now works with Wordpress backend (see + [137]http://groups.google.com/group/asciidoc/browse_thread/thread/6 + d8c716748b109e3). + + 14.1. Regression issues + + 1. A colon following the date in the AsciiDoc header is treated as a + revision remark delimiter — this could be an issue if you have used + a colon in the header date. + __________________________________________________________________ + +15. Version 8.4.4 (2009-04-26) + + Additions and changes + * Added table column and row spanning. + * Table styles can now be applied per cell. + * Vertical cell alignment can be applied to columns and individual + cells. + * Added table align attribute to set horizontal alignment for entire + table. + * Included Geoff Eddy’s update of the experimental LaTeX backend. + * A new attribute named trace controls the output of diagnostic + information. If the trace attribute is defined then + element-by-element diagnostic messages detailing output markup + generation are printed to stderr. + * Added literal paragraph style (allows literal style to be applied + to normal paragraphs). + * Deleted unused replacements2 from xhtml11.conf. + * Added replacements2 to default substitutions. + * testasciidoc.py: messages to stdout, only diffs to stderr. + * Added transparency to smallnew.png image. + + Bug fixes + * All combinations of leading comments and attribute entries at the + start of a document are now skipped correctly. + * FIXED: ./configure doesn’t support --docdir as expected (patch + submitted by Artem Zolochevskiy) + * FIXED: Constrained quotes were incorrectly matched across line + boundaries e.g. the string +\nabc+ incorrectly matched a monospace + quote. + __________________________________________________________________ + +16. Version 8.4.3 (2009-04-13) + + Additions and changes + * DocBook outputs default to DocBook version 4.5 doctype (previously + 4.2). + * Configuration file [specialsections] definitions can be undefined + by setting their configuration entry values blank. + * The Makefile install target depends on the all target to ensure + pre-install patches are applied. + * testasciidoc.py now emits user friendly messages if: + 1. the configuration file is missing. + 2. an illegal backend is specified. + 3. an illegal test number is specified. + + Bug fixes + * Fixed [138]missing template section error. + * The testasciidoc.py --force option no longer deletes test data + files that were not specified. + * Dropped second quotes substitution in table cells — it had + effectively disabled quote escaping in table cells. + __________________________________________________________________ + +17. Version 8.4.2 (2009-03-19) + + Additions and changes + * Added [139]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). + __________________________________________________________________ + +18. Version 8.4.1 (2009-03-10) + + Additions and changes + * AsciiDoc now has a [140]Python API. The following minimal example + compiles mydoc.txt to mydoc.html: + + from asciidocapi import AsciiDocAPI asciidoc = AsciiDocAPI() + asciidoc.execute('mydoc.txt') + + * 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. See + [141]Regression issues below for the impact this may have on + existing documents. Here are some examples that would previously + have had to be escaped: + The `++i` and `++j` auto-increments. + Paths `~/.vim` and `~/docs`. + The `__init__` method. + The `{id}` attribute. + * 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. + + 18.1. Regression issues + + Replacing backtick quoting with the inline literal passthrough raises + two regression scenarios for existing documents: + 1. You have escaped the expansion of enclosed inline elements, for + example: \{id}. You would need to delete the backslashes: {id} (if + you don’t the backslashes will be printed). Mostly it’s just a case + of interactively finding and replacing of all occurrences of `\. + 2. There are enclosed inline elements, for example: some *bold* + monospaced. You would need to switch to plus character monospace + quoting: +some *bold* monospaced+ (if you don’t the enclosed + elements won’t be expanded). + + If your existing documents include these cases and you don’t want to + upgrade then use the -a no-inline-literal command-line option, + alternatively put this in ~/.asciidoc/asciidoc.conf: + [attributes] + no-inline-literal= + __________________________________________________________________ + +19. Version 8.3.5 (2009-02-02) + + 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. + + 19.1. Compatibility issues + + The roman numbered list parenthesis syntax is incompatible with the + potentially ambiguous roman period syntax introduced in 8.3.2. + __________________________________________________________________ + +20. Version 8.3.4 (2009-01-20) + + 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. + __________________________________________________________________ + +21. Version 8.3.3 (2009-01-02) + + This release supersedes 8.3.2. + + Bug fixes + * The broken and confusing numeration and numeration2 numbered list + attributes have been dropped, use the style attribute instead. + __________________________________________________________________ + +22. Version 8.3.2 (2009-01-01) + + 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. + __________________________________________________________________ + +23. Version 8.3.1 (2008-12-14) + + Additions and changes + * Replaced the install.sh script with Ben Walton’s updated autoconf + scripts — see [142]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. + __________________________________________________________________ + +24. Version 8.3.0 (2008-11-29) + + Additions and changes + * [143]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. + * [144]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 [145]passthrough macros along with + asciimath and latexmath [146]passthrough blocks provide a (backend + dependent) mechanism for rendering mathematical formulas. There are + [147]LaTeX Math, [148]AsciiMathML and [149]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 <optionname>-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). + + 24.1. Compatibility issues + + Version 8.3.0 has a number of backward incompatibilities with respect + to the previous 8.2.7 release: + * The old table syntax is still processed but a DEPRECATED warning is + issued. + * Entity references have to be escaped with a backslash. + * You have to explicitly precede horizontal style labeled lists with + the [horizontal] style attribute — by default all labeled lists are + rendered vertically. + * The list compact style has been dropped and is now a list option + (use options="compact" in attribute lists). + * AsciiDoc version 6 sytnax no longer supported. + * Linuxdoc been removed from the distribution. + * The unsupported experimental latex backend has not been tested on + this release. + * The introduction of single-quote quoting requires that double-quote + quoting is escaped with two backslashes. + __________________________________________________________________ + +25. Version 8.2.7 (2008-07-04) + + 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) that 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 [150]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 [151]AsciiDoc repository changelog. + __________________________________________________________________ + +26. Version 8.2.6 (2008-04-29) + + 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 [152]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. + __________________________________________________________________ + +27. Version 8.2.5 (2007-11-18) + + 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. + __________________________________________________________________ + +28. 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. + __________________________________________________________________ + +29. 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 [153]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). + __________________________________________________________________ + +30. Version 8.2.2 (2007-07-22) + + Additions and changes + * [154]LaTeXMathML capability has been added for users who are more + familiar with or prefer LaTeX math formulas to the [155]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. + __________________________________________________________________ + +31. 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. + __________________________________________________________________ + +32. 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 [156]AsciiDoc home page. + __________________________________________________________________ + +33. 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 + [157]tpl User Guide for a fancier layout. Use the -a toc -a + numbered command-line options to produce a number table of + contents. + * A [158]music filter is included in the distribution ./filters/ + directory. It translates music in [159]LilyPond or [160]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. + __________________________________________________________________ + +34. 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. + + [161]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 [162]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 [163]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 + [164]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. + __________________________________________________________________ + +35. Version 7.1.2 (2006-03-07) + + Additions and changes + * Support for [165]ASCIIMathML has been added. See Appendix I: + ASCIIMathML Support in the User Guide and the examples at + [166]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 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 [167]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 [168]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. + __________________________________________________________________ + +36. 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). + __________________________________________________________________ + +37. 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. + __________________________________________________________________ + +38. 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. + __________________________________________________________________ + +39. 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 + [169]Appendix C in the AsciiDoc User Guide). + * Included [170]source-highlight filter in the distribution + ./examples/source-highlight-filter/ directory (based on filter + submitted by [171]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. + __________________________________________________________________ + +40. 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. + __________________________________________________________________ + +41. 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. + __________________________________________________________________ + +42. Version 7.0.0 (2005-06-06) + + This is a major release with many code and documentation changes. + Please report any problems you encounter. + + [172]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 [173]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 [174]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 [175]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 [176]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 [177]David + Greaves. + * Unexpected error following malformed author line error. + __________________________________________________________________ + +43. 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. + __________________________________________________________________ + +44. 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. + __________________________________________________________________ + +45. 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 + [178]Fredrik Steen). + * Recoded tempfile.mktemp() and other artifacts that are no longer + necessary or desirable (patches supplied by [179]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. + __________________________________________________________________ + +46. Version 6.0.0 (2005-01-28) + + This release has had some fairly major code and documentation changes. + Please report any problems you encounter. + + [180]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 + ([181]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. + __________________________________________________________________ + +47. 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 ® to [replacements]. + * CSS stylesheet tweaks. + * Admonitions (Note, Tip, Important, Warning, Caution) include icons + when generating css output. + __________________________________________________________________ + +48. 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. + __________________________________________________________________ + +49. 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. + __________________________________________________________________ + +50. 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. + __________________________________________________________________ + +51. 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. + __________________________________________________________________ + +52. 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 — entity. + * Changed the .UNDER-CONSTRUCTION. macro syntax to + #UNDER-CONSTRUCTION# so it is not mistaken for a BlockTitle. + Similarly changed the .NEW. replacement with #NEW#. + * #NEW# and #UNDER-CONSTRUCTION# macros are now included in + the DocBook backend. + * Replaced shipped smallnew.gif with smallnew.png. + * Documentation tidy ups. + __________________________________________________________________ + +53. 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. + __________________________________________________________________ + +54. 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. + __________________________________________________________________ + +55. 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. + __________________________________________________________________ + +56. 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. + __________________________________________________________________ + +57. Version 5.0.1 (2003-12-09) + + * Fixed problem with anchor tag when generating CSS styled HTML. + __________________________________________________________________ + +58. Version 5.0 (2003-12-08) + + This release has had some fairly major code and documentation changes. + Please report any problems you encounter. + + [182]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). + __________________________________________________________________ + +59. 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. + __________________________________________________________________ + +60. 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. + __________________________________________________________________ + +61. 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. + __________________________________________________________________ + +62. 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. + __________________________________________________________________ + +63. 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. + __________________________________________________________________ + +64. 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). + __________________________________________________________________ + +65. 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. + __________________________________________________________________ + +66. 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. + __________________________________________________________________ + +67. 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. + * 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). + __________________________________________________________________ + +68. 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. + __________________________________________________________________ + +69. Version 1.5 (2003-01-08) + + * Implemented sidebar document elements. + * Explicit checks for user specified configuration files and input + file (rather than throwing exception). + __________________________________________________________________ + +70. 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. + __________________________________________________________________ + +71. 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. + __________________________________________________________________ + +72. 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. + __________________________________________________________________ + +73. 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. + __________________________________________________________________ + +74. Version 1.0 (2002-11-25) + + First AsciiDoc public release along with AsciiDoc web site + ([183]http://www.methods.co.nz/asciidoc/) and SourceForge.net project + registration ([184]https://sourceforge.net/projects/asciidoc/). + __________________________________________________________________ + + Version 8.6.8 + Last updated 2012-07-17 07:24:10 NZST + +References + + 1. https://groups.google.com/group/asciidoc/browse_thread/thread/7be28e9714f249c7 + 2. https://groups.google.com/group/asciidoc/browse_thread/thread/961a957ab5872ebf + 3. https://groups.google.com/group/asciidoc/browse_thread/thread/961a957ab5872ebf + 4. https://groups.google.com/group/asciidoc/browse_thread/thread/9e79d8494ef8d870 + 5. https://groups.google.com/group/asciidoc/browse_frm/thread/64b071bb21de9cf0 + 6. https://groups.google.com/group/asciidoc/browse_frm/thread/e045c9986c71d72a + 7. https://groups.google.com/group/asciidoc/browse_thread/thread/f5174f450a61f14b + 8. https://groups.google.com/group/asciidoc/browse_thread/thread/db3b734a6931cb74 + 9. https://groups.google.com/group/asciidoc/browse_thread/thread/13c9ee97930342b3 + 10. http://groups.google.com/group/asciidoc/browse_thread/thread/a9762e21ec0cc244/5d3a4ebf20e6847e + 11. http://groups.google.com/group/asciidoc/browse_thread/thread/843d7d3d671006fb/25628e14c829db3f + 12. http://groups.google.com/group/asciidoc/browse_thread/thread/b8e93740b7cd0e1d/b5e0b83fe37ae31a + 13. http://groups.google.com/group/asciidoc/browse_thread/thread/3d06b0105dfbb780/8c60eb7a62f522e4 + 14. http://groups.google.com/group/asciidoc/browse_thread/thread/33e99b78e2472122 + 15. http://groups.google.com/group/asciidoc/browse_thread/thread/8200e29815c40f72 + 16. http://groups.google.com/group/asciidoc/browse_thread/thread/849e5ea91f43adf2 + 17. http://groups.google.com/group/asciidoc/browse_thread/thread/e92a75abcc382701 + 18. http://groups.google.com/group/asciidoc/browse_thread/thread/58d0843ae4345afd + 19. http://groups.google.com/group/asciidoc/browse_thread/thread/b0e69e393b6f9f20/47a2c7586f9e40c6?lnk=gst&q=themes+tarball#47a2c7586f9e40c6 + 20. http://groups.google.com/group/asciidoc/browse_thread/thread/b9d705c6b6b39f59/1e120483dafca109 + 21. http://groups.google.com/group/asciidoc/browse_thread/thread/103445ab9d95cb0c + 22. http://code.google.com/p/asciidoc/issues/detail?id=9 + 23. http://groups.google.com/group/asciidoc/browse_thread/thread/4608b77ec289f6c4 + 24. http://groups.google.com/group/asciidoc/browse_thread/thread/14e8fcb289a135b/3af3b4e57b827c78?lnk=gst&q=archlinux#3af3b4e57b827c78 + 25. http://groups.google.com/group/asciidoc/browse_thread/thread/5e2e6f4dd740d51a + 26. http://groups.google.com/group/asciidoc/browse_thread/thread/5e2e6f4dd740d51a + 27. http://groups.google.com/group/asciidoc/browse_thread/thread/a839aa01db0765d2 + 28. http://groups.google.com/group/asciidoc/browse_thread/thread/734ac5afed736987 + 29. http://groups.google.com/group/asciidoc/browse_thread/thread/6436788a10561851 + 30. http://groups.google.com/group/asciidoc/browse_thread/thread/c9238380a1f2507a + 31. http://groups.google.com/group/asciidoc/browse_thread/thread/ec8e8481eb0e27b0/d1c035092b5bb7a4?lnk=gst&q=caption+option#d1c035092b5bb7a4 + 32. http://groups.google.com/group/asciidoc/browse_thread/thread/3e177b84bc133ca9/659796dfadad30ea?lnk=gst&q=a2x+format#659796dfadad30ea + 33. http://groups.google.com/group/asciidoc/browse_thread/thread/16d3fb9672a408e7 + 34. http://groups.google.com/group/asciidoc/browse_thread/thread/bacbf8aeb8ad6a3a + 35. http://code.google.com/p/asciidoc/issues/detail?id=8 + 36. http://groups.google.com/group/asciidoc/browse_thread/thread/6436788a10561851 + 37. http://groups.google.com/group/asciidoc/browse_thread/thread/e8f3938bcb4c8bb4/44d13113a35738ef + 38. http://groups.google.com/group/asciidoc/browse_thread/thread/c9238380a1f2507a/9afc4559d51e1dbd + 39. http://groups.google.com/group/asciidoc/browse_thread/thread/8c111f1046b33691/158a944cf4d5ff0d?lnk=gst&q=latex+escapes#158a944cf4d5ff0d + 40. http://groups.google.com/group/asciidoc/browse_thread/thread/eaf25f21d1da180a + 41. http://flask.pocoo.org/docs/ + 42. file://localhost/tmp/lynxXXXXrCQLhm/article-html5-toc2.html + 43. file://localhost/tmp/lynxXXXXrCQLhm/epub-notes.html + 44. http://flask.pocoo.org/docs/ + 45. http://groups.google.com/group/asciidoc/browse_thread/thread/9da9d48a6461ff14 + 46. http://groups.google.com/group/asciidoc/browse_thread/thread/5c792cbb395b753b + 47. http://groups.google.com/group/asciidoc/browse_thread/thread/e2100b7cb29283ce + 48. http://groups.google.com/group/asciidoc/browse_thread/thread/c5e30ee5555877f5 + 49. http://groups.google.com/group/asciidoc/browse_thread/thread/baf3218551d05a05 + 50. http://groups.google.com/group/asciidoc/browse_thread/thread/5a7fe64fbfd65ad + 51. http://groups.google.com/group/asciidoc/browse_thread/thread/5620ba634fdb030a + 52. http://groups.google.com/group/asciidoc/browse_thread/thread/f969b9ce987d7f5d + 53. http://groups.google.com/group/asciidoc/browse_thread/thread/cd0f47495fd04181 + 54. http://code.google.com/p/asciidoc/issues/detail?id=6&q=label%3APriority-Medium + 55. http://sourceforge.net/tracker/?func=detail&atid=373747&aid=2854075&group_id=21935 + 56. http://groups.google.com/group/asciidoc/browse_thread/thread/b24cc3362f35b801 + 57. http://www.methods.co.nz/asciidoc/userguide.html#X96 + 58. http://groups.google.com/group/asciidoc/browse_thread/thread/77f28b0dfe60d262 + 59. http://www.methods.co.nz/asciidoc/manpage.html + 60. http://groups.google.com/group/asciidoc/browse_thread/thread/40c64cd33ee1905c + 61. http://groups.google.com/group/asciidoc/browse_thread/thread/e15282f072413940 + 62. http://groups.google.com/group/asciidoc/browse_thread/thread/5ac8e8ea895147e9 + 63. http://groups.google.com/group/asciidoc/browse_thread/thread/e15282f072413940 + 64. http://groups.google.com/group/asciidoc/browse_thread/thread/e15282f072413940 + 65. http://groups.google.com/group/asciidoc/browse_thread/thread/b11066a828ab45b9 + 66. http://groups.google.com/group/asciidoc/browse_thread/thread/a1dd0562dee8b939 + 67. http://groups.google.com/group/asciidoc/browse_thread/thread/f44615dca0b834e9 + 68. http://groups.google.com/group/asciidoc/browse_thread/thread/1b3f88f1f8118ab3 + 69. http://groups.google.com/group/asciidoc/browse_thread/thread/c21c2902c29bae64 + 70. http://groups.google.com/group/asciidoc/browse_thread/thread/f510ea82a88aaee8 + 71. http://groups.google.com/group/asciidoc/browse_thread/thread/42b63ce90c2563b8 + 72. http://groups.google.com/group/asciidoc/browse_thread/thread/42b63ce90c2563b8 + 73. http://bugs.python.org/issue3932 + 74. http://groups.google.com/group/asciidoc/browse_thread/thread/dedc961b23e9ac56 + 75. https://phillordbio-asciidoc-fixes.googlecode.com/hg/ + 76. http://groups.google.com/group/asciidoc/browse_thread/thread/c14a4c3b1e4f6dc5 + 77. http://groups.google.com/group/asciidoc/browse_thread/thread/c948697943432e24 + 78. http://groups.google.com/group/asciidoc/browse_thread/thread/1c415fc4540ce5e5 + 79. http://groups.google.com/group/asciidoc/browse_thread/thread/8712a95e95a292a7 + 80. http://groups.google.com/group/asciidoc/browse_thread/thread/c4427a3902d130a8 + 81. http://groups.google.com/group/asciidoc/browse_thread/thread/59a610068e4acb58 + 82. http://groups.google.com/group/asciidoc/browse_thread/thread/b22603bfb879418c + 83. http://groups.google.com/group/asciidoc/browse_thread/thread/1c02d27d49221aa2 + 84. http://groups.google.com/group/asciidoc/browse_thread/thread/5f3e825c74ed30c + 85. http://pygments.org/ + 86. http://groups.google.com/group/asciidoc/browse_thread/thread/d8d042f5a3021369/8934ebbb8cb7144b + 87. http://groups.google.com/group/asciidoc/browse_frm/thread/319e5cd94493e330/3fcb83fab067af42 + 88. http://groups.google.com/group/asciidoc/browse_frm/thread/fe9b33d8f5f1e0af + 89. http://groups.google.com/group/asciidoc/browse_frm/thread/8eda3ea812968854 + 90. http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72 + 91. http://groups.google.com/group/asciidoc/browse_frm/thread/66e7b59d12cd2f91 + 92. http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72 + 93. http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72 + 94. http://groups.google.com/group/asciidoc/browse_frm/thread/219c86ae25b79a21 + 95. http://groups.google.com/group/asciidoc/browse_frm/thread/af652507caf6cec9 + 96. http://groups.google.com/group/asciidoc/browse_frm/thread/3f96900f7fbf5620 + 97. http://groups.google.com/group/asciidoc/browse_frm/thread/7174cb7598993c72 + 98. http://groups.google.com/group/asciidoc/browse_frm/thread/2ff802547b6a75ea + 99. http://groups.google.com/group/asciidoc/browse_thread/thread/14e8fcb289a135b + 100. http://groups.google.com/group/asciidoc/browse_thread/thread/faa36e9e5c7da019/d24cab3fe363e58d + 101. http://groups.google.com/group/asciidoc/browse_frm/thread/ac4b9bfa2116db28 + 102. http://groups.google.com/group/asciidoc/browse_frm/thread/c17abd175778f5ea + 103. http://groups.google.com/group/asciidoc/browse_frm/thread/c17abd175778f5ea + 104. http://groups.google.com/group/asciidoc/browse_frm/thread/1b6b66adb24e710 + 105. http://groups.google.com/group/asciidoc/browse_frm/thread/a23fea28394c8ca9 + 106. http://groups.google.com/group/asciidoc/browse_frm/thread/50b28f6941de111a + 107. http://groups.google.com/group/asciidoc/browse_frm/thread/dfe5204d5b2c9685 + 108. http://groups.google.com/group/asciidoc/browse_frm/thread/f0b6f9989f828c3 + 109. http://groups.google.com/group/asciidoc/browse_frm/thread/14aefc1cb6bd85f5 + 110. http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b7694bbc82a6 + 111. http://groups.google.com/group/asciidoc/browse_frm/thread/cb8b7694bbc82a6 + 112. http://groups.google.com/group/asciidoc/browse_frm/thread/4b0f364b477ec165 + 113. http://groups.google.com/group/asciidoc/browse_frm/thread/e5e61823ff4203cd + 114. http://groups.google.com/group/asciidoc/browse_frm/thread/2aa3e5711d243045 + 115. http://groups.google.com/group/asciidoc/browse_frm/thread/5215c99dcc865e7d + 116. http://hg.sharesource.org/asciidoc/diff/55a5999bfd04/xhtml11.conf + 117. http://groups.google.com/group/asciidoc/browse_frm/thread/b276a927fdc87995 + 118. http://groups.google.com/group/asciidoc/browse_frm/thread/f4df7c9eec01a9bd + 119. http://groups.google.com/group/asciidoc/browse_frm/thread/f4df7c9eec01a9bd + 120. http://groups.google.com/group/asciidoc/browse_frm/thread/d29924043e21cb6a + 121. http://groups.google.com/group/asciidoc/browse_frm/thread/74d9a542b79ccd50 + 122. http://groups.google.com/group/asciidoc/browse_frm/thread/ea3a8ea399ae5d2a + 123. http://groups.google.com/group/asciidoc/browse_frm/thread/69b3183fdab7c6a5 + 124. http://groups.google.com/group/asciidoc/browse_frm/thread/a254cf949ea7c6c5 + 125. http://groups.google.com/group/asciidoc/browse_frm/thread/e1dcb7ee0efc17b5 + 126. http://groups.google.com/group/asciidoc/browse_frm/thread/69b3183fdab7c6a5 + 127. http://groups.google.com/group/asciidoc/browse_frm/thread/1badad21ff9447ac + 128. http://groups.google.com/group/asciidoc/browse_frm/thread/a42db6bc54c2c537 + 129. http://groups.google.com/group/asciidoc/browse_frm/thread/b9c63be67dd1d11c + 130. http://groups.google.com/group/asciidoc/browse_frm/thread/1269dc2feb1a482c + 131. http://groups.google.com/group/asciidoc/browse_frm/thread/36ff073c79cbc20a + 132. http://www.methods.co.nz/asciidoc/userguide.html#X89 + 133. http://groups.google.com/group/asciidoc/browse_thread/thread/62278a054188a038 + 134. http://groups.google.com/group/asciidoc/browse_thread/thread/4bdcdfb0af773e2 + 135. http://groups.google.com/group/asciidoc/browse_thread/thread/c93bb4db025225d8 + 136. http://groups.google.com/group/asciidoc/browse_thread/thread/1d796a9c9ddb2855 + 137. http://groups.google.com/group/asciidoc/browse_thread/thread/6d8c716748b109e3 + 138. http://groups.google.com/group/asciidoc/browse_thread/thread/fd27add515597c06 + 139. http://www.methods.co.nz/asciidoc/testasciidoc.html + 140. http://www.methods.co.nz/asciidoc/asciidocapi.html + 141. file://localhost/tmp/lynxXXXXrCQLhm/L12417-6257TMP.html#X2 + 142. http://www.methods.co.nz/asciidoc/INSTALL.html + 143. http://www.methods.co.nz/asciidoc/newtables.html + 144. http://www.methods.co.nz/asciidoc/newlists.html + 145. http://www.methods.co.nz/asciidoc/userguide.html#X77 + 146. http://www.methods.co.nz/asciidoc/userguide.html#X76 + 147. http://www.methods.co.nz/asciidoc/latexmath.pdf + 148. http://www.methods.co.nz/asciidoc/asciimathml.html + 149. http://www.methods.co.nz/asciidoc/latexmathml.html + 150. http://www.methods.co.nz/asciidoc/source-highlight-filter.html + 151. https://sharesource.org/hg/asciidoc/ + 152. http://en.wikipedia.org/wiki/Data:_URI_scheme + 153. http://www.methods.co.nz/asciidoc/faq.html + 154. http://www.maths.nottingham.ac.uk/personal/drw/lm.html + 155. http://www.methods.co.nz/asciidoc/asciimathml.html + 156. http://www.methods.co.nz/asciidoc/index.html + 157. http://tpl.sourceforge.net/userguide.html + 158. http://www.methods.co.nz/asciidoc/music-filter.html + 159. http://lilypond.org/ + 160. http://abcnotation.org.uk/ + 161. mailto:srackham@gmail.com + 162. mailto:jlm@ofb.net + 163. mailto:m_pupil@yahoo.com.cn + 164. http://open.comsultia.com/docbook2odf/ + 165. http://www1.chapman.edu/~jipsen/mathml/asciimath.html + 166. http://www.methods.co.nz/asciidoc/asciimath.html + 167. file://localhost/tmp/lynxXXXXrCQLhm/userguide.html#X33 + 168. mailto:francis@daoine.org + 169. file://localhost/tmp/lynxXXXXrCQLhm/userguide.html#X39 + 170. file://localhost/tmp/lynxXXXXrCQLhm/source-highlight-filter.html + 171. mailto:trolocsis@gmail.com + 172. mailto:srackham@gmail.com + 173. file://localhost/tmp/lynxXXXXrCQLhm/userguide.html#X36 + 174. file://localhost/tmp/lynxXXXXrCQLhm/userguide.html#X33 + 175. mailto:viktor@rbg.informatik.tu-darmstadt.de + 176. file://localhost/tmp/lynxXXXXrCQLhm/userguide.html#X23 + 177. mailto:david@dgreaves.com + 178. mailto:stone@debian.org + 179. mailto:stone@debian.org + 180. mailto:srackham@gmail.com + 181. http://jimmac.musichall.cz/ikony.php3 + 182. mailto:srackham@gmail.com + 183. http://www.methods.co.nz/asciidoc/ + 184. https://sourceforge.net/projects/asciidoc/ |