1
0
mirror of https://gitlab.gnome.org/GNOME/libxml2.git synced 2024-12-24 21:33:51 +03:00

doc: Don't mention xmlNewInputURL

This commit is contained in:
Nick Wellnhofer 2024-06-10 14:04:00 +02:00
parent b46decdfc9
commit 47cbb6bb3c
2 changed files with 22 additions and 37 deletions

View File

@ -2530,9 +2530,6 @@ xmlPopInput(xmlParserCtxtPtr ctxt) {
*
* Push an input stream onto the stack.
*
* This makes the parser use an input returned from advanced functions
* like xmlNewInputURL or xmlNewInputMemory.
*
* Returns -1 in case of error or the index in the input stack
*/
int
@ -12605,7 +12602,7 @@ xmlParseEntity(const char *filename) {
* @ID: the entity PUBLIC ID
* @base: a possible base for the target URI
*
* DEPRECATED: Use xmlNewInputURL.
* DEPRECATED: Don't use.
*
* Create a parser context for an external entity
* Automatic support for ZLIB/Compress compressed document is provided
@ -13938,8 +13935,6 @@ xmlCtxtReadDoc(xmlParserCtxtPtr ctxt, const xmlChar *str,
* Parse an XML file from the filesystem, the network or a user-defined
* resource loader.
*
* See xmlNewInputURL and xmlCtxtUseOptions for details.
*
* Returns the resulting document tree
*/
xmlDocPtr

View File

@ -1536,37 +1536,6 @@ xmlNewInputStream(xmlParserCtxtPtr ctxt) {
* Creates a new parser input from the filesystem, the network or
* a user-defined resource loader.
*
* @url is a filename or URL. If if contains the substring "://",
* it is assumed to be a Legacy Extended IRI. Otherwise, it is
* treated as a filesystem path.
*
* @publicId is an optional XML public ID, typically from a doctype
* declaration. It is used for catalog lookups.
*
* If @encoding is specified, it will override any encodings found
* in XML declarations, text declarations, BOMs, etc. Pass NULL
* for auto-detection.
*
* The following resource loaders will be called if they were
* registered (in order of precedence):
*
* - the global external entity loader set with
* xmlSetExternalEntityLoader
* - the per-thread xmlParserInputBufferCreateFilenameFunc set with
* xmlParserInputBufferCreateFilenameDefault
* - the default loader which will return
* - the result from a matching global input callback set with
* xmlRegisterInputCallbacks
* - a HTTP resource if support is compiled in.
* - a file opened from the filesystem, with automatic detection
* of compressed files if support is compiled in.
*
* The returned input can be passed to xmlCtxtParseDocument or
* htmlCtxtParseDocument.
*
* This function should not be invoked from user-defined resource
* loaders to avoid infinite loops.
*
* Returns a new parser input.
*/
xmlParserInputPtr
@ -2234,6 +2203,27 @@ xmlGetExternalEntityLoader(void) {
* @ID: the Public ID for the entity to load
* @ctxt: the context in which the entity is called or NULL
*
* @URL is a filename or URL. If if contains the substring "://",
* it is assumed to be a Legacy Extended IRI. Otherwise, it is
* treated as a filesystem path.
*
* @ID is an optional XML public ID, typically from a doctype
* declaration. It is used for catalog lookups.
*
* The following resource loaders will be called if they were
* registered (in order of precedence):
*
* - the global external entity loader set with
* xmlSetExternalEntityLoader
* - the per-thread xmlParserInputBufferCreateFilenameFunc set with
* xmlParserInputBufferCreateFilenameDefault
* - the default loader which will return
* - the result from a matching global input callback set with
* xmlRegisterInputCallbacks
* - a HTTP resource if support is compiled in.
* - a file opened from the filesystem, with automatic detection
* of compressed files if support is compiled in.
*
* Returns the xmlParserInputPtr or NULL
*/
xmlParserInputPtr