diff options
Diffstat (limited to 'source-builder/sb/asciidoc/CHANGELOG')
-rw-r--r-- | source-builder/sb/asciidoc/CHANGELOG | 3291 |
1 files changed, 0 insertions, 3291 deletions
diff --git a/source-builder/sb/asciidoc/CHANGELOG b/source-builder/sb/asciidoc/CHANGELOG deleted file mode 100644 index 8d260e5..0000000 --- a/source-builder/sb/asciidoc/CHANGELOG +++ /dev/null @@ -1,3291 +0,0 @@ - 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/ |