[cxml-cvs] CVS update: cxml/doc/dom.html cxml/doc/installation.html cxml/doc/quickstart.html cxml/doc/using.html
David Lichteblau
dlichteblau at common-lisp.net
Tue Dec 27 20:01:18 UTC 2005
Update of /project/cxml/cvsroot/cxml/doc
In directory common-lisp.net:/tmp/cvs-serv5367/doc
Modified Files:
dom.html installation.html quickstart.html using.html
Log Message:
sb-unicode backport
namespace-korrekturen
noch documentation
Date: Tue Dec 27 21:01:12 2005
Author: dlichteblau
Index: cxml/doc/dom.html
diff -u cxml/doc/dom.html:1.2 cxml/doc/dom.html:1.3
--- cxml/doc/dom.html:1.2 Tue Dec 27 02:35:13 2005
+++ cxml/doc/dom.html Tue Dec 27 21:01:12 2005
@@ -117,6 +117,15 @@
href="using.html#misc">namespace normalizer</a> is used.
</li>
</ul>
+ <p>
+ <tt>unparse-document-to-octets</tt> returns an <tt>(unsigned-byte
+ 8)</tt> array, whereas <tt>unparse-document</tt> writes
+ characters. <tt>unparse-document</tt> is useful together
+ with <tt>with-output-to-string</tt>. However, note that the
+ resulting document in both cases is UTF-8 encoded, so the
+ characters written by <tt>unparse-document</tt> are really UTF-8
+ bytes encoded as characters.
+ </p>
<a name="mapping"/>
<h3>DOM/Lisp mapping</h3>
Index: cxml/doc/installation.html
diff -u cxml/doc/installation.html:1.5 cxml/doc/installation.html:1.6
--- cxml/doc/installation.html:1.5 Mon Dec 26 23:04:10 2005
+++ cxml/doc/installation.html Tue Dec 27 21:01:12 2005
@@ -14,35 +14,31 @@
<h2>Download</h2>
<ul>
<li>
- <a href="http://common-lisp.net/project/cxml/download/">tarballs</a>
+ <div><a href="http://common-lisp.net/project/cxml/download/">tarballs</a></div>
</li>
- <li>
+ <li>
+ <div>
Anoncvs (<a href="http://common-lisp.net/cgi-bin/viewcvs.cgi/cxml/?cvsroot=cxml">browse</a>):
<pre>$ export CVSROOT=:pserver:anonymous at common-lisp.net:/project/cxml/cvsroot
$ cvs login
Logging in to :pserver:anonymous at common-lisp.net:2401/project/cxml/cvsroot
CVS password: anonymous
$ cvs co cxml</pre>
- </lii>
+ </div>
+ </li>
</ul>
<a name="implementations"/>
<h2>Implementation-specific notes</h2>
<p>
CXML should be portable to all Common Lisp implementations
- supporting gray streams. Currently supported are ACL, CLISP,
- CMUCL, LispWorks, OpenMCL, and SBCL.
+ supported by <a
+ href="http://common-lisp.net/project/cl-plus-ssl/#trivial-gray-streams">trivial-gray-streams</a>.
</p>
<ul>
<li>
- Note that CMUCL and OpenMCL do not support Unicode
- natively. (You might want to use the <a
- href="using.html#rods">recoding SAX handler</a> to work with
- native strings anyway.)
- </li>
- <li>
SBCL and CLISP will trip over cxml's non-ASCII source files
- unless compiled using a suitable locale configuration
+ unless run using a suitable locale configuration
(<tt>LC_CTYPE=en_US.ISO-8859-1</tt> should help).
</li>
<li>
@@ -51,19 +47,6 @@
</li>
</ul>
-<!--
- <p>
- Optional configuration (skip this unless you know better): CXML
- has full Unicode code support - - even on Lisps without Unicode
- strings. On non-unicode aware Lisps, <tt>DOMString</tt> is
- implemented as an array of character codes. CXML will auto-detect
- at compile-time which string representation to use. To override
- the auto-detection, you can set one of the features
- <tt>:rune-is-character</tt> and <tt>:rune-is-integer</tt> before
- loading <tt>cxml.asd</tt>.
- </p>
--->
-
<a name="compilation"/>
<h2>Compilation</h2>
<p>
@@ -117,9 +100,9 @@
</p>
<p>
- <b>fixme</b> My parser does not understand the current testsuite
- anymore. To fix this problem, revert the affected files
- manually after check-out:
+ <b>fixme</b> domtest.lisp does not understand the current
+ testsuite driver anymore. To fix this problem, revert the
+ affected files manually after check-out:
</p>
<pre>$ cd 2001/XML-Test-Suite/xmlconf/
Index: cxml/doc/quickstart.html
diff -u cxml/doc/quickstart.html:1.2 cxml/doc/quickstart.html:1.3
--- cxml/doc/quickstart.html:1.2 Tue Dec 27 02:35:13 2005
+++ cxml/doc/quickstart.html Tue Dec 27 21:01:12 2005
@@ -16,7 +16,7 @@
<ul class="sub">
<li><a href="installation.html#download"><b>Download</b></a></li>
<li><a href="installation.html#implementations">Implementation-specific notes</a></li>
- <li><a href="installation.html#compilation"><b>Compilation</b></a></li>
+ <li><a href="installation.html#compilation">Compilation</a></li>
<li><a href="installation.html#tests">Tests</a></li>
</ul>
</li>
Index: cxml/doc/using.html
diff -u cxml/doc/using.html:1.8 cxml/doc/using.html:1.9
--- cxml/doc/using.html:1.8 Tue Dec 27 02:35:13 2005
+++ cxml/doc/using.html Tue Dec 27 21:01:12 2005
@@ -138,9 +138,10 @@
</p>
<p>
- <div class="def">Function CXML:MAKE-CHARACTER-STREAM-SINK (stream &rest keys) => sink</div>
+ <div class="def">Function CXML:MAKE-OCTET-STREAM-SINK (stream &rest keys) => sink</div>
<div class="def">Function CXML:MAKE-OCTET-VECTOR-SINK (&rest keys) => sink</div>
- Return a handle suitable for event-based XML serialization.
+ <div class="def">Function CXML:MAKE-CHARACTER-STREAM-SINK (stream &rest keys) => sink</div>
+ Return a SAX serialization handle.
</p>
<p>Keyword arguments:</p>
<ul>
@@ -175,26 +176,6 @@
changes the document model and should only be used if whitespace
does not matter to the application.
</p>
- <p>
- If namespace support is enabled (the default), these functions use
- a namespace normalizer (<tt>cxml:make-namespace-normalizer</tt>).
- </p>
- <p>
- <tt>unparse-document-to-octets</tt> returns an <tt>(unsigned-byte
- 8)</tt> array, whereas <tt>unparse-document</tt> writes
- characters. <tt>unparse-document</tt> is useful together
- with <tt>with-output-to-string</tt>. However, note that the
- resulting document in both cases is UTF-8 encoded, so the
- characters written by <tt>unparse-document</tt> are really UTF-8
- bytes encoded as characters.
- </p>
- <p>
- These function provide the low-level mechanism used by the DOM
- serialization functions. To serialize a document without building
- its DOM tree first, create a sink handle and call SAX functions on that
- handle. <tt>sax:end-document</tt> returns the serialized form of
- the document described by the SAX events.
- </p>
<p>
<div class="def">Macro CXML:WITH-XML-OUTPUT (sink &body body) => sink-specific result</div>
@@ -214,17 +195,12 @@
(attribute "blub" "bla"))
(text "Hi there.")))</pre>
<p>
- Prints this to <tt>stream</tt>, which must be an
- <tt>(unsigned-byte 8)</tt> stream:
+ Prints this to <tt>stream</tt>:
</p>
<pre><foo xyz="abc">
<bar blub="bla"></bar>
Hi there.
</foo></pre>
- <p>
- (Note that these functions accept both strings and rods, so we
- can write <tt>"foo"</tt> instead of <tt>#"foo"</tt> above.)
- </p>
<p>
<div class="def">Macro XHTML-GENERATOR:WITH-XHTML (sink &rest forms)</div>
More information about the Cxml-cvs
mailing list