diff options
author | fdrake <fdrake> | 2003-10-15 16:36:23 +0000 |
---|---|---|
committer | fdrake <fdrake> | 2003-10-15 16:36:23 +0000 |
commit | ad6974e541fe098a7c198239db78ca86e9ed2ed0 (patch) | |
tree | 0dd824e7764d07bef9f84712725f78e997d987d2 /doc | |
parent | baebcb69dfbc0b91a6a27b7abe4dbf850dff962d (diff) | |
download | libexpat-ad6974e541fe098a7c198239db78ca86e9ed2ed0.tar.gz |
Move "Configuring Expat Using the Pre-Processor" from the "Using"
section to the "Building" section.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/reference.html | 102 |
1 files changed, 51 insertions, 51 deletions
diff --git a/doc/reference.html b/doc/reference.html index e40ce06..6d57c4d 100644 --- a/doc/reference.html +++ b/doc/reference.html @@ -276,6 +276,57 @@ library and header would get installed in <code>/home/me/mystuff/lib</code> and <code>/home/me/mystuff/include</code> respectively.</p> +<h3>Configuring Expat Using the Pre-Processor</h3> + +<p>Expat's feature set can be configured using a small number of +pre-processor definitions. The definition of this symbols does not +affect the set of entry points for Expat, only the behavior of the API +and the definition of character types in the case of +<code>XML_UNICODE_WCHAR_T</code>. The symbols are:</p> + +<dl class="cpp-symbols"> +<dt>XML_DTD</dt> +<dd>Include support for using and reporting DTD-based content. If +this is defined, default attribute values from the DTD are reported +and attribute value normalization occurs based on the type of +attributes. Callbacks can be registered which report information from +the DTD (including content models and attribute definitions) only if +this is defined. Without this, Expat has a smaller memory footprint +and can be faster.</dd> + +<dt>XML_NS</dt> +<dd>When defined, support for the <cite><a href= +"http://www.w3.org/TR/REC-xml-names/" >Namespaces in XML</a></cite> +specification is included.</dd> + +<dt>XML_UNICODE</dt> +<dd>When defined, character data reported to the application is +encoded in UTF-16 using wide characters of the type +<code>XML_Char</code>. This is implied if +<code>XML_UNICODE_WCHAR_T</code> is defined.</dt> + +<dt>XML_UNICODE_WCHAR_T</dt> +<dd>If defined, causes the <code>XML_Char</code> character type to be +defined using the <code>wchar_t</code> type; otherwise, <code>unsigned +short</code> is used. Defining this implies +<code>XML_UNICODE</code>.</dd> + +<dt>XML_CONTEXT_BYTES</dt> +<dd>The number of input bytes of markup context which the parser will +ensure are available for reporting via <code><a href= +"#XML_GetInputContext" >XML_GetInputContext</a></code>. This is +normally set to 1024. If this is not defined, the input context will +not be available and <code><a href= "#XML_GetInputContext" +>XML_GetInputContext</a></code> will always report NULL. Without +this, Expat has a smaller memory footprint and can be faster.</dd> + +<dt>XML_STATIC</dt> +<dd>On Windows, this should be set if Expat is going to be linked +statically with the code that calls it; this is required to get all +the right MSVC magic annotations correct. This is ignored on other +platforms.</dd> +</dl> + <hr /> <h2><a name="using">Using Expat</a></h2> @@ -623,57 +674,6 @@ arguments:</p> <p>In order to read an external DTD, you also have to set an external entity reference handler as described above.</p> -<h3>Configuring Expat Using the Pre-Processor</h3> - -<p>Expat's feature set can be configured using a small number of -pre-processor definitions. The definition of this symbols does not -affect the set of entry points for Expat, only the behavior of the API -and the definition of character types in the case of -<code>XML_UNICODE_WCHAR_T</code>. The symbols are:</p> - -<dl class="cpp-symbols"> -<dt>XML_DTD</dt> -<dd>Include support for using and reporting DTD-based content. If -this is defined, default attribute values from the DTD are reported -and attribute value normalization occurs based on the type of -attributes. Callbacks can be registered which report information from -the DTD (including content models and attribute definitions) only if -this is defined. Without this, Expat has a smaller memory footprint -and can be faster.</dd> - -<dt>XML_NS</dt> -<dd>When defined, support for the <cite><a href= -"http://www.w3.org/TR/REC-xml-names/" >Namespaces in XML</a></cite> -specification is included.</dd> - -<dt>XML_UNICODE</dt> -<dd>When defined, character data reported to the application is -encoded in UTF-16 using wide characters of the type -<code>XML_Char</code>. This is implied if -<code>XML_UNICODE_WCHAR_T</code> is defined.</dt> - -<dt>XML_UNICODE_WCHAR_T</dt> -<dd>If defined, causes the <code>XML_Char</code> character type to be -defined using the <code>wchar_t</code> type; otherwise, <code>unsigned -short</code> is used. Defining this implies -<code>XML_UNICODE</code>.</dd> - -<dt>XML_CONTEXT_BYTES</dt> -<dd>The number of input bytes of markup context which the parser will -ensure are available for reporting via <code><a href= -"#XML_GetInputContext" >XML_GetInputContext</a></code>. This is -normally set to 1024. If this is not defined, the input context will -not be available and <code><a href= "#XML_GetInputContext" ->XML_GetInputContext</a></code> will always report NULL. Without -this, Expat has a smaller memory footprint and can be faster.</dd> - -<dt>XML_STATIC</dt> -<dd>On Windows, this should be set if Expat is going to be linked -statically with the code that calls it; this is required to get all -the right MSVC magic annotations correct. This is ignored on other -platforms.</dd> -</dl> - <hr /> <!-- ================================================================ --> |