htmlNewSAXParserCtxt ()
-htmlParserCtxtPtr htmlNewSAXParserCtxt (htmlSAXHandlerPtr sax,
void * userData)
+htmlParserCtxtPtr htmlNewSAXParserCtxt (const htmlSAXHandler * sax,
void * userData)
-Allocate and initialize a new parser context.
+Allocate and initialize a new SAX parser context. If userData is NULL, the parser context will be passed as user data.
@@ -1000,7 +1000,7 @@ const htmlElemDesc * htmlParseCharRef ()
int htmlParseCharRef (htmlParserCtxtPtr ctxt)
-parse Reference declarations [66] CharRef ::= '&#' [0-9]+ ';' | '&#x' [0-9a-fA-F]+ ';'
+DEPRECATED: Internal function, don't use. parse Reference declarations [66] CharRef ::= '&#' [0-9]+ ';' | '&#x' [0-9a-fA-F]+ ';'
@@ -1101,7 +1101,7 @@ const htmlElemDesc * htmlParseElement ()
void htmlParseElement (htmlParserCtxtPtr ctxt)
-parse an HTML element, this is highly recursive this is kept for compatibility with previous code versions [39] element ::= EmptyElemTag | STag content ETag [41] Attribute ::= Name Eq AttValue
+DEPRECATED: Internal function, don't use. parse an HTML element, this is highly recursive this is kept for compatibility with previous code versions [39] element ::= EmptyElemTag | STag content ETag [41] Attribute ::= Name Eq AttValue
@@ -1116,7 +1116,7 @@ const htmlElemDesc * htmlParseEntityRef ()
const htmlEntityDesc * htmlParseEntityRef (htmlParserCtxtPtr ctxt,
const xmlChar ** str)
-parse an HTML ENTITY references [68] EntityRef ::= '&' Name ';'
+DEPRECATED: Internal function, don't use. parse an HTML ENTITY references [68] EntityRef ::= '&' Name ';'
@@ -1339,7 +1339,7 @@ const htmlElemDesc * htmlSAXParseDoc ()
htmlDocPtr htmlSAXParseDoc (const xmlChar * cur,
const char * encoding,
htmlSAXHandlerPtr sax,
void * userData)
-Parse an HTML in-memory document. If sax is not NULL, use the SAX callbacks to handle parse events. If sax is NULL, fallback to the default DOM behavior and return a tree.
+DEPRECATED: Use htmlNewSAXParserCtxt and htmlCtxtReadDoc. Parse an HTML in-memory document. If sax is not NULL, use the SAX callbacks to handle parse events. If sax is NULL, fallback to the default DOM behavior and return a tree.
@@ -1373,7 +1373,7 @@ const htmlElemDesc * htmlSAXParseFile ()
htmlDocPtr htmlSAXParseFile (const char * filename,
const char * encoding,
htmlSAXHandlerPtr sax,
void * userData)
-parse an HTML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. It use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines.
+DEPRECATED: Use htmlNewSAXParserCtxt and htmlCtxtReadFile. parse an HTML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. It use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines.
diff --git a/doc/devhelp/libxml2-SAX2.html b/doc/devhelp/libxml2-SAX2.html
index 4a463b17..b0bb2c79 100644
--- a/doc/devhelp/libxml2-SAX2.html
+++ b/doc/devhelp/libxml2-SAX2.html
@@ -69,7 +69,7 @@ int xmlSAXVersion (htmlDefaultSAXHandlerInit ()
void htmlDefaultSAXHandlerInit (void)
-DEPRECATED: This function will be made private. Call xmlInitParser to initialize the library. Initialize the default SAX handler
+DEPRECATED: This function is a no-op. Call xmlInitParser to initialize the library.
@@ -77,7 +77,7 @@ int
xmlSAXVersion (
xmlDefaultSAXHandlerInit ()
void xmlDefaultSAXHandlerInit (void)
-
DEPRECATED: This function will be made private. Call xmlInitParser to initialize the library. Initialize the default SAX2 handler
+
DEPRECATED: This function is a no-op. Call xmlInitParser to initialize the library. Initialize the default SAX2 handler
diff --git a/doc/devhelp/libxml2-dict.html b/doc/devhelp/libxml2-dict.html
index 5a2c8835..08e914d1 100644
--- a/doc/devhelp/libxml2-dict.html
+++ b/doc/devhelp/libxml2-dict.html
@@ -66,7 +66,7 @@ The content of this structure is not made public by the API.
xmlDictCleanup ()
void xmlDictCleanup (void)
-
DEPRECATED: This function will be made private. Call xmlCleanupParser to free global state but see the warnings there. xmlCleanupParser should be only called once at program exit. In most cases, you don't have call cleanup functions at all. Free the dictionary mutex. Do not call unless sure the library is not in use anymore !
+
DEPRECATED: This function is a no-op. Call xmlCleanupParser to free global state but see the warnings there. xmlCleanupParser should be only called once at program exit. In most cases, you don't have call cleanup functions at all.
@@ -325,12 +325,12 @@ The content of this structure is not made public by the API.
xmlInitializeDict ()
int xmlInitializeDict (void)
-
DEPRECATED: This function will be made private. Call xmlInitParser to initialize the library. Do the dictionary mutex initialization.
+
DEPRECATED: Alias for xmlInitParser.
| Returns: |
-0 if initialization was already done, and 1 if that call led to the initialization |
+ |
int xmlCharEncFirstLine (xmlCharEncodingHandler * handler,
xmlBufferPtr out,
xmlBufferPtr in)
-Front-end for the encoding handler input function, but handle only the very first line, i.e. limit itself to 45 chars.
+DEPERECATED: Don't use.
@@ -310,7 +310,7 @@ void xmlRegisterCharEncodingHandler
| Returns: |
-the number of byte written if success, or -1 general error -2 if the transcoding fails (for *in is not valid utf8 string or the result of transformation can't fit into the encoding we want), or |
+ |
xmlCharEncodingHandlerPtr xmlFindCharEncodingHandler (const char * name)
-Search in the registered set the handler able to read/write that encoding.
+Search in the registered set the handler able to read/write that encoding or create a new one.
@@ -525,7 +525,7 @@ void xmlRegisterCharEncodingHandlerxmlInitCharEncodingHandlers ()
void xmlInitCharEncodingHandlers (void)
-DEPRECATED: This function will be made private. Call xmlInitParser to initialize the library. Initialize the char encoding support, it registers the default encoding supported. NOTE: while public, this function usually doesn't need to be called in normal processing.
+DEPRECATED: Alias for xmlInitParser.
diff --git a/doc/devhelp/libxml2-globals.html b/doc/devhelp/libxml2-globals.html
index ea7696de..0c1eb574 100644
--- a/doc/devhelp/libxml2-globals.html
+++ b/doc/devhelp/libxml2-globals.html
@@ -455,7 +455,7 @@ const char *
xmlThrDefTreeIndentString
xmlCleanupGlobals ()
void xmlCleanupGlobals (void)
-
DEPRECATED: This function will be made private. Call xmlCleanupParser to free global state but see the warnings there. xmlCleanupParser should be only called once at program exit. In most cases, you don't have call cleanup functions at all. Additional cleanup for multi-threading
+
DEPRECATED: This function is a no-op. Call xmlCleanupParser to free global state but see the warnings there. xmlCleanupParser should be only called once at program exit. In most cases, you don't have call cleanup functions at all.
@@ -484,7 +484,7 @@ const char *
xmlThrDefTreeIndentString
xmlInitGlobals ()
void xmlInitGlobals (void)
-
DEPRECATED: This function will be made private. Call xmlInitParser to initialize the library. Additional initialisation for multi-threading
+
DEPRECATED: Alias for xmlInitParser.
diff --git a/doc/devhelp/libxml2-parser.html b/doc/devhelp/libxml2-parser.html
index bc37b594..07410f11 100644
--- a/doc/devhelp/libxml2-parser.html
+++ b/doc/devhelp/libxml2-parser.html
@@ -98,7 +98,7 @@ int
xmlLineNumbersDefault (int val);
xmlParserInputPtr xmlLoadExternalEntity (const char * URL,
const char * ID,
xmlParserCtxtPtr ctxt);
xmlParserInputPtr xmlNewIOInputStream (
xmlParserCtxtPtr ctxt,
xmlParserInputBufferPtr input,
xmlCharEncoding enc);
xmlParserCtxtPtr xmlNewParserCtxt (void);
-
xmlParserCtxtPtr xmlNewSAXParserCtxt (
xmlSAXHandlerPtr sax,
void * userData);
+
xmlParserCtxtPtr xmlNewSAXParserCtxt (const
xmlSAXHandler * sax,
void * userData);
int
xmlParseBalancedChunkMemory (
xmlDocPtr doc,
xmlSAXHandlerPtr sax,
void * user_data,
int depth,
const
xmlChar * string,
xmlNodePtr * lst);
int
xmlParseBalancedChunkMemoryRecover (
xmlDocPtr doc,
xmlSAXHandlerPtr sax,
void * user_data,
int depth,
const
xmlChar * string,
xmlNodePtr * lst,
int recover);
int
xmlParseChunk (
xmlParserCtxtPtr ctxt,
const char * chunk,
int size,
int terminate);
@@ -1964,9 +1964,9 @@ The content of this structure is not made public by the API.
xmlNewSAXParserCtxt ()
-
xmlParserCtxtPtr xmlNewSAXParserCtxt (xmlSAXHandlerPtr sax,
void * userData)
+xmlParserCtxtPtr xmlNewSAXParserCtxt (const xmlSAXHandler * sax,
void * userData)
-Allocate and initialize a new SAX parser context.
+Allocate and initialize a new SAX parser context. If userData is NULL, the parser context will be passed as user data.
@@ -1980,7 +1980,7 @@ The content of this structure is not made public by the API.
| Returns: |
-the xmlParserCtxtPtr or NULL |
+the xmlParserCtxtPtr or NULL if memory allocation failed. |
int * len);
xmlChar * xmlDecodeEntities (xmlParserCtxtPtr ctxt,
int len,
int what,
xmlChar end,
xmlChar end2,
xmlChar end3);
typedef void xmlEntityReferenceFunc (xmlEntityPtr ent,
xmlNodePtr firstNode,
xmlNodePtr lastNode);
-void xmlErrMemory (xmlParserCtxtPtr ctxt,
const char * extra);
void xmlFreeInputStream (xmlParserInputPtr input);
void xmlHandleEntity (xmlParserCtxtPtr ctxt,
xmlEntityPtr entity);
int xmlIsLetter (int c);
@@ -444,51 +441,6 @@ int xmlSwitchToEncoding (
-Macro MOVETO_ENDTAG
-#define MOVETO_ENDTAG(p);
-
-Skips to the next '>' char.
-
-
-
-| p: |
-and UTF8 string pointer |
-
-
-
-
-
-Macro MOVETO_STARTTAG
-
#define MOVETO_STARTTAG(p);
-
-
Skips to the next '<' char.
-
-
-
-| p: |
-and UTF8 string pointer |
-
-
-
-
-
-
-
#define SKIP_EOL(p);
-
-
Skips the end of line chars.
-
-
-
-| p: |
-and UTF8 string pointer |
-
-
-
-
-
+
+
+
Macro XML_MAX_LOOKUP_LIMIT
#define XML_MAX_LOOKUP_LIMIT;
@@ -667,7 +627,7 @@ int
xmlSwitchToEncoding (
namePop ()
const xmlChar * namePop (xmlParserCtxtPtr ctxt)
-
Pops the top element name from the name stack
+
DEPRECATED: Internal function, do not use. Pops the top element name from the name stack
@@ -688,7 +648,7 @@ int xmlSwitchToEncoding (namePush ()
int namePush (xmlParserCtxtPtr ctxt,
const xmlChar * value)
-Pushes a new element name on top of the name stack
+DEPRECATED: Internal function, do not use. Pushes a new element name on top of the name stack