doc


Log

Author Commit Date CI Message
Nick Wellnhofer 7a8722f5 2025-01-31T14:55:29 parser: Document that XML_PARSE_NOBLANKS is broken Long text content can generate multiple "characters" callbacks which can lead to NOBLANKS removing whitespace in non-whitespace text nodes. So the NOBLANKS option doesn't even work reliably with the pull parser. This would be extremely hard to fix. Unfortunately, `xmllint --format` relies on this option which is another reason why this feature never really worked.
Nick Wellnhofer 0cf25b3d 2024-12-26T20:32:35 Regenerate docs and testapi.c
Nick Wellnhofer 53c131f6 2024-12-26T20:29:58 doc: Make apibuild.py work again
correctmost 81d38ed0 2024-09-25T07:52:10 meson: Fix duplicate listing of libxml2.devhelp2 The duplication caused a warning when uninstalling.
Nick Wellnhofer 8ad618d2 2024-08-28T22:03:30 doc: Document all xmllint options Remove --pushsmall. Fixes #785.
Nick Wellnhofer 6be79014 2024-07-15T14:18:26 Remove unused code
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 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 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 481fd6bb 2024-06-16T16:30:54 tests: Remove testThreads.c This was merged into runtest.c some time ago.
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 7a94fd0b 2024-06-12T13:35:20 doc: Update documentation
Nick Wellnhofer 9523438a 2024-05-20T13:56:47 doc: Allow missing author
Nick Wellnhofer a800e003 2024-05-20T13:54:09 doc: Allow missing desc if we have a retdesc Allow missing function descriptions if the return value is documented.
Nick Wellnhofer 5f75c956 2024-04-28T22:57:02 doc: Remove tutorial The tutorial was moved to the Wiki: https://gitlab.gnome.org/GNOME/libxml2/-/wikis/Tutorial
Nick Wellnhofer d381e5de 2024-04-28T21:14:32 doc: Move doc/examples to example
Nick Wellnhofer 1cdfece1 2024-04-28T18:33:40 memory: Remove memory debugging This is useless compared to sanitizers or valgrind and has a considerable performance impact if enabled accidentally.
Nick Wellnhofer 5e80f438 2024-04-28T17:33:19 tree: Deprecate xmlRegisterNodeDefault This rarely used feature should be phased out.
Vincent Torri 5732ce56 2024-04-04T12:14:46 meson: Initial commit
Nick Wellnhofer 1d50df87 2024-03-28T12:08:13 examples: Don't leave temp files
Nick Wellnhofer 87bebd25 2024-02-12T16:45:16 xmllint: Return error code if XPath returns empty nodeset Return an error code as before but make it possible to distinguish from real errors. Fixes #690.
Nick Wellnhofer b53562bd 2024-02-11T12:33:02 examples: Readd xpath1 test This was removed for some reason in fc119e32. Fixes #685.
Nick Wellnhofer 2835337a 2024-01-30T14:18:45 doc: Mark `xmllint --xpath` as experimental This feature was poorly thought-out.
Nick Wellnhofer 6b089473 2024-01-30T13:37:16 doc: Update xmllint man page after fixing #180 Fixes #673.
Nick Wellnhofer d636ef1d 2024-01-11T00:43:44 tests: Remove testOOM This was never part of the standard test suite and we now test OOM error handling more comprehensively with fuzz testing.
Nick Wellnhofer 9122ad0c 2023-12-06T19:56:50 include: Move globals from xmlsave.h to parser.h Fix downstream build issues after reworking globals.h.
Nick Wellnhofer c011e760 2023-12-06T01:09:31 globals: Remove unused globals from thread storage Setting these deprecated globals hasn't had an effect for a long time. Make them constants. This reduces the size of per-thread storage from ~700 to ~250 bytes.
Nick Wellnhofer 7d6969d9 2023-11-23T15:48:52 Remove Trio Trio is a rather old cross-platform printf library which was bundled with libxml2. It was needed for ancient pre-C99 systems without snprintf and should be safe to remove these days.
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 b8e03e13 2023-10-02T15:07:55 examples: Don't use sprintf Avoids warnings on macOS.
Nick Wellnhofer 42a0bc6d 2023-09-16T19:45:30 tests: Add ATTRIBUTE_NO_SANITIZE_INTEGER macro
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 e4091bcf 2023-09-21T22:54:57 doc: Allow 'unsigned' without 'int'
Nick Wellnhofer 46d7aaec 2023-09-21T22:54:30 doc: Add ignored tokens to apibuild.py
Nick Wellnhofer 9fc5090c 2023-09-16T19:58:42 hash: Clean up libxml/hash.h Rename variables, fix subincludes, whitespace.
Nick Wellnhofer 1117fae0 2023-09-20T19:20:41 include: Remove unneeded includes
Nick Wellnhofer a77f9ab8 2023-09-20T16:57:22 globals: Don't include SAX2.h from globals.h
Nick Wellnhofer ed3bd052 2023-08-20T20:48:10 parser: Allow to set maximum amplification factor
Nick Wellnhofer b463b38b 2023-04-30T16:19:28 .gitignore: Split up and rearrange .gitignore files
Nick Wellnhofer fc119e32 2023-04-30T15:28:12 examples: Don't call xmlCleanupParser and xmlMemoryDump xmlCleanupParser is dangerous and shouldn't be called in most cases. Being part of the examples led many people to use it incorrectly. xmlMemoryDump is an obsolete way to test for memory leaks.
Nick Wellnhofer 6e12409b 2023-04-26T21:21:31 Regenerate docs and testapi.c
Nick Wellnhofer 21cec82b 2023-03-10T17:25:44 win32: Remove broken libxml2.def.src Fixes #472.
Nick Wellnhofer bbb2b8f1 2023-01-17T16:08:06 Remove symbols from version script The version script didn't account for symbols disabled by configuration options. This has caused problems on some OSs in the past and breaks lld 16 which enables --no-undefined-version by default. A proper fix would be rather involved, so we simply remove all symbols from the version script. This is an ELF-only feature and libxml2 never made use of symbol versioning anyway. Ultimately, this removes the need for a lot of bookkeeping without tangible benefits. We have to keep the version nodes to avoid errors when running binaries linked against older versions of libxml2. Fixes #473.
Nick Wellnhofer 78c4430f 2022-12-22T00:03:10 doc: Remove ancient files
Nick Wellnhofer 785cfcff 2022-12-08T19:05:12 doc/libxml2-api.xml: Regenerate
Nick Wellnhofer ce9baf94 2022-12-08T02:48:27 Remove XMLCALL and XMLCDECL macros from public headers
Ross Burton 4762c856 2022-12-06T21:40:01 Use python3 not python As per https://peps.python.org/pep-0394/, the python binary can be one of the following options: - Python 2 - Python 3 - Not exist All of the scripts in libxml2 use 'python', which may not exist. As Python 2 reached EOL on the 1st January 2020, it's safe to move the scripts to use python3 explicitly.
Nick Wellnhofer b693905f 2022-11-04T14:50:39 doc: Remove xmlDllMain from documentation and version script This is a Windows-only symbol.
Nick Wellnhofer d48faf1a 2022-11-04T14:30:50 doc: Mention ${sysconfdir} in man pages Fixes #395.
Nick Wellnhofer 3ab57bf4 2022-11-04T14:25:23 doc: Document xmlcatalog --convert Fixes #417.
Nick Wellnhofer ae7096a1 2022-11-04T14:21:53 doc: Document xmllint --nodict and --pedantic Fixes #418.
Nick Wellnhofer 736487df 2022-11-04T14:17:01 doc: Fix indentation in source XML files
Nick Wellnhofer fec85df1 2022-09-06T18:50:23 xmllint: Document --quiet option
Nick Wellnhofer caef8563 2022-09-02T17:26:47 Move automata test to runtest.c
Nick Wellnhofer 1bd24d44 2022-09-02T17:59:09 Fix compiler warning in examples
Nick Wellnhofer 1660331b 2022-08-26T02:24:23 Remove xmlErrMemory from symbols This function was never publically declared.
Nick Wellnhofer 0f568c0b 2022-08-26T01:22:33 Consolidate private header files Private functions were previously declared - in header files in the root directory - in public headers guarded with IN_LIBXML - in libxml.h - redundantly in source files that used them. Consolidate all private header files in include/private.
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 88637d42 2022-08-24T15:09:46 Improve cross-references in API docs Also cross-reference keywords followed by a period. This is still a hack but catches quite a few more keywords.
Nick Wellnhofer 6cdaa192 2022-08-24T14:34:04 Rebuild documentation
Nick Wellnhofer b33be8a0 2022-08-24T14:29:50 Switch back to HTML output for API 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 bd6a4272 2022-08-24T00:17:51 Rebuild API documentation
Nick Wellnhofer 4f3eb8a3 2022-08-24T00:15:10 Support comments for global variables in documentation This was never implemented.
Nick Wellnhofer 288c951e 2022-08-24T00:12:59 Fix update call in apibuild.py There are still a few places where try/except is used for branching. This is a bad idea since it can hide errors like this one.
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 18d79460 2022-08-18T21:03:56 Port doc/examples/index.py to Python 3 - Make sure that examples.xml is generated deterministically - Sort includes by line number
Nick Wellnhofer a7af2c99 2022-08-18T20:03:07 Fix order of exports in libxml2-api.xml The values passed to the `uniq` function are dictionary keys and should already be unique. On older Python versions, this would reshuffle the list after it had just been sorted.
Nick Wellnhofer f82b56c6 2022-08-18T19:51:33 Remove libxml2-refs.xml The cross-reference was only used by the old website.
Nick Wellnhofer d20df9d8 2022-08-17T12:01:04 Cleanup files generated by test suite Fixes make distcheck.
Nick Wellnhofer 4e494b9c 2022-08-17T12:00:40 Add uninstall target for examples Fixes make distcheck.
Nick Wellnhofer 229fe8f1 2022-08-17T11:41:23 Rebuild documentation
Nick Wellnhofer 24323d31 2022-08-17T11:39:55 Don't autogenerate doc/examples/Makefile.am
Nick Wellnhofer 3e7b4f37 2022-05-20T23:28:25 Avoid calling xmlSetTreeDoc Create text nodes with xmlNewDocText or set the document directly to avoid xmlSetTreeDoc being called when the node is inserted.
Nick Wellnhofer d9e1198c 2022-04-23T18:42:35 Redirect examples test output to /dev/null Regressed in commit c61e1273.
Nick Wellnhofer c61e1273 2022-04-21T06:03:22 Fix warnings when testing --with-minimum build There's no simple way to make the doc/examples tests handle different configurations. But these tests aren't especially valuable, so remove the result file checks.
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
David Seifert a62b31f4 2022-04-06T19:57:30 Use portable python shebangs * In conda or Gentoo Prefix, we don't want to use the system python and instead rely on PATH lookup.