[Expat-checkins] expat/doc reference.html,1.50,1.51

Wed Oct 15 14:49:56 EDT 2003

Update of /cvsroot/expat/expat/doc
In directory sc8-pr-cvs1:/tmp/cvs-serv19568

Modified Files:
	reference.html 
Log Message:
- add Expat version number
- add notes about safely using XMLCALL with older Expat versions


Index: reference.html
===================================================================
RCS file: /cvsroot/expat/expat/doc/reference.html,v
retrieving revision 1.50
retrieving revision 1.51
diff -u -d -r1.50 -r1.51

--- reference.html	15 Oct 2003 16:36:23 -0000	1.50
+++ reference.html	15 Oct 2003 18:49:54 -0000	1.51
@@ -15,6 +15,8 @@
 <body>
 <h1>Expat XML Parser</h1>
 
+<p><em>Release 1.95.7.</em></p>
+
 <p>Expat is a library, written in C, for parsing XML documents. It's
 the underlying XML parser for the open source Mozilla project, Perl's
 <code>XML::Parser</code>, Python's <code>xml.parsers.expat</code>, and
@@ -223,7 +225,23 @@
 existing working Expat applications don't need to add it (since they
 are already using the "cdecl" calling convention, or they wouldn't be
 working).  The annotation is only needed if the default calling
-convention may be something other than "cdecl".</p>
+convention may be something other than "cdecl".  To use the annotation
+safely with older versions of Expat, you can conditionally define it
+<em>after</em> including Expat's header file:</p>
+
+<pre class="eg">
+#include &lt;expat.h&gt;
+
+#ifndef XMLCALL
+#if defined(_MSC_EXTENSIONS) && !defined(__BEOS__) && !defined(__CYGWIN__)
+#define XMLCALL __cdecl
+#elif defined(__GNUC__)
+#define XMLCALL __attribute__((cdecl))
+#else
+#define XMLCALL
+#endif
+#endif
+</pre>
 
 <p>After creating the parser, the main program just has the job of
 shoveling the document to the parser so that it can do its work.</p>



