Thu, 02 Jun 2011 16:29:50 +0100
Update docs and README for 1.1.1 release
README | file | annotate | diff | comparison | revisions | |
doc/us/index.html | file | annotate | diff | comparison | revisions | |
doc/us/manual.html | file | annotate | diff | comparison | revisions |
--- a/README Thu Jun 02 16:27:59 2011 +0100 +++ b/README Thu Jun 02 16:29:50 2011 +0100 @@ -8,7 +8,7 @@ Status -Current version is 1.1.0. It was developed for both Lua 5.0 and Lua 5.1, +Current version is 1.1.1. It was developed for both Lua 5.0 and Lua 5.1, and has been tested on Linux, Windows (2000/XP) and MacOS X with Expat 2.0.0. Download @@ -18,6 +18,11 @@ History +Version 1.1.1 [02/Jun/2011] + + * support for the StartDoctypeDecl handler + * add parser:stop() to abort parsing inside a callback + Version 1.1.0 [05/Jun/2006] * adapted to work on both Lua 5.0 and Lua 5.1 @@ -52,5 +57,3 @@ For more information please contact us (info at keplerproject dot org). Comments are welcome! You can also reach other Kepler developers and users on the Kepler Project mailing list. - -$Id: README,v 1.2 2007/06/05 20:03:12 carregal Exp $
--- a/doc/us/index.html Thu Jun 02 16:27:59 2011 +0100 +++ b/doc/us/index.html Thu Jun 02 16:29:50 2011 +0100 @@ -66,7 +66,7 @@ <h2><a name="status"></a>Status</h2> -<p>Current version is 1.1.0. It was developed for both Lua 5.0 and Lua 5.1, and has been tested on +<p>Current version is 1.1.1. It was developed for both Lua 5.0 and Lua 5.1, and has been tested on Linux, Windows (2000/XP) and MacOS X with Expat 2.0.0.</p> <h2><a name="download"></a>Download</h2> @@ -79,6 +79,14 @@ <h2><a name="history"></a>History</h2> <dl class="history"> + <dt><strong>Version 1.1.1</strong> [02/Jun/2011]</dt> + <dd> + <ul> + <li>support for the StartDoctypeDecl handler</li> + <li>add parser:stop() to abort parsing inside a callback</li> + </ul> + </dd> + <dt><strong>Version 1.1.0</strong> [05/Jun/2007]</dt> <dd> <ul>
--- a/doc/us/manual.html Thu Jun 02 16:27:59 2011 +0100 +++ b/doc/us/manual.html Thu Jun 02 16:29:50 2011 +0100 @@ -175,6 +175,13 @@ <dd>Set the encoding to be used by the parser. There are four built-in encodings, passed as strings: "US-ASCII", "UTF-8", "UTF-16", and "ISO-8859-1".</dd> + + <dt><strong>parser:stop()</strong></dt> + <dd>Abort the parser and prevent it from parsing any further + through the data it was last passed. Use to halt parsing the + document when an error is discovered inside a callback, for + example. The parser object cannot accept more data after + this call.</dd> </dl> <h4>Callbacks</h4> @@ -198,7 +205,8 @@ <em>ExternalEntityRef</em>, <em>NotStandalone</em>, <em>NotationDecl</em>, <em>ProcessingInstruction</em>, <em>StartCDataSection</em>, <em>StartElement</em>, -<em>StartNamespaceDecl</em>, and <em>UnparsedEntityDecl</em>.</p> +<em>StartNamespaceDecl</em>, <em>UnparsedEntityDecl</em> +and <em>StartDoctypeDecl</em>.</p> <p>These indices can be references to functions with specific signatures, as seen below. The parser constructor also @@ -337,6 +345,15 @@ For this example the <em>publicId</em> parameter would be nil. The <em>base</em> parameter would be whatever has been set with <code>parser:setbase</code>. If not set, it would be nil.</dd> + + <dt><strong>callbacks.StartDoctypeDecl = function(parser, name, sysid, pubid, has_internal_subset)</strong></dt> + <dd>Called when the <em>parser</em> detects the beginning of an XML + DTD (DOCTYPE) section. These precede the XML root element and take + the form: +<pre class="example"> +<!DOCTYPE root_elem PUBLIC "example"> +</pre> + </dd> </dl> <h4><a name="separator"></a>The separator character</h4>