NEWS, changelog: Documentation for 1.5.0~rc1

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

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 <ijackson@chiark.greenend.org.uk>  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 <ijackson@chiark.greenend.org.uk>  Sun, 26 Oct 2014 13:21:38 +0000
 
 adns (1.5.0~rc0) UPSTREAM; urgency=low