doc/libxml2-api.xml


Log

Author Commit Date CI Message
Nick Wellnhofer a372cbf5 2025-03-27T15:17:22 Update documentation for 2.14.0
Nick Wellnhofer b3492259 2025-03-14T00:01:11 include: Change some return types from int to enum This also affects some new functions from 2.13.
Nick Wellnhofer fd1b9391 2025-03-13T23:20:16 include: Convert some macros to enums
Nick Wellnhofer 84c6524e 2025-03-13T19:45:35 encoding: Support input-only and output-only converters Make it possible to open an encoding handler only for input or output. This avoids the creation of unnecessary converters. Should also fix #863.
Nick Wellnhofer 69b83bb6 2025-03-10T02:18:51 encoding: Detect truncated multi-byte sequences with ICU Unlike iconv or the internal converters, ICU consumes truncated multi- byte sequences at the end of an input buffer. We currently check for a non-empty raw input buffer to detect truncated sequences, so this fails with ICU. It might be possible to inspect the pivot buffer pointers, but it seems cleaner to implement a `flush` flag for some encoding and I/O functions. After flushing, we can check for U_TRUNCATED_CHAR_FOUND with ICU, or detect remaining input with other converters. Also fix detection of truncated sequences for HTML, XML content and DTDs with iconv.
Nick Wellnhofer 87c9e000 2025-03-09T22:20:23 encoding: Rework custom encoding implementation API
Nick Wellnhofer d96911f1 2025-03-08T23:00:29 doc: Documentation fixes
Nick Wellnhofer 5f0b1378 2025-03-08T22:07:15 parser: Add more parser context accessors Fixes #763.
Nick Wellnhofer 94d8a3e2 2025-03-05T14:56:46 parser: Convert xmlParserMaxDepth to macro
Nick Wellnhofer 69657224 2025-03-04T20:32:02 globals: Remove unused globals - xmlBufferAllocScheme - xmlDefaultBufferSize - xmlParserDebugEntities
Nick Wellnhofer 92d7b0cd 2025-03-04T20:18:11 xpath: Rename valuePush and valuePop
Nick Wellnhofer 85bd58ef 2025-03-04T16:07:40 globals: Remove functions related to global state handling - xmlGetGlobalState - xmlInitializeGlobalState - xmlGetThreadId - xmlIsMainThread
Nick Wellnhofer 03a8d5f9 2025-03-04T16:00:08 unicode: Make Unicode functions private
Nick Wellnhofer 3d37ff84 2025-03-04T15:10:09 globals: Also use global state struct if threads are disabled
Nick Wellnhofer 8e871162 2025-03-04T13:36:55 parser: Remove oldXMLWDcompatibility
Nick Wellnhofer cdc5cfed 2025-03-04T13:26:51 legacy: Remove legacy symbols
Nick Wellnhofer 3250a01d 2025-03-04T13:15:42 error: Convert initGenericErrorDefaultFunc to macro
Nick Wellnhofer c42b3227 2025-03-04T13:11:18 parser: Convert inputPush and inputPop to macros
Nick Wellnhofer 361f7bff 2025-03-04T13:02:36 parser: Make nodePush, nodePop, namePush, namePop private
Nick Wellnhofer 0b27097a 2025-03-04T12:55:25 encoding: Rename unprefixed public functions
Nick Wellnhofer e50d314a 2025-02-25T23:07:19 build: Add separate configuration option for RELAX NG Support for RELAX NG used to be enabled together with XML Schema support (--with-schemas). Now there's a separate option and a new feature macro LIBXML_RELAXNG_ENABLED.
Nick Wellnhofer ce1b704e 2025-02-25T20:09:36 doc: Regenerate libxml2-api.xml
Nick Wellnhofer 0cf25b3d 2024-12-26T20:32:35 Regenerate docs and testapi.c
Nick Wellnhofer 8af55c8d 2024-07-06T22:14:21 parser: Rename new input API functions These weren't made public yet.
Nick Wellnhofer 4f329dc5 2024-07-10T03:27:47 parser: Implement xmlCtxtParseContent This implements xmlCtxtParseContent, a better alternative to xmlParseInNodeContext or xmlParseBalancedChunkMemory. It accepts a parser context and a parser input, making it a lot more versatile. xmlParseInNodeContext is now implemented in terms of xmlCtxtParseContent. This makes sure that xmlParseInNodeContext never modifies the target document, improving thread safety. xmlParseInNodeContext is also more lenient now with regard to undeclared entities. Fixes #727.
Nick Wellnhofer 673ca0ed 2024-07-11T01:23:57 tests: Regenerate testapi.c
Nick Wellnhofer f4e63f7a 2024-06-27T15:15:06 Regenerate libxml2-api.xml and testapi.c
Mike Dalessio bbbbbb46 2024-06-20T03:19:48 parser: implement xmlCtxtGetOptions In 712a31ab, the `options` struct member was deprecated. To allow callers to check the status of options bits, introduce xmlCtxtGetOptions.
Nick Wellnhofer 3aca5bcf 2024-06-17T03:34:06 doc: Ignore empty headers
Nick Wellnhofer 1112699c 2024-06-17T02:42:18 legacy: Remove most legacy functions from public headers Also remove warning messages.
Nick Wellnhofer 5fca9498 2024-06-16T19:56:08 doc: Hide internal macro
Nick Wellnhofer fb2b9cda 2024-06-16T19:51:44 doc: Remove broken struct field description
Nick Wellnhofer 33a1f897 2024-06-16T19:16:47 legacy: Merge SAX.c into legacy.c
Nick Wellnhofer 1341deac 2024-06-16T17:57:12 xmllint: Move shell to xmllint Move source code for xmllint shell to shell.c and move it from the libxml2 library to the xmllint executable. Also allow shell to run without XPath and debug modules. Add stubs for old shell API functions in legacy build mode.
Nick Wellnhofer 1b640358 2024-06-16T00:39:39 schemas: Stop using xmlValidateNotationUse Simplify symbol availability logic.
Nick Wellnhofer fa01278d 2024-06-16T00:11:41 regexp: Hide experimental legacy code This was never made public.
Nick Wellnhofer 10d60d15 2024-06-16T00:04:46 regexp: Stop using LIBXML_AUTOMATA_ENABLED This macro always equals LIBXML_REGEXP_ENABLED.
Nick Wellnhofer 11c3f84b 2024-06-15T23:57:39 SAX2: Always make xmlSAX2{Start,End}Element public Simplify symbol availability logic.
Nick Wellnhofer f307237e 2024-06-15T23:53:04 schemas: Use private copy of global NaN and Inf Simplify symbol availability logic.
Nick Wellnhofer b0fc67aa 2024-06-15T22:53:55 build: Remove --with-tree configuration option This option would allow for a smaller, but mostly useless minimal build. But it complicates the symbol availability logic in an insane way and requires specialized tools like our custom C parser in doc/apibuild.py. See #717.
Nick Wellnhofer 7b65c90f 2024-06-16T18:29:21 Regenerate libxml2-api.xml and testapi.c
Nick Wellnhofer 7a94fd0b 2024-06-12T13:35:20 doc: Update documentation
Nick Wellnhofer f5d4d33b 2023-11-23T15:25:54 tests: Regenerate testapi.c
Nick Wellnhofer a40c32ac 2023-11-04T19:07:37 doc: Regenerate documentation
Nick Wellnhofer 45470611 2023-09-21T23:52:52 error: Make xmlGetLastError return a const error This is a slight break of the API, but users really shouldn't modify the global error struct. The goal is to make xmlLastError use static buffers for its strings eventually. This should warn people if they're abusing the struct.
Nick Wellnhofer 6e12409b 2023-04-26T21:21:31 Regenerate docs and testapi.c
Nick Wellnhofer 785cfcff 2022-12-08T19:05:12 doc/libxml2-api.xml: Regenerate
Nick Wellnhofer 34a050cd 2022-08-24T16:35:58 Move some HTML functions to correct header file
Nick Wellnhofer ca3807d9 2022-08-24T15:55:46 Mark more functions setting globals as deprecated
Nick Wellnhofer e70b0c5e 2022-08-24T15:16:04 Rebuild documentation
Nick Wellnhofer 0e49f882 2022-08-24T05:25:37 Mark most SAX1 functions as deprecated No compiler warnings generated yet.
Nick Wellnhofer 9a82b94a 2022-08-24T04:21:58 Introduce xmlNewSAXParserCtxt and htmlNewSAXParserCtxt Add API functions to create a parser context with a custom SAX handler without having to mess with ctxt->sax manually.
Nick Wellnhofer 3513d76a 2022-08-24T02:18:50 Improve documentation of globals Document more global variables as deprecated. Some of the variables don't generate deprecation warnings yet, but they shouldn't be used in new code.
Nick Wellnhofer f703ed69 2022-08-24T01:29:49 Fix documentation parser Reset comment right after adding to the index.
Nick Wellnhofer 4f3eb8a3 2022-08-24T00:15:10 Support comments for global variables in documentation This was never implemented.
Nick Wellnhofer 92bb889b 2022-08-24T00:03:44 Don't index anything in DOC_DISABLE sections Somewhat misleadingly, the DOC_DISABLE directive only disabled warnings. Now we really stop the documentation generator from indexing. This results in additional warnings for xmlThrDef* functions. This should be fixed by documenting or deprecating them.
Nick Wellnhofer d54f829f 2022-08-19T11:28:49 Rebuild documentation
Nick Wellnhofer 229fe8f1 2022-08-17T11:41:23 Rebuild documentation
Nick Wellnhofer 67070107 2022-04-20T23:17:14 Add configuration flag for XPointer locations support Add a new configuration flag that controls whether the outdated support for XPointer locations (ranges and points) is enabled. --with-xptr-locs # Autotools LIBXML2_WITH_XPTR_LOCS # CMake The latest spec for what it essentially an XPath extension seems to be this working draft from 2002: https://www.w3.org/TR/xptr-xpointer/ The xpointer() scheme is listed as "being reviewed" in the XPointer registry since at least 2006. libxml2 seems to be the only modern software that tries to implement this spec, but the code has many bugs and quality issues. The flag defaults to "off" and support for this extensions has to be requested explicitly. The relevant API functions are deprecated.
Nick Wellnhofer 9a0be0dc 2022-04-21T01:11:35 Regenerate api.xml and testapi.c
Nick Wellnhofer 04d4124c 2022-02-19T18:50:10 Update news and rebuild documentation
Daniel Veillard e1bcffea 2021-05-13T15:35:21 Release of libxml2-2.9.11 Prompted by CVE-2021-3541, but this includes an awful lot of serious bug fixes by Nick and others. - configure.ac: bumped to new release - doc/* updated and regenerated
Daniel Veillard 41a34e1f 2019-10-30T20:14:56 Release of libxml2-2.9.10 * configure.ac doc/xml.html: updated for the release * doc/*: regenerated docs, APIs, etc ...
Nick Wellnhofer 64966ebe 2019-09-30T17:34:32 Rebuild docs
Jan Pokorný 81958b6e 2019-07-11T19:24:11 Doc: do not mislead towards "infeasible" scenario wrt. xmlBufNodeDump At least when merely public API is to be leveraged, one cannot use xmlBufCreate function that would otherwise be a clear fit, and relying on some invariants wrt. how some other struct fields will get initialized along the construction/filling such parent struct and (ab)using that instead does not appear clever, either. Hence, instruct people what's the Right Thing for the moment, that is, make them use xmlNodeDumpOutput instead (together with likewise public xmlAllocOutputBuffer). Going forward, it's questionable what do with xmlBuf* family of functions that are once public, since they, for any practical purpose, cannot be used by the library clients (that's how I've run into this). Signed-off-by: Jan Pokorný <jpokorny@redhat.com>
Daniel Veillard 18890f47 2018-03-05T17:09:43 Release of libxml2-2.9.8 * configure.ac doc/* libxml2.syms testapi.c: updated for the new release
Daniel Veillard 2960178f 2017-09-04T15:38:47 Release of libxml2-2.9.5 * configure.ac, doc/xslt.html: updated for the release * doc/*, python/setup.py, testapi.c: regenerated
Daniel Veillard bdec2183 2016-05-23T16:04:52 Release of libxml2-2.9.4 * doc/xml.html libxml.spec.in: updated for the release * doc/*: regenerated but no API additions
Daniel Veillard 8effcb57 2016-05-09T10:31:09 Fix apibuild for a recently added construct commit c71f9305a99b6aa03cb08fab31106c9c56f1be4f added __XML_EXTERNC cpp construct which not understood by apibuild, leading to make dist failures, ask to ignore that construct.
Daniel Veillard 6657afe8 2015-11-20T17:55:11 Release of libxml2-2.9.3 * configure.ac: updated * doc/*: regenerated
Daniel Veillard af62eb4f 2014-10-13T16:40:56 Python generator bug raised by the const change the doc methode for xmlDocGetRootElement wasn't generated anymore
Daniel Veillard f4e5a699 2013-04-19T15:36:36 Release of libxml2-2.9.1 * configure.in: bumped version * doc/*: updated the symbols file and regenerated
Daniel Veillard 54ae471c 2013-04-01T16:37:05 Regenerated API, and testapi, rebuild documentation After the previous commit adding 2 new entry points
Michael Wood fb27e2cd 2012-09-28T08:59:33 Fix spelling of "length".
Daniel Veillard 38bbd341 2012-09-11T15:00:08 Release of libxml2-2.9.0 * libxml.spec.in: update * doc/*: updated and regenerated * libxml2.syms testapi.c: regenerated
Daniel Veillard 82cdfc4e 2012-08-22T11:05:09 Expose xmlBufShrink in the public tree API As suggested by Andrew W. Nosenko: Proposal: expose the new xmlBufShrink() to the "public" API for compatibility with xmlBufUse(). Reason: the following scenario: 1. Read something into xmlParserInputBuffer (e.g. using xmlParserInputBufferRead()) 2. Extract content through xmlBufContent() 3. Extract content length through xmlBufUse(). Result have type 'size_t'. 4. Use this content 5. Now, you need to shrink the buffer. How to do it? Doing that through legacy xmlBufferShrink() is unsafe because it uses 'unsigned int' and the whole point of introducing the new API was handling the cases, when 'unsigned int' is not enough. Therefore, need to use the new xmlBufShrink(). But it is "private". Therefore, I propose to expose the new xmlBufShrink() in the same way, as xmlBufContent() and xmlBufUse() are exposed.
Daniel Veillard 64d11249 2012-08-15T09:10:50 Fix missing xmlsave.h module which was ignored in recent builds due to "save.h" rule discarding it too
Daniel Veillard 28cc42d0 2012-08-10T10:00:18 Regenerating docs and API files Various cleanups * configure.in: force regeneration of APIs in my environment * buf.c buf.h enc.h encoding.c include/libxml/tree.h include/libxml/xmlerror.h save.h tree.c: various comment cleanups pointed by apibuild * doc/apibuild.py: added the 3 new internal headers in the excludes * doc/libxml2-api.xml doc/libxml2-refs.xml: regenerated the API * doc/symbols.xml: listing new entry points for 2.9.0 * doc/devhelp/*: regenerated
Daniel Veillard c943f708 2012-05-23T17:10:59 Release of libxml2-2.8.0 - Makefile.am: don't package .git - configure.in : update to new release - doc/xml.html: added the new release - doc/* testapi.c: regenerated
Anders F Bjorklund 6703148c 2011-09-19T09:50:45 add XML_WITH_LZMA to api
Daniel Veillard 28fdf8bb 2011-03-07T08:12:39 Updated URL for lxml python bindings Also fixed the warning for XPath threaded usage a bit
Daniel Veillard 4c2e7c65 2010-11-04T18:35:57 Release of libxml2-2.7.8
Ozkan Sezer f99d2223 2010-11-04T12:08:08 614087 Fix Socket API usage to allow Windows64 compilation In Windows 64 a socket is no more represented by an int, this breaks the nanoftp API and nanoftp/nanohttp, the patch changes this and fix the API for Win64 Regenerated the XML and documentation as a result too.
Daniel Veillard d2190faf 2010-09-30T13:58:22 Fix web site encoding problems The encoding.html page was generated incorectly, revamp the input xml.html and convert the full XSLT chain to use and serve it as UTF-8 * doc/*: fix xml.html, update all stylesheets and regenerate
Daniel Veillard bb5055f3 2010-03-15T16:21:00 Release of libxml2-2.7.7 * configure.in: bump version * doc//*: regenerated
Daniel Veillard 29341682 2009-09-10T18:23:39 Release of libxml2-2.7.4 * configure.in: new version * libxml.spec.in: cleanup * xmlregexp.c: fix a comment * doc/apibuild.py: update * doc/*: regenerate everything
Daniel Veillard f447ab8f 2009-08-24T19:47:00 Regenerated API and symbols * doc/Makefile.am: make the check for symbols pbm a make api failure * doc/symbols.xml: added xmlXIncludeProcessTreeFlagsData * doc//* elfgcchack.h libxml2.syms testapi.c: regenerated
Daniel Veillard 472b1e11 2009-08-24T17:39:07 Regenerate symbols and API after previous patches * doc/symbols.xml: new global data xmlStructuredErrorContext * doc/checkapisym.xsl: slightly improve output * doc/* libxml2.syms win32/libxml2.def.src: regenerated the API
Daniel Veillard 53c32edf 2009-08-21T15:20:55 Rebuilt the API and regenerated docs
Daniel Veillard 7b465bdf 2009-07-24T09:02:51 Fixed apibuild.py, regenerated doc and interfaces * doc/apibuild.py: fixed the parsing after the change of macro name * doc/* testapi.c: regenerated
Daniel Veillard a4f85b93 2009-03-25T10:45:20 updated SVN URL for GNOME as pointed by Vincent Lefevre and regenerated * doc/*: updated SVN URL for GNOME as pointed by Vincent Lefevre and regenerated docs daniel svn path=/trunk/; revision=3824
Daniel Veillard 97ff9b36 2009-01-18T21:43:30 preparing 0.7.3 release fix a typo in a name Daniel * configure.in doc/xml.html doc/*: preparing 0.7.3 release * include/libxml/parserInternals.h SAX2.c: fix a typo in a name Daniel svn path=/trunk/; revision=3814
Daniel Veillard f63085de 2009-01-18T20:53:59 port patch from Marcus Meissner to add gcc checking for printf like * include/libxml/parser.h include/libxml/xmlwriter.h include/libxml/relaxng.h include/libxml/xmlversion.h.in include/libxml/xmlwin32version.h.in include/libxml/valid.h include/libxml/xmlschemas.h include/libxml/xmlerror.h: port patch from Marcus Meissner to add gcc checking for printf like functions parameters, should fix #65068 * doc/apibuild.py doc/*: modified the script accordingly and regenerated * xpath.c xmlmemory.c threads.c: fix a few warnings Daniel svn path=/trunk/; revision=3813
Daniel Veillard d4d47057 2009-01-18T17:26:02 apply patch from Marcus Meissner to add gcc attribute alloc_size should * include/libxml/xmlversion.h.in include/libxml/xmlmemory.h: apply patch from Marcus Meissner to add gcc attribute alloc_size should fix #552505 * doc/apibuild.py doc/* testapi.c: regenerate the API * include/libxml/parserInternals.h: fix a comment problem raised by apibuild.py daniel svn path=/trunk/; revision=3811
Daniel Veillard be2bd6ac 2008-11-27T15:26:28 adds element traversal support avoid a warning regenerated daniel * include/libxml/tree.h tree.c python/generator.py: adds element traversal support * valid.c: avoid a warning * doc/*: regenerated daniel svn path=/trunk/; revision=3804
Daniel Veillard 7f4547cd 2008-10-03T07:58:23 preparing the release of 2.7.2 fix the Solaris portability issue * configure.in doc/* NEWS: preparing the release of 2.7.2 * dict.c: fix the Solaris portability issue * parser.c: additional cleanup on #554660 fix * test/ent13 result/ent13* result/noent/ent13*: added the example in the regression test suite. * HTMLparser.c: handle leading BOM in htmlParseElement() Daniel svn path=/trunk/; revision=3799
Daniel Veillard 1572425c 2008-08-30T15:01:04 preparing 2.7.0 release remove some testing traces remove some warnings * configure.in, doc/*: preparing 2.7.0 release * tree.c: remove some testing traces * parser.c xmlIO.c xmlschemas.c: remove some warnings Daniel svn path=/trunk/; revision=3788
Daniel Veillard 28b7b4bd 2008-08-30T08:19:02 regenerated Daniel * doc/* testapi.c: regenerated Daniel svn path=/trunk/; revision=3786
Daniel Veillard 2cba4158 2008-08-27T11:45:41 fix a small initialization problem raised by Ashwin increase testing * threads.c: fix a small initialization problem raised by Ashwin * testapi.c gentest.py: increase testing especially for document with an internal subset, and entities * tree.c: fix a deallocation issue when unlinking entities from a document. * valid.c: fix a missing entry point test not found previously. * doc/*: regenerated the APIs, docs etc. daniel svn path=/trunk/; revision=3778
Daniel Veillard dee23485 2008-04-11T12:58:43 added new function xmlSchemaValidCtxtGetParserCtxt based on Holger * include/libxml/xmlschemas.h xmlschemas.c: added new function xmlSchemaValidCtxtGetParserCtxt based on Holger Kaelberer patch * doc/apibuild.py doc/*: regenerated the doc, chased why the new function didn't got any documentation, added more checking in the generator * include/libxml/relaxng.h include/libxml/schematron.h include/libxml/xmlschemas.h include/libxml/c14n.h include/libxml/xmlregexp.h include/libxml/globals.h include/libxml/xmlreader.h threads.c xmlschemas.c: various changes and cleanups following the new reports Daniel svn path=/trunk/; revision=3738