This is the mail archive of the
mailing list for the Cygwin project.
- From: Eric Blake <ebb9 at byu dot net>
- To: cygwin-announce at cygwin dot com
- Date: Tue, 02 Dec 2008 19:12:04 -0700
- Subject: Updated: asciidoc-8.3.0-1
- Reply-to: The Cygwin Mailing List <cygwin at cygwin dot com>
- Reply-to: The Cygwin Mailing List <cygwin at cygwin dot com>
-----BEGIN PGP SIGNED MESSAGE-----
A new version of the asciidoc package, asciidoc 8.3.0-1, is now available
for download, replacing 8.2.7-1 as current.
This is a new upstream release, with upstream changes listed below. See
also the package documentation in /usr/share/doc/asciidoc-8.3.0/.
AsciiDoc is a text document format for writing short documents, articles,
books and UNIX man pages. AsciiDoc files can be translated to HTML and
DocBook markups using the asciidoc(1) command. AsciiDoc is highly
configurable: both the AsciiDoc source file syntax and the backend output
markups (which can be almost any type of SGML/XML markup) can be
customized and extended by the user.
To update your installation, click on the "Install Cygwin now" link on the
http://cygwin.com/ web page. This downloads setup.exe to your system.
Save it and run setup, answer the questions and pick up 'asciidoc' from
the 'Devel' category.
Note that downloads from sources.redhat.com (aka cygwin.com) aren't
allowed due to bandwidth limitations. This means that you will need to
find a mirror which has this update, please choose the one nearest to you:
If you want to make a point or ask a question the Cygwin mailing list is
the appropriate place.
volunteer cygwin asciidoc maintainer
CYGWIN-ANNOUNCE UNSUBSCRIBE INFO:
To unsubscribe to the cygwin-announce mailing list, look at the
"List-Unsubscribe: " tag in the email header of this message. Send email
to the address specified there. It will be in the format:
If you need more information on unsubscribing, start reading here:
Please read *all* of the information on unsubscribing that is available
starting at this URL.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Public key at home.comcast.net/~ericblake/eblake.gpg
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
-----END PGP SIGNATURE-----
Version 8.3.0 (2008-11-29)
Additions and changes
* 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.
* 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 passthrough macros along with
asciimath and latexmath passthrough blocks provide a (backend
dependent) mechanism for rendering mathematical formulas. There are
LaTeX Math, AsciiMathML and LaTeXMathML examples on the
* 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
* 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
* Title elements now process the options attribute like other block
* Added `single quoted' element.
* Spaces on both sides of a -- em-dash are translated to thin space
* 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
* 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
* Use w3m(1) as default a2x(1) text format generator (fallback to
* 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
* 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
* 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
* 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
* Vim syntax highlighter: passthroughs now exactly match AsciiDoc
* 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
* Fixed exception that occured if undefined attribute was present in
* AttributeList block can now follow a paragraph without intervening
* The include macro tabsize attribute is no longer propagated to
The following features were implemented but then but removed from this
* 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
1.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
* 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
* The introduction of single-quote quoting requires that double-quote
quoting is escaped with two backslashes.