git.maemo.org Git - xmlrpc-c/blob - lib/expat/expat.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
   2 "http://www.w3.org/TR/REC-html40/loose.dtd">
   3
   4 <HTML>
   5
   6 <TITLE>expat</TITLE>
   7
   8 <BODY>
   9
  10 <H1>expat - XML Parser Toolkit</H1>
  11
  12 <H3>Version 1.2</H3>
  13
  14 <P>Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center
  15 Ltd.  Expat is freely available with source under a very liberal <a
  16 href="copying.txt">license</a> (the MIT license).</P>
  17
  18 <P>This is a production version of expat.  Relative to expat 1.1, it
  19 adds support for parsing external DTDs and parameter entities.
  20 Compiling with -DXML_DTD enables this support.  There's a new
  21 <CODE>-p</CODE> option for xmlwf which will cause it to process
  22 external DTDs and parameter entities; this implies the <CODE>-x</CODE>
  23 option.  See the comment above <CODE>XML_SetParamEntityParsing</CODE>
  24 in <CODE>xmlparse.h</CODE> for the API addition that enables this.</P>
  25
  26 <P>Expat is an <A
  27 HREF="http://www.w3.org/TR/1998/REC-xml-19980210">XML 1.0</A> parser
  28 written in C. It aims to be fully conforming.  It is currently not a
  29 validating XML processor.  The current production version of expat 1.X
  30 can be downloaded from <A href =
  31 "ftp://ftp.jclark.com/pub/xml/expat.zip"
  32 >ftp://ftp.jclark.com/pub/xml/expat.zip</A>.</P>
  33
  34 <P>Development of expat 2.0 is being handled by a team led by Clark
  35 Cooper, hosted by <A
  36 href="http://www.sourceforge.net">sourceforge.net</A>.  See <A href=
  37 "http://expat.sourceforge.net">http://expat.sourceforge.net</A> for
  38 the latest on expat 2.0.</P>
  39
  40 <P>The directory <SAMP>xmltok</SAMP> contains a low-level library for
  41 tokenizing XML.  The interface is documented in
  42 <SAMP>xmltok/xmltok.h</SAMP>.</P>
  43
  44 <P>The directory <SAMP>xmlparse</SAMP> contains an XML parser library
  45 which is built on top of the <SAMP>xmltok</SAMP> library.  The
  46 interface is documented in <SAMP>xmlparse/xmlparse.h</SAMP>.  The
  47 directory <SAMP>sample</SAMP> contains a simple example program using
  48 this interface; <SAMP>sample/build.bat</SAMP> is a batch file to build
  49 the example using Visual C++.</P>
  50
  51 <P>The directory <SAMP>xmlwf</SAMP> contains the <SAMP>xmlwf</SAMP>
  52 application, which uses the <SAMP>xmlparse</SAMP> library. The
  53 arguments to <SAMP>xmlwf</SAMP> are one or more files which are each
  54 to be checked for well-formedness. An option <SAMP>-d
  55 <VAR>dir</VAR></SAMP> can be specified; for each well-formed input
  56 file the corresponding <A
  57 href="http://www.jclark.com/xml/canonxml.html">canonical XML</A> will
  58 be written to <SAMP>dir/<VAR>f</VAR></SAMP>, where
  59 <SAMP><VAR>f</VAR></SAMP> is the filename (without any path) of the
  60 input file.  A <CODE>-x</CODE> option will cause references to
  61 external general entities to be processed.  A <CODE>-s</CODE> option
  62 will make documents that are not standalone cause an error (a document
  63 is considered standalone if either it is intrinsically standalone
  64 because it has no external subset and no references to parameter
  65 entities in the internal subset or it is declared as standalone in the
  66 XML declaration).</P>
  67
  68 <P>The <SAMP>bin</SAMP> directory contains Win32 executables.  The
  69 <SAMP>lib</SAMP> directory contains Win32 import libraries.</P>
  70
  71 <P>Answers to some frequently asked questions about expat can be found
  72 in the <A
  73 HREF="http://www.jclark.com/xml/expatfaq.html">expat
  74 FAQ</A>.</P>
  75
  76 <P></P>
  77
  78 <ADDRESS>
  79
  80 <A HREF="mailto:jjc@jclark.com">James Clark</A>
  81
  82 </ADDRESS>
  83
  84 </BODY>
  85
  86 </HTML>