Commit Graph

64 Commits

Author SHA1 Message Date
Fred L. Drake, Jr.
556f1650b1 extend the "Communicating between handlers" section a bit; needed to
mention the need to accumulate data between calls to the character
data handler
2003-10-28 21:25:43 +00:00
Fred L. Drake, Jr.
9749816465 use indentation consistently 2003-10-20 14:50:37 +00:00
Fred L. Drake, Jr.
16efce86d2 Steal a bit of look-n-feel from the website; this document was just looking
incredibly bland.
2003-10-20 14:40:44 +00:00
Fred L. Drake, Jr.
7b1a4b6f16 - add the XMLCALL annotation consistently in the docs
- don't drop the void return for handler setting functions
2003-10-15 20:46:53 +00:00
Fred L. Drake, Jr.
5635f09e4c - add Expat version number
- add notes about safely using XMLCALL with older Expat versions
2003-10-15 18:49:54 +00:00
Fred L. Drake, Jr.
c33c38d289 Move "Configuring Expat Using the Pre-Processor" from the "Using"
section to the "Building" section.
2003-10-15 16:36:23 +00:00
Fred L. Drake, Jr.
2bba3d20f5 Deal with issue discussed in SF patch #820946: Expat doesn't handle
the use of modified default calling conventions in client code.

To deal with this issue and generally clean up the mass of macros
being used to support bits of the machinery, two new macros are being
added:

- XMLCALL, which expands to whatever is needed to nail down the
  calling convention for all calls across the library boundary.  This
  must match the convention used for the system's malloc()
  implementation.

- XMLIMPORT, defined to be whatever magic is needed to mark an entry
  point as imported from a dynamically loaded module (.dll, .so, .sl,
  whatever).

These macros are used to define the XMLPARSEAPI macro already being
used to define the API entry points.  In addition, XMLCALL is used to
define the types of callback functions, and all example code uses this
explicitly in both the distributed applications and the documentation.
2003-10-15 16:25:44 +00:00
Fred L. Drake, Jr.
b5aaaefa1f Added documentation for the pre-processor macros used to configure Expat. 2003-10-08 03:32:25 +00:00
Karl Waclawek
04e4395048 Adjusted layout of XML_ParserReset fix. 2003-08-28 13:12:34 +00:00
Karl Waclawek
f375cc9c98 Fixed omission of second argument in XML_ParserReset.
Reported by Tim Bray.
2003-08-28 13:08:10 +00:00
Fred L. Drake, Jr.
c288abe148 - better explain the XML_GetCurrent*() functions (SF bug #683681)
- fix spelling
2003-03-13 02:13:06 +00:00
Fred L. Drake, Jr.
de2aab2a91 Fix function signature.
Closes SF bug #679468.
2003-03-13 01:30:48 +00:00
Fred L. Drake, Jr.
c95888aeed Removed documentation of limitations that no longer exist in the
implementation.  See SF bug #620343.
2003-03-12 22:42:53 +00:00
Fred L. Drake, Jr.
0edf0b6689 XML_Status is an enum, not a typedef name. 2003-01-28 15:23:39 +00:00
Fred L. Drake, Jr.
de5e0f55c8 Regenerate from xmlwf.sgml revision 1.4. 2003-01-24 18:34:59 +00:00
Fred L. Drake, Jr.
ed1d59f6b1 Explain "--" properly. 2003-01-24 18:34:03 +00:00
Fred L. Drake, Jr.
da325003e9 Regenerate from xmlwf.sgml. 2003-01-24 15:26:06 +00:00
Fred L. Drake, Jr.
9934dba58a - document unexpected memory use reporting when memory mapped files
are used; closes SF bug #632146
- minor changes to wording in a few places
- remove cute comment on one of the linked sites
- added more markup
2003-01-24 15:23:33 +00:00
Fred L. Drake, Jr.
164b04825b Added notes that the namespace decl handlers are only called when the
start element handler is set.  See SF bug #620343.
2003-01-21 16:09:31 +00:00
Fred L. Drake, Jr.
3d6f978672 Documented XML_SetExternalEntityRefHandlerArg(), including API
foolishness noted in SF bug #644344.
Closes SF bug #644344.
2003-01-21 05:00:51 +00:00
Fred L. Drake, Jr.
bbfa307c6b Add documentation for XML_FreeContentModel(), XML_MemMalloc(),
XML_MemRealloc(), and XML_MemFree().
2003-01-16 23:15:19 +00:00
Fred L. Drake, Jr.
eb280e7260 Change the API to return XML_Status values where possible.
Existing client code is 100% compatible.
2002-12-30 20:12:52 +00:00
Fred L. Drake, Jr.
7556575221 Clarify the documentation for the position-reporting functions
somewhat (see SF bug #653180).

Use XML_STATUS_ERROR and XML_STATUS_OK instead of 0, 1, and "non-zero"
in several places.
2002-12-30 19:50:06 +00:00
Fred L. Drake, Jr.
0bf90d3f52 Adjust markup a bit, adding some internal hyperlinks. 2002-10-17 19:13:55 +00:00
Karl Waclawek
b6a92c7a8f Improved documentation of XML_ExternalEntityRefHandler. 2002-10-17 16:47:45 +00:00
Fred L. Drake, Jr.
8d3327daf6 Add omitted period. 2002-10-08 14:02:02 +00:00
Fred L. Drake, Jr.
ad0e1a943b Elaborate the XML_GetFeatureList() API a bit, and add additional info
that may be needed by a hughly flexible client.  (Or at least used to check
that the Expat that it links to matches client expectations.)
2002-09-05 01:48:26 +00:00
Fred L. Drake, Jr.
fcfed06b51 Consistently use "Expat" when refering to the Expat software.
Other minor clarifications.
2002-08-29 15:57:08 +00:00
Fred L. Drake, Jr.
a759c51ca1 The strings returned as part of the XML_Feature structure should be of type
XML_LChar*, not XML_Char*.
2002-08-29 15:29:52 +00:00
Fred L. Drake, Jr.
e5cf509115 Revise the XML_GetFeatureList() function signature so that we maintain the
behavior that all strings returned from Expat are affected by the XML_UNICODE
and XML_UNICODE_WCHAR_T feature-test macros, and ensure that an application
that needs to determine what type of character data is returned can do so
with reasonable ease.
2002-08-29 04:54:04 +00:00
Fred L. Drake, Jr.
fd28011aa5 Documented XML_ParserReset().
Made function signatures use a trailing semi-colon consistently.
2002-08-26 20:37:49 +00:00
Fred L. Drake, Jr.
d0ce0b3b0b Substantially reduce the amount of indentation used in the table of
contents.

Added documentation for XML_UseForeignDTD().
2002-08-26 19:55:22 +00:00
Karl Waclawek
46feda26da Small documentation fix for default handler. 2002-08-26 17:57:38 +00:00
Fred L. Drake, Jr.
7f88e00a8e Fix XHTML well-formedness and validity. 2002-08-26 17:27:29 +00:00
Fred L. Drake, Jr.
bb761420b6 XML_GetFeatureList(): New API function. 2002-08-26 17:19:41 +00:00
Fred L. Drake, Jr.
66e88141e0 Minor changes for consistency. 2002-08-23 22:21:09 +00:00
Fred L. Drake, Jr.
1297454350 Added some minor markup, plus many more internal hyperlinks. 2002-08-22 21:08:43 +00:00
Karl Waclawek
c2f6f06d91 Added more detail about the unknownEncodingHandler. 2002-08-22 00:06:51 +00:00
Karl Waclawek
f5f615c931 Fixed typo. 2002-08-11 01:36:05 +00:00
Fred L. Drake, Jr.
88701bc30f Fix well-formedness, broken in the previous checkin. 2002-08-08 22:21:06 +00:00
Fred L. Drake, Jr.
1908fd3dbd Added documentation on how Expat deals with XML versions other than
1.0, and shows how an application can affect it.
Closes SF bug #584041.
2002-08-08 22:17:28 +00:00
Fred L. Drake, Jr.
86803b4c89 Specify XHTML 1.0 Strict, conform, and add the "Valid XHTML 1.0" icon.
Rip out a lot of the extra layers of <div/> and <a/> elements.
2002-08-08 21:51:31 +00:00
Fred L. Drake, Jr.
60b31ae5e7 Add the "Valid XHTML 1.0" icon. 2002-08-08 21:51:01 +00:00
Fred L. Drake, Jr.
aef65d4ec3 Lots of really minor changes:
- Wrap paragraphs more consistently.
- Make this well-formed XML.
- When making a hyperlink to a function description, consistently
  place the anchor inside the code, not the other way around.
- Make more references to function names hyperlinks to the
  descriptions.
- Fix a few small typos.
- Don't always use an extra div to carry a class attribute, just stick
  it on the pre.
2002-08-08 20:41:43 +00:00
Fred L. Drake, Jr.
3d198c888e Style cleanup. 2002-08-08 20:37:11 +00:00
Fred L. Drake, Jr.
81f729ae08 Document XML_DefaultCurrent().
Update the documentation on XML_SetDefaultHandler() and
XML_SetDefaultHandlerExpand().

Closes SF bug #585537.
2002-08-08 19:29:08 +00:00
Fred L. Drake, Jr.
63f624a708 Update the API documentation with the use of XML_Status for the
XML_Parse() and XML_ParseBuffer() functions.
2002-08-08 18:54:15 +00:00
Karl Waclawek
f944d41397 Added documentation to prevent the misunderstanding that led
to bug #580503: user called parsing functions recursively.
2002-07-27 23:13:16 +00:00
Karl Waclawek
51be5c3e5d Added documentation for new skipped entity handler. 2002-07-11 03:35:42 +00:00
Fred L. Drake, Jr.
17fc960ec4 Consistently use the shorter libexpat.org URL. 2002-06-13 18:12:20 +00:00