Module Name:	pkgsrc
Committed By:	reed
Date:		Fri Nov 17 20:43:48 UTC 2006

Modified Files:
	pkgsrc/textproc/asciidoc: DESCR Makefile PLIST distinfo

Log Message:
Update to version 8.1.0.

Mention docbook and LaTeX in DESCRiption.

Add sourceforge to MASTER_SITES.

Add more directories to INSTALLATION_DIRS (maybe some are redundant).

Also install a2x.
Install man pages.
Install various configs and icons.

Add do-test target.

Following is from the AsciiDoc ChangeLog:

1. Version 8.1.0 (2006-10-22)

     * AsciiDoc generated XHTML documents now display as 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
       [1]tpl User Guide for a fancier layout. Use the -a toc -a numbered
       command-line options to produce a number table of contents.
     * A [2]music filter is included in the distribution ./filters/
       directory. It translates music in [3]LilyPond or [4]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 instrinsic attribute
       {docname} is extracted from the input file name.
     _________________________________________________________________

2. 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.

   [5]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 [6]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 [7]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 [8]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.


To generate a diff of this commit:
cvs rdiff -r1.1.1.1 -r1.2 pkgsrc/textproc/asciidoc/DESCR \
    pkgsrc/textproc/asciidoc/Makefile pkgsrc/textproc/asciidoc/PLIST \
    pkgsrc/textproc/asciidoc/distinfo

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.