Home | History | Annotate | Download | only in libxml2 
      1 /*
      2  * legacy.c: set of deprecated routines, not to be used anymore but
      3  *           kept purely for ABI compatibility
      4  *
      5  * See Copyright for the status of this software.
      6  *
      7  * daniel (at) veillard.com
      8  */
      9 
     10 #define IN_LIBXML
     11 #include "libxml.h"
     12 
     13 #ifdef LIBXML_LEGACY_ENABLED
     14 #include <string.h>
     15 
     16 #include <libxml/tree.h>
     17 #include <libxml/entities.h>
     18 #include <libxml/SAX.h>
     19 #include <libxml/parserInternals.h>
     20 #include <libxml/HTMLparser.h>
     21 
     22 void xmlUpgradeOldNs(xmlDocPtr doc);
     23 
     24 /************************************************************************
     25  *									*
     26  *		Deprecated functions kept for compatibility		*
     27  *									*
     28  ************************************************************************/
     29 
     30 #ifdef LIBXML_HTML_ENABLED
     31 xmlChar *htmlDecodeEntities(htmlParserCtxtPtr ctxt, int len, xmlChar end,
     32                             xmlChar end2, xmlChar end3);
     33 
     34 /**
     35  * htmlDecodeEntities:
     36  * @ctxt:  the parser context
     37  * @len:  the len to decode (in bytes !), -1 for no size limit
     38  * @end:  an end marker xmlChar, 0 if none
     39  * @end2:  an end marker xmlChar, 0 if none
     40  * @end3:  an end marker xmlChar, 0 if none
     41  *
     42  * Substitute the HTML entities by their value
     43  *
     44  * DEPRECATED !!!!
     45  *
     46  * Returns A newly allocated string with the substitution done. The caller
     47  *      must deallocate it !
     48  */
     49 xmlChar *
     50 htmlDecodeEntities(htmlParserCtxtPtr ctxt ATTRIBUTE_UNUSED,
     51                    int len ATTRIBUTE_UNUSED, xmlChar end ATTRIBUTE_UNUSED,
     52                    xmlChar end2 ATTRIBUTE_UNUSED,
     53                    xmlChar end3 ATTRIBUTE_UNUSED)
     54 {
     55     static int deprecated = 0;
     56 
     57     if (!deprecated) {
     58         xmlGenericError(xmlGenericErrorContext,
     59                         "htmlDecodeEntities() deprecated function reached\n");
     60         deprecated = 1;
     61     }
     62     return (NULL);
     63 }
     64 #endif
     65 
     66 /**
     67  * xmlInitializePredefinedEntities:
     68  *
     69  * Set up the predefined entities.
     70  * Deprecated call
     71  */
     72 void
     73 xmlInitializePredefinedEntities(void)
     74 {
     75 }
     76 
     77 /**
     78  * xmlCleanupPredefinedEntities:
     79  *
     80  * Cleanup up the predefined entities table.
     81  * Deprecated call
     82  */
     83 void
     84 xmlCleanupPredefinedEntities(void)
     85 {
     86 }
     87 
     88 static const char *xmlFeaturesList[] = {
     89     "validate",
     90     "load subset",
     91     "keep blanks",
     92     "disable SAX",
     93     "fetch external entities",
     94     "substitute entities",
     95     "gather line info",
     96     "user data",
     97     "is html",
     98     "is standalone",
     99     "stop parser",
    100     "document",
    101     "is well formed",
    102     "is valid",
    103     "SAX block",
    104     "SAX function internalSubset",
    105     "SAX function isStandalone",
    106     "SAX function hasInternalSubset",
    107     "SAX function hasExternalSubset",
    108     "SAX function resolveEntity",
    109     "SAX function getEntity",
    110     "SAX function entityDecl",
    111     "SAX function notationDecl",
    112     "SAX function attributeDecl",
    113     "SAX function elementDecl",
    114     "SAX function unparsedEntityDecl",
    115     "SAX function setDocumentLocator",
    116     "SAX function startDocument",
    117     "SAX function endDocument",
    118     "SAX function startElement",
    119     "SAX function endElement",
    120     "SAX function reference",
    121     "SAX function characters",
    122     "SAX function ignorableWhitespace",
    123     "SAX function processingInstruction",
    124     "SAX function comment",
    125     "SAX function warning",
    126     "SAX function error",
    127     "SAX function fatalError",
    128     "SAX function getParameterEntity",
    129     "SAX function cdataBlock",
    130     "SAX function externalSubset",
    131 };
    132 
    133 /**
    134  * xmlGetFeaturesList:
    135  * @len:  the length of the features name array (input/output)
    136  * @result:  an array of string to be filled with the features name.
    137  *
    138  * Copy at most *@len feature names into the @result array
    139  *
    140  * Returns -1 in case or error, or the total number of features,
    141  *            len is updated with the number of strings copied,
    142  *            strings must not be deallocated
    143  */
    144 int
    145 xmlGetFeaturesList(int *len, const char **result)
    146 {
    147     int ret, i;
    148 
    149     ret = sizeof(xmlFeaturesList) / sizeof(xmlFeaturesList[0]);
    150     if ((len == NULL) || (result == NULL))
    151         return (ret);
    152     if ((*len < 0) || (*len >= 1000))
    153         return (-1);
    154     if (*len > ret)
    155         *len = ret;
    156     for (i = 0; i < *len; i++)
    157         result[i] = xmlFeaturesList[i];
    158     return (ret);
    159 }
    160 
    161 /**
    162  * xmlGetFeature:
    163  * @ctxt:  an XML/HTML parser context
    164  * @name:  the feature name
    165  * @result:  location to store the result
    166  *
    167  * Read the current value of one feature of this parser instance
    168  *
    169  * Returns -1 in case or error, 0 otherwise
    170  */
    171 int
    172 xmlGetFeature(xmlParserCtxtPtr ctxt, const char *name, void *result)
    173 {
    174     if ((ctxt == NULL) || (name == NULL) || (result == NULL))
    175         return (-1);
    176 
    177     if (!strcmp(name, "validate")) {
    178         *((int *) result) = ctxt->validate;
    179     } else if (!strcmp(name, "keep blanks")) {
    180         *((int *) result) = ctxt->keepBlanks;
    181     } else if (!strcmp(name, "disable SAX")) {
    182         *((int *) result) = ctxt->disableSAX;
    183     } else if (!strcmp(name, "fetch external entities")) {
    184         *((int *) result) = ctxt->loadsubset;
    185     } else if (!strcmp(name, "substitute entities")) {
    186         *((int *) result) = ctxt->replaceEntities;
    187     } else if (!strcmp(name, "gather line info")) {
    188         *((int *) result) = ctxt->record_info;
    189     } else if (!strcmp(name, "user data")) {
    190         *((void **) result) = ctxt->userData;
    191     } else if (!strcmp(name, "is html")) {
    192         *((int *) result) = ctxt->html;
    193     } else if (!strcmp(name, "is standalone")) {
    194         *((int *) result) = ctxt->standalone;
    195     } else if (!strcmp(name, "document")) {
    196         *((xmlDocPtr *) result) = ctxt->myDoc;
    197     } else if (!strcmp(name, "is well formed")) {
    198         *((int *) result) = ctxt->wellFormed;
    199     } else if (!strcmp(name, "is valid")) {
    200         *((int *) result) = ctxt->valid;
    201     } else if (!strcmp(name, "SAX block")) {
    202         *((xmlSAXHandlerPtr *) result) = ctxt->sax;
    203     } else if (!strcmp(name, "SAX function internalSubset")) {
    204         *((internalSubsetSAXFunc *) result) = ctxt->sax->internalSubset;
    205     } else if (!strcmp(name, "SAX function isStandalone")) {
    206         *((isStandaloneSAXFunc *) result) = ctxt->sax->isStandalone;
    207     } else if (!strcmp(name, "SAX function hasInternalSubset")) {
    208         *((hasInternalSubsetSAXFunc *) result) =
    209             ctxt->sax->hasInternalSubset;
    210     } else if (!strcmp(name, "SAX function hasExternalSubset")) {
    211         *((hasExternalSubsetSAXFunc *) result) =
    212             ctxt->sax->hasExternalSubset;
    213     } else if (!strcmp(name, "SAX function resolveEntity")) {
    214         *((resolveEntitySAXFunc *) result) = ctxt->sax->resolveEntity;
    215     } else if (!strcmp(name, "SAX function getEntity")) {
    216         *((getEntitySAXFunc *) result) = ctxt->sax->getEntity;
    217     } else if (!strcmp(name, "SAX function entityDecl")) {
    218         *((entityDeclSAXFunc *) result) = ctxt->sax->entityDecl;
    219     } else if (!strcmp(name, "SAX function notationDecl")) {
    220         *((notationDeclSAXFunc *) result) = ctxt->sax->notationDecl;
    221     } else if (!strcmp(name, "SAX function attributeDecl")) {
    222         *((attributeDeclSAXFunc *) result) = ctxt->sax->attributeDecl;
    223     } else if (!strcmp(name, "SAX function elementDecl")) {
    224         *((elementDeclSAXFunc *) result) = ctxt->sax->elementDecl;
    225     } else if (!strcmp(name, "SAX function unparsedEntityDecl")) {
    226         *((unparsedEntityDeclSAXFunc *) result) =
    227             ctxt->sax->unparsedEntityDecl;
    228     } else if (!strcmp(name, "SAX function setDocumentLocator")) {
    229         *((setDocumentLocatorSAXFunc *) result) =
    230             ctxt->sax->setDocumentLocator;
    231     } else if (!strcmp(name, "SAX function startDocument")) {
    232         *((startDocumentSAXFunc *) result) = ctxt->sax->startDocument;
    233     } else if (!strcmp(name, "SAX function endDocument")) {
    234         *((endDocumentSAXFunc *) result) = ctxt->sax->endDocument;
    235     } else if (!strcmp(name, "SAX function startElement")) {
    236         *((startElementSAXFunc *) result) = ctxt->sax->startElement;
    237     } else if (!strcmp(name, "SAX function endElement")) {
    238         *((endElementSAXFunc *) result) = ctxt->sax->endElement;
    239     } else if (!strcmp(name, "SAX function reference")) {
    240         *((referenceSAXFunc *) result) = ctxt->sax->reference;
    241     } else if (!strcmp(name, "SAX function characters")) {
    242         *((charactersSAXFunc *) result) = ctxt->sax->characters;
    243     } else if (!strcmp(name, "SAX function ignorableWhitespace")) {
    244         *((ignorableWhitespaceSAXFunc *) result) =
    245             ctxt->sax->ignorableWhitespace;
    246     } else if (!strcmp(name, "SAX function processingInstruction")) {
    247         *((processingInstructionSAXFunc *) result) =
    248             ctxt->sax->processingInstruction;
    249     } else if (!strcmp(name, "SAX function comment")) {
    250         *((commentSAXFunc *) result) = ctxt->sax->comment;
    251     } else if (!strcmp(name, "SAX function warning")) {
    252         *((warningSAXFunc *) result) = ctxt->sax->warning;
    253     } else if (!strcmp(name, "SAX function error")) {
    254         *((errorSAXFunc *) result) = ctxt->sax->error;
    255     } else if (!strcmp(name, "SAX function fatalError")) {
    256         *((fatalErrorSAXFunc *) result) = ctxt->sax->fatalError;
    257     } else if (!strcmp(name, "SAX function getParameterEntity")) {
    258         *((getParameterEntitySAXFunc *) result) =
    259             ctxt->sax->getParameterEntity;
    260     } else if (!strcmp(name, "SAX function cdataBlock")) {
    261         *((cdataBlockSAXFunc *) result) = ctxt->sax->cdataBlock;
    262     } else if (!strcmp(name, "SAX function externalSubset")) {
    263         *((externalSubsetSAXFunc *) result) = ctxt->sax->externalSubset;
    264     } else {
    265         return (-1);
    266     }
    267     return (0);
    268 }
    269 
    270 /**
    271  * xmlSetFeature:
    272  * @ctxt:  an XML/HTML parser context
    273  * @name:  the feature name
    274  * @value:  pointer to the location of the new value
    275  *
    276  * Change the current value of one feature of this parser instance
    277  *
    278  * Returns -1 in case or error, 0 otherwise
    279  */
    280 int
    281 xmlSetFeature(xmlParserCtxtPtr ctxt, const char *name, void *value)
    282 {
    283     if ((ctxt == NULL) || (name == NULL) || (value == NULL))
    284         return (-1);
    285 
    286     if (!strcmp(name, "validate")) {
    287         int newvalidate = *((int *) value);
    288 
    289         if ((!ctxt->validate) && (newvalidate != 0)) {
    290             if (ctxt->vctxt.warning == NULL)
    291                 ctxt->vctxt.warning = xmlParserValidityWarning;
    292             if (ctxt->vctxt.error == NULL)
    293                 ctxt->vctxt.error = xmlParserValidityError;
    294             ctxt->vctxt.nodeMax = 0;
    295         }
    296         ctxt->validate = newvalidate;
    297     } else if (!strcmp(name, "keep blanks")) {
    298         ctxt->keepBlanks = *((int *) value);
    299     } else if (!strcmp(name, "disable SAX")) {
    300         ctxt->disableSAX = *((int *) value);
    301     } else if (!strcmp(name, "fetch external entities")) {
    302         ctxt->loadsubset = *((int *) value);
    303     } else if (!strcmp(name, "substitute entities")) {
    304         ctxt->replaceEntities = *((int *) value);
    305     } else if (!strcmp(name, "gather line info")) {
    306         ctxt->record_info = *((int *) value);
    307     } else if (!strcmp(name, "user data")) {
    308         ctxt->userData = *((void **) value);
    309     } else if (!strcmp(name, "is html")) {
    310         ctxt->html = *((int *) value);
    311     } else if (!strcmp(name, "is standalone")) {
    312         ctxt->standalone = *((int *) value);
    313     } else if (!strcmp(name, "document")) {
    314         ctxt->myDoc = *((xmlDocPtr *) value);
    315     } else if (!strcmp(name, "is well formed")) {
    316         ctxt->wellFormed = *((int *) value);
    317     } else if (!strcmp(name, "is valid")) {
    318         ctxt->valid = *((int *) value);
    319     } else if (!strcmp(name, "SAX block")) {
    320         ctxt->sax = *((xmlSAXHandlerPtr *) value);
    321     } else if (!strcmp(name, "SAX function internalSubset")) {
    322         ctxt->sax->internalSubset = *((internalSubsetSAXFunc *) value);
    323     } else if (!strcmp(name, "SAX function isStandalone")) {
    324         ctxt->sax->isStandalone = *((isStandaloneSAXFunc *) value);
    325     } else if (!strcmp(name, "SAX function hasInternalSubset")) {
    326         ctxt->sax->hasInternalSubset =
    327             *((hasInternalSubsetSAXFunc *) value);
    328     } else if (!strcmp(name, "SAX function hasExternalSubset")) {
    329         ctxt->sax->hasExternalSubset =
    330             *((hasExternalSubsetSAXFunc *) value);
    331     } else if (!strcmp(name, "SAX function resolveEntity")) {
    332         ctxt->sax->resolveEntity = *((resolveEntitySAXFunc *) value);
    333     } else if (!strcmp(name, "SAX function getEntity")) {
    334         ctxt->sax->getEntity = *((getEntitySAXFunc *) value);
    335     } else if (!strcmp(name, "SAX function entityDecl")) {
    336         ctxt->sax->entityDecl = *((entityDeclSAXFunc *) value);
    337     } else if (!strcmp(name, "SAX function notationDecl")) {
    338         ctxt->sax->notationDecl = *((notationDeclSAXFunc *) value);
    339     } else if (!strcmp(name, "SAX function attributeDecl")) {
    340         ctxt->sax->attributeDecl = *((attributeDeclSAXFunc *) value);
    341     } else if (!strcmp(name, "SAX function elementDecl")) {
    342         ctxt->sax->elementDecl = *((elementDeclSAXFunc *) value);
    343     } else if (!strcmp(name, "SAX function unparsedEntityDecl")) {
    344         ctxt->sax->unparsedEntityDecl =
    345             *((unparsedEntityDeclSAXFunc *) value);
    346     } else if (!strcmp(name, "SAX function setDocumentLocator")) {
    347         ctxt->sax->setDocumentLocator =
    348             *((setDocumentLocatorSAXFunc *) value);
    349     } else if (!strcmp(name, "SAX function startDocument")) {
    350         ctxt->sax->startDocument = *((startDocumentSAXFunc *) value);
    351     } else if (!strcmp(name, "SAX function endDocument")) {
    352         ctxt->sax->endDocument = *((endDocumentSAXFunc *) value);
    353     } else if (!strcmp(name, "SAX function startElement")) {
    354         ctxt->sax->startElement = *((startElementSAXFunc *) value);
    355     } else if (!strcmp(name, "SAX function endElement")) {
    356         ctxt->sax->endElement = *((endElementSAXFunc *) value);
    357     } else if (!strcmp(name, "SAX function reference")) {
    358         ctxt->sax->reference = *((referenceSAXFunc *) value);
    359     } else if (!strcmp(name, "SAX function characters")) {
    360         ctxt->sax->characters = *((charactersSAXFunc *) value);
    361     } else if (!strcmp(name, "SAX function ignorableWhitespace")) {
    362         ctxt->sax->ignorableWhitespace =
    363             *((ignorableWhitespaceSAXFunc *) value);
    364     } else if (!strcmp(name, "SAX function processingInstruction")) {
    365         ctxt->sax->processingInstruction =
    366             *((processingInstructionSAXFunc *) value);
    367     } else if (!strcmp(name, "SAX function comment")) {
    368         ctxt->sax->comment = *((commentSAXFunc *) value);
    369     } else if (!strcmp(name, "SAX function warning")) {
    370         ctxt->sax->warning = *((warningSAXFunc *) value);
    371     } else if (!strcmp(name, "SAX function error")) {
    372         ctxt->sax->error = *((errorSAXFunc *) value);
    373     } else if (!strcmp(name, "SAX function fatalError")) {
    374         ctxt->sax->fatalError = *((fatalErrorSAXFunc *) value);
    375     } else if (!strcmp(name, "SAX function getParameterEntity")) {
    376         ctxt->sax->getParameterEntity =
    377             *((getParameterEntitySAXFunc *) value);
    378     } else if (!strcmp(name, "SAX function cdataBlock")) {
    379         ctxt->sax->cdataBlock = *((cdataBlockSAXFunc *) value);
    380     } else if (!strcmp(name, "SAX function externalSubset")) {
    381         ctxt->sax->externalSubset = *((externalSubsetSAXFunc *) value);
    382     } else {
    383         return (-1);
    384     }
    385     return (0);
    386 }
    387 
    388 /**
    389  * xmlDecodeEntities:
    390  * @ctxt:  the parser context
    391  * @len:  the len to decode (in bytes !), -1 for no size limit
    392  * @what:  combination of XML_SUBSTITUTE_REF and XML_SUBSTITUTE_PEREF
    393  * @end:  an end marker xmlChar, 0 if none
    394  * @end2:  an end marker xmlChar, 0 if none
    395  * @end3:  an end marker xmlChar, 0 if none
    396  *
    397  * This function is deprecated, we now always process entities content
    398  * through xmlStringDecodeEntities
    399  *
    400  * TODO: remove it in next major release.
    401  *
    402  * [67] Reference ::= EntityRef | CharRef
    403  *
    404  * [69] PEReference ::= '%' Name ';'
    405  *
    406  * Returns A newly allocated string with the substitution done. The caller
    407  *      must deallocate it !
    408  */
    409 xmlChar *
    410 xmlDecodeEntities(xmlParserCtxtPtr ctxt ATTRIBUTE_UNUSED,
    411                   int len ATTRIBUTE_UNUSED, int what ATTRIBUTE_UNUSED,
    412                   xmlChar end ATTRIBUTE_UNUSED,
    413                   xmlChar end2 ATTRIBUTE_UNUSED,
    414                   xmlChar end3 ATTRIBUTE_UNUSED)
    415 {
    416     static int deprecated = 0;
    417 
    418     if (!deprecated) {
    419         xmlGenericError(xmlGenericErrorContext,
    420                         "xmlDecodeEntities() deprecated function reached\n");
    421         deprecated = 1;
    422     }
    423     return (NULL);
    424 }
    425 
    426 /**
    427  * xmlNamespaceParseNCName:
    428  * @ctxt:  an XML parser context
    429  *
    430  * parse an XML namespace name.
    431  *
    432  * TODO: this seems not in use anymore, the namespace handling is done on
    433  *       top of the SAX interfaces, i.e. not on raw input.
    434  *
    435  * [NS 3] NCName ::= (Letter | '_') (NCNameChar)*
    436  *
    437  * [NS 4] NCNameChar ::= Letter | Digit | '.' | '-' | '_' |
    438  *                       CombiningChar | Extender
    439  *
    440  * Returns the namespace name or NULL
    441  */
    442 
    443 xmlChar *
    444 xmlNamespaceParseNCName(xmlParserCtxtPtr ctxt ATTRIBUTE_UNUSED)
    445 {
    446     static int deprecated = 0;
    447 
    448     if (!deprecated) {
    449         xmlGenericError(xmlGenericErrorContext,
    450                         "xmlNamespaceParseNCName() deprecated function reached\n");
    451         deprecated = 1;
    452     }
    453     return (NULL);
    454 }
    455 
    456 /**
    457  * xmlNamespaceParseQName:
    458  * @ctxt:  an XML parser context
    459  * @prefix:  a xmlChar **
    460  *
    461  * TODO: this seems not in use anymore, the namespace handling is done on
    462  *       top of the SAX interfaces, i.e. not on raw input.
    463  *
    464  * parse an XML qualified name
    465  *
    466  * [NS 5] QName ::= (Prefix ':')? LocalPart
    467  *
    468  * [NS 6] Prefix ::= NCName
    469  *
    470  * [NS 7] LocalPart ::= NCName
    471  *
    472  * Returns the local part, and prefix is updated
    473  *   to get the Prefix if any.
    474  */
    475 
    476 xmlChar *
    477 xmlNamespaceParseQName(xmlParserCtxtPtr ctxt ATTRIBUTE_UNUSED,
    478                        xmlChar ** prefix ATTRIBUTE_UNUSED)
    479 {
    480 
    481     static int deprecated = 0;
    482 
    483     if (!deprecated) {
    484         xmlGenericError(xmlGenericErrorContext,
    485                         "xmlNamespaceParseQName() deprecated function reached\n");
    486         deprecated = 1;
    487     }
    488     return (NULL);
    489 }
    490 
    491 /**
    492  * xmlNamespaceParseNSDef:
    493  * @ctxt:  an XML parser context
    494  *
    495  * parse a namespace prefix declaration
    496  *
    497  * TODO: this seems not in use anymore, the namespace handling is done on
    498  *       top of the SAX interfaces, i.e. not on raw input.
    499  *
    500  * [NS 1] NSDef ::= PrefixDef Eq SystemLiteral
    501  *
    502  * [NS 2] PrefixDef ::= 'xmlns' (':' NCName)?
    503  *
    504  * Returns the namespace name
    505  */
    506 
    507 xmlChar *
    508 xmlNamespaceParseNSDef(xmlParserCtxtPtr ctxt ATTRIBUTE_UNUSED)
    509 {
    510     static int deprecated = 0;
    511 
    512     if (!deprecated) {
    513         xmlGenericError(xmlGenericErrorContext,
    514                         "xmlNamespaceParseNSDef() deprecated function reached\n");
    515         deprecated = 1;
    516     }
    517     return (NULL);
    518 }
    519 
    520 /**
    521  * xmlParseQuotedString:
    522  * @ctxt:  an XML parser context
    523  *
    524  * Parse and return a string between quotes or doublequotes
    525  *
    526  * TODO: Deprecated, to  be removed at next drop of binary compatibility
    527  *
    528  * Returns the string parser or NULL.
    529  */
    530 xmlChar *
    531 xmlParseQuotedString(xmlParserCtxtPtr ctxt ATTRIBUTE_UNUSED)
    532 {
    533     static int deprecated = 0;
    534 
    535     if (!deprecated) {
    536         xmlGenericError(xmlGenericErrorContext,
    537                         "xmlParseQuotedString() deprecated function reached\n");
    538         deprecated = 1;
    539     }
    540     return (NULL);
    541 }
    542 
    543 /**
    544  * xmlParseNamespace:
    545  * @ctxt:  an XML parser context
    546  *
    547  * xmlParseNamespace: parse specific PI '<?namespace ...' constructs.
    548  *
    549  * This is what the older xml-name Working Draft specified, a bunch of
    550  * other stuff may still rely on it, so support is still here as
    551  * if it was declared on the root of the Tree:-(
    552  *
    553  * TODO: remove from library
    554  *
    555  * To be removed at next drop of binary compatibility
    556  */
    557 
    558 void
    559 xmlParseNamespace(xmlParserCtxtPtr ctxt ATTRIBUTE_UNUSED)
    560 {
    561     static int deprecated = 0;
    562 
    563     if (!deprecated) {
    564         xmlGenericError(xmlGenericErrorContext,
    565                         "xmlParseNamespace() deprecated function reached\n");
    566         deprecated = 1;
    567     }
    568 }
    569 
    570 /**
    571  * xmlScanName:
    572  * @ctxt:  an XML parser context
    573  *
    574  * Trickery: parse an XML name but without consuming the input flow
    575  * Needed for rollback cases. Used only when parsing entities references.
    576  *
    577  * TODO: seems deprecated now, only used in the default part of
    578  *       xmlParserHandleReference
    579  *
    580  * [4] NameChar ::= Letter | Digit | '.' | '-' | '_' | ':' |
    581  *                  CombiningChar | Extender
    582  *
    583  * [5] Name ::= (Letter | '_' | ':') (NameChar)*
    584  *
    585  * [6] Names ::= Name (S Name)*
    586  *
    587  * Returns the Name parsed or NULL
    588  */
    589 
    590 xmlChar *
    591 xmlScanName(xmlParserCtxtPtr ctxt ATTRIBUTE_UNUSED)
    592 {
    593     static int deprecated = 0;
    594 
    595     if (!deprecated) {
    596         xmlGenericError(xmlGenericErrorContext,
    597                         "xmlScanName() deprecated function reached\n");
    598         deprecated = 1;
    599     }
    600     return (NULL);
    601 }
    602 
    603 /**
    604  * xmlParserHandleReference:
    605  * @ctxt:  the parser context
    606  *
    607  * TODO: Remove, now deprecated ... the test is done directly in the
    608  *       content parsing
    609  * routines.
    610  *
    611  * [67] Reference ::= EntityRef | CharRef
    612  *
    613  * [68] EntityRef ::= '&' Name ';'
    614  *
    615  * [ WFC: Entity Declared ]
    616  * the Name given in the entity reference must match that in an entity
    617  * declaration, except that well-formed documents need not declare any
    618  * of the following entities: amp, lt, gt, apos, quot.
    619  *
    620  * [ WFC: Parsed Entity ]
    621  * An entity reference must not contain the name of an unparsed entity
    622  *
    623  * [66] CharRef ::= '&#' [0-9]+ ';' |
    624  *                  '&#x' [0-9a-fA-F]+ ';'
    625  *
    626  * A PEReference may have been detected in the current input stream
    627  * the handling is done accordingly to
    628  *      http://www.w3.org/TR/REC-xml#entproc
    629  */
    630 void
    631 xmlParserHandleReference(xmlParserCtxtPtr ctxt ATTRIBUTE_UNUSED)
    632 {
    633     static int deprecated = 0;
    634 
    635     if (!deprecated) {
    636         xmlGenericError(xmlGenericErrorContext,
    637                         "xmlParserHandleReference() deprecated function reached\n");
    638         deprecated = 1;
    639     }
    640 
    641     return;
    642 }
    643 
    644 /**
    645  * xmlHandleEntity:
    646  * @ctxt:  an XML parser context
    647  * @entity:  an XML entity pointer.
    648  *
    649  * Default handling of defined entities, when should we define a new input
    650  * stream ? When do we just handle that as a set of chars ?
    651  *
    652  * OBSOLETE: to be removed at some point.
    653  */
    654 
    655 void
    656 xmlHandleEntity(xmlParserCtxtPtr ctxt ATTRIBUTE_UNUSED,
    657                 xmlEntityPtr entity ATTRIBUTE_UNUSED)
    658 {
    659     static int deprecated = 0;
    660 
    661     if (!deprecated) {
    662         xmlGenericError(xmlGenericErrorContext,
    663                         "xmlHandleEntity() deprecated function reached\n");
    664         deprecated = 1;
    665     }
    666 }
    667 
    668 /**
    669  * xmlNewGlobalNs:
    670  * @doc:  the document carrying the namespace
    671  * @href:  the URI associated
    672  * @prefix:  the prefix for the namespace
    673  *
    674  * Creation of a Namespace, the old way using PI and without scoping
    675  *   DEPRECATED !!!
    676  * Returns NULL this functionality had been removed
    677  */
    678 xmlNsPtr
    679 xmlNewGlobalNs(xmlDocPtr doc ATTRIBUTE_UNUSED,
    680                const xmlChar * href ATTRIBUTE_UNUSED,
    681                const xmlChar * prefix ATTRIBUTE_UNUSED)
    682 {
    683     static int deprecated = 0;
    684 
    685     if (!deprecated) {
    686         xmlGenericError(xmlGenericErrorContext,
    687                         "xmlNewGlobalNs() deprecated function reached\n");
    688         deprecated = 1;
    689     }
    690     return (NULL);
    691 }
    692 
    693 /**
    694  * xmlUpgradeOldNs:
    695  * @doc:  a document pointer
    696  *
    697  * Upgrade old style Namespaces (PI) and move them to the root of the document.
    698  * DEPRECATED
    699  */
    700 void
    701 xmlUpgradeOldNs(xmlDocPtr doc ATTRIBUTE_UNUSED)
    702 {
    703     static int deprecated = 0;
    704 
    705     if (!deprecated) {
    706         xmlGenericError(xmlGenericErrorContext,
    707                         "xmlUpgradeOldNs() deprecated function reached\n");
    708         deprecated = 1;
    709     }
    710 }
    711 
    712 /**
    713  * xmlEncodeEntities:
    714  * @doc:  the document containing the string
    715  * @input:  A string to convert to XML.
    716  *
    717  * TODO: remove xmlEncodeEntities, once we are not afraid of breaking binary
    718  *       compatibility
    719  *
    720  * People must migrate their code to xmlEncodeEntitiesReentrant !
    721  * This routine will issue a warning when encountered.
    722  *
    723  * Returns NULL
    724  */
    725 const xmlChar *
    726 xmlEncodeEntities(xmlDocPtr doc ATTRIBUTE_UNUSED,
    727                   const xmlChar * input ATTRIBUTE_UNUSED)
    728 {
    729     static int warning = 1;
    730 
    731     if (warning) {
    732         xmlGenericError(xmlGenericErrorContext,
    733                         "Deprecated API xmlEncodeEntities() used\n");
    734         xmlGenericError(xmlGenericErrorContext,
    735                         "   change code to use xmlEncodeEntitiesReentrant()\n");
    736         warning = 0;
    737     }
    738     return (NULL);
    739 }
    740 
    741 /************************************************************************
    742  *									*
    743  *		Old set of SAXv1 functions 				*
    744  *									*
    745  ************************************************************************/
    746 static int deprecated_v1_msg = 0;
    747 
    748 #define DEPRECATED(n)						\
    749     if (deprecated_v1_msg == 0)					\
    750 	xmlGenericError(xmlGenericErrorContext,			\
    751 	  "Use of deprecated SAXv1 function %s\n", n);		\
    752     deprecated_v1_msg++;
    753 
    754 /**
    755  * getPublicId:
    756  * @ctx: the user data (XML parser context)
    757  *
    758  * Provides the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN"
    759  * DEPRECATED: use xmlSAX2GetPublicId()
    760  *
    761  * Returns a xmlChar *
    762  */
    763 const xmlChar *
    764 getPublicId(void *ctx)
    765 {
    766     DEPRECATED("getPublicId")
    767         return (xmlSAX2GetPublicId(ctx));
    768 }
    769 
    770 /**
    771  * getSystemId:
    772  * @ctx: the user data (XML parser context)
    773  *
    774  * Provides the system ID, basically URL or filename e.g.
    775  * http://www.sgmlsource.com/dtds/memo.dtd
    776  * DEPRECATED: use xmlSAX2GetSystemId()
    777  *
    778  * Returns a xmlChar *
    779  */
    780 const xmlChar *
    781 getSystemId(void *ctx)
    782 {
    783     DEPRECATED("getSystemId")
    784         return (xmlSAX2GetSystemId(ctx));
    785 }
    786 
    787 /**
    788  * getLineNumber:
    789  * @ctx: the user data (XML parser context)
    790  *
    791  * Provide the line number of the current parsing point.
    792  * DEPRECATED: use xmlSAX2GetLineNumber()
    793  *
    794  * Returns an int
    795  */
    796 int
    797 getLineNumber(void *ctx)
    798 {
    799     DEPRECATED("getLineNumber")
    800         return (xmlSAX2GetLineNumber(ctx));
    801 }
    802 
    803 /**
    804  * getColumnNumber:
    805  * @ctx: the user data (XML parser context)
    806  *
    807  * Provide the column number of the current parsing point.
    808  * DEPRECATED: use xmlSAX2GetColumnNumber()
    809  *
    810  * Returns an int
    811  */
    812 int
    813 getColumnNumber(void *ctx)
    814 {
    815     DEPRECATED("getColumnNumber")
    816         return (xmlSAX2GetColumnNumber(ctx));
    817 }
    818 
    819 /**
    820  * isStandalone:
    821  * @ctx: the user data (XML parser context)
    822  *
    823  * Is this document tagged standalone ?
    824  * DEPRECATED: use xmlSAX2IsStandalone()
    825  *
    826  * Returns 1 if true
    827  */
    828 int
    829 isStandalone(void *ctx)
    830 {
    831     DEPRECATED("isStandalone")
    832         return (xmlSAX2IsStandalone(ctx));
    833 }
    834 
    835 /**
    836  * hasInternalSubset:
    837  * @ctx: the user data (XML parser context)
    838  *
    839  * Does this document has an internal subset
    840  * DEPRECATED: use xmlSAX2HasInternalSubset()
    841  *
    842  * Returns 1 if true
    843  */
    844 int
    845 hasInternalSubset(void *ctx)
    846 {
    847     DEPRECATED("hasInternalSubset")
    848         return (xmlSAX2HasInternalSubset(ctx));
    849 }
    850 
    851 /**
    852  * hasExternalSubset:
    853  * @ctx: the user data (XML parser context)
    854  *
    855  * Does this document has an external subset
    856  * DEPRECATED: use xmlSAX2HasExternalSubset()
    857  *
    858  * Returns 1 if true
    859  */
    860 int
    861 hasExternalSubset(void *ctx)
    862 {
    863     DEPRECATED("hasExternalSubset")
    864         return (xmlSAX2HasExternalSubset(ctx));
    865 }
    866 
    867 /**
    868  * internalSubset:
    869  * @ctx:  the user data (XML parser context)
    870  * @name:  the root element name
    871  * @ExternalID:  the external ID
    872  * @SystemID:  the SYSTEM ID (e.g. filename or URL)
    873  *
    874  * Callback on internal subset declaration.
    875  * DEPRECATED: use xmlSAX2InternalSubset()
    876  */
    877 void
    878 internalSubset(void *ctx, const xmlChar * name,
    879                const xmlChar * ExternalID, const xmlChar * SystemID)
    880 {
    881     DEPRECATED("internalSubset")
    882         xmlSAX2InternalSubset(ctx, name, ExternalID, SystemID);
    883 }
    884 
    885 /**
    886  * externalSubset:
    887  * @ctx: the user data (XML parser context)
    888  * @name:  the root element name
    889  * @ExternalID:  the external ID
    890  * @SystemID:  the SYSTEM ID (e.g. filename or URL)
    891  *
    892  * Callback on external subset declaration.
    893  * DEPRECATED: use xmlSAX2ExternalSubset()
    894  */
    895 void
    896 externalSubset(void *ctx, const xmlChar * name,
    897                const xmlChar * ExternalID, const xmlChar * SystemID)
    898 {
    899     DEPRECATED("externalSubset")
    900         xmlSAX2ExternalSubset(ctx, name, ExternalID, SystemID);
    901 }
    902 
    903 /**
    904  * resolveEntity:
    905  * @ctx: the user data (XML parser context)
    906  * @publicId: The public ID of the entity
    907  * @systemId: The system ID of the entity
    908  *
    909  * The entity loader, to control the loading of external entities,
    910  * the application can either:
    911  *    - override this resolveEntity() callback in the SAX block
    912  *    - or better use the xmlSetExternalEntityLoader() function to
    913  *      set up it's own entity resolution routine
    914  * DEPRECATED: use xmlSAX2ResolveEntity()
    915  *
    916  * Returns the xmlParserInputPtr if inlined or NULL for DOM behaviour.
    917  */
    918 xmlParserInputPtr
    919 resolveEntity(void *ctx, const xmlChar * publicId,
    920               const xmlChar * systemId)
    921 {
    922     DEPRECATED("resolveEntity")
    923         return (xmlSAX2ResolveEntity(ctx, publicId, systemId));
    924 }
    925 
    926 /**
    927  * getEntity:
    928  * @ctx: the user data (XML parser context)
    929  * @name: The entity name
    930  *
    931  * Get an entity by name
    932  * DEPRECATED: use xmlSAX2GetEntity()
    933  *
    934  * Returns the xmlEntityPtr if found.
    935  */
    936 xmlEntityPtr
    937 getEntity(void *ctx, const xmlChar * name)
    938 {
    939     DEPRECATED("getEntity")
    940         return (xmlSAX2GetEntity(ctx, name));
    941 }
    942 
    943 /**
    944  * getParameterEntity:
    945  * @ctx: the user data (XML parser context)
    946  * @name: The entity name
    947  *
    948  * Get a parameter entity by name
    949  * DEPRECATED: use xmlSAX2GetParameterEntity()
    950  *
    951  * Returns the xmlEntityPtr if found.
    952  */
    953 xmlEntityPtr
    954 getParameterEntity(void *ctx, const xmlChar * name)
    955 {
    956     DEPRECATED("getParameterEntity")
    957         return (xmlSAX2GetParameterEntity(ctx, name));
    958 }
    959 
    960 
    961 /**
    962  * entityDecl:
    963  * @ctx: the user data (XML parser context)
    964  * @name:  the entity name
    965  * @type:  the entity type
    966  * @publicId: The public ID of the entity
    967  * @systemId: The system ID of the entity
    968  * @content: the entity value (without processing).
    969  *
    970  * An entity definition has been parsed
    971  * DEPRECATED: use xmlSAX2EntityDecl()
    972  */
    973 void
    974 entityDecl(void *ctx, const xmlChar * name, int type,
    975            const xmlChar * publicId, const xmlChar * systemId,
    976            xmlChar * content)
    977 {
    978     DEPRECATED("entityDecl")
    979         xmlSAX2EntityDecl(ctx, name, type, publicId, systemId, content);
    980 }
    981 
    982 /**
    983  * attributeDecl:
    984  * @ctx: the user data (XML parser context)
    985  * @elem:  the name of the element
    986  * @fullname:  the attribute name
    987  * @type:  the attribute type
    988  * @def:  the type of default value
    989  * @defaultValue: the attribute default value
    990  * @tree:  the tree of enumerated value set
    991  *
    992  * An attribute definition has been parsed
    993  * DEPRECATED: use xmlSAX2AttributeDecl()
    994  */
    995 void
    996 attributeDecl(void *ctx, const xmlChar * elem, const xmlChar * fullname,
    997               int type, int def, const xmlChar * defaultValue,
    998               xmlEnumerationPtr tree)
    999 {
   1000     DEPRECATED("attributeDecl")
   1001         xmlSAX2AttributeDecl(ctx, elem, fullname, type, def, defaultValue,
   1002                              tree);
   1003 }
   1004 
   1005 /**
   1006  * elementDecl:
   1007  * @ctx: the user data (XML parser context)
   1008  * @name:  the element name
   1009  * @type:  the element type
   1010  * @content: the element value tree
   1011  *
   1012  * An element definition has been parsed
   1013  * DEPRECATED: use xmlSAX2ElementDecl()
   1014  */
   1015 void
   1016 elementDecl(void *ctx, const xmlChar * name, int type,
   1017             xmlElementContentPtr content)
   1018 {
   1019     DEPRECATED("elementDecl")
   1020         xmlSAX2ElementDecl(ctx, name, type, content);
   1021 }
   1022 
   1023 /**
   1024  * notationDecl:
   1025  * @ctx: the user data (XML parser context)
   1026  * @name: The name of the notation
   1027  * @publicId: The public ID of the entity
   1028  * @systemId: The system ID of the entity
   1029  *
   1030  * What to do when a notation declaration has been parsed.
   1031  * DEPRECATED: use xmlSAX2NotationDecl()
   1032  */
   1033 void
   1034 notationDecl(void *ctx, const xmlChar * name,
   1035              const xmlChar * publicId, const xmlChar * systemId)
   1036 {
   1037     DEPRECATED("notationDecl")
   1038         xmlSAX2NotationDecl(ctx, name, publicId, systemId);
   1039 }
   1040 
   1041 /**
   1042  * unparsedEntityDecl:
   1043  * @ctx: the user data (XML parser context)
   1044  * @name: The name of the entity
   1045  * @publicId: The public ID of the entity
   1046  * @systemId: The system ID of the entity
   1047  * @notationName: the name of the notation
   1048  *
   1049  * What to do when an unparsed entity declaration is parsed
   1050  * DEPRECATED: use xmlSAX2UnparsedEntityDecl()
   1051  */
   1052 void
   1053 unparsedEntityDecl(void *ctx, const xmlChar * name,
   1054                    const xmlChar * publicId, const xmlChar * systemId,
   1055                    const xmlChar * notationName)
   1056 {
   1057     DEPRECATED("unparsedEntityDecl")
   1058         xmlSAX2UnparsedEntityDecl(ctx, name, publicId, systemId,
   1059                                   notationName);
   1060 }
   1061 
   1062 /**
   1063  * setDocumentLocator:
   1064  * @ctx: the user data (XML parser context)
   1065  * @loc: A SAX Locator
   1066  *
   1067  * Receive the document locator at startup, actually xmlDefaultSAXLocator
   1068  * Everything is available on the context, so this is useless in our case.
   1069  * DEPRECATED
   1070  */
   1071 void
   1072 setDocumentLocator(void *ctx ATTRIBUTE_UNUSED,
   1073                    xmlSAXLocatorPtr loc ATTRIBUTE_UNUSED)
   1074 {
   1075     DEPRECATED("setDocumentLocator")
   1076 }
   1077 
   1078 /**
   1079  * startDocument:
   1080  * @ctx: the user data (XML parser context)
   1081  *
   1082  * called when the document start being processed.
   1083  * DEPRECATED: use xmlSAX2StartDocument()
   1084  */
   1085 void
   1086 startDocument(void *ctx)
   1087 {
   1088    /* don't be too painful for glade users */
   1089    /*  DEPRECATED("startDocument") */
   1090         xmlSAX2StartDocument(ctx);
   1091 }
   1092 
   1093 /**
   1094  * endDocument:
   1095  * @ctx: the user data (XML parser context)
   1096  *
   1097  * called when the document end has been detected.
   1098  * DEPRECATED: use xmlSAX2EndDocument()
   1099  */
   1100 void
   1101 endDocument(void *ctx)
   1102 {
   1103     DEPRECATED("endDocument")
   1104         xmlSAX2EndDocument(ctx);
   1105 }
   1106 
   1107 /**
   1108  * attribute:
   1109  * @ctx: the user data (XML parser context)
   1110  * @fullname:  The attribute name, including namespace prefix
   1111  * @value:  The attribute value
   1112  *
   1113  * Handle an attribute that has been read by the parser.
   1114  * The default handling is to convert the attribute into an
   1115  * DOM subtree and past it in a new xmlAttr element added to
   1116  * the element.
   1117  * DEPRECATED: use xmlSAX2Attribute()
   1118  */
   1119 void
   1120 attribute(void *ctx ATTRIBUTE_UNUSED,
   1121           const xmlChar * fullname ATTRIBUTE_UNUSED,
   1122           const xmlChar * value ATTRIBUTE_UNUSED)
   1123 {
   1124     DEPRECATED("attribute")
   1125 }
   1126 
   1127 /**
   1128  * startElement:
   1129  * @ctx: the user data (XML parser context)
   1130  * @fullname:  The element name, including namespace prefix
   1131  * @atts:  An array of name/value attributes pairs, NULL terminated
   1132  *
   1133  * called when an opening tag has been processed.
   1134  * DEPRECATED: use xmlSAX2StartElement()
   1135  */
   1136 void
   1137 startElement(void *ctx, const xmlChar * fullname, const xmlChar ** atts)
   1138 {
   1139     xmlSAX2StartElement(ctx, fullname, atts);
   1140 }
   1141 
   1142 /**
   1143  * endElement:
   1144  * @ctx: the user data (XML parser context)
   1145  * @name:  The element name
   1146  *
   1147  * called when the end of an element has been detected.
   1148  * DEPRECATED: use xmlSAX2EndElement()
   1149  */
   1150 void
   1151 endElement(void *ctx, const xmlChar * name ATTRIBUTE_UNUSED)
   1152 {
   1153     DEPRECATED("endElement")
   1154         xmlSAX2EndElement(ctx, name);
   1155 }
   1156 
   1157 /**
   1158  * reference:
   1159  * @ctx: the user data (XML parser context)
   1160  * @name:  The entity name
   1161  *
   1162  * called when an entity reference is detected.
   1163  * DEPRECATED: use xmlSAX2Reference()
   1164  */
   1165 void
   1166 reference(void *ctx, const xmlChar * name)
   1167 {
   1168     DEPRECATED("reference")
   1169         xmlSAX2Reference(ctx, name);
   1170 }
   1171 
   1172 /**
   1173  * characters:
   1174  * @ctx: the user data (XML parser context)
   1175  * @ch:  a xmlChar string
   1176  * @len: the number of xmlChar
   1177  *
   1178  * receiving some chars from the parser.
   1179  * DEPRECATED: use xmlSAX2Characters()
   1180  */
   1181 void
   1182 characters(void *ctx, const xmlChar * ch, int len)
   1183 {
   1184     DEPRECATED("characters")
   1185         xmlSAX2Characters(ctx, ch, len);
   1186 }
   1187 
   1188 /**
   1189  * ignorableWhitespace:
   1190  * @ctx: the user data (XML parser context)
   1191  * @ch:  a xmlChar string
   1192  * @len: the number of xmlChar
   1193  *
   1194  * receiving some ignorable whitespaces from the parser.
   1195  * UNUSED: by default the DOM building will use characters
   1196  * DEPRECATED: use xmlSAX2IgnorableWhitespace()
   1197  */
   1198 void
   1199 ignorableWhitespace(void *ctx ATTRIBUTE_UNUSED,
   1200                     const xmlChar * ch ATTRIBUTE_UNUSED,
   1201                     int len ATTRIBUTE_UNUSED)
   1202 {
   1203     DEPRECATED("ignorableWhitespace")
   1204 }
   1205 
   1206 /**
   1207  * processingInstruction:
   1208  * @ctx: the user data (XML parser context)
   1209  * @target:  the target name
   1210  * @data: the PI data's
   1211  *
   1212  * A processing instruction has been parsed.
   1213  * DEPRECATED: use xmlSAX2ProcessingInstruction()
   1214  */
   1215 void
   1216 processingInstruction(void *ctx, const xmlChar * target,
   1217                       const xmlChar * data)
   1218 {
   1219     DEPRECATED("processingInstruction")
   1220         xmlSAX2ProcessingInstruction(ctx, target, data);
   1221 }
   1222 
   1223 /**
   1224  * globalNamespace:
   1225  * @ctx: the user data (XML parser context)
   1226  * @href:  the namespace associated URN
   1227  * @prefix: the namespace prefix
   1228  *
   1229  * An old global namespace has been parsed.
   1230  * DEPRECATED
   1231  */
   1232 void
   1233 globalNamespace(void *ctx ATTRIBUTE_UNUSED,
   1234                 const xmlChar * href ATTRIBUTE_UNUSED,
   1235                 const xmlChar * prefix ATTRIBUTE_UNUSED)
   1236 {
   1237     DEPRECATED("globalNamespace")
   1238 }
   1239 
   1240 /**
   1241  * setNamespace:
   1242  * @ctx: the user data (XML parser context)
   1243  * @name:  the namespace prefix
   1244  *
   1245  * Set the current element namespace.
   1246  * DEPRECATED
   1247  */
   1248 
   1249 void
   1250 setNamespace(void *ctx ATTRIBUTE_UNUSED,
   1251              const xmlChar * name ATTRIBUTE_UNUSED)
   1252 {
   1253     DEPRECATED("setNamespace")
   1254 }
   1255 
   1256 /**
   1257  * getNamespace:
   1258  * @ctx: the user data (XML parser context)
   1259  *
   1260  * Get the current element namespace.
   1261  * DEPRECATED
   1262  *
   1263  * Returns the xmlNsPtr or NULL if none
   1264  */
   1265 
   1266 xmlNsPtr
   1267 getNamespace(void *ctx ATTRIBUTE_UNUSED)
   1268 {
   1269     DEPRECATED("getNamespace")
   1270         return (NULL);
   1271 }
   1272 
   1273 /**
   1274  * checkNamespace:
   1275  * @ctx: the user data (XML parser context)
   1276  * @namespace: the namespace to check against
   1277  *
   1278  * Check that the current element namespace is the same as the
   1279  * one read upon parsing.
   1280  * DEPRECATED
   1281  *
   1282  * Returns 1 if true 0 otherwise
   1283  */
   1284 
   1285 int
   1286 checkNamespace(void *ctx ATTRIBUTE_UNUSED,
   1287                xmlChar * namespace ATTRIBUTE_UNUSED)
   1288 {
   1289     DEPRECATED("checkNamespace")
   1290         return (0);
   1291 }
   1292 
   1293 /**
   1294  * namespaceDecl:
   1295  * @ctx: the user data (XML parser context)
   1296  * @href:  the namespace associated URN
   1297  * @prefix: the namespace prefix
   1298  *
   1299  * A namespace has been parsed.
   1300  * DEPRECATED
   1301  */
   1302 void
   1303 namespaceDecl(void *ctx ATTRIBUTE_UNUSED,
   1304               const xmlChar * href ATTRIBUTE_UNUSED,
   1305               const xmlChar * prefix ATTRIBUTE_UNUSED)
   1306 {
   1307     DEPRECATED("namespaceDecl")
   1308 }
   1309 
   1310 /**
   1311  * comment:
   1312  * @ctx: the user data (XML parser context)
   1313  * @value:  the comment content
   1314  *
   1315  * A comment has been parsed.
   1316  * DEPRECATED: use xmlSAX2Comment()
   1317  */
   1318 void
   1319 comment(void *ctx, const xmlChar * value)
   1320 {
   1321     DEPRECATED("comment")
   1322         xmlSAX2Comment(ctx, value);
   1323 }
   1324 
   1325 /**
   1326  * cdataBlock:
   1327  * @ctx: the user data (XML parser context)
   1328  * @value:  The pcdata content
   1329  * @len:  the block length
   1330  *
   1331  * called when a pcdata block has been parsed
   1332  * DEPRECATED: use xmlSAX2CDataBlock()
   1333  */
   1334 void
   1335 cdataBlock(void *ctx, const xmlChar * value, int len)
   1336 {
   1337     DEPRECATED("cdataBlock")
   1338         xmlSAX2CDataBlock(ctx, value, len);
   1339 }
   1340 #define bottom_legacy
   1341 #include "elfgcchack.h"
   1342 #endif /* LIBXML_LEGACY_ENABLED */
   1343 
   1344