libexpat/expat
Greg Stein 4232566291 Revamp config/build to keep generated files out of CVS (some libtool files
were out of date, and we've previously seen expat.h out of sync).

*) Use new script "buildconf.sh" to create the set of generated files
   (aclocal.m4, config.h.in, configure). This is intended to be used by
   developers (rerun when configure.in changes) and just before a release
   (releases include these outputs).

   Developers now need the "autoconf" and "libtool" packages.

*) config.h.in is now built by autoheader and includes bits from acconfig.h
   rather than manual construction/maintenance. (renamed from config.hin)

*) added conftools/PrintPath from the ASF; it is a portable "which"

*) added "extraclean" target to top-level Makefile to get rid of all
   generated files (return to pure CVS state; before buildconf.sh)

*) updates various bits for config.hin -> config.h.in rename

*) no longer need to delete the ".deps" subdir since we don't create it
   anymore (dependencies are explicit rather than auto-generated).
2001-03-10 15:41:50 +00:00
..
conftools Revamp config/build to keep generated files out of CVS (some libtool files 2001-03-10 15:41:50 +00:00
doc Document the #define constants giving library version information. 2001-01-24 19:53:01 +00:00
examples Sam TH: 2001-03-01 04:28:27 +00:00
gennmtab Merged in modifications from perl-expat. Also fiddled around with more 2000-09-21 21:20:18 +00:00
lib Revamp config/build to keep generated files out of CVS (some libtool files 2001-03-10 15:41:50 +00:00
sample Sam TH: 2001-03-01 04:18:28 +00:00
xmlparse
xmltok Merged in modifications from perl-expat. Also fiddled around with more 2000-09-21 21:20:18 +00:00
xmlwf Sam TH: 2001-03-01 04:28:27 +00:00
.gitignore Revamp config/build to keep generated files out of CVS (some libtool files 2001-03-10 15:41:50 +00:00
acconfig.h Revamp config/build to keep generated files out of CVS (some libtool files 2001-03-10 15:41:50 +00:00
buildconf.sh Revamp config/build to keep generated files out of CVS (some libtool files 2001-03-10 15:41:50 +00:00
Changes Inadvertently failed to commit these files for 1.95.1 (apparently I committed 2000-12-27 18:08:15 +00:00
configure.in Revamp config/build to keep generated files out of CVS (some libtool files 2001-03-10 15:41:50 +00:00
COPYING
expat.spec Update the license type; error pointed out by Greg Stein. 2001-03-03 07:20:04 +00:00
Makefile.in Revamp config/build to keep generated files out of CVS (some libtool files 2001-03-10 15:41:50 +00:00
MANIFEST Inadvertently failed to commit these files for 1.95.1 (apparently I committed 2000-12-27 18:08:15 +00:00
README Added note about adding /usr/ccs/bin to the PATH for Solaris users. 2001-01-25 17:55:24 +00:00

			Expat, Release 1.95.1

This is expat, the 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 prior to 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.

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 and expat.h into /usr/local/include. If, for example, you'd
prefer to install into /home/me/mystuff/lib and /home/me/mystuff/include,
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.

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.  If you're using ksh or
bash, use this command to build:

	PATH=/usr/ccs/bin:$PATH make

Alternatively, on Win32 systems with Microsoft's Developer's Studio installed,
you can simply double-click on lib/expat.dsp from Windows Explorer and build
and install in the usual way from with DevStudio.

As a third alternative you may choose to download expat_win32bin which has
a pre-compiled dll in it.

A reference manual is available in the 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.