Commits

Anonymous committed 9b390c8

Bump version number and update release docs.

Comments (0)

Files changed (10)

 
 :replacements.\bweb:: http://www.methods.co.nz/asciidoc/
 
+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
+  http://groups.google.com/group/asciidoc/browse_frm/thread/ac4b9bfa2116db28
+- Dropped `.hgignore` from the repository. See
+  http://groups.google.com/group/asciidoc/browse_frm/thread/c17abd175778f5ea
+- Don't pass verbose options to asciidoc table filter so that
+  asciidocapi messages are not discarded. See:
+  http://groups.google.com/group/asciidoc/browse_frm/thread/c17abd175778f5ea
+- 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:
+  http://groups.google.com/group/asciidoc/browse_frm/thread/1b6b66adb24e710
+- 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.
+
+
 Version 8.5.2 (2009-12-07)
 --------------------------
 .Additions and changes
 
 COPYING
 -------
-Copyright (C) 2002-2009 Stuart Rackham. Free use of this software
+Copyright (C) 2002-2010 Stuart Rackham. Free use of this software
 is granted under the terms of the GNU General Public License (GPL).
 
 # Default configuration file parameters.
 ######################################################################
 
-# Optional environment variable dictionary passed to executing programs.
-# If set to None the existing environment is used.
+# Optional environment variable dictionary passed to
+# executing programs. If set to None the existing
+# environment is used.
 ENV = None
 
 # External executables.
 LYNX = 'lynx'               # text generation (if no w3m).
 XMLLINT = 'xmllint'         # Set to '' to disable.
 EPUBCHECK = 'epubcheck'     # Set to '' to disable.
+# External executable default options.
 ASCIIDOC_OPTS = ''
 DBLATEX_OPTS = ''
 FOP_OPTS = ''
 """
 asciidoc - converts an AsciiDoc text file to DocBook, HTML or LinuxDoc
 
-Copyright (C) 2002-2009 Stuart Rackham. Free use of this software is granted
+Copyright (C) 2002-2010 Stuart Rackham. Free use of this software is granted
 under the terms of the GNU General Public License (GPL).
 """
 
 import sys, os, re, time, traceback, tempfile, subprocess, codecs, locale
 
 ### Used by asciidocapi.py ###
-VERSION = '8.5.2'           # See CHANGLOG file for version history.
+VERSION = '8.5.3'           # See CHANGLOG file for version history.
 
 MIN_PYTHON_VERSION = 2.4    # Require this version of Python or better.
 
 # Executed by all main.aap's before anything else.
 #
 
-_parent.VERS = 8.5.2
-_parent.DATE = 7 December 2009
+_parent.VERS = 8.5.3
+_parent.DATE = 18 January 2010
 
 all:
     :pass
 . `a2x.conf` from the directory containing 'a2x.py'.
 . The 'CONF_FILE' specified in the '--conf-file' option.
 
+Here are the default configuration file option values:
+
+---------------------------------------------------------------------
+# Optional environment variable dictionary passed to
+# executing programs. If set to None the existing
+# environment is used.
+ENV = None
+
+# External executables.
+ASCIIDOC = 'asciidoc'
+XSLTPROC = 'xsltproc'
+DBLATEX = 'dblatex'         # pdf generation.
+FOP = 'fop'                 # pdf generation (--fop option).
+W3M = 'w3m'                 # text generation.
+LYNX = 'lynx'               # text generation (if no w3m).
+XMLLINT = 'xmllint'         # Set to '' to disable.
+EPUBCHECK = 'epubcheck'     # Set to '' to disable.
+# External executable default options.
+ASCIIDOC_OPTS = ''
+DBLATEX_OPTS = ''
+FOP_OPTS = ''
+XSLTPROC_OPTS = ''
+---------------------------------------------------------------------
+
 
 BUGS
 ----
 
 COPYING
 -------
-Copyright \(C) 2002-2009 Stuart Rackham. Free use of this software is
+Copyright \(C) 2002-2010 Stuart Rackham. Free use of this software is
 granted under the terms of the MIT license.
 

doc/asciidoc.1.txt

 
 COPYING
 -------
-Copyright \(C) 2002-2009 Stuart Rackham. Free use of this software is
+Copyright \(C) 2002-2010 Stuart Rackham. Free use of this software is
 granted under the terms of the GNU General Public License (GPL).
 

doc/asciidoc.dict

-personal_ws-1.1 en 838 
+personal_ws-1.1 en 847 
 mandoc
 colspecs
 API
 BOM
 Bon
 ungenerated
+des
 cmd
-des
 ListItems
 dev
 vulputate
 toclevel
 hyperlinks
 dsv
+ENV
 dvi
 stderr
 SimpleSection
 gif
 prepend
+RevisionNumber
 CommentBlocks
 consequat
 fmt
 Chai
 strongwords
 setlocal
+ListingBlock
 listingblock
-ListingBlock
 exe
+AuthorInfo
 vsides
 rewriteSystem
 taoup
 AttributeLists
 magna
 xreflabel
+PDF's
 PDFs
-PDF's
 MSIE
 permalinks
 Daly
 apos
 ShareSource
 hoc
+ispum
 Maier
-ispum
 TableFooter
 blog
 passthroughs
 png
 lobortis
 Bowlin
+asciimathml
+AsciiMathML
 ASCIIMathML
-AsciiMathML
-asciimathml
 conf
 RCS
 CalloutList
 tzname
 ListParagraph
 Windtrainer
+hgignore
 eget
 sed
 userguide
 SJR
 biggy
 pgwide
+RevisionDate
 crlf
 tex
+B�lido
 Bolido
-B�lido
 tabsize
 colpcwidth
 onload
 Tsawassen
 postsubs
 src
+LastName
 lastname
-LastName
 toc
 tmp
 Knisley
 params
 undefines
 Andr�s
+htmlhelp
 HTMLHelp
-htmlhelp
 cellspacing
 Citeaux
 srackham
+Lule�
 Lulea
-Lule�
 Ubuntu
 xml
 XSLTLib
 refactored
 sgml
 backcolor
+AsciiDoc
 asciidoc
-AsciiDoc
 subslist
 hs
 hu
 commodo
 Fernandes
 Pretium
+notitle
 manvolnum
 homero
 listindex
 linkcss
 colspan
 localtime
+Ruderich
 noincsearch
 Stas
 colspec
 chmod
 posattrs
 subdirectories
+RevisionRemark
 TableHeader
 Mihai
 KeyboardInterrupt
 ItemContinuation
 tyger
 upperroman
+RevisionInfo
 Berglunds
 nabc
 symlinked
 datadir
 Kumar
 IndentedParagraphs
+Berguvsvagen
 Berguvsv�gen
-Berguvsvagen
 executables
 tabledef
 ftdetect
 JavaHelp
 unescaped
 mydoc
+middlename
 MiddleName
-middlename
 Jimmac's
 Plain text is the most universal electronic document format,
 regardless of your computing environment you can always read and write
 plain text documentation. But for many applications plain text is not
-the prefered presentation format -- HTML and PDF formats are widely
+the preferred presentation format -- HTML and PDF formats are widely
 used as is the roff man page format.  DocBook is a popular
 documentation markup format which can be translated to HTML, PDF and
 other presentation formats.
 -----------------------
 There are three types of AsciiDoc documents: article, book and
 manpage. All document types share the same AsciiDoc format with some
-minor variations. If you are familar with DocBook you will have
+minor variations. If you are familiar with DocBook you will have
 noticed that AsciiDoc document types correspond to the same-named
 DocBook document types).
 
 indented paragraph to be misinterpreted as a list -- in situations
 like this apply the 'literal' style to a normal paragraph.
 
-Instead of using a paragraph indent you could applie the 'literal'
+Instead of using a paragraph indent you could apply the 'literal'
 style explicitly, for example:
 
 ---------------------------------------------------------------------
   NOTE: This is an example note.
 
 Alternatively, you can specify the paragraph admonition style
-explicity using an <<X79,AttributeList element>>. For example:
+explicitly using an <<X79,AttributeList element>>. For example:
 
   [NOTE]
   This is an example note.
 
 Block images can be titled by preceding the 'image' macro with a
 'BlockTitle'.  DocBook toolchains normally number titled block images
-and optionally list them in an automatically gnerated 'List of
+and optionally list them in an automatically generated 'List of
 Figures' backmatter section.
 
 This example:
 asciidoc(1) searches for the command:
 
 - First it looks in the user's `$HOME/.asciidoc/filters` directory.
-- Next the global filters directory (ususally `/etc/asciidoc/filters`
+- Next the global filters directory (usually `/etc/asciidoc/filters`
   or `/usr/local/etc/asciidoc`) directory is searched.
 - Then it looks in the asciidoc(1) `./filters` directory.
 - Finally it relies on the executing shell to search the environment

examples/website/index.txt

 
 .{revdate}: AsciiDoc {revnumber} Released
 ************************************************************************
-In addition to Vim syntax highlighter improvements this release
-contains quite a few (fairly minor) improvements plus a few bug fixes.
-
-Although it does not involve anything new, it is now recommended that
-special sections be specified using the explicit section name syntax
-rather than special section titles (see  the 'Special section titles
-vs. explicit template names' sidebar in the AsciiDoc 'User Guide').
+This release contains a few improvements, a couple of bug fixes and
+documentation updates.
 
 Read the link:CHANGELOG.html[CHANGELOG] for a full list of all
 additions, changes and bug fixes. Changes are documented in the