diff options
-rw-r--r-- | CHANGELOG.txt | 13 | ||||
-rw-r--r-- | INSTALL.txt | 34 | ||||
-rw-r--r-- | common.aap | 2 | ||||
-rw-r--r-- | doc/asciidoc.dict | 40 | ||||
-rw-r--r-- | examples/website/asciidoc-website.dict | 3 | ||||
-rw-r--r-- | examples/website/downloads.txt | 27 | ||||
-rw-r--r-- | examples/website/index.txt | 24 |
7 files changed, 78 insertions, 65 deletions
diff --git a/CHANGELOG.txt b/CHANGELOG.txt index 67a156a..a88b610 100644 --- a/CHANGELOG.txt +++ b/CHANGELOG.txt @@ -3,6 +3,19 @@ AsciiDoc ChangeLog :replacements.\bweb:: http://www.methods.co.nz/asciidoc/
+Version 8.4.2 (2009-03-19)
+--------------------------
+.Additions and changes
+- Added web:testasciidoc.html[testasciidoc], a tool to verify AsciiDoc
+ conformance.
+- A warning is issued if nested inline passthroughs are encountered.
+- 'asciidocapi': setting an attribute value to `None` will undefine
+ (delete) the attribute (this in addition to the `name!` attribute
+ name format that the `asciidoc(1)` command uses).
+
+.Bug fixes
+
+
Version 8.4.1 (2009-03-10)
--------------------------
.Additions and changes
diff --git a/INSTALL.txt b/INSTALL.txt index 730caae..9255681 100644 --- a/INSTALL.txt +++ b/INSTALL.txt @@ -48,6 +48,34 @@ configuration file directory (`asciidoc.vim` in the `syntax` directory and `asciidoc_filetype.vim` in the `ftdetect` directory). +Installing from the Mercurial repository +---------------------------------------- +This is an easy way to install AsciiDoc 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 {revision} tagged release: + +[subs="attributes"] + $ cd ~/bin + $ hg clone -r {revision} http://hg.sharesource.org/asciidoc asciidoc-{revision} + +- 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-{revision}/asciidoc.py ~/bin/asciidoc + +Use the Mercurial `pull` command to update your AsciiDoc repository. + + Microsoft Windows installation ------------------------------ To install the zip formatted distribution just unzip the contents to a @@ -65,7 +93,7 @@ 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 -NOTE: Windows users will need to execute the `asciidoc.py` script -directly or create a suitable `asciidoc.bat` file. +link:testasciidoc.html[testasciidoc] offers a more extensive set of +conformance tests. @@ -3,7 +3,7 @@ # _parent.VERS = 8.4.2 -_parent.DATE = ?? March 2009 +_parent.DATE = 19 March 2009 all: :pass diff --git a/doc/asciidoc.dict b/doc/asciidoc.dict index a2afef9..b147f06 100644 --- a/doc/asciidoc.dict +++ b/doc/asciidoc.dict @@ -1,7 +1,7 @@ personal_ws-1.1 en 768 Sturmer -Kléber Kleber +Kléber quis tuples auctor @@ -14,8 +14,8 @@ callouts API bulleted starttags -ListingBlock listingblock +ListingBlock eval ListLabel asc @@ -101,8 +101,8 @@ pageunits LaTeX citetitle emphasizedwords -blocktitle BlockTitle +blocktitle DTD CVS valign @@ -123,17 +123,17 @@ CommentBlocks lowerroman gif Builtin +datadir optionname tabledef -datadir manpurpose dignissim luptatum TitleBlock fmt subscripted -middlename MiddleName +middlename subdirectories footnoteref passtext @@ -154,8 +154,8 @@ entrytbl Ghostscript verear Buenos -LinuxDoc linuxdoc +LinuxDoc PostScript hhp Vijay @@ -171,8 +171,8 @@ GPL hsides upperalpha docfile -Bólido Bolido +Bólido footrow misspelt WINNT @@ -184,8 +184,8 @@ bloggs hoc LiteralParagraphs primis -verbatimblock VerbatimBlock +verbatimblock corpname shiftwidth misevaluations @@ -402,8 +402,8 @@ pre coid params mediaobjects -JavaScripts javascripts +JavaScripts sgmlfmt subsnormal unchunked @@ -475,13 +475,13 @@ arabic fringilla retab BackendBlocks -ChangeLog changelog +ChangeLog tis Ubuntu sectids -asciidocapi AsciiDocAPI +asciidocapi Sommer LabeledList ZapfDingbats @@ -499,8 +499,8 @@ crlf vel Iisaka's localtime -BlockMacro blockmacro +BlockMacro Xandros groff POSIX @@ -545,8 +545,8 @@ dbtimestamp txt BlockId passthrough -Berguvsvägen Berguvsvagen +Berguvsvägen noincsearch TableRow inlinemediaobject @@ -596,9 +596,9 @@ Redhat cb tuple cd -asciimathml -AsciiMathML ASCIIMathML +AsciiMathML +asciimathml arounds filename mansource @@ -614,8 +614,8 @@ scaledwidth cp xsl fb -DocBook docbook +DocBook stylesheet pagefile superscripted @@ -636,8 +636,8 @@ fprintf colabswidth tabsize smallnew -BlockTitles blocktitles +BlockTitles localdate bodyrow hs @@ -688,8 +688,8 @@ permalink td py AROUT -literalblock LiteralBlock +literalblock sgml biggy softtabstop @@ -705,8 +705,8 @@ tt blandit inline Martín -SectionBody sectionbody +SectionBody VM conformant listchars @@ -752,8 +752,8 @@ nbsp qanda noout massa -AsciiDoc asciidoc +AsciiDoc manmanual TableBody realpath diff --git a/examples/website/asciidoc-website.dict b/examples/website/asciidoc-website.dict index 18d673e..28793a7 100644 --- a/examples/website/asciidoc-website.dict +++ b/examples/website/asciidoc-website.dict @@ -1,4 +1,4 @@ -personal_ws-1.1 en 170 +personal_ws-1.1 en 171 backends Backtick AsciiDoc's @@ -63,6 +63,7 @@ latexmathml LaTeXMathML LaTexMathML outlang +testasciidoc Efros roff repo diff --git a/examples/website/downloads.txt b/examples/website/downloads.txt index 4549408..b5e6904 100644 --- a/examples/website/downloads.txt +++ b/examples/website/downloads.txt @@ -31,33 +31,6 @@ Mercurial friendly website for hosting Open Source projects. To browse the repo go to http://hg.sharesource.org/asciidoc/.
-Installing from the repository
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-This is an easy way to install AsciiDoc 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 {revision} tagged release:
-
-[subs="attributes"]
- $ cd ~/bin
- $ hg clone -r {revision} http://hg.sharesource.org/asciidoc asciidoc-{revision}
-
-- 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-{revision}/asciidoc.py ~/bin/asciidoc
-
-Use the Mercurial `pull` command to update your AsciiDoc repository.
-
[[X1]]
Prepackaged Versions
diff --git a/examples/website/index.txt b/examples/website/index.txt index 72d9faf..3091121 100644 --- a/examples/website/index.txt +++ b/examples/website/index.txt @@ -3,19 +3,17 @@ AsciiDoc Home Page .{date}: AsciiDoc {revision} Released
************************************************************************
-Additions and change in this release include:
-
-- AsciiDoc now has a link:asciidocapi.html[Python API], use it to
- process AsciiDoc source directly from your Python applications.
-- Backtick quoting for monospaced text is now implemented as an
- 'inline literal' passthrough. This makes more sense since monospace
- text is usually intended to be rendered literally. This change may
- raise link:CHANGELOG.html#X2[regression issues] in existing
- documents.
-
-There are a number of smaller additions along with the usual
-documentation polishing. Read the link:CHANGELOG.html[CHANGELOG] for
-a full list of all additions and changes.
+When modifying AsciiDoc configuration files or source code it's very
+easy to introduce regression errors. This release includes
+link:testasciidoc.html[testasciidoc], a tool for writing many and
+varied test cases that can be run after changes have been made in
+order to verify that existing behavior has not been broken. I wrote
+'testasciidoc' after very nearly making a couple of serious regression
+bloopers with the last release.
+
+There's nothing much else in this release apart from a couple of minor
+additions, read the link:CHANGELOG.html[CHANGELOG] for a full list of
+all additions and changes.
mailto:srackham@gmail.com['Stuart Rackham']
************************************************************************
|