Update of /project/cxml/cvsroot/cxml/doc
In directory clnet:/tmp/cvs-serv2817/doc
Modified Files:
html.xsl index.xml klacks.xml sax.xml
Log Message:
xml:base
--- /project/cxml/cvsroot/cxml/doc/html.xsl 2007/02/18 16:46:32 1.3
+++ /project/cxml/cvsroot/cxml/doc/html.xsl 2007/03/04 21:04:11 1.4
@@ -60,6 +60,7 @@
<li><a href="klacks.html#sources">Parsing incrementally</a></li>
<li><a href="klacks.html#convenience">Convenience functions</a></li>
<li><a href="klacks.html#klacksax">Bridging Klacks and SAX</a></li>
+ <li><a href="klacks.html#locator">Location information</a></li>
<li><a href="klacks.html#klacksax">Examples</a></li>
</ul>
</li>
--- /project/cxml/cvsroot/cxml/doc/index.xml 2007/03/04 18:30:41 1.3
+++ /project/cxml/cvsroot/cxml/doc/index.xml 2007/03/04 21:04:11 1.4
@@ -52,6 +52,9 @@
<h2>Recent Changes</h2>
<p class="nomargin"><tt>rel-2007-xx-yy</tt></p>
<ul class="nomargin">
+ <li>xml:base support (SAX and Klacks only, not yet used in DOM).
+ See documentation <a href="sax.html#saxparser">here</a> and <a
+ href="klacks.html#locator">here</a>.</li>
<li>Fixed attributes to carry an lname even without when occurring
without a namespace.</li>
<li>Klacks improvements: Incompatibly changed
--- /project/cxml/cvsroot/cxml/doc/klacks.xml 2007/03/04 18:30:41 1.7
+++ /project/cxml/cvsroot/cxml/doc/klacks.xml 2007/03/04 21:04:11 1.8
@@ -282,6 +282,29 @@
events to the SAX <tt>handler</tt>.
</p>
+ <a name="locator"/>
+ <h3>Location information</h3>
+ <p>
+ <div class="def">Function KLACKS:CURRENT-LINE-NUMBER (source)</div>
+ Return an approximation of the current line number, or NIL.
+ </p>
+ <p>
+ <div class="def">Function KLACKS:CURRENT-COLUMN-NUMBER (source)</div>
+ Return an approximation of the current column number, or NIL.
+ </p>
+ <p>
+ <div class="def">Function KLACKS:CURRENT-SYSTEM-ID (source)</div>
+ Return the URI of the document being parsed. This is either the
+ main document, or the entity's system ID while contents of a parsed
+ general external entity are being processed.
+ </p>
+ <p>
+ <div class="def">Function KLACKS:CURRENT-XML-BASE (source)</div>
+ Return the [Base URI] of the current element. This URI can differ from
+ the value returned by <tt>current-system-id</tt> if xml:base
+ attributes are present.
+ </p>
+
<a name="examples"/>
<h3>Examples</h3>
<p>
--- /project/cxml/cvsroot/cxml/doc/sax.xml 2007/02/18 12:35:50 1.1
+++ /project/cxml/cvsroot/cxml/doc/sax.xml 2007/03/04 21:04:11 1.2
@@ -476,6 +476,48 @@
<em>fixme:</em> thread-safety
</p>
+ <a name="saxparser"/>
+ <h3>Location information</h3>
+ <p>
+ <div class="def">Class SAX:SAX-PARSER ()</div>
+ A class providing location information through an
+ implementation-specific subclass. Parsers will use
+ <tt>sax:register-sax-parser</tt> to pass their parser instance to
+ the handler. The easiest way to receive sax parsers instances is
+ to inherit from sax-parser-mixin when defining a sax handler.
+ </p>
+ <p>
+ <div class="def">Class SAX:SAX-PARSER-MIXIN ()</div>
+ A mixin for sax handler classes that records the sax handler
+ object for use with the following functions. Trampoline methods
+ are provided that allow those functions to be called directly on
+ the sax-parser-mixin.
+ </p>
+ <p>
+ <div class="def">Function SAX:SAX-HANDLER (sax-handler-mixin) => sax-handler</div>
+ Return the sax-parser instance recorded by this handler, or NIL.
+ </p>
+ <p>
+ <div class="def">Function SAX:LINE-NUMBER (sax-parser)</div>
+ Return an approximation of the current line number, or NIL.
+ </p>
+ <p>
+ <div class="def">Function SAX:COLUMN-NUMBER (sax-parser)</div>
+ Return an approximation of the current column number, or NIL.
+ </p>
+ <p>
+ <div class="def">Function SAX:SYSTEM-ID (sax-parser)</div>
+ Return the URI of the document being parsed. This is either the
+ main document, or the entity's system ID while contents of a parsed
+ general external entity are being processed.
+ </p>
+ <p>
+ <div class="def">Function SAX:XML-BASE (sax-parser)</div>
+ Return the [Base URI] of the current element. This URI can differ from
+ the value returned by <tt>sax:system-id</tt> if xml:base
+ attributes are present.
+ </p>
+
<a name="catalogs"/>
<h3>XML Catalogs</h3>
<p>