From adaee51c9e3c38317004ef5803e2fb3e4b7db0ce Mon Sep 17 00:00:00 2001 From: Ian Jackson Date: Sun, 26 Oct 2014 13:21:16 +0000 Subject: [PATCH] NEWS, changelog: Documentation for 1.5.0~rc1 Signed-off-by: Ian Jackson --- NEWS | 41 +++++++++++++++++++++++++++++++++-------- changelog | 32 +++++++++++++++++++++++++++++--- 2 files changed, 62 insertions(+), 11 deletions(-) diff --git a/NEWS b/NEWS index bd0dff1..541cc02 100644 --- a/NEWS +++ b/NEWS @@ -1,22 +1,39 @@ -Changes in adns 1.5, since adns 1.4, are: +Changes in adns 1.5.0, since adns 1.4, are: + + New features: * This release provides full IPv6 support. Applications can request AAAA records (containing IPv6 addresses) as well as, or instead of, A records (containing IPv4 addresses). adns 1.5 can speak to nameservers over IPv6. - * adns_addr2text and adns_text2addr: Convenient C functions for - converting between addresses and address literals. These carry - less baggage than getaddrinfo and getnameinfo. + * adns_addr2text and adns_text2addr: Convenient C functions for + converting between addresses and address literals. These carry + less baggage than getaddrinfo and getnameinfo. + + Bugfixes: + + * We fix a crashing bug in adnslogres. (Debian#392102.) + + * Previously, parsing of some adns_specific options in resolv.conf + would go awry if multiple options were specified on the same line. + (Fixed since 1.5.0~rc0.) - * There is a fix to the one currently known bug in the resolver: - previously, some harmless but wrong owner names for checked ptr + * adns now knows to ignore more things in resolv.conf, rather than + warn about them, and there's also an option to disable all of these + warnings. (Debian#411263.) (Fixed since 1.5.0~rc0.) + + * Previously, some harmless but wrong owner names for checked ptr queries would be accepted; now they are rejected with `Domain invalid for particular DNS query type'. - * We fix a crashing bug in adnslogres. (Debian#392102.) + Other: + + * There are some minor API/ABI changes and improvements, for future + proofing. - * There are also some build system and test suite improvements. + * There are also some build system, test suite and coding style + improvements. * Licence is now GPLv3. @@ -43,3 +60,11 @@ Compatibility: IPv6 as well as IPv4 information if simply asked for `addresses'. Calling programs which did not ask for a specific address type ought to cope with this. + + The API in 1.5.0 also fixes a technical nonconformance to the C + specification. On platforms where an `enum' type might be an + integer type whose size is bits is not a power of two, there could + be an incompatible ABI change between 1.4 and 1.5 - but we don't + think there are many (if any) such platforms which are sufficiently + POSIX-like for adns. (Changed since 1.5.0~rc0.) + diff --git a/changelog b/changelog index 0bcc2fb..411645b 100644 --- a/changelog +++ b/changelog @@ -1,8 +1,34 @@ adns (1.5.0~rc1~) UPSTREAM; urgency=low - * WIP - - -- Ian Jackson Mon, 20 Oct 2014 02:29:45 +0100 + ABI/API changes: + * Provide adns_qf_cname_strict flag, currently ignored because it's the + default. This will allow us to make this not the default in the future + while retaining forward and backward API and ABI compatibility. + * Add `sizeforce' enum member value to force enum types in the APIs to be + big (which will avoids theoretical future ABI-incompatibility). + * Reject unknown flags passed by our caller. This will make it ABI-safe + (although not ABI-backward-compatible) to add new flags in the future, + as newer clients running against this old library will get ENOSYS. + + resolv.conf parsing: + * Support `adns_ignoreunkcfg' resolv.conf option to ignore unknown + options and keywords in resolv.conf. + * Ignore various BIND9 resolv.conf keywords and options. + * Fix resolv.conf option word splitting. + + Tests, build system, coding style, etc.: + * Test cases show rrtype flag values in hex. + * Parallelise `make check'. + * Make vbuf__append_quoted1035 no longer extern (there are no out-of-file + callers). + * Remove all RCSids. + * When releasing, check that the `make dist' tarball is identical to git. + And provide a test mode for the RELEASE-CHECKLIST doc/script. + * Add `make dist' tarball signature to .gitignore. + * More correctly and effectively work around bugs in make (Debian #4073, + #756123) affecting regress. + + -- Ian Jackson Sun, 26 Oct 2014 13:21:38 +0000 adns (1.5.0~rc0) UPSTREAM; urgency=low -- 2.11.0