jasons 02/03/28 19:04:55
Modified: targets/xerces-p index.html releases.html
targets/xerces-p/graphics domcount-header.jpg
domcreate-header.jpg domprint-header.jpg
download-header.jpg download-label-1.jpg
download-label-3.jpg ext-2-label-1.jpg
ext-2-label-2.jpg ext-2-label-3.jpg
index-header.jpg index-label-1.jpg
index-label-2.jpg releases-header.jpg
releases-label-1.jpg releases-label-2.jpg
samples-label-1.jpg samples-label-2.jpg
Log:
new version
Revision Changes Path
1.16 +108 -89 xml-site/targets/xerces-p/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xerces-p/index.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- index.html 2 Mar 2002 03:28:06 -0000 1.15
+++ index.html 29 Mar 2002 03:04:55 -0000 1.16
@@ -12,28 +12,33 @@
<IMG border="0" height="6" hspace="0" src="resources/separator.gif"
vspace="0" width="120"><BR>
<A href="releases.html" onMouseOut="rolloverOff('side-releases');"
onMouseOver="rolloverOn('side-releases');"><IMG alt="Releases" border="0"
height="12" hspace="0" name="side-releases"
onLoad="rolloverLoad('side-releases','graphics/releases-label-2.jpg','graphics/releases-label-3.jpg');"
src="graphics/releases-label-3.jpg" vspace="0" width="120"></A><BR>
<IMG border="0" height="14" hspace="0" src="resources/close.gif" vspace="0"
width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE
border="0" cellpadding="3" cellspacing="0"><TR><TD>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Xerces.pm 1.5.1</B></FONT></TD><TD bgcolor="#017299"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P> Xerces.pm is the Perl API to the Apache project's
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>XML::Xerces 1.7.0_1</B></FONT></TD><TD
bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299"
height="1" width="492"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <P> XML::Xerces is the Perl API to the Apache project's
Xerces XML parser. It is implemented using the Xerces C++ API, and
it provides access to <B>most</B> of the C++ API from Perl.
</P>
- <P> Because it is based on Xerces-C, Xerces.pm provides a validating
+ <P> Because it is based on Xerces-C, XML::Xerces provides a validating
XML parser that makes it easy to give your application the
ability to read and write XML data. A shared library is provided
for parsing, generating, manipulating, and validating XML
- documents. Xerces.pm is faithful to the XML 1.0 recommendation
+ documents. XML::Xerces is faithful to the XML 1.0 recommendation
and associated standards (DOM 1.0, DOM 2.0. SAX 1.0, SAX 2.0,
- Namespaces, and Schema), The parser provides high performance,
- modularity, and scalability.
+ Namespaces, and Schema). The parser provides high performance,
+ modularity, and scalability. It also provides full support for
+ Unicode.
</P>
- <P>Xerces.pm implements the vast majority of the Xerces-C API (if you
+ <P>XML::Xerces implements the vast majority of the Xerces-C API (if you
notice any discrepancies please mail the <A
href="mailto:[email protected]";>list</A>). The
- exception of this is functions in the C++ API which have been
- overloaded to accept different arguments, currently have only a
- single version in the Perl API. This is a simple fix, but will
- take time.
+ exception of this are some functions in the C++ API which have
+ been overloaded to accept different arguments may currently
+ have only a single version in the Perl API. This is a simple
+ fix and most of the overloaded functions are finished, but will
+ take time to catch them all. Also, there are some functions in
+ the C++ API which either have better Perl counterparts (such as
+ file I/O) or which manipulate internal C++ information that has
+ no role in the Perl module.
</P>
<P> The majority of the API is created automatically using <A
href="http://www.swig.org/";>Simplified Wrapper Interface Generator
@@ -46,48 +51,49 @@
<P> The code has been tested on the following Unix platforms: </P>
<UL>
<LI>Linux</LI>
- <UL>
- <LI>PPC-debian: works jason</LI>
- <LI>x86-debian: works harmon</LI>
- <LI>x86-redhat6.2: works jason</LI>
- <LI>x86-redhat7: works jason (recompile Xerces-C and
- Perl-5.6.1 from source)</LI>
- </UL>
<LI>BSD</LI>
- <UL>
- <LI>NetBSD (egcs-2.91.66, works: Emanuel Dreyfus
- <[EMAIL PROTECTED]>)</LI>
- </UL>
<LI>Solaris </LI>
- <UL>
- <LI>Solaris 8: works cc and gcc (recompile perl and Xerces-C from
source)</LI>
- <LI>Solaris 5.6: works gcc</LI>
- </UL>
- </UL>
- <P>Windows is currently not supported. However, minimal changes would be
- necessary to enable functionality under Windows (modification of
- some Unix 'make' specific code in Makefile.PL).
+ </UL>
+ <P>An early version of XML::Xerces (1.3.3) was ported to
+ Windows. A port is underway, and once completed, Windows will
+ become a fully supported platform.
</P>
+
</FONT></TD></TR></TABLE><BR>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Build Requirements</B></FONT></TD><TD bgcolor="#017299"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <OL>
- <LI>An ANSI C++ compiler. Builds are known to work with the GNU
- compiler. Ports to other compilers such as MSVC++ (the Microsoft
- Visual C++ compiler and development environment) are in the works.
- Contributions in this area are always welcome :-).
- </LI>
- <LI>Perl5 (Xerces.pm has been tested with perl 5.005 and 5.6).
- Currently only tested on XML documents that are encoded in plain
- old ASCII.
- </LI>
- <LI>The Apache Xerces C++ XML Parser version 1.5 (which can be
- downloaded from: <A
href="http://xml.apache.org/dist/xerces-c/stable/";>http://xml.apache.org/dist/xerces-c/stable/</A>
- <BR><BR>
- You'll need both the library and header files, and to set up any
- environment variables that will direct the Xerces.pm build to the
- directories where these reside.
- </LI>
- </OL>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD
bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0"
cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG
border="0" height="2" hspace="0" src="resources/void.gif" vspace="0"
width="2"><B>ANSI C++ compiler</B></FONT></TD><TD bgcolor="#017299"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <P>
+ Builds are known to work with the GNU
+ compiler. Ports to other compilers such as MSVC++ (the Microsoft
+ Visual C++ compiler and development environment) are in the works.
+ Contributions in this area are always welcome :-).
+ </P>
+ </FONT></TD></TR></TABLE><BR>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD
bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0"
cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG
border="0" height="2" hspace="0" src="resources/void.gif" vspace="0"
width="2"><B>Perl5</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD
valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0"
src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT
color="#000000" face="arial,helvetica,sanserif" size="-1"><I> <B> Required
version: 5.6.0</B></I></FONT></TD></TR></TABLE>
+ <P>
+ XML::Xerces now supports Unicode. Since Unicode support wasn't
+ added to Perl until 5.6.0, you will need to upgrade in order to
+ use this and future versions of XML::Xerces. Upgrading to at least
+ to the latest stable release, 5.6.1, is recommended, but if you
+ already have 5.6.0 installed it will work fine.
+ </P>
+ <P>
+ If you plan on using Unicode, I *strongly* recommend upgrading to
+ Perl-5.7.2, the latest development version. There have been
+ significant improvements to Perl's Unicode support.
+ </P>
+ </FONT></TD></TR></TABLE><BR>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD
bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0"
cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG
border="0" height="2" hspace="0" src="resources/void.gif" vspace="0"
width="2"><B>The Apache Xerces C++ XML Parser</B></FONT></TD><TD
bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299"
height="1" width="482"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD
valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0"
src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT
color="#000000" face="arial,helvetica,sanserif" size="-1"><I> <B> Required
version: 1.7.0</B></I></FONT></TD></TR></TABLE>
+ <P>
+ (which can be downloaded from: <A
href="http://xml.apache.org/dist/xerces-c/stable/";>
+ http://xml.apache.org/dist/xerces-c/stable/</A>
+ You'll need both the library and header files, and
+ to set up any environment variables that will direct the
+ XML::Xerces build to the directories where these reside.
+ </P>
+ </FONT></TD></TR></TABLE><BR>
</FONT></TD></TR></TABLE><BR>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Optional Components</B></FONT></TD><TD
bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299"
height="1" width="492"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<P><A href="http://www.swig.org/";> Simplified Wrapper Interface
@@ -97,13 +103,14 @@
for Windoes). You can get the source from <A
href="http://www.swig.org/";>www.swig.org</A> and then build it
for your platform.
</P>
- <P>You will only need this if the include Xerces.C and Xerces.pm
+ <P>You will only need this if the include Xerces.C and XML::Xerces
files do not work for your perl distribution. The pre-generated
files have been created by SWIG 1.3 and work under perl-5.005
and perl-5.6.
</P>
<P>
- This port is know to work with versions 1.1p5 and 1.3a5 of SWIG.
+ This port will only work with SWIG 1.3.12 (which is currently
+ only available via CVS).
</P>
<P>
If your planning to use SWIG, you can set the environment variable
@@ -131,8 +138,8 @@
<LI>Unpack the archive in a directory of your choice. Example (for
UNIX):</LI>
<UL>
- <LI><CODE><FONT face="courier, monospaced">tar zxvf
XML-Xerces-1.5.x.tar.gz</FONT></CODE></LI>
- <LI><CODE><FONT face="courier, monospaced">cd
XML-Xerces-1.5.x</FONT></CODE></LI>
+ <LI><CODE><FONT face="courier, monospaced">tar zxvf
XML-Xerces-1.7.0_1.tar.gz</FONT></CODE></LI>
+ <LI><CODE><FONT face="courier, monospaced">cd
XML-Xerces-1.7.0_1</FONT></CODE></LI>
</UL> <LI>Examine the Perl script "Makefile.PL". You
shouldn't
need to change any of the information unless you are
attempting to build on a platform other than UNIX, in which
@@ -140,14 +147,14 @@
<BR><BR>
Also, you may want to edit the path to the swig executable
($SWIG), if you're planning on regenerating Xerces.C and
- Xerces.pm
+ XML::Xerces
</LI>
<LI>If the Xerces-C library and header files are installed on your
system directly, e.g. via an rpm or deb package, proceed to the
build.
<BR><BR>
Otherwise, you must download Xerces from xml.apache.org and build
- it. To build Xerces.pm in this case, make sure the value of your
+ it. To build XML::Xerces in this case, make sure the value of your
XERCESCROOT environment variable is the top-level directory of
your xerces distribution (i.e. the same value it needs to be to
build XERCES).
@@ -166,10 +173,10 @@
</UL>
</OL>
</FONT></TD></TR></TABLE><BR>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Build Xerces.pm</B></FONT></TD><TD bgcolor="#017299"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Build XML::Xerces</B></FONT></TD><TD bgcolor="#017299"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<OL>
- <LI>Go to the XML-Xerces-1.5.x directory.</LI>
- <LI>Build Xerces.pm as you would any perl package that you might get
+ <LI>Go to the XML-Xerces-1.7.0_1 directory.</LI>
+ <LI>Build XML::Xerces as you would any perl package that you might get
from CPAN: </LI>
<UL>
<LI><CODE><FONT face="courier, monospaced">perl
Makefile.PL</FONT></CODE></LI>
@@ -179,9 +186,9 @@
</UL>
</OL>
</FONT></TD></TR></TABLE><BR>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Using Xerces.pm</B></FONT></TD><TD bgcolor="#017299"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Using XML::Xerces</B></FONT></TD><TD bgcolor="#017299"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<P>
- Xerces.pm implements the vast majority of the Xerces-C API (if
+ XML::Xerces implements the vast majority of the Xerces-C API (if
you notice any discrepancies please mail the
list). Documentation for this API are sadly not available in POD
format, but the Xerces-C html documentation is available at:
@@ -195,46 +202,26 @@
</P>
</FONT></TD></TR></TABLE><BR>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Special Perl API Features</B></FONT></TD><TD
bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299"
height="1" width="492"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P> Even though Xerces.pm is based on the C++ API, it has been modified
in
+ <P> Even though XML::Xerces is based on the C++ API, it has been
modified in
a few ways to make it more accessible to typical Perl usage,
primarily in the handling:
<A name="perl-api"><!--anchor--></A>
</P>
<UL>
- <LI> <A href="#string">String I/O</A> (Perl strings versus
DOMString's, XMLch *'s)</LI>
+ <LI> <A href="#string">String I/O</A> (Perl strings versus XMLch
arrays)</LI>
<LI> <A href="#list">List I/O</A> (Perl lists versus
DOM_NodeList's)</LI>
<LI> <A href="#hash">Hash I/O</A> (Perl hashes versus
DOM_NamedNodeMap's)</LI>
<LI> <A href="#serialize">Serialize API</A></LI>
<LI> <A href="#handlers">Implementing Perl handlers for C++
- even callbacks</A></LI>
+ event callbacks</A></LI>
<LI> <A href="#exceptions">handling C++ exceptions</A></LI>
+ <LI> <A href="#dom_vs_idom">DOM vs. IDOM: Incompatible Change</A></LI>
</UL>
<P><A name="string"><!--anchor--></A></P>
<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD
bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0"
cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG
border="0" height="2" hspace="0" src="resources/void.gif" vspace="0"
width="2"><B>String I/O</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
- <P>Note that the creation of
- <CODE><FONT face="courier, monospaced">DOMString</FONT></CODE>'s as
arguments to to functions is
- optional. That is, where in C++ you'd have to use:</P>
-
- <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4"
width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD
bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff"
width="462"><FONT size="-1"><PRE>
- document.createElement( new DOMString("foo") );
- </PRE></FONT></TD><TD bgcolor="#0086b2" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
-
- in Xerces.pm, you can use either of:
-
- <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4"
width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD
bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff"
width="462"><FONT size="-1"><PRE>
- $document->createElement( XML::Xerces::DOMString->new('foo') );
- </PRE></FONT></TD><TD bgcolor="#0086b2" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
-
- or the less cumbersome:
-
- <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4"
width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD
bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff"
width="462"><FONT size="-1"><PRE>
- $document->createElement('foo');
- </PRE></FONT></TD><TD bgcolor="#0086b2" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
-
- <P> As well, any functions in the C++ API that return
- string-like values, i.e. like <CODE><FONT face="courier,
monospaced">DOMString</FONT></CODE>'s and
- <CODE><FONT face="courier, monospaced">XMLCh</FONT></CODE> arrays,
return plain vanilla perl-strings in
- Xerces.pm. This obviates calls to <CODE><FONT face="courier,
monospaced">transcode</FONT></CODE> (in
+ <P> Any functions in the C++ API that return
+ <CODE><FONT face="courier, monospaced">XMLCh</FONT></CODE> arrays will
return plain vanilla perl-strings in
+ XML::Xerces. This obviates calls to <CODE><FONT face="courier,
monospaced">transcode</FONT></CODE> (in
fact, it makes them entirely invalid).
</P>
</FONT></TD></TR></TABLE><BR>
@@ -292,7 +279,7 @@
</FONT></TD></TR></TABLE><BR>
<P><A name="handlers"><!--anchor--></A></P>
<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD
bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0"
cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG
border="0" height="2" hspace="0" src="resources/void.gif" vspace="0"
width="2"><B>Implementing {Document,Content,Error}Handlers from Perl
</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1"
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299"
height="1" width="482"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
- <P>Thanks to suggestions from Duncan Cameron, Xerces.pm now has a
handler
+ <P>Thanks to suggestions from Duncan Cameron, XML::Xerces now has a
handler
API that matches the currently used semantics of other Perl
XML API's. There are three classes available for application
writers:</P>
@@ -321,7 +308,7 @@
<P><A name="exceptions"><!--anchor--></A></P>
<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD
bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0"
cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG
border="0" height="2" hspace="0" src="resources/void.gif" vspace="0"
width="2"><B>Handling exceptions ({XML,DOM,SAX}Exception's)</B></FONT></TD><TD
bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299"
height="1" width="482"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
<P>Some errors occur outside parsing and are not caught by the parser's
- ErrorHandler. Xerces.pm provides a way for catching these errors using
+ ErrorHandler. XML::Xerces provides a way for catching these errors using
the PerlExceptionHandler class.
</P>
<P>
@@ -331,9 +318,41 @@
own handler.
</P>
</FONT></TD></TR></TABLE><BR>
+ <P><A name="dom_vs_idom"><!--anchor--></A></P>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD
bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0"
cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG
border="0" height="2" hspace="0" src="resources/void.gif" vspace="0"
width="2"><B>DOM vs. IDOM</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <P><B>Incompatible Change</B></P>
+ <P>Since Xerces-C-1.5 there has been an experimental DOM implementation
+(IDOM) that is much more efficient than the old DOM implementation. As
+of XML::Xerces-1.7.0_0 all DOM methods have been switched to the IDOM
+implementation, and the old DOM implementation is no longer
+available. </P>
+ <P>
+This has made the codebase much smaller and more efficient, but there
+are some important issues to watch out for, and some code written to
+use the old DOM implementation may not work:
+ </P>
+ <UL>
+ <LI><CODE><FONT face="courier,
monospaced">DOM_Node::isNull()</FONT></CODE>: is no longer
+ available. In the old DOM API, you could receive a valid
+ <CODE><FONT face="courier, monospaced">DOM_Node</FONT></CODE> that was
really just a wrapper for a
+ <CODE><FONT face="courier, monospaced">NULL</FONT></CODE> pointer, so
before you did anything, you
+ always had to check it using the <CODE><FONT face="courier,
monospaced">isNull()</FONT></CODE>
+ method. Using the new DOM, you will get <CODE><FONT face="courier,
monospaced">undef</FONT></CODE>
+ instead of an object, so you would instead check using
+ <CODE><FONT face="courier, monospaced">defined()</FONT></CODE>.</LI>
+ <LI><CODE><FONT face="courier,
monospaced">DOMParser::setToCreateXMLDeclTypeNode()</FONT></CODE>: the
+ now DOM API follows the W3C specification more closely than
+ the old one did, so this method is no longer available.</LI>
+ <LI><CODE><FONT face="courier,
monospaced">DOM_Document::createDocument()</FONT></CODE>: the now DOM
+ API follows the W3C specification more closely than the old
+ one did, so this method is no longer available, use
+ <CODE><FONT face="courier,
monospaced">DOM_DOMImplementation::createDocument()</FONT></CODE>
+ instead.</LI>
+ </UL>
+ </FONT></TD></TR></TABLE><BR>
</FONT></TD></TR></TABLE><BR>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Sample Code</B></FONT></TD><TD bgcolor="#017299"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1"
width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P> Xerces.pm comes with three sample applications:</P>
+ <P> XML::Xerces comes with three sample applications:</P>
<UL>
<LI> <A href="saxcount.html">SAXCount.pl</A>: Uses the SAX
interface to output a count of the number of elements in an XML
document</LI>
1.5 +15 -0 xml-site/targets/xerces-p/releases.html
Index: releases.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xerces-p/releases.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- releases.html 9 Jul 2001 05:29:43 -0000 1.4
+++ releases.html 29 Mar 2002 03:04:55 -0000 1.5
@@ -12,6 +12,21 @@
<IMG border="0" height="6" hspace="0" src="resources/separator.gif"
vspace="0" width="120"><BR>
<IMG alt="Releases" border="0" height="12" hspace="0"
src="graphics/releases-label-1.jpg" vspace="0" width="120"><BR>
<IMG border="0" height="14" hspace="0" src="resources/close.gif" vspace="0"
width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE
border="0" cellpadding="3" cellspacing="0"><TR><TD>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Release XML-Xerces-1.7.0_0 Mar 24,
2002</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1"
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299"
height="1" width="492"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif"><BR>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD
bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0"
cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG
border="0" height="2" hspace="0" src="resources/void.gif" vspace="0"
width="2"><B>Features</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><UL>
+ <LI>Mirrors Xerces-C-1.7.0 release</LI>
+ <LI> The DOM API is now implemented by the Xerces-C IDOM
+ implementation (see README for issues)</LI>
+ <LI>All dynamic casting of DOM_Node*'s is now done internally by
+ the C++ code. This means that calls to DOM_Node::actual_cast
+ are now unnecessary.</LI>
+ </UL></FONT></TD></TR></TABLE><BR>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD
bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0"
cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG
border="0" height="2" hspace="0" src="resources/void.gif" vspace="0"
width="2"><B>Bugs fixed</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><UL>
+ <LI>ensured that methods which return DOM_NodeList's and
+ DOM_NamedNodeMap's will never return undef in an array
+ context (instead they return the empty list).</LI>
+ </UL></FONT></TD></TR></TABLE><BR>
+ </FONT></TD></TR></TABLE><BR>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD
bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0"
cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif"
size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif"
vspace="0" width="2"><B>Release XML-Xerces-1.3.3 Mar 22,
2001</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1"
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299"
height="1" width="492"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299"
height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="484"><FONT color="#000000" face="arial,helvetica,sanserif"><BR>
<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD
bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0"
cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD
bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2"
width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG
border="0" height="2" hspace="0" src="resources/void.gif" vspace="0"
width="2"><B>Features</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG
border="0" height="1" hspace="0" src="resources/void.gif" vspace="0"
width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD
bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0"
width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD
width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><UL>
<LI> XML::Xerces now has three non-exported functions that can be
1.6 +29 -28 xml-site/targets/xerces-p/graphics/domcount-header.jpg
<<Binary file>>
1.6 +33 -53 xml-site/targets/xerces-p/graphics/domcreate-header.jpg
<<Binary file>>
1.5 +23 -50 xml-site/targets/xerces-p/graphics/domprint-header.jpg
<<Binary file>>
1.4 +34 -37 xml-site/targets/xerces-p/graphics/download-header.jpg
<<Binary file>>
1.4 +2 -5 xml-site/targets/xerces-p/graphics/download-label-1.jpg
<<Binary file>>
1.4 +2 -1 xml-site/targets/xerces-p/graphics/download-label-3.jpg
<<Binary file>>
1.11 +4 -3 xml-site/targets/xerces-p/graphics/ext-2-label-1.jpg
<<Binary file>>
1.10 +2 -7 xml-site/targets/xerces-p/graphics/ext-2-label-2.jpg
<<Binary file>>
1.11 +2 -2 xml-site/targets/xerces-p/graphics/ext-2-label-3.jpg
<<Binary file>>
1.13 +28 -22 xml-site/targets/xerces-p/graphics/index-header.jpg
<<Binary file>>
1.10 +5 -2 xml-site/targets/xerces-p/graphics/index-label-1.jpg
<<Binary file>>
1.11 +4 -8 xml-site/targets/xerces-p/graphics/index-label-2.jpg
<<Binary file>>
1.6 +36 -43 xml-site/targets/xerces-p/graphics/releases-header.jpg
<<Binary file>>
1.6 +4 -2 xml-site/targets/xerces-p/graphics/releases-label-1.jpg
<<Binary file>>
1.6 +6 -7 xml-site/targets/xerces-p/graphics/releases-label-2.jpg
<<Binary file>>
1.6 +3 -4 xml-site/targets/xerces-p/graphics/samples-label-1.jpg
<<Binary file>>
1.6 +6 -7 xml-site/targets/xerces-p/graphics/samples-label-2.jpg
<<Binary file>>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
