mizuho 0.9.6 → 0.9.8

data/asciidoc/COPYRIGHT

@@ -1,18 +1,18 @@
-Copyright (C) 2000-2007 Stuart Rackham
-
-Email: srackham@gmail.com
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or (at
-your option) any later version.
-
-This program is distributed in the hope that it will be useful, but
-WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program; if not, write to the Free Software
-Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,
-USA.
+Copyright (C) 2000-2007 Stuart Rackham
+
+Email: srackham@gmail.com
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or (at
+your option) any later version.
+
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,
+USA.

data/asciidoc/INSTALL

@@ -1,24 +1,71 @@
                              AsciiDoc Installation
 
-   version 8.3.3, 2 January 2009
+   version 8.6.5, 20 May 2011
 
-   Note: The current version of AsciiDoc requires Python 2.4 or newer to
-   run. If you don't already have an up-to-date version of Python
-   installed it can be downloaded from the official Python website
-   [1]http://www.python.org/.
+   Note
+       The current version of AsciiDoc requires Python 2.4 or newer to run. If
+       you don’t already have an up-to-date version of Python installed it can
+       be downloaded from the official Python website
+       [1]http://www.python.org/.
+     __________________________________________________________________
+
+1. Prerequisites
 
-   The latest AsciiDoc downloads can be found on the AsciiDoc website
-   [2]http://www.methods.co.nz/asciidoc/downloads.html and at the
-   SourceForge [3]http://sourceforge.net/projects/asciidoc/.
+   See the [2]README page.
      __________________________________________________________________
 
-1. Prepackaged AsciiDoc installation
+2. Installing from the Mercurial repository
+
+   The AsciiDoc [3]Mercurial repository is hosted by [4]Google Code. To
+   browse the repository go to
+   [5]http://code.google.com/p/asciidoc/source/browse/. You can install
+   AsciiDoc from the repository if you don’t have an up to date packaged
+   version or want to get the latest version from the trunk:
+     * Make sure you have [6]Mercurial installed, you can check with:
+  $ hg --version
+     * Go to the directory you want to install AsciiDoc into and download
+       the repository. This example gets the 8.6.5 tagged release:
+  $ cd ~/bin
+  $ hg clone -r 8.6.5 https://asciidoc.googlecode.com/hg/ asciidoc-8.6.5
+
+   You now have two choices: you can run asciidoc locally from your
+   repository or you can use autoconf(1) and make(1) to perform a
+   system-wide install.
+
+  2.1. Running asciidoc from your local copy
+
+   Create a symlink to the AsciiDoc script in a search PATH directory so
+   it’s easy to execute asciidoc from the command-line, for example:
+  $ ln -s ~/bin/asciidoc-8.6.5/asciidoc.py ~/bin/asciidoc
+  $ ln -s ~/bin/asciidoc-8.6.5/a2x.py ~/bin/a2x
+
+   Use the Mercurial pull command to update your local AsciiDoc
+   repository.
+
+  2.2. Installing asciidoc for all users
+
+   Create configure using autoconf(1); use configure to create the
+   Makefile; run make(1); build the man pages; install:
+
+     $ autoconf
+     $ ./configure
+     $ make
+     $ sudo make install
 
-   The AsciiDoc [4]downloads page lists AsciiDoc packages for various
-   Linux distributions.
+   To uninstall:
+
+     $ sudo make uninstall
      __________________________________________________________________
 
-2. Distribution tarball installation
+3. Distribution tarball installation
+
+   The distribution source tarballs can be downloaded from the SourceForge
+   [7]http://sourceforge.net/projects/asciidoc/.
+
+   Note
+       Unless you are [8]installing on Microsoft Windows you should use the
+       tarball and not the zip file to install the the distribution (the
+       tarball contains symlinks).
 
    If your flavor or UNIX or Linux does not have a packaged AsciiDoc
    distribution or if you prefer to install the latest AsciiDoc version
@@ -27,10 +74,9 @@
 
    The autoconf(1) generated configure script creates a make file that is
    tailored for your system. To install:
-  $ tar -xzf asciidoc-8.3.3.tar.gz
-  $ cd asciidoc-8.3.3
+  $ tar -xzf asciidoc-8.6.5.tar.gz
+  $ cd asciidoc-8.6.5
   $ ./configure
-  $ make
   $ sudo make install
 
    To install the documentation:
@@ -45,32 +91,145 @@
    asciidoc_filetype.vim in the ftdetect directory).
      __________________________________________________________________
 
-3. Microsoft Windows installation
+4. Microsoft Windows installation
+
+   AsciiDoc is developed and tested on Linux but there seem to be quite a
+   few people using it on Windows. To install AsciiDoc on Windows unzip
+   the distribution Zip file contents:
+  $ unzip asciidoc-8.6.5.zip
+
+   This will create the folder asciidoc-8.6.5 containing the asciidoc.py
+   and a2x.py executables along with configuration files and
+   documentation.
 
-   To install the zip formatted distribution just unzip the contents to a
-   new folder:
-  $ mkdir asciidoc
-  $ cd asciidoc
-  $ unzip ../asciidoc-8.3.3.zip
+   To generate DocBook based outputs (e.g. PDFs) you will also need a
+   working DocBook toolchain. Installing and configuring a DocBook
+   toolchain on Windows can be a challenge — this blog post explains
+   [9]How to Create Handsome PDF Documents Without Frustration using
+   [10]Cygwin, [11]dblatex and AsciiDoc.
      __________________________________________________________________
 
-4. Testing your installation
+5. Testing your installation
 
    Test out asciidoc by changing to the AsciiDoc application directory and
    convert the User Guide document (./doc/asciidoc.txt) to XHTML
    (./doc/asciidoc.html):
-  $ asciidoc doc/asciidoc.txt
+  $ python asciidoc.py doc/asciidoc.txt
+
+   [12]testasciidoc offers a more extensive set of conformance tests,
+   though you do need to create the test data before running the tests
+   (this in itself is a good post-install test):
+  $ python ./tests/testasciidoc.py update
+
+   Now you can run the tests by executing this command:
+  $ python ./tests/testasciidoc.py run
+
+   A full battery of tests can be run from the main.aap script in the
+   distribution root directory:
+  $ aap test
+     __________________________________________________________________
+
+6. Building the distribution
+
+   The AsciiDoc distribution is built using [13]A-A-P (a software build
+   system written by Bram Moolenaar). The AsciiDoc A-A-P scripts are:
+
+   ./main.aap
+          Builds the distribution tarball and zip files, documentation and
+          example website.
+
+   ./doc/main.aap
+          Builds distribution documentation.
+
+   ./examples/website/main.aap
+          Builds AsciiDoc website.
+
+   ./common.aap
+          Included in all scripts.
+
+   To build the distribution tarball and zip files, documentation and
+   example website run A-A-P from the distribution root directory:
+  $ aap
+     __________________________________________________________________
+
+7. Prepackaged AsciiDoc installation
+
+   The following platform specific AsciiDoc packages are available:
+
+   Debian GNU/Linux
+          If you use Debian or a Debian based distribution there’s an
+          [14]AsciiDoc Debian package available. Thanks to [15]Fredrik
+          Steen who built and maintains the Debian AsciiDoc package.
+
+   Gentoo Linux
+          If you use Gentoo Linux there’s a [16]Gentoo AsciiDoc package
+          available. Thanks to [17]Brandon Philips for writing the ebuild.
+
+   Fedora Linux
+          With help from Terje Røsten, Chris Wright added asciidoc to
+          Fedora Extras which is available in the default installation. To
+          install asciidoc execute the following command:
+
+  $ yum install asciidoc
+
+   Slackware Linux
+          John Calixto has created a Slackware package for AsciiDoc which
+          can be downloaded from [18]http://linuxpackages.net/.
+
+   Ark Linux
+          [19]Bernhard Rosenkraenzer added AsciiDoc to Ark Linux — the
+          package is available from the Ark Linux repository at
+          [20]http://arklinux.osuosl.org/dockyard-devel/, so Ark Linux
+          users should just run apt-get install asciidoc.
+
+   T2 Linux
+          [21]Christian Wiese added AsciiDoc to the [22]T2 Linux
+          repository at
+          [23]http://svn.exactcode.de/t2/trunk/package/textproc/asciidoc/.
+          To build and install the package on a T2 system, run
+          ./scripts/Emerge-Pkg asciidoc from within your T2 source
+          directory (default: /usr/src/t2-src).
+
+   Red Hat Enterprise Linux, Fedora and CentOS packages
+          Dag Wieers has built AsciiDoc RPMs for a number of Red Hat based
+          distributions, they can be downloaded from
+          [24]http://dag.wieers.com/rpm/packages/asciidoc/.
+
+   CSW Package for Sun Solaris
+          Ben Walton has created a CSW package for AsciiDoc, you can find
+          it here: [25]http://opencsw.org/packages/asciidoc.
 
-   Note: Windows users will need to execute the asciidoc.py script
-   directly or create a suitable asciidoc.bat file.
+   See also [26]Packager Notes in the AsciiDoc User Guide.
      __________________________________________________________________
 
-   Version 8.3.3
-   Last updated 2009-01-02 12:45:19 NZDT
+   Version 8.6.5
+   Last updated 2010-11-15 08:44:54 NZDT
 
 References
 
    1. http://www.python.org/
-   2. http://www.methods.co.nz/asciidoc/downloads.html
-   3. http://sourceforge.net/projects/asciidoc/
-   4. http://www.methods.co.nz/asciidoc/downloads.html
+   2. file://localhost/tmp/lynxXXXXrHyhys/README.html
+   3. http://www.selenic.com/mercurial/
+   4. http://code.google.com/
+   5. http://code.google.com/p/asciidoc/source/browse/
+   6. http://www.selenic.com/mercurial/
+   7. http://sourceforge.net/projects/asciidoc/
+   8. file://localhost/tmp/lynxXXXXrHyhys/L3934-4626TMP.html#X3
+   9. http://blog.rainwebs.net/2010/02/25/how-to-create-handsome-pdf-documents-without-frustration/
+  10. http://www.cygwin.com/
+  11. http://dblatex.sourceforge.net/
+  12. file://localhost/tmp/lynxXXXXrHyhys/testasciidoc.html
+  13. http://www.a-a-p.org/
+  14. http://packages.debian.org/asciidoc
+  15. mailto:stone@debian.org
+  16. http://packages.gentoo.org/package/app-text/asciidoc
+  17. mailto:brandon@ifup.org
+  18. http://linuxpackages.net/
+  19. mailto:bero@arklinux.org
+  20. http://arklinux.osuosl.org/dockyard-devel/
+  21. mailto:cw@ixplanet.de
+  22. http://www.t2-project.org/
+  23. http://svn.exactcode.de/t2/trunk/package/textproc/asciidoc/
+  24. http://dag.wieers.com/rpm/packages/asciidoc/
+  25. http://opencsw.org/packages/asciidoc
+  26. file://localhost/tmp/lynxXXXXrHyhys/userguide.html#X38

data/asciidoc/INSTALL.txt

@@ -6,19 +6,77 @@ to run.  If you don't already have an up-to-date version of Python
 installed it can be downloaded from the official Python website
 http://www.python.org/.
 
-The latest AsciiDoc downloads can be found on the AsciiDoc website
-http://www.methods.co.nz/asciidoc/downloads.html and at the
-SourceForge http://sourceforge.net/projects/asciidoc/.
 
-Prepackaged AsciiDoc installation
----------------------------------
-The AsciiDoc
-http://www.methods.co.nz/asciidoc/downloads.html[downloads page]
-lists AsciiDoc packages for various Linux distributions.
+Prerequisites
+-------------
+See the link:README.html[README] page.
+
+
+Installing from the Mercurial repository
+----------------------------------------
+The AsciiDoc http://www.selenic.com/mercurial/[Mercurial] repository
+is hosted by http://code.google.com/[Google Code].
+To browse the repository go to
+http://code.google.com/p/asciidoc/source/browse/.
+You can install AsciiDoc from the repository if you don't have an up to
+date packaged version or want to get the latest version from the trunk:
+
+- Make sure you have http://www.selenic.com/mercurial/[Mercurial]
+  installed, you can check with:
+
+  $ hg --version
+
+- Go to the directory you want to install AsciiDoc into and download
+  the repository.  This example gets the {revnumber} tagged release:
+
+[subs="attributes"]
+  $ cd ~/bin
+  $ hg clone -r {revnumber} https://asciidoc.googlecode.com/hg/ asciidoc-{revnumber}
+
+You now have two choices: you can run asciidoc locally from your
+repository or you can use 'autoconf(1)' and 'make(1)' to perform a
+system-wide install.
 
+Running asciidoc from your local copy
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Create a symlink to the AsciiDoc script in a search `PATH` directory
+so it's easy to execute `asciidoc` from the command-line, for example:
 
+[subs="attributes"]
+  $ ln -s ~/bin/asciidoc-{revnumber}/asciidoc.py ~/bin/asciidoc
+  $ ln -s ~/bin/asciidoc-{revnumber}/a2x.py ~/bin/a2x
+
+Use the Mercurial `pull` command to update your local AsciiDoc repository.
+
+Installing asciidoc for all users
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Create `configure` using 'autoconf(1)'; use `configure` to create the
+`Makefile`; run 'make(1)'; build the man pages; install:
+
+---------------------------------------------
+$ autoconf
+$ ./configure
+$ make
+$ sudo make install
+---------------------------------------------
+
+To uninstall:
+
+---------------------------------------------
+$ sudo make uninstall
+---------------------------------------------
+
+
+[[X1]]
 Distribution tarball installation
 ---------------------------------
+The distribution source tarballs can be downloaded from the
+SourceForge http://sourceforge.net/projects/asciidoc/.
+
+NOTE: Unless you are <<X3,installing on Microsoft Windows>> you should
+use the tarball and not the zip file to install the the distribution
+(the tarball contains symlinks).
+
 If your flavor or UNIX or Linux does not have a packaged AsciiDoc
 distribution or if you prefer to install the latest AsciiDoc version
 from source use the `configure` shell script in the tarball root
@@ -28,10 +86,9 @@ The `autoconf(1)` generated `configure` script creates a make file
 that is tailored for your system. To install:
 
 [subs="attributes"]
-  $ tar -xzf asciidoc-{revision}.tar.gz
-  $ cd asciidoc-{revision}
+  $ tar -xzf asciidoc-{revnumber}.tar.gz
+  $ cd asciidoc-{revnumber}
   $ ./configure
-  $ make
   $ sudo make install
 
 To install the documentation:
@@ -48,15 +105,27 @@ configuration file directory (`asciidoc.vim` in the `syntax` directory
 and `asciidoc_filetype.vim` in the `ftdetect` directory).
 
 
+[[X3]]
 Microsoft Windows installation
 ------------------------------
-To install the zip formatted distribution just unzip the contents to a
-new folder:
+AsciiDoc is developed and tested on Linux but there seem to be quite a
+few people using it on Windows.  To install AsciiDoc on Windows unzip
+the distribution Zip file contents:
 
 [subs="attributes"]
-  $ mkdir asciidoc
-  $ cd asciidoc
-  $ unzip ../asciidoc-{revision}.zip
+  $ unzip asciidoc-{revnumber}.zip
+
+This will create the folder +asciidoc-{revnumber}+ containing the
+`asciidoc.py` and `a2x.py` executables along with configuration files
+and documentation.
+
+To generate DocBook based outputs (e.g. PDFs) you will also need a
+working DocBook toolchain. Installing and configuring a DocBook
+toolchain on Windows can be a challenge -- this blog post explains
+http://blog.rainwebs.net/2010/02/25/how-to-create-handsome-pdf-documents-without-frustration/[How
+to Create Handsome PDF Documents Without Frustration] using
+http://www.cygwin.com/[Cygwin],
+http://dblatex.sourceforge.net/[dblatex] and AsciiDoc.
 
 
 Testing your installation
@@ -65,7 +134,94 @@ Test out asciidoc by changing to the AsciiDoc application directory
 and convert the User Guide document (`./doc/asciidoc.txt`) to XHTML
 (`./doc/asciidoc.html`):
 
-  $ asciidoc doc/asciidoc.txt
+  $ python asciidoc.py doc/asciidoc.txt
+
+link:testasciidoc.html[testasciidoc] offers a more extensive set of
+conformance tests, though you do need to create the test data before
+running the tests (this in itself is a good post-install test):
+
+  $ python ./tests/testasciidoc.py update
+
+Now you can run the tests by executing this command:
+
+  $ python ./tests/testasciidoc.py run
+
+A full battery of tests can be run from the `main.aap` script in the
+distribution root directory:
+
+  $ aap test
+
+
+Building the distribution
+-------------------------
+The AsciiDoc distribution is built using http://www.a-a-p.org/[A-A-P]
+(a software build system written by Bram Moolenaar). The AsciiDoc
+A-A-P scripts are:
+
+`./main.aap`:: Builds the distribution tarball and zip files,
+documentation and example website.
+`./doc/main.aap`:: Builds distribution documentation.
+`./examples/website/main.aap`:: Builds AsciiDoc website.
+`./common.aap`:: Included in all scripts.
+
+To build the distribution tarball and zip files, documentation and
+example website run A-A-P from the distribution root directory:
+
+  $ aap
+
+
+[[X2]]
+Prepackaged AsciiDoc installation
+---------------------------------
+The following platform specific AsciiDoc packages are available:
+
+*Debian GNU/Linux*::
+  If you use Debian or a Debian based distribution there's an
+  http://packages.debian.org/asciidoc[AsciiDoc Debian package]
+  available.  Thanks to mailto:stone@debian.org[Fredrik Steen] who
+  built and maintains the Debian AsciiDoc package.
+
+*Gentoo Linux*::
+  If you use Gentoo Linux there's a
+  http://packages.gentoo.org/package/app-text/asciidoc[Gentoo AsciiDoc
+  package] available. Thanks to mailto:brandon@ifup.org[Brandon
+  Philips] for writing the ebuild.
+
+*Fedora Linux*::
+  With help from Terje Røsten, Chris Wright added asciidoc to Fedora
+  Extras which is available in the default installation. To install
+  asciidoc execute the following command:
+
+  $ yum install asciidoc
+
+*Slackware Linux*::
+  John Calixto has created a Slackware package for AsciiDoc which can
+  be downloaded from http://linuxpackages.net/.
+
+*Ark Linux*::
+  mailto:bero@arklinux.org[Bernhard Rosenkraenzer] added AsciiDoc to
+  Ark Linux -- the package is available from the Ark Linux repository
+  at http://arklinux.osuosl.org/dockyard-devel/, so Ark Linux users
+  should just run `apt-get install asciidoc`.
+
+*T2 Linux*::
+  mailto:cw@ixplanet.de[Christian Wiese] added AsciiDoc to the
+  http://www.t2-project.org/[T2 Linux] repository at
+  http://svn.exactcode.de/t2/trunk/package/textproc/asciidoc/. To
+  build and install the package on a T2 system, run
+  `./scripts/Emerge-Pkg asciidoc` from within your T2 source directory
+  (default: `/usr/src/t2-src`).
+
+*Red Hat Enterprise Linux, Fedora and CentOS packages*::
+  Dag Wieers has built AsciiDoc RPMs for a number of Red Hat based
+  distributions, they can be downloaded from
+  http://dag.wieers.com/rpm/packages/asciidoc/.
+
+*CSW Package for Sun Solaris*::
+  Ben Walton has created a CSW package for AsciiDoc, you can find it
+  here: http://opencsw.org/packages/asciidoc.
+
+See also link:userguide.html#X38[Packager Notes] in the 'AsciiDoc User
+Guide'.
+
 
-NOTE: Windows users will need to execute the `asciidoc.py` script
-directly or create a suitable `asciidoc.bat` file.