73 lines
3.1 KiB
Plaintext
73 lines
3.1 KiB
Plaintext
|
|
||
|
|
Expat, Release 1.95.2
|
||
|
|
|
||
|
|
This is expat, a C library for parsing XML, written by James Clark.
|
||
|
|
Expat is a stream-oriented XML parser. This means that you register
|
||
|
|
handlers with the parser before starting the parse. These handlers
|
||
|
|
are called when the parser discovers the associated structures in the
|
||
|
|
document being parsed. A start tag is an example of the kind of
|
||
|
|
structures for which you may register handlers.
|
||
|
|
|
||
|
|
Windows users should use the expat_win32bin package, which includes
|
||
|
|
both precompiled libraries and executalbes, and source code for
|
||
|
|
developers.
|
||
|
|
|
||
|
|
Expat is free software. You may copy, distribute, and modify it under
|
||
|
|
the terms of the License contained in the file COPYING distributed
|
||
|
|
with this package. This license is the same as the MIT/X Consortium
|
||
|
|
license.
|
||
|
|
|
||
|
|
Versions of expat that have an odd minor version (the middle number in
|
||
|
|
the release above), are development releases and should be considered
|
||
|
|
as beta software. Releases with even minor version numbers are
|
||
|
|
intended to be production grade software.
|
||
|
|
|
||
|
|
To build expat, you first run the configuration shell script in the
|
||
|
|
top level distribution directory:
|
||
|
|
|
||
|
|
./configure
|
||
|
|
|
||
|
|
There are many options which you may provide to configure (which you
|
||
|
|
can discover by running configure with the --help option). But the
|
||
|
|
one of most interest is the one that sets the installation directory.
|
||
|
|
By default, the configure script will set things up to install
|
||
|
|
libexpat into /usr/local/lib, expat.h into /usr/local/include, and
|
||
|
|
xmlwf into /usr/local/bin. If, for example, you'd prefer to install
|
||
|
|
into /home/me/mystuff/lib, /home/me/mystuff/include, and
|
||
|
|
/home/me/mystuff/bin, you can tell configure about that with:
|
||
|
|
|
||
|
|
./configure --prefix=/home/me/mystuff
|
||
|
|
|
||
|
|
After running the configure script, the "make" command will build
|
||
|
|
things and "make install" will install things into their proper
|
||
|
|
location. Note that you need to have write permission into the
|
||
|
|
directories into which things will be installed.
|
||
|
|
|
||
|
|
When building for use with C++, you may need to add additional
|
||
|
|
compiler flags to support proper interaction with exceptions. This
|
||
|
|
can be done by setting the CFLAGS environment variable. For example,
|
||
|
|
when using GCC, you can use:
|
||
|
|
|
||
|
|
CFLAGS=-fexceptions ./configure
|
||
|
|
|
||
|
|
Note for Solaris users: The "ar" command is usually located in
|
||
|
|
"/usr/ccs/bin", which is not in the default PATH. You will need to
|
||
|
|
add this to your path for the "make" command, and probably also switch
|
||
|
|
to GNU make (the "make" found in /usr/ccs/bin does not seem to work
|
||
|
|
properly -- appearantly it does not understand .PHONY directives). If
|
||
|
|
you're using ksh or bash, use this command to build:
|
||
|
|
|
||
|
|
PATH=/usr/ccs/bin:$PATH make
|
||
|
|
|
||
|
|
A reference manual is available in the file doc/reference.html in this
|
||
|
|
distribution.
|
||
|
|
|
||
|
|
The homepage for this project is http://expat.sourceforge.net/. There
|
||
|
|
are links there to connect you to the bug reports page. If you need
|
||
|
|
to report a bug when you don't have access to a browser, you may also
|
||
|
|
send a bug report by email to expat-bugs@lists.sourceforge.net.
|
||
|
|
|
||
|
|
Discussion related to the direction of future expat development takes
|
||
|
|
place on expat-discuss@lists.sourceforge.net. Archives of this list
|
||
|
|
may be found at http://www.geocrawler.com/redir-sf.php3?list=expat-discuss.
|