FooBarWidget-mizuho 0.9.1 → 0.9.2

data/asciidoc/CHANGELOG.txt

@@ -1,17 +1,185 @@
 AsciiDoc ChangeLog
 ==================
 
-Version 8.2.7 (2008-07-04)
+:replacements.\bweb:: http://www.methods.co.nz/asciidoc/
+
+Version 8.3.1 (2008-12-14)
+--------------------------
+.Additions and changes
+- Replaced the `install.sh` script with Ben Walton's updated autoconf
+  scripts -- see web:INSTALL.html[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.
+
+
+Version 8.3.0 (2008-11-29)
 --------------------------
-See the http://hg.sharesource.org/asciidoc/shortlog[AsciiDoc Mercurial
-repository] for a full list of changes.
+.Additions and changes
+- web:newtables.html[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.
+- web:newlists.html[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' web:userguide.html#X77[passthrough
+  macros] along with 'asciimath' and 'latexmath'
+  web:userguide.html#X76[passthrough blocks] provide a (backend
+  dependent) mechanism for rendering mathematical formulas. There are
+  web:latexmath.pdf[LaTeX Math], web:asciimathml.html[AsciiMathML] and
+  web:latexmathml.html[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 pass:[$$...$$].
+- 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).
+
+
+[[X1]]
+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.
 
+
+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) which are used by a2x(1).
+  `./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
@@ -45,9 +213,9 @@ repository] for a full list of changes.
   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
+- Added a2x(1) `\--fop-opts=FOP_OPTS` option (patch submitted by Miklos
   Vajna).
-- Added a2x(1) `--dblatex-opts=DBLATEX_OPTS` option.
+- 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).
@@ -66,9 +234,6 @@ repository changelog].
 
 Version 8.2.6 (2008-04-29)
 --------------------------
-See the http://hg.sharesource.org/asciidoc/shortlog[AsciiDoc Mercurial
-repository] for a full list of changes.
-
 .Additions and changes
 - Enhancements to the Vim AsciiDoc syntax highlighter, for example,
   quoted text is now highlighted in titles and macro captions.
@@ -1023,10 +1188,10 @@ Version 5.0.6 (2004-03-07)
 - A replacement has been added to `asciidoc.conf` to replace inline
   double dashes with the `&mdash;` entity.
 - Changed the `.UNDER-CONSTRUCTION.` macro syntax to
-  `\#UNDER-CONSTRUCTION#` so it is not mistaken for a BlockTitle.
+  `#UNDER-CONSTRUCTION#` so it is not mistaken for a BlockTitle.
   Similarly changed the `.NEW.` replacement with
-  `{amp}\#35;NEW{amp}#35;`.
-- `{amp}\#35;NEW{amp}#35;` and `\#UNDER-CONSTRUCTION#` macros are now
+  `&#35;NEW&#35;`.
+- `&#35;NEW&#35;` and `#UNDER-CONSTRUCTION#` macros are now
   included in the DocBook backend.
 - Replaced shipped `smallnew.gif` with `smallnew.png`.
 - Documentation tidy ups.

data/asciidoc/INSTALL

@@ -1,6 +1,6 @@
                              AsciiDoc Installation
 
-   version 8.2.7, 4 July 2008
+   version 8.3.1, 14 December 2008
 
    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
@@ -20,42 +20,38 @@
 
 2. Distribution tarball installation
 
-   If your flavor or UNIX or Linux is not supported or you prefer to
-   install from source use the install.sh shell script in the tarball root
-   directory (thanks to [5]Jacob Mandelson for the initial implementation
-   of this script).
-
-   install.sh installs AsciiDoc executables, configuration files and man
-   pages in the usual locations. Here's how:
-
-     $ tar -xzf asciidoc-8.2.7.tar.gz
-     $ cd asciidoc-8.2.7
-     $ sudo ./install.sh
-
-   Note: This script was tested on Ubuntu Linux. You may need to edit
-   install.sh if your file locations differ from those wired into the
-   script.
-
-   The uninstall.sh script (actually just a symlink to install.sh) will
-   uninstall AsciiDoc.
-
-   If Vim is installed on your system install.sh will install the Vim
-   syntax highlighter and filetype detection scripts in the global
-   /etc/vim directory (asciidoc.vim in /etc/vim/syntax/ and
-   asciidoc_filetype.vim in /etc/vim/ftdetect/).
-
-   To install locally put asciidoc.vim in ~/.vim/syntax/ and
-   asciidoc_filetype.vim in ~/.vim/ftdetect/.
+   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
+   directory.
+
+   The autoconf(1) generated configure script creates a make file that is
+   tailored for your system. To install:
+  $ tar -xzf asciidoc-8.3.1.tar.gz
+  $ cd asciidoc-8.3.1
+  $ ./configure
+  $ make
+  $ sudo make install
+
+   To install the documentation:
+  $ sudo make docs
+
+   To uninstall AsciiDoc:
+  $ sudo make uninstall
+
+   If Vim is installed on your system the AsciiDoc Vim syntax highlighter
+   and filetype detection scripts will be install in the global Vim
+   configuration file directory (asciidoc.vim in the syntax directory and
+   asciidoc_filetype.vim in the ftdetect directory).
      __________________________________________________________________
 
 3. Microsoft Windows installation
 
    To install the zip formatted distribution just unzip the contents to a
    new folder:
-
-     $ mkdir asciidoc
-     $ cd asciidoc
-     $ unzip ../asciidoc-8.2.7.zip
+  $ mkdir asciidoc
+  $ cd asciidoc
+  $ unzip ../asciidoc-8.3.1.zip
      __________________________________________________________________
 
 4. Testing your installation
@@ -63,15 +59,14 @@
    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
+  $ asciidoc doc/asciidoc.txt
 
    Note: Windows users will need to execute the asciidoc.py script
    directly or create a suitable asciidoc.bat file.
      __________________________________________________________________
 
-   Version 8.2.7
-   Last updated 2008-07-04 23:26:27 NZDT
+   Version 8.3.1
+   Last updated 2008-12-13 10:52:07 NZDT
 
 References
 
@@ -79,4 +74,3 @@ References
    2. http://www.methods.co.nz/asciidoc/downloads.html
    3. http://sourceforge.net/projects/asciidoc/
    4. http://www.methods.co.nz/asciidoc/downloads.html
-   5. mailto:jlm@ofb.net

data/asciidoc/INSTALL.txt

@@ -19,33 +19,33 @@ lists AsciiDoc packages for various Linux distributions.
 
 Distribution tarball installation
 ---------------------------------
-If your flavor or UNIX or Linux is not supported or you prefer to
-install from source use the `install.sh` shell script in the tarball
-root directory (thanks to mailto:jlm@ofb.net[Jacob Mandelson] for the
-initial implementation of this script).
+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
+directory.
 
-`install.sh` installs AsciiDoc executables, configuration files and
-man pages in the usual locations. Here's how:
+The `autoconf(1)` generated `configure` script creates a make file
+that is tailored for your system. To install:
 
-[subs="normal"]
+[subs="attributes"]
   $ tar -xzf asciidoc-{revision}.tar.gz
   $ cd asciidoc-{revision}
-  $ sudo ./install.sh
+  $ ./configure
+  $ make
+  $ sudo make install
 
-NOTE: This script was tested on Ubuntu Linux.  You may need to edit
-`install.sh` if your file locations differ from those wired into the
-script.
+To install the documentation:
 
-The `uninstall.sh` script (actually just a symlink to `install.sh`)
-will uninstall AsciiDoc.
+  $ sudo make docs
 
-If Vim is installed on your system `install.sh` will install the Vim
-syntax highlighter and filetype detection scripts in the global
-`/etc/vim` directory (`asciidoc.vim` in `/etc/vim/syntax/` and
-`asciidoc_filetype.vim` in `/etc/vim/ftdetect/`).
+To uninstall AsciiDoc:
 
-To install locally put `asciidoc.vim` in `\~/.vim/syntax/` and
-`asciidoc_filetype.vim` in `~/.vim/ftdetect/`.
+  $ sudo make uninstall
+
+If Vim is installed on your system the AsciiDoc Vim syntax highlighter
+and filetype detection scripts will be install in the global Vim
+configuration file directory (`asciidoc.vim` in the `syntax` directory
+and `asciidoc_filetype.vim` in the `ftdetect` directory).
 
 
 Microsoft Windows installation
@@ -53,7 +53,7 @@ Microsoft Windows installation
 To install the zip formatted distribution just unzip the contents to a
 new folder:
 
-[subs="normal"]
+[subs="attributes"]
   $ mkdir asciidoc
   $ cd asciidoc
   $ unzip ../asciidoc-{revision}.zip

data/asciidoc/Makefile.in

@@ -0,0 +1,145 @@
+#
+# Make file to install/uninstall AsciiDoc
+#
+
+INSTALL = @INSTALL@
+INSTALL_PROG = @INSTALL_PROGRAM@
+INSTALL_DATA = @INSTALL_DATA@
+
+SED = @SED@
+
+prefix = @prefix@
+exec_prefix = @exec_prefix@
+bindir = @bindir@
+datadir = @datadir@
+sysconfdir = @sysconfdir@
+datarootdir = @datarootdir@
+mandir=@mandir@
+srcdir = @srcdir@
+
+VPATH = @srcdir@
+
+ASCIIDOCCONF = $(sysconfdir)/asciidoc
+
+prog = asciidoc.py a2x
+progdir = $(bindir)
+
+vimdir = @sysconfdir@/vim
+
+manp = $(wildcard doc/*.1)
+manpdir = $(mandir)/man1
+
+conf = $(wildcard *.conf)
+confdir = $(ASCIIDOCCONF)
+
+filters = $(wildcard filters/*.py)
+filtersdir = $(ASCIIDOCCONF)/filters
+
+filterconfs = $(wildcard filters/*.conf)
+filterconfsdir = $(ASCIIDOCCONF)/filters
+
+docbook = $(wildcard docbook-xsl/*.xsl)
+docbookdir = $(ASCIIDOCCONF)/docbook-xsl
+
+dblatex = $(wildcard dblatex/*.xsl) $(wildcard dblatex/*.sty)
+dblatexdir = $(ASCIIDOCCONF)/dblatex
+
+css = $(wildcard stylesheets/*.css)
+cssdir = $(ASCIIDOCCONF)/stylesheets
+
+js = $(wildcard javascripts/*.js)
+jsdir = $(ASCIIDOCCONF)/javascripts
+
+callouts = $(wildcard images/icons/callouts/*)
+calloutsdir = $(ASCIIDOCCONF)/images/icons/callouts
+
+icons = $(wildcard images/icons/*.png) images/icons/README
+iconsdir = $(ASCIIDOCCONF)/images/icons
+
+doc = $(wildcard README*) $(wildcard BUGS*) $(wildcard INSTALL*) $(wildcard CHANGELOG*)
+docdir = $(datadir)/doc/asciidoc
+
+DATATARGETS = manp conf filterconfs docbook dblatex css js callouts icons
+PROGTARGETS = prog filters
+TARGETS = $(DATATARGETS) $(PROGTARGETS) doc
+
+INSTDIRS = $(TARGETS:%=%dir)
+
+.PHONY: $(TARGETS)
+
+all: build
+
+# create directories used during the install
+$(INSTDIRS):
+	$(INSTALL) -d $(DESTDIR)/$($@)
+
+$(PROGTARGETS): % : %dir
+	$(INSTALL_PROG) $($@) $(DESTDIR)/$($<)/
+
+$(DATATARGETS): % : %dir
+	$(INSTALL_DATA) $($@) $(DESTDIR)/$($<)/
+
+docs:
+	$(INSTALL) -d $(DESTDIR)/$(docdir)
+	$(INSTALL_DATA) $(doc) $(DESTDIR)/$(docdir)
+	$(INSTALL) -d $(DESTDIR)/$(docdir)/docbook-xsl
+	$(INSTALL_DATA) docbook-xsl/asciidoc-docbook-xsl.txt $(DESTDIR)/$(docdir)/docbook-xsl
+	$(INSTALL) -d $(DESTDIR)/$(docdir)/dblatex
+	$(INSTALL_DATA) dblatex/dblatex-readme.txt $(DESTDIR)/$(docdir)/dblatex
+	$(INSTALL) -d $(DESTDIR)/$(docdir)/stylesheets
+	$(INSTALL_DATA) $(css) $(DESTDIR)/$(docdir)/stylesheets
+	$(INSTALL) -d $(DESTDIR)/$(docdir)/javascripts
+	$(INSTALL_DATA) $(js) $(DESTDIR)/$(docdir)/javascripts
+	$(INSTALL) -d $(DESTDIR)/$(docdir)/images
+	( cd images && \
+		cp -R * $(DESTDIR)/$(docdir)/images )
+	$(INSTALL) -d $(DESTDIR)/$(docdir)/doc
+	( cd doc && \
+		cp -R * $(DESTDIR)/$(docdir)/doc )
+	$(INSTALL) -d $(DESTDIR)/$(docdir)/examples/website
+	( cd examples/website && \
+		cp -R * $(DESTDIR)/$(docdir)/examples/website )
+
+renameprog:
+	(cd $(DESTDIR)/$(progdir); mv asciidoc.py asciidoc)
+
+fixconfpath:
+	@for f in $(prog); do \
+		echo "Fixing CONF_DIR in $$f"; \
+		$(SED) "s#^CONF_DIR = '.*'#CONF_DIR = '$(ASCIIDOCCONF)'#; s#^CONF_DIR=.*#CONF_DIR=$(ASCIIDOCCONF)#" $$f > $$f.out; \
+		mv $$f.out $$f; \
+	done
+
+install-vim:
+	@for d in $(DESTDIR)/$(vimdir) /etc/vim; do \
+		if ! test -d $$d; then continue; fi ; \
+		echo "installing Vim files in $$d" ; \
+		$(INSTALL) -d $$d/syntax ; \
+		$(INSTALL_DATA) vim/syntax/asciidoc.vim $$d/syntax ; \
+		$(INSTALL) -d $$d/ftdetect ; \
+		$(INSTALL_DATA) vim/ftdetect/asciidoc_filetype.vim $$d/ftdetect ; \
+	done
+
+uninstall-vim:
+	@for d in $(DESTDIR)/$(vimdir) /etc/vim; do \
+		if ! test -d $$d; then continue; fi ; \
+		echo "uninstalling Vim files in $$d" ; \
+		rm -f $$d/syntax/asciidoc.vim ; \
+		rm -f $$d/ftdetect/asciidoc_filetype.vim ; \
+	done
+
+
+build: fixconfpath
+
+install: $(PROGTARGETS) $(DATATARGETS) renameprog install-vim
+
+uninstall: uninstall-vim
+	rm -f $(DESTDIR)/$(progdir)/asciidoc
+	rm -f $(DESTDIR)/$(progdir)/a2x
+	rm -f $(DESTDIR)/$(mandir)/asciidoc.1
+	rm -f $(DESTDIR)/$(mandir)/a2x.1
+	rm -rf $(DESTDIR)/$(confdir)
+	rm -rf $(DESTDIR)/$(docdir)
+
+test:
+	@echo "Nothing to see here...Move along."