# HG changeset patch
# User Matthew Wild <mwild1@gmail.com>
# Date 1307028590 -3600
# Node ID 4570d6616c99b5fc36318ab12d4598752b1f3189
# Parent  a3cc83281bb83021936c1d4520c28dd21b48edeb
Update docs and README for 1.1.1 release

diff -r a3cc83281bb8 -r 4570d6616c99 README
--- 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 $
diff -r a3cc83281bb8 -r 4570d6616c99 doc/us/index.html
--- 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>
diff -r a3cc83281bb8 -r 4570d6616c99 doc/us/manual.html
--- 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">
+&lt;!DOCTYPE root_elem PUBLIC "example"&gt;
+</pre>
+    </dd>
 </dl>
 
 <h4><a name="separator"></a>The separator character</h4>