shaba/libxml2
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/libxml2.git synced 2025-03-20 18:50:08 +03:00
Code

doc: Regenerate libxml2-api.xml

Browse Source
This commit is contained in:
Nick Wellnhofer 2025-02-25 20:09:36 +01:00
parent 6ab430ca2e
commit ce1b704e33
2 changed files with 110 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

127
doc/libxml2-api.xml
View File

@ -554,6 +554,7 @@
<exports symbol='XML_PARSER_SYSTEM_LITERAL' type='enum'/>
<exports symbol='XML_PARSER_XML_DECL' type='enum'/>
<exports symbol='XML_PARSE_BIG_LINES' type='enum'/>
<exports symbol='XML_PARSE_CATALOG_PI' type='enum'/>
<exports symbol='XML_PARSE_COMPACT' type='enum'/>
<exports symbol='XML_PARSE_DOM' type='enum'/>
<exports symbol='XML_PARSE_DTDATTR' type='enum'/>
@ -570,9 +571,7 @@
<exports symbol='XML_PARSE_NONET' type='enum'/>
<exports symbol='XML_PARSE_NOWARNING' type='enum'/>
<exports symbol='XML_PARSE_NOXINCNODE' type='enum'/>
<exports symbol='XML_PARSE_NO_CATALOG_PI' type='enum'/>
<exports symbol='XML_PARSE_NO_SYS_CATALOG' type='enum'/>
<exports symbol='XML_PARSE_NO_UNZIP' type='enum'/>
<exports symbol='XML_PARSE_NO_XXE' type='enum'/>
<exports symbol='XML_PARSE_NSCLEAN' type='enum'/>
<exports symbol='XML_PARSE_OLD10' type='enum'/>
@ -585,6 +584,7 @@
<exports symbol='XML_PARSE_SAX' type='enum'/>
<exports symbol='XML_PARSE_SAX1' type='enum'/>
<exports symbol='XML_PARSE_UNKNOWN' type='enum'/>
<exports symbol='XML_PARSE_UNZIP' type='enum'/>
<exports symbol='XML_PARSE_XINCLUDE' type='enum'/>
<exports symbol='XML_RESOURCE_DTD' type='enum'/>
<exports symbol='XML_RESOURCE_GENERAL_ENTITY' type='enum'/>
@ -796,8 +796,25 @@
<summary>internals routines and limits exported by the parser.</summary>
<description>this module exports a number of internal parsing routines they are not really all intended for applications but can prove useful doing low level processing. </description>
<author>Daniel Veillard </author>
<exports symbol='IS_ASCII_DIGIT' type='macro'/>
<exports symbol='IS_ASCII_LETTER' type='macro'/>
<exports symbol='IS_BASECHAR' type='macro'/>
<exports symbol='IS_BLANK' type='macro'/>
<exports symbol='IS_BLANK_CH' type='macro'/>
<exports symbol='IS_BYTE_CHAR' type='macro'/>
<exports symbol='IS_CHAR' type='macro'/>
<exports symbol='IS_CHAR_CH' type='macro'/>
<exports symbol='IS_COMBINING' type='macro'/>
<exports symbol='IS_COMBINING_CH' type='macro'/>
<exports symbol='IS_DIGIT' type='macro'/>
<exports symbol='IS_DIGIT_CH' type='macro'/>
<exports symbol='IS_EXTENDER' type='macro'/>
<exports symbol='IS_EXTENDER_CH' type='macro'/>
<exports symbol='IS_IDEOGRAPHIC' type='macro'/>
<exports symbol='IS_LETTER' type='macro'/>
<exports symbol='IS_LETTER_CH' type='macro'/>
<exports symbol='IS_PUBIDCHAR' type='macro'/>
<exports symbol='IS_PUBIDCHAR_CH' type='macro'/>
<exports symbol='XML_MAX_DICTIONARY_LIMIT' type='macro'/>
<exports symbol='XML_MAX_HUGE_LENGTH' type='macro'/>
<exports symbol='XML_MAX_LOOKUP_LIMIT' type='macro'/>
@ -3285,6 +3302,7 @@
<exports symbol='LIBXML_PUSH_ENABLED' type='macro'/>
<exports symbol='LIBXML_READER_ENABLED' type='macro'/>
<exports symbol='LIBXML_REGEXP_ENABLED' type='macro'/>
<exports symbol='LIBXML_RELAXNG_ENABLED' type='macro'/>
<exports symbol='LIBXML_SAX1_ENABLED' type='macro'/>
<exports symbol='LIBXML_SCHEMAS_ENABLED' type='macro'/>
<exports symbol='LIBXML_SCHEMATRON_ENABLED' type='macro'/>
@ -3723,6 +3741,18 @@
<macro name='HTML_TEXT_NODE' file='HTMLtree'>
<info>Macro. A text node in a HTML document is really implemented the same way as a text node in an XML document.</info>
</macro>
<macro name='IS_ASCII_DIGIT' file='parserInternals'>
<info>Macro to check [0-9]</info>
<arg name='c' info='an xmlChar value'/>
</macro>
<macro name='IS_ASCII_LETTER' file='parserInternals'>
<info>Macro to check [a-zA-Z]</info>
<arg name='c' info='an xmlChar value'/>
</macro>
<macro name='IS_BASECHAR' file='parserInternals'>
<info>Macro to check the following production in the XML spec: [85] BaseChar ::= ... long list see REC ...</info>
<arg name='c' info='an UNICODE value (int)'/>
</macro>
<macro name='IS_BLANK' file='parserInternals'>
<info>Macro to check the following production in the XML spec: [3] S ::= (#x20 | #x9 | #xD | #xA)+</info>
<arg name='c' info='an UNICODE value (int)'/>
@ -3731,6 +3761,62 @@
<info>Behaviour same as IS_BLANK</info>
<arg name='c' info='an xmlChar value (normally unsigned char)'/>
</macro>
<macro name='IS_BYTE_CHAR' file='parserInternals'>
<info>Macro to check the following production in the XML spec: [2] Char ::= #x9 | #xA | #xD | [#x20...] any byte character in the accepted range</info>
<arg name='c' info='an byte value (int)'/>
</macro>
<macro name='IS_CHAR' file='parserInternals'>
<info>Macro to check the following production in the XML spec: [2] Char ::= #x9 | #xA | #xD | [#x20-#xD7FF] | [#xE000-#xFFFD] | [#x10000-#x10FFFF] any Unicode character, excluding the surrogate blocks, FFFE, and FFFF.</info>
<arg name='c' info='an UNICODE value (int)'/>
</macro>
<macro name='IS_CHAR_CH' file='parserInternals'>
<info>Behaves like IS_CHAR on single-byte value</info>
<arg name='c' info='an xmlChar (usually an unsigned char)'/>
</macro>
<macro name='IS_COMBINING' file='parserInternals'>
<info>Macro to check the following production in the XML spec: [87] CombiningChar ::= ... long list see REC ...</info>
<arg name='c' info='an UNICODE value (int)'/>
</macro>
<macro name='IS_COMBINING_CH' file='parserInternals'>
<info>Always false (all combining chars &gt; 0xff)</info>
<arg name='c' info='an xmlChar (usually an unsigned char)'/>
</macro>
<macro name='IS_DIGIT' file='parserInternals'>
<info>Macro to check the following production in the XML spec: [88] Digit ::= ... long list see REC ...</info>
<arg name='c' info='an UNICODE value (int)'/>
</macro>
<macro name='IS_DIGIT_CH' file='parserInternals'>
<info>Behaves like IS_DIGIT but with a single byte argument</info>
<arg name='c' info='an xmlChar value (usually an unsigned char)'/>
</macro>
<macro name='IS_EXTENDER' file='parserInternals'>
<info>Macro to check the following production in the XML spec: [89] Extender ::= #x00B7 | #x02D0 | #x02D1 | #x0387 | #x0640 | #x0E46 | #x0EC6 | #x3005 | [#x3031-#x3035] | [#x309D-#x309E] | [#x30FC-#x30FE]</info>
<arg name='c' info='an UNICODE value (int)'/>
</macro>
<macro name='IS_EXTENDER_CH' file='parserInternals'>
<info>Behaves like IS_EXTENDER but with a single-byte argument</info>
<arg name='c' info='an xmlChar value (usually an unsigned char)'/>
</macro>
<macro name='IS_IDEOGRAPHIC' file='parserInternals'>
<info>Macro to check the following production in the XML spec: [86] Ideographic ::= [#x4E00-#x9FA5] | #x3007 | [#x3021-#x3029]</info>
<arg name='c' info='an UNICODE value (int)'/>
</macro>
<macro name='IS_LETTER' file='parserInternals'>
<info>Macro to check the following production in the XML spec: [84] Letter ::= BaseChar | Ideographic</info>
<arg name='c' info='an UNICODE value (int)'/>
</macro>
<macro name='IS_LETTER_CH' file='parserInternals'>
<info>Macro behaves like IS_LETTER, but only check base chars</info>
<arg name='c' info='an xmlChar value (normally unsigned char)'/>
</macro>
<macro name='IS_PUBIDCHAR' file='parserInternals'>
<info>Macro to check the following production in the XML spec: [13] PubidChar ::= #x20 | #xD | #xA | [a-zA-Z0-9] | [-&apos;()+,./:=?;!*#@$_%]</info>
<arg name='c' info='an UNICODE value (int)'/>
</macro>
<macro name='IS_PUBIDCHAR_CH' file='parserInternals'>
<info>Same as IS_PUBIDCHAR but for single-byte value</info>
<arg name='c' info='an xmlChar value (normally unsigned char)'/>
</macro>
<macro name='LIBXML2_NEW_BUFFER' file='tree'>
<info>Macro used to express that the API use the new buffers for xmlParserInputBuffer and xmlOutputBuffer. The change was introduced in 2.9.0.</info>
</macro>
@ -3791,6 +3877,9 @@
<macro name='LIBXML_REGEXP_ENABLED' file='xmlversion'>
<info>Whether the regular expressions interfaces are compiled in</info>
</macro>
<macro name='LIBXML_RELAXNG_ENABLED' file='xmlversion'>
<info>Whether the RelaxNG validation interfaces are compiled in</info>
</macro>
<macro name='LIBXML_SAX1_ENABLED' file='xmlversion'>
<info>Whether the older SAX1 interface is configured in</info>
</macro>
@ -4872,6 +4961,7 @@ and not by parsing an instance'/>
<enum name='XML_PARSER_VALIDATE' file='xmlreader' value='3' type='xmlParserProperties'/>
<enum name='XML_PARSER_XML_DECL' file='parser' value='17' type='xmlParserInputState' info=' before XML decl (but after BOM)'/>
<enum name='XML_PARSE_BIG_LINES' file='parser' value='4194304' type='xmlParserOption' info='Store big lines numbers in text PSVI field since 2.13.0'/>
<enum name='XML_PARSE_CATALOG_PI' file='parser' value='67108864' type='xmlParserOption' info=' allow catalog PIs'/>
<enum name='XML_PARSE_COMPACT' file='parser' value='65536' type='xmlParserOption' info='compact small text nodes; no modification of
the tree allowed afterwards (will possibly
crash if you try to modify the tree)'/>
@ -4890,9 +4980,7 @@ crash if you try to modify the tree)'/>
<enum name='XML_PARSE_NONET' file='parser' value='2048' type='xmlParserOption' info='Forbid network access'/>
<enum name='XML_PARSE_NOWARNING' file='parser' value='64' type='xmlParserOption' info='suppress warning reports'/>
<enum name='XML_PARSE_NOXINCNODE' file='parser' value='32768' type='xmlParserOption' info='do not generate XINCLUDE START/END nodes'/>
<enum name='XML_PARSE_NO_CATALOG_PI' file='parser' value='67108864' type='xmlParserOption' info=' ignore catalog PIs'/>
<enum name='XML_PARSE_NO_SYS_CATALOG' file='parser' value='33554432' type='xmlParserOption' info='disable global system catalog'/>
<enum name='XML_PARSE_NO_UNZIP' file='parser' value='16777216' type='xmlParserOption' info='disable compressed content'/>
<enum name='XML_PARSE_NO_XXE' file='parser' value='8388608' type='xmlParserOption' info='disable loading of external content since 2.14.0'/>
<enum name='XML_PARSE_NSCLEAN' file='parser' value='8192' type='xmlParserOption' info='remove redundant namespaces declarations'/>
<enum name='XML_PARSE_OLD10' file='parser' value='131072' type='xmlParserOption' info='parse using XML-1.0 before update 5'/>
@ -4905,6 +4993,7 @@ crash if you try to modify the tree)'/>
<enum name='XML_PARSE_SAX' file='parser' value='2' type='xmlParserMode'/>
<enum name='XML_PARSE_SAX1' file='parser' value='512' type='xmlParserOption' info='use the SAX1 interface internally'/>
<enum name='XML_PARSE_UNKNOWN' file='parser' value='0' type='xmlParserMode'/>
<enum name='XML_PARSE_UNZIP' file='parser' value='16777216' type='xmlParserOption' info='allow compressed content'/>
<enum name='XML_PARSE_XINCLUDE' file='parser' value='1024' type='xmlParserOption' info='Implement XInclude substitution'/>
<enum name='XML_PATTERN_DEFAULT' file='pattern' value='0' type='xmlPatternFlags' info='simple pattern match'/>
<enum name='XML_PATTERN_XPATH' file='pattern' value='1' type='xmlPatternFlags' info='standard XPath pattern'/>
@ -7611,8 +7700,8 @@ crash if you try to modify the tree)'/>
<arg name='tree' type='xmlEnumerationPtr' info='if it&apos;s an enumeration, the associated list'/>
</function>
<function name='xmlAddChild' file='tree' module='tree'>
<info>Unlink @cur and append it to the children of @parent. If @cur is a text node, it may be merged with an adjacent text node and freed. In this case the text node containing the merged content is returned. If @cur is an attribute node, it is appended to the attributes of @parent. If the attribute list contains an attribute with a name matching @elem, the old attribute is destroyed. General notes: Move operations like xmlAddChild can cause element or attribute nodes to reference namespaces that aren&apos;t declared in one of their ancestors. This can lead to use-after-free errors if the elements containing the declarations are freed later, especially when moving nodes from one document to another. You should consider calling xmlReconciliateNs after a move operation to normalize namespaces. Another option is to call xmlDOMWrapAdoptNode with the target parent before moving a node. For the most part, move operations don&apos;t check whether the resulting tree structure is valid. Users must make sure that parent nodes only receive children of valid types. Inserted child nodes must never be an ancestor of the parent node to avoid cycles in the tree structure. In general, only document, document fragments, elements and attributes should be used as parent nodes. When moving a node between documents and a memory allocation fails, the node&apos;s content will be corrupted and it will be unlinked. In this case, the node must be freed manually. Moving DTDs between documents isn&apos;t supported.</info>
<return type='xmlNodePtr' info='@elem or a sibling if @elem was merged. Returns NULL if arguments are invalid or a memory allocation failed.'/>
<info>Unlink @cur and append it to the children of @parent. If @cur is a text node, it may be merged with an adjacent text node and freed. In this case the text node containing the merged content is returned. If @cur is an attribute node, it is appended to the attributes of @parent. If the attribute list contains an attribute with a name matching @cur, the old attribute is destroyed. General notes: Move operations like xmlAddChild can cause element or attribute nodes to reference namespaces that aren&apos;t declared in one of their ancestors. This can lead to use-after-free errors if the elements containing the declarations are freed later, especially when moving nodes from one document to another. You should consider calling xmlReconciliateNs after a move operation to normalize namespaces. Another option is to call xmlDOMWrapAdoptNode with the target parent before moving a node. For the most part, move operations don&apos;t check whether the resulting tree structure is valid. Users must make sure that parent nodes only receive children of valid types. Inserted child nodes must never be an ancestor of the parent node to avoid cycles in the tree structure. In general, only document, document fragments, elements and attributes should be used as parent nodes. When moving a node between documents and a memory allocation fails, the node&apos;s content will be corrupted and it will be unlinked. In this case, the node must be freed manually. Moving DTDs between documents isn&apos;t supported.</info>
<return type='xmlNodePtr' info='@cur or a sibling if @cur was merged. Returns NULL if arguments are invalid or a memory allocation failed.'/>
<arg name='parent' type='xmlNodePtr' info='the parent node'/>
<arg name='cur' type='xmlNodePtr' info='the child node'/>
</function>
@ -8182,7 +8271,7 @@ crash if you try to modify the tree)'/>
</function>
<function name='xmlCatalogGetDefaults' file='catalog' module='catalog'>
<cond>defined(LIBXML_CATALOG_ENABLED)</cond>
<info>DEPRECATED: Use XML_PARSE_NO_SYS_CATALOG and XML_PARSE_NO_CATALOG_PI. Used to get the user preference w.r.t. to what catalogs should be accepted</info>
<info>DEPRECATED: Use XML_PARSE_NO_SYS_CATALOG and XML_PARSE_CATALOG_PI. Used to get the user preference w.r.t. to what catalogs should be accepted</info>
<return type='xmlCatalogAllow' info='the current xmlCatalogAllow value'/>
</function>
<function name='xmlCatalogGetPublic' file='catalog' module='catalog'>
@ -8263,7 +8352,7 @@ crash if you try to modify the tree)'/>
</function>
<function name='xmlCatalogSetDefaults' file='catalog' module='catalog'>
<cond>defined(LIBXML_CATALOG_ENABLED)</cond>
<info>DEPRECATED: Use XML_PARSE_NO_SYS_CATALOG and XML_PARSE_NO_CATALOG_PI. Used to set the user preference w.r.t. to what catalogs should be accepted</info>
<info>DEPRECATED: Use XML_PARSE_NO_SYS_CATALOG and XML_PARSE_CATALOG_PI. Used to set the user preference w.r.t. to what catalogs should be accepted</info>
<return type='void'/>
<arg name='allow' type='xmlCatalogAllow' info='what catalogs should be accepted'/>
</function>
@ -8586,7 +8675,7 @@ crash if you try to modify the tree)'/>
</function>
<function name='xmlCreatePushParserCtxt' file='parser' module='parser'>
<cond>defined(LIBXML_PUSH_ENABLED)</cond>
<info>Create a parser context for using the XML parser in push mode. See xmlParseChunk. Passing an initial chunk is useless and deprecated. @filename is used as base URI to fetch external entities and for error reports.</info>
<info>Create a parser context for using the XML parser in push mode. See xmlParseChunk. Passing an initial chunk is useless and deprecated. The push parser doesn&apos;t support recovery mode or the XML_PARSE_NOBLANKS option. @filename is used as base URI to fetch external entities and for error reports.</info>
<return type='xmlParserCtxtPtr' info='the new parser context or NULL if a memory allocation failed.'/>
<arg name='sax' type='xmlSAXHandlerPtr' info='a SAX handler (optional)'/>
<arg name='user_data' type='void *' info='user data for SAX callbacks (optional)'/>
@ -8707,7 +8796,7 @@ crash if you try to modify the tree)'/>
<arg name='options' type='int' info='a combination of xmlParserOption'/>
</function>
<function name='xmlCtxtReadFile' file='parser' module='parser'>
<info>Parse an XML file from the filesystem, the network or a user-defined resource loader.</info>
<info>Parse an XML file from the filesystem, the network or a user-defined resource loader. This function always enables the XML_PARSE_UNZIP option for backward compatibility. This feature is potentially insecure and might be removed from later versions.</info>
<return type='xmlDocPtr' info='the resulting document tree'/>
<arg name='ctxt' type='xmlParserCtxtPtr' info='an XML parser context'/>
<arg name='filename' type='const char *' info='a file or URL'/>
@ -8787,7 +8876,7 @@ crash if you try to modify the tree)'/>
<arg name='maxAmpl' type='unsigned' info='maximum amplification factor'/>
</function>
<function name='xmlCtxtSetOptions' file='parser' module='parser'>
<info>Applies the options to the parser context. Unset options are cleared. Available since 2.13.0. With older versions, you can use xmlCtxtUseOptions. XML_PARSE_RECOVER Enable &quot;recovery&quot; mode which allows non-wellformed documents. How this mode behaves exactly is unspecified and may change without further notice. Use of this feature is DISCOURAGED. XML_PARSE_NOENT Despite the confusing name, this option enables substitution of entities. The resulting tree won&apos;t contain any entity reference nodes. This option also enables loading of external entities (both general and parameter entities) which is dangerous. If you process untrusted data, it&apos;s recommended to set the XML_PARSE_NO_XXE option to disable loading of external entities. XML_PARSE_DTDLOAD Enables loading of an external DTD and the loading and substitution of external parameter entities. Has no effect if XML_PARSE_NO_XXE is set. XML_PARSE_DTDATTR Adds default attributes from the DTD to the result document. Implies XML_PARSE_DTDLOAD, but loading of external content can be disabled with XML_PARSE_NO_XXE. XML_PARSE_DTDVALID This option enables DTD validation which requires to load external DTDs and external entities (both general and parameter entities) unless XML_PARSE_NO_XXE was set. XML_PARSE_NO_XXE Disables loading of external DTDs or entities. Available since 2.13.0. XML_PARSE_NOERROR Disable error and warning reports to the error handlers. Errors are still accessible with xmlCtxtGetLastError. XML_PARSE_NOWARNING Disable warning reports. XML_PARSE_PEDANTIC Enable some pedantic warnings. XML_PARSE_NOBLANKS Remove some text nodes containing only whitespace from the result document. Which nodes are removed depends on DTD element declarations or a conservative heuristic. The reindenting feature of the serialization code relies on this option to be set when parsing. Use of this option is DISCOURAGED. XML_PARSE_SAX1 Always invoke the deprecated SAX1 startElement and endElement handlers. This option is DEPRECATED. XML_PARSE_NONET Disable network access with the builtin HTTP client. XML_PARSE_NODICT Create a document without interned strings, making all strings separate memory allocations. XML_PARSE_NSCLEAN Remove redundant namespace declarations from the result document. XML_PARSE_NOCDATA Output normal text nodes instead of CDATA nodes. XML_PARSE_COMPACT Store small strings directly in the node struct to save memory. XML_PARSE_OLD10 Use old Name productions from before XML 1.0 Fifth Edition. This options is DEPRECATED. XML_PARSE_HUGE Relax some internal limits. Maximum size of text nodes, tags, comments, processing instructions, CDATA sections, entity values normal: 10M huge: 1B Maximum size of names, system literals, pubid literals normal: 50K huge: 10M Maximum nesting depth of elements normal: 256 huge: 2048 Maximum nesting depth of entities normal: 20 huge: 40 XML_PARSE_OLDSAX Enable an unspecified legacy mode for SAX parsers. This option is DEPRECATED. XML_PARSE_IGNORE_ENC Ignore the encoding in the XML declaration. This option is mostly unneeded these days. The only effect is to enforce UTF-8 decoding of ASCII-like data. XML_PARSE_BIG_LINES Enable reporting of line numbers larger than 65535. XML_PARSE_NO_UNZIP Disables input decompression. Setting this option is recommended to avoid zip bombs. Available since 2.14.0. XML_PARSE_NO_SYS_CATALOG Disables the global system XML catalog. Available since 2.14.0. XML_PARSE_NO_CATALOG_PI Ignore XML catalog processing instructions. Available since 2.14.0.</info>
<info>Applies the options to the parser context. Unset options are cleared. Available since 2.13.0. With older versions, you can use xmlCtxtUseOptions. XML_PARSE_RECOVER Enable &quot;recovery&quot; mode which allows non-wellformed documents. How this mode behaves exactly is unspecified and may change without further notice. Use of this feature is DISCOURAGED. Not supported by the push parser. XML_PARSE_NOENT Despite the confusing name, this option enables substitution of entities. The resulting tree won&apos;t contain any entity reference nodes. This option also enables loading of external entities (both general and parameter entities) which is dangerous. If you process untrusted data, it&apos;s recommended to set the XML_PARSE_NO_XXE option to disable loading of external entities. XML_PARSE_DTDLOAD Enables loading of an external DTD and the loading and substitution of external parameter entities. Has no effect if XML_PARSE_NO_XXE is set. XML_PARSE_DTDATTR Adds default attributes from the DTD to the result document. Implies XML_PARSE_DTDLOAD, but loading of external content can be disabled with XML_PARSE_NO_XXE. XML_PARSE_DTDVALID This option enables DTD validation which requires to load external DTDs and external entities (both general and parameter entities) unless XML_PARSE_NO_XXE was set. XML_PARSE_NO_XXE Disables loading of external DTDs or entities. Available since 2.13.0. XML_PARSE_NOERROR Disable error and warning reports to the error handlers. Errors are still accessible with xmlCtxtGetLastError. XML_PARSE_NOWARNING Disable warning reports. XML_PARSE_PEDANTIC Enable some pedantic warnings. XML_PARSE_NOBLANKS Remove some whitespace from the result document. Where to remove whitespace depends on DTD element declarations or a broken heuristic with unfixable bugs. Use of this option is DISCOURAGED. Not supported by the push parser. XML_PARSE_SAX1 Always invoke the deprecated SAX1 startElement and endElement handlers. This option is DEPRECATED. XML_PARSE_NONET Disable network access with the builtin HTTP client. XML_PARSE_NODICT Create a document without interned strings, making all strings separate memory allocations. XML_PARSE_NSCLEAN Remove redundant namespace declarations from the result document. XML_PARSE_NOCDATA Output normal text nodes instead of CDATA nodes. XML_PARSE_COMPACT Store small strings directly in the node struct to save memory. XML_PARSE_OLD10 Use old Name productions from before XML 1.0 Fifth Edition. This options is DEPRECATED. XML_PARSE_HUGE Relax some internal limits. Maximum size of text nodes, tags, comments, processing instructions, CDATA sections, entity values normal: 10M huge: 1B Maximum size of names, system literals, pubid literals normal: 50K huge: 10M Maximum nesting depth of elements normal: 256 huge: 2048 Maximum nesting depth of entities normal: 20 huge: 40 XML_PARSE_OLDSAX Enable an unspecified legacy mode for SAX parsers. This option is DEPRECATED. XML_PARSE_IGNORE_ENC Ignore the encoding in the XML declaration. This option is mostly unneeded these days. The only effect is to enforce UTF-8 decoding of ASCII-like data. XML_PARSE_BIG_LINES Enable reporting of line numbers larger than 65535. XML_PARSE_UNZIP Enable input decompression. Setting this option is discouraged to avoid zip bombs. Available since 2.14.0. XML_PARSE_NO_SYS_CATALOG Disables the global system XML catalog. Available since 2.14.0. XML_PARSE_CATALOG_PI Enable XML catalog processing instructions. Available since 2.14.0.</info>
<return type='int' info='0 in case of success, the set of unknown or unimplemented options in case of error.'/>
<arg name='ctxt' type='xmlParserCtxtPtr' info='an XML parser context'/>
<arg name='options' type='int' info='a bitmask of xmlParserOption values'/>
@ -10715,11 +10804,11 @@ crash if you try to modify the tree)'/>
<arg name='enc' type='xmlCharEncoding' info='the charset encoding if known'/>
</function>
<function name='xmlNewInputFromFd' file='parser' module='parserInternals'>
<info>Creates a new parser input to read from a zero-terminated string. @url is used as base to resolve external entities and for error reporting. @fd is closed after parsing has finished. Available since 2.14.0.</info>
<info>Creates a new parser input to read from a zero-terminated string. @url is used as base to resolve external entities and for error reporting. @fd is closed after parsing has finished. Supported @flags are XML_INPUT_UNZIP to decompress data automatically. This feature is deprecated and will be removed in a future release. Available since 2.14.0.</info>
<return type='xmlParserInputPtr' info='a new parser input or NULL if a memory allocation failed.'/>
<arg name='url' type='const char *' info='base URL (optional)'/>
<arg name='fd' type='int' info='file descriptor'/>
<arg name='flags' type='int' info='unused, pass 0'/>
<arg name='flags' type='int' info='input flags'/>
</function>
<function name='xmlNewInputFromFile' file='parserInternals' module='parserInternals'>
<info>DEPRECATED: Use xmlNewInputFromUrl. Create a new input stream based on a file or an URL.</info>
@ -11284,7 +11373,7 @@ crash if you try to modify the tree)'/>
</function>
<function name='xmlParseChunk' file='parser' module='parser'>
<cond>defined(LIBXML_PUSH_ENABLED)</cond>
<info>Parse a chunk of memory in push parser mode. Assumes that the parser context was initialized with xmlCreatePushParserCtxt. The last chunk, which will often be empty, must be marked with the @terminate flag. With the default SAX callbacks, the resulting document will be available in ctxt-&gt;myDoc. This pointer will not be freed by the library. If the document isn&apos;t well-formed, ctxt-&gt;myDoc is set to NULL. The push parser doesn&apos;t support recovery mode.</info>
<info>Parse a chunk of memory in push parser mode. Assumes that the parser context was initialized with xmlCreatePushParserCtxt. The last chunk, which will often be empty, must be marked with the @terminate flag. With the default SAX callbacks, the resulting document will be available in ctxt-&gt;myDoc. This pointer will not be freed when calling xmlFreeParserCtxt and must be freed by the caller. If the document isn&apos;t well-formed, it will still be returned in ctxt-&gt;myDoc. As an exception, xmlCtxtResetPush will free the document in ctxt-&gt;myDoc. So ctxt-&gt;myDoc should be set to NULL after extracting the document.</info>
<return type='int' info='an xmlParserErrors code (0 on success).'/>
<arg name='ctxt' type='xmlParserCtxtPtr' info='an XML parser context'/>
<arg name='chunk' type='const char *' info='chunk of memory'/>
@ -11865,7 +11954,7 @@ crash if you try to modify the tree)'/>
<arg name='options' type='int' info='a combination of xmlParserOption'/>
</function>
<function name='xmlReadFile' file='parser' module='parser'>
<info>Convenience function to parse an XML file from the filesystem, the network or a global user-define resource loader. See xmlCtxtReadFile for details.</info>
<info>Convenience function to parse an XML file from the filesystem, the network or a global user-define resource loader. This function always enables the XML_PARSE_UNZIP option for backward compatibility. If a &quot;-&quot; filename is passed, it will read from stdin. Both of these features are potentially insecure and might be removed from later versions. See xmlCtxtReadFile for details.</info>
<return type='xmlDocPtr' info='the resulting document tree'/>
<arg name='filename' type='const char *' info='a file or URL'/>
<arg name='encoding' type='const char *' info='the document encoding (optional)'/>
@ -12129,7 +12218,7 @@ crash if you try to modify the tree)'/>
</function>
<function name='xmlRegexpPrint' file='xmlregexp' module='xmlregexp'>
<cond>defined(LIBXML_REGEXP_ENABLED)</cond>
<info>Print the content of the compiled regular expression</info>
<info>DEPRECATED: Don&apos;t use. No-op since 2.14.0.</info>
<return type='void'/>
<arg name='output' type='FILE *' info='the file for the output debug'/>
<arg name='regexp' type='xmlRegexpPtr' info='the compiled regexp'/>
@ -12907,7 +12996,7 @@ crash if you try to modify the tree)'/>
<arg name='val' type='xmlSchemaValPtr' info='the precomputed value to be copied'/>
</function>
<function name='xmlSchemaDump' file='xmlschemas' module='xmlschemas'>
<cond>defined(LIBXML_SCHEMAS_ENABLED) &amp;&amp; defined(LIBXML_OUTPUT_ENABLED)</cond>
<cond>defined(LIBXML_SCHEMAS_ENABLED) &amp;&amp; defined(LIBXML_DEBUG_ENABLED)</cond>
<info>Dump a Schema structure.</info>
<return type='void'/>
<arg name='output' type='FILE *' info='the file output'/>
@ -13289,7 +13378,7 @@ crash if you try to modify the tree)'/>
<arg name='ctxt' type='xmlSchemaValidCtxtPtr' info='a schema validation context'/>
<arg name='input' type='xmlParserInputBufferPtr' info='the input to use for reading the data'/>
<arg name='enc' type='xmlCharEncoding' info='an optional encoding information'/>
<arg name='sax' type='xmlSAXHandlerPtr' info='a SAX handler for the resulting events'/>
<arg name='sax' type='const xmlSAXHandler *' info='a SAX handler for the resulting events'/>
<arg name='user_data' type='void *' info='the context to provide to the SAX handler.'/>
</function>
<functype name='xmlSchemaValidityErrorFunc' file='xmlschemas' module='xmlschemas'>
@ -14184,7 +14273,7 @@ crash if you try to modify the tree)'/>
<function name='xmlTextReaderReadString' file='xmlreader' module='xmlreader'>
<cond>defined(LIBXML_READER_ENABLED)</cond>
<info>Reads the contents of an element or a text node as a string.</info>
<return type='xmlChar *' info='a string containing the contents of the Element or Text node, or NULL if the reader is positioned on any other type of node. The string must be deallocated by the caller.'/>
<return type='xmlChar *' info='a string containing the contents of the non-empty Element or Text node (including CDATA sections), or NULL if the reader is positioned on any other type of node. The string must be deallocated by the caller.'/>
<arg name='reader' type='xmlTextReaderPtr' info='the xmlTextReaderPtr used'/>
</function>
<function name='xmlTextReaderRelaxNGSetSchema' file='xmlreader' module='xmlreader'>

3
xmllint.c
View File

@ -208,7 +208,8 @@ typedef struct {
char *htmlBuf;
int htmlBufLen;
xmlTime begin, end;
xmlTime begin;
xmlTime end;
} xmllintState;
static int xmllintMaxmem;