1
0
mirror of https://github.com/GNOME/libxml2.git synced 2025-05-07 20:39:30 +08:00

doc: Remove more comment block headers

This commit is contained in:
Nick Wellnhofer 2025-05-02 15:57:17 +02:00
parent 103f0203e0
commit f7c412874b
32 changed files with 34 additions and 607 deletions

View File

@ -1542,7 +1542,6 @@ htmlCheckImplied(htmlParserCtxtPtr ctxt, const xmlChar *newtag) {
}
/**
* htmlStartCharData
* @param ctxt an HTML parser context
*
* Prepare for non-whitespace character data.
@ -2162,7 +2161,6 @@ static const char *allowPCData[] = {
};
/**
* areBlanks:
* @param ctxt an HTML parser context
* @param str a xmlChar *
* @param len the size of `str`
@ -5545,7 +5543,6 @@ htmlNodeStatus(htmlNodePtr node ATTRIBUTE_UNUSED,
* *
************************************************************************/
/**
* DICT_FREE:
* @param str a string
*
* Free a string if it is not owned by the "dict" dictionary in the

View File

@ -223,7 +223,6 @@ xmlMallocFunc xmlMallocAtomic = malloc;
*/
xmlReallocFunc xmlRealloc = realloc;
/**
* xmlPosixStrdup
* @param cur the input char *
*
* a strdup implementation with a type signature matching POSIX
@ -799,7 +798,6 @@ xmlGetLastErrorInternal(void) {
/** @cond IGNORE */
/**
* DllMain:
* @param hinstDLL handle to DLL instance
* @param fdwReason Reason code for entry
* @param lpvReserved generic pointer (depends upon reason code)

View File

@ -27,36 +27,26 @@ extern "C" {
/**
* HTML_TEXT_NODE:
*
* Macro. A text node in a HTML document is really implemented
* the same way as a text node in an XML document.
*/
#define HTML_TEXT_NODE XML_TEXT_NODE
/**
* HTML_ENTITY_REF_NODE:
*
* Macro. An entity reference in a HTML document is really implemented
* the same way as an entity reference in an XML document.
*/
#define HTML_ENTITY_REF_NODE XML_ENTITY_REF_NODE
/**
* HTML_COMMENT_NODE:
*
* Macro. A comment in a HTML document is really implemented
* the same way as a comment in an XML document.
*/
#define HTML_COMMENT_NODE XML_COMMENT_NODE
/**
* HTML_PRESERVE_NODE:
*
* Macro. A preserved node in a HTML document is really implemented
* the same way as a CDATA section in an XML document.
*/
#define HTML_PRESERVE_NODE XML_CDATA_SECTION_NODE
/**
* HTML_PI_NODE:
*
* Macro. A processing instruction in a HTML document is really implemented
* the same way as a processing instruction in an XML document.
*/

View File

@ -33,15 +33,11 @@ extern "C" {
#endif
/**
* XML_CATALOGS_NAMESPACE:
*
* The namespace for the XML Catalogs elements.
*/
#define XML_CATALOGS_NAMESPACE \
(const xmlChar *) "urn:oasis:names:tc:entity:xmlns:xml:catalog"
/**
* XML_CATALOG_PI:
*
* The specific XML Catalog Processing Instruction name.
*/
#define XML_CATALOG_PI \

View File

@ -34,7 +34,6 @@ typedef xmlHashTable *xmlHashTablePtr;
* serious trouble within the library.
*/
/**
* XML_CAST_FPTR:
* @param fptr pointer to a function
*
* Macro to do a casting from an object pointer to a

View File

@ -35,8 +35,6 @@ extern "C" {
#endif
/**
* XML_DEFAULT_VERSION:
*
* The default version of XML used: 1.0
*/
#define XML_DEFAULT_VERSION "1.0"
@ -498,7 +496,6 @@ struct _xmlSAXLocator {
};
/**
* resolveEntitySAXFunc:
* @param ctx the user data (XML parser context)
* @param publicId The public ID of the entity
* @param systemId The system ID of the entity
@ -516,7 +513,6 @@ typedef xmlParserInputPtr (*resolveEntitySAXFunc) (void *ctx,
const xmlChar *publicId,
const xmlChar *systemId);
/**
* internalSubsetSAXFunc:
* @param ctx the user data (XML parser context)
* @param name the root element name
* @param ExternalID the external ID
@ -529,7 +525,6 @@ typedef void (*internalSubsetSAXFunc) (void *ctx,
const xmlChar *ExternalID,
const xmlChar *SystemID);
/**
* externalSubsetSAXFunc:
* @param ctx the user data (XML parser context)
* @param name the root element name
* @param ExternalID the external ID
@ -542,7 +537,6 @@ typedef void (*externalSubsetSAXFunc) (void *ctx,
const xmlChar *ExternalID,
const xmlChar *SystemID);
/**
* getEntitySAXFunc:
* @param ctx the user data (XML parser context)
* @param name The entity name
*
@ -553,7 +547,6 @@ typedef void (*externalSubsetSAXFunc) (void *ctx,
typedef xmlEntityPtr (*getEntitySAXFunc) (void *ctx,
const xmlChar *name);
/**
* getParameterEntitySAXFunc:
* @param ctx the user data (XML parser context)
* @param name The entity name
*
@ -564,7 +557,6 @@ typedef xmlEntityPtr (*getEntitySAXFunc) (void *ctx,
typedef xmlEntityPtr (*getParameterEntitySAXFunc) (void *ctx,
const xmlChar *name);
/**
* entityDeclSAXFunc:
* @param ctx the user data (XML parser context)
* @param name the entity name
* @param type the entity type
@ -581,7 +573,6 @@ typedef void (*entityDeclSAXFunc) (void *ctx,
const xmlChar *systemId,
xmlChar *content);
/**
* notationDeclSAXFunc:
* @param ctx the user data (XML parser context)
* @param name The name of the notation
* @param publicId The public ID of the entity
@ -594,7 +585,6 @@ typedef void (*notationDeclSAXFunc)(void *ctx,
const xmlChar *publicId,
const xmlChar *systemId);
/**
* attributeDeclSAXFunc:
* @param ctx the user data (XML parser context)
* @param elem the name of the element
* @param fullname the attribute name
@ -613,7 +603,6 @@ typedef void (*attributeDeclSAXFunc)(void *ctx,
const xmlChar *defaultValue,
xmlEnumerationPtr tree);
/**
* elementDeclSAXFunc:
* @param ctx the user data (XML parser context)
* @param name the element name
* @param type the element type
@ -626,7 +615,6 @@ typedef void (*elementDeclSAXFunc)(void *ctx,
int type,
xmlElementContentPtr content);
/**
* unparsedEntityDeclSAXFunc:
* @param ctx the user data (XML parser context)
* @param name The name of the entity
* @param publicId The public ID of the entity
@ -641,7 +629,6 @@ typedef void (*unparsedEntityDeclSAXFunc)(void *ctx,
const xmlChar *systemId,
const xmlChar *notationName);
/**
* setDocumentLocatorSAXFunc:
* @param ctx the user data (XML parser context)
* @param loc A SAX Locator
*
@ -651,21 +638,18 @@ typedef void (*unparsedEntityDeclSAXFunc)(void *ctx,
typedef void (*setDocumentLocatorSAXFunc) (void *ctx,
xmlSAXLocatorPtr loc);
/**
* startDocumentSAXFunc:
* @param ctx the user data (XML parser context)
*
* Called when the document start being processed.
*/
typedef void (*startDocumentSAXFunc) (void *ctx);
/**
* endDocumentSAXFunc:
* @param ctx the user data (XML parser context)
*
* Called when the document end has been detected.
*/
typedef void (*endDocumentSAXFunc) (void *ctx);
/**
* startElementSAXFunc:
* @param ctx the user data (XML parser context)
* @param name The element name, including namespace prefix
* @param atts An array of name/value attributes pairs, NULL terminated
@ -676,7 +660,6 @@ typedef void (*startElementSAXFunc) (void *ctx,
const xmlChar *name,
const xmlChar **atts);
/**
* endElementSAXFunc:
* @param ctx the user data (XML parser context)
* @param name The element name
*
@ -685,7 +668,6 @@ typedef void (*startElementSAXFunc) (void *ctx,
typedef void (*endElementSAXFunc) (void *ctx,
const xmlChar *name);
/**
* attributeSAXFunc:
* @param ctx the user data (XML parser context)
* @param name The attribute name, including namespace prefix
* @param value The attribute value
@ -699,7 +681,6 @@ typedef void (*attributeSAXFunc) (void *ctx,
const xmlChar *name,
const xmlChar *value);
/**
* referenceSAXFunc:
* @param ctx the user data (XML parser context)
* @param name The entity name
*
@ -708,7 +689,6 @@ typedef void (*attributeSAXFunc) (void *ctx,
typedef void (*referenceSAXFunc) (void *ctx,
const xmlChar *name);
/**
* charactersSAXFunc:
* @param ctx the user data (XML parser context)
* @param ch a xmlChar string
* @param len the number of xmlChar
@ -719,7 +699,6 @@ typedef void (*charactersSAXFunc) (void *ctx,
const xmlChar *ch,
int len);
/**
* ignorableWhitespaceSAXFunc:
* @param ctx the user data (XML parser context)
* @param ch a xmlChar string
* @param len the number of xmlChar
@ -731,7 +710,6 @@ typedef void (*ignorableWhitespaceSAXFunc) (void *ctx,
const xmlChar *ch,
int len);
/**
* processingInstructionSAXFunc:
* @param ctx the user data (XML parser context)
* @param target the target name
* @param data the PI data's
@ -742,7 +720,6 @@ typedef void (*processingInstructionSAXFunc) (void *ctx,
const xmlChar *target,
const xmlChar *data);
/**
* commentSAXFunc:
* @param ctx the user data (XML parser context)
* @param value the comment content
*
@ -751,7 +728,6 @@ typedef void (*processingInstructionSAXFunc) (void *ctx,
typedef void (*commentSAXFunc) (void *ctx,
const xmlChar *value);
/**
* cdataBlockSAXFunc:
* @param ctx the user data (XML parser context)
* @param value The pcdata content
* @param len the block length
@ -763,7 +739,6 @@ typedef void (*cdataBlockSAXFunc) (
const xmlChar *value,
int len);
/**
* warningSAXFunc:
* @param ctx an XML parser context
* @param msg the message to display/transmit
* @...: extra parameters for the message display
@ -773,7 +748,6 @@ typedef void (*cdataBlockSAXFunc) (
typedef void (*warningSAXFunc) (void *ctx,
const char *msg, ...) LIBXML_ATTR_FORMAT(2,3);
/**
* errorSAXFunc:
* @param ctx an XML parser context
* @param msg the message to display/transmit
* @...: extra parameters for the message display
@ -783,7 +757,6 @@ typedef void (*warningSAXFunc) (void *ctx,
typedef void (*errorSAXFunc) (void *ctx,
const char *msg, ...) LIBXML_ATTR_FORMAT(2,3);
/**
* fatalErrorSAXFunc:
* @param ctx an XML parser context
* @param msg the message to display/transmit
* @...: extra parameters for the message display
@ -795,7 +768,6 @@ typedef void (*errorSAXFunc) (void *ctx,
typedef void (*fatalErrorSAXFunc) (void *ctx,
const char *msg, ...) LIBXML_ATTR_FORMAT(2,3);
/**
* isStandaloneSAXFunc:
* @param ctx the user data (XML parser context)
*
* Is this document tagged standalone?
@ -804,7 +776,6 @@ typedef void (*fatalErrorSAXFunc) (void *ctx,
*/
typedef int (*isStandaloneSAXFunc) (void *ctx);
/**
* hasInternalSubsetSAXFunc:
* @param ctx the user data (XML parser context)
*
* Does this document has an internal subset.
@ -814,7 +785,6 @@ typedef int (*isStandaloneSAXFunc) (void *ctx);
typedef int (*hasInternalSubsetSAXFunc) (void *ctx);
/**
* hasExternalSubsetSAXFunc:
* @param ctx the user data (XML parser context)
*
* Does this document has an external subset?
@ -829,14 +799,11 @@ typedef int (*hasExternalSubsetSAXFunc) (void *ctx);
* *
************************************************************************/
/**
* XML_SAX2_MAGIC:
*
* Special constant found in SAX2 blocks initialized fields
*/
#define XML_SAX2_MAGIC 0xDEEDBEAF
/**
* startElementNsSAX2Func:
* @param ctx the user data (XML parser context)
* @param localname the local name of the element
* @param prefix the element namespace prefix if available
@ -865,7 +832,6 @@ typedef void (*startElementNsSAX2Func) (void *ctx,
const xmlChar **attributes);
/**
* endElementNsSAX2Func:
* @param ctx the user data (XML parser context)
* @param localname the local name of the element
* @param prefix the element namespace prefix if available

View File

@ -33,8 +33,6 @@ extern "C" {
#define xmlParserMaxDepth 256
/**
* XML_MAX_TEXT_LENGTH:
*
* Maximum size allowed for a single text node when building a tree.
* This is not a limitation of the parser but a safety boundary feature,
* use XML_PARSE_HUGE option to override it.
@ -43,15 +41,11 @@ extern "C" {
#define XML_MAX_TEXT_LENGTH 10000000
/**
* XML_MAX_HUGE_LENGTH:
*
* Maximum size allowed when XML_PARSE_HUGE is set.
*/
#define XML_MAX_HUGE_LENGTH 1000000000
/**
* XML_MAX_NAME_LENGTH:
*
* Maximum size allowed for a markup identifier.
* This is not a limitation of the parser but a safety boundary feature,
* use XML_PARSE_HUGE option to override it.
@ -62,8 +56,6 @@ extern "C" {
#define XML_MAX_NAME_LENGTH 50000
/**
* XML_MAX_DICTIONARY_LIMIT:
*
* Maximum size allowed by the parser for a dictionary by default
* This is not a limitation of the parser but a safety boundary feature,
* use XML_PARSE_HUGE option to override it.
@ -72,8 +64,6 @@ extern "C" {
#define XML_MAX_DICTIONARY_LIMIT 100000000
/**
* XML_MAX_LOOKUP_LIMIT:
*
* Maximum size allowed by the parser for ahead lookup
* This is an upper boundary enforced by the parser to avoid bad
* behaviour on "unfriendly' content
@ -82,8 +72,6 @@ extern "C" {
#define XML_MAX_LOOKUP_LIMIT 10000000
/**
* XML_MAX_NAMELEN:
*
* Identifiers can be longer, but this will be more costly
* at runtime.
*/
@ -95,7 +83,6 @@ extern "C" {
* *
************************************************************************/
/**
* IS_BYTE_CHAR:
* @param c an byte value (int)
*
* Macro to check the following production in the XML spec:
@ -106,7 +93,6 @@ extern "C" {
#define IS_BYTE_CHAR(c) xmlIsChar_ch(c)
/**
* IS_CHAR:
* @param c an UNICODE value (int)
*
* Macro to check the following production in the XML spec:
@ -118,7 +104,6 @@ extern "C" {
#define IS_CHAR(c) xmlIsCharQ(c)
/**
* IS_CHAR_CH:
* @param c an xmlChar (usually an unsigned char)
*
* Behaves like IS_CHAR on single-byte value
@ -126,7 +111,6 @@ extern "C" {
#define IS_CHAR_CH(c) xmlIsChar_ch(c)
/**
* IS_BLANK:
* @param c an UNICODE value (int)
*
* Macro to check the following production in the XML spec:
@ -136,7 +120,6 @@ extern "C" {
#define IS_BLANK(c) xmlIsBlankQ(c)
/**
* IS_BLANK_CH:
* @param c an xmlChar value (normally unsigned char)
*
* Behaviour same as IS_BLANK
@ -144,7 +127,6 @@ extern "C" {
#define IS_BLANK_CH(c) xmlIsBlank_ch(c)
/**
* IS_BASECHAR:
* @param c an UNICODE value (int)
*
* Macro to check the following production in the XML spec:
@ -154,7 +136,6 @@ extern "C" {
#define IS_BASECHAR(c) xmlIsBaseCharQ(c)
/**
* IS_DIGIT:
* @param c an UNICODE value (int)
*
* Macro to check the following production in the XML spec:
@ -164,7 +145,6 @@ extern "C" {
#define IS_DIGIT(c) xmlIsDigitQ(c)
/**
* IS_DIGIT_CH:
* @param c an xmlChar value (usually an unsigned char)
*
* Behaves like IS_DIGIT but with a single byte argument
@ -172,7 +152,6 @@ extern "C" {
#define IS_DIGIT_CH(c) xmlIsDigit_ch(c)
/**
* IS_COMBINING:
* @param c an UNICODE value (int)
*
* Macro to check the following production in the XML spec:
@ -182,7 +161,6 @@ extern "C" {
#define IS_COMBINING(c) xmlIsCombiningQ(c)
/**
* IS_COMBINING_CH:
* @param c an xmlChar (usually an unsigned char)
*
* Always false (all combining chars > 0xff)
@ -190,7 +168,6 @@ extern "C" {
#define IS_COMBINING_CH(c) 0
/**
* IS_EXTENDER:
* @param c an UNICODE value (int)
*
* Macro to check the following production in the XML spec:
@ -203,7 +180,6 @@ extern "C" {
#define IS_EXTENDER(c) xmlIsExtenderQ(c)
/**
* IS_EXTENDER_CH:
* @param c an xmlChar value (usually an unsigned char)
*
* Behaves like IS_EXTENDER but with a single-byte argument
@ -211,7 +187,6 @@ extern "C" {
#define IS_EXTENDER_CH(c) xmlIsExtender_ch(c)
/**
* IS_IDEOGRAPHIC:
* @param c an UNICODE value (int)
*
* Macro to check the following production in the XML spec:
@ -222,7 +197,6 @@ extern "C" {
#define IS_IDEOGRAPHIC(c) xmlIsIdeographicQ(c)
/**
* IS_LETTER:
* @param c an UNICODE value (int)
*
* Macro to check the following production in the XML spec:
@ -233,7 +207,6 @@ extern "C" {
#define IS_LETTER(c) (IS_BASECHAR(c) || IS_IDEOGRAPHIC(c))
/**
* IS_LETTER_CH:
* @param c an xmlChar value (normally unsigned char)
*
* Macro behaves like IS_LETTER, but only check base chars
@ -242,7 +215,6 @@ extern "C" {
#define IS_LETTER_CH(c) xmlIsBaseChar_ch(c)
/**
* IS_ASCII_LETTER:
* @param c an xmlChar value
*
* Macro to check [a-zA-Z]
@ -252,7 +224,6 @@ extern "C" {
(((c) | 0x20) <= 0x7a))
/**
* IS_ASCII_DIGIT:
* @param c an xmlChar value
*
* Macro to check [0-9]
@ -261,7 +232,6 @@ extern "C" {
#define IS_ASCII_DIGIT(c) ((0x30 <= (c)) && ((c) <= 0x39))
/**
* IS_PUBIDCHAR:
* @param c an UNICODE value (int)
*
* Macro to check the following production in the XML spec:
@ -272,7 +242,6 @@ extern "C" {
#define IS_PUBIDCHAR(c) xmlIsPubidCharQ(c)
/**
* IS_PUBIDCHAR_CH:
* @param c an xmlChar value (normally unsigned char)
*
* Same as IS_PUBIDCHAR but for single-byte value
@ -514,26 +483,18 @@ XMLPUBFUN void
const xmlChar *ExternalID,
const xmlChar *SystemID);
/**
* XML_SUBSTITUTE_NONE:
*
* If no entities need to be substituted.
*/
#define XML_SUBSTITUTE_NONE 0
/**
* XML_SUBSTITUTE_REF:
*
* Whether general entities need to be substituted.
*/
#define XML_SUBSTITUTE_REF 1
/**
* XML_SUBSTITUTE_PEREF:
*
* Whether parameter entities need to be substituted.
*/
#define XML_SUBSTITUTE_PEREF 2
/**
* XML_SUBSTITUTE_BOTH:
*
* Both general and parameter entities need to be substituted.
*/
#define XML_SUBSTITUTE_BOTH 3

View File

@ -157,87 +157,61 @@ struct _xmlSchemaAnnot {
};
/**
* XML_SCHEMAS_ANYATTR_SKIP:
*
* Skip unknown attribute from validation
* Obsolete, not used anymore.
*/
#define XML_SCHEMAS_ANYATTR_SKIP 1
/**
* XML_SCHEMAS_ANYATTR_LAX:
*
* Ignore validation non definition on attributes
* Obsolete, not used anymore.
*/
#define XML_SCHEMAS_ANYATTR_LAX 2
/**
* XML_SCHEMAS_ANYATTR_STRICT:
*
* Apply strict validation rules on attributes
* Obsolete, not used anymore.
*/
#define XML_SCHEMAS_ANYATTR_STRICT 3
/**
* XML_SCHEMAS_ANY_SKIP:
*
* Skip unknown attribute from validation
*/
#define XML_SCHEMAS_ANY_SKIP 1
/**
* XML_SCHEMAS_ANY_LAX:
*
* Used by wildcards.
* Validate if type found, don't worry if not found
*/
#define XML_SCHEMAS_ANY_LAX 2
/**
* XML_SCHEMAS_ANY_STRICT:
*
* Used by wildcards.
* Apply strict validation rules
*/
#define XML_SCHEMAS_ANY_STRICT 3
/**
* XML_SCHEMAS_ATTR_USE_PROHIBITED:
*
* Used by wildcards.
* The attribute is prohibited.
*/
#define XML_SCHEMAS_ATTR_USE_PROHIBITED 0
/**
* XML_SCHEMAS_ATTR_USE_REQUIRED:
*
* The attribute is required.
*/
#define XML_SCHEMAS_ATTR_USE_REQUIRED 1
/**
* XML_SCHEMAS_ATTR_USE_OPTIONAL:
*
* The attribute is optional.
*/
#define XML_SCHEMAS_ATTR_USE_OPTIONAL 2
/**
* XML_SCHEMAS_ATTR_GLOBAL:
*
* allow elements in no namespace
*/
#define XML_SCHEMAS_ATTR_GLOBAL 1 << 0
/**
* XML_SCHEMAS_ATTR_NSDEFAULT:
*
* allow elements in no namespace
*/
#define XML_SCHEMAS_ATTR_NSDEFAULT 1 << 7
/**
* XML_SCHEMAS_ATTR_INTERNAL_RESOLVED:
*
* this is set when the "type" and "ref" references
* have been resolved.
*/
#define XML_SCHEMAS_ATTR_INTERNAL_RESOLVED 1 << 8
/**
* XML_SCHEMAS_ATTR_FIXED:
*
* the attribute has a fixed value
*/
#define XML_SCHEMAS_ATTR_FIXED 1 << 9
@ -283,8 +257,6 @@ struct _xmlSchemaAttributeLink {
};
/**
* XML_SCHEMAS_WILDCARD_COMPLETE:
*
* If the wildcard is complete.
*/
#define XML_SCHEMAS_WILDCARD_COMPLETE 1 << 0
@ -300,7 +272,6 @@ struct _xmlSchemaWildcardNs {
};
/*
* xmlSchemaWildcard.
* A wildcard.
*/
typedef struct _xmlSchemaWildcard xmlSchemaWildcard;
@ -320,33 +291,23 @@ struct _xmlSchemaWildcard {
};
/**
* XML_SCHEMAS_ATTRGROUP_WILDCARD_BUILDED:
*
* The attribute wildcard has been built.
*/
#define XML_SCHEMAS_ATTRGROUP_WILDCARD_BUILDED 1 << 0
/**
* XML_SCHEMAS_ATTRGROUP_GLOBAL:
*
* The attribute group has been defined.
*/
#define XML_SCHEMAS_ATTRGROUP_GLOBAL 1 << 1
/**
* XML_SCHEMAS_ATTRGROUP_MARKED:
*
* Marks the attr group as marked; used for circular checks.
*/
#define XML_SCHEMAS_ATTRGROUP_MARKED 1 << 2
/**
* XML_SCHEMAS_ATTRGROUP_REDEFINED:
*
* The attr group was redefined.
*/
#define XML_SCHEMAS_ATTRGROUP_REDEFINED 1 << 3
/**
* XML_SCHEMAS_ATTRGROUP_HAS_REFS:
*
* Whether this attr. group contains attr. group references.
*/
#define XML_SCHEMAS_ATTRGROUP_HAS_REFS 1 << 4
@ -400,39 +361,27 @@ struct _xmlSchemaFacetLink {
};
/**
* XML_SCHEMAS_TYPE_MIXED:
*
* the element content type is mixed
*/
#define XML_SCHEMAS_TYPE_MIXED 1 << 0
/**
* XML_SCHEMAS_TYPE_DERIVATION_METHOD_EXTENSION:
*
* the simple or complex type has a derivation method of "extension".
*/
#define XML_SCHEMAS_TYPE_DERIVATION_METHOD_EXTENSION 1 << 1
/**
* XML_SCHEMAS_TYPE_DERIVATION_METHOD_RESTRICTION:
*
* the simple or complex type has a derivation method of "restriction".
*/
#define XML_SCHEMAS_TYPE_DERIVATION_METHOD_RESTRICTION 1 << 2
/**
* XML_SCHEMAS_TYPE_GLOBAL:
*
* the type is global
*/
#define XML_SCHEMAS_TYPE_GLOBAL 1 << 3
/**
* XML_SCHEMAS_TYPE_OWNED_ATTR_WILDCARD:
*
* the complexType owns an attribute wildcard, i.e.
* it can be freed by the complexType
*/
#define XML_SCHEMAS_TYPE_OWNED_ATTR_WILDCARD 1 << 4 /* Obsolete. */
/**
* XML_SCHEMAS_TYPE_VARIETY_ABSENT:
*
* the simpleType has a variety of "absent".
* TODO: Actually not necessary :-/, since if
* none of the variety flags occur then it's
@ -440,164 +389,112 @@ struct _xmlSchemaFacetLink {
*/
#define XML_SCHEMAS_TYPE_VARIETY_ABSENT 1 << 5
/**
* XML_SCHEMAS_TYPE_VARIETY_LIST:
*
* the simpleType has a variety of "list".
*/
#define XML_SCHEMAS_TYPE_VARIETY_LIST 1 << 6
/**
* XML_SCHEMAS_TYPE_VARIETY_UNION:
*
* the simpleType has a variety of "union".
*/
#define XML_SCHEMAS_TYPE_VARIETY_UNION 1 << 7
/**
* XML_SCHEMAS_TYPE_VARIETY_ATOMIC:
*
* the simpleType has a variety of "union".
*/
#define XML_SCHEMAS_TYPE_VARIETY_ATOMIC 1 << 8
/**
* XML_SCHEMAS_TYPE_FINAL_EXTENSION:
*
* the complexType has a final of "extension".
*/
#define XML_SCHEMAS_TYPE_FINAL_EXTENSION 1 << 9
/**
* XML_SCHEMAS_TYPE_FINAL_RESTRICTION:
*
* the simpleType/complexType has a final of "restriction".
*/
#define XML_SCHEMAS_TYPE_FINAL_RESTRICTION 1 << 10
/**
* XML_SCHEMAS_TYPE_FINAL_LIST:
*
* the simpleType has a final of "list".
*/
#define XML_SCHEMAS_TYPE_FINAL_LIST 1 << 11
/**
* XML_SCHEMAS_TYPE_FINAL_UNION:
*
* the simpleType has a final of "union".
*/
#define XML_SCHEMAS_TYPE_FINAL_UNION 1 << 12
/**
* XML_SCHEMAS_TYPE_FINAL_DEFAULT:
*
* the simpleType has a final of "default".
*/
#define XML_SCHEMAS_TYPE_FINAL_DEFAULT 1 << 13
/**
* XML_SCHEMAS_TYPE_BUILTIN_PRIMITIVE:
*
* Marks the item as a builtin primitive.
*/
#define XML_SCHEMAS_TYPE_BUILTIN_PRIMITIVE 1 << 14
/**
* XML_SCHEMAS_TYPE_MARKED:
*
* Marks the item as marked; used for circular checks.
*/
#define XML_SCHEMAS_TYPE_MARKED 1 << 16
/**
* XML_SCHEMAS_TYPE_BLOCK_DEFAULT:
*
* the complexType did not specify 'block' so use the default of the
* `<schema>` item.
*/
#define XML_SCHEMAS_TYPE_BLOCK_DEFAULT 1 << 17
/**
* XML_SCHEMAS_TYPE_BLOCK_EXTENSION:
*
* the complexType has a 'block' of "extension".
*/
#define XML_SCHEMAS_TYPE_BLOCK_EXTENSION 1 << 18
/**
* XML_SCHEMAS_TYPE_BLOCK_RESTRICTION:
*
* the complexType has a 'block' of "restriction".
*/
#define XML_SCHEMAS_TYPE_BLOCK_RESTRICTION 1 << 19
/**
* XML_SCHEMAS_TYPE_ABSTRACT:
*
* the simple/complexType is abstract.
*/
#define XML_SCHEMAS_TYPE_ABSTRACT 1 << 20
/**
* XML_SCHEMAS_TYPE_FACETSNEEDVALUE:
*
* indicates if the facets need a computed value
*/
#define XML_SCHEMAS_TYPE_FACETSNEEDVALUE 1 << 21
/**
* XML_SCHEMAS_TYPE_INTERNAL_RESOLVED:
*
* indicates that the type was typefixed
*/
#define XML_SCHEMAS_TYPE_INTERNAL_RESOLVED 1 << 22
/**
* XML_SCHEMAS_TYPE_INTERNAL_INVALID:
*
* indicates that the type is invalid
*/
#define XML_SCHEMAS_TYPE_INTERNAL_INVALID 1 << 23
/**
* XML_SCHEMAS_TYPE_WHITESPACE_PRESERVE:
*
* a whitespace-facet value of "preserve"
*/
#define XML_SCHEMAS_TYPE_WHITESPACE_PRESERVE 1 << 24
/**
* XML_SCHEMAS_TYPE_WHITESPACE_REPLACE:
*
* a whitespace-facet value of "replace"
*/
#define XML_SCHEMAS_TYPE_WHITESPACE_REPLACE 1 << 25
/**
* XML_SCHEMAS_TYPE_WHITESPACE_COLLAPSE:
*
* a whitespace-facet value of "collapse"
*/
#define XML_SCHEMAS_TYPE_WHITESPACE_COLLAPSE 1 << 26
/**
* XML_SCHEMAS_TYPE_HAS_FACETS:
*
* has facets
*/
#define XML_SCHEMAS_TYPE_HAS_FACETS 1 << 27
/**
* XML_SCHEMAS_TYPE_NORMVALUENEEDED:
*
* indicates if the facets (pattern) need a normalized value
*/
#define XML_SCHEMAS_TYPE_NORMVALUENEEDED 1 << 28
/**
* XML_SCHEMAS_TYPE_FIXUP_1:
*
* First stage of fixup was done.
*/
#define XML_SCHEMAS_TYPE_FIXUP_1 1 << 29
/**
* XML_SCHEMAS_TYPE_REDEFINED:
*
* The type was redefined.
*/
#define XML_SCHEMAS_TYPE_REDEFINED 1 << 30
#if 0
/**
* XML_SCHEMAS_TYPE_REDEFINING:
*
* The type redefines an other type.
*/
#define XML_SCHEMAS_TYPE_REDEFINING 1 << 31
#endif
/*
* _xmlSchemaType:
*
* Schemas type definition.
*/
struct _xmlSchemaType {
@ -642,119 +539,81 @@ struct _xmlSchemaType {
* structures must be kept similar
*/
/**
* XML_SCHEMAS_ELEM_NILLABLE:
*
* the element is nillable
*/
#define XML_SCHEMAS_ELEM_NILLABLE 1 << 0
/**
* XML_SCHEMAS_ELEM_GLOBAL:
*
* the element is global
*/
#define XML_SCHEMAS_ELEM_GLOBAL 1 << 1
/**
* XML_SCHEMAS_ELEM_DEFAULT:
*
* the element has a default value
*/
#define XML_SCHEMAS_ELEM_DEFAULT 1 << 2
/**
* XML_SCHEMAS_ELEM_FIXED:
*
* the element has a fixed value
*/
#define XML_SCHEMAS_ELEM_FIXED 1 << 3
/**
* XML_SCHEMAS_ELEM_ABSTRACT:
*
* the element is abstract
*/
#define XML_SCHEMAS_ELEM_ABSTRACT 1 << 4
/**
* XML_SCHEMAS_ELEM_TOPLEVEL:
*
* the element is top level
* obsolete: use XML_SCHEMAS_ELEM_GLOBAL instead
*/
#define XML_SCHEMAS_ELEM_TOPLEVEL 1 << 5
/**
* XML_SCHEMAS_ELEM_REF:
*
* the element is a reference to a type
*/
#define XML_SCHEMAS_ELEM_REF 1 << 6
/**
* XML_SCHEMAS_ELEM_NSDEFAULT:
*
* allow elements in no namespace
* Obsolete, not used anymore.
*/
#define XML_SCHEMAS_ELEM_NSDEFAULT 1 << 7
/**
* XML_SCHEMAS_ELEM_INTERNAL_RESOLVED:
*
* this is set when "type", "ref", "substitutionGroup"
* references have been resolved.
*/
#define XML_SCHEMAS_ELEM_INTERNAL_RESOLVED 1 << 8
/**
* XML_SCHEMAS_ELEM_CIRCULAR:
*
* a helper flag for the search of circular references.
*/
#define XML_SCHEMAS_ELEM_CIRCULAR 1 << 9
/**
* XML_SCHEMAS_ELEM_BLOCK_ABSENT:
*
* the "block" attribute is absent
*/
#define XML_SCHEMAS_ELEM_BLOCK_ABSENT 1 << 10
/**
* XML_SCHEMAS_ELEM_BLOCK_EXTENSION:
*
* disallowed substitutions are absent
*/
#define XML_SCHEMAS_ELEM_BLOCK_EXTENSION 1 << 11
/**
* XML_SCHEMAS_ELEM_BLOCK_RESTRICTION:
*
* disallowed substitutions: "restriction"
*/
#define XML_SCHEMAS_ELEM_BLOCK_RESTRICTION 1 << 12
/**
* XML_SCHEMAS_ELEM_BLOCK_SUBSTITUTION:
*
* disallowed substitutions: "substitution"
*/
#define XML_SCHEMAS_ELEM_BLOCK_SUBSTITUTION 1 << 13
/**
* XML_SCHEMAS_ELEM_FINAL_ABSENT:
*
* substitution group exclusions are absent
*/
#define XML_SCHEMAS_ELEM_FINAL_ABSENT 1 << 14
/**
* XML_SCHEMAS_ELEM_FINAL_EXTENSION:
*
* substitution group exclusions: "extension"
*/
#define XML_SCHEMAS_ELEM_FINAL_EXTENSION 1 << 15
/**
* XML_SCHEMAS_ELEM_FINAL_RESTRICTION:
*
* substitution group exclusions: "restriction"
*/
#define XML_SCHEMAS_ELEM_FINAL_RESTRICTION 1 << 16
/**
* XML_SCHEMAS_ELEM_SUBST_GROUP_HEAD:
*
* the declaration is a substitution group head
*/
#define XML_SCHEMAS_ELEM_SUBST_GROUP_HEAD 1 << 17
/**
* XML_SCHEMAS_ELEM_INTERNAL_CHECKED:
*
* this is set when the elem decl has been checked against
* all constraints
*/
@ -794,26 +653,18 @@ struct _xmlSchemaElement {
};
/*
* XML_SCHEMAS_FACET_UNKNOWN:
*
* unknown facet handling
*/
#define XML_SCHEMAS_FACET_UNKNOWN 0
/*
* XML_SCHEMAS_FACET_PRESERVE:
*
* preserve the type of the facet
*/
#define XML_SCHEMAS_FACET_PRESERVE 1
/*
* XML_SCHEMAS_FACET_REPLACE:
*
* replace the type of the facet
*/
#define XML_SCHEMAS_FACET_REPLACE 2
/*
* XML_SCHEMAS_FACET_COLLAPSE:
*
* collapse the types of the facet
*/
#define XML_SCHEMAS_FACET_COLLAPSE 3
@ -853,71 +704,49 @@ struct _xmlSchemaNotation {
* on the component level as per spec.
*/
/**
* XML_SCHEMAS_QUALIF_ELEM:
*
* Reflects elementFormDefault == qualified in
* an XML schema document.
*/
#define XML_SCHEMAS_QUALIF_ELEM 1 << 0
/**
* XML_SCHEMAS_QUALIF_ATTR:
*
* Reflects attributeFormDefault == qualified in
* an XML schema document.
*/
#define XML_SCHEMAS_QUALIF_ATTR 1 << 1
/**
* XML_SCHEMAS_FINAL_DEFAULT_EXTENSION:
*
* the schema has "extension" in the set of finalDefault.
*/
#define XML_SCHEMAS_FINAL_DEFAULT_EXTENSION 1 << 2
/**
* XML_SCHEMAS_FINAL_DEFAULT_RESTRICTION:
*
* the schema has "restriction" in the set of finalDefault.
*/
#define XML_SCHEMAS_FINAL_DEFAULT_RESTRICTION 1 << 3
/**
* XML_SCHEMAS_FINAL_DEFAULT_LIST:
*
* the schema has "list" in the set of finalDefault.
*/
#define XML_SCHEMAS_FINAL_DEFAULT_LIST 1 << 4
/**
* XML_SCHEMAS_FINAL_DEFAULT_UNION:
*
* the schema has "union" in the set of finalDefault.
*/
#define XML_SCHEMAS_FINAL_DEFAULT_UNION 1 << 5
/**
* XML_SCHEMAS_BLOCK_DEFAULT_EXTENSION:
*
* the schema has "extension" in the set of blockDefault.
*/
#define XML_SCHEMAS_BLOCK_DEFAULT_EXTENSION 1 << 6
/**
* XML_SCHEMAS_BLOCK_DEFAULT_RESTRICTION:
*
* the schema has "restriction" in the set of blockDefault.
*/
#define XML_SCHEMAS_BLOCK_DEFAULT_RESTRICTION 1 << 7
/**
* XML_SCHEMAS_BLOCK_DEFAULT_SUBSTITUTION:
*
* the schema has "substitution" in the set of blockDefault.
*/
#define XML_SCHEMAS_BLOCK_DEFAULT_SUBSTITUTION 1 << 8
/**
* XML_SCHEMAS_INCLUDING_CONVERT_NS:
*
* the schema is currently including an other schema with
* no target namespace.
*/
#define XML_SCHEMAS_INCLUDING_CONVERT_NS 1 << 9
/*
* _xmlSchema:
*
* A Schemas definition
*/
struct _xmlSchema {

View File

@ -68,15 +68,6 @@ typedef xmlSAXHandler *xmlSAXHandlerPtr;
typedef struct _xmlEntity xmlEntity;
typedef xmlEntity *xmlEntityPtr;
/**
* LIBXML_NAMESPACE_DICT:
*
* Defines experimental behaviour:
* 1) xmlNs gets an additional field `context` (a xmlDoc)
* 2) when creating a tree, xmlNs->href is stored in the dict of xmlDoc.
*/
/* #define LIBXML_NAMESPACE_DICT */
/*
* Removed, buffers always use XML_BUFFER_ALLOC_IO now.
*/
@ -129,8 +120,6 @@ XMLPUBFUN size_t xmlBufUse (const xmlBufPtr buf);
XMLPUBFUN size_t xmlBufShrink (xmlBufPtr buf, size_t len);
/*
* LIBXML2_NEW_BUFFER:
*
* Macro used to express that the API use the new buffers for
* xmlParserInputBuffer and xmlOutputBuffer. The change was
* introduced in 2.9.0.
@ -138,8 +127,6 @@ XMLPUBFUN size_t xmlBufShrink (xmlBufPtr buf, size_t len);
#define LIBXML2_NEW_BUFFER
/**
* XML_XML_NAMESPACE:
*
* This is the namespace for the special xml: prefix predefined in the
* XML Namespace specification.
*/
@ -147,8 +134,6 @@ XMLPUBFUN size_t xmlBufShrink (xmlBufPtr buf, size_t len);
(const xmlChar *) "http://www.w3.org/XML/1998/namespace"
/**
* XML_XML_ID:
*
* This is the name for the special xml:id attribute
*/
#define XML_XML_ID (const xmlChar *) "xml:id"
@ -400,8 +385,6 @@ struct _xmlElement {
/**
* XML_LOCAL_NAMESPACE:
*
* A namespace declaration node.
*/
#define XML_LOCAL_NAMESPACE XML_NAMESPACE_DECL
@ -586,16 +569,12 @@ struct _xmlNode {
};
/**
* XML_GET_CONTENT:
*
* Macro to extract the content pointer of a node.
*/
#define XML_GET_CONTENT(n) \
((n)->type == XML_ELEMENT_NODE ? NULL : (n)->content)
/**
* XML_GET_LINE:
*
* Macro to extract the line number of an element node.
*/
#define XML_GET_LINE(n) \

View File

@ -28,62 +28,42 @@ extern "C" {
#endif
/**
* XINCLUDE_NS:
*
* Macro defining the Xinclude namespace: http://www.w3.org/2003/XInclude
*/
#define XINCLUDE_NS (const xmlChar *) "http://www.w3.org/2003/XInclude"
/**
* XINCLUDE_OLD_NS:
*
* Macro defining the draft Xinclude namespace: http://www.w3.org/2001/XInclude
*/
#define XINCLUDE_OLD_NS (const xmlChar *) "http://www.w3.org/2001/XInclude"
/**
* XINCLUDE_NODE:
*
* Macro defining "include"
*/
#define XINCLUDE_NODE (const xmlChar *) "include"
/**
* XINCLUDE_FALLBACK:
*
* Macro defining "fallback"
*/
#define XINCLUDE_FALLBACK (const xmlChar *) "fallback"
/**
* XINCLUDE_HREF:
*
* Macro defining "href"
*/
#define XINCLUDE_HREF (const xmlChar *) "href"
/**
* XINCLUDE_PARSE:
*
* Macro defining "parse"
*/
#define XINCLUDE_PARSE (const xmlChar *) "parse"
/**
* XINCLUDE_PARSE_XML:
*
* Macro defining "xml"
*/
#define XINCLUDE_PARSE_XML (const xmlChar *) "xml"
/**
* XINCLUDE_PARSE_TEXT:
*
* Macro defining "text"
*/
#define XINCLUDE_PARSE_TEXT (const xmlChar *) "text"
/**
* XINCLUDE_PARSE_ENCODING:
*
* Macro defining "encoding"
*/
#define XINCLUDE_PARSE_ENCODING (const xmlChar *) "encoding"
/**
* XINCLUDE_PARSE_XPOINTER:
*
* Macro defining "xpointer"
*/
#define XINCLUDE_PARSE_XPOINTER (const xmlChar *) "xpointer"

View File

@ -29,8 +29,6 @@ extern "C" {
typedef unsigned char xmlChar;
/**
* BAD_CAST:
*
* Macro to cast a string to an xmlChar * when one know its safe.
*/
#define BAD_CAST (xmlChar *)

View File

@ -11,317 +11,243 @@
#define __XML_VERSION_H__
/**
* LIBXML_DOTTED_VERSION:
*
* the version string like "1.2.3"
*/
#define LIBXML_DOTTED_VERSION "@VERSION@"
/**
* LIBXML_VERSION:
*
* the version number: 1.2.3 value is 10203
*/
#define LIBXML_VERSION @LIBXML_VERSION_NUMBER@
/**
* LIBXML_VERSION_STRING:
*
* the version number string, 1.2.3 value is "10203"
*/
#define LIBXML_VERSION_STRING "@LIBXML_VERSION_NUMBER@"
/**
* LIBXML_VERSION_EXTRA:
*
* extra version information, used to show a git commit description
*/
#define LIBXML_VERSION_EXTRA "@LIBXML_VERSION_EXTRA@"
/**
* LIBXML_TEST_VERSION:
*
* Macro to check that the libxml version in use is compatible with
* the version the software has been compiled against
*/
#define LIBXML_TEST_VERSION xmlCheckVersion(@LIBXML_VERSION_NUMBER@);
#if @WITH_THREADS@
/**
* LIBXML_THREAD_ENABLED:
*
* Whether the thread support is configured in
*/
#if @WITH_THREADS@
#define LIBXML_THREAD_ENABLED
#endif
#if @WITH_THREAD_ALLOC@
/**
* LIBXML_THREAD_ALLOC_ENABLED:
*
* Whether the allocation hooks are per-thread
*/
#if @WITH_THREAD_ALLOC@
#define LIBXML_THREAD_ALLOC_ENABLED
#endif
/**
* LIBXML_TREE_ENABLED:
*
* Always enabled since 2.14.0
*/
#define LIBXML_TREE_ENABLED
#if @WITH_OUTPUT@
/**
* LIBXML_OUTPUT_ENABLED:
*
* Whether the serialization/saving support is configured in
*/
#if @WITH_OUTPUT@
#define LIBXML_OUTPUT_ENABLED
#endif
#if @WITH_PUSH@
/**
* LIBXML_PUSH_ENABLED:
*
* Whether the push parsing interfaces are configured in
*/
#if @WITH_PUSH@
#define LIBXML_PUSH_ENABLED
#endif
#if @WITH_READER@
/**
* LIBXML_READER_ENABLED:
*
* Whether the xmlReader parsing interface is configured in
*/
#if @WITH_READER@
#define LIBXML_READER_ENABLED
#endif
#if @WITH_PATTERN@
/**
* LIBXML_PATTERN_ENABLED:
*
* Whether the xmlPattern node selection interface is configured in
*/
#if @WITH_PATTERN@
#define LIBXML_PATTERN_ENABLED
#endif
#if @WITH_WRITER@
/**
* LIBXML_WRITER_ENABLED:
*
* Whether the xmlWriter saving interface is configured in
*/
#if @WITH_WRITER@
#define LIBXML_WRITER_ENABLED
#endif
#if @WITH_SAX1@
/**
* LIBXML_SAX1_ENABLED:
*
* Whether the older SAX1 interface is configured in
*/
#if @WITH_SAX1@
#define LIBXML_SAX1_ENABLED
#endif
#if @WITH_HTTP@
/**
* LIBXML_HTTP_STUBS_ENABLED:
*
* HTTP support was removed in 2.15
*/
#if @WITH_HTTP@
#define LIBXML_HTTP_STUBS_ENABLED
#endif
#if @WITH_VALID@
/**
* LIBXML_VALID_ENABLED:
*
* Whether the DTD validation support is configured in
*/
#if @WITH_VALID@
#define LIBXML_VALID_ENABLED
#endif
#if @WITH_HTML@
/**
* LIBXML_HTML_ENABLED:
*
* Whether the HTML support is configured in
*/
#if @WITH_HTML@
#define LIBXML_HTML_ENABLED
#endif
/**
* LIBXML_LEGACY_ENABLED:
*
/*
* Removed in 2.14
*/
#undef LIBXML_LEGACY_ENABLED
#if @WITH_C14N@
/**
* LIBXML_C14N_ENABLED:
*
* Whether the Canonicalization support is configured in
*/
#if @WITH_C14N@
#define LIBXML_C14N_ENABLED
#endif
#if @WITH_CATALOG@
/**
* LIBXML_CATALOG_ENABLED:
*
* Whether the Catalog support is configured in
*/
#if @WITH_CATALOG@
#define LIBXML_CATALOG_ENABLED
#endif
#if @WITH_XPATH@
/**
* LIBXML_XPATH_ENABLED:
*
* Whether XPath is configured in
*/
#if @WITH_XPATH@
#define LIBXML_XPATH_ENABLED
#endif
#if @WITH_XPTR@
/**
* LIBXML_XPTR_ENABLED:
*
* Whether XPointer is configured in
*/
#if @WITH_XPTR@
#define LIBXML_XPTR_ENABLED
#endif
#if @WITH_XINCLUDE@
/**
* LIBXML_XINCLUDE_ENABLED:
*
* Whether XInclude is configured in
*/
#if @WITH_XINCLUDE@
#define LIBXML_XINCLUDE_ENABLED
#endif
#if @WITH_ICONV@
/**
* LIBXML_ICONV_ENABLED:
*
* Whether iconv support is available
*/
#if @WITH_ICONV@
#define LIBXML_ICONV_ENABLED
#endif
#if @WITH_ICU@
/**
* LIBXML_ICU_ENABLED:
*
* Whether icu support is available
*/
#if @WITH_ICU@
#define LIBXML_ICU_ENABLED
#endif
#if @WITH_ISO8859X@
/**
* LIBXML_ISO8859X_ENABLED:
*
* Whether ISO-8859-* support is made available in case iconv is not
*/
#if @WITH_ISO8859X@
#define LIBXML_ISO8859X_ENABLED
#endif
#if @WITH_DEBUG@
/**
* LIBXML_DEBUG_ENABLED:
*
* Whether Debugging module is configured in
*/
#if @WITH_DEBUG@
#define LIBXML_DEBUG_ENABLED
#endif
/**
* LIBXML_UNICODE_ENABLED:
*
/*
* Removed in 2.14
*/
#undef LIBXML_UNICODE_ENABLED
#if @WITH_REGEXPS@
/**
* LIBXML_REGEXP_ENABLED:
*
* Whether the regular expressions interfaces are compiled in
*/
#if @WITH_REGEXPS@
#define LIBXML_REGEXP_ENABLED
#endif
#if @WITH_REGEXPS@
/**
* LIBXML_AUTOMATA_ENABLED:
*
* Whether the automata interfaces are compiled in
*/
#if @WITH_REGEXPS@
#define LIBXML_AUTOMATA_ENABLED
#endif
#if @WITH_RELAXNG@
/**
* LIBXML_RELAXNG_ENABLED:
*
* Whether the RelaxNG validation interfaces are compiled in
*/
#if @WITH_RELAXNG@
#define LIBXML_RELAXNG_ENABLED
#endif
#if @WITH_SCHEMAS@
/**
* LIBXML_SCHEMAS_ENABLED:
*
* Whether the Schemas validation interfaces are compiled in
*/
#if @WITH_SCHEMAS@
#define LIBXML_SCHEMAS_ENABLED
#endif
#if @WITH_SCHEMATRON@
/**
* LIBXML_SCHEMATRON_ENABLED:
*
* Whether the Schematron validation interfaces are compiled in
*/
#if @WITH_SCHEMATRON@
#define LIBXML_SCHEMATRON_ENABLED
#endif
#if @WITH_MODULES@
/**
* LIBXML_MODULES_ENABLED:
*
* Whether the module interfaces are compiled in
*/
#if @WITH_MODULES@
#define LIBXML_MODULES_ENABLED
/**
* LIBXML_MODULE_EXTENSION:
*
* the string suffix used by dynamic modules (usually shared libraries)
*/
#define LIBXML_MODULE_EXTENSION "@MODULE_EXTENSION@"
#endif
#if @WITH_ZLIB@
/**
* LIBXML_ZLIB_ENABLED:
*
* Whether the Zlib support is compiled in
*/
#if @WITH_ZLIB@
#define LIBXML_ZLIB_ENABLED
#endif
#if @WITH_LZMA@
/**
* LIBXML_LZMA_ENABLED:
*
* Whether the Lzma support is compiled in
*/
#if @WITH_LZMA@
#define LIBXML_LZMA_ENABLED
#endif

View File

@ -229,14 +229,10 @@ typedef xmlXPathFunction (*xmlXPathFuncLookupFunc) (void *ctxt,
* Flags for XPath engine compilation and runtime
*/
/**
* XML_XPATH_CHECKNS:
*
* check namespaces at compilation
*/
#define XML_XPATH_CHECKNS (1<<0)
/**
* XML_XPATH_NOVAR:
*
* forbid variables in expression
*/
#define XML_XPATH_NOVAR (1<<1)

View File

@ -223,23 +223,18 @@ XMLPUBFUN void *
{ while ((ns)->nodeNr > 0) (ns)->nodeTab[--(ns)->nodeNr] = NULL; }
/**
* CHECK_ERROR:
*
* Macro to return from the function if an XPath error was detected.
*/
#define CHECK_ERROR \
if (ctxt->error != XPATH_EXPRESSION_OK) return
/**
* CHECK_ERROR0:
*
* Macro to return 0 from the function if an XPath error was detected.
*/
#define CHECK_ERROR0 \
if (ctxt->error != XPATH_EXPRESSION_OK) return(0)
/**
* XP_ERROR:
* @param X the error code
*
* Macro to raise an XPath error and return.
@ -248,7 +243,6 @@ XMLPUBFUN void *
{ xmlXPathErr(ctxt, X); return; }
/**
* XP_ERROR0:
* @param X the error code
*
* Macro to raise an XPath error and return 0.
@ -257,7 +251,6 @@ XMLPUBFUN void *
{ xmlXPathErr(ctxt, X); return(0); }
/**
* CHECK_TYPE:
* @param typeval the XPath type
*
* Macro to check that the value on top of the XPath stack is of a given
@ -268,7 +261,6 @@ XMLPUBFUN void *
XP_ERROR(XPATH_INVALID_TYPE)
/**
* CHECK_TYPE0:
* @param typeval the XPath type
*
* Macro to check that the value on top of the XPath stack is of a given
@ -279,7 +271,6 @@ XMLPUBFUN void *
XP_ERROR0(XPATH_INVALID_TYPE)
/**
* CHECK_ARITY:
* @param x the number of expected args
*
* Macro to check that the number of args passed to an XPath function matches.
@ -292,8 +283,6 @@ XMLPUBFUN void *
XP_ERROR(XPATH_STACK_ERROR);
/**
* CAST_TO_STRING:
*
* Macro to try to cast the value on the top of the XPath stack to a string.
*/
#define CAST_TO_STRING \
@ -301,8 +290,6 @@ XMLPUBFUN void *
xmlXPathStringFunction(ctxt, 1);
/**
* CAST_TO_NUMBER:
*
* Macro to try to cast the value on the top of the XPath stack to a number.
*/
#define CAST_TO_NUMBER \
@ -310,8 +297,6 @@ XMLPUBFUN void *
xmlXPathNumberFunction(ctxt, 1);
/**
* CAST_TO_BOOLEAN:
*
* Macro to try to cast the value on the top of the XPath stack to a boolean.
*/
#define CAST_TO_BOOLEAN \

View File

@ -18,7 +18,6 @@ XML_HIDDEN void
xmlCleanupMemoryInternal(void);
/**
* xmlGrowCapacity:
* @array: pointer to array
* @capacity: pointer to capacity (in/out)
* @elemSize: size of an element in bytes

View File

@ -9,14 +9,10 @@
#define XML_MAX_URI_LENGTH 2000
/**
* XML_VCTXT_DTD_VALIDATED:
*
* Set after xmlValidateDtdFinal was called.
*/
#define XML_VCTXT_DTD_VALIDATED (1u << 0)
/**
* XML_VCTXT_USE_PCTXT:
*
* Set if the validation context is part of a parser context.
*/
#define XML_VCTXT_USE_PCTXT (1u << 1)
@ -50,8 +46,6 @@
((ctxt)->input->entity->etype == XML_EXTERNAL_PARAMETER_ENTITY)))
/**
* INPUT_CHUNK:
*
* The parser tries to always have that amount of input ready.
* One of the point is providing context when reporting errors.
*/

View File

@ -376,7 +376,6 @@ xmlNsErr(xmlParserCtxtPtr ctxt, xmlParserErrors error,
}
/**
* xmlNsWarn
* @param ctxt an XML parser context
* @param error the error number
* @param msg the message
@ -1993,7 +1992,6 @@ xmlCtxtPopInput(xmlParserCtxtPtr ctxt)
}
/**
* nodePush:
* @param ctxt an XML parser context
* @param value the element node
*
@ -2040,7 +2038,6 @@ nodePush(xmlParserCtxtPtr ctxt, xmlNodePtr value)
}
/**
* nodePop:
* @param ctxt an XML parser context
*
* @deprecated Internal function, do not use.
@ -2068,7 +2065,6 @@ nodePop(xmlParserCtxtPtr ctxt)
}
/**
* nameNsPush:
* @param ctxt an XML parser context
* @param value the element name
* @param prefix the element prefix
@ -2127,7 +2123,6 @@ mem_error:
}
#ifdef LIBXML_PUSH_ENABLED
/**
* nameNsPop:
* @param ctxt an XML parser context
*
* Pops the top element/prefix/URI name from the name stack
@ -2153,7 +2148,6 @@ nameNsPop(xmlParserCtxtPtr ctxt)
#endif /* LIBXML_PUSH_ENABLED */
/**
* namePop:
* @param ctxt an XML parser context
*
* @deprecated Internal function, do not use.
@ -2836,7 +2830,6 @@ xmlStringDecodeEntities(xmlParserCtxtPtr ctxt, const xmlChar *str,
************************************************************************/
/**
* areBlanks:
* @param ctxt an XML parser context
* @param str a xmlChar *
* @param len the size of `str`
@ -6882,7 +6875,6 @@ xmlParseElementDecl(xmlParserCtxtPtr ctxt) {
}
/**
* xmlParseConditionalSections
* @param ctxt an XML parser context
*
* Parse a conditional section. Always consumes '<!['.
@ -13104,7 +13096,6 @@ xmlParseDoc(const xmlChar *cur) {
************************************************************************/
/**
* DICT_FREE:
* @param str a string
*
* Free a string if it is not owned by the "dict" dictionary in the

View File

@ -146,8 +146,6 @@ struct _xmlRelaxNGDefine {
};
/**
* _xmlRelaxNG:
*
* A RelaxNGs definition
*/
struct _xmlRelaxNG {

View File

@ -607,7 +607,6 @@ static int callbacks = 0;
static int quiet = 0;
/**
* isStandaloneDebug:
* @param ctxt An XML parser context
*
* Is this document tagged standalone ?
@ -625,7 +624,6 @@ isStandaloneDebug(void *ctx ATTRIBUTE_UNUSED)
}
/**
* hasInternalSubsetDebug:
* @param ctxt An XML parser context
*
* Does this document has an internal subset
@ -643,7 +641,6 @@ hasInternalSubsetDebug(void *ctx ATTRIBUTE_UNUSED)
}
/**
* hasExternalSubsetDebug:
* @param ctxt An XML parser context
*
* Does this document has an external subset
@ -661,7 +658,6 @@ hasExternalSubsetDebug(void *ctx ATTRIBUTE_UNUSED)
}
/**
* internalSubsetDebug:
* @param ctxt An XML parser context
*
* Does this document has an internal subset
@ -687,7 +683,6 @@ internalSubsetDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *name,
}
/**
* externalSubsetDebug:
* @param ctxt An XML parser context
*
* Does this document has an external subset
@ -711,7 +706,6 @@ externalSubsetDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *name,
}
/**
* resolveEntityDebug:
* @param ctxt An XML parser context
* @param publicId The public ID of the entity
* @param systemId The system ID of the entity
@ -751,7 +745,6 @@ resolveEntityDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *publicId, const xm
}
/**
* getEntityDebug:
* @param ctxt An XML parser context
* @param name The entity name
*
@ -773,7 +766,6 @@ getEntityDebug(void *ctx, const xmlChar *name)
}
/**
* getParameterEntityDebug:
* @param ctxt An XML parser context
* @param name The entity name
*
@ -796,7 +788,6 @@ getParameterEntityDebug(void *ctx, const xmlChar *name)
/**
* entityDeclDebug:
* @param ctxt An XML parser context
* @param name the entity name
* @param type the entity type
@ -839,7 +830,6 @@ entityDeclDebug(void *ctx, const xmlChar *name, int type,
}
/**
* attributeDeclDebug:
* @param ctxt An XML parser context
* @param name the attribute name
* @param type the attribute type
@ -864,7 +854,6 @@ attributeDeclDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar * elem,
}
/**
* elementDeclDebug:
* @param ctxt An XML parser context
* @param name the element name
* @param type the element type
@ -884,7 +873,6 @@ elementDeclDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *name, int type,
}
/**
* notationDeclDebug:
* @param ctxt An XML parser context
* @param name The name of the notation
* @param publicId The public ID of the entity
@ -904,7 +892,6 @@ notationDeclDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *name,
}
/**
* unparsedEntityDeclDebug:
* @param ctxt An XML parser context
* @param name The name of the entity
* @param publicId The public ID of the entity
@ -935,7 +922,6 @@ const xmlChar *nullstr = BAD_CAST "(null)";
}
/**
* setDocumentLocatorDebug:
* @param ctxt An XML parser context
* @param loc A SAX Locator
*
@ -952,7 +938,6 @@ setDocumentLocatorDebug(void *ctx ATTRIBUTE_UNUSED, xmlSAXLocatorPtr loc ATTRIBU
}
/**
* startDocumentDebug:
* @param ctxt An XML parser context
*
* called when the document start being processed.
@ -967,7 +952,6 @@ startDocumentDebug(void *ctx ATTRIBUTE_UNUSED)
}
/**
* endDocumentDebug:
* @param ctxt An XML parser context
*
* called when the document end has been detected.
@ -982,7 +966,6 @@ endDocumentDebug(void *ctx ATTRIBUTE_UNUSED)
}
/**
* startElementDebug:
* @param ctxt An XML parser context
* @param name The element name
*
@ -1008,7 +991,6 @@ startElementDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *name, const xmlChar
}
/**
* endElementDebug:
* @param ctxt An XML parser context
* @param name The element name
*
@ -1024,7 +1006,6 @@ endElementDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *name)
}
/**
* charactersDebug:
* @param ctxt An XML parser context
* @param ch a xmlChar string
* @param len the number of xmlChar
@ -1049,7 +1030,6 @@ charactersDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *ch, int len)
}
/**
* referenceDebug:
* @param ctxt An XML parser context
* @param name The entity name
*
@ -1065,7 +1045,6 @@ referenceDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *name)
}
/**
* ignorableWhitespaceDebug:
* @param ctxt An XML parser context
* @param ch a xmlChar string
* @param start the first char in the string
@ -1090,7 +1069,6 @@ ignorableWhitespaceDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *ch, int len)
}
/**
* processingInstructionDebug:
* @param ctxt An XML parser context
* @param target the target name
* @param data the PI data's
@ -1114,7 +1092,6 @@ processingInstructionDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *target,
}
/**
* cdataBlockDebug:
* @param ctx the user data (XML parser context)
* @param value The pcdata content
* @param len the block length
@ -1132,7 +1109,6 @@ cdataBlockDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *value, int len)
}
/**
* commentDebug:
* @param ctxt An XML parser context
* @param value the comment content
*
@ -1148,7 +1124,6 @@ commentDebug(void *ctx ATTRIBUTE_UNUSED, const xmlChar *value)
}
/**
* warningDebug:
* @param ctxt An XML parser context
* @param msg the message to display/transmit
* @...: extra parameters for the message display
@ -1171,7 +1146,6 @@ warningDebug(void *ctx ATTRIBUTE_UNUSED, const char *msg, ...)
}
/**
* errorDebug:
* @param ctxt An XML parser context
* @param msg the message to display/transmit
* @...: extra parameters for the message display
@ -1194,7 +1168,6 @@ errorDebug(void *ctx ATTRIBUTE_UNUSED, const char *msg, ...)
}
/**
* fatalErrorDebug:
* @param ctxt An XML parser context
* @param msg the message to display/transmit
* @...: extra parameters for the message display
@ -1257,7 +1230,6 @@ static xmlSAXHandlerPtr debugSAXHandler = &debugSAXHandlerStruct;
* SAX2 specific callbacks
*/
/**
* startElementNsDebug:
* @param ctxt An XML parser context
* @param name The element name
*
@ -1314,7 +1286,6 @@ startElementNsDebug(void *ctx ATTRIBUTE_UNUSED,
}
/**
* endElementDebug:
* @param ctxt An XML parser context
* @param name The element name
*
@ -1498,7 +1469,6 @@ hashFreeEntity(void *payload, const xmlChar *name ATTRIBUTE_UNUSED) {
}
/**
* saxParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -1834,7 +1804,6 @@ htmlTokenizerTest(const char *filename, const char *result,
* *
************************************************************************/
/**
* oldParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages: unused
@ -1905,7 +1874,6 @@ oldParseTest(const char *filename, const char *result,
#ifdef LIBXML_PUSH_ENABLED
/**
* pushParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages: unused
@ -2092,7 +2060,6 @@ endElementNsBnd(void *ctx, const xmlChar *localname, const xmlChar *prefix,
}
/**
* pushBoundaryTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages: unused
@ -2407,7 +2374,6 @@ testParseContent(xmlParserCtxtPtr ctxt, xmlDocPtr doc, const char *filename) {
}
/**
* memParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages: unused
@ -2462,7 +2428,6 @@ memParseTest(const char *filename, const char *result,
}
/**
* noentParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages: unused
@ -2521,7 +2486,6 @@ noentParseTest(const char *filename, const char *result,
}
/**
* errParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -2610,7 +2574,6 @@ errParseTest(const char *filename, const char *result, const char *err,
#if defined(LIBXML_VALID_ENABLED) || defined(LIBXML_HTML_ENABLED)
/**
* fdParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -2797,7 +2760,6 @@ streamProcessTest(const char *filename, const char *result, const char *err,
}
/**
* streamParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -2821,7 +2783,6 @@ streamParseTest(const char *filename, const char *result, const char *err,
}
/**
* walkerParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -2850,7 +2811,6 @@ walkerParseTest(const char *filename, const char *result, const char *err,
}
/**
* streamMemParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -2933,7 +2893,6 @@ testXPath(const char *str, int xptr, int expr) {
}
/**
* xpathExprTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -3001,7 +2960,6 @@ xpathCommonTest(const char *filename, const char *result,
}
/**
* xpathExprTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -3018,7 +2976,6 @@ xpathExprTest(const char *filename, const char *result,
}
/**
* xpathDocTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -3070,7 +3027,6 @@ xpathDocTest(const char *filename,
#ifdef LIBXML_XPTR_ENABLED
/**
* xptrDocTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -3232,7 +3188,6 @@ handleURI(const char *str, const char *base, FILE *o) {
}
/**
* uriCommonTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -3320,7 +3275,6 @@ uriCommonTest(const char *filename,
}
/**
* uriParseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -3338,7 +3292,6 @@ uriParseTest(const char *filename,
}
/**
* uriBaseTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages
@ -3394,7 +3347,6 @@ static const char *urip_cur = NULL;
static int urip_rlen;
/**
* uripMatch:
* @param URI an URI to test
*
* Check for an urip: query
@ -3415,7 +3367,6 @@ uripMatch(const char * URI) {
}
/**
* uripOpen:
* @param URI an URI to test
*
* @returns a pointer to the urip: query handler, in this example simply
@ -3439,7 +3390,6 @@ uripOpen(const char * URI) {
}
/**
* uripClose:
* @param context the read context
*
* Close the urip: query handler
@ -3455,7 +3405,6 @@ uripClose(void * context) {
}
/**
* uripRead:
* @param context the read context
* @param buffer where to store data
* @param len number of bytes to read
@ -3489,7 +3438,6 @@ urip_checkURL(const char *URL) {
}
/**
* uriPathTest:
* @param filename ignored
* @param result ignored
* @param err ignored
@ -3604,7 +3552,6 @@ done:
return(ret);
}
/**
* schemasTest:
* @param filename the schemas file
* @param result the file with expected result
* @param err the file with error messages
@ -3737,7 +3684,6 @@ rngOneTest(const char *sch,
return(0);
}
/**
* rngTest:
* @param filename the schemas file
* @param result the file with expected result
* @param err the file with error messages
@ -3829,7 +3775,6 @@ rngTest(const char *filename,
#ifdef LIBXML_READER_ENABLED
/**
* rngStreamTest:
* @param filename the schemas file
* @param result the file with expected result
* @param err the file with error messages
@ -3968,7 +3913,6 @@ schematronOneTest(const char *sch, const char *filename, int options,
}
/**
* schematronTest:
* @param filename the schemas file
* @param result the file with expected result
* @param err the file with error messages
@ -4120,7 +4064,6 @@ static void patternNode(FILE *out, xmlTextReaderPtr reader,
}
/**
* patternTest:
* @param filename the schemas file
* @param result the file with expected result
* @param err the file with error messages

View File

@ -69,8 +69,6 @@ typedef enum {
} xmlSchematronTestType;
/**
* _xmlSchematronLet:
*
* A Schematron let variable
*/
typedef struct _xmlSchematronLet xmlSchematronLet;
@ -82,8 +80,6 @@ struct _xmlSchematronLet {
};
/**
* _xmlSchematronTest:
*
* A Schematrons test, either an assert or a report
*/
typedef struct _xmlSchematronTest xmlSchematronTest;
@ -98,8 +94,6 @@ struct _xmlSchematronTest {
};
/**
* _xmlSchematronRule:
*
* A Schematrons rule
*/
typedef struct _xmlSchematronRule xmlSchematronRule;
@ -116,8 +110,6 @@ struct _xmlSchematronRule {
};
/**
* _xmlSchematronPattern:
*
* A Schematrons pattern
*/
typedef struct _xmlSchematronPattern xmlSchematronPattern;
@ -129,8 +121,6 @@ struct _xmlSchematronPattern {
};
/**
* _xmlSchematron:
*
* A Schematrons definition
*/
struct _xmlSchematron {

View File

@ -153,8 +153,6 @@ static int testDocumentRangeByte2(xmlParserCtxtPtr ctxt, char *document,
}
/**
* testDocumentRanges:
*
* Test the correct UTF8 character parsing in context of XML documents
* Those are in-context injection tests checking the parser behaviour on
* edge case values at different point in content, beginning and end of
@ -624,8 +622,6 @@ static int testCharRangeByte4(xmlParserCtxtPtr ctxt) {
}
/**
* testCharRanges:
*
* Test the correct UTF8 character parsing in isolation i.e.
* not when parsing a full document, this is less expensive and we can
* cover the full range of UTF-8 chars accepted by XML-1.0

View File

@ -89,7 +89,6 @@ static unsigned int currentTest = 0;
static int instate = 0;
/**
* hugeMatch:
* @param URI an URI to test
*
* Check for an huge: query
@ -104,7 +103,6 @@ hugeMatch(const char * URI) {
}
/**
* hugeOpen:
* @param URI an URI to test
*
* @returns a pointer to the huge: query handler, in this example simply
@ -132,7 +130,6 @@ found:
}
/**
* hugeClose:
* @param context the read context
*
* Close the huge: query handler
@ -164,7 +161,6 @@ size_t curlen = 0;
size_t dotlen;
/**
* hugeRead:
* @param context the read context
* @param buffer where to store data
* @param len number of bytes to read
@ -252,7 +248,6 @@ foo\
<!-- tst -->";
/**
* crazyMatch:
* @param URI an URI to test
*
* Check for a crazy: query
@ -267,7 +262,6 @@ crazyMatch(const char * URI) {
}
/**
* crazyOpen:
* @param URI an URI to test
*
* @returns a pointer to the crazy: query handler, in this example simply
@ -290,7 +284,6 @@ crazyOpen(const char * URI) {
}
/**
* crazyClose:
* @param context the read context
*
* Close the crazy: query handler
@ -305,7 +298,6 @@ crazyClose(void * context) {
/**
* crazyRead:
* @param context the read context
* @param buffer where to store data
* @param len number of bytes to read
@ -405,7 +397,6 @@ initializeLibxml2(void) {
unsigned long callbacks = 0;
/**
* isStandaloneCallback:
* @param ctxt An XML parser context
*
* Is this document tagged standalone ?
@ -420,7 +411,6 @@ isStandaloneCallback(void *ctx ATTRIBUTE_UNUSED)
}
/**
* hasInternalSubsetCallback:
* @param ctxt An XML parser context
*
* Does this document has an internal subset
@ -435,7 +425,6 @@ hasInternalSubsetCallback(void *ctx ATTRIBUTE_UNUSED)
}
/**
* hasExternalSubsetCallback:
* @param ctxt An XML parser context
*
* Does this document has an external subset
@ -450,7 +439,6 @@ hasExternalSubsetCallback(void *ctx ATTRIBUTE_UNUSED)
}
/**
* internalSubsetCallback:
* @param ctxt An XML parser context
*
* Does this document has an internal subset
@ -465,7 +453,6 @@ internalSubsetCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* externalSubsetCallback:
* @param ctxt An XML parser context
*
* Does this document has an external subset
@ -480,7 +467,6 @@ externalSubsetCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* resolveEntityCallback:
* @param ctxt An XML parser context
* @param publicId The public ID of the entity
* @param systemId The system ID of the entity
@ -503,7 +489,6 @@ resolveEntityCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* getEntityCallback:
* @param ctxt An XML parser context
* @param name The entity name
*
@ -520,7 +505,6 @@ getEntityCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* getParameterEntityCallback:
* @param ctxt An XML parser context
* @param name The entity name
*
@ -538,7 +522,6 @@ getParameterEntityCallback(void *ctx ATTRIBUTE_UNUSED,
/**
* entityDeclCallback:
* @param ctxt An XML parser context
* @param name the entity name
* @param type the entity type
@ -560,7 +543,6 @@ entityDeclCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* attributeDeclCallback:
* @param ctxt An XML parser context
* @param name the attribute name
* @param type the attribute type
@ -579,7 +561,6 @@ attributeDeclCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* elementDeclCallback:
* @param ctxt An XML parser context
* @param name the element name
* @param type the element type
@ -597,7 +578,6 @@ elementDeclCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* notationDeclCallback:
* @param ctxt An XML parser context
* @param name The name of the notation
* @param publicId The public ID of the entity
@ -615,7 +595,6 @@ notationDeclCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* unparsedEntityDeclCallback:
* @param ctxt An XML parser context
* @param name The name of the entity
* @param publicId The public ID of the entity
@ -635,7 +614,6 @@ unparsedEntityDeclCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* setDocumentLocatorCallback:
* @param ctxt An XML parser context
* @param loc A SAX Locator
*
@ -650,7 +628,6 @@ setDocumentLocatorCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* startDocumentCallback:
* @param ctxt An XML parser context
*
* called when the document start being processed.
@ -662,7 +639,6 @@ startDocumentCallback(void *ctx ATTRIBUTE_UNUSED)
}
/**
* endDocumentCallback:
* @param ctxt An XML parser context
*
* called when the document end has been detected.
@ -675,7 +651,6 @@ endDocumentCallback(void *ctx ATTRIBUTE_UNUSED)
#if 0
/**
* startElementCallback:
* @param ctxt An XML parser context
* @param name The element name
*
@ -691,7 +666,6 @@ startElementCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* endElementCallback:
* @param ctxt An XML parser context
* @param name The element name
*
@ -707,7 +681,6 @@ endElementCallback(void *ctx ATTRIBUTE_UNUSED,
#endif
/**
* charactersCallback:
* @param ctxt An XML parser context
* @param ch a xmlChar string
* @param len the number of xmlChar
@ -724,7 +697,6 @@ charactersCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* referenceCallback:
* @param ctxt An XML parser context
* @param name The entity name
*
@ -738,7 +710,6 @@ referenceCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* ignorableWhitespaceCallback:
* @param ctxt An XML parser context
* @param ch a xmlChar string
* @param start the first char in the string
@ -756,7 +727,6 @@ ignorableWhitespaceCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* processingInstructionCallback:
* @param ctxt An XML parser context
* @param target the target name
* @param data the PI data's
@ -773,7 +743,6 @@ processingInstructionCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* cdataBlockCallback:
* @param ctx the user data (XML parser context)
* @param value The pcdata content
* @param len the block length
@ -789,7 +758,6 @@ cdataBlockCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* commentCallback:
* @param ctxt An XML parser context
* @param value the comment content
*
@ -803,7 +771,6 @@ commentCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* warningCallback:
* @param ctxt An XML parser context
* @param msg the message to display/transmit
* @...: extra parameters for the message display
@ -819,7 +786,6 @@ warningCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* errorCallback:
* @param ctxt An XML parser context
* @param msg the message to display/transmit
* @...: extra parameters for the message display
@ -835,7 +801,6 @@ errorCallback(void *ctx ATTRIBUTE_UNUSED, const char *msg ATTRIBUTE_UNUSED,
}
/**
* fatalErrorCallback:
* @param ctxt An XML parser context
* @param msg the message to display/transmit
* @...: extra parameters for the message display
@ -855,7 +820,6 @@ fatalErrorCallback(void *ctx ATTRIBUTE_UNUSED,
*/
/**
* startElementNsCallback:
* @param ctxt An XML parser context
* @param name The element name
*
@ -876,7 +840,6 @@ startElementNsCallback(void *ctx ATTRIBUTE_UNUSED,
}
/**
* endElementCallback:
* @param ctxt An XML parser context
* @param name The element name
*
@ -935,7 +898,6 @@ static xmlSAXHandlerPtr callbackSAX2Handler = &callbackSAX2HandlerStruct;
************************************************************************/
/**
* readerTest:
* @param filename the file to parse
* @param max_size size of the limit to test
* @param options parsing options
@ -987,7 +949,6 @@ saxTest(const char *filename, size_t limit, int options, int fail) {
}
#ifdef LIBXML_READER_ENABLED
/**
* readerTest:
* @param filename the file to parse
* @param max_size size of the limit to test
* @param options parsing options

View File

@ -244,7 +244,6 @@ static const char *current;
static int rlen;
/**
* hugeMatch:
* @param URI an URI to test
*
* Check for a huge query
@ -267,7 +266,6 @@ hugeMatch(const char * URI) {
}
/**
* hugeOpen:
* @param URI an URI to test
*
* @returns a pointer to the huge query handler, in this example simply
@ -296,7 +294,6 @@ hugeOpen(const char * URI) {
}
/**
* hugeClose:
* @param context the read context
*
* Close the huge query handler
@ -312,7 +309,6 @@ hugeClose(void * context) {
#define MAX_NODES 1000
/**
* hugeRead:
* @param context the read context
* @param buffer where to store data
* @param len number of bytes to read
@ -466,7 +462,6 @@ static int checkTestFile(const char *filename) {
* *
************************************************************************/
/**
* recursiveDetectTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages: unused
@ -514,7 +509,6 @@ recursiveDetectTest(const char *filename,
}
/**
* notRecursiveDetectTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages: unused
@ -557,7 +551,6 @@ notRecursiveDetectTest(const char *filename,
}
/**
* notRecursiveHugeTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages: unused
@ -659,7 +652,6 @@ notRecursiveHugeTest(const char *filename ATTRIBUTE_UNUSED,
}
/**
* notRecursiveHugeTest:
* @param filename the file to parse
* @param result the file with expected result
* @param err the file with error messages: unused

3
tree.c
View File

@ -962,7 +962,6 @@ error:
}
/**
* DICT_FREE:
* @param str a string
*
* Free a string if it is not owned by the "dict" dictionary in the
@ -4910,7 +4909,7 @@ xmlDocGetRootElement(const xmlDoc *doc) {
/**
* @param doc the document
* @param root the new document root element, if root is NULL no action is taken,
* to remove a node from a document use xmlUnlinkNode(root) instead.
* to remove a node from a document use xmlUnlinkNode() instead.
*
* Set the root element of the document (doc->children is a list
* containing possibly comments, PIs, etc ...).

2
uri.c
View File

@ -22,8 +22,6 @@
#include "private/memory.h"
/**
* MAX_URI_LENGTH:
*
* The definition of the URI regexp in the above RFC has no size limit
* In practice they are usually relatively short except for the
* data URI scheme as defined in RFC 2397. Even for data URI the usual

View File

@ -2235,7 +2235,6 @@ xmlDumpNotationTable(xmlBufferPtr buf, xmlNotationTablePtr table) {
* *
************************************************************************/
/**
* DICT_FREE:
* @param str a string
*
* Free a string if it is not owned by the "dict" dictionary in the
@ -2639,7 +2638,6 @@ xmlWalkRemoveRef(const void *data, void *user)
}
/**
* xmlDummyCompare
* @param data0 Value supplied by the user
* @param data1 Value supplied by the user
*

View File

@ -288,7 +288,6 @@ xmlIOErr(int err)
#if defined(_WIN32)
/**
* __xmlIOWin32UTF8ToWChar:
* @param u8String uft-8 string
*
* Convert a string from utf-8 to wchar (WINDOWS ONLY!)
@ -2061,9 +2060,7 @@ xmlParserInputBufferPush(xmlParserInputBufferPtr in,
return(nbchars);
}
/**
* endOfInput:
*
/*
* When reading from an Input channel indicated end of file or error
* don't reread from it again.
*/

View File

@ -175,7 +175,6 @@ static int xmlTextReaderReadTree(xmlTextReaderPtr reader);
static int xmlTextReaderNextTree(xmlTextReaderPtr reader);
/**
* DICT_FREE:
* @param str a string
*
* Free a string if it is not owned by the "dict" dictionary in the

View File

@ -1261,9 +1261,8 @@ xmlRegPrintStateCompact(FILE* output, xmlRegexpPtr regexp, int state)
}
/*
* xmlRegPrintCompact
* `output` an output stream
* `regexp` the regexp instance
* @param output an output stream
* @param regexp the regexp instance
*
* Print the compact representation of a regexp, in the same fashion as the
* public xmlRegexpPrint function.

View File

@ -893,7 +893,6 @@ xmlNsDumpOutput(xmlOutputBufferPtr buf, xmlNsPtr cur, xmlSaveCtxtPtr ctxt) {
}
/**
* xmlNsListDumpOutputCtxt
* @param ctxt the save context
* @param cur the first namespace
*
@ -1468,7 +1467,6 @@ xmlSaveDocInternal(xmlSaveCtxtPtr ctxt, xmlDocPtr cur,
************************************************************************/
/**
* xhtmlIsEmpty:
* @param node the node
*
* Check if a node is an empty xhtml node
@ -1535,7 +1533,6 @@ xhtmlIsEmpty(xmlNodePtr node) {
}
/**
* xhtmlAttrListDumpOutput:
* @param ctxt the save context
* @param cur the first attribute pointer
*
@ -1604,7 +1601,6 @@ xhtmlAttrListDumpOutput(xmlSaveCtxtPtr ctxt, xmlAttrPtr cur) {
}
/**
* xhtmlNodeDumpOutput:
* @param ctxt the save context
* @param cur the current node
*

View File

@ -1406,7 +1406,6 @@ static const long dayInLeapYearByMonth[12] =
dayInYearByMonth[month - 1]) + day)
/**
* _xmlSchemaParseGYear:
* @param dt pointer to a date structure
* @param str pointer to the string to analyze
*
@ -1462,7 +1461,6 @@ _xmlSchemaParseGYear (xmlSchemaValDatePtr dt, const xmlChar **str) {
}
/**
* PARSE_2_DIGITS:
* @param num the integer to fill in
* @param cur an \#xmlChar *
* @param invalid an integer
@ -1481,7 +1479,6 @@ _xmlSchemaParseGYear (xmlSchemaValDatePtr dt, const xmlChar **str) {
cur += 2;
/**
* PARSE_FLOAT:
* @param num the double to fill in
* @param cur an \#xmlChar *
* @param invalid an integer
@ -1507,7 +1504,6 @@ _xmlSchemaParseGYear (xmlSchemaValDatePtr dt, const xmlChar **str) {
}
/**
* _xmlSchemaParseGMonth:
* @param dt pointer to a date structure
* @param str pointer to the string to analyze
*
@ -1537,7 +1533,6 @@ _xmlSchemaParseGMonth (xmlSchemaValDatePtr dt, const xmlChar **str) {
}
/**
* _xmlSchemaParseGDay:
* @param dt pointer to a date structure
* @param str pointer to the string to analyze
*
@ -1566,7 +1561,6 @@ _xmlSchemaParseGDay (xmlSchemaValDatePtr dt, const xmlChar **str) {
}
/**
* _xmlSchemaParseTime:
* @param dt pointer to a date structure
* @param str pointer to the string to analyze
*
@ -1618,7 +1612,6 @@ _xmlSchemaParseTime (xmlSchemaValDatePtr dt, const xmlChar **str) {
}
/**
* _xmlSchemaParseTimeZone:
* @param dt pointer to a date structure
* @param str pointer to the string to analyze
*
@ -1693,7 +1686,6 @@ _xmlSchemaParseTimeZone (xmlSchemaValDatePtr dt, const xmlChar **str) {
}
/**
* _xmlSchemaBase64Decode:
* @param ch a character
*
* Converts a base64 encoded character to its base 64 value.
@ -1718,7 +1710,6 @@ _xmlSchemaBase64Decode (const xmlChar ch) {
****************************************************************/
/**
* PARSE_DIGITS:
* @param num the integer to fill in
* @param cur an \#xmlChar *
* @param num_type an integer flag
@ -1738,7 +1729,6 @@ _xmlSchemaBase64Decode (const xmlChar ch) {
}
/**
* PARSE_NUM:
* @param num the double to fill in
* @param cur an \#xmlChar *
* @param num_type an integer flag
@ -3905,7 +3895,6 @@ xmlSchemaCopyValue(xmlSchemaValPtr val)
}
/**
* _xmlSchemaDateAdd:
* @param dt an \#xmlSchemaValPtr
* @param dur an \#xmlSchemaValPtr of type \#XS_DURATION
*
@ -4099,7 +4088,6 @@ xmlSchemaDateNormalize (xmlSchemaValPtr dt, double offset)
}
/**
* _xmlSchemaDateCastYMToDays:
* @param dt an \#xmlSchemaValPtr
*
* Convert mon and year of `dt` to total number of days. Take the
@ -4133,7 +4121,6 @@ _xmlSchemaDateCastYMToDays (const xmlSchemaValPtr dt)
}
/**
* TIME_TO_NUMBER:
* @param dt an \#xmlSchemaValPtr
*
* Calculates the number of seconds in the time portion of `dt`.

10
xpath.c
View File

@ -56,8 +56,6 @@
#endif
/**
* WITH_TIM_SORT:
*
* Use the Timsort algorithm provided in timsort.h to sort
* nodeset as this is a great improvement over the old Shell sort
* used in xmlXPathNodeSetSort()
@ -65,7 +63,6 @@
#define WITH_TIM_SORT
/*
* XP_OPTIMIZED_NON_ELEM_COMPARISON:
* If defined, this will use xmlXPathCmpNodesExt() instead of
* xmlXPathCmpNodes(). The new function is optimized comparison of
* non-element nodes; actually it will speed up comparison only if
@ -76,14 +73,12 @@
#define XP_OPTIMIZED_NON_ELEM_COMPARISON
/*
* XP_OPTIMIZED_FILTER_FIRST:
* If defined, this will optimize expressions like "key('foo', 'val')[b][1]"
* in a way, that it stop evaluation at the first node.
*/
#define XP_OPTIMIZED_FILTER_FIRST
/*
* XPATH_MAX_STEPS:
* when compiling an XPath expression we arbitrary limit the maximum
* number of step operation in the compiled expression. 1000000 is
* an insanely large value which should never be reached under normal
@ -92,7 +87,6 @@
#define XPATH_MAX_STEPS 1000000
/*
* XPATH_MAX_STACK_DEPTH:
* when evaluating an XPath expression we arbitrary limit the maximum
* number of object allowed to be pushed on the stack. 1000000 is
* an insanely large value which should never be reached under normal
@ -101,7 +95,6 @@
#define XPATH_MAX_STACK_DEPTH 1000000
/*
* XPATH_MAX_NODESET_LENGTH:
* when evaluating an XPath expression nodesets are created and we
* arbitrary limit the maximum length of those node set. 10000000 is
* an insanely large value which should never be reached under normal
@ -111,7 +104,6 @@
#define XPATH_MAX_NODESET_LENGTH 10000000
/*
* XPATH_MAX_RECRUSION_DEPTH:
* Maximum amount of nested functions calls when parsing or evaluating
* expressions
*/
@ -602,7 +594,6 @@ turtle_comparison:
#define SORT_NAME libxml_domnode
#define SORT_TYPE xmlNodePtr
/**
* wrap_cmp:
* @param x a node
* @param y another node
*
@ -637,7 +628,6 @@ int wrap_cmp( xmlNodePtr x, xmlNodePtr y );
************************************************************************/
/**
* XP_ERRORNULL:
* @param X the error code
*
* Macro to raise an XPath error and return NULL.