[cxml-cvs] CVS cxml/doc - cxml-cvs@common-lisp.net - mailman3.common-lisp.net

4 Mar 2007

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>

    