From a24937211244f3a33ff6f3e64f3ab2c294f095dc Mon Sep 17 00:00:00 2001 From: Nick Wellnhofer Date: Fri, 4 Nov 2022 15:06:25 +0100 Subject: [PATCH] doc: Mention potentially breaking changes in NEWS --- NEWS | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/NEWS b/NEWS index 0a3dd6b03..70d273f96 100644 --- a/NEWS +++ b/NEWS @@ -2,6 +2,38 @@ NEWS file for libxml2 v2.10.0: Aug 17 2022 +### Breaking changes + +The Docbook parser module and all related symbols habe been removed completely. +This was experimental code which never worked and generated a deprecation +warning for 15+ years. The library's soname wasn't changed in order to allow +seamless upgrades to later versions. If this concerns you, consider bumping +soname yourself. + +Some other modules are now disabled by default and will eventually be removed +completely: + +- Support for XPointer locations (ranges and points): This was based on + a W3C specification which never got beyond Working Draft status. To my + knowledge, there's no software supporting this spec which is still + maintained. You now have to enable this code by passing the + `--with-xptr-locs` configuration option. Be warned that this part of + the code base is buggy and had many security issues in the past. + +- Support for the built-in FTP client (`--with-ftp`). + +- Support for "legacy" functions (`--with-legacy`). + +If you're concerned about ABI stability and haven't disabled these modules +already, add the following configuration options or bump soname yourself: + + --with-ftp + --with-legacy + --with-xptr-locs + +Several functions of the public API were deprecated. Most of them should be +completely unused and will generate a deprecation warning now. + ### Security - [CVE-2022-2309] Reset nsNr in xmlCtxtReset