|
1 | 1 |
|
2 |
| - Expat, Release 1.95.1 |
| 2 | + Expat, Release 1.95.2 |
3 | 3 |
|
4 |
| -This is expat, the C library for parsing XML, written by James Clark. Expat |
5 |
| -is a stream oriented XML parser. This means that you register handlers with |
6 |
| -the parser prior to starting the parse. These handlers are called when |
7 |
| -the parser discovers the associated structures in the document being parsed. |
8 |
| -A start tag is an example of the kind of structures for which you may |
9 |
| -register handlers. |
| 4 | +This is expat, a C library for parsing XML, written by James Clark. |
| 5 | +Expat is a stream-oriented XML parser. This means that you register |
| 6 | +handlers with the parser before starting the parse. These handlers |
| 7 | +are called when the parser discovers the associated structures in the |
| 8 | +document being parsed. A start tag is an example of the kind of |
| 9 | +structures for which you may register handlers. |
10 | 10 |
|
11 |
| -Expat is free software. You may copy, distribute, and modify it under the |
12 |
| -terms of the License contained in the file, COPYING, distributed with this |
13 |
| -package. This license is the same as the MIT/X Consortium license. |
| 11 | +Windows users should use the expat_win32bin package, which includes |
| 12 | +both precompiled libraries and executalbes, and source code for |
| 13 | +developers. |
14 | 14 |
|
15 |
| -Versions of expat that have an odd minor version (the middle number in the |
16 |
| -release above), are development releases and should be considered as |
17 |
| -beta software. Releases with even minor version numbers are intended to be |
18 |
| -production grade software. |
| 15 | +Expat is free software. You may copy, distribute, and modify it under |
| 16 | +the terms of the License contained in the file COPYING distributed |
| 17 | +with this package. This license is the same as the MIT/X Consortium |
| 18 | +license. |
19 | 19 |
|
20 |
| -To build expat, you first run the configuration shell script in the top |
21 |
| -level distribution directory: |
| 20 | +Versions of expat that have an odd minor version (the middle number in |
| 21 | +the release above), are development releases and should be considered |
| 22 | +as beta software. Releases with even minor version numbers are |
| 23 | +intended to be production grade software. |
| 24 | + |
| 25 | +To build expat, you first run the configuration shell script in the |
| 26 | +top level distribution directory: |
22 | 27 |
|
23 | 28 | ./configure
|
24 | 29 |
|
25 |
| -There are many options which you may provide to configure (which you can |
26 |
| -discover by running configure with the --help option.) But the one of most |
27 |
| -interest is the one that sets the installation directory. By default, |
28 |
| -the configure script will set things up to install libexpat into |
29 |
| -/usr/local/lib and expat.h into /usr/local/include. If, for example, you'd |
30 |
| -prefer to install into /home/me/mystuff/lib and /home/me/mystuff/include, |
31 |
| -you can tell configure about that with: |
| 30 | +There are many options which you may provide to configure (which you |
| 31 | +can discover by running configure with the --help option). But the |
| 32 | +one of most interest is the one that sets the installation directory. |
| 33 | +By default, the configure script will set things up to install |
| 34 | +libexpat into /usr/local/lib, expat.h into /usr/local/include, and |
| 35 | +xmlwf into /usr/local/bin. If, for example, you'd prefer to install |
| 36 | +into /home/me/mystuff/lib, /home/me/mystuff/include, and |
| 37 | +/home/me/mystuff/bin, you can tell configure about that with: |
32 | 38 |
|
33 | 39 | ./configure --prefix=/home/me/mystuff
|
34 | 40 |
|
35 |
| -After running the configure script, the "make" command will build things and |
36 |
| -"make install" will install things into their proper location. Note that |
37 |
| -you need to have write permission into the directories into which things |
38 |
| -will be installed. |
| 41 | +After running the configure script, the "make" command will build |
| 42 | +things and "make install" will install things into their proper |
| 43 | +location. Note that you need to have write permission into the |
| 44 | +directories into which things will be installed. |
| 45 | + |
| 46 | +When building for use with C++, you may need to add additional |
| 47 | +compiler flags to support proper interaction with exceptions. This |
| 48 | +can be done by setting the CFLAGS environment variable. For example, |
| 49 | +when using GCC, you can use: |
| 50 | + |
| 51 | + CFLAGS=-fexceptions ./configure |
39 | 52 |
|
40 |
| -Alternatively, on Win32 systems with Microsoft's Developer's Studio installed, |
41 |
| -you can simply double-click on lib/expat.dsp from Windows Explorer and build |
42 |
| -and install in the usual way from with DevStudio. |
| 53 | +Note for Solaris users: The "ar" command is usually located in |
| 54 | +"/usr/ccs/bin", which is not in the default PATH. You will need to |
| 55 | +add this to your path for the "make" command, and probably also switch |
| 56 | +to GNU make (the "make" found in /usr/ccs/bin does not seem to work |
| 57 | +properly -- appearantly it does not understand .PHONY directives). If |
| 58 | +you're using ksh or bash, use this command to build: |
43 | 59 |
|
44 |
| -As a third alternative you may choose to download expat_win32bin which has |
45 |
| -a pre-compiled dll in it. |
| 60 | + PATH=/usr/ccs/bin:$PATH make |
46 | 61 |
|
47 |
| -A reference manual is available in the doc/reference.html in this |
| 62 | +A reference manual is available in the file doc/reference.html in this |
48 | 63 | distribution.
|
49 | 64 |
|
50 |
| -The homepage for this project is http://expat.sourceforge.net. There are |
51 |
| -links there to connect you to the bug reports page. If you need to report |
52 |
| -a bug when you don't have access to a browser, you may also send a bug |
53 |
| -report by email to expat-bugs@lists.sourceforge.net. |
| 65 | +The homepage for this project is http://expat.sourceforge.net/. There |
| 66 | +are links there to connect you to the bug reports page. If you need |
| 67 | +to report a bug when you don't have access to a browser, you may also |
| 68 | +send a bug report by email to expat-bugs@lists.sourceforge.net. |
54 | 69 |
|
55 |
| -Discussion related to the direction of future expat development takes place |
56 |
| -on expat-discuss@lists.sourceforge.net. Archives of this list may be found |
57 |
| -at http://www.geocrawler.com/redir-sf.php3?list=expat-discuss. |
| 70 | +Discussion related to the direction of future expat development takes |
| 71 | +place on expat-discuss@lists.sourceforge.net. Archives of this list |
| 72 | +may be found at http://www.geocrawler.com/redir-sf.php3?list=expat-discuss. |
0 commit comments