Change the upstream source URL
[platform/upstream/c-ares.git] / CHANGES
diff --git a/CHANGES b/CHANGES
index b3ecd2d..607545d 100644 (file)
--- a/CHANGES
+++ b/CHANGES
    Changelog for the c-ares project. Generated with git2changes.pl
 
-Version 1.10.0 (12 May 2013)
-
-Daniel Stenberg (12 May 2013)
-- RELEASE-NOTES: two more bug fixes
+Version 1.17.1 (19 Nov 2020)
 
-- [Keith Shaw brought this change]
+GitHub (19 Nov 2020)
+- [Brad House brought this change]
 
-  ares_set_servers_csv: fixed IPv6 address parsing
+  Travis: add iOS target built with CMake (#378)
   
-  Fixed bug that caused the last part of an IPv6 address to be parsed as
-  the port number when the last part is all numeric.
+  Issue #377 suggested that CMake builds for iOS with c-ares were broken. This PR adds an automatic Travis build for iOS CMake.
+  
+  Fix By: Brad House (@bradh352)
 
-- nroff: fix two syntax mistakes
+bradh352 (18 Nov 2020)
+- fix build
+
+GitHub (18 Nov 2020)
+- [Fabrice Fontaine brought this change]
+
+  External projects were using non-public header ares_dns.h, make public again (#376)
   
-  ares_parse_a_reply and ares_parse_aaaa_reply both had two \fB instead of
-  \fP
+  It appears some outside projects were relying on macros in ares_dns.h, even though it doesn't appear that header was ever meant to be public.  That said, we don't want to break external integrators so we should distribute this header again.
   
-  Reported-by: Alexander Klauer
-  Bug: http://c-ares.haxx.se/mail/c-ares-archive-2013-03/0010.shtml
+  Fix By: Fabrice Fontaine (@ffontaine)
 
-- [Alex Loukissas brought this change]
+bradh352 (17 Nov 2020)
+- note that so versioning has moved to configure.ac
 
-  build: fix build on msvc11
+- note about 1.17.1
 
-- Makefile.am: increment -version-info for 1.10.0 release
+- fix sed gone wrong
 
-- README: remove unnecessary comment
+GitHub (17 Nov 2020)
+- [Daniel Stenberg brought this change]
 
-- ares_version.h: copyright end range year is now 2013
+  autotools cleanup (#372)
+  
+  * remove: install-sh mkinstalldirs
+  
+  They're generated when needed, no need to store in it.
+  
+  * buildconf: remove custom logic with autoreconf
+  
+  Fix By: Daniel Stenberg (@bagder)
 
-- RELEASE-NOTES: synced with fb0737f3a0a1c37
+bradh352 (17 Nov 2020)
+- attempt to fix 1.17.0 release distribution issues
 
-- [Paul Saab brought this change]
+Version 1.17.0 (16 Nov 2020)
 
-  ares_parse_aaaa_reply: Plug memory leak
-  
-  This change is similar to ares_parse_a_reply.c in commit
-  bffd67f16a8f42fe6dbf79ab2e39d92eea05c8a6
+bradh352 (16 Nov 2020)
+- 1.17.0 release prep
 
-- [Patrick Valsecchi brought this change]
+- ares_getaddrinfo(): duplicate hints ai_socktype and ai_protocol into output
+  
+  ai_socktype and ai_protocol were ignored from the hints input.  They are now
+  duplicated into the output as expected.  Currently no sanity checks on
+  proper values are taking place.
+  
+  Fixes: #317
+  Fix By: Brad House (@bradh352)
 
-  ares_parse_txt_reply: return a ares_txt_reply node for each sub-string
+- ares_parse_{a,aaaa}_reply could return larger *naddrttls than passed in
   
-  Previously, the function would wrongly return all substrings merged into
-  one.
+  If there are more ttls returned than the maximum provided by the requestor, then
+  the *naddrttls response would be larger than the actual number of elements in
+  the addrttls array.
+  
+  This bug could lead to invalid memory accesses in applications using c-ares.
+  
+  This behavior appeared to break with PR #257
+  
+  Fixes: #371
+  Reported By: Momtchil Momtchev (@mmomtchev)
+  Fix By: Brad House (@bradh352)
 
-- [Alexander Klauer brought this change]
+GitHub (5 Nov 2020)
+- [Dustin Lundquist brought this change]
 
-  library init: documentation update
+  docs: ares_set_local_ip4() uses host byte order (#368)
   
-  This commit updates the documentation of ares_library_init() and
-  ares_library_cleanup() with regard to the newly introduced reference
-  counting of initializations and deinitializations.
+  Properly document brain-dead behavior of ares_set_local_ip4() using host byte order instead of expected network byte order.
+  
+  Fix By: Dustin Lundquist <d.lundquist@tempered.io>
 
-- [Alexander Klauer brought this change]
+- [Łukasz Marszał brought this change]
 
-  library init: be recursive
+  empty hquery->name could lead to invalid memory access (#367)
   
-  Previously, a single call to ares_library_cleanup() would deinitialise
-  the c-ares library, regardless of how many times ares_library_init() was
-  called. This behaviour may cause problems in programs linking two or
-  more libraries which, in turn, use c-ares. The present commit fixes this
-  problem, deinitializing the library only after a number of calls to
-  ares_library_cleanup() matching the number of calls to
-  ares_library_init().
-
-- [Patrick Valsecchi brought this change]
+  If hquery->name is empty (=="\0"), &hquery->name[strlen(hquery->name)-1] would point to "random" place in memory. This is causing some of my address sanitizer tests to fail.
+  
+  Fix By: Łukasz Marszał (@lmarszal)
 
-  protocol parsing: check input data stricter
+bradh352 (28 Sep 2020)
+- Fix OSSFuzz reported issue in CAA reply parsing
   
-  ... so that bad length fields aren't blindly accepted
+  OSS-Fuzz is reporting a use-of-uninitialized-value:
+  https://bugs.chromium.org/p/oss-fuzz/issues/detail?id=26012
   
-  Bug: http://c-ares.haxx.se/mail/c-ares-archive-2013-04/0016.shtml
+  Reported By: David Drysdale (@daviddrysdale)
 
-Guenter Knauf (11 Apr 2013)
-- Create ares_build.h when buidling from Git.
+GitHub (26 Sep 2020)
+- [David Hotham brought this change]
 
-- Added -DCARES_STATICLIB to CFLAGS.
+  fuzz CAA parsing (#363)
   
-  Currently this static makefile does only support building the
-  static library libcares.a.
+  Add fuzz support for CAA parsing
+  
+  Fix By: David Hotham (@dimbleby)
 
-Daniel Stenberg (8 Apr 2013)
-- [Alexander Klauer brought this change]
+- [Daniela Sonnenschein brought this change]
 
-  .gitignore: ignore patch files
+  Allow parsing of CAA Resource Record (#360)
   
-  This commit adds a line to .gitignore to the effect that patch files
-  generated by 'git format-patch' are excluded from the repository.
-
-- [Alexander Klauer brought this change]
+  CAA (Certification Authority Authorization) was introduced in RFC 6844.
+  This has been obsoleted by RFC 8659. This commit added the possibility
+  to query CAA resource records with adig and adds a parser for CAA
+  records, that can be used in conjunction with ares_query(3).
+  
+  Closes Bug: #292
+  Fix By: Daniela Sonnenschein (@lxdicted)
 
-  ares_destroy() documentation: no new requests
+Daniel Stenberg (17 Sep 2020)
+- docs: remove the html and pdf make targets
   
-  Clarify that no new requests may be added to a resolver channel that is
-  currently being destroyed.
+  They're rarely used in our daily work flow and mostly just add friction,
+  
+  Closes #362
 
-- [Alexander Klauer brought this change]
+bradh352 (14 Sep 2020)
+- ares_process needs to always include nameser.h as it has compat
 
-  Documentation: properly document ARES_ECANCELLED
-  
-  This commit clarifies the behaviour of ares_cancel() with respect to
-  callbacks and adds missing documentation of ARES_ECANCELLED to the man
-  pages of the affected functions.
+- Define T_OPT if system doesn't provide it
 
-- [Alexander Klauer brought this change]
+GitHub (12 Sep 2020)
+- [Gisle Vanem brought this change]
 
-  ares_cancel(): cancel requests safely
+  Change the mailman links (#358)
   
-  An invocation of ares_cancel() walks through the request list, calling
-  the callbacks of all pending requests on a channel. Previously, if such
-  a callback added a new request to the channel, the request list might
-  not end up empty, causing an abort by assertion failure. The present
-  commit ensures that precisely all requests present upon entry of
-  ares_cancel() are cancelled, and that adding new requests through
-  callbacks is safe.
-
-Yang Tse (10 Mar 2013)
-- ares.h: stricter CARES_EXTERN linkage decorations logic
+  Links when wrapping become misleading.  Insert newline to prevent wrapping.
   
-  No API change involved.
+  Fix By: Gisle Vanem (@gvanem)
 
-- ares_build.h.dist: enhance non-configure GCC ABI detection logic
-  
-  GCC specific adjustments:
+- [Gisle Vanem brought this change]
+
+  [adig] Update man-page for the '-x' option (#357)
   
-  - check __ILP32__ before 32 and 64bit processor architectures in
-    order to detect ILP32 programming model on 64 bit processors
-    which, of course, also support LP64 programming model, when using
-    gcc 4.7 or newer.
+  Fix By: Gisle Vanem (@gvanem)
+
+- [Gisle Vanem brought this change]
+
+  [adig] add '-x' option. (#356)
   
-  - keep 32bit processor architecture checks in order to support gcc
-    versions older than 4.7 which don't define __ILP32__
+  Added a 'dig-style' '-x' option. Also support '-xx' for a
+  IPv6 bit-string PTR query.
   
-  - check __LP64__ for gcc 3.3 and newer, while keeping 64bit processor
-    architecture checks for older versions which don't define __LP64__
+  Fix By: Gisle Vanem (@gvanem)
 
-Daniel Stenberg (9 Mar 2013)
-- ares.h: there is no ares_free_soa function
+bradh352 (12 Sep 2020)
+- fix indentation
 
-Yang Tse (9 Mar 2013)
-- Makefile.am: empty AM_LDFLAGS definition for automake 1.7 compatibility
+- ns_t_opt -> T_OPT
 
-- ares_inet_ntop.3: s/socklen_t/ares_socklen_t
+GitHub (12 Sep 2020)
+- [Gisle Vanem brought this change]
 
-- configure: use XC_LIBTOOL for portability across libtool versions
+  Fixes for Watt-32 on djgpp + Windows (#355)
+  
+  No longer any relation to libcurl since '<libcurl-root>/packages/DOS/common.dj' is dropped.
+  This Makefile.dj has been tested on Win-10 only (using the Windows hosted djgpp cross compiler).
+  
+  Fix By: Gisle Vanem (@gvanem)
 
-- xc-lt-iface.m4: provide XC_LIBTOOL macro
+- [Gisle Vanem brought this change]
 
-- Makefile.am: use AM_CPPFLAGS instead of INCLUDES
+  Fixes for Watt-32 on Windows and MSDOS (#354)
+  
+  Move the prototype to 'ares_private.h'.
+  
+  Fix By: Gisle Vanem (@gvanem)
 
-- inet_ntop.c: s/socklen_t/ares_socklen_t
+bradh352 (11 Sep 2020)
+- update path for include
 
-- inet_ntop.c: s/socklen_t/ares_socklen_t for portability
+- remove stale information
 
-Daniel Stenberg (19 Feb 2013)
-- ares.h: s/socklen_t/ares_socklen_t for portability
+- remove stale information
 
-- ares_inet_ntop.3: 4th argument is socklen_t!
+Brad House (9 Sep 2020)
+- silence compiler warnings
 
-- spell inet correctly!
+- Remove stale msvc files from makefile
 
-- ares_inet_pton/ntop: cleanup
-  
-  Make sure that the symbols are always exported and present in c-ares.
+GitHub (9 Sep 2020)
+- [Brad House brought this change]
+
+  Reorganize source tree (#349)
   
-  Make the headers prefixed with 'ares'.
+  Originally started by Daniel Stenberg (@bagder) with #123, this patch reorganizes the c-ares source tree to have a more modern layout.  It also fixes out of tree builds for autotools, and automatically builds the tests if tests are enabled.  All tests are passing which tests each of the supported build systems (autotools, cmake, nmake, mingw gmake).  There may be some edge cases that will have to be caught later on for things I'm not aware of.
   
-  Removed the inet_ntop.h version as it no longer features any content.
+  Fix By: Brad House (@bradh352)
 
-- ares_inet_ntop/ares_inet_pton: added man pages
+Brad House (1 Sep 2020)
+- remove CURLDEBUG as per #82
 
-Yang Tse (15 Feb 2013)
-- [Gisle Vanem brought this change]
+GitHub (1 Sep 2020)
+- [Erik Lax brought this change]
 
-  curl_setup_once.h: definition of HAVE_CLOSE_S defines sclose() to close_s()
+  Detect remote DNS server does not support EDNS as per RFC 6891 (#244)
+  
+  EDNS retry should be based on FORMERR returned without an OPT RR record as per https://tools.ietf.org/html/rfc6891#section-7 rather than just treating any unexpected error condition as a reason to disable EDNS on the channel.
+  
+  Fix By: Erik Lax (@eriklax)
 
-- [Gisle Vanem brought this change]
+Brad House (27 Aug 2020)
+- Fix for #345, don't use 'true' use 1
 
-  config-dos.h: define HAVE_CLOSE_S for MSDOS/Watt-32
+GitHub (27 Aug 2020)
+- [Seraphime Kirkovski brought this change]
 
-- [Gisle Vanem brought this change]
+  ares_gethostbyname: Fix AF_UNSPEC support when using an ip address (#204)
+  
+  fake_hostent() was not supporting AF_UNSPEC, so when an ip address was specified when using AF_UNSPEC it would attempt to do a DNS lookup rather than returning a fake hostent using the ip address.
+  
+  Fix By: Seraphime Kirkovski (@Seraphime)
 
-  config-dos.h: define strerror() to strerror_s_() for High-C
+- [apenn-msft brought this change]
 
-Daniel Stenberg (13 Feb 2013)
-- ares_get_datatype: removed unused function
+  Tests should use dynamic system-assigned ports rather than static port (#346)
   
-  it was also wrongly named as internal functions require two underscores
-
-- ares__bitncmp: use two underscores for private functions
+  The c-ares test suite was hardcoded to use port 5300 (and possibly 5301, 5302) for the test suite.  Especially in containers, there may be no guarantee these ports are available and cause tests to fail when they could otherwise succeed.  Instead, request the system to assign a port to use dynamically.  This is now the default.  To override, the test suite still takes the "-p <port>" option as it always has and will honor that.
   
-  It used a single one previously making it look like a public one
+  Fix By: Anthony Penniston (@apenn-msft)
 
-- ares__generate_new_id: moved to ares_query.c
+Brad House (25 Aug 2020)
+- Unset members of the addr struct contain garbage values (#343)
   
-  ... and ares__rc4 is turned into a local static function.
+  When generating the ares_sockaddr data by getaddrinfo() it was only filling
+  in certain members while leaving others uninitialized.  This left garbage
+  data if a user tried to use the unset values.  memset() the ares_sockaddr
+  to 0 prior to filling in the values to prevent this.
+  
+  Reported By: @SmorkalovG
+  Fix By: Brad House (@bradh352)
 
-- ares__swap_lists: make private and static
+GitHub (24 Aug 2020)
+- [Jonathan Maye-Hobbs brought this change]
+
+  FQDN with trailing period should be queried first with larger ndot value (#345)
   
-  ... since there's only one user, make it static within ares_process.c
+  If a query is performed for dynamodb.us-east-1.amazonaws.com. with ndots=5, it was attempting to search the search domains rather than just attempting the FQDN that was passed it.  This patch now at least attempts the FQDN first.
+  
+  We may need to determine if we should abort any further searching, however as is probably intended.
+  
+  Fix by: Jonathan Maye-Hobbs (@wheelpharoah)
 
-Yang Tse (13 Feb 2013)
-- Makefile.msvc: add four VS version strings
+- [Gisle Vanem brought this change]
 
-Daniel Stenberg (13 Feb 2013)
-- ares_expand_name.3: clarify how to free the data
+  Update acountry.c country code list (#341)
+  
+  Updated country_list[]:
+   * 2-letter ISO-3166 country-codes.
+   * Add, rename some names + codes in accordance with latest table at https://en.wikipedia.org/wiki/ISO_3166-1.
+  
+  Fix By: Gisle Vanem (@gvanem)
 
-Yang Tse (30 Jan 2013)
-- zz40-xc-ovr.m4: fix 'wc' detection - follow-up 2
+- [Bulat Gaifullin brought this change]
+
+  Test case should honor flag HAVE_WRITEV rather than WIN32 (#344)
   
-  - Fix a pair of single quotes to double quotes.
+  Test cases where not honoring the HAVE_WRITEV flag but instead using WIN32 to determine if WRITEV was available or not.  This patch fixes that.
   
-  URL: http://curl.haxx.se/mail/lib-2013-01/0355.html
-  Reported by: Tor Arntsen
+  Fix By: Bulat Gaifullin (@bgaifullin)
 
-- zz40-xc-ovr.m4: fix 'wc' detection - follow-up
+Brad House (18 Jul 2020)
+- Ensure c89 support
   
-  - Take into account that 'wc' may return leading spaces and/or tabs.
+  A couple of for loops in Mac-specific code were using integer declarations
+  inside a for loop.  Move the declaration to the top of the preceding
+  code block to retain c89 compliance.
   
-  - Set initial IFS to space, tab and newline.
+  Reported By: Jeffrey Walton
 
-- zz40-xc-ovr.m4: fix 'wc' detection
+GitHub (2 Jul 2020)
+- [Fionn Fitzmaurice brought this change]
+
+  Avoid buffer overflow in RC4 loop comparison (#336)
   
-  - Take into account that 'wc' may return leading spaces.
+  The rc4 function iterates over a buffer of size buffer_len who's maximum
+  value is INT_MAX with a counter of type short that is not guaranteed to
+  have maximum size INT_MAX.
   
-  - Set internationalization behavior variables.
+  In circumstances where short is narrower than int and where buffer_len
+  is larger than the maximum value of a short, it may be possible to loop
+  infinitely as counter will overflow and never be greater than or equal
+  to buffer_len.
   
-  Tor Arntsen analyzed and reported the issue.
+  The solution is to make the comparison be between types of equal width.
+  This commit defines counter as an int.
   
-  URL: http://curl.haxx.se/mail/lib-2013-01/0351.html
+  Fix By: Fionn Fitzmaurice (@fionn)
 
-- zz40-xc-ovr.m4: check another three basic utilities
+- [anonymoushelpishere brought this change]
 
-- zz40-xc-ovr.m4: 1.0 interface stabilization
+  Updated help information for adig, acountry, and ahost. (#334)
   
-  - Stabilization results in 4 public interface m4 macros:
-    XC_CONFIGURE_PREAMBLE
-    XC_CONFIGURE_PREAMBLE_VER_MAJOR
-    XC_CONFIGURE_PREAMBLE_VER_MINOR
-    XC_CHECK_PATH_SEPARATOR
-  - Avoid one level of internal indirection
-  - Update comments
-  - Drop XC_OVR_ZZ40 macro
-
-- zz40-xc-ovr.m4: emit witness message in configure BODY
+  Provide more descriptive help information for various utilities.
   
-  This avoids witness message in output when running configure --help,
-  while sending the message to config.log for other configure runs.
+  Fix By: @anonymoushelpishere
 
-- zz40-xc-ovr.m4: truly do version conditional overriding
+- [lutianxiong brought this change]
+
+  avoid read-heap-buffer-overflow (#332)
   
-  - version conditional overriding
-  - catch unexpanded XC macros
-  - fix double words in comments
+  Fix invalid read in ares_parse_soa_reply.c found during fuzzing
+  
+  Fixes Bug: #333
+  Fix By: lutianxiong (@ltx2018)
 
-- zz40-xc-ovr.m4: fix variable assignment of subshell output bashism
+- [Ivan Baidakou brought this change]
+
+  Fix: sizeof(sizeof(addr.saX)) -> sizeof(addr.saX) in readaddrinfo (#331)
   
-  Tor Arntsen analyzed and reported the issue.
+  Looks like a sed-gone-wrong, a sizeof inside of a sizeof.
   
-  URL: http://curl.haxx.se/mail/lib-2013-01/0306.html
+  Fix By: Ivan Baidakou (@basiliscos)
 
-- zz40-xc-ovr.m4: reinstate strict AC_REQUIRE macro dependencies
+Version 1.16.1 (11 May 2020)
 
-- zz40-xc-ovr.m4: avoid double single-quote usage
+Brad House (11 May 2020)
+- c-ares 1.16.1 release prep
 
-- zz40-xc-ovr.m4: parentheses balancing of 'case' statements
-  
-  m4 quadrigraph shell comment technique allows proper autoconf
-  parentheses balancing in shell 'case' statements. The presence
-  of unbalanced parentheses may otherwise trigger expansion bugs.
+- update travis to use xcode11.4
 
-- zz40-xc-ovr.m4: internals overhauling
+- Prevent possible double-free in ares_getaddrinfo() if ares_destroy() is called
   
-  - Update comments
-  - Execute commands in subshells
-  - Faster path separator check
-  - Fix missing 'test' command
-  - Rename private macros
-  - Minimize AC_REQUIRE usage
+  In the event that ares_destroy() is called prior to ares_getaddrinfo() completing,
+  it would result in an invalid read and double-free due to calling end_hquery() twice.
+  
+  Reported By: Jann Horn @ Google Project Zero
 
-- zz40-xc-ovr.m4: redirect errors and warnings to stderr
+GitHub (30 Apr 2020)
+- [shelley vohr brought this change]
 
-- configure: use XC_CONFIGURE_PREAMBLE early checks
+  fix: windows UNICODE incompatibilities with ares_getaddrinfo (#328)
   
-  Some basic checks we make were placed early enough in generated
-  configure script when using autoconf 2.5X versions. Newer autoconf
-  versions expand these checks much further into the configure script,
-  rendering them useless. Using XC_CONFIGURE_PREAMBLE fixes placement
-  of early intended checks across all our autoconf supported versions.
+  Fixes the following compatibility issues:
+  * Use RegQueryValueExA instead of RegQueryValueEx
+  * Use ExpandEnvironmentStringsA instead of ExpandEnvironmentStrings
+  * Use RegOpenKeyExA instead of RegOpenKeyExA
+  * Use GetWindowsDirectoryA instead of GetWindowsDirectoryA
+  
+  Fix By: Shelley Vohr (@codebytere)
+  Closes: #327
 
-- zz40-xc-ovr.m4: provide XC_CONFIGURE_PREAMBLE macro
+Brad House (13 Apr 2020)
+- travis: CloudFlare does not allow T_ANY requests, so live tests that use it fail.  Disable.
 
-- configure: autotools compatibility fixes - step I
-  
-  Fix proper macro expansion order across autotools versions for
-  C compiler and preprocessor program checks.
+- travis: bump macos image to the latest
 
-- configure: fix automake 1.13 compatibility
+- cast-align warnings are false for struct sockaddr, silence
   
-  Tested with:
+  Create a macro to silence false cast-align warnings when casting
+  struct sockaddr * to struct sockaddr_in * and struct sockaddr_in6 *.
   
-  buildconf: autoconf version 2.69
-  buildconf: autom4te version 2.69
-  buildconf: autoheader version 2.69
-  buildconf: automake version 1.13.1
-  buildconf: aclocal version 1.13.1
-  buildconf: libtool version 2.4
-  buildconf: GNU m4 version 1.4.16
+  Fix By: Brad House (@bradh352)
 
-- ares_private.h: use again memdebug.h instead of curl_memdebug.h
+- MacOS: Enable libresolv support for retrieving DNS servers like iOS does.
 
-- configure.ac: replace AM_CONFIG_HEADER with AC_CONFIG_HEADERS
-  
-  automake 1.13 errors if AM_CONFIG_HEADER is used in configure script.
+GitHub (10 Apr 2020)
+- [Dmitry Igrishin brought this change]
 
-- cares-override.m4: provide AC_CONFIG_MACRO_DIR definition conditionally
+  CMake: Populate the INCLUDE_DIRECTORIES property of installed targets (#323)
   
-  Provide a 'traceable' AC_CONFIG_MACRO_DIR definition only when using
-  an autoconf version that does not provide it, instead of what we were
-  doing up to now of providing and overriding AC_CONFIG_MACRO_DIR for
-  all autoconf versions.
+  Populate the INCLUDE_DIRECTORIES property of installed targets
+  
+  Fix By: Dmitry Igrishin (@dmitigr)
 
-- ares_private.h: use curl_memdebug.h instead of memdebug.h
+Brad House (10 Apr 2020)
+- travis: make valgrind use cmake for tests
 
-- vc6cares.dsp: add ares_create_query.c and ares_parse_soa_reply.c
+- dont try to use libtool to run valgrind
 
-- cares-functions.m4: improve gethostname arg 2 data type check
+- valgrind requires libtool installed to wrap tests
 
-- setup_once.h: HP-UX specific 'bool', 'false' and 'true' definitions.
-  
-  Also reverts commit bceb40095a
+- scan build 7
 
-- configure: check if compiler halts on function prototype mismatch
+- fix travis live test
 
-- cares-functions.m4: add gethostname arg 2 data type check and definition
+- add debug for travis
 
-- cares-functions.m4: update thread-safeness detection of getaddrinfo()
-  
-  Take in account that POSIX standard Issue 7 drops h_errno support. Now, we also
-  consider getaddrinfo() to be thread-safe when (_POSIX_C_SOURCE >= 200809L) or
-  (_XOPEN_SOURCE >= 700) independently of whether h_errno exists or not.
-  
-  Take in account that h_errno might be a modifiable lvalue not defined as
-  a C preprocessor macro.
+- try without sudo
 
-- setup_once.h: HP-UX <sys/socket.h> issue workaround
+- attempt to modernize travis build environment
+
+GitHub (6 Apr 2020)
+- [Teemu R brought this change]
+
+  Allow TXT records on CHAOS qclass (#321)
   
-  Issue: When building a 32bit target with large file support HP-UX
-  <sys/socket.h> header file may simultaneously provide two different
-  sets of declarations for sendfile and sendpath functions, one with
-  static and another with external linkage. Given that we do not use
-  mentioned functions we really don't care which linkage is the
-  appropriate one, but on the other hand, the double declaration emmits
-  warnings when using the HP-UX compiler and errors when using modern
-  gcc versions resulting in fatal compilation errors.
+  Some DNS servers intentionally "misuse" the obsoleted CHAOS (CH) qclass to provide things like `version.bind`, `version.server`, `authors.bind`, `hostname.bind` and `id.server`.
   
-  Mentioned issue is now fixed as long as we don't use sendfile nor
-  sendpath functions.
-
-- setup_once.h: refactor inclusion of <unistd.h> and <sys/socket.h>
+  C-ares was not allowing such use cases.
   
-  Inclusion of these two header files now done in setup_once.h
+  Fix By: Teemu R. (@rytilahti)
 
-- Header inclusion clean-up
+Brad House (5 Apr 2020)
+- Remove warnings from ares_getaddrinfo.3 man page
   
-  Remove header inclusions already done in setup_once.h
-
-- setup_once.h: HP-UX specific TRUE and FALSE definitions
+  As reported in #319, non-standard macros of .IN were used.
+  Replace with .RS/.RE.
   
-  Some HP-UX system headers require TRUE defined to 1 and FALSE to 0.
+  Fixes: #319
+  Fix By: Brad House (@bradh352)
 
-- ares_timeout.c: fix compiler warning
+- ares_getaddrinfo man page render better for man2html
 
-- ares_create_query.c: IRIX compilation fix
+- update man pages to render better for man2html
 
-- c-ares/nameser.h: add some T_* defines for ns_t_* values
+Version 1.16.0 (12 Mar 2020)
 
-Daniel Stenberg (7 Nov 2012)
-- Revert "ares_parse_aaaa_reply: fix memory leak"
-  
-  This reverts commit 50f25d8a4b2d16f4c5e0ef620238688b7a315c7a.
+Brad House (12 Mar 2020)
+- 1.16.0 release notes draft
 
-- ares_parse_aaaa_reply: fix memory leak
-  
-  an allocated buffer was not freed in the successful case.
+- attempt to fix double-free introduced in e0517f9
 
-- [Gisle Vanem brought this change]
+GitHub (12 Mar 2020)
+- [David Drysdale brought this change]
 
-  adig: perror() doesn't work for socket errors on windows
+  test: fuzzer input triggering double free (#315)
   
-  ... so print the SOCKERRNO instead
+  OSS-Fuzz has reported a double-free with the fuzzer input file
+  included here; run with:
+    ./test/aresfuzz test/fuzzinput/clusterfuzz-5637790584012800
+  
+  Bisecting the failure points to commit e0517f97d988 ("Parse SOA records
+  from ns_t_any response (#103)")
 
-- get_DNS_AdaptersAddresses: fix IPv6 parsing
+- [Brad House brought this change]
+
+  CMake: Install Manpages (#314)
   
-  Use of the wrong define made the function not parse IPv6 addresses
-  properly.
+  CMake wasn't installing manpages.
   
-  Bug: http://c-ares.haxx.se/mail/c-ares-archive-2012-06/0028.shtml
-  Reported by: Saúl Ibarra Corretgé
+  Fixes #297
+  Fix By: Brad House (@bradh352)
 
-- version: bumped to 1.10.0
-  
-  Due to the newly added function: ares_create_query()
+- [Brad House brought this change]
 
-- AUTHORS: synced with 83093ac450
+  Enable cmake tests for AppVeyor (#313)
   
-  Added 21 authors since this document was last updated
-
-- ares_create_query.3: mention when this is added
+  Tests require linking against the static library on Windows otherwise the symbols are not exported for internals being tested.
+  
+  Fix By: Brad House (@bradh352)
 
-- [hpopescu@ixiacom.com brought this change]
+Brad House (11 Mar 2020)
+- Add AppVeyor badge
 
-  Added new feature (rfc2671)
+- bump c-ares version to 1.16.0. test AppVeyor integration.
 
-- code police: fix indents, < 80 columns, reflowed comments
+GitHub (11 Mar 2020)
+- [Brad House brought this change]
 
-Guenter Knauf (11 Jul 2012)
-- Cleaned up version awk script.
+  replace all usages of inet_addr() with ares_inet_pton() which is more proper (#312)
+  
+  Replace usage of inet_addr() with ares_inet_pton() which is more appropriate and fixes issues with legitimate addresses like 255.255.255.0. IPv6 already used this.
+  
+  Fixes #309
+  Fix By: Brad House (@bradh352)
 
-Daniel Stenberg (30 Jun 2012)
-- [Gisle Vanem brought this change]
+- [Brad House brought this change]
 
-  read_udp_packets: bail out loop on bad sockets
+  CMake: Generate WinPDB files during build (#311)
   
-  I can see that recvfrom() in ares_process.c many times is called with
-  'udp_socket' == ARES_SOCKET_BAD. The code takes care not to call
-  recv/recvfrom with ARES_SOCKET_BAD in the outer-loop. So should the
-  inner-loop.
+  Build and Install PDB (Windows Debug Symbol) files if supported by underlying system.
+  
+  Also update AppVeyor to test cmake builds.
+  
+  Fixes #245
+  Fix By: Piotr Pietraszkiewicz (@ppietrasa) and Brad House (@bradh352)
 
-Yang Tse (29 Jun 2012)
-- cares-compilers.m4: remove -Wstrict-aliasing=3 from clang
+- [Brad House brought this change]
+
+  CMake: Rework library function checking (#310)
   
-  Currently it is unknown if there is any version of clang that
-  actually supports -Wstrict-aliasing. What is known is that there
-  are several that don't support it.
+  CHECK_LIBRARY_EXISTS(), while it takes a function name, does not actually verify the function exists in the library being evaluated. Instead, if the function is found in any dependent library, and the referenced library also exists, it returns true. This is not desirable.
+  
+  Wrap with a Macro to change the behavior.
+  
+  Fixes: #307
+  Fix By: Brad House (@bradh352)
 
-- cares-compilers.m4: -Wstrict-aliasing=3 for warning enabled gcc and clang builds
+- [Dron Rathore brought this change]
 
-Daniel Stenberg (18 Jun 2012)
-- version: work towards 1.9.2 (at least)
+  Parse SOA records from ns_t_any response (#103)
+  
+  Added the capability of parsing SOA record from a response buffer of ns_t_any type query, this implementation doesn't interfere with existing T_SOA query's response as that too is treated as a list of records. The function returns ARES_EBADRESP if no SOA record is found(as per RFC).
+  
+  The basic idea of sticking to RFC that a ns_t_any too should return an SOA record is something open for discussion but I have kept the functionality intact as it was previously i.e the function returns ARES_EBADRESP if it doesn't find a SOA record regardless of which response it is parsing i.e. T_SOA or T_ANY.
+  
+  Note that asking for T_ANY is generally a bad idea:
+  - https://blog.cloudflare.com/what-happened-next-the-deprecation-of-any/
+  - https://tools.ietf.org/html/draft-ietf-dnsop-refuse-any
+  
+  Bug: #102
+  Fix By: Dron Rathore (@DronRathore)
 
-Version 1.9.1 (18 Jun 2012)
+- [Stephen Bryant brought this change]
 
-Daniel Stenberg (18 Jun 2012)
-- RELEASE-NOTES: 1.9.1 coming up
+  Added CPack functionality for generating RPM or DEB packages (#283)
+  
+  Added CPack functionality for generating RPM or DEB packages
+  
+  ie: run `cpack -G RPM` (or "DEB") after building with CMake.
+  
+  The current configuration creates 3 separate packages for the shared library,
+  the development files and the tools.
+  
+  Fix By: Stephen Bryant (@bf-bryants)
 
-Version 1.9.0 (16 Jun 2012)
+- [tjwalton brought this change]
 
-Daniel Stenberg (16 Jun 2012)
-- ares_version.h: next version is 1.9.0
+  ares_gethostbyname: Return ENODATA if no valid A or AAAA record found (#304)
+  
+  ares_gethostbyname() was returning ESUCCESS when no A or AAAA record was found but a CNAME pointing nowhere was present.  ENODATA should be returned instead, however the hosts pointer will still be present to provide the alias list.
+  
+  * Return ENODATA if no valid A or AAAA record found
+  * Fix and update test ParseAReplyNoData.
+  * Add test for new ENODATA behaviour in ares_gethostbyname.
+  
+  Fixes Bug #303
+  Fix By: @tjwalton
 
-- [Marko Kreen brought this change]
+- [Michal Rostecki brought this change]
 
-  ares_data.h: ARES_DATATYPE_SOA_REPLY is added in 1.9.0
+  test: Separate live tests from SetServers* tests (#299)
+  
+  Before this change, SetServers, SetServersPorts and SetServersCSV
+  contained test cases trying to make DNS queries with the google.com
+  hostname, which requires Internet connectivity. Tests with that
+  requirement should be defined in the ares-test-live.cc file and contain
+  "Live" prefix to filter them out with `--gtest_filter=-*.Live*` on
+  machines without Internet connectivity.
+  
+  Fix By: Michal Rostecki (@mrostecki)
 
-- RELEASE-NOTES: synced with 979bf951d
+- [Adam Majer brought this change]
+
+  Only count valid addresses when response parsing (#302)
   
-  Next release deemed to become 1.9.0 due to the new function
+  When ares_parse_a_reply or ares_parse_aaaa_reply is called in case
+  where another AAAA and A responses exist, the resulting ares_addrttl
+  count is invalid and the structure points to gibberish.
+  
+  This is a regression since 1.15.
+  
+  Issue: https://github.com/c-ares/c-ares/issues/300
+  Fix By: Adam Majer (@AdamMajer)
 
-- [Marko Kreen brought this change]
+Brad House (24 Dec 2019)
+- [Kyle Edwards brought this change]
 
-  SOA parser added
+  CMake: Provide c-ares version in package export file (#296)
   
-  I need to do SOA queries, so here is a parser for them.
+  The CMake package export file should provide version information.
   
-  - ares_soa_reply: new struct
-  - ares_malloc_data/ares_free_soa: ARES_DATATYPE_SOA_REPLY
-  - ares_parse_soa_reply: actual function
+  Fix By: Kyle Edwards (@KyleFromKitware)
 
-Yang Tse (14 Jun 2012)
-- Kill compiler warning
+- [Ben Noordhuis brought this change]
 
-- Fix libcares.pc generation for static MingW* cross builds
+  Accept invalid /etc/resolv.conf lookup values, ability to build container tests (#274)
+  
+  * Add CARES_BUILD_CONTAINER_TESTS CMake option to add ability to build the Linux-only containerized tests.
+  * Accept invalid /etc/resolv.conf lookup values
+  
+  Before this commit invalid `lookup` values resulted in c-ares not using
+  any lookups without any clear indication why. After this commit it uses
+  the default "fb".
+  
+  Fix By: Ben Noordhuis (@bnoordhuis)
 
-Daniel Stenberg (21 May 2012)
-- [Nick Alcock brought this change]
+- [Christian Ammer brought this change]
 
-  Fix UDP and TCP port byte order in saved options.
+  Parallel A and AAAA lookups in `ares_getaddrinfo` (#290)
   
-  The UDP and TCP port are stored in network byte order in the
-  ares_channeldata, but are passed in to ares_init_options() in host byte
-  order.  Thus we must return them from ares_save_options() in host byte
-  order too, or a duplicated channel will convert them again, leading to a
-  nonfunctional channel and a mysterious connection refused error from
-  ares_gethostbyname().  This breaks ares_dup(), thus the curl easy API
-  when c-ares is used by curl, and thus all the curl easy API's users.
+  A and AAAA lookups for ares_getaddrinfo() are now performed in parallel.
+  
+  For this change `ares_search` was removed from `ares_getaddrinfo`.
+  Instead `ares_query` in combination with `next_dns_lookup` are
+  doing the suffix search.
+  
+  Adding support for `.onion` addresses which are tested by
+  `TEST_F(DefaultChannelTest, GetAddrinfoOnionDomain)`
+  
+  Fix By: Christian Ammer (@ChristianAmmer)
 
-Yang Tse (28 Apr 2012)
-- version: start working on 1.8.1-DEV
+- [Vy Nguyen brought this change]
 
-Version 1.8.0 (27 Apr 2012)
+  Move variables into the block where it is used to avoid unused-vars (#281)
+  
+  Warning uncovered with [-Werror, -Wunused-variables]
+  
+  Fix By: Vy Nguyen (@oontvoo)
 
-Daniel Stenberg (27 Apr 2012)
-- RELEASE-NOTES: call next 1.8 instead
+- [Vy Nguyen brought this change]
+
+  Rename local macros to avoid conflicting with system ones and remove unsed variables. (Otherwise code will break once compiled with [-Werror,-Wmacro-redefined,-Wunused-variable] ) (#280)
   
-  Since we added a function, let's use a stricter bumping scheme
+  Fix new getaddrinfo code to not redefine macros on some systems.
+  
+  Fix By: Vy Nguyen (@oontvoo)
 
-Yang Tse (25 Apr 2012)
-- INSTALL: some adjustments
+- [Egor Pugin brought this change]
 
-Daniel Stenberg (25 Apr 2012)
-- GIT-INFO: mention buildconf
+  [ares_getenv] Return NULL in all cases. (#279)
+  
+  if ares_getenv is defined, it must return a value on all platforms.
+  
+  Fix By: Egor Pugin (@egorpugin)
 
-Yang Tse (25 Apr 2012)
-- INSTALL: remove more sections that don't apply to c-ares
+- [Abhishek Arya brought this change]
 
-- ares_timeout.c: fix compiler warning
+  Add OSS-Fuzz fuzzing badge (#278)
+  
+  Adds based on instructions at
+  https://google.github.io/oss-fuzz/getting-started/new-project-guide/#status-badge
+  
+  Patch By: Abhishek Arya (@inferno-chromium)
 
-Daniel Stenberg (25 Apr 2012)
-- [Ben Noordhuis brought this change]
+- [Peter Eisentraut brought this change]
 
-  Makefile.m32: fix mingw32 build
+  ares_init_options.3: Fix layout (#275)
   
-  * add . to include path so ares_build.h is picked up
-  * make ar configurable to ease cross-compiling
+  7e6af8e inserted the documentation of resolvconf_path in the middle of
+  the item for ednspsz, leading to broken layout.  Fix that.
+  
+  Fix By: Peter Eisentraut (@petere)
 
-- RELEASE-NOTES: added what's happened since 1.7.5
+- [Gregor Jasny brought this change]
 
-Guenter Knauf (22 Apr 2012)
-- Updated copyright year.
+  manpages: Fix typos detected by lintian (#269)
+  
+  
+  Fix By: Gregor Jasny (@gjasny)
 
-Yang Tse (21 Apr 2012)
-- ares_init.c: Further refactoring of Windows system's DNS fetching code
+- [lifenjoiner brought this change]
 
-Guenter Knauf (20 Apr 2012)
-- Android: small changes to dns property part.
+  keep command line usage up to date (#256)
   
-  Prefix prop vars; kill var; use DNS_PROP_NAME_PREFIX macro.
+  adig and ahost built-in help did not match args taken.
+  
+  Fix-By: @lifenjoiner
 
-- Handle CNAME-only in ares_parse_aaaa_reply().
+- [Dan Noé brought this change]
+
+  ares-test.cc: Handle nullptr in AddrInfo ostream. (#268)
   
-  posted to the c-ares list by Peter Griess <pg@std.in>.
+  The const AddrInfo& argument to operator<< overload for AddrInfo can be
+  a nullptr unique_ptr. Handle this explicitly by printing {nullptr} if
+  the rest of the function cannot be safely executed.
+  
+  Fix-by: Dan Noé <dpn@google.com>
 
-- Add support for multiple DNS servers on Android.
+- [Dan Noé brought this change]
+
+  Add missing limits.h include from ares_getaddrinfo.c (#267)
   
-  Before, c-ares always used the first DNS server on Android, causing
-  network problems if this DNS server was not available.
+  This files references INT_MAX, but does not include limits.h. This can
+  cause a build failure on some platforms. Include limits.h if we have it.
   
-  Signed-off-by: Geert Uytterhoeven <Geert.Uytterhoeven@sonycom.com>
+  Fix-by: Dan Noé <dpn@google.com>
 
-- Added INSTALL so it gets into tarballs.
+- [Andrew Selivanov brought this change]
 
-- Added some more ifdefs to silent compiler warnings.
+  fix fuzzer docs and add missing getaddrinfo docs (#265)
+  
+  There is a fix for a bit outdated clang fuzzer docs and ares_getaddrinfo docs.
+  
+  Fix By: Andrew Selivanov (@ki11roy)
 
-Yang Tse (17 Apr 2012)
-- INSTALL: remove a non c-ares section
+- [Andrew Selivanov brought this change]
 
-- cares-compilers.m4: -Wno-pedantic-ms-format for Windows gcc 4.5 builds
+  Fix leak and crash in ares_parse_a/aaaa_reply (#264)
   
-  When building a Windows target with gcc 4.5 or newer and strict compiler
-  warnings enabled use -Wno-pedantic-ms-format in addition to other flags.
+  * fix leak if naddress of particular type found
+  * fix segfault when wanted ttls count lesser than count of result records
+  * add fuzzer input files that trigger problems (from #263)
+  
+  Reported-By: David Drysdale (@daviddrysdale)
+  Fix-By: Andrew Selivanov (@ki11roy)
 
-- setup_once.h: tighten requirements for stdbool.h header inclusion
+- [Andrew Selivanov brought this change]
+
+  fix segfault when parsing wrong type of record (#262)
   
-  Include stdbool.h only when it is available and configure is capable of
-  detecting a proper 'bool' data type when the header is included.
+  Fixes segfault when trying to ares_parse_aaaa with AF_INET and vise versa.
+  
+  Fix By: Andrew Selivanov (@ki11roy)
 
-- configure: NATIVE_WINDOWS no longer defined in config file
+- work around mingw compile failure
 
-- cares-compilers.m4: double underscore decoration for visibility attribute
+- c++ requires explicit casts
 
-- build adjustments: CARES_SYMBOL_HIDING no longer defined in config files
-  
-  configure script now provides conditional definitions for Makefile.am
-  that result in CARES_SYMBOL_HIDING being defined by resulting makefiles
-  when appropriate.
+- support EnvValue on Windows by implementing setenv/unsetenv
 
-- configure: Windows cross-compilation fixes
-  
-  CARES_BUILDING_LIBRARY and CARES_STATICLIB no longer defined in ares_config.h,
-  configure will generate appropriate conditionals so that mentioned symbols
-  get defined and used in Makefile derived from Makefile.am at compilation time.
+- [Andrew Selivanov brought this change]
 
-Guenter Knauf (17 Apr 2012)
-- Added INSTALL file adapted from libcurl.
+  getaddrinfo enhancements (#257)
   
-  Not yet ready, and needs further edits.
-
-Yang Tse (16 Apr 2012)
-- ares_init.c: get_iphlpapi_dns_info() refactoring
+  * Service support has been added to getaddrinfo.
+  * ares_parse_a/aaaa_record now share code with the addrinfo parser.
+  * Private ares_addrinfo structure with useful extensions such as ttls (including cname ttls),
+    as well as the ability to list multiple cnames in chain of lookups
+  
+  Work By: Andrew Selivanov @ki11roy
 
-Guenter Knauf (16 Apr 2012)
-- Kill some more compiler warnings.
+- [Andrew Selivanov brought this change]
 
-- Kill compiler warning about unused var.
+  fix ares__sortaddrinfo, use wrappers for sock_funcs (#258)
+  
+  Some socket functions weren't exposed for use by other areas of the library.  Expose
+  those and make use of them in ares__sortaddrinfo().
+  
+  Fix By: Andrew Selivanov (@ki11roy)
 
-- Fixed my last commit: wrong preprocessor directive.
+- Fix c89 compilation support broken by .onion rejection changes
+  
+  Move .onion check lower after all variables have been declared.
+  
+  Bug: #246
 
-- Check for __ANDROID__ in addition to ANDROID macro.
+- [kedixa brought this change]
 
-- Check for __ANDROID__ in addition to ANDROID macro.
+  getaddrinfo: callback must be called on bad domain (#249)
   
-  Posted to c-ares list by Wayne.
+  Due to an order of incrementing the remaining queries and calling ares_query, on a bad domain
+  the registered callback wouldn't be called.
+  
+  Bug: #248
+  Fixed-By: @kedixa
 
-- Fix for Android to disable useless arpa/nameser.h.
+- [Darrin W. Cullop brought this change]
 
-- Fix for Android to include sys/select.h for fd_set.
+  Windows ARM/ARM64 requires AdvApi32 (#252)
+  
+  Fix link issues caused by missing library that appears to only be required on ARM (though
+  docs don't list this restriction). Doesn't hurt to require it everywhere.
+  
+  Bug: #251
+  Fixed-By: Darrin Cullop (@dwcullop)
 
-Yang Tse (17 Mar 2012)
-- ares_data.c: some NAPTR related fixes
+- [kedixa brought this change]
 
-Daniel Stenberg (16 Mar 2012)
-- port numbers: convert them to network order!
+  getaddrinfo: avoid infinite loop in case of NXDOMAIN(#240) (#242)
   
-  When the config options ARES_OPT_UDP_PORT or ARES_OPT_TCP_PORT are used,
-  make sure to convert them to network byte order!
+  There are two possible causes for infinite loops fo NXDOMAIN, based on how many dots are in the domain name (one for < ARES_OPT_NDOTS and one for >= ARES_OPT_NDOTS), where it will repeat the same query over and over as the hquery->next_domain doesn't increment.
   
-  Bug: http://c-ares.haxx.se/mail/c-ares-archive-2012-02/0004.shtml
+  Fix By: @kedixa
 
-- white space cleanup
+- Portability fix for ares__sortaddrinfo()
   
-  - Keep code within 80 columns
+  replace uint32_t with unsigned int and socklen_t with ares_socklen_t
   
-  - Removed funny spaces after open paren and before closing paren
+  By: Brad House
 
-- [Poul Thomas Lomholt brought this change]
+- [Khaidi Chu brought this change]
 
-  get_iphlpapi_dns_info: fix buffer overrun
+  fix: init bufp before reject .onion to make it can be free correctly (#241)
   
-  I experienced a buffer overrun exception in c-ares on Windows and
-  tracked it down to be an error in the calculation of the 'left' variable
-  in get_iphlpapi_dns_info().
+  When querying a .onion domain, it returns directly without setting bufp to NULL. A subsequent free() that occurs can cause a segmentation fault.
   
-  I changed the variable type of 'left' to a _signed_ type because of the
-  subtraction arithmetic; not sure if a long is the best choice
+  Fix By: Khaidi Chu (@XadillaX)
 
-- Merge pull request #7 from saghul/naptr
+- [Andrew Selivanov brought this change]
+
+  Add ares__sortaddrinfo() to support getaddrinfo() sorted results (#239)
   
-  Added support for parsing NAPTR records
+  This is a port of RFC 6724 compliant sorting function from Android Bionic project:
+  https://android.googlesource.com/platform/bionic/+/e919b116d35aa7deb24ddece69c491e24c3b0d6f/libc/netbsd/net/getaddrinfo.c
+  
+  The latest version is essentially the same, except two additional parameters to test connection with (mark/uid):
+  https://android.googlesource.com/platform/bionic/+/master/libc/dns/net/getaddrinfo.c
+  
+  Please note that even that version has some restrictions. It doesn't support some rules from RFC 6724:
+  
+  Rule 3 (Avoid deprecated addresses)
+  Rule 4 (Prefer home addresses)
+  Rule 7 (Prefer native transport)
+  
+  Submitted By: Andrew Selivanov (@ki11roy)
 
-saghul (23 Feb 2012)
-- Added support for parsing NAPTR records
+- [Christian Ammer brought this change]
 
-Yang Tse (19 Jan 2012)
-- ares_init.c: fix compiler warning on winsock builds
+  Increase portability of `ares-test-mock-ai.cc` (#235)
+  
+  * using portable ares_inet_pton and updated includes in ares-test-mock-ai
+  * forgot to remove deleted ares-test-ai.cc in Makefile.inc
+  
+  Fix By: Christian Ammer (@ChristianAmmer)
 
-- configure: libtool 1.5 tweaks
+- [Fabrice Fontaine brought this change]
 
-Daniel Stenberg (19 Dec 2011)
-- ares_timeout.3: fix the NAME section
+  m4/xc-cc-check.m4: use XC_CHECK_BUILD_FLAGS (#236)
   
-  It was clearly a copy n' paste error
+  Use XC_CHECK_BUILD_FLAGS instead of XC_CHECK_USER_FLAGS.
+  Otherwise it complains of CPPFLAGS in CFLAGS.
+  [Retrieved from:
+  https://git.buildroot.net/buildroot/tree/package/c-ares/0001-use_check_build_instead_of_check_user.patch]
+  
+  Signed-off-by: Gustavo Zacarias <gustavo@zacarias.com.ar>
+  Signed-off-by: Fabrice Fontaine <fontaine.fabrice@gmail.com>
+  Submitted by: Fabrice Fontaine
 
-Yang Tse (27 Sep 2011)
-- [Albert Chin brought this change]
+- [Christian Ammer brought this change]
 
-  configure - m4: make CURL_CHECK_DEF ignore leading whitespace on symbol def
+  Bugfix for `ares_getaddrinfo` and additional unit tests (#234)
   
-  When using Sun C compiler the preprocessor somehow inserts an extra space
-  in front of replaced symbol, breaking CURL_CHECK_DEF macro. To workaround
-  this, macro CURL_CHECK_DEF now ignores all leading whitespace in front of
-  symbol substitution result.
+  This PullRequest fixes a bug in the function add_to_addrinfo which task is to add new addrinfo items to the ai_next linked list. Also additional unit tests for testing ares_getaddrinfo will be added:
+  
+  Additional mock server test classes (ares-test-mock-ai.cc):
+  MockTCPChannelTestAI
+  MockExtraOptsTestAI
+  MockNoCheckRespChannelTestAI
+  MockEDNSChannelTestAI
+  RotateMultiMockTestAI
+  NoRotateMultiMockTestAI
+  
+  Additional live tests (ares-test-live-ai.cc):
+  LiveGetHostByNameV4
+  LiveGetHostByNameV6
+  LiveGetHostByNameV4AndV6
+  
+  Fix By: Christian Ammer (@ChristianAmmer)
 
-- ares_init.c: fix segfault triggered in ares_init_options() upon previous
-               failure of init_by_defaults() and incomplete cleanup there.
+- [Christian Ammer brought this change]
 
-- ares_process.c: fix compiler warning
+  Remaining queries counter fix, additional unit tests for `ares_getaddrinfo` (#233)
+  
+  Remaining queries counter fix, added tests (ParallelLookups,
+  SearchDomains, SearchDomainsServFailOnAAAA).  Removed unnecessary
+  if and commented code in test.
+  
+  Fix By: Christian Ammer (@ChristianAmmer)
 
-- fix MSVC compiler warning 'conditional expression is constant'
+- [Christian Ammer brought this change]
 
-- setup_once.h cleanup and sync
+  Add initial implementation for ares_getaddrinfo (#112)
+  
+  Initial implementation for ares_getaddrinfo().  It is NOT compliant with RFC6724, though
+  it is expected to come closer to conformance prior to the next release.
+  
+  Features not supported include sorted addresses and honoring of service and hints
+  parameters.
+  
+  Implementation by: Christian Ammer (@ChristianAmmer)
 
-- [Denis Bilenko brought this change]
+- [Ben Noordhuis brought this change]
 
-  ares_getnameinfo: fix random results with c-ares 1.7.5
+  test: fix bad expectation in ipv6 localhost test (#227)
   
-  In ares_getnameinfo memcpy did not copy enough bytes, causing
-  it to return arbitrary memory contents as a result.
+  The LiveGetLocalhostByAddrV6 test expected to see "localhost" in the
+  result when doing an address-to-name lookup for ::1 but on my system
+  that resolves to "ip6-loopback" because of this stanza in /etc/hosts:
+  
+      $ grep ^::1 /etc/hosts
+      ::1     ip6-localhost ip6-loopback
+  
+  Fix By: Ben Noordhuis (@bnoordhuis)
+  Bug: #85
 
-- warnings: fix another 'conversion may lose significant bits' compiler warning
+- [Ben Noordhuis brought this change]
 
-- ares_dns.h: adjust DNS__16BIT and DNS__32BIT macro definitions
+  ares_version.h: bump version (#230)
   
-  Fixing compiler warnings existing definitions triggered on these.
+  Version change not committed from maketgz.sh
+  
+  Bug: #229
 
-- ares_destroy.c: fix segfault in ares_destroy_options()
+Daniel Stenberg (24 Oct 2018)
+- ares_library_init_android.3: minor syntax edits, fixed AVAILABILITY
 
-Daniel Stenberg (21 Aug 2011)
-- ares_parse_srv_reply: silence compiler warnings
+Version 1.15.0 (23 Oct 2018)
+
+Brad House (23 Oct 2018)
+- last minute 1.15.0 addition
+
+- [Ben Noordhuis brought this change]
+
+  Report ARES_ENOTFOUND for .onion domain names as per RFC7686. (#228)
   
-  ... by adding ugly typecasts.
+  Quoting RFC 7686:
+  
+      Name Resolution APIs and Libraries (...) MUST either respond
+      to requests for .onion names by resolving them according to
+      [tor-rendezvous] or by responding with NXDOMAIN.
+  
+      A legacy client may inadvertently attempt to resolve a .onion
+      name through the DNS. This causes a disclosure that the client
+      is attempting to use Tor to reach a specific service. Malicious
+      resolvers could be engineered to capture and record such leaks,
+      which might have very adverse consequences for the well-being
+      of the user.
+  
+  Bug: #196
+  Fix By: Ben Noordhuis @bnoordhuis
 
-- CHANGES: generate from script
+- prepare for c-ares 1.15.0 release
+
+- AIX Build Fix
   
-  The CHANGES file is now generated automatically with 'git2changes.pl',
-  invoked by the maketgz script which is used to build release archives.
+  AIX attempts to include both nameser_compat.h and onameser_compat.h.  It appears
+  the proper fix is to define _USE_IRS so that only nameser_compat.h is used.
   
-  The former human edited CHANGES file was renamed to CHANGES.0 in git.
+  Bug: #224
+  Fix By: Brad House (@bradh352)
 
-Yang Tse (21 Aug 2011)
-- Makefile.netware: SIZEOF_SHORT definition
+- Fix crash in ares_dup() due to new ARES_OPT_RESOLVCONF
+  
+  ares_dup() calls ares_init_options() by making its own fake option
+  mask since the original mask isn't stored but ARES_OPT_RESOLVCONF
+  was always set, instead of conditionally set.  This caused a crash
+  because ares_strdup() isn't NULL-safe if no custom path was set.
+  
+  Made ares_dup() set ARES_OPT_RESOLVCONF conditionally.
+  
+  Fix By: Brad House (@bradh352)
 
-- warnings: fix some 'conversion may lose significant bits' compiler warnings
+- [Sarat Addepalli brought this change]
 
-- configure: fix symbol hiding usability check
+  Add ares_init_options() configurability for path to resolv.conf file
   
-  A more thorough test is done now in order to determine visibility attribute
-  usability, given that some compilers don't support visibility attribute on
-  all configurations.
+  Add resolvconf_path to end of struct ares_options with ARES_OPT_RESOLVCONF option
+  so on Unix-like systems a custom path can be specified.  If no path is specified,
+  /etc/resolv.conf is used like normal.
+  
+  Fix By: Sarat Addepalli @SirR4T
+  Fixes Bug: #220
+  Review By: Brad House @bradh352
 
-Daniel Stenberg (16 Aug 2011)
-- 1.7.6: start working...
+- remove stale variables
 
-Version 1.7.5 (16 Aug 2011)
+- fix prototype name for ares_strsplit_free()
 
-Daniel Stenberg (16 Aug 2011)
-- CHANGES: synced for 1.7.5 release
+- add missing prototype
 
-- RELEASE-NOTES: synced with bb4096effef7f000
+- simplify ares_strsplit() and create ares_strsplit_free() helper function
 
-Jakub Hrozek (15 Aug 2011)
-- Only fall back to AF_INET searches when looking for AF_UNSPEC addresses
+- missing ares_strsplit.h from HHEADERS for inclusion in distribution
 
-Yang Tse (10 Aug 2011)
-- [Gisle Vanem brought this change]
+- [Ruslan Baratov brought this change]
 
-  ares_iphlpapi.h: Watcom C fix
+  Add CARES_BUILD_TOOLS CMake option (#214)
   
-    Added "!defined(_WS2DEF_)" since Watcom doesn't have
-    a per type guard for the typedefs 'CSADDR_INFO' (that MingW has) or
-    'SOCKET_ADDRESS' (that MSVC has). But we can use the header-guard for
-    <ws2def.h> instead.
-
-- [Gisle Vanem brought this change]
+  Add ability to exclude building of tools (adig, ahost, acountry) in CMake.  This should also close #200.
+  
+  Fix By: Ruslan Baratov (@ruslo)
+  Bug: #200
 
-  Makefile.Watcom:
-    * The 'NTDDI_VERSION' needs to be raised to 0x05010000
-      in order for SOCKADDR_STORAGE etc. to be typedefed.
-    * Replaced '-dUSE_WATT32' with '-dWATT32'.
-    * Added $(DEMOS) to the 'all' target and removed the 'demos'
-      target to be consistent with e.g. Makefile.msvc etc.
-    * 'ENABLE_IPV6' is no longer used. Hence removed the '%use_ipv6' construct.
-    * object-file order seems to be important (Watcom v.19). Hence
-      'ares_getopt.obj' must be put after the .obj that references getopt().
+- [flyingdutchman23 brought this change]
 
-- cares-compilers.m4: CARES_CONVERT_INCLUDE_TO_ISYSTEM adjustments
-  
-  Add CARES_CHECK_COMPILER as a requirement.
+  Style. Whitespace cleanup. (#213)
   
-  Ensure macro does nothing unless GNU_C or CLANG compiler is used.
+  Small whitespace cleanups.
   
-  This should allow usage of this macro in unforeseen placements.
+  Fix By: @flyingdutchman23
 
-- config-win32.h: comments adjustments - followup
+- [John Schember brought this change]
 
-- config-win32.h: comments adjustments
+  Android: Support for domain search suffix (#211)
+  
+  Fixes issue #207. Uses LinkProperties.getDomains() to get a list of search domains and adds them to the suffix list.  This also adds a new helper function to split strings into an array based on multiple delimiters replacing multiple other functions for dealing with string splitting.
+  
+  Submitter: John Schember (@user-none)
+  Fixes: #207
+  Approved-by: Brad House (@bradh352)
 
-Daniel Stenberg (5 Aug 2011)
-- [Tom Hughes brought this change]
+- [afalin brought this change]
 
-  ares_parse_a_reply: fix memleak
+  Improve DNS suffixes extracting from WinNT registry (#202)
+  
+  Join all global and connection specific suffix lists. Use 'HKLM\Software\Policies\Microsoft\Windows NT\DNSClient\SearchList', 'HKLM\System\CurrentControlSet\Services\Tcpip\Parameters\Domain' as global suffix lists.
+  
+  Fix By: @afalin
 
-Yang Tse (29 Jul 2011)
-- cares-functions.m4 serial # bump
+- Be consistent with indention in CMakeLists.txt
+  
+  The imported TRANSFORM_MAKEFILE_INC function from curl used space indention
+  but the rest of the file used tabs.  Go ahead and make it tabs for
+  consistency as well.
+  
+  Committed By: Brad House
 
-- Revert "configure: additional flag checks for fcntl() and socket()"
+- [flyingdutchman23 brought this change]
+
+  Fix modern gcc warning: argument to 'sizeof' in 'strncpy' call is the same expression as the source
   
-  This reverts commit 5f2a3b0e48f26d24cb1fefea0dccb92d417dcbf7.
+  Silence warning about using src to determine number of bytes to copy.
+  In this case it doesn't matter whether it is `src` or `dest`. So there
+  is no functionality change.
+  
+  Bug: #210
+  Fix By: @flyingdutchman23
 
-- configure: additional flag checks for fcntl() and socket()
+- [Andi Schnebinger brought this change]
 
-- xc-translit.m4 fix quoting
+  fix stringop-overflow warning of GCC (#201)
+  
+  When using a modern GCC to compile c-ares, there is a stringop-overflow warning.
+  This patch simply silences the false-positive warning, there is no actual code flaw.
+  
+  Bug: https://github.com/c-ares/c-ares/pull/201
+  Fixed By: Andi Schnebinger @Iniesta8
 
-- configure: avoid direct usage of AS_TR_* macros
+GitHub (18 May 2018)
+- [David Drysdale brought this change]
 
-- xc-translit.m4 provides transliteration macros with well defined behavior.
+  travis: do coverage in "coverage" build (#195)
+  
+  Fixes #194, a mistake from commit a255081f2c3c ("travis: Only do
+  coverage/distcheck on normal build")
 
-Jakub Hrozek (15 Jun 2011)
-- Revert "Only fall back to AF_INET searches when looking for AF_UNSPEC addresses"
+Brad House (17 May 2018)
+- [Brad Spencer brought this change]
+
+  Apply the IPv6 server blacklist to all nameserver sources, not just Windows (#193)
   
-  This reverts commit b5823d65706af687c0e5110af8f0cfdcd068997d.
+  For #164, I mentioned that it seemed like the IPv6 nameserver blacklist should apply to all OSes. In a mailing list post, @bradh352 agreed and suggested that I file a PR to make it so.
   
-  This patch was not reviewed properly before pushing
+  This moves the blacklist check from being Windows-specific to being a general feature of config_nameservers(), no matter the nameserver source. It also simplifies the ares_ipv6_server_blacklisted() implementation to not parse and re-parse the blacklisted IPv6 addresses from strings on every check. I think they're almost as easy to read as a sequence of hex bytes in an array initializer, and it's definitely less work on each trip through the code.
+  
+  Fix By: Brad Spencer @b-spencer
+  PR: https://github.com/c-ares/c-ares/pull/193
 
-- Revert "Do not use sized constants in public headers"
+- [Brad Spencer brought this change]
+
+  Fix warnings emitted by MSVC when using -W4 (#192)
   
-  This reverts commit 22c01e96f7b2ae9923e1baa50bfe3c0d22297a7d.
+  These changes fix a few warnings emitted by recent versions of MSVC when compiling with -W4. Half of the changes are in Windows-specific code, and the other half should be safe no matter the compiler or OS.
   
-  This is a Red Hat specific patch that does not belong into upstream
+  The allocation function change is probably the only one that needs explanation. MSVC gives warnings about the function pointers not being stable across DLL boundaries or something to that effect, so for Windows, I've made them be called indirectly, which at least made the compiler happy. I can't say I've tested every linking combination on Windows with them before or after the change, but it seems harmless.
+  
+  Fix By: Brad Spencer @b-spencer
+  PR: https://github.com/c-ares/c-ares/pull/192
 
-- Use correct sizeof in ares_getnameinfo()
+- [David Hotham brought this change]
 
-- Do not leak rr_name on failures inside ares_parse_ptr_reply
+  Prevent changing name servers while queries are outstanding (#191)
+  
+  Changing name servers doesn't work, per #41.  Better to return an error code than to crash.
+  
+  Fix-by: David Hotham @dimbleby
 
-- Do not leak rr_name on failures inside ares_parse_a_reply
+David Drysdale (15 May 2018)
+- [Tobias Nießen brought this change]
 
-- Do not leak rr_name on failures inside ares_parse_aaaa_reply
+  Fix comment in ares_rules.h (#189)
 
-- Do not leak rr_name on failures inside ares_parse_ns_reply
+Brad House (6 May 2018)
+- [Brad Spencer brought this change]
 
-- Fix incorrect sizeof() in ares_save_options
+  Harden and rationalize c-ares timeout computation (#187)
+  
+  * Harden and rationalize c-ares timeout computation
+  * Remove the rand() part of the timeout calculation completely.
+  
+  When c-ares sends a DNS query, it computes the timeout for that request as follows:
+  
+  timeplus = channel->timeout << (query->try_count / channel->nservers);
+  timeplus = (timeplus * (9 + (rand () & 7))) / 16;
+  I see two issues with this code. Firstly, when either try_count or channel->timeout are large enough, this can end up as an illegal shift.
+  
+  Secondly, the algorithm for adding the random timeout (added in 2009) is surprising. The original commit that introduced this algorithm says it was done to avoid a "packet storm". But, the algorithm appears to only reduce the timeout by an amount proportional to the scaled timeout's magnitude. It isn't clear to me that, for example, cutting a 30 second timeout almost in half to roughly 17 seconds is appropriate. Even with the default timeout of 5000 ms, this algorithm computes values between 2812 ms and 5000 ms, which is enough to cause a slightly latent DNS response to get spuriously dropped.
+  
+  If preventing the timers from all expiring at the same time really is desirable, then it seems better to extend the timeout by a small factor so that the application gets at least the timeout it asked for, and maybe a little more. In my experience, this is common practice for timeouts: applications expect that a timeout will happen at or after the designated time (but not before), allowing for delay in detecting and reporting the timeout. Furthermore, it seems like the timeout shouldn't be extended by very much (we don't want a 30 second timeout changing into a 45 second timeout, either).
+  
+  Consider also the documentation of channel->timeout in ares_init_options():
+  
+  The number of milliseconds each name server is given to respond to a query on the first try. (After the first try, the timeout algorithm becomes more complicated, but scales linearly with the value of timeout.) The default is five seconds.
+  
+  In the current implementation, even the first try does not use the value that the user supplies; it will use anywhere between 56% and 100% of that value.
+  
+  The attached patch attempts to address all of these concerns without trying to make the algorithm much more sophisticated. After performing a safe shift, this patch simply adds a small random timeout to the computed value of between 0 ms and 511 ms. I could see limiting the random amount to be no greater than a proportion of the configured magnitude, but I can't see scaling the random with the overall computed timeout. As far as I understand, the goal is just to schedule retries "not at the same exact time", so a small difference seems sufficient.
+  
+  UPDATE: randomization removed.
+  
+  Closes PR #187
+  Fix by: Brad Spencer
 
-- Fix incorrect allocation in ares_parse_ptr_reply()
+- distribute ares_android.h
+  
+  Distribute ares_android.h when a release distribution package is
+  created.
+  
+  Reported By: Andrey Khranovsky
+  Bug: https://c-ares.haxx.se/mail/c-ares-archive-2018-04/0000.shtml
 
-- Only fall back to AF_INET searches when looking for AF_UNSPEC addresses
+- ares_set_servers_csv() on failure should not leave channel in a bad state
+  
+  If bad data is passed to ares_set_servers_csv() or
+  ares_set_servers_ports_csv() it will clear the existing channel
+  configured DNS servers, then a call to ares_send() will fail due
+  to a bad malloc which may have undefined behavior.
+  
+  The fix now only clears existing servers on success.  An additional
+  sanity check was added in ares_send() to ensure nservers >= 1 or
+  will result in ARES_ESERVFAIL.
+  
+  Bug: https://c-ares.haxx.se/mail/c-ares-archive-2018-03/0000.shtml
+  Reported-by: Francisco Sedano Crippa
 
-- Do not use sized constants in public headers
+- docs: Not all manpages are listed
+  
+  Some docs aren't installed or not showing up on
+  https://c-ares.haxx.se/docs.html
+  due to not being listed in Makefile.inc.  Add missing docs and
+  ensure docs are alphabetized.
 
-Daniel Stenberg (13 Jun 2011)
-- [Jakub Hrozek brought this change]
+Version 1.14.0 (16 Feb 2018)
 
-  ares_free_hostent(NULL) should be a noop
+Daniel Stenberg (16 Feb 2018)
+- ares_android.c: fix warning: ISO C forbids an empty translation unit
 
-Yang Tse (8 Jun 2011)
-- configure: fix recvfrom 5th arg type qualifier detection (followup)
+- RELEASE-NOTES: some more work we did and people who helped
 
-- configure: fix recvfrom 5th arg type qualifier detection
+Brad House (16 Feb 2018)
+- travis: skip Autotools style testing for cmake
   
-  Additionally remove whitespace from EOL
+  Fix cmake test build by skipping autotools portion of test script.
 
-Daniel Stenberg (4 Jun 2011)
-- strlen: use size_t to receive the return
+- travis: standardize CMake test off of Autotools tests
+  
+  Instead of running 'make test', run the tests directly like autotools
+  does.  It provides more verbose output.
 
-Yang Tse (4 Jun 2011)
-- xlc: avoid preprocessor definition usage when linking
+- travis: Enable building tests for CMake
+  
+  Travis should auto-build and run tests for cmake builds now that
+  PR #168 is merged.
 
-- ares_nowarn: icc 9.1 workaround
+- fix version in pkgconfig
 
-- ares_nowarn: header inclusion fix
+- Add version update to CMakeLists in maketgz
 
-- ares_init: make ares_private.h last included header again
+- Release prep.  Add support for pkgconfig in cmake, set versions appropriately
 
-- compiler warning: fix
-  
-  Fix compiler warning: conversion may lose significant bits
+Gregor Jasny (15 Feb 2018)
+- CMake: Add tests
 
-- compiler warning: fix
-  
-  Fix compiler warning: variable was set but never used
-  
-  Fix compiler warning: clobber ignored
+Brad House (14 Feb 2018)
+- [Gregor Jasny brought this change]
 
-- ares_iphlpapi: fix compiler warnings
+  Use cmake3 package provided by Ubuntu (#182)
 
-- winsock: compilation fixes
-  
-  Provide winsock iphlpapi alternative definitions to prevent compilation
-  failures when using a variety of winsock header implementations.
+- Cmake 3.1 instead of 3.2.1 should be the minimum
 
-Daniel Stenberg (17 May 2011)
-- [David Stuart brought this change]
+- Update RELEASE-NOTES and RELEASE-PROCEDURE.md to prepare for next release
 
-  IPv6-on-windows: find DNS servers correctly
+- get rid of c++ style comments
 
-- man pages: docs for the c-ares utility programs
+- Use trusty for all builds, precise is EOL.  Update clang and cmake versions.
 
-- ares_parse_ns_reply.c: remove CVSism
+- Current CMakeLists.txt doesn't support 2.8.12 anymore, we need to bump the version to 3.2.1 minimum
 
-Yang Tse (27 Mar 2011)
-- build: fix header inclusion
+- Re-organize sections in INSTALL.md and add CMake section
 
-- getservbyport replacement for Win CE
+- [Sergey Kolomenkin brought this change]
 
-- renamed getplatform() to ares__getplatform() to avoid namespace pollution
+  remove compilation warnings in MSVC (#47)
 
-- configure: fix libtool warning
-  
-  Recent versions of libtool are now tracing usage of AC_CONFIG_MACRO_DIR
-  macro and warn heavily when not used in configure script along with
-  ACLOCAL_AMFLAGS in Makefile.am.  So in order to make libtool happy
-  while keeping backwards compatibility this is added.
+- document handling of timeouts for ares_process and ares_process_fd to close PR #57
 
-- adig: RFC4034 resource record type detection
-  
-  Can be tested with: adig -s 8.8.8.8 -t ANY example.com
+- As per Issue #155, since we do not require gethostname() during init, if it fails, there's no reason for init to fail as it is only used to populate the domain
 
-- nameser.h: RFC4034 resource record type definitions
+GitHub (7 Feb 2018)
+- [David Drysdale brought this change]
 
-- build: move platform stuff to ares_platform.c and ares_platform.h
+  Document WSAStartup requirement (#180)
 
-- build: find out windows platform using GetVersionEx()
+David Drysdale (6 Feb 2018)
+- [Antonio Tajuelo brought this change]
 
-- build: use getenv() replacement function for systems which lack it
+  Added coderelease.io badge to readme.md for letting people subscribe to new versions (#174)
 
-- setup_once: system error codes for Windows CE
+- [Sheel Bedi brought this change]
 
-- ares_search: use ERRNO macro for portability sake
+  Update year in LICENSE.md to 2018 (#170)
 
-- System's errno.h inclusion cleanup follow-up.
-  
-  System's errno.h is conditionally included from setup_once.h
+GitHub (4 Feb 2018)
+- [David Drysdale brought this change]
 
-- Windows CE specific adjustment
+  travis: use VM not container for {L,A}SAN builds (#177)
   
-  All versions of Windows CE support Winsock 1.1
+  As per https://github.com/travis-ci/travis-ci/issues/9033, container
+  based builds do not currently allow ptrace, which is used by LSAN and
+  ASAN.
 
-- System's errno.h inclusion cleanup.
+Brad House (3 Feb 2018)
+- [acthompson-google-com brought this change]
+
+  Android JNI code leaks local references in some cases (#175)
   
-  System's errno.h is conditionally included from setup_once.h
+  * Add Google LLC to AUTHORS.
+  
+  * android: Explicitly delete all JNI local references, and cache JNI method IDs at initialization.
+  
+  * android: Only return ARES_ENOTINITIALIZED on failures in initialization code.
 
-- ares_init: fix gethostname error detection on winsock platforms
+Gregor Jasny (2 Jan 2018)
+- Embed fused Google Test 1.8.0
 
-- configure: r-enable temporarily disabled detection of system's inet_ntop()
-  
-  Detection was temporarily disabled in commit 674e044ccb21f2f63537da53565fce868f
+Brad House (21 Dec 2017)
+- [John Schember brought this change]
 
-Daniel Stenberg (15 Mar 2011)
-- configure: stop using the deprecated AM_INIT_AUTOMAKE syntax
+  android: Check returns for obj and classes are not NULL. Document API levels for various Android functions and objects used. (#166)
 
-- [Gisle Vanem brought this change]
+- CARES_CHECK_TYPE should reference variable so a warning is not produced for -Werror compatibility
 
-  Watt-32: use errno
-  
-  Make sure Watt-32 programs use 'errno' even on Win32 targets
+- [Brad Spencer brought this change]
 
-Guenter Knauf (18 Feb 2011)
-- Removed commented CLFAGS no longer needed.
+  Fix computation of IPv6 blacklist mask for values of netmask > 8. (#164)
 
-- Fixed CFLAGS for NetWare.
+David Drysdale (14 Dec 2017)
+- travis: Only do coverage/distcheck on normal build
+
+- travis: only do pip install on Linux
+
+- travis: only test in IPv4 mode
   
-  Added -m32 to enable compilation with x86_64 compilers;
-  added conditional to set -fpcc-struct-return only for gcc compiler.
+  Travis' Trusty environment does not support IPv6.
 
-Daniel Stenberg (18 Feb 2011)
-- [Gisle Vanem brought this change]
+- test: allow restriction to one IP address family
 
-  Watt32: fix server init
-  
-  Somewhere in the process, programs using the Watt-32 tcp/ip stack
-  stopped working.
+- [Roman Teterin brought this change]
 
-- [Dima Tisnek brought this change]
+  Fix a typo in init_by_resolv_conf (#160)
 
-  config_sortlist: (win32) missing else
-  
-  Without an else there, contents of "pat" that could have been
-  successfully set just above, may be clobbered by successive unsuccessful
-  calls to "xxx_pton" or "ip_addr".
+Brad House (11 Dec 2017)
+- @gvanem says MSVC -RTCc option fails, looks erroneous to me, but the additional mask is harmless
 
-Yang Tse (17 Jan 2011)
-- Makefile.msvc: add a couple of VS version strings
+- Fix some other mingw warnings
 
-- Makefile.msvc: add a couple of VS version strings
+- Issue #143, get rid of windows build warning due to passing 'char **' to argument expecting 'const char **'
 
-- build: add install target to Makefile.msvc
+- [Gregor Jasny brought this change]
 
-Daniel Stenberg (27 Dec 2010)
-- ares_set_servers_csv: remove unused variables
+  Distribute CMake files (#130)
 
-- init_by_resolv_conf: fix compiler warnings
+- Android variants may not have __system_property_get
   
-  The code received the return codes in the 'status' variable without
-  using it. Instead we just ignore those particular errors.
+  Some android systems like ARM64 may not have the __system_property_get
+  symbol in libc (but still have it in the public headers).  Detect this
+  condition at build time.  The __system_property_get method of retrieving
+  name servers is deprecated as of Oreo so should strictly be a fallback
+  mechanism anyhow.
 
-- getv4: Value stored to 'dst' is never read
+David Drysdale (9 Nov 2017)
+- [David Hotham brought this change]
 
-- advance_tcp_send_queue: avoid NULL ptr dereference
+  Wrong function name throughout man page (#154)
+
+- ares_data.c: iterate through substructs when freeing
   
-  If given a too large 'num_bytes' value, it would cause a NULL ptr
-  dereference. Instead the code will now break out of the loop at the end
-  of the list.
+  Previous code recursed into substructures, which makes it more likely
+  that large/heavily-nested responses could use up lots of stack.
 
-- [Peter Pentchev brought this change]
+- test: test ares_free_data on long chain of structs
 
-  configure: fix a bashism
+- [Felix Yan brought this change]
 
-- cleanup: avoid unsafe typecasts
-  
-  Avoid the risk of reading 16bit data from an unaligned address by using
-  a macro that is adapted for this.
+  Fix a typo in inet_ntop.c (#151)
 
-- [Stefan Bühler brought this change]
+Daniel Stenberg (29 Sep 2017)
+- ares_gethostbyname.3: fix callback status values
+  
+  - ARES_ENOTFOUND means the _name_ wasn't found
+  
+  - ARES_ENODATA can be returned when a resolve fails
+  
+  Reported-by: Jakub Hrozek
+  Bug: https://c-ares.haxx.se/mail/c-ares-archive-2011-06/0012.shtml
 
-  ares_expand_name: Fix encoded length for indirect root
+Brad House (28 Sep 2017)
+- [John Schember brought this change]
 
-Yang Tse (18 Dec 2010)
-- build: add some explicit file references to VS project files
+  Fix DNS server lookup breaking with Android O due to Android removing access to net.dns# system properties. (#148)
+  
+  As of Android 8 (Oreo) access to net.dns# has been removed (https://developer.android.com/about/versions/oreo/android-8.0-changes.html). The reasoning given is that it, "improves privacy on the platform". Currently c-ares uses this to get the list of DNS servers.
+  
+  Now the only way to access the DNS server list is by using the Connectivity Manager though Java. This adds the necessary JNI code to use the Connectivity Manager and pull the DNS server list. The old way using __system_property_get with net.dns# remains for compatibilty.
+  
+  Using the Connectivity Manager requires the ACCESS_NETWORK_STATE permission to be set on the app. Existing applications most likely are not setting this and keeping the previous method as a fallback will at the very least ensure those apps don't break on older versions of Android. They will need to add this permission for Android 8 compatibility.
+  
+  Included in the patch are two initalization functions which are required. The JVM must be registered as well as the Connectivity Manager itself. There is no way to get the Connectivity Manager except though Java. Either being passed down to C directly or by passing in an Android Context which can be used to get the Connectivity Manager. Examples are provided in the documentation.
 
-- config-win32: provide HAVE_ASSERT_H definition
+- [Konstantinos Sofokleous brought this change]
 
-- build: include ares_nowarn in sample program VS project files
+  allow linking against the static msvc runtime library (#133)
+  
+  allow linking against the static msvc runtime library
 
-- build: include ares_nowarn among SAMPLESOURCES and SAMPLEHEADERS
+- [Gergely Nagy brought this change]
 
-- configure: temporarily disable detection of system's inet_ntop()
+  Force using the ANSI versions of WinAPI functions (#142)
   
-  This is done to allow compilation of ares_inet_ntop() by some daily
-  builds picky compilers that otherwise do not need this function.
+  When compiling c-ares with a build system that defines UNICODE,
+  bad versions of WinAPI functions are used causing failures or even
+  crashes. When windows.h is included in MBCS mode (like in the default
+  build system), the ..A versions are the same as using the one without
+  any suffix.
 
-- changes: mention last fix
+- [cmake] build fix on Solaris
 
-- ares_inet_ntop: remove definition and usage of macro SPRINTF
-  
-  Existing definition of SPRINTF always resulted in sprintf() being used,
-  and sprintf() returning 'int' is already used throughout the library.
+GitHub (11 Sep 2017)
+- [Brad House brought this change]
 
-- ares_inet_ntop: reapply changes from previous c-ares version (III)
+  Win32 exclude legacy ipv6 subnets (#144)
   
-  - Replace 'u_char' with 'unsigned char'.
-  - Replace 'u_int' with 'unsigned int'.
-  - use macros ERRNO and SET_ERRNO() for errno handling.
+  win32 ipv6: add infrastructure to exclude ipv6 subnets that are known to cause issues
 
-- ares_inet_ntop: reapply changes from previous c-ares version (II)
+- [David Drysdale brought this change]
+
+  windows: only look for ancient compilers (#146)
   
-  - Remove rcsid.
-  - Adjust header file inclusions.
-  - ares_inet_ntop used only on systems without a proper inet_ntop function.
+  Also drop the use of a versioned output directory; just use
+  .\msvc
 
-- ares_inet_ntop: reapply changes from previous c-ares version (I)
+- [David Drysdale brought this change]
+
+  ares_init_options.3: match up sock_state_cb args (#141)
   
-  - Replace tabs with spaces.
-  - Use ANSI C style for function declarations and definitions.
-  - Use sizeof with parentheses.
+  Fixes #140
 
-- ares_inet_ntop: fix off by one error triggering out of bounds write
+Daniel Stenberg (25 Aug 2017)
+- [Anna Henningsen brought this change]
+
+  gethostbyaddr: fail with `ECANCELLED` for `ares_cancel()`
   
-  ares_inet_ntop would trigger an out of bounds write when the representation
-  of the address required 15 characters, due to not taking in account null
-  termination character.
+  When `ares_cancel()` was invoked, `ares_gethostbyaddr()`
+  queries would fail with `ENOTFOUND` instead of `ECANCELLED`.
   
-  Full import of inet_ntop.c from bind-9.5.3rc1 to pull additional fixes.
+  It seems appropriate to treat `ares_cancel()` like `ares_destroy()`,
+  but I would appreciate review of the correctness of this change.
+  
+  Ref: https://github.com/nodejs/node/issues/14814
+  
+  Closes #138
 
-- ares_nowarn: add conditional inclusion of assert.h header
+David Drysdale (18 Aug 2017)
+- [David Hotham brought this change]
 
-- fix compiler warning: conversion may lose significant bits
+  support most recent Visual Studio 2017
 
-- ares_inet_net_pton: fix non-rejection of some malformed literals
+Brad House (26 Jul 2017)
+- Preserve original DNS server order on Windows for equal metrics.
   
-  ares_inet_net_pton would return wrong values when excessively large,
-  and invalid, netmasks are used. Fixes are from bind-9.5.3rc1,
-  issue also described in the WLB-2008080064 advisory.
+  qsort is not stable, in order to make it stable we need to record
+  the original index and add it as a secondary sort value when the
+  metrics are equal to prevent using DNS servers that may not work
+  at all as reported by some users.
 
-- setup_once: provide ISASCII macro
+David Drysdale (15 Jul 2017)
+- [Anna Henningsen brought this change]
 
-- configure: inet_net_pton function check adjustments
+  ares_parse_naptr_reply: make buffer length check more accurate
   
-  Define HAVE_INET_NET_PTON only when system's inet_net_pton function is IPv6
-  capable and is not affected by the WLB-2008080064 advisory.
+  9478908a490a6bf009ba58d81de8c1d06d50a117 introduced a length check
+  for records parsed by `ares_parse_naptr_reply()`. However, that
+  function is designed to parse replies which also contain non-NAPTR
+  records; for A records, the `rr_len > 7` check will fail as there
+  are only 4 bytes of payload.
+  In particular, parsing ANY replies for NAPTR records was broken
+  by that patch.
   
-  HAVE_INET_NET_PTON_IPV6 is no longer defined nor used.
+  Fix that by moving the check into the case in which it is already
+  known that the record is a NAPTR record.
 
-- ares_init: fix detection of semicolon comments in resolv.conf
+- appveyor: run dnsdump as a sanity check
+
+- travis: run dnsdump as a sanity check
+
+- test: use ares_free_string() throughout
   
-  File resolv.conf may either use a hash '#' or a semicolon ';' character as an
-  indication that the rest of the line is a comment.  This fixes not recognizing
-  the semicolon as a valid comment indicator in resolv.conf.
+  As pointed out by Gisle Vanem in #125.
 
-- version: start working on 1.7.5
+Daniel Stenberg (3 Jul 2017)
+- RELEASE-PROCEDURE.md: how to release
+  
+  Fixes #115
+  Closes #116
 
-Version 1.7.4 (8 Dec 2010)
+David Drysdale (2 Jul 2017)
+- test: Build dnsdump on Windows too
+  
+  Thanks to Gisle Vanem for showing the way:
+  https://github.com/c-ares/c-ares/commit/b701af8a24cf9d173b1dbe5faedcea34642e92da#commitcomment-22830845
 
-Daniel Stenberg (8 Dec 2010)
-- release-preps: CHANGES and RELEASE-NOTES synced
+Brad House (26 Jun 2017)
+- [Christian Ammer brought this change]
 
-- ares_set_local_*: added in 1.7.4, not before
+  fix statement like #define - ares ssize_t define had a trailing semicolon (#120)
 
-Yang Tse (3 Dec 2010)
-- build: provide SIZEOF_SIZE_T definition for non-configure builds
+David Drysdale (21 Jun 2017)
+- test: distribute the fuzzcheck.sh script
+  
+  The TESTS target runs fuzzcheck.sh so make sure it is included
+  in the distributed tarball.
+  
+  (The test itself will be pointless when run on a distribution, because
+  the fuzzing corpus directories are not shipped, but at least this
+  means that `make -C test test` should work.)
 
-- build: config.dos renamed to config-dos.h
+- test: run the name-parsing corpus check too
 
-- build: provide SIZEOF_SIZE_T netware definition
+Daniel Stenberg (21 Jun 2017)
+- dist: don't build/ship PDF versions in release archives
+  
+  ... experience says very few read them and they can still get build by
+  those who want them.a
 
-- ares_gethostbyaddr: fix compiler warning: conversion may lose significant bits
+- ares_version.h: bump version
 
-- configure: undo using autobuilds to temporarily verify strict aliasing warnings.
+Version 1.13.0 (20 Jun 2017)
 
-- fix compiler warning: rounding, sign extension, or loss of accuracy may result
+Daniel Stenberg (20 Jun 2017)
+- RELEASE-NOTES: 1.13.0
 
-Daniel Stenberg (2 Dec 2010)
-- [Ben Noordhuis brought this change]
+- ares_set_socket_functions.3: added in 1.13.0
 
-  ares_parse_a_reply: fix CNAME response parsing
-  
-  Reply to a CNAME query doesn't contain addresses, causing
-  ares_parse_a_reply() to bail out with ARES_ENODATA
+David Drysdale (18 Jun 2017)
+- ares_parse_naptr_reply: check sufficient data
   
-  Bug: http://groups.google.com/group/nodejs/browse_thread/thread/a1268c9ea5e9ad9b
+  Check that there is enough data for the required elements
+  of an NAPTR record (2 int16, 3 bytes for string lengths)
+  before processing a record.
 
-Yang Tse (1 Dec 2010)
-- fix compiler warning: conversion may lose significant bits
+- test: Feed in short NAPTR
 
-- atoi: remove atoi usage
+- test: Add fuzz input with short NAPTR
 
-- ares_init: fix compiler warning: conversion may lose significant bits
+- test: add ares_parse_naptr_reply to fuzzer
 
-- configure: fix autoconf warning
+- [noiz brought this change]
 
-- inet_pton: fix compiler warning
+  Update ares.h to support compiling with QNX
 
-- configure: use autobuilds to temporarily verify strict aliasing warnings.
-  
-  Temporarily, When cross-compiling with gcc 3.0 or later, enable strict aliasing
-  rules and warnings. Given that cross-compiled targets autobuilds do not run the
-  test-suite, there is no risk of running code that violates strict aliasing rules
+- [Dionna Glaze brought this change]
 
-- ares_getnameinfo: Partially revert commit 85520d66e0ac7ac73411bc25e98769a88b2f
+  Simple changes to appease stricter compilers.
   
-  Upon socket address family and length validation failure return ARES_ENOTIMP
-  in callback again, this is the error code documented in man page and used
-  mostly all over the library.
+  ares_process.c uses htonl, which needs <arpa/inet.h> included.
+  ares_getnameinfo.c uses a dynamically selected format string for
+  sprintf, which -Wformat-literal doesn't like. Usually one would use
+  inttypes.h and a format string "%" PRIu32, but C99 is too new for some
+  supported platforms.
 
-- ares_getnameinfo: Validate socket address family and length.
-  
-  Validate socket address family and that the socket address length is appropriate
-  for the specified family. Failure is reported with ARES_EBADFAMILY in callback.
+GitHub (16 Jun 2017)
+- [Gregor Jasny brought this change]
 
-- ares_getnameinfo: fix two compiler warnings
+  CMake: Emulate interface library on import (#108)
+  
+  Closes: #104
+  Signed-off-by: Gregor Jasny <gjasny@googlemail.com>
 
-- Added another VS10 version string
+Brad House (6 Jun 2017)
+- [ChristianAmmer brought this change]
 
-- Fix GCC 4 compiler warning 'dereferencing type-punned pointer might break strict-aliasing rules'.
+  Added support for Windows DNS Suffix Search List (#93)
+  
+  This change solves issue #53.
+  
+  Support for suffix search lists was already built in for Linux. The search list could be set via set_search. With this change the suffix search list from Windows is read from the registry and then set into the ares configuration via set_search. There are two sources for the search list:
+  
+  The global DNS suffix search list.
+  The primary and connection specific DNS suffixes if the global is not available.
+  
+  Contributed by @ChristianAmmer
 
-- Revert commit 494274e653936335c255a47599970de3df21e7c4
+Daniel Stenberg (25 May 2017)
+- [Thomas Köckerbauer brought this change]
 
-- configure: fix autoconf 2.68 warning: no AC_LANG_SOURCE call detected in body
+  configure: do not heck for ar if specified manually
+  
+  Closes #62
 
-- Fix compiler warning: array subscript has type 'char'
+David Drysdale (23 May 2017)
+- ares_expand_name: limit number of indirections
 
-- Fix GCC 4 compiler warning 'dereferencing type-punned pointer might break strict-aliasing rules'.
+- test: fuzz input file that takes a while to process
 
-- Revert following commits:
-    07bc7ea79509bcc9ef6e09151e81766ed00d3392
-    3392a50ea3f8573ea4b7a9d82b9833dab60cb0e9
-    9912637d32c9987719a1ea12db591aee2941891c
-  
-  The purpose of the whole patch was to silence a compiler warning triggered
-  with GCC 4 on file ares_process.c  The specific compiler warning was
-  'dereferencing type-punned pointer might break strict-aliasing rules'.
+- test: copy data in fuzz regression driver
   
-  A simpler patch will follow to equally silence the warning.
-
-- ares_options: reorder header inclusions to make inclusion of
-  ares_private.h the last included one again.
+  Oops.
 
-Daniel Stenberg (12 Nov 2010)
-- [Patrik Thunstrom brought this change]
+GitHub (23 May 2017)
+- [David Drysdale brought this change]
 
-  adig: fix NAPTR parsing
+  Convert char from ISO-8859-1 to UTF-8 (#99)
   
-  I ran across a small "issue" in your adig example.
-  
-  It is simply the last part of the NAPTR record, the replacement element,
-  which is not a string, as currently handled in adig, but a domain name.
+  Fixes #97
 
-- ares_save_options: assignments instead of memcpy
+- [Gregor Jasny brought this change]
 
-- init_by_options: don't copy an empty sortlist
+  travis: Use trusty for cmake builds (#109)
   
-  If there aren't any sort items to copy, don't bother. Without this
-  little precaution it would do a malloc(0) which causes undefined
-  behaviors and is frowned upon by curl's memdebug-system.
+  kubuntu-backports dropped the CMake package for Precise
 
-Guenter Knauf (3 Oct 2010)
-- Minor Watcom makefile tweaks.
+David Drysdale (2 May 2017)
+- [David Hotham brought this change]
 
-Daniel Stenberg (30 Sep 2010)
-- [Mike Crowe brought this change]
+  msvc_ver.inc support most recent Visual Studio 2017 (#101)
 
-  Fix lookup with HOSTALIASES set.
-  
-  ares__read_line returns ARES_EOF when it reaches the end of the
-  file. This will happen every time when reading to the end of the
-  HOSTALIASES file. Unfortunately single_domain treats this error as
-  being fatal.
-  
-  Signed-off-by: Mike Crowe <mac@mcrowe.com>
+- test: use io.h not unistd.h for Windows
 
-Ben Greear (24 Aug 2010)
-- Add missing break that caused get_ares_servers to fail.
+- test: try building fuzz binaries on Windows
+
+- test: stick to int in ares-fuzz.c
   
-  Reported-by: Ning Dong <flintning@163.com>
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
+  Using int rather than ares_ssize_t means this file
+  needs no c-ares dependency - it's a general driver for
+  any libFuzzer-style entrypoint.
 
-Yang Tse (11 Aug 2010)
-- configure: werror related adjustments
+- test: force ARES_OPT_NOROTATE for no-rotate tests
 
-Guenter Knauf (8 Aug 2010)
-- Added copyright string to ares_version.h and make use of it in other files.
+- test: check expected NOROTATE value
 
-- Block created ares_build.h for NetWare to avoid usage from other platforms.
+- ares_create_query: use ares_free not naked free
+  
+  Accidentally added in commit 65c71be1cbe5
+  ("ares_create_query: avoid single-byte buffer overwrite")
 
-- Fix to overwrite default libname.
+Brad House (17 Mar 2017)
+- Need ares.h for ares_ssize_t
 
-- Some more Watcom makefile massage ...
+- tests should not use ssize_t, use ares_ssize_t
 
-- Some more Watcom makefile massage ...
+GitHub (16 Mar 2017)
+- [Brad House brought this change]
 
-Ben Greear (4 Aug 2010)
-- sock-addr-storage:  Detect and deal with lack of .ss_family member.
+  Portability updates for legacy systems. (#92)
   
-  AIX, at least, does not have sockaddr_storage.ss_family member.
-  Detect this in the configure logic and use proper #ifdefs in the
-  ares_process logic.
+  Socklen_t should not be used in code, instead ares_socklen_t should be used.
+  Convert ssize_t to ares_ssize_t for portability since the public API now exposes this.
+
+David Drysdale (14 Mar 2017)
+- [Michael Osei brought this change]
+
+  Update msvc_ver.inc (#91)
   
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
-  Tested-by: Tor Arntsen <tor@spacetec.no>
+  For Visual Studio 2017 builds
 
-Guenter Knauf (3 Aug 2010)
-- Added Watcom makefile based on libcurl's Makefile.Watcom.
+Daniel Stenberg (13 Mar 2017)
+- [Brad House brought this change]
 
-Ben Greear (31 Jul 2010)
-- typo:  Fix compile bug for platforms that don't have sockaddr_storage.
+  Windows DNS server sorting (#81)
   
-  Bug was introduced by me in previous commit.
+  Original Patch From Brad Spencer:
+  https://c-ares.haxx.se/mail/c-ares-archive-2016-04/0000.shtml
   
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
-
-- Fix aliasing warning in gcc 4.4.4 (at least).
+  My modifications include:
+   * Dynamically find GetBestRoute2 since it is a Windows Vista+ symbol, and will fall back to prior behavior when not available.
+   * Prefer get_DNS_AdaptersAddresses as the modifications should alleviate the concerns which caused us to prefer get_DNS_NetworkParams
+   * Update AppVeyor to use MinGW-w64 instead of the legacy MinGW
+   * Fix compile error in test suite for Windows.
   
-  Should be no functional change, though the code gets a bit
-  ugglier.
+  Original message from patch below:
   
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
-
-Daniel Stenberg (31 Jul 2010)
-- ares_set_servers_csv: use ISDIGIT
+  From: Brad Spencer <bspencer@blackberry.com>
+  Date: Fri, 29 Apr 2016 14:26:23 -0300
   
-  The IS*() set of macros are preferred to the regular is*() functions as
-  they help us avoid the most common pitfalls.
-
-Ben Greear (30 Jul 2010)
-- cast arg to isdigit to int
+  On Windows, the c-ares DNS resolver tries first to get a full list of
+  DNS server addresses by enumerating the system's IPv4/v6 interfaces and
+  then getting the per-interface DNS server lists from those interfaces
+  and joining them together. The OS, at least in the way the c-ares
+  prefers to query them (which also may be the only or best way in some
+  environments), does not provide a unified list of DNS servers ordered
+  according to "current network conditions". Currently, c-ares will then
+  try to use them in whatever order the nested enumeration produces, which
+  may result in DNS requests being sent to servers on one interface
+  (hosting the current default route, for example) that are only intended
+  to be used via another interface (intended to be used when the first
+  interface is not available, for example). This, in turn, can lead to
+  spurious failures and timeouts simply because of the server address
+  order that resulted because of the enumeration process.
   
-  Looks like it might silence a warning on Netware build.
+  This patch makes the (safe?) assumption that there is no other better
+  rule to chose which interface's DNS server list should be prioritized.
+  After all, a DNS lookup isn't something "per network"; applications
+  don't look up "these DNS names on this interface and those DNS names on
+  that interface". There is a single resource pool of DNS servers and the
+  application should presume that any server will give it the "right"
+  answer. However, even if all DNS servers are assumed to give equally
+  useful responses, it is reasonable to expect that some DNS servers will
+  not accept requests on all interfaces. This patch avoids the problem by
+  sorting the DNS server addresses using the Windows IPv4/v6 routing tables.
   
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
-
-- remove all uses of uint32_t
+  For example, a request to DNS server C on interface 2 that is actually
+  sent over interface 1 (which may happen to have the default route) may
+  be rejected by or not delivered to DNS server C. So, better to use DNS
+  servers A and B associated with interface 1, at least as a first try.
   
-  Previous fix forgot a few.
+  By using the metric of the route to the DNS server itself as a proxy for
+  priority of the DNS server in the list, this patch is able to adapt
+  dynamically to changes in the interface list, the DNS server lists per
+  interface, which interfaces are active, the routing table, and so on,
+  while always picking a good "best" DNS server first.
   
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
+  In cases where any DNS server on any interface will do, this patch still
+  seems useful because it will prioritize a lower-metric route's (and thus
+  interface's) servers.
 
-- fix signed v/s unsigned casts warning in ares_gethostbyaddr.c
+David Drysdale (22 Feb 2017)
+- [Sergii Pylypenko brought this change]
+
+  docs: fixed references to ares_set_local_ip4 and ares_set_local_ip6
+
+- [Calle Wilund brought this change]
+
+  ares test: fix win32 build errors with virtual socket function tests
   
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
+  The added api requires both some typedefs not previously imported
+  into the test build + the test code did not fully deal with
+  socket differences on windows.
 
-- local-bind-fixup:  Fix inet_pton warning.
+- [Calle Wilund brought this change]
+
+  ares_process: fix return type of socket_create function (win32 warning)
+
+Daniel Stenberg (31 Jan 2017)
+- [Calle Wilund brought this change]
+
+  ares_set_socket_functions: Add man page
   
-  Conditionally include <arpa/inet.h> for inet_pton
-  headers.
+  Providing some rudimentary documentation for the added functionality
   
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
+  Closes #72
 
-- build:  Enable compiling with -Werror.
+- [Calle Wilund brought this change]
+
+  ares-test: Add test helpers and cases for virtual socket IO
   
-  This helps find compile warnings because they simply break
-  the build.
+  * Added test case macro to automatically run tests twice, once "normal",
+    once with virtual IO.
+  * Changed most "live" query tests to run in dual mode to verify
+    at least simple socket IO via virtual functions
+  * Added test case for settings/duping socket functions & callback data
+
+- [elcallio brought this change]
+
+  Implement using virtual socket IO functions when set
   
-  To use:
-  ./configure --enable-warnings --enable-werror
-  
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
+  Uses virtual socket IO functions when set on a channel.
+  Note that no socket options are set, nor is any binding
+  done by the library in this case, since the client defining
+  these is probably more suited to deal with this.
 
-- ipv6: Fix some build issues related to the local-bind feature.
-  
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
+- [elcallio brought this change]
 
-Guenter Knauf (29 Jul 2010)
-- Replaced uint32_t with unsigned int to fix broken builds on a couple of platforms.
+  Add virtual function set for socket IO
+  
+  Defines a structure of basic create, close, read/write
+  functions as virtual function calls, settable for individual
+  c-ares channels.
 
-Daniel Stenberg (18 Jul 2010)
-- [Ben Greear brought this change]
+David Drysdale (30 Jan 2017)
+- test: ignore aresfuzzname binary
 
-  local-bind:  Support binding to local interface/IPs
-  
-  Add 3 new functions to set the local binding for the out-going
-  socket connection, and add ares_set_servers_csv() to set a
-  list of servers at once as a comma-separated string.
-  
-  Signed-off-by: Ben Greear <greearb@candelatech.com>
+Gregor Jasny (14 Jan 2017)
+- [Stephen Sorley brought this change]
 
-- version: now start on 1.7.4
+  Always use check_symbol_exists instead of check_function_exists.
 
-- [Andrew C. Morrow brought this change]
+- Also add includes to TARGETS_INST_DEST
 
-  fix memory leak in ares_getnameinfo
+- [Stephen Sorley brought this change]
 
-Version 1.7.3 (11 Jun 2010)
+  Windows build fixes
 
-Daniel Stenberg (11 Jun 2010)
-- changelogs: updated for 1.7.3
+- CMake: Export targets
 
-- [BogDan Vatra brought this change]
+- CMake: Use GNUInstallDirs for install location defaults
 
-  init: allow c-ares to work on Android OS
+David Drysdale (11 Jan 2017)
+- Update Makefile.am for renamed INSTALL.md
 
-- changelog: fill in the 1.7.2 changes
+GitHub (11 Jan 2017)
+- [David Drysdale brought this change]
 
-- added another pdf to ignore
+  docs: convert INSTALL to MarkDown & tweak (#83)
 
-Yang Tse (11 Jun 2010)
-- add ares_parse_mx_reply.c to VS dsp file
+- [Gregor Jasny brought this change]
 
-Daniel Stenberg (10 Jun 2010)
-- tarball: add $(CSOURCES) $(HHEADERS) to EXTRA_DIST
+  Merge pull request #77 from stephen-sorley/cmake_modernize
   
-  It's not clear to me why we need this, but we apparently may
-  otherwise not get all files bundled in the dist tarball.
+  Updated CMake minimum version to 2.8.12.
 
-- version: start working on 1.7.3
+Stephen Sorley (4 Jan 2017)
+- Changed executables to depend directly on internal libcares target, instead of against
+  the external-facing alias targets.
 
-Version 1.7.2 (10 Jun 2010)
+- Updated Travis to pull CMake 2.8.12 from kubuntu-backports ppa.
 
-Daniel Stenberg (10 Jun 2010)
-- RELEASE-NOTES: 1.7.2 details added
+- Updated CMake minimum version to 2.8.12.
+  
+  Changed the way usage requirements (include dirs, compile defs, dependent libraries) are specified, to match the recommended standard practice for modern CMake. This involves using target-specific functions (target_include_directories, target_compile_definitions, etc.), along with the PUBLIC, PRIVATE or INTERFACE modifiers.
+  
+  Updated chain-building support to imitate new-style Find modules (import libs), instead of old-style Find modules (cache variables).
 
-- [Jakub Hrozek brought this change]
+David Drysdale (26 Dec 2016)
+- [Chris Araman brought this change]
 
-  ares_init: Last, not first instance of domain or search should win
+  configure: clock_gettime workaround (#75)
+  
+  Commits 7518c26, c41726b, and bc14ee7 brought this workaround to the CMake build system. This expands it to the autoconf build system.
+  
+  Fixes #71
 
-- style: make code less than 80 columns wide
+- test: add fuzz entrypoint for ares_create_query()
 
-Yang Tse (31 May 2010)
-- [Tor Arntsen brought this change]
+- test: Add gTest/gMock files to SOURCES
+  
+  Built tarballs are not including all of the files needed
+  to build the test suite because they are missing from the
+  <target>_SOURCES variable in Makefile.am.
 
-  improve alternative definition of bool to use enum instead of unsigned char
+- travis: Move build scripts under travis/
+  
+  Travis doesn't always propagate errors in inline multi-line
+  scripts, so move them all to be explicit shell scripts, each
+  with set -e.
 
-- fix VS2010 compiler warnings
+- travis: check distributed tarball builds
 
-Daniel Stenberg (18 Apr 2010)
-- [Jérémy Lal brought this change]
+Daniel Stenberg (25 Oct 2016)
+- dist: ship msvc_ver.inc too
+  
+  Reported-by: Bruce Stephens
+  
+  Fixes #69
 
-  added ares_parse_mx_reply
+- [Aaron Bieber brought this change]
 
-- repair the file mode
+  fix build on OpenBSD
 
-- remove all $Id$ lines
+- ares_version.h: bump, working on 1.12.1 now
 
-- remove all .cvsignore files
+GitHub (18 Oct 2016)
+- [Gregor Jasny brought this change]
 
-- spell fix
+  Merge pull request #64 from bradh352/master
   
-  reported by Gregor Jasny on the mailing list
+  Add CMake build system support to C-Ares.
 
-- [Peter Pentchev brought this change]
+Brad House (5 Oct 2016)
+- suggested PROJECT_NAME change broke chain building as it needs the magic PROJECT_NAME set in the ADD_LIBRARY for matching. Fix to make both goals work
 
-  Fix a couple of typos and grammar nits.
+- update MacOSX 10.12 detection
 
-- ignore the GPG signature files too
+- Expand XCode clock_gettime fix to include MacOS 10.12, not just iOS10
 
-- start the journey towards 1.7.2
+David Drysdale (4 Oct 2016)
+- Revert "travis: work around bug in PyCParser"
+  
+  This reverts commit a24a10a348fc00b8cfd684d91894a1df14880ea9.
 
-- no longer CVS tagging
+- travis: work around bug in PyCParser
+  
+  See https://github.com/pyca/cryptography/issues/3187
 
-- ignore generated PDFs
+Brad House (3 Oct 2016)
+- PROJECT_SOURCE_DIR instead of CMAKE_CURRENT_SOURCE_DIR as per @gjasny
 
-Version 1.7.1 (23 Mar 2010)
+- use a project name of c-ares as per @gjasny
 
-Daniel Stenberg (23 Mar 2010)
-- 1.7.1
+- Import curl conversion of Makefile.inc to cmake form dynamically as per bdoetsch@ameritech.net to make maintaining multiple build systems easier
 
-- made README the primary readme file
-  
-  ... and did README.cares to contain a historic reason etc.
+Daniel Stenberg (30 Sep 2016)
+- dist: add ares_library_initialized.* to the tarball
 
-- s/CVS/git
+David Drysdale (30 Sep 2016)
+- test: check ares_create_query with too-long name
 
-- git now, not CVS
+Daniel Stenberg (30 Sep 2016)
+- man pages: minor formatting edits
 
-- ignore lots of generated files
+Brad House (29 Sep 2016)
+- merge fc7917e from @daviddrysdale ... travis build updates for cmake
 
-- [Daniel Johnson brought this change]
+- cleanups as per @gjasny ... Use naked IF statements and use NOT DEFINED
 
-  Fix warnings for clang
+Version 1.12.0 (29 Sep 2016)
 
-Yang Tse (17 Mar 2010)
-- replaced intel compiler option -no-ansi-alias with -fno-strict-aliasing
+Daniel Stenberg (29 Sep 2016)
+- RELEASE-NOTES: 1.12.0
 
-- update outdated serial number
+- [David Drysdale brought this change]
 
-- fix compiler warning
+  ares-test-misc: test ares_create_query with escaped trailing dot
 
-- watt32 compilation fix
+- ares_create_query: avoid single-byte buffer overwrite
+  
+  ... when the name ends with an escaped dot.
+  
+  CVE-2016-5180
+  
+  Bug: https://c-ares.haxx.se/adv_20160929.html
 
-- Added another VS10 version string
+Brad House (29 Sep 2016)
+- CMake: Unify library versioning with the libtool methodology to make keeping library versions in sync easier with the autotools build system
 
-- fix line break
+Daniel Stenberg (29 Sep 2016)
+- ares_library_initialized.3: added
 
-- removed usage of 's6_addr', fixing compilation issue triggered with no
-  longer using 'in6_addr' but only our 'ares_in6_addr' struct
+- make: bump CARES_VERSION_INFO for release
 
-Daniel Stenberg (5 Mar 2010)
-- Daniel Johnson provided fixes for building with the clang compiler
+David Drysdale (29 Sep 2016)
+- man: update ares_init_options.3
 
-Yang Tse (5 Mar 2010)
-- Added IPv6 name servers support
+Daniel Stenberg (29 Sep 2016)
+- ares_library_init.3: corrected the ares_library_init_mem proto
 
-Gisle Vanem (5 Mar 2010)
-- Ops!. Readded ares_nowarn.h.
+Brad House (28 Sep 2016)
+- XCode v8 introduced clock_gettime() for iOS v10.  However, it is a weak symbol, which means when earlier iOS versions try to use clock_gettime() it results in a crash due to the missing symbol.  Detect this condition and do not set HAVE_CLOCK_GETTIME_MONOTONIC.
 
-- Added ares_nowarn.c.
+- Adds cmake build system support to C-Ares.
+  
+  The patch does not modify any source files, it only adds 3 new files
+  (CMakelists.txt, ares_build.h.cmake, ares_config.h.cmake) which form the
+  build system.  I've tried to go through as much of the autotools tests and
+  extracted what I thought was appropriate, though many of the tests aren't
+  as in-depth in CMake as they are for autotools ... it is unclear why some
+  of them exist at all, I'm guessing for legacy systems that CMake probably
+  doesn't support anyhow.
+  
+  Building the library, and examples (adig, ahost, acountry) plus installation
+  should work across a large number of tested platforms.  The tests have not
+  yet been integrated.
 
-Yang Tse (28 Feb 2010)
-- Added SIZEOF_INT and SIZEOF_SHORT definitions for non-configure systems
+Daniel Stenberg (27 Sep 2016)
+- README.md: remove space from link
 
-- Added ares_nowarn.* to VC6 project file
+- README: link to the correct c-ares badge!
+  
+  Reported-by: David Hotham
+  
+  Fixes #63
 
-- Added SIZEOF_INT definition
+- docs: minor formatting edits
 
-- fix compiler warning
+- ares_destroy.3: formatting polish
 
-- fix compiler warning
+- ares_init.3: split the init docs into two separate man pages
 
-- fix compiler warning
+- SECURITY: point to the vulnerabilities page now
 
-Daniel Stenberg (17 Feb 2010)
-- ares_reinit()
+- RELEASE-NOTES: synced with daa7235b1a5
+
+- ares_create_query.3: edit language
   
-  - To allow an app to force a re-read of /etc/resolv.conf etc, pretty much
-    like the res_init() resolver function offers
+  Tried to make the man page more readable.
 
-- - Tommie Gannert pointed out a silly bug in ares_process_fd() since it didn't
-    check for broken connections like ares_process() did. Based on that, I
-    merged the two functions into a single generic one with two front-ends.
+David Drysdale (26 Sep 2016)
+- test: fix gMock to work with gcc >= 6.x
+  
+  Taken from:
+  https://github.com/google/googletest/issues/705#issuecomment-235067917
 
-Yang Tse (30 Dec 2009)
-- VMS specific preprocessor symbol checking adjustments
+Daniel Stenberg (26 Sep 2016)
+- [Brad House brought this change]
 
-- Mention last changes
+  headers: remove checks for and defines of variable sizes
+  
+  ... they're not really used and by avoiding them in the ares_build.h
+  output we make the public header less dependent on data sizes.
 
-- - Fix configure_socket() to use ares_socket_t instead of int data type.
+David Drysdale (24 Sep 2016)
+- api: add ARES_OPT_NOROTATE optmask value
+  
+  Fix up a couple of problems with configuring whether c-ares rotates
+  between different name servers between requests.
+  
+  Firstly, ares_save_options() returns (in *optmask) the value of
+  (channel->optmask & ARES_OPT_ROTATE), which doesn't necessarily
+  indicate whether the channel is or is not actually doing rotation.
+  This can be confusing/incorrect if:
+   - the channel was originally configured without ARES_OPT_ROTATE
+     (so it appears that the channel is not rotating)
+   - the /etc/resolv.conf file includes the 'rotate' option
+     (so the channel is actually performing rotation).
+  
+  Secondly, it is not possible to reliably configure a channel
+  to not-rotate; leaving off ARES_OPT_ROTATE is not enough, since
+  a 'rotate' option in /etc/resolv.conf will turn it on again.
+  
+  Therefore:
+   - add an ARES_OPT_NOROTATE optmask value to allow explicit
+     configuration of no-rotate behaviour
+   - in ares_save_options(), report the value of channel->rotate
+     as exactly one of (optmask & ARES_OPT_ROTATE) or
+     (optmask & ARES_OPT_NOROTATE).
+  
+  In terms of back-compatibility:
+   - existing apps that set ARES_OPT_ROTATE will continue to rotate,
+     and to have ARES_OPT_ROTATE reported back from ares_save_options()
+   - existing apps that don't set ARES_OPT_ROTATE will continue to
+     use local config/defaults to decide whether to rotate, and will
+     now get ARES_OPT_ROTATE or ARES_OPT_NOROTATE reported back from
+     ares_save_options() rather than 0.
 
-- - Where run-time error checks enabling compiler option /GZ was used it is now
-    replaced with equivalent /RTCsu for Visual Studio 2003 and newer versions.
+- ares_init_options: only propagate init failures from options
   
-  - Compiler option /GX is now replaced with equivalent /EHsc for all versions.
+  Commit 46bb820be3a8 ("ares_init_options: don't lose init failure")
+  changed init behaviour so that earlier errors in initialization
+  weren't lost.  In particular, if the user passes in specific
+  options but they are not applied (e.g. because of an allocation
+  failure), that failure needs to be reported back to the user; this
+  also applies when duplicating a channel with ares_dup().
+  
+  However, other initialization failures can be ignored and
+  overridden -- in particular, if init_by_resolv_conf() or
+  init_by_environment() fail, then falling back to default values
+  is OK.
+  
+  So only preserve failures from the init_by_options() stage, not
+  from all initialization stages.
+  
+  Fixes issue 60.
 
-- - Ingmar Runge noticed that Windows config-win32.h configuration file
-    did not include a definition for HAVE_CLOSESOCKET which resulted in
-    function close() being inappropriately used to close sockets.
+- test: Force reinstall of libtool on OSX
+  
+  Travis build environment appears to have changed.
 
-Daniel Stenberg (30 Nov 2009)
-- start working on 1.7.1
+- test: Add valgrind build variant
 
-Version 1.7.0 (27 Nov 2009)
+- test: Add null pointer to gtest args
+  
+  GoogleTest assumes that there is a null pointer in argv[argc],
+  so make it look like that. Without this change, tests run with
+  command-line arguments get memory errors under valgrind/ASAN.
 
-Yang Tse (27 Nov 2009)
-- Preserve empty line following last target
+Daniel Stenberg (21 Aug 2016)
+- AUTHOR: maybe gitgub isn't really an author =)
 
-- - Larry Lansing fixed ares_parse_srv_reply to properly parse replies
-    which might contain non-SRV answers, skipping over potential non-SRV
-    ones such as CNAMEs.
+- AUTHORS: added contributors from the git log
 
-- When using icc, compile with -fpic and link with intel dynamic libraries.
+- LICENSE.md: add a stand-alone license file
+  
+  Just the MIT license used in the top the source files moved out to a
+  stand-alone file for easier reference and discovery.
 
-- Added 'currently' in italics to insist on transient situation.
+- README: added "CII best practices" badge
 
-- Fix language
+- SECURITY.md: suggested "security process" for the project
 
-- Daniel wants upcoming release to be 1.7.0
+David Drysdale (17 Aug 2016)
+- test: Add Clang static analysis build to Travis
+  
+  Run scan-build over the library source code, but skip the
+  tests.  Needs a later Clang install in Travis
 
-- Mention last changes
+- test: more info on how to run fuzz testing
 
-- - Removed from external interface preprocessor symbol definition for
-    CARES_HAVE_ARES_FREE_DATA. Current functionality of ares_free_data()
-    makes it unnecessary.
+- test: make fuzzer driver code C not C++
 
-- Added README.msvc
+- test: fuzzer mode for AFL's persistent mode
+  
+  When fuzzing with AFL, if the LLVM-based instrumentation is
+  used (via the afl-clang-fast wrapper), then it is possible to
+  have a single execution of the fuzzer program iterate multiple
+  times over the fuzzing entrypoint (similar to libFuzzer's normal
+  mode of execution) with different data.  This is much (e.g. 10x)
+  faster.
+  
+  Add code to support this, by checking whether __AFL_LOOP is
+  defined at compile-time.
+  
+  Also, shift the code to effectively be C rather than C++.
 
-- Changed c-ares naming conventions when using MSVC as described in README.msvc
+- test: simplify deps for fuzzer entrypoint
+  
+  No need to depend on the rest of the test code (ares-test.h) for
+  the fuzzer entrypoint; this makes the entrypoint slightly simpler
+  to build with LLVM's libFuzzer.
+  
+  Also shift the code to effectively be C rather than C++
 
-- - Mention other recent changes
+- test: disable MinGW tests
+  
+  The test binary built in the MinGW build is failing for some
+  reason.  It works for me when I build locally, so I'm guessing
+  it's down to some sort of AppVeyor environment issue.
+  
+  Disable for now.
 
-- - Jakub Hrozek renamed addrttl and addr6ttl structs to ares_addrttl and
-    ares_addr6ttl in order to prevent name space pollution, along with
-    necessary changes to code base and man pages.This change does not break
-    ABI, there is no need to recompile existing applications. But existing
-    applications using these structs with the old name will need source code
-    adjustments when recompiled using c-ares 1.6.1.
+Daniel Stenberg (16 Aug 2016)
+- read_tcp_data: remove superfluous NULL check
+  
+  CID 56884 by Coverity. The pointer is already derefenced before this
+  point so it can't be NULL here anyway.
 
-- - Jakub Hrozek fixed more function prototypes in man pages to sync them
-    with the ones declared in ares.h
+- web: http => https
 
-- Make configure remove the ares_build.h file included in distribution tarballs.
+GitHub (20 Jul 2016)
+- [David Drysdale brought this change]
 
-- Fix macro redefinition.
+  Merge pull request #59 from fuze/master
+  
+  Update msvc_ver.inc for VS2015 Update 3
 
-- Fix name space pollution.
+- [Chris Araman brought this change]
 
-- Allow using different extra import libraries for debug and release builds.
+  Update msvc_ver.inc
+  
+  support Visual Studio 2015 Update 3
 
-- Add manifest stuff to msvc makefile
+David Drysdale (2 May 2016)
+- Fix trailing comment for #endif
 
-- Sync man page with reality
+Daniel Stenberg (30 Apr 2016)
+- email: use Gisle's "new" address
 
-- Add missing external API decoration for ares_set_socket_callback()
+David Drysdale (18 Apr 2016)
+- test: drop superfluous fuzz inputs
+  
+  Where there are multiple fuzz input files that only differ in
+  the first two bytes (the query ID), just keep the first such
+  file.
 
-- Add ares_free_data() man page.
+svante karlsson (15 Apr 2016)
+- Update msvc_ver.inc
+  
+  support Visual Studio 2015 Update 2
 
-- - Provide in external interface preprocessor symbol definitions for
-    CARES_HAVE_ARES_FREE_DATA as an indication of function availability.
+David Drysdale (31 Mar 2016)
+- test: Run fuzzcheck.sh in Travis build
 
-- Remove typecast
+- test: add fuzzing check script to tests
+  
+  Add a test script that runs the fuzzing command over the
+  corpus of DNS packets.  This doesn't actually do any fuzzing
+  (it just runs them as inputs without generating any variations)
+  but it does ensure that the fuzzing entrypoint is still working.
 
-- Fix comment
+- test: allow multiple files in aresfuzz command line
+  
+  If no arguments are specified, use stdin as input.
+  Otherwise treat each argument as a filename and feed
+  its contents to the fuzz entrypoint.
 
-- Add ares_data.c and ares_data.h
+- test: Add corpus of DNS packets
+  
+  For fuzz testing it is useful to start from a corpus of valid
+  packets, so fill out the test/fuzzinput/ directory with a bunch
+  of inputs.
+  
+  These packets were generated by temporarily modifying the c-ares
+  process_answer() function to save off any incoming response messages.
 
-- Jakub Hrozek modified ares_parse_srv_reply() and ares_parse_txt_reply() API
-  to return a linked lists of results. These were also modified to internally
-  use the ares_data memory struct and as such its result must be free'ed with
-  ares_free_data().
+- test: Add utility to show DNS packet from file
 
-- Initial support for the generic ares_free_data() function that will allow
-  applications to free memory allocated and returned by some c-ares funtions.
+- [nordsturm brought this change]
 
-- Make usage of calloc()'s arguments consistent with rest of code base
+  Fix nsort initialization
+  
+  Author: Alexander Drachevskiy
+  http://c-ares.haxx.se/mail/c-ares-archive-2014-07/0004.shtml
+  http://c-ares.haxx.se/mail/c-ares-archive-2014-07/0014.shtml
 
-- workaround icc 9.1 optimizer issue
+- test: Check setting nsort=0 option is respected
 
-- Add icc fvisibility bug test
+- test: Update fuzzing function prototype
+  
+  libFuzzer changed expected return type from void to int
+  in LLVM 3.8.
 
-- Fix icc 9.0 compiler warning: external definition with no prior declaration
+- Explicitly clear struct servent before use
+  
+  On a build where MSAN has been manually set up (which involves
+  using an MSAN-instrumented version of the standard C++ library, see
+  https://github.com/google/sanitizers/wiki/MemorySanitizerLibcxxHowTo)
+  there's a warning about use of uninitialized memory here.  It
+  might be a false positive, but the fix is trivial so include it.
 
-- Fix three var names
+- test: for AF_UNSPEC, return CNAME only for AAAA, but valid A record
+  
+  Also shuffle expected responses rsp6/rsp4 into the order they will occur.
 
-- Add check for assert.h header file
+- [Chris Araman brought this change]
 
-- getaddrinfo is fully thread safe on solaris versions which
-  implement the function even when h_errno is not a macro.
-  
-  The h_errno macro test now only done on systems for which there
-  is no hard coded knowledge about getaddrinfo's thread safeness.
+  msvc_ver.inc: support Visual Studio 2015 Update 1
 
-- Remove files generated on previous buildconf/configure run
+- build: commonize MSVC version detection
+  
+  Remove the need to copy/paste version number mapping between
+  Makefile.msvc and test/Makefile.msvc.
 
-- Remove enable-thread / disable-thread configure option. These were only placebo
-  options. The library is always built as thread safe as possible on every system.
+- test: Use different name in live test
 
-- Refactor how preprocessor symbol _THREAD_SAFE definition is done.
+- test: Only pass unused args to GoogleTest
 
-- Assume that getaddrinfo is thread safe, unless hard coded
-  knowledge says the contrary or h_errno is not defined.
+- ahost.c: add cast to fix C++ compile
+  
+  If ahost.c is force-compiled as C++ the missing cast from
+  (void *) to (char **) is problematic.
 
-- Related with the threadsafe capability of getaddrinfo:
+- ares_library_cleanup: reset ares_realloc too
   
-  - Constantine Sapuntzakis reported that Darwin 6.0 a.k.a. MAC OS X 10.2
-    and newer have a threadsafe getaddrinfo.
+  Otherwise a subsequent use of the library might use a previous
+  incarnation's realloc() implementation.
+
+Daniel Stenberg (9 Mar 2016)
+- [Brad House brought this change]
+
+  configure: check if tests can get built before enabled
   
-  - Fix Dragonfly BSD triplet detection.
+  The current approach for disabling tests is not a good solution because
+  it forces you to pass --disable-tests, rather than auto-detect if your
+  system can support the tests in the first place.  Many (most?) systems
+  do not have C++11.  This also causes issues when chain-building c-ares,
+  the hosting system needs to be updated to support passing this
+  additional flag if necessary, it doesn't seem reasonable to add this
+  requirement which breaks compatibility.
   
-  - In case the hard-coded knowledge says that getaddrinfo is threadsafe,
-    an additional check is done to verify that h_errno is also defined.
-    If h_errno isn't defined, we finally assume that it isn't threadsafe.
-    Jamie Lokier provided the inspiration for this extra check.
+  This change auto-detects if the system can build the tests and
+  automatically disable them if it cannot.  If you pass --enable-tests to
+  configure and the system cannot build them either due to lack of system
+  support, or because cross-compilation is being used, it will throw an
+  appropriate error since the user indicated they really did want the
+  tests.
 
-- AIX 5.2 and newer have threadsafe getaddrinfo.
+David Drysdale (3 Mar 2016)
+- [Viktor Szakats brought this change]
+
+  Makefile.m32: add support for CROSSPREFIX
+
+- [Viktor Szakats brought this change]
+
+  Makefile.m32: add support for extra flags
   
-  Add some comments to better understand what the regex's pretend to achieve.
+  Allow specification of CARES_{LD,C}FLAG_EXTRAS envvars
+  for mingw
 
-- HP-UX 11.11 and later have threadsafe getaddrinfo
+- test: Build with MinGW on AppVeyor
 
-- Check if getaddrinfo is threadsafe when function check allows it to be used
+- test: avoid in6addr_* constants
+  
+  These aren't available on MinGW, so use explicit addresses instead.
 
-- Renamed fpGetNetworkParams and fpSystemFunction036 to avoid namespace pollution with static library
+- test: add missing #includes for dns-proto.cc
 
-- Add kernel32.lib
+- [Gregor Jasny brought this change]
 
-- Mention last changes
+  Fix man page typos detected by Lintian
 
-- Reinstate copyright symbol lost in previous commit
+Daniel Stenberg (19 Feb 2016)
+- configure: acknowledge --disable-tests
+  
+  Fixes #44
 
-- Make some strings different in resource file for debug or release builds
+- AUTHORS: added contributors from the 1.11.0 release
 
-- Ignore more subdirs
+- bump: start working on the next version
 
-- Fix compiler warning: conditional expression is constant
+Version 1.11.0 (19 Feb 2016)
 
-- Sync linker and resource compiler options with Makefile.msvc
+Daniel Stenberg (19 Feb 2016)
+- RELEASE-NOTES: final edits for 1.11.0
 
-- Follow Makefile.msvc subdirectory naming scheme, and sync compiler options
+David Drysdale (15 Feb 2016)
+- ares_dup.3: remove mention of nonexistent function
+  
+  ares_dup_options() doesn't exist, so don't document it.
 
-- Updated MSVC makefile that allows building dynamic and static
-  c-ares libraries in debug and release flavours.
+- test: skip repeated build steps
   
-  Additionally each of the three sample programs is built against
-  each of the four possible c-ares libraries, generating all this
-  a total number of 12 executables and 4 libraries.
-
-- Test for USE_WINSOCK since it is more restrictive than WIN32
-
-- Make header inclusion depend on HAVE_*_H definition
-
-- Remove unneeded preprocessor directives
-
-- Adjust c-ares include paths for memory tracking enabled (--enable-curldebug) builds
+  Top-level buildconf/configure now triggers for the
+  test/ subdir too, so don't need to do explicitly.
 
-- source files used by sample programs
+- test: namespaces unavailable when cross-compiling
 
-- Renamed c-ares setup.h to ares_setup.h
+Daniel Stenberg (13 Feb 2016)
+- configure: only run configure in test when NOT cross-compiling
+  
+  ... as the tests won't run cross-compiled anyway
 
-- Adjust include paths to take in account that currently:
+David Drysdale (13 Feb 2016)
+- test: prefer ON_CALL to EXPECT_CALL to reduce flakes
   
-  c-ares with --enable-curldebug uses memdebug.h from libcurl's lib subdirectory.
+  For UDP tests, there's a chance of a retry.  EXPECT_CALL only
+  expects a single request to arrive at the server; ON_CALL allows
+  for a UDP retry and repeats the same answer.
   
-  memdebug.h needs access to libcurl's setup.h from libcurl's lib subdirectory
-  and also needs access to libcurl's generated curl_config.h
+  Note that ON_CALL and EXPECT_CALL can't be mixed in the same
+  test, and that tests that have a varied sequence of responses
+  for the same repeated request still have to use EXPECT_CALL.
 
-- Undo old temporary change once used for testing purposes
+Daniel Stenberg (13 Feb 2016)
+- configure: run configure in 'test' too
+  
+  Having the test dir completely stand-alone causes too many issues for
+  users and devs. It still needs to be built specifically.
 
-- Mention many changes
+- configure: build silently by default
 
-- Mention --enable-symbol-hiding configure option
+- buildconf: run test/buildconf too if present
 
-- Symbol hiding configure options renamed to the hopefully less ambiguous
-  --enable-symbol-hiding and --disable-symbol-hiding as well as related
-  macro names and some internal variables used for them.
-  
-  Related configuration file preprocessor symbols named to
-  CARES_SYMBOL_HIDING and CARES_SYMBOL_SCOPE_EXTERN.
+- test/configure: build silently by default
 
-- Header inclusion depending on HAVE_* symbol.
-  Fix two typos.
+- [Gregor Jasny brought this change]
 
-- Comparison of the Initial revision of this file with ares_parse_a_reply.c
-  shows that this one is actually a modified copy of ares_parse_a_reply.c.
+  dist: Distribute README.md
   
-  In order to comply with ares_parse_a_reply.c's M.I.T. license, the old
-  1998 M.I.T. copyright notice is now also preserved in this file the same
-  as it is done in other ares_parse_*.c files.
+  Closes #42
 
-- Add CVS Id tag.
-  Fix identation of some license lines.
+Version 1.11.0 (11 Feb 2016)
 
-- Add CVS Id tag.
+Daniel Stenberg (11 Feb 2016)
+- Makefile.am: distribute the test dir too
 
-- Fix comment
+- RELEASE-NOTES: synced with 385582bd14b68a
 
-- In no particular order, changed/fixed all of the following in
-  ares_parse_txt_reply() current version:
+- [Nicolas \"Pixel\" Noble brought this change]
+
+  ares_win32_init: make LoadLibrary work when using UNICODE too
   
-  - Fixed a couple of potential double free's.
+  Closes #17
+
+David Drysdale (11 Feb 2016)
+- Use "resolve" as synonym of "dns" in nsswitch.conf
   
-  - Fixed memory leaks upon out of memory condition.
+  Modern Linux systems may have libnss_resolve from systemd as the
+  resolver, which is then configured in /etc/nsswitch.conf with
+  the "resolve" keyword rather than "dns".
   
-  - Fixed pointer arithmetic.
+  Fixes #33
+
+- ares_set_socket_callback: make manpage match code
   
-  - Setting ntxtreply to zero upon entry for all failure cases.
+  The code in ares_process.c that invokes the socket creation/connection
+  callback only checks for rc < 0, not for standard ares error codes.
+
+- Merge pull request #36 from AGWA-forks/master
   
-  - Changed data type to size_t for variables substr_len, str_len and
-    the length member of ares_txt_reply struct.
+  Add ares_set_socket_configure_callback()
+
+- test: Update init tests to match behaviour
   
-  - Avoided a couple of memcpy() calls.
+  Unreadable config files are now treated the same way
+  as absent config files.
+
+- [Fedor Indutny brought this change]
+
+  Ignore `fopen` errors to use default values
   
-  - Changed i data type to unsigned int to prevent compiler warnings.
+  After 46bb820be3a83520e70e6c5f0c5133253fcd69cd `init_by_resolv_conf`
+  errors are no longer swallowed in `ares_init_options`. This has exposed
+  a previously unknown bug in `lookups` initialization code.
   
-  - Adjusted a comment.
+  If there is no lookup configuration in `resolv.conf`,
+  `init_by_resolv_conf` will attempt to read it from other files available
+  on the system. However, some of these files may have restricted
+  permissions (like `600`), which will lead to `EACCESS` errno, which in
+  turn is handled like a fatal error by `init_by_resolv_conf`.
   
-  - Use ARES_SUCCESS literal for successfull completion.
+  However, it sounds illogical that this error should be handled as a
+  fatal. There is a `init_by_defaults` call that overrides `lookups` with
+  default value, and certainly possible absence of lookup information is
+  the reason why this function exists in a first place!
   
-  - Added CVS Id tag.
-
-- Add c-ares DLL resource file to distribution archive
-
-- ignore files
+  I suggest handling any `fopen` errors as non-fatal ones, allowing to
+  pick up the `lookups` value from different config files, or to pick up
+  default value.
 
-- Empty subdir
+Andrew Ayer (9 Feb 2016)
+- Document callback type in man page for ares_set_socket_callback
 
-- Updated MSVC 6.0 workspace and project files that allows building
-  dynamic and static c-ares libraries in debug and release flavours.
+- Add ares_set_socket_configure_callback()
   
-  Additionally each of the three sample programs is built against
-  each of the four possible c-ares libraries, generating all this
-  a total number of 12 executables and 4 libraries.
+  This function sets a callback that is invoked after the socket is
+  created, but before the connection is established.  This is an ideal
+  time to customize various socket options.
 
-Daniel Stenberg (29 Oct 2009)
-- no need to check for NULL pointers before dereferencing, as the pointers
-  MUST be valid and they are dereferenced further down in the function
-  unconditionally!
+David Drysdale (9 Feb 2016)
+- test: ares_set_socket_callback failure behaviour
 
-- shorten the descriptions somewhat
+- test: Check ares_parse_txt_reply_ext() entrypoint
 
-- update to the new struct name
+- [Fedor Indutny brought this change]
 
-- Jakub Hrozek added ares_parse_txt_reply() for TXT parsing
+  txt: introduce `ares_parse_txt_reply_ext`
+  
+  Introduce `ares_txt_ext` structure with an extra `record_start`
+  field, which indicates a start of a new TXT record, thus allowing to
+  differentiate the chunks in the same record, from a chunks in a
+  different record.
+  
+  Introduce a new API method: `ares_parse_txt_reply_ext` that works with
+  this kind of struct.
 
-- use 'ares_srv_reply' for proper name-spacing
+- doc: Update missed repo references
 
-Yang Tse (29 Oct 2009)
-- Add reference for ares_parse_srv_reply.pdf
+- doc: Update docs on contributing
 
-- Add reference for ares_parse_srv_reply docs
+- test: Run command line tools in Travis
+  
+  Do a quick execution of each of the command line tools
+  in the continuous integration build, so that any (say)
+  sanitizer failures show up.
 
-- External API function linkage decoration adjustment
+- acountry: drop inert test
+  
+  If ver_1 is true, then z0 and z1 must both be 'z', and so
+  (z0 != 'z' && z1 != 'z') can never be true.
+  
+  CID 56879, pointed out by Coverity.
 
-- External API function linkage decoration adjustment
+- doc: update badge locations to master repo
 
-- Initial step towards the ability to reduce c-ares exported symbols
-  based on the 'visibility' attribute for GNUC and __global for Sun
-  compilers, taking also in account __declspec function decoration
-  for Win32 and Symbian DLL's.
-  
-  Introducing configure options --enable-hidden-symbols and
-  --disable-hidden-symbols following libcurl's naming.
+- test: Enable maintainer mode + debug in Travis
 
-- Fix comment
+- test: Add an iOS build target
 
-- Fix spelling
+- test: Ignore SIGPIPE in tests
 
-- Fix Pelles C Win32 target compilation issues
+- test: More initialization tests
 
-- John Engelhart noticed an unreleased problem relative to a duplicate
-  ARES_ECANCELLED error code value and missing error code description.
+- test: Improve containerized test mechanism
+  
+  Aim is to ensure that code coverage information can escape the
+  container.  To do this:
+   - Enter a new mount namespace too, so that we can...
+   - Bind mount the expected source directory into the container
+   - Share memory with the sub-process so coverage information is
+     shared too.
 
-- Fix compiler warning: local variable may be used without having been initialized
+- test: Make contained tests easier to write
 
-- Use *_CHECK_PATH_SEPARATOR_REQUIRED to ensure that *_CHECK_PATH_SEPARATOR
-  is only expanded and included once in the configure script.
+- test: Add framework for containerized testing
+  
+  On Linux we can potentially use user and UTS namespaces to run  a test
+  in a pseudo-container with:
+   - arbitrary filesystem (e.g. /etc/resolv.conf, /etc/nsswitch.conf, /etc/hosts)
+   - arbitrary hostname/domainname.
+  
+  Include a first pass at the framework code to allow this, along with a
+  first test case that uses the container.
 
-- Our _AS_PATH_SEPARATOR_PREPARE override is now m4_defun'd instead of m4_define'd
-  due to autoconf 2.64 m4_require'ing it in _AS_SHELL_SANITIZE indirectly through
-  _AS_PATH_WALK.
+- test: Use a longer timeout for less flakiness
+  
+  Having occasional test failures from timeout before multiple
+  queries can complete, so up the default timeout for the test
+  from 100ms to 1500ms.
 
-- Fix compiler warning: argument is incompatible with corresponding format string conversion
+- test: Make failure tests more robust
+  
+  Different platforms will do different numbers of allocations
+  in the processing of a given API call; just check that the
+  return code is either success or ENOMEM, and free off any
+  returned state in the former case.
+  
+  Also cope with ECONNREFUSED as well as ENOTFOUND.
 
-- Fix potential out-of-bounds read
+- test: Get test code building under Windows
+  
+   - Initial nmake file based off library nmake file
+   - Cast socket call arguments to (char *)
+   - Use wrapper sclose() that maps to closesocket() or close()
+   - Build a config.h indicating presence of headers
+   - Conditionally include netdb.h
+   - Remove unnecessary include of sys/socket.h
+   - Force longer bitmask for allocation failure tracking
+   - Call WSAStartup() / WSACleanup() in main()
+   - Set TCP_NODELAY for mock server
+   - Turn on tests in AppVeyor build
 
-- Fix compiler warning: loop without body
+- test: Disable tests that manipulate env on Windows
 
-- Fix compiler warning
+- test: Move file lists into Makefile.inc
+  
+  In preparation for a Win32 build of the test suite.
 
-- Fix compiler warning
+- test: Add a simple multi-server test
+  
+  Check rotate option does something
 
-- Fix compiler warning
+- test: Allow for multiple mock servers
+  
+   - Update the MockServer to allow separate specification of
+     UDP and TCP ports
+   - Have an array of mock servers listening on consecutive
+     sets of ports.
+   - Rename Process(fd) to ProcessFD(fd) to avoid confusion.
+   - Initialize channel by using the new ares_set_servers_ports()
+     entrypoint, so multiple ports on the same loopback address
+     can be used.
 
-- Fix compiler warning: addition result could be truncated before cast to bigger sized type
+- test: Update test for set/get_servers variants
+  
+  Ports are significant in the _ports_ variant functions, so update test to cope.
 
-- Overhauled ares__get_hostent()
+- test: Make GetNameServers() utility function port-aware
   
-  - Fixing out of bounds memory overwrite triggered with malformed /etc/hosts file.
-  - Improving parsing of /etc/hosts file.
-  - Validating requested address family.
-  - Ensuring that failures always return a NULL pointer.
-  - Adjusting header inclusions.
+  Also make it generally available.
 
-- Fix ssize_t redefinition errors on WIN64 reported by Alexey Simak
+- test: more testing, including of internal static functions
 
-- more files to ignore
+- test: more tests, especially fallback processing
+  
+   - Make mock server listen on UDP + TCP in parallel.
+   - Test UDP->TCP fallback on truncation
+   - Test EDNS->no-EDNS fallback
+   - Test some environment init options
+   - Test nonsense reply
+  
+  test: short response
 
-- Check if _REENTRANT definition is required to
-  make errno available as a preprocessor macro.
+- test: more tests, particularly of initialization
 
-- Attempt to silence bogus compiler warning: "Potential null pointer dereference"
+- test: Run mock tests over both TCP and UDP
+  
+  With the exception of a few tests that make use of the timed
+  retry aspect of UDP.
 
-- ignore more files
+- test: Run mock tests over both IPv4 and IPv6
 
-Gisle Vanem (7 Sep 2009)
-- Suppress warnings about unused prototypes in Watt32 and Win32 programs.
+- test: Add more tests for edge cases
 
-- Update email address.
+- test: more nooks and crannies of pton functions
 
-- Update my email address. Add ares_config.h as dependency for 'make depend'.
+- test: More tests for PTR parsing
 
-Yang Tse (6 Sep 2009)
-- T_SRV portability check
+- test: Use of HOSTALIAS environment variable
 
-Gunter Knauf (5 Sep 2009)
-- changed includes to match style how we do with all other *.c files.
+- test: Add RAII utility classes for testing
+  
+   - TempFile holds specific contents
+   - EnvValue sets an environment variable
 
-- changed u_int16_t to unsigned short because it is the only place within ares and curl where such a type would be used;
-  also it broke many autobuilds. We should probably introduce an ares_port_t if we want to use a type here.
+- test: More search domain scenarios
 
-Gisle Vanem (5 Sep 2009)
-- Replace 'uint16_t' with 'u_int16_t' since the latter is used in ares.h.
+- test: Remove duplicate flags from Makefile.am
 
-- Added 'ares_parse_srv_reply.obj'. Added definition of 'u_int16_t'. This is I don't like; we should not depend on such non-universal types in a public header. But this is just a quick fix.
+- test: Make test code leak-free
 
-Daniel Stenberg (4 Sep 2009)
-- - Jakub Hrozek added ares_parse_srv_reply() for SRV parsing
+- test: More tests
+  
+   - test use of sortlist
+   - test gethostbyname(AF_UNSPEC)
 
-Steinar H. Gunderson (27 Aug 2009)
-- Support lookup of IPv4 literals in ares_gethostbyname(), even when the address family is set to AF_INET6.
+- test: Test ares_gethostbyname_file()
 
-Gisle Vanem (3 Aug 2009)
-- Remove call to LoadLibrary(). (leftover from debugging).
+- test: Add more tests of ares_getnameinfo()
 
-- Fix bad sentence.
+- test: Tweak tests, add alloc failure test
 
-Daniel Stenberg (3 Aug 2009)
-- - Timo Teras changed the reason code used in the resolve callback done when
-    ares_cancel() is used, to be ARES_ECANCELLED instead of ARES_ETIMEOUT to
-    better allow the callback to know what's happening.
+- test: Test init with options
 
-- - Joshua Kwan fixed the init routine to fill in the defaults for stuff that
-    fails to get inited by other means. This fixes a case of when the c-ares
-    init fails when internet access is fone.
+- test: More tests
+  
+   - ares_inet_net_pton() variants
+   - ares_getsock() variants
 
-Gunter Knauf (16 Jul 2009)
-- test if adding ../lib to includes can fix the current break ...
+- test: Expose ProcessWork() function
 
-- renamed generated config.h to ares_config.h in order to avoid clashes when libcurl is used with other projects which also have a config.h.
+- test: More parsing tests
+  
+  Including:
+   - Split each parse function test set out into separate files.
+   - Add an allocation failure test for each parsing function.
+   - Add error check test for each parsing function.
 
-Yang Tse (21 Jun 2009)
-- Refactor how libraries are checked for connect() function, follow-up.
+- test: Add various additional tests
 
-- Refactor how libraries are checked for connect() function,
-  and check for connect() as it is done for other functions.
+- test: More tests
+  
+  Include tests of internal functions, based on the value of the
+  CARES_SYMBOL_HIDING macro; need to configure the library with
+  --disable-symbol-hiding to enable these tests.
 
-Gisle Vanem (20 Jun 2009)
-- Remove unneeded defines.
+- test: Allow command line override of mock server port
 
-- Use select_s() and not select().
+- test: Add README.md documentation
 
-Yang Tse (19 Jun 2009)
-- sclose() function-like macro definition used to close a socket,
-  now solely based on HAVE_CLOSESOCKET and HAVE_CLOSESOCKET_CAMEL
-  config file preprocessor definitions.
+- test: Temporarily avoid latest Python requests package
+  
+  Currently get error from Travis on this install step, and downgrading one
+  version appears to fix the problem.
+  
+  "Could not find any downloads that satisfy the requirement pyOpenSSL>=0.13
+  (from requests[security])"
 
-- add CloseSocket camel case function check
+- test: Add AppVeyor config file for Windows build
 
-- check for socket() and closesocket() as it is done for other functions
+- test: Add configuration for a Travis build
+  
+  Cover Linux & OSX on the container infrastructure, but install
+  a later G++ to satisfy the tests' need for C++11.
+  
+  Use a build matrix to include a variety of build variants:
+   - ASAN
+   - UBSAN
+   - LSAN
+   - Coverage via coveralls.io
+  
+  test: invoke ASAN and coverage in Travis build
+  
+  Also shift to use explicit build matrix
+  
+  test: Use coveralls.io for coverage tracking
+  
+  test: Add a build with UBSAN
+  
+  Also expand and re-order the setting of environment variables
+  for easier modification.
+  
+  test: Add LSAN build to Travis config
 
-- Remove HAVE_CONFIG_H definition from here,
-  CFLAGS from common.dj already defines it.
+- test: Add initial unit tests for c-ares library
+  
+  The tests are written in C++11, using the GoogleTest and GoogleMock
+  frameworks.  They have their own independent autoconf setup, so that
+  users of the library need not have a C++ compiler just to get c-ares
+  working (however, the test/configure.ac file does assume the use of
+  a shared top-level m4/ directory).  However, this autoconf setup has
+  only been tested on Linux and OSX so far.
+  
+  Run with "./arestest", or "./arestest -v" to see extra debug info.
+  The GoogleTest options for running specific tests are also
+  available (e.g. "./arestest --gtest_filter=*Live*").
+  
+  The tests are nowhere near complete yet (currently hitting around
+  60% coverage as reported by gcov), but they do include examples
+  of a few different styles of testing:
+  
+   - There are live tests (ares-test-live.cc), which assume that the
+     current machine has a valid DNS setup and connection to the
+     internet; these tests issue queries for real domains but don't
+     particularly check what gets returned.  The tests will fail on
+     an offline machine.
+  
+   - There a few mock tests (ares-test-mock.cc) that set up a fake DNS
+     server and inject its port into the c-ares library configuration.
+     These tests allow specific response messages to be crafted and
+     injected, and so are likely to be used for many more tests in
+     future.
+  
+      - To make this generation/injection easier, the dns-proto.h file
+        includes C++ helper classes for building DNS packets.
+  
+   - Other library entrypoints that don't require network activity
+     (e.g. ares_parse_*_reply) are tested directly.
+  
+   - There are few tests of library-internal functions that are not
+     normally visible to API users (in ares-test-internal.cc).
+  
+   - A couple of the tests use a helper method of the test fixture to
+     inject memory allocation failures, using the earlier change to the
+     library to allow override of malloc/realloc/free.
+  
+   - There is also an entrypoint to allow Clang's libfuzzer to drive
+     the packet parsing code in ares_parse_*_reply, together with a
+     standalone wrapper for it (./aresfuzz) to allow use of afl-fuzz
+     for further fuzz testing.
 
-- initial step towards decoupling c-ares from libcurl for DOS
+- test: Add local copy of GoogleMock/GoogleTest 1.7.0
+  
+  Don't check in gtest/m4 files, as they are unused and interfere
+  with the top-level configure process.
 
-- don't ignore these subdirs, they must be removed first
+- doc: Show build badges in README.md
+  
+  Note that these URLs will need to be updated if/when the test branch
+  gets pulled into the master repo/branch.
 
-- Remove DEBUGBUILD symbol definition, is not required for programs using the library.
+- doc: Convert README to README.md
+  
+  Gives better display on GitHub
 
-- DEBUGBUILD symbol definition for debug builds
+- doc: Update in preparation for next release
+  
+  Assume 1.11.0 is next (as there are various API additions).
+  Also add myself to AUTHORS.
 
-- ignore some subdirs
+- build: Allow header compilation by Windows C++ compiler
 
-- fix comment
+- build: Expose whether symbol hiding is on
+  
+  Adding the CARES_SYMBOL_HIDING definition allows the test suite to
+  detect whether internal symbols are available or not.
 
-- Try to make more clear that --enable-curldebug has nothing to do with --enable-debug for this library.
+- build: Add autoconf macros for C++11 code using pthreads
+  
+  Pull in testing macros from the GNU autoconf archive to allow
+  configure scripts to test for and setup use of a C++11 compiler
+  (AX_CXX_COMPILE_STDCXX_11) and the pthreads library (AX_PTHREAD).
+  
+  Note that these macros are not used by the main library autoconf,
+  just by the tests (which share the same m4/ directory).
 
-- Revert last change, it is inappropriate.
+- build: Add a code coverage option
+  
+  Configure with:
+    ./configure --enable-code-coverage
+  Show coverage output with:
+    make code-coverage-capture
+  
+  Built on m4/ax_code_coverage.m4 from the GNU autoconf archive
+  to provide the macros to check for presence of gcov + lcov;
+  upstream macro modified to:
+   - Remove use of $(AM_DEFAULT_VERBOSITY) , as earlier versions of
+     autoconf (such as the one used by default on Travis) do not have this.
+   - Rather than automatically defining CODE_COVERAGE_RULES to be a set
+     of makefile rules that use ifeq/endif (which is GNU make-specific),
+     instead only define CODE_COVERAGE_RULES if coverages is turned on,
+     and in that case don't use conditionals in the makefile.
 
-Gisle Vanem (12 Jun 2009)
-- Replace CURLDEBUG with DEBUGBUILD.
+- api: Add entrypoints to allow use of per-server ports
+  
+  Add user-visible entrypoints ares_{get,set}_servers_ports(3), which
+  take struct ares_addr_port_node rather than struct ares_addr_node.
+  This structure includes a UDP and TCP port number; if this is set
+  to zero, the channel-wide port values are used as before.
+  
+  Similarly, add a new ares_set_servers_ports_csv(3) entrypoint, which
+  is analogous to ares_set_servers(3) except it doesn't ignore any
+  specified port information; instead, any per-server specified port
+  is used as both the UDP and TCP port for that server.
+  
+  The internal struct ares_addr is extended to hold the UDP/TCP ports,
+  stored in network order, with the convention that a value of zero
+  indicates that the channel-wide UDP/TCP port should be used.
+  
+  For the internal implementation of ares_dup(3), shift to use the
+  _ports() version of the get/set functions, so port information is
+  transferred correctly to the new channel.
+  
+  Update manpages, and add missing ares_set_servers_csv to the lists
+  while we're at it
 
-Yang Tse (11 Jun 2009)
-- when running automake copy missing files instead of symlinking them
+- api: Add ares_set_sortlist(3) entrypoint
+  
+  Allow explicit configuration of the channel's sortlist, by
+  specifying a string in the same format as the equivalent
+  /etc/resolv.conf option.
+  
+  This allows library users to perform the same configuration
+  that is available via /etc/resolv.conf, but without needing
+  to change that file.
 
-- Adjusted to take in account that...
+- api: Allow injection of user-specified malloc/free functions
   
-  With the curl memory tracking feature decoupled from the debug build feature,
-  CURLDEBUG and DEBUGBUILD preprocessor symbol definitions are used as follows:
+  Add a new ares_library_init_mem() initialization function for the
+  library which allows the library user to specify their own malloc,
+  realloc & free equivalents for use library-wide.
   
-  CURLDEBUG used for curl debug memory tracking specific code (--enable-curldebug)
+  Store these function pointers in library-wide global variables,
+  defaulting to libc's malloc(), realloc() and free().
   
-  DEBUGBUILD used for debug enabled specific code (--enable-debug)
+  Change all calls to malloc, realloc and free to use the function pointer
+  instead.  Also ensure that ares_strdup() is always available
+  (even if the local environment includes strdup(3)), and change the
+  library code to always use it.
+  
+  Convert calls to calloc() to use ares_malloc() + memset
 
-- c-ares' --enable-debug --enable-curldebug decoupling follow-up
+- api: Add option to expose some internal functions
+  
+  Purely for testing, add --enable-expose-statics option to configure
+  which converts some static internal functions to be externally visible.
 
-- mention last changes
+- api: Expose the ares_library_initialized() function
 
-- Remove buildconf.bat from release and daily snapshot archives.
+- ahost: Allow repeated -s <domain> options
   
-  buildconf.bat is only for CVS tree builds.
+  This also removes a potential leak where later -s options would
+  replace earlier ones without freeing the relevant string.
 
-- Ensure that buildconf.bat does nothing unless it is used with a CVS checkout.
+- Mark unhittable lines
+  
+  Add comments for the benefit of the lcov tool, marking
+  lines that cannot be hit.  Typically these are fall-back
+  protection arms that are already covered by earlier checks,
+  and so it's not worth taking out the unhittable code (in case
+  someone changes the code between the two places in future).
 
-- CVS-INFO file only present in CVS tree, never in release nor daily snapshot
-  archives. Used as a sentinel file in buildconf.bat to differentiate CVS builds.
+- ares_set_servers_csv.3: make return type match code
 
-Gisle Vanem (8 Jun 2009)
-- Update comment about "ML". Removed "-D_USE_32BIT_TIME_T" (not a requirement).
+- bitncmp: update comment to match code behaviour
 
-Yang Tse (8 Jun 2009)
-- just comment it out
+- ares_striendstr: fix so non-NULL return can happen
+  
+  This looks to have been broken since it was first introduced in 2005 in
+  commit aba0b775ea30 ("Added ares_getnameinfo which mimics the
+  getnameinfo API")
 
-- For debugging purposes...
+- config_sortlist: free any existing sortlist on (re)alloc failure
   
-  Disable the '-export-symbols-regex' to discard this as the origin
-  of link failures related with shared libraries and non-GNU linkers.
+  If we get an allocation failure on 2nd or later entry in the sortlist, the
+  code would return ENOMEM but still leave the initial entries allocated.
+  Ensure that *sortlist is set to NULL whenever ENOMEM is returned.
 
-- c-ares Makefile.am back to using $(top_builddir) for *_LDADD
+- ares_dup: clear new channel on failure
+  
+  If the attempt to transfer IPv6 servers from the old to the new channel
+  fails, the previous code would still return a channel to the user even though
+  an error return code was generated.  This makes it likely that users would
+  leak the channel, so explicitly clear the channel in this case.
 
-- c-ares' -no-undefined and --enable-curldebug adjustments
+- ares_init_options: don't lose init failure
+  
+  If (say) init_by_options() fails, the subsequent call to
+  init_by_defaults() was overwriting the return code with
+  success.  Still call init_by_defaults() regardless, but track
+  its return value separately
 
-- Use relative path to built c-ares tree libtool library
+- ares_gethostbyname: don't leak valid-but-empty hostent
+  
+  If an AF_UNSPEC query gets a valid response to its AAAA query,
+  but which has no IPv6 addresses in it, then the code chains on to
+  a A record query.  However, the hostent from the AAAA response
+  was being leaked along the way (because it gets replaced before
+  the follow-on end_hquery() invocation).
 
-- John E. Malmberg noticed that the configure script was failing to detect the
-  timeval struct on VMS when building with _XOPEN_SOURCE_EXTENDED undefined due
-  to definition taking place in socket.h instead of time.h
+- ares_parse_txt_reply: propagate errors from per-substring loop
+  
+  If we get an allocation failure when processing a particular substring in a
+  TXT record, that failure is silently lost; fix that by propagating errors from
+  the inner loop to the outer loop.
 
-- Fix compiler warning: out of bound access
+- process_answer: fix things up correctly when removing EDNS option
+  
+  When a server rejects an EDNS-equipped request, we retry without
+  the EDNS option.  However, in TCP mode, the 2-byte length prefix was
+  being calculated wrong -- it was built from the answer length rather than
+  the length of the original request.
+  
+  Also, it is theoretically possible that the call to realloc() might change
+  the data pointed to; to allow for this, qbuf also needs updating.
+  
+  (Both these fixes were actually included in a patchset sent on the mailing
+  list in Oct 2012, but were included with other functional changes that
+  didn't get merged:
+  http://c-ares.haxx.se/mail/c-ares-archive-2012-10/0004.shtml)
+
+- ares__read_line: clear buf pointer on realloc failure
 
-- fix compilation on AIX
+- ares_expand_name: check for valid bits in label length
+  
+  The top two bits of the label length indicate whether this is a
+  label length (00) or an index to a name elsewhere in the message
+  (11).  RFC1035 4.1.4 says that the other possible values for the
+  top two bits (01, 10) are reserved for future use.
 
-- c-ares' --enable-curldebug adjustments
+Daniel Stenberg (23 Jan 2016)
+- [Gregor Jasny brought this change]
 
-- Remove temporarily introduced memory leak.
+  Fix typos detected by lintian
+  
+  Closes #32
 
-- Temporarily introduce a memory leak to verify curl debug memory tracking works.
+- [Gregor Jasny brought this change]
 
-- Allow curl debug memory tracking when building a shared library on
-  systems which support external, undefined, symbols in shared libraries.
+  Distribute all man pages
 
-Daniel Stenberg (26 May 2009)
-- language fix
+- README.cares: s/I/Daniel
+  
+  ... and add a pointer to an existing version of the original area 1.1.1
+  package.a
 
-Yang Tse (26 May 2009)
-- Make ares_init(), ares_dup() and ares_init_options() return ARES_ENOTINITIALIZED
-  if library initialization has not been performed calling ares_library_init().
+- read_tcp_data: don't try to use NULL pointer after malloc failure
+  
+  CID 56884, pointed out by Coverity. We really should make this function
+  return an error code so that a malloc() failure can return back a major
+  failure.
 
-- c-ares's --enable-curldebug configure option decoupled from c-ares's --enable-debug
+- configure_socket: explicitly ignore return code
+  
+  CID 56889 in Coverity pointed out the return code from setsocknonblock()
+  is ignored, and this added typecast to (void) makes it explicit.
 
-- Prevent copying 'sourced' manpages for build targets that don't use them.
+- ahost: check the select() return code
+  
+  Fixes CID 137189, pointed out by Coverity
 
-Daniel Stenberg (23 May 2009)
-- minor edits
+David Drysdale (18 Jan 2016)
+- Fix buildconf on platforms using glibtoolize
+  
+  Commit c49a87eea538 changed buildconf to only check for
+  libtoolize, but missed a line
 
-Yang Tse (21 May 2009)
-- Include .pdf versions of c-ares man pages in distribution tarball.
+- Don't exit loop early leaving uninitialized entries
+  
+  Update for commit affc63cba875d.
+  
+  The original patch from Gregor Jasny did not have the break
+  statement; I incorrectly added it to prevent continuing the loop.
+  However, the later entries in the array would then be left
+  uninitialized, causing problems for later cleanup.
+  
+  So fix to match Gregor's original patch, with apologies.
 
-- Allow generation of .html and .pdf versions of c-ares man pages.
+Daniel Stenberg (18 Jan 2016)
+- buildconf: remove check for libtool, it only requires libtoolize
 
-Gisle Vanem (21 May 2009)
-- $(OBJ_DIR)/ares_getopt.o must be cleaned explicitly.
+David Drysdale (17 Jan 2016)
+- [Gregor Jasny brought this change]
 
-Yang Tse (20 May 2009)
-- Mention last changes
+  Use libresolv to initialize cares on iPhone targets
+  
+  On iPhone targets like iOS, watchOS or tvOS the file
+  /etc/resolv.conf cannot be used to configure cares.
+  
+  Instead the resolver library is queried for configuration
+  values.
+  
+  CC: Yury Kirpichev <ykirpichev@yandex-team.ru>
 
-- Initial ares_library_cleanup(3) man page
+Daniel Stenberg (17 Jan 2016)
+- README: updated to new repo URL
 
-- Update man page
+David Drysdale (14 Jan 2016)
+- [Lei Shi brought this change]
 
-- Update man page
+  Fixing slow DNS lookup issue
+  
+  This patch is fixing the dns lookup issue due to dummy dns information
+  of a disconnected adapter(in my case is a bluetooth adapter). I changed
+  the dns lookup policy to try GetNetworkParams first because the
+  GetNetworkParams provides the most reliable dns information (lots of
+  checks were done by system). I also filter out inoperable adapter in
+  DNS_AdaptersAddresses in case GetNetworkParams fail.
 
-- Initial ares_library_init(3) man page attempt
+- Merge pull request #30 from p-push/vs-2015
+  
+  Support Visual Studio 2015
 
-- Force revision update, to force CVS to update the $Id date string format
+Oleg Pudeyev (3 Jan 2016)
+- [Gisle Vanem brought this change]
 
-- Add same copyright notice as other c-ares files
+  Support Visual Studio 2015
 
-- Fix case
+David Drysdale (11 Nov 2015)
+- [Andrew Andkjar brought this change]
 
-- Remove run-time requirement for advapi32.dll since
-  c-ares can work even with no advapi32.dll at all.
+  added another version case to Makefile.msvc
+  
+  nmake version 11.00.61030.0 resolves to CC_VERS_NUM = 110
 
-- Intentionally avoid checking if the address of SystemFunction036, a.k.a.
-  RtlGenRandom, has been located or not. This function is only available on
-  WinXP and later. When unavailable c-ares uses portable rand() function.
+- Merge pull request #26 from bitbouncer/vs-2013
+  
+  added define for visual studio 2013
 
-- - Provide in external interface preprocessor symbol definitions for
-    CARES_HAVE_ARES_LIBRARY_INIT and CARES_HAVE_ARES_LIBRARY_CLEANUP
-    to ease the use of new capabilities.
+svante karlsson (25 Jun 2015)
+- added define for visual studio 2013
+
+Jakub Hrozek (6 Nov 2014)
+- ares__read_line: free buf on realloc failure
+
+- Destroy options if ares_save_options fails
+  
+  It's possible that, if ares_save_options failed, the opts structure
+  would contain some allocated memory. Calling ares_destroy_options in
+  this case is safe, because ares_save_options zeroes out the memory
+  initially.
+
+- [David Drysdale brought this change]
+
+  Continue loop if space for hostname not large enough
+  
+  When attempting to build a search domain from the local hostname
+  (used as a fallback when no other methods have given a search
+  domain), the code doubles the buffer size on each loop iteration.
   
-  - Move ares_version() prototype to ares.h
+  However, the loop previously had a WHILE_FALSE terminator so the continue
+  statement exited the loop rather than going round again.
+
+Daniel Stenberg (30 Oct 2014)
+- ares_getnameinfo.3: there is no ares_getaddrinfo
+
+David Drysdale (30 Sep 2014)
+- [Gregor Jasny brought this change]
 
-- Introduction of ares_library_init() and ares_library_cleanup()
+  Prevent tmpbuf from overrunning
+  
+  Fix Coverity error CID 56886.
+  
+  Signed-off-by: Gregor Jasny <gjasny@googlemail.com>
 
-- Introduction of ares_library_init() and ares_library_cleanup()
+- [Gregor Jasny brought this change]
 
-- remove outdated comment
+  Re-start loop if select fails
+  
+  Fix Coverity error CID 56882
+  
+  Signed-off-by: Gregor Jasny <gjasny@googlemail.com>
 
-- Fix preprocessor conditional expression
+- [Gregor Jasny brought this change]
 
-- fiX *__SOCKLEN_T definitions for remaining targets
+  Free temporary variable in error path
+  
+  Fix Coverity CID 56890
+  
+  Signed-off-by: Gregor Jasny <gjasny@googlemail.com>
 
-- *__SOCKLEN_T definitions for OS400 already fixed
+- [Gregor Jasny brought this change]
 
-- fIX *__SOCKLEN_T definitions for SYMBIAN32 and VMS targets
+  Fix integer shift overflow if both tcp_socket and udp_socket are set
+  
+  The problem occurs if at the start of the loop the sockindex is at the
+  last valid ARES_GETSOCK_MAXNUM position. If then both udp_socket and
+  tcp_socket are valid, sockindex gets incremented for UDP first and
+  points one entry behind the array for the tcp block.
+  So the fix is to check after every increment of sockindex if it is still
+  valid.
+  
+  Fix Coverity error CID 56878
+  
+  Signed-off-by: Gregor Jasny <gjasny@googlemail.com>
 
-Daniel Stenberg (11 May 2009)
-- - Gregor Jasny made c-ares link with libtool 's -export-symbols-regex option to
-    only expose functions starting with ares_.
+- [Gregor Jasny brought this change]
 
-Yang Tse (11 May 2009)
-- Remove experimental check. Currently there's no need for it.
+  Null check before dereference
+  
+  Fix Coverity error CID 56880
+  
+  Signed-off-by: Gregor Jasny <gjasny@googlemail.com>
 
-- Fix an m4 overquoting triggering a spurious 'AS_TR_CPP' symbol definition
-  attempt in generated config.h
+Jakub Hrozek (28 Jul 2014)
+- [Gisle Vanem brought this change]
 
-- Proper naming for the experimental compiler test and moved to *-compilers.m4
+  Comment in ares_ipv6.h
 
-- Moved *_CHECK_COMPILER_HALT_ON_ERROR and *_CHECK_COMPILER_ARRAY_SIZE_NEGATIVE to *-compilers.m4 along with other *_CHECK_COMPILER_*
+David Drysdale (25 Jul 2014)
+- CONTRIBUTING: add file to indicate mailing list is preferred
 
-- fIX *__SOCKLEN_T definitions for OS400 and generic GCC targets
+- Add -t u option to ahost
+  
+  Add an option to allow specification of the AF_UNSPEC
+  address family.
 
-- fIX *__SOCKLEN_T definitions for MVS and 370 targets
+Jakub Hrozek (24 Jul 2014)
+- host_callback: Fall back to AF_INET on searching with AF_UNSPEC
+  
+  Previously, when an ares_gethostbyname() searched with AF_UNSPEC and the
+  first AF_INET6 call only returned CNAMEs, the host_callback never
+  retried AF_INET.
+  
+  This patch makes sure than on ARES_SUCCESS, the result of AF_INET6 is
+  taken as authoritative only if the result contains some addresses.
 
-- fIX *__SOCKLEN_T definitions for several Windows target tool-chains
+- [David Drysdale brought this change]
 
-- HP-UX's X/Open network library requirement check follow-up
+  Move memset call below platform-specific declarations
+  
+  A GitHub commenter [1] says that my recent change to ahost.c has
+  problems compiling on Windows + C89 platforms.
+  
+  [1]  https://github.com/bagder/c-ares/commit/ee22246507c9#commitcomment-6587616
 
-- HP-UX's X/Open network library requirement check follow-up
+- [David Drysdale brought this change]
 
-- Use build-time configured ares_socklen_t instead of socklen_t
+  Update ahost man page to describe -s option.
+  
+  Commit ee22246507c9 added the -s <domain> option to the
+  ahost command, but neglected to update the man page to
+  describe it.
+  
+  Also fix typo in description of -t option.
 
-- David McCreedy's "TPF-platform specific changes to various files" patch follow-up
+- ares_parse_soa_reply: Do not leak rr_name on allocation failure
+  
+  If ares_malloc_data failed, already allocated rr_name would go out of
+  scope.
 
-Daniel Stenberg (1 May 2009)
-- s/libcurl/c-ares
+- [David Drysdale brought this change]
 
-- version number typo fix
+  Don't override explicitly specified search domains
+  
+  Only set search domains from /etc/resolv.conf if there isn't a value
+  already present in the channel.
 
-Yang Tse (1 May 2009)
-- David McCreedy's "TPF-platform specific changes to various files" patch
+- [David Drysdale brought this change]
 
-- Check definition of _XOPEN_SOURCE_EXTENDED with the compiler
+  Allow specification of search domain in ahost
+  
+  Add the "-s domain" command line option to override the search
+  domains.
 
-- Check if X/Open network library is required
+Daniel Stenberg (12 May 2014)
+- Revert "ares_parse_aaaa_reply: fix leak when reply contains 1 alias and no address"
+  
+  This reverts commit 440110b303fdbfadb3ad53d30eeb98cc45d70451.
 
-- cope with ares_build.h and ares_rules.h follow-up
+- [Frederic Germain brought this change]
 
-- Added some notes regarding ares_build.h
+  ares_parse_aaaa_reply: fix leak when reply contains 1 alias and no address
 
-- fix EOL
+- [Doug Kwan brought this change]
 
-- fix EOL
+  ares_build.h: fix building on 64-bit powerpc
+  
+  There are two issues.
+  
+  1. gcc actually does not use __ppc__ and __ppc64__ but __PPC__ and
+  __PPC64__.  The tests of __ILP32__ and __LP64__ are sufficient for gcc.
+  
+  2. clang defines __GNU__ and defines both __ppc64__ and __ppc__ when
+  targeting ppc64.  This makes CARES_SIZEOF_LONG to be 4 on a ppc64 system
+  when building with clang.
+  
+  My patch is two change the order of the checks so that we check the
+  64-bit case first.
 
-- cope with ares_build.h and ares_rules.h
+- refresh: updated now with automake 1.14
 
-- buildconf.bat for CVS-tree c-ares
+- [David Drysdale brought this change]
 
-- Use 'unsigned int' instead of size_t attempting to avoid header inclusion
+  single_domain: Invalid memory access for empty string input
+  
+  We noticed a small buglet in ares_search() when it gets an empty string
+  as input -- the single_domain() utility function in ares_search.c
+  accesses invalid memory (before the start of the string).
 
-- NetWare LibC's getpeername() third argument data type is size_t
+Guenter Knauf (31 Aug 2013)
+- Fixed warning 'type specifier missing'.
 
-- Remove temporary debug tracing for ares_socklen_t Windows targets
+Daniel Stenberg (30 Aug 2013)
+- [Tor Arntsen brought this change]
 
-- ares_socklen_t follow-up
+  ares_rules.h: CARES_SIZEOF_LONG doesn't exist anymore, don't test for it
+  
+  It was removed in f19387dd72432
 
-- ares_build.h Windows follow-up
+- nowarn: use <limits.h> instead of configure for size of long
+  
+  This makes the header file much more multi-arch friendly and can be used
+  as-is with both 32 bit and 64 bit builds.
 
-- Add temporary debug tracing for ares_socklen_t Windows targets
+- timeoffset: made static and private
+  
+  ares__timeoffset() was only used once within this single source file
 
-- ares_build.h NetWare follow-up
+- timeadd: make static
+  
+  ares__timeadd() was only ever used from within the same source
 
-- ares_build.h NetWare attempt
+Yang Tse (18 Jul 2013)
+- xc-am-iface.m4: comments refinement
 
-- Initial step towards a configure time ares_socklen_t definition
+- configure: fix 'subdir-objects' distclean related issue
+  
+  See XC_AMEND_DISTCLEAN comments for details.
 
-- ignore stamp-h*
+- configure: automake 1.14 compatibility tweak (use XC_AUTOMAKE)
 
-- Added CARES_INCLUDES_SYS_TYPES
+- xc-am-iface.m4: provide XC_AUTOMAKE macro
 
-- Initial step towards a configure time curl_socklen_t definition
+Daniel Stenberg (12 May 2013)
+- gitignore: ignore all ares_*pdf but also CHANGES.dist
 
-- avoid use of alloca()
+- bump: start working towards 1.10.1
 
-- Moved potential inclusion of system's malloc.h and memory.h header files to
-  setup_once.h.  Inclusion of each header file is based on the definition of
-  NEED_MALLOC_H and NEED_MEMORY_H respectively.
+Version 1.10.0 (12 May 2013)
 
-- ignore
+Daniel Stenberg (12 May 2013)
+- RELEASE-NOTES: two more bug fixes
 
-Gisle Vanem (18 Apr 2009)
-- Added '-DHAVE_LIMITS_H'.
+- [Keith Shaw brought this change]
 
-Yang Tse (17 Apr 2009)
-- remove compiler options used while debugging the icc 9.1 optimizer issue
+  ares_set_servers_csv: fixed IPv6 address parsing
+  
+  Fixed bug that caused the last part of an IPv6 address to be parsed as
+  the port number when the last part is all numeric.
 
-- moved HAVE_LIMITS_H to common defines
+- nroff: fix two syntax mistakes
+  
+  ares_parse_a_reply and ares_parse_aaaa_reply both had two \fB instead of
+  \fP
+  
+  Reported-by: Alexander Klauer
+  Bug: http://c-ares.haxx.se/mail/c-ares-archive-2013-03/0010.shtml
 
-- Set HP-UX compiler warning level back to the one that exposes
-  the socklen_t issue on this platform.
+- [Alex Loukissas brought this change]
 
-- HAVE_LIMITS_H definition for NetWare CLIB
+  build: fix build on msvc11
 
-- use HAVE_LIMITS_H symbol to protect limits.h inclusion
+- Makefile.am: increment -version-info for 1.10.0 release
 
-- fix compiler warning: implicit conversion shortens 64-bit value into a 32-bit value
+- README: remove unnecessary comment
 
-- s/u_long/unsigned long/
+- ares_version.h: copyright end range year is now 2013
 
-- Do not halt compilation when using VS2008 to build a Windows 2000 target
+- RELEASE-NOTES: synced with fb0737f3a0a1c37
 
-- ignore
+- [Paul Saab brought this change]
 
-Phil Blundell (3 Feb 2009)
-- * February 3 2009 (Phil Blundell)
-  - If the server returns garbage or nothing at all in response to an AAAA query,
-    go on and ask for A records anyway.
+  ares_parse_aaaa_reply: Plug memory leak
+  
+  This change is similar to ares_parse_a_reply.c in commit
+  bffd67f16a8f42fe6dbf79ab2e39d92eea05c8a6
 
-Daniel Stenberg (31 Jan 2009)
-- - ares_gethostbyname() now accepts 'AF_UNSPEC' as a family for resolving
-    either AF_INET6 or AF_INET. It works by accepting any of the looksups in the
-    hosts file, and it resolves the AAAA field with a fallback to A.
+- [Patrick Valsecchi brought this change]
 
-Gisle Vanem (18 Jan 2009)
-- fopen() returns error in 'errno' even on Windows.
-  So don't use ERRNO (GetLastError()). Trimmed trailing
-  blanks.
+  ares_parse_txt_reply: return a ares_txt_reply node for each sub-string
+  
+  Previously, the function would wrongly return all substrings merged into
+  one.
 
-- Constified some arguments in local functions.
+- [Alexander Klauer brought this change]
 
-Daniel Stenberg (14 Jan 2009)
-- - ares.h no longer uses the HAVE_STRUCT_IN6_ADDR define check, but instead it
-    now declares the private struct ares_in6_addr for all systems instead of
-    relying on one possibly not present in the system.
+  library init: documentation update
+  
+  This commit updates the documentation of ares_library_init() and
+  ares_library_cleanup() with regard to the newly introduced reference
+  counting of initializations and deinitializations.
 
-Phil Blundell (13 Jan 2009)
-- - ares__send_query() now varies the retry timeout pseudo-randomly to avoid
-    packet storms when several queries were started at the same time.
+- [Alexander Klauer brought this change]
 
-Daniel Stenberg (11 Jan 2009)
-- - Phil Blundell added the internal function ares__expand_name_for_response()
-    that is now used by the ares_parse_*_reply() functions instead of the
-    ares_expand_name() simply to easier return ARES_EBADRESP for the cases where
-    the name expansion fails as in responses that really isn't expected.
+  library init: be recursive
+  
+  Previously, a single call to ares_library_cleanup() would deinitialise
+  the c-ares library, regardless of how many times ares_library_init() was
+  called. This behaviour may cause problems in programs linking two or
+  more libraries which, in turn, use c-ares. The present commit fixes this
+  problem, deinitializing the library only after a number of calls to
+  ares_library_cleanup() matching the number of calls to
+  ares_library_init().
 
-Gunter Knauf (30 Dec 2008)
-- added HAVE_SOCKADDR_IN6_SIN6_SCOPE_ID to ares Makefile.netware and sync'd with other Makefile.netware.
+- [Patrick Valsecchi brought this change]
 
-Daniel Stenberg (9 Dec 2008)
-- use the new URL
+  protocol parsing: check input data stricter
+  
+  ... so that bad length fields aren't blindly accepted
+  
+  Bug: http://c-ares.haxx.se/mail/c-ares-archive-2013-04/0016.shtml
 
-- start over on the 1.6.1 release...
+Guenter Knauf (11 Apr 2013)
+- Create ares_build.h when buidling from Git.
 
-Version 1.6.0 (9 Dec 2008)
+- Added -DCARES_STATICLIB to CFLAGS.
+  
+  Currently this static makefile does only support building the
+  static library libcares.a.
 
-Daniel Stenberg (9 Dec 2008)
-- add space
+Daniel Stenberg (8 Apr 2013)
+- [Alexander Klauer brought this change]
 
-Gisle Vanem (9 Dec 2008)
-- Fix for Win32 targets using Watt-32.
+  .gitignore: ignore patch files
+  
+  This commit adds a line to .gitignore to the effect that patch files
+  generated by 'git format-patch' are excluded from the repository.
 
-Dan Fandrich (9 Dec 2008)
-- C89 compilers (like Minix' ACK) only need to handle 31 functions arguments
-  so split a long sprintf into two calls to get below that number.
+- [Alexander Klauer brought this change]
 
-Gisle Vanem (8 Dec 2008)
-- Added needed defines for Watt-32 on Windows.
+  ares_destroy() documentation: no new requests
+  
+  Clarify that no new requests may be added to a resolver channel that is
+  currently being destroyed.
 
-- Undefine 'optarg', 'optind' and 'opterr' when using Watt-32
-  (to get correct linkage on Windows).
+- [Alexander Klauer brought this change]
 
-- ares_writev() shall not be exported when using Watt-32 (has writev).
-  Added _USE_32BIT_TIME_T to avoid runtime warning. Applies to
-  VC-2008+ only.
+  Documentation: properly document ARES_ECANCELLED
+  
+  This commit clarifies the behaviour of ares_cancel() with respect to
+  callbacks and adds missing documentation of ARES_ECANCELLED to the man
+  pages of the affected functions.
 
-- Removed unneeded defines HAVE_SIGNAL_H, HAVE_SIG_ATOMIC_T,
-  RETSIGTYPE and HAVE_PROCESS_H.
+- [Alexander Klauer brought this change]
 
-Daniel Stenberg (4 Dec 2008)
-- the initial version of the ares_set_socket_callback man page
+  ares_cancel(): cancel requests safely
+  
+  An invocation of ares_cancel() walks through the request list, calling
+  the callbacks of all pending requests on a channel. Previously, if such
+  a callback added a new request to the channel, the request list might
+  not end up empty, causing an abort by assertion failure. The present
+  commit ensures that precisely all requests present upon entry of
+  ares_cancel() are cancelled, and that adding new requests through
+  callbacks is safe.
 
-- Gregor Jasny provided the patch that introduces ares_set_socket_callback(),
-  and I edited it to also get duped by ares_dup().
+Yang Tse (10 Mar 2013)
+- ares.h: stricter CARES_EXTERN linkage decorations logic
+  
+  No API change involved.
 
-Dan Fandrich (4 Dec 2008)
-- Bring the sys/include.h include test in line with curl's.
+- ares_build.h.dist: enhance non-configure GCC ABI detection logic
+  
+  GCC specific adjustments:
+  
+  - check __ILP32__ before 32 and 64bit processor architectures in
+    order to detect ILP32 programming model on 64 bit processors
+    which, of course, also support LP64 programming model, when using
+    gcc 4.7 or newer.
+  
+  - keep 32bit processor architecture checks in order to support gcc
+    versions older than 4.7 which don't define __ILP32__
+  
+  - check __LP64__ for gcc 3.3 and newer, while keeping 64bit processor
+    architecture checks for older versions which don't define __LP64__
 
-Daniel Stenberg (3 Dec 2008)
-- Let's not call ares_save_options() deprecated just yet
+Daniel Stenberg (9 Mar 2013)
+- ares.h: there is no ares_free_soa function
 
-- Introduce ares_dup(3) and new thoughts about API/ABI and how to move forwards.
-  Also discussed on the ml.
+Yang Tse (9 Mar 2013)
+- Makefile.am: empty AM_LDFLAGS definition for automake 1.7 compatibility
 
-Dan Fandrich (2 Dec 2008)
-- Make sure sys/socket.h is included before netinet/in.h (required by
-  OpenWatcom C, and condoned by SUS)
+- ares_inet_ntop.3: s/socklen_t/ares_socklen_t
 
-Daniel Stenberg (1 Dec 2008)
-- minor indent fix
+- configure: use XC_LIBTOOL for portability across libtool versions
 
-- Convert the public config struct to the same binary size/construct as in the
-  latest releases to remain ABI compatible.
+- xc-lt-iface.m4: provide XC_LIBTOOL macro
 
-Gisle Vanem (29 Nov 2008)
-- Added '-DHAVE_GETHOSTNAME'.
+- Makefile.am: use AM_CPPFLAGS instead of INCLUDES
 
-Dan Fandrich (29 Nov 2008)
-- Make sure sys/socket.h is included before netinet/in.h (required by
-  OpenWatcom C)
+- inet_ntop.c: s/socklen_t/ares_socklen_t
 
-- Netware has gethostname()
+- inet_ntop.c: s/socklen_t/ares_socklen_t for portability
 
-- Fixed a couple of typos
+Daniel Stenberg (19 Feb 2013)
+- ares.h: s/socklen_t/ares_socklen_t for portability
 
-- Don't tweak the HAVE_* macros when using autoconf
+- ares_inet_ntop.3: 4th argument is socklen_t!
 
-- Make use of gethostname() conditional on it being available
+- spell inet correctly!
 
-- Only set TCP_NODELAY when it exists
+- ares_inet_pton/ntop: cleanup
+  
+  Make sure that the symbols are always exported and present in c-ares.
+  
+  Make the headers prefixed with 'ares'.
+  
+  Removed the inet_ntop.h version as it no longer features any content.
 
-Daniel Stenberg (28 Nov 2008)
-- updated with changes, preparing for a release soon
+- ares_inet_ntop/ares_inet_pton: added man pages
 
-Yang Tse (26 Nov 2008)
-- Gerald Combs fixed a bug in ares_parse_ptr_reply() which would cause a
-  buffer to shrink instead of expand if a reply contained 8 or more records.
+Yang Tse (15 Feb 2013)
+- [Gisle Vanem brought this change]
 
-- Brad Spencer provided changes to allow buildconf to work on OS X.
+  curl_setup_once.h: definition of HAVE_CLOSE_S defines sclose() to close_s()
 
-- In preparation for the upcomming IPv6 nameservers patch, the internal
-  ares_addr union is now changed into an internal struct which also holds
-  the address family.
+- [Gisle Vanem brought this change]
 
-Dan Fandrich (20 Nov 2008)
-- Make checking for struct ifreq a prerequisite for setting
-  HAVE_IOCTL_SIOCGIFADDR since it's needed to use SIOCGIFADDR and Watcom C
-  doesn't currently define it.
+  config-dos.h: define HAVE_CLOSE_S for MSDOS/Watt-32
 
-Daniel Stenberg (20 Nov 2008)
-- use unsigned short better intead of mixing with ints to prevent compiler
-  warnings
+- [Gisle Vanem brought this change]
 
-- please the picky compilers by staying with short as the data we get is short
-  only
+  config-dos.h: define strerror() to strerror_s_() for High-C
 
-- - Brad Spencer brought the new function ares_gethostbyname_file() which simply
-    resolves a host name from the given file, using the regular hosts syntax.
+Daniel Stenberg (13 Feb 2013)
+- ares_get_datatype: removed unused function
+  
+  it was also wrongly named as internal functions require two underscores
 
-Yang Tse (19 Nov 2008)
-- user provided PATH_SEPARATOR always overrides auto-detected one
+- ares__bitncmp: use two underscores for private functions
+  
+  It used a single one previously making it look like a public one
 
-- attempting to keep lines below 80 chars
+- ares__generate_new_id: moved to ares_query.c
+  
+  ... and ares__rc4 is turned into a local static function.
 
-- provide a common PATH_SEPARATOR check method which is required by
-  upcomming work to support the broadest range of Autoconf versions
+- ares__swap_lists: make private and static
+  
+  ... since there's only one user, make it static within ares_process.c
 
-- check for gethostbyaddr and gethostbyname as it is done for other functions
+Yang Tse (13 Feb 2013)
+- Makefile.msvc: add four VS version strings
 
-- Make configure script check if ioctl with the SIOCGIFADDR command can be
-  used, and define HAVE_IOCTL_SIOCGIFADDR if appropriate.
+Daniel Stenberg (13 Feb 2013)
+- ares_expand_name.3: clarify how to free the data
 
-- fix leftover from previous commit
+Yang Tse (30 Jan 2013)
+- zz40-xc-ovr.m4: fix 'wc' detection - follow-up 2
+  
+  - Fix a pair of single quotes to double quotes.
+  
+  URL: http://curl.haxx.se/mail/lib-2013-01/0355.html
+  Reported by: Tor Arntsen
 
-- fix inet_pton() runtime configure check
+- zz40-xc-ovr.m4: fix 'wc' detection - follow-up
+  
+  - Take into account that 'wc' may return leading spaces and/or tabs.
+  
+  - Set initial IFS to space, tab and newline.
 
-- trim down configure script size
+- zz40-xc-ovr.m4: fix 'wc' detection
+  
+  - Take into account that 'wc' may return leading spaces.
+  
+  - Set internationalization behavior variables.
+  
+  Tor Arntsen analyzed and reported the issue.
+  
+  URL: http://curl.haxx.se/mail/lib-2013-01/0351.html
 
-Daniel Stenberg (15 Nov 2008)
-- Fixed an OOM condition reported by Jim Meyering
+- zz40-xc-ovr.m4: check another three basic utilities
 
-Yang Tse (14 Nov 2008)
-- fix typo affecting inclusion of <arpa/inet.h> in configure
-  checks for inet_ntoa_r() inet_ntop() and inet_pton()
+- zz40-xc-ovr.m4: 1.0 interface stabilization
+  
+  - Stabilization results in 4 public interface m4 macros:
+    XC_CONFIGURE_PREAMBLE
+    XC_CONFIGURE_PREAMBLE_VER_MAJOR
+    XC_CONFIGURE_PREAMBLE_VER_MINOR
+    XC_CHECK_PATH_SEPARATOR
+  - Avoid one level of internal indirection
+  - Update comments
+  - Drop XC_OVR_ZZ40 macro
+
+- zz40-xc-ovr.m4: emit witness message in configure BODY
+  
+  This avoids witness message in output when running configure --help,
+  while sending the message to config.log for other configure runs.
+
+- zz40-xc-ovr.m4: truly do version conditional overriding
+  
+  - version conditional overriding
+  - catch unexpanded XC macros
+  - fix double words in comments
+
+- zz40-xc-ovr.m4: fix variable assignment of subshell output bashism
+  
+  Tor Arntsen analyzed and reported the issue.
+  
+  URL: http://curl.haxx.se/mail/lib-2013-01/0306.html
+
+- zz40-xc-ovr.m4: reinstate strict AC_REQUIRE macro dependencies
+
+- zz40-xc-ovr.m4: avoid double single-quote usage
+
+- zz40-xc-ovr.m4: parentheses balancing of 'case' statements
+  
+  m4 quadrigraph shell comment technique allows proper autoconf
+  parentheses balancing in shell 'case' statements. The presence
+  of unbalanced parentheses may otherwise trigger expansion bugs.
+
+- zz40-xc-ovr.m4: internals overhauling
+  
+  - Update comments
+  - Execute commands in subshells
+  - Faster path separator check
+  - Fix missing 'test' command
+  - Rename private macros
+  - Minimize AC_REQUIRE usage
+
+- zz40-xc-ovr.m4: redirect errors and warnings to stderr
+
+- configure: use XC_CONFIGURE_PREAMBLE early checks
+  
+  Some basic checks we make were placed early enough in generated
+  configure script when using autoconf 2.5X versions. Newer autoconf
+  versions expand these checks much further into the configure script,
+  rendering them useless. Using XC_CONFIGURE_PREAMBLE fixes placement
+  of early intended checks across all our autoconf supported versions.
+
+- zz40-xc-ovr.m4: provide XC_CONFIGURE_PREAMBLE macro
+
+- configure: autotools compatibility fixes - step I
+  
+  Fix proper macro expansion order across autotools versions for
+  C compiler and preprocessor program checks.
+
+- configure: fix automake 1.13 compatibility
+  
+  Tested with:
+  
+  buildconf: autoconf version 2.69
+  buildconf: autom4te version 2.69
+  buildconf: autoheader version 2.69
+  buildconf: automake version 1.13.1
+  buildconf: aclocal version 1.13.1
+  buildconf: libtool version 2.4
+  buildconf: GNU m4 version 1.4.16
+
+- ares_private.h: use again memdebug.h instead of curl_memdebug.h
+
+- configure.ac: replace AM_CONFIG_HEADER with AC_CONFIG_HEADERS
+  
+  automake 1.13 errors if AM_CONFIG_HEADER is used in configure script.
+
+- cares-override.m4: provide AC_CONFIG_MACRO_DIR definition conditionally
+  
+  Provide a 'traceable' AC_CONFIG_MACRO_DIR definition only when using
+  an autoconf version that does not provide it, instead of what we were
+  doing up to now of providing and overriding AC_CONFIG_MACRO_DIR for
+  all autoconf versions.
+
+- ares_private.h: use curl_memdebug.h instead of memdebug.h
+
+- vc6cares.dsp: add ares_create_query.c and ares_parse_soa_reply.c
+
+- cares-functions.m4: improve gethostname arg 2 data type check
+
+- setup_once.h: HP-UX specific 'bool', 'false' and 'true' definitions.
+  
+  Also reverts commit bceb40095a
+
+- configure: check if compiler halts on function prototype mismatch
+
+- cares-functions.m4: add gethostname arg 2 data type check and definition
+
+- cares-functions.m4: update thread-safeness detection of getaddrinfo()
+  
+  Take in account that POSIX standard Issue 7 drops h_errno support. Now, we also
+  consider getaddrinfo() to be thread-safe when (_POSIX_C_SOURCE >= 200809L) or
+  (_XOPEN_SOURCE >= 700) independently of whether h_errno exists or not.
+  
+  Take in account that h_errno might be a modifiable lvalue not defined as
+  a C preprocessor macro.
+
+- setup_once.h: HP-UX <sys/socket.h> issue workaround
+  
+  Issue: When building a 32bit target with large file support HP-UX
+  <sys/socket.h> header file may simultaneously provide two different
+  sets of declarations for sendfile and sendpath functions, one with
+  static and another with external linkage. Given that we do not use
+  mentioned functions we really don't care which linkage is the
+  appropriate one, but on the other hand, the double declaration emmits
+  warnings when using the HP-UX compiler and errors when using modern
+  gcc versions resulting in fatal compilation errors.
+  
+  Mentioned issue is now fixed as long as we don't use sendfile nor
+  sendpath functions.
+
+- setup_once.h: refactor inclusion of <unistd.h> and <sys/socket.h>
+  
+  Inclusion of these two header files now done in setup_once.h
+
+- Header inclusion clean-up
+  
+  Remove header inclusions already done in setup_once.h
+
+- setup_once.h: HP-UX specific TRUE and FALSE definitions
+  
+  Some HP-UX system headers require TRUE defined to 1 and FALSE to 0.
+
+- ares_timeout.c: fix compiler warning
+
+- ares_create_query.c: IRIX compilation fix
+
+- c-ares/nameser.h: add some T_* defines for ns_t_* values
+
+Daniel Stenberg (7 Nov 2012)
+- Revert "ares_parse_aaaa_reply: fix memory leak"
+  
+  This reverts commit 50f25d8a4b2d16f4c5e0ef620238688b7a315c7a.
+
+- ares_parse_aaaa_reply: fix memory leak
+  
+  an allocated buffer was not freed in the successful case.
+
+- [Gisle Vanem brought this change]
+
+  adig: perror() doesn't work for socket errors on windows
+  
+  ... so print the SOCKERRNO instead
+
+- get_DNS_AdaptersAddresses: fix IPv6 parsing
+  
+  Use of the wrong define made the function not parse IPv6 addresses
+  properly.
+  
+  Bug: http://c-ares.haxx.se/mail/c-ares-archive-2012-06/0028.shtml
+  Reported by: Saúl Ibarra Corretgé
+
+- version: bumped to 1.10.0
+  
+  Due to the newly added function: ares_create_query()
+
+- AUTHORS: synced with 83093ac450
+  
+  Added 21 authors since this document was last updated
+
+- ares_create_query.3: mention when this is added
+
+- [hpopescu@ixiacom.com brought this change]
+
+  Added new feature (rfc2671)
+
+- code police: fix indents, < 80 columns, reflowed comments
+
+Guenter Knauf (11 Jul 2012)
+- Cleaned up version awk script.
+
+Daniel Stenberg (30 Jun 2012)
+- [Gisle Vanem brought this change]
+
+  read_udp_packets: bail out loop on bad sockets
+  
+  I can see that recvfrom() in ares_process.c many times is called with
+  'udp_socket' == ARES_SOCKET_BAD. The code takes care not to call
+  recv/recvfrom with ARES_SOCKET_BAD in the outer-loop. So should the
+  inner-loop.
+
+Yang Tse (29 Jun 2012)
+- cares-compilers.m4: remove -Wstrict-aliasing=3 from clang
+  
+  Currently it is unknown if there is any version of clang that
+  actually supports -Wstrict-aliasing. What is known is that there
+  are several that don't support it.
+
+- cares-compilers.m4: -Wstrict-aliasing=3 for warning enabled gcc and clang builds
+
+Daniel Stenberg (18 Jun 2012)
+- version: work towards 1.9.2 (at least)
+
+Version 1.9.1 (18 Jun 2012)
+
+Daniel Stenberg (18 Jun 2012)
+- RELEASE-NOTES: 1.9.1 coming up
+
+Version 1.9.0 (16 Jun 2012)
+
+Daniel Stenberg (16 Jun 2012)
+- ares_version.h: next version is 1.9.0
+
+- [Marko Kreen brought this change]
+
+  ares_data.h: ARES_DATATYPE_SOA_REPLY is added in 1.9.0
+
+- RELEASE-NOTES: synced with 979bf951d
+  
+  Next release deemed to become 1.9.0 due to the new function
+
+- [Marko Kreen brought this change]
+
+  SOA parser added
+  
+  I need to do SOA queries, so here is a parser for them.
+  
+  - ares_soa_reply: new struct
+  - ares_malloc_data/ares_free_soa: ARES_DATATYPE_SOA_REPLY
+  - ares_parse_soa_reply: actual function
+
+Yang Tse (14 Jun 2012)
+- Kill compiler warning
+
+- Fix libcares.pc generation for static MingW* cross builds
+
+Daniel Stenberg (21 May 2012)
+- [Nick Alcock brought this change]
+
+  Fix UDP and TCP port byte order in saved options.
+  
+  The UDP and TCP port are stored in network byte order in the
+  ares_channeldata, but are passed in to ares_init_options() in host byte
+  order.  Thus we must return them from ares_save_options() in host byte
+  order too, or a duplicated channel will convert them again, leading to a
+  nonfunctional channel and a mysterious connection refused error from
+  ares_gethostbyname().  This breaks ares_dup(), thus the curl easy API
+  when c-ares is used by curl, and thus all the curl easy API's users.
+
+Yang Tse (28 Apr 2012)
+- version: start working on 1.8.1-DEV
+
+Version 1.8.0 (27 Apr 2012)
+
+Daniel Stenberg (27 Apr 2012)
+- RELEASE-NOTES: call next 1.8 instead
+  
+  Since we added a function, let's use a stricter bumping scheme
+
+Yang Tse (25 Apr 2012)
+- INSTALL: some adjustments
+
+Daniel Stenberg (25 Apr 2012)
+- GIT-INFO: mention buildconf
+
+Yang Tse (25 Apr 2012)
+- INSTALL: remove more sections that don't apply to c-ares
+
+- ares_timeout.c: fix compiler warning
+
+Daniel Stenberg (25 Apr 2012)
+- [Ben Noordhuis brought this change]
+
+  Makefile.m32: fix mingw32 build
+  
+  * add . to include path so ares_build.h is picked up
+  * make ar configurable to ease cross-compiling
+
+- RELEASE-NOTES: added what's happened since 1.7.5
+
+Guenter Knauf (22 Apr 2012)
+- Updated copyright year.
+
+Yang Tse (21 Apr 2012)
+- ares_init.c: Further refactoring of Windows system's DNS fetching code
+
+Guenter Knauf (20 Apr 2012)
+- Android: small changes to dns property part.
+  
+  Prefix prop vars; kill var; use DNS_PROP_NAME_PREFIX macro.
+
+- Handle CNAME-only in ares_parse_aaaa_reply().
+  
+  posted to the c-ares list by Peter Griess <pg@std.in>.
+
+- Add support for multiple DNS servers on Android.
+  
+  Before, c-ares always used the first DNS server on Android, causing
+  network problems if this DNS server was not available.
+  
+  Signed-off-by: Geert Uytterhoeven <Geert.Uytterhoeven@sonycom.com>
+
+- Added INSTALL so it gets into tarballs.
+
+- Added some more ifdefs to silent compiler warnings.
+
+Yang Tse (17 Apr 2012)
+- INSTALL: remove a non c-ares section
+
+- cares-compilers.m4: -Wno-pedantic-ms-format for Windows gcc 4.5 builds
+  
+  When building a Windows target with gcc 4.5 or newer and strict compiler
+  warnings enabled use -Wno-pedantic-ms-format in addition to other flags.
+
+- setup_once.h: tighten requirements for stdbool.h header inclusion
+  
+  Include stdbool.h only when it is available and configure is capable of
+  detecting a proper 'bool' data type when the header is included.
+
+- configure: NATIVE_WINDOWS no longer defined in config file
+
+- cares-compilers.m4: double underscore decoration for visibility attribute
+
+- build adjustments: CARES_SYMBOL_HIDING no longer defined in config files
+  
+  configure script now provides conditional definitions for Makefile.am
+  that result in CARES_SYMBOL_HIDING being defined by resulting makefiles
+  when appropriate.
+
+- configure: Windows cross-compilation fixes
+  
+  CARES_BUILDING_LIBRARY and CARES_STATICLIB no longer defined in ares_config.h,
+  configure will generate appropriate conditionals so that mentioned symbols
+  get defined and used in Makefile derived from Makefile.am at compilation time.
+
+Guenter Knauf (17 Apr 2012)
+- Added INSTALL file adapted from libcurl.
+  
+  Not yet ready, and needs further edits.
+
+Yang Tse (16 Apr 2012)
+- ares_init.c: get_iphlpapi_dns_info() refactoring
+
+Guenter Knauf (16 Apr 2012)
+- Kill some more compiler warnings.
+
+- Kill compiler warning about unused var.
+
+- Fixed my last commit: wrong preprocessor directive.
+
+- Check for __ANDROID__ in addition to ANDROID macro.
+
+- Check for __ANDROID__ in addition to ANDROID macro.
+  
+  Posted to c-ares list by Wayne.
+
+- Fix for Android to disable useless arpa/nameser.h.
+
+- Fix for Android to include sys/select.h for fd_set.
+
+Yang Tse (17 Mar 2012)
+- ares_data.c: some NAPTR related fixes
+
+Daniel Stenberg (16 Mar 2012)
+- port numbers: convert them to network order!
+  
+  When the config options ARES_OPT_UDP_PORT or ARES_OPT_TCP_PORT are used,
+  make sure to convert them to network byte order!
+  
+  Bug: http://c-ares.haxx.se/mail/c-ares-archive-2012-02/0004.shtml
+
+- white space cleanup
+  
+  - Keep code within 80 columns
+  
+  - Removed funny spaces after open paren and before closing paren
+
+- [Poul Thomas Lomholt brought this change]
+
+  get_iphlpapi_dns_info: fix buffer overrun
+  
+  I experienced a buffer overrun exception in c-ares on Windows and
+  tracked it down to be an error in the calculation of the 'left' variable
+  in get_iphlpapi_dns_info().
+  
+  I changed the variable type of 'left' to a _signed_ type because of the
+  subtraction arithmetic; not sure if a long is the best choice
+
+- Merge pull request #7 from saghul/naptr
+  
+  Added support for parsing NAPTR records
+
+saghul (23 Feb 2012)
+- Added support for parsing NAPTR records
+
+Yang Tse (19 Jan 2012)
+- ares_init.c: fix compiler warning on winsock builds
+
+- configure: libtool 1.5 tweaks
+
+Daniel Stenberg (19 Dec 2011)
+- ares_timeout.3: fix the NAME section
+  
+  It was clearly a copy n' paste error
+
+Yang Tse (27 Sep 2011)
+- [Albert Chin brought this change]
+
+  configure - m4: make CURL_CHECK_DEF ignore leading whitespace on symbol def
+  
+  When using Sun C compiler the preprocessor somehow inserts an extra space
+  in front of replaced symbol, breaking CURL_CHECK_DEF macro. To workaround
+  this, macro CURL_CHECK_DEF now ignores all leading whitespace in front of
+  symbol substitution result.
+
+- ares_init.c: fix segfault triggered in ares_init_options() upon previous
+               failure of init_by_defaults() and incomplete cleanup there.
+
+- ares_process.c: fix compiler warning
+
+- fix MSVC compiler warning 'conditional expression is constant'
+
+- setup_once.h cleanup and sync
+
+- [Denis Bilenko brought this change]
+
+  ares_getnameinfo: fix random results with c-ares 1.7.5
+  
+  In ares_getnameinfo memcpy did not copy enough bytes, causing
+  it to return arbitrary memory contents as a result.
+
+- warnings: fix another 'conversion may lose significant bits' compiler warning
+
+- ares_dns.h: adjust DNS__16BIT and DNS__32BIT macro definitions
+  
+  Fixing compiler warnings existing definitions triggered on these.
+
+- ares_destroy.c: fix segfault in ares_destroy_options()
+
+Daniel Stenberg (21 Aug 2011)
+- ares_parse_srv_reply: silence compiler warnings
+  
+  ... by adding ugly typecasts.
+
+- CHANGES: generate from script
+  
+  The CHANGES file is now generated automatically with 'git2changes.pl',
+  invoked by the maketgz script which is used to build release archives.
+  
+  The former human edited CHANGES file was renamed to CHANGES.0 in git.
+
+Yang Tse (21 Aug 2011)
+- Makefile.netware: SIZEOF_SHORT definition
+
+- warnings: fix some 'conversion may lose significant bits' compiler warnings
+
+- configure: fix symbol hiding usability check
+  
+  A more thorough test is done now in order to determine visibility attribute
+  usability, given that some compilers don't support visibility attribute on
+  all configurations.
+
+Daniel Stenberg (16 Aug 2011)
+- 1.7.6: start working...
+
+Version 1.7.5 (16 Aug 2011)
+
+Daniel Stenberg (16 Aug 2011)
+- CHANGES: synced for 1.7.5 release
+
+- RELEASE-NOTES: synced with bb4096effef7f000
+
+Jakub Hrozek (15 Aug 2011)
+- Only fall back to AF_INET searches when looking for AF_UNSPEC addresses
+
+Yang Tse (10 Aug 2011)
+- [Gisle Vanem brought this change]
+
+  ares_iphlpapi.h: Watcom C fix
+  
+    Added "!defined(_WS2DEF_)" since Watcom doesn't have
+    a per type guard for the typedefs 'CSADDR_INFO' (that MingW has) or
+    'SOCKET_ADDRESS' (that MSVC has). But we can use the header-guard for
+    <ws2def.h> instead.
+
+- [Gisle Vanem brought this change]
+
+  Makefile.Watcom:
+    * The 'NTDDI_VERSION' needs to be raised to 0x05010000
+      in order for SOCKADDR_STORAGE etc. to be typedefed.
+    * Replaced '-dUSE_WATT32' with '-dWATT32'.
+    * Added $(DEMOS) to the 'all' target and removed the 'demos'
+      target to be consistent with e.g. Makefile.msvc etc.
+    * 'ENABLE_IPV6' is no longer used. Hence removed the '%use_ipv6' construct.
+    * object-file order seems to be important (Watcom v.19). Hence
+      'ares_getopt.obj' must be put after the .obj that references getopt().
+
+- cares-compilers.m4: CARES_CONVERT_INCLUDE_TO_ISYSTEM adjustments
+  
+  Add CARES_CHECK_COMPILER as a requirement.
+  
+  Ensure macro does nothing unless GNU_C or CLANG compiler is used.
+  
+  This should allow usage of this macro in unforeseen placements.
+
+- config-win32.h: comments adjustments - followup
+
+- config-win32.h: comments adjustments
+
+Daniel Stenberg (5 Aug 2011)
+- [Tom Hughes brought this change]
+
+  ares_parse_a_reply: fix memleak
+
+Yang Tse (29 Jul 2011)
+- cares-functions.m4 serial # bump
+
+- Revert "configure: additional flag checks for fcntl() and socket()"
+  
+  This reverts commit 5f2a3b0e48f26d24cb1fefea0dccb92d417dcbf7.
+
+- configure: additional flag checks for fcntl() and socket()
+
+- xc-translit.m4 fix quoting
+
+- configure: avoid direct usage of AS_TR_* macros
+
+- xc-translit.m4 provides transliteration macros with well defined behavior.
+
+Jakub Hrozek (15 Jun 2011)
+- Revert "Only fall back to AF_INET searches when looking for AF_UNSPEC addresses"
+  
+  This reverts commit b5823d65706af687c0e5110af8f0cfdcd068997d.
+  
+  This patch was not reviewed properly before pushing
+
+- Revert "Do not use sized constants in public headers"
+  
+  This reverts commit 22c01e96f7b2ae9923e1baa50bfe3c0d22297a7d.
+  
+  This is a Red Hat specific patch that does not belong into upstream
+
+- Use correct sizeof in ares_getnameinfo()
 
-- #include <string.h> in the getaddrinfo() runtime check for the memset() prototype
+- Do not leak rr_name on failures inside ares_parse_ptr_reply
 
-- fix symbol definition check for fcntl.h inclusion
+- Do not leak rr_name on failures inside ares_parse_a_reply
 
-- Refactor configure script detection of functions used to set sockets into
-  non-blocking mode, and decouple function detection from function capability.
+- Do not leak rr_name on failures inside ares_parse_aaaa_reply
 
-Daniel Stenberg (1 Nov 2008)
-- Added a TODO file to list things we want changed, added or fixed.
+- Do not leak rr_name on failures inside ares_parse_ns_reply
 
-- - Carlo Contavalli added support for the glibc "rotate" option, as documented
-    in man resolv.conf:
-  
-    causes round robin selection of nameservers from among those listed.  This
-    has the effect of spreading the query load among all listed servers, rather
-    than having all clients try the first listed server first every time.
-  
-    You can enable it with ARES_OPT_ROTATE
+- Fix incorrect sizeof() in ares_save_options
 
-Yang Tse (1 Nov 2008)
-- Adjust WIN32 freeaddrinfo, getaddrinfo and getnameinfo availability
+- Fix incorrect allocation in ares_parse_ptr_reply()
 
-- WIN32 availability of freeaddrinfo, getaddrinfo and getnameinfo functions is quite
-  convoluted, compiler dependant and in some cases even build target dependat.
+- Only fall back to AF_INET searches when looking for AF_UNSPEC addresses
 
-- check for freeaddrinfo() at configuration phase
+- Do not use sized constants in public headers
 
-- update aclocal file serial number
+Daniel Stenberg (13 Jun 2011)
+- [Jakub Hrozek brought this change]
 
-- remove verification of the freeability of the addrinfo struct pointer members
+  ares_free_hostent(NULL) should be a noop
 
-- fix comment
+Yang Tse (8 Jun 2011)
+- configure: fix recvfrom 5th arg type qualifier detection (followup)
 
-- make CHECK_FUNC_GETADDRINFO_UNFREEABLE_AI_ADDR
-   and CHECK_FUNC_GETADDRINFO_UNFREEABLE_AI_CANONNAME
-  internal to CHECK_FUNC_GETADDRINFO
+- configure: fix recvfrom 5th arg type qualifier detection
+  
+  Additionally remove whitespace from EOL
 
-- fix leftover
+Daniel Stenberg (4 Jun 2011)
+- strlen: use size_t to receive the return
 
-- Initial attempt to detect at configuration time if the getaddrinfo()
-  function returns an addrinfo with an unfreeable ai_canonname member ptr.
+Yang Tse (4 Jun 2011)
+- xlc: avoid preprocessor definition usage when linking
 
-- Initial attempt to detect at configuration time if the getaddrinfo()
-  function returns an addrinfo with an unfreeable ai_addr member ptr.
+- ares_nowarn: icc 9.1 workaround
 
-- icc adjustments:
-  
-    Select ANSI C89 dialect plus GNU extensions, again.
+- ares_nowarn: header inclusion fix
 
-- some more temporary magic for the icc seg-fault issue
+- ares_init: make ares_private.h last included header again
 
-- icc permanent adjustment:
-  
-    Select precise floating-point model, otherwise doubles are less than 64-bit wide
-  
-  icc test adjustment:
+- compiler warning: fix
   
-    Select c89 dialect
+  Fix compiler warning: conversion may lose significant bits
 
-- icc adjustments:
+- compiler warning: fix
   
-    Enable more icc warnings.
+  Fix compiler warning: variable was set but never used
   
-    Optimization disabling options used only for icc 9.1
-
-- #include <stdlib.h> for exit() prototype
-
-- some more temporary magic for the icc seg-fault issue
-
-- remove from configure.ac temporary magic for the icc seg-fault issue
+  Fix compiler warning: clobber ignored
 
-- some more temporary magic for the icc seg-fault issue
+- ares_iphlpapi: fix compiler warnings
 
-- Charles Hardin patch:
+- winsock: compilation fixes
   
-  - handles the EINPROGRESS for UDP connects
-  - uses closesocket instead of close on some paths that were noticed
+  Provide winsock iphlpapi alternative definitions to prevent compilation
+  failures when using a variety of winsock header implementations.
 
-- some more temporary magic for the icc seg-fault issue
+Daniel Stenberg (17 May 2011)
+- [David Stuart brought this change]
 
-- messages initially intended only for debug purposes, now become permanent
-  since these are extremely useful when compiler rejects a set of options.
+  IPv6-on-windows: find DNS servers correctly
 
-- fix compiler warning
+- man pages: docs for the c-ares utility programs
 
-- fix missing double-quotes
+- ares_parse_ns_reply.c: remove CVSism
 
-Daniel Stenberg (17 Oct 2008)
-- Charles Hardin made adig support a regular numerical dotted IP address for the
-  -s option as well.
+Yang Tse (27 Mar 2011)
+- build: fix header inclusion
 
-Yang Tse (16 Oct 2008)
-- some more temporary magic for the icc seg-fault issue
+- getservbyport replacement for Win CE
 
-- Ensure that shell variable contents which have active meaning
-  to the shell echo command are not interpreted when trying to
-  remove extra whitespace from shell variable content.
+- renamed getplatform() to ares__getplatform() to avoid namespace pollution
 
-- Adjust Watcom C warnings:
+- configure: fix libtool warning
   
-    Disable warnings on structure members padding.
-
-- With this change Solaris target builds will now be done with _REENTRANT defined.
+  Recent versions of libtool are now tracing usage of AC_CONFIG_MACRO_DIR
+  macro and warn heavily when not used in configure script along with
+  ACLOCAL_AMFLAGS in Makefile.am.  So in order to make libtool happy
+  while keeping backwards compatibility this is added.
 
-- Adjust Tiny C basic options:
+- adig: RFC4034 resource record type detection
   
-    Remove -b from debug-enabled configuration, as Tiny C might have
-    been built without the memory and bounds checker support.
+  Can be tested with: adig -s 8.8.8.8 -t ANY example.com
 
-- Adjust GCC warnings:
-  
-    Better disable following warnings when cross-compiling with a gcc older
-    than 3.0, to avoid warnings from third party system headers:
-  
-      -Wmissing-declarations
-      -Wmissing-prototypes
-      -Wunused
-      -Wshadow
+- nameser.h: RFC4034 resource record type definitions
+
+- build: move platform stuff to ares_platform.c and ares_platform.h
 
-- fix syntax error
+- build: find out windows platform using GetVersionEx()
+
+- build: use getenv() replacement function for systems which lack it
 
-- Initial attempt to detect Watcom C compiler
+- setup_once: system error codes for Windows CE
 
-- make naming scheme more consistent across whole file
+- ares_search: use ERRNO macro for portability sake
 
-- Adjust GCC warnings:
+- System's errno.h inclusion cleanup follow-up.
   
-    Disable following warnings when cross-compiling with a gcc older
-    than 3.0, to avoid warnings from third party system headers:
+  System's errno.h is conditionally included from setup_once.h
+
+- Windows CE specific adjustment
   
-      -Wmissing-prototypes
-      -Wunused
-      -Wshadow
+  All versions of Windows CE support Winsock 1.1
 
-- Adjust GCC --enable-warnings:
+- System's errno.h inclusion cleanup.
   
-    Do not enable -pedantic when cross-compiling with a gcc older
-    than 3.0, to avoid warnings from third party system headers.
+  System's errno.h is conditionally included from setup_once.h
 
-- adjust SGI MIPSpro C detection
+- ares_init: fix gethostname error detection on winsock platforms
 
-- LCC compiler adjustments:
+- configure: r-enable temporarily disabled detection of system's inet_ntop()
   
-    Highest warning level is double -A, next is single -A.
-    Due to the big number of warnings these trigger on third
-    party header files it is impratical for us to use any of
-    them here. If you want them simply define it in CPPFLAGS.
+  Detection was temporarily disabled in commit 674e044ccb21f2f63537da53565fce868f
 
-- remove extra space
+Daniel Stenberg (15 Mar 2011)
+- configure: stop using the deprecated AM_INIT_AUTOMAKE syntax
 
-- split SGI compiler check. One for MIPS C and another for MIPSpro C
+- [Gisle Vanem brought this change]
 
-- LCC compiler adjustments:
+  Watt-32: use errno
   
-    Warning level reduced from double -A to single -A
-
-- Initial attempt to detect Tiny C compiler
+  Make sure Watt-32 programs use 'errno' even on Win32 targets
 
-- Initial attempt to detect LCC compiler
+Guenter Knauf (18 Feb 2011)
+- Removed commented CLFAGS no longer needed.
 
-- 1) fix bug in CONVERT_INCLUDE_TO_ISYSTEM
+- Fixed CFLAGS for NetWare.
   
-  2) Disable SGI remark: controlling expression is constant
+  Added -m32 to enable compilation with x86_64 compilers;
+  added conditional to set -fpcc-struct-return only for gcc compiler.
 
-- simplify SGI C compiler check
+Daniel Stenberg (18 Feb 2011)
+- [Gisle Vanem brought this change]
 
-- HP C adjustments:
-  
-    Due to the HP-UX socklen_t issue it is insane to use the +w1 warning level.
-    It generates more than 1100 warnings on socklen_t related statements.
+  Watt32: fix server init
   
-    Until the issue is somehow fixed we will just use the +w2 warning level.
+  Somewhere in the process, programs using the Watt-32 tcp/ip stack
+  stopped working.
 
-- Add debug tracing for COMPILER_WORKS_IFELSE
+- [Dima Tisnek brought this change]
 
-- configure will also warn on 'strict compiler warning' rejected options
+  config_sortlist: (win32) missing else
+  
+  Without an else there, contents of "pat" that could have been
+  successfully set just above, may be clobbered by successive unsuccessful
+  calls to "xxx_pton" or "ip_addr".
 
-- convert rejected compiler options messages into a warnings
+Yang Tse (17 Jan 2011)
+- Makefile.msvc: add a couple of VS version strings
 
-- remove extra whitespace from string in SGI C check
+- Makefile.msvc: add a couple of VS version strings
 
-- oops
+- build: add install target to Makefile.msvc
 
-- Initial attempt to detect SGI C compiler
+Daniel Stenberg (27 Dec 2010)
+- ares_set_servers_csv: remove unused variables
 
-- HP C adjustments:
-  
-    Disallow run-time dereferencing of null pointers.
-  
-    Disable some remarks:
-  
-      #4227: padding struct with n bytes to align member.
+- init_by_resolv_conf: fix compiler warnings
   
-      #4255: padding size of struct with n bytes to alignment boundary.
-
-- improve presentation of accepted/rejected debug/optimizer options
-
-- refactoring of COMPILER_BASIC_OPTS
-
-- Initial attempt to detect SUN C compiler
-
-- Initial attempt to detect HP C compiler
+  The code received the return codes in the 'status' variable without
+  using it. Instead we just ignore those particular errors.
 
-- fix compiler warning: 'dot_4' may be used uninitialized in this function
+- getv4: Value stored to 'dst' is never read
 
-- adjust ICC_windows settings
+- advance_tcp_send_queue: avoid NULL ptr dereference
+  
+  If given a too large 'num_bytes' value, it would cause a NULL ptr
+  dereference. Instead the code will now break out of the loop at the end
+  of the list.
 
-- fix VAR_STRIP
+- [Peter Pentchev brought this change]
 
-- Sync up with reality
+  configure: fix a bashism
 
-- Initial attempt to support configure's --(dis|en)able-optimize
-  option to specify dis(activation) of compiler optimizations.
+- cleanup: avoid unsafe typecasts
   
-  If option is specified, it will be honored independant of the
-  --(dis|en)able-debug option.
+  Avoid the risk of reading 16bit data from an unaligned address by using
+  a macro that is adapted for this.
 
-- fix comment
+- [Stefan Bühler brought this change]
 
-- Initial attempt to support configure's --(dis|en)able-warnings
-  option to specify dis(activation) of picky compiler warnings.
-  
-  If option is specified, it will be honored independant of the
-  --(dis|en)able-debug option.
-  
-  If option is not specified, it will follow --(dis|en)able-debug
-  setting, whose default is disabled if not specified.
+  ares_expand_name: Fix encoded length for indirect root
 
-- fix compiler warning: dereferencing type-punned pointer will break strict-aliasing rules
+Yang Tse (18 Dec 2010)
+- build: add some explicit file references to VS project files
 
-- now compiler warnings are activated for all gcc builds, not only debug ones.
+- config-win32: provide HAVE_ASSERT_H definition
 
-- Use CFLAGS for icc linker options instead of LDFLAGS,
-  otherwise gethostbyname() is not detected.
+- build: include ares_nowarn in sample program VS project files
 
-- use ac_cv_compiler and ac_cv_compiler_num to keep compiler ID and version number
+- build: include ares_nowarn among SAMPLESOURCES and SAMPLEHEADERS
 
-- Temporary icc adjustment:
+- configure: temporarily disable detection of system's inet_ntop()
   
-    Disable floating point optimizations
-
-- HAVE_INET_PTON will only be defined when an IPv6 capable working
-  inet_pton function is available.
-
-- HAVE_INET_NTOP will only be defined when an IPv6 capable working
-  inet_ntop function is available.
+  This is done to allow compilation of ares_inet_ntop() by some daily
+  builds picky compilers that otherwise do not need this function.
 
-- ntoa() and inet_ntoa_r() no longer used
+- changes: mention last fix
 
-- icc adjustments for icc 9.0 and prior versions:
-  
-    Disable remark #279: controlling expression is constant
+- ares_inet_ntop: remove definition and usage of macro SPRINTF
   
-        Remark triggered mostly on va_arg() and FD_ZERO() macros.
-
-- attempt to make work the gethostname function
-  check for winsock build target configurations
+  Existing definition of SPRINTF always resulted in sprintf() being used,
+  and sprintf() returning 'int' is already used throughout the library.
 
-Gisle Vanem (21 Sep 2008)
-- Added HAVE_NETDB_H, HAVE_ARPA_INET_H, HAVE_STRCASECMP
-  and HAVE_STRNCASECMP.
+- ares_inet_ntop: reapply changes from previous c-ares version (III)
+  
+  - Replace 'u_char' with 'unsigned char'.
+  - Replace 'u_int' with 'unsigned int'.
+  - use macros ERRNO and SET_ERRNO() for errno handling.
 
-Yang Tse (19 Sep 2008)
-- icc adjustments:
+- ares_inet_ntop: reapply changes from previous c-ares version (II)
   
-    Disable remark #981: operands are evaluated in unspecified order
+  - Remove rcsid.
+  - Adjust header file inclusions.
+  - ares_inet_ntop used only on systems without a proper inet_ntop function.
+
+- ares_inet_ntop: reapply changes from previous c-ares version (I)
   
-        Function calls which are triggering this remark, today, do not depend
-        on the order of evaluation of its arguments.
+  - Replace tabs with spaces.
+  - Use ANSI C style for function declarations and definitions.
+  - Use sizeof with parentheses.
+
+- ares_inet_ntop: fix off by one error triggering out of bounds write
   
-    Disable remark #1469: "cc" clobber ignored
+  ares_inet_ntop would trigger an out of bounds write when the representation
+  of the address required 15 characters, due to not taking in account null
+  termination character.
   
-        Remark triggered on htons() and ntohs() due to glibc header files.
-
-- icc adjustments
-
-- fix netdb.h prerequisite inclusion
-
-- improve detection of getservbyport_r()
+  Full import of inet_ntop.c from bind-9.5.3rc1 to pull additional fixes.
 
-- On Linux Intel's icc uses gcc's header files, so
-  we select ANSI C89 dialect plus GNU extensions.
+- ares_nowarn: add conditional inclusion of assert.h header
 
-- improve detection of gethostname()
+- fix compiler warning: conversion may lose significant bits
 
-- NetWare builds include "nameser.h" from the c-ares subdir
+- ares_inet_net_pton: fix non-rejection of some malformed literals
+  
+  ares_inet_net_pton would return wrong values when excessively large,
+  and invalid, netmasks are used. Fixes are from bind-9.5.3rc1,
+  issue also described in the WLB-2008080064 advisory.
 
-- include <strings.h>
+- setup_once: provide ISASCII macro
 
-- Sync up with reality
+- configure: inet_net_pton function check adjustments
+  
+  Define HAVE_INET_NET_PTON only when system's inet_net_pton function is IPv6
+  capable and is not affected by the WLB-2008080064 advisory.
+  
+  HAVE_INET_NET_PTON_IPV6 is no longer defined nor used.
 
-- adjust inclusion of "nameser.h"
+- ares_init: fix detection of semicolon comments in resolv.conf
+  
+  File resolv.conf may either use a hash '#' or a semicolon ';' character as an
+  indication that the rest of the line is a comment.  This fixes not recognizing
+  the semicolon as a valid comment indicator in resolv.conf.
 
-- reorder some lines in file
+- version: start working on 1.7.5
 
-- code cleanup
+Version 1.7.4 (8 Dec 2010)
 
-- NetWare seems to have writev()
+Daniel Stenberg (8 Dec 2010)
+- release-preps: CHANGES and RELEASE-NOTES synced
 
-- rearrange to allow internal/private use of ares_writev to any system
-  that lacks the writev function.
+- ares_set_local_*: added in 1.7.4, not before
 
-- NetWare CLIB target has stricmp() and strnicmp()
+Yang Tse (3 Dec 2010)
+- build: provide SIZEOF_SIZE_T definition for non-configure builds
 
-- include header file only when available
+- build: config.dos renamed to config-dos.h
 
-- rearrange to allow internal/private use of ares_strcasecmp to any system that
-  lacks the strcasecmp function.
+- build: provide SIZEOF_SIZE_T netware definition
 
-- improve detection of:
-    strcasecmp()
-    strcmpi()
-    stricmp()
-    strncasecmp()
-    strncmpi()
-    strnicmp()
+- ares_gethostbyaddr: fix compiler warning: conversion may lose significant bits
 
-- *** empty log message ***
+- configure: undo using autobuilds to temporarily verify strict aliasing warnings.
 
-Gisle Vanem (12 Sep 2008)
-- djgpp does have strdup().
+- fix compiler warning: rounding, sign extension, or loss of accuracy may result
 
-Yang Tse (12 Sep 2008)
-- change CRLF into LF line endings
+Daniel Stenberg (2 Dec 2010)
+- [Ben Noordhuis brought this change]
 
-- strdup() clone for systems/configurations which lack it
+  ares_parse_a_reply: fix CNAME response parsing
+  
+  Reply to a CNAME query doesn't contain addresses, causing
+  ares_parse_a_reply() to bail out with ARES_ENODATA
+  
+  Bug: http://groups.google.com/group/nodejs/browse_thread/thread/a1268c9ea5e9ad9b
 
-- move inclusion of ares_private.h last
+Yang Tse (1 Dec 2010)
+- fix compiler warning: conversion may lose significant bits
 
-- icc adjustments
+- atoi: remove atoi usage
 
-- icc adjustments
+- ares_init: fix compiler warning: conversion may lose significant bits
 
-- Select strict ANSI C89 conformance for icc
+- configure: fix autoconf warning
 
-- remove unnecessary typecasting of malloc()
+- inet_pton: fix compiler warning
 
-- remove unnecessary typecasting of realloc()
+- configure: use autobuilds to temporarily verify strict aliasing warnings.
+  
+  Temporarily, When cross-compiling with gcc 3.0 or later, enable strict aliasing
+  rules and warnings. Given that cross-compiled targets autobuilds do not run the
+  test-suite, there is no risk of running code that violates strict aliasing rules
 
-Daniel Stenberg (29 Aug 2008)
-- we start over working towards 1.5.4
+- ares_getnameinfo: Partially revert commit 85520d66e0ac7ac73411bc25e98769a88b2f
+  
+  Upon socket address family and length validation failure return ARES_ENOTIMP
+  in callback again, this is the error code documented in man page and used
+  mostly all over the library.
 
-Version 1.5.3 (29 Aug 2008)
+- ares_getnameinfo: Validate socket address family and length.
+  
+  Validate socket address family and that the socket address length is appropriate
+  for the specified family. Failure is reported with ARES_EBADFAMILY in callback.
 
-Daniel Stenberg (29 Aug 2008)
-- Version 1.5.3
+- ares_getnameinfo: fix two compiler warnings
 
-- added the three people from RELEASE-NOTES and sorted the list alphabetically
+- Added another VS10 version string
 
-Yang Tse (27 Aug 2008)
-- Don't abort configuration if recvfrom() is not available.
+- Fix GCC 4 compiler warning 'dereferencing type-punned pointer might break strict-aliasing rules'.
 
-- Functionality only possible if recvfrom() is available.
+- Revert commit 494274e653936335c255a47599970de3df21e7c4
 
-- George Neill's fix acountry sample application compilation failure.
+- configure: fix autoconf 2.68 warning: no AC_LANG_SOURCE call detected in body
 
-- Brad House's validation that DNS response address matches the request address
+- Fix compiler warning: array subscript has type 'char'
 
-- fix the output name
+- Fix GCC 4 compiler warning 'dereferencing type-punned pointer might break strict-aliasing rules'.
 
-- Get rid of ENABLE_64BIT symbol definition and usage.
+- Revert following commits:
+    07bc7ea79509bcc9ef6e09151e81766ed00d3392
+    3392a50ea3f8573ea4b7a9d82b9833dab60cb0e9
+    9912637d32c9987719a1ea12db591aee2941891c
   
-  Improve HAVE_LONGLONG symbol description.
-
-- Export 'ares_process_fd' too.
+  The purpose of the whole patch was to silence a compiler warning triggered
+  with GCC 4 on file ares_process.c  The specific compiler warning was
+  'dereferencing type-punned pointer might break strict-aliasing rules'.
+  
+  A simpler patch will follow to equally silence the warning.
 
-Gisle Vanem (16 Aug 2008)
-- Ops, remove 'use_vc'.
+- ares_options: reorder header inclusions to make inclusion of
+  ares_private.h the last included one again.
 
-- Support Watt-32 under Win32.
+Daniel Stenberg (12 Nov 2010)
+- [Patrik Thunstrom brought this change]
 
-Yang Tse (10 Aug 2008)
-- Fix: Remove now this SIZEOF_CURL_OFF_T symbol definition.
+  adig: fix NAPTR parsing
+  
+  I ran across a small "issue" in your adig example.
   
-  This should have been done with the initial 64-bit curl_off_t patch.
+  It is simply the last part of the NAPTR record, the replacement element,
+  which is not a string, as currently handled in adig, but a domain name.
 
-- Improve CURL_CHECK_DEF
+- ares_save_options: assignments instead of memcpy
 
-- Fix IBM C and DEC/Compaq C compiler detection
+- init_by_options: don't copy an empty sortlist
+  
+  If there aren't any sort items to copy, don't bother. Without this
+  little precaution it would do a malloc(0) which causes undefined
+  behaviors and is frowned upon by curl's memdebug-system.
 
-- Initial support of curlbuild.h and curlrules.h which allows
-  to have a curl_off_t data type no longer gated to off_t.
+Guenter Knauf (3 Oct 2010)
+- Minor Watcom makefile tweaks.
 
-- The minimum autoconf version required for this file is 2.50
-  
-  Avoid dot notation in aclocal serial file number, use a single number now.
+Daniel Stenberg (30 Sep 2010)
+- [Mike Crowe brought this change]
 
-Daniel Stenberg (4 Aug 2008)
-- - Fix by Tofu Linden:
-  
-    The symptom:
-    * Users (usually, but not always) on 2-Wire routers and the Comcast service
-    and a wired connection to their router would find that the second and
-    subsequent DNS lookups from fresh processes using c-ares to resolve the same
-    address would cause the process to never see a reply (it keeps polling for
-    around 1m15s before giving up).
+  Fix lookup with HOSTALIASES set.
   
-    The repro:
-    * On such a machine (and yeah, it took us a lot of QA to find the systems
-    that reproduce such a specific problem!), do 'ahost www.secondlife.com',
-    then do it again.  The first process's lookup will work, subsequent lookups
-    will time-out and fail.
+  ares__read_line returns ARES_EOF when it reaches the end of the
+  file. This will happen every time when reading to the end of the
+  HOSTALIASES file. Unfortunately single_domain treats this error as
+  being fatal.
   
-    The cause:
-    * init_id_key() was calling randomize_key() *before* it initialized
-    key->state, meaning that the randomness generated by randomize_key() is
-    immediately overwritten with deterministic values. (/dev/urandom was also
-    being read incorrectly in the c-ares version we were using, but this was
-    fixed in a later version.)
-    * This makes the stream of generated query-IDs from any new c-ares process
-    be an identical and predictable sequence of IDs.
-    * This makes the 2-Wire's default built-in DNS server detect these queries
-    as probable-duplicates and (erroneously) not respond at all.
+  Signed-off-by: Mike Crowe <mac@mcrowe.com>
 
-Yang Tse (4 Aug 2008)
-- Autoconf 2.62 has changed the behaviour of the AC_AIX macro which we use.
-  Prior versions of autoconf defined _ALL_SOURCE if _AIX was defined. But,
-  autoconf 2.62 version of AC_AIX defines _ALL_SOURCE along with other four
-  preprocessor symbols no matter if the system is AIX or not. To keep the
-  traditional behaviour, as well as an uniform one, across autoconf versions
-  AC_AIX is replaced with our own internal macro.
+Ben Greear (24 Aug 2010)
+- Add missing break that caused get_ares_servers to fail.
+  
+  Reported-by: Ning Dong <flintning@163.com>
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
 
-- Adjust DEC/Compaq C compiler settings.
+Yang Tse (11 Aug 2010)
+- configure: werror related adjustments
 
-- Another AC_TRY_LINK conversion to AC_LINK_IFELSE.
-  Proper definition of HAVE_function if function is found deeper.
+Guenter Knauf (8 Aug 2010)
+- Added copyright string to ares_version.h and make use of it in other files.
 
-- Sync up with reality
+- Block created ares_build.h for NetWare to avoid usage from other platforms.
 
-- Rename reentrant.m4 to avoid filename clash.
+- Fix to overwrite default libname.
 
-- Add file version serial number that might be used by 'aclocal' and others.
-  
-  Keep the '#' character as the first one on the line.
+- Some more Watcom makefile massage ...
 
-- Update copyright year.
+- Some more Watcom makefile massage ...
 
-- Sync comment with reality.
+Ben Greear (4 Aug 2010)
+- sock-addr-storage:  Detect and deal with lack of .ss_family member.
+  
+  AIX, at least, does not have sockaddr_storage.ss_family member.
+  Detect this in the configure logic and use proper #ifdefs in the
+  ares_process logic.
+  
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
+  Tested-by: Tor Arntsen <tor@spacetec.no>
 
-- Reinstate the 'aclocal -I m4' in buildconf and 'ACLOCAL_AMFLAGS = -I m4' way of
-  including our local m4/reentrant.m4 file. This even takes care of including the
-  file in the distribution tarball.
+Guenter Knauf (3 Aug 2010)
+- Added Watcom makefile based on libcurl's Makefile.Watcom.
 
-- Add quoting for the AC_DEFINE arguments.
+Ben Greear (31 Jul 2010)
+- typo:  Fix compile bug for platforms that don't have sockaddr_storage.
+  
+  Bug was introduced by me in previous commit.
+  
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
 
-- Also remove the whitespace.
+- Fix aliasing warning in gcc 4.4.4 (at least).
+  
+  Should be no functional change, though the code gets a bit
+  ugglier.
+  
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
 
-- Also remove the extra quoting.
+Daniel Stenberg (31 Jul 2010)
+- ares_set_servers_csv: use ISDIGIT
+  
+  The IS*() set of macros are preferred to the regular is*() functions as
+  they help us avoid the most common pitfalls.
 
-- Replace some '@%:@' quadigraphs by its actual representation '#'.
+Ben Greear (30 Jul 2010)
+- cast arg to isdigit to int
   
-  This quadigraph used before a C preprocessor 'define' directive could
-  be fooling M4, when processing this file, and make it think that the
-  line contains a pure M4 'define' macro.
+  Looks like it might silence a warning on Netware build.
+  
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
 
-- Tests done using 'aclocal -I m4' in buildconf and 'ACLOCAL_AMFLAGS = -I m4
-  in top Makefile.am triggered a problem that prevented aclocal from running
-  successfully on SunOS 5.10 with GNU m4 1.4.5 and GNU Autoconf 2.61
+- remove all uses of uint32_t
   
-  A tarball which reproduces mentioned problem is the one dated July-28-2008
-  http://cool.haxx.se/curl-daily/curl-7.19.0-20080728.tar.gz
+  Previous fix forgot a few.
   
-  We actually don't need all the bells and whistles that the above mechanism
-  provides. We only need to include our m4/reentrant.m4 file in acinclude.m4
-  so here we go with this simpler mechanism.
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
 
-- for debugging purposes show ACLOCAL_FLAGS
+- fix signed v/s unsigned casts warning in ares_gethostbyaddr.c
+  
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
 
-- These lines were unintentionally removed in previous commit
+- local-bind-fixup:  Fix inet_pton warning.
+  
+  Conditionally include <arpa/inet.h> for inet_pton
+  headers.
+  
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
 
-- Partially undo change that prevented SED, GREP, EGREP and AR from being changed by libtool or autoconf.
+- build:  Enable compiling with -Werror.
+  
+  This helps find compile warnings because they simply break
+  the build.
+  
+  To use:
+  ./configure --enable-warnings --enable-werror
+  
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
 
-- Assert that SED and GREP are set
+- ipv6: Fix some build issues related to the local-bind feature.
+  
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
 
-- Require autoconf 2.57 or newer
+Guenter Knauf (29 Jul 2010)
+- Replaced uint32_t with unsigned int to fix broken builds on a couple of platforms.
 
-- When calling aclocal, user defined ACLOCAL_FLAGS will now precede ours.
+Daniel Stenberg (18 Jul 2010)
+- [Ben Greear brought this change]
 
-- move ACLOCAL_AMFLAGS after AUTOMAKE_OPTIONS
+  local-bind:  Support binding to local interface/IPs
+  
+  Add 3 new functions to set the local binding for the out-going
+  socket connection, and add ares_set_servers_csv() to set a
+  list of servers at once as a comma-separated string.
+  
+  Signed-off-by: Ben Greear <greearb@candelatech.com>
 
-- setup.h handles definition of _REENTRANT based on NEED_REENTRANT
-  definition which might be defined in config.h or config-*.h files
+- version: now start on 1.7.4
 
-- Remove explicit inclusion of our m4 files first. It was interesting as a test,
-  but it breaks aclocal execution on some systems, with the following error:
-  
-  Can't locate object method "rel2abs" via package "File::Spec" at /usr/local/bin/aclocal line 256.
+- [Andrew C. Morrow brought this change]
 
-- Another step towards detecting if _REENTRANT is already defined or actually
-  needed, and being able to define it if appropriate for further configure tests
-  as well as for the generated config file.
+  fix memory leak in ares_getnameinfo
 
-- Explicitly include our m4 files first. This might minimize the impact
-  that other package's underquoted m4 function definitions have on ours.
+Version 1.7.3 (11 Jun 2010)
 
-- Add a 3 argument check for getprotobyname_r
+Daniel Stenberg (11 Jun 2010)
+- changelogs: updated for 1.7.3
 
-- move reentrant.m4 to the m4 subdirectory to avoid infinite loop inclusion problem
+- [BogDan Vatra brought this change]
 
-- add checks for strtok_r and getprotobyname_r
+  init: allow c-ares to work on Android OS
 
-- Another step towards detecting if _REENTRANT is already defined or actually
-  needed, and being able to define it if appropriate for further configure tests
-  as well as for the generated config file.
-  
-  Introduced reentrant.m4 intended for our reentrant related autotools/m4 macros.
+- changelog: fill in the 1.7.2 changes
 
-- reorder argument number detection for getservbyport_r to
-  actually verify if the test is properly working
+- added another pdf to ignore
 
-- Make sure that configure process tests are done with the same _REENTRANT
-  setting as the one actually used when finally building the library.
+Yang Tse (11 Jun 2010)
+- add ares_parse_mx_reply.c to VS dsp file
 
-- Change recvfrom's sixth argument data type to the 'historically standard' 'int'
-  data type for systems where this sixth argument is prototyped as a void pointer.
+Daniel Stenberg (10 Jun 2010)
+- tarball: add $(CSOURCES) $(HHEADERS) to EXTRA_DIST
   
-  Start of thread: http://curl.haxx.se/mail/lib-2008-07/0153.html
-
-- use prototypes to improve getservbyport_r detection
+  It's not clear to me why we need this, but we apparently may
+  otherwise not get all files bundled in the dist tarball.
 
-- Adjust recvfrom's sixth arg data type definition for NetWare (LIBC)
+- version: start working on 1.7.3
 
-- Use the sreadfrom() wrapper to replace recvfrom() in our code.
+Version 1.7.2 (10 Jun 2010)
 
-- when recvfrom prototype uses a void pointer for arguments 2, 5 or 6 this will
-  now cause the definition of RECVFROM_TYPE_ARG2_IS_VOID, RECVFROM_TYPE_ARG5_IS_VOID
-  or RECVFROM_TYPE_ARG6_IS_VOID, as appropriate.
+Daniel Stenberg (10 Jun 2010)
+- RELEASE-NOTES: 1.7.2 details added
 
-- Adjust DEC/Compaq C compiler settings
+- [Jakub Hrozek brought this change]
 
-- Added "pointer to void" as another data type to check for the sixth argument of
-  function recvfrom as a result of the info additionally logged when running on a
-  Solaris system.
-  
-  The compiler error showed that the prototype being used on Solaris was the one
-  declared in line 427 of "/usr/include/sys/socket.h" as:
-  
-  function(int,
-           pointer to void,
-           unsigned int,
-           int,
-           pointer to struct sockaddr,
-           pointer to void) returning int
+  ares_init: Last, not first instance of domain or search should win
 
-- Adjust DEC/Compaq C compiler settings
+- style: make code less than 80 columns wide
 
-- RECVFROM_TYPE_ARG2, RECVFROM_TYPE_ARG5 and RECVFROM_TYPE_ARG6 are now defined
-  to the data type pointed by its respective argument and not the pointer type.
+Yang Tse (31 May 2010)
+- [Tor Arntsen brought this change]
 
-- Configure process now checks availability of recvfrom() socket function and
-  finds out its return type and the types of its arguments. Added definitions
-  for non-configure systems config files, and introduced macro sreadfrom which
-  will be used on udp sockets as a recvfrom() wrapper.
+  improve alternative definition of bool to use enum instead of unsigned char
 
-- Initial DEC/Compaq C compiler detection and flags
+- fix VS2010 compiler warnings
 
-- Improved configure detection of number of arguments for getservbyport_r
+Daniel Stenberg (18 Apr 2010)
+- [Jérémy Lal brought this change]
 
-- Allow --enable-largefile and --disable-largefile configurations.
-  Configure process no longer needs nor checks size of curl_off_t.
-  Library will now be built with _REENTRANT symbol defined.
+  added ares_parse_mx_reply
 
-- fix compiler warning
+- repair the file mode
 
-- since Jun 30 2008 MAXHOSTNAMELEN define is no longer used
+- remove all $Id$ lines
 
-- fix c-ares version reported in generated libcares.pc file when building
-  from CVS tree.
+- remove all .cvsignore files
 
-- egrep and ar are also mandatory
+- spell fix
+  
+  reported by Gregor Jasny on the mailing list
 
-Daniel Stenberg (3 Jul 2008)
-- just to clarify that c-ares actually have some ipv6 support
+- [Peter Pentchev brought this change]
 
-- ares_gethostbyname() fallback from AAA to A records with CNAME present
+  Fix a couple of typos and grammar nits.
 
-- - Phil Blundell: If you ask ares_gethostbyname() to do an AF_INET6 lookup and
-    the target host has only A records, it automatically falls back to an
-    AF_INET lookup and gives you the A results.  However, if the target host has
-    a CNAME record, this behaviour is defeated since the original query does
-    return some data even though ares_parse_aaa_reply() doesn't consider it
-    relevant. Here's a small patch to make it behave the same with and without
-    the CNAME.
+- ignore the GPG signature files too
 
-Yang Tse (2 Jul 2008)
-- The configure process will now halt when sed or grep are unavailable
+- start the journey towards 1.7.2
 
-- fallback to gettimeofday when monotonic clock is unavailable at run-time
+- no longer CVS tagging
 
-- IBM C/C++ compiler predefined macro check
+- ignore generated PDFs
 
-- set earlier in configure process IBM compilers optimization flags
+Version 1.7.1 (23 Mar 2010)
 
-- make check message wording more precise
+Daniel Stenberg (23 Mar 2010)
+- 1.7.1
 
-Daniel Stenberg (30 Jun 2008)
-- - As was pointed out to me by Andreas Schuldei, the MAXHOSTNAMELEN define is
-    not posix or anything and thus c-ares failed to build on hurd (and possibly
-    elsewhere). The define was also somewhat artificially used in the windows
-    port. Now, I instead rewrote the use of gethostbyname to enlarge the host
-    name buffer in case of need and totally avoid the use of the MAXHOSTNAMELEN
-    define. I thus also removed the defien from the namser.h file where it was
-    once added for the windows build.
+- made README the primary readme file
   
-    I also fixed init_by_defaults() function to not leak memory in case if
-    error.
-
-Yang Tse (29 Jun 2008)
-- fix C style comment
-
-- John Lightsey filed bug report #1999181: "CLOCK_MONOTONIC always fails on
-  some systems" (http://curl.haxx.se/bug/view.cgi?id=1999181). The problem was
-  that the configure script did not use the _POSIX_MONOTONIC_CLOCK feature test
-  macro when checking monotonic clock availability. This is now fixed and the
-  monotonic clock will not be used unless the feature test macro is defined
-  with a value greater than zero indicating always supported.
-
-- Modified configuration script to actually verify if the compiler is good
-  enough at detecting compilation errors or at least it has been properly
-  configured to do so. Configuration heavily depends on this capability, so
-  if this compiler sanity check fails the configuration process will now fail.
+  ... and did README.cares to contain a historic reason etc.
 
-- No longer break out of a shell "for" statement from inside
-  AC_FOO_IFELSE macros, otherwise temp files are not removed.
-  
-  Identation adjustment.
+- s/CVS/git
 
-Gunter Knauf (11 Jun 2008)
-- enable additional CFLAGS from commandline.
+- git now, not CVS
 
-Yang Tse (9 Jun 2008)
-- fix pkg-config reporting of private libraries needed for static linking
+- ignore lots of generated files
 
-- MSVC does build Windows native targets
+- [Daniel Johnson brought this change]
 
-- Brad House fixed a missing header file inclusion in adig sample program
+  Fix warnings for clang
 
-Daniel Stenberg (29 May 2008)
-- start working on 1.5.3
+Yang Tse (17 Mar 2010)
+- replaced intel compiler option -no-ansi-alias with -fno-strict-aliasing
 
-Version 1.5.2 (29 May 2008)
+- update outdated serial number
 
-Daniel Stenberg (29 May 2008)
-- 1.5.2
+- fix compiler warning
 
-Yang Tse (26 May 2008)
-- fix compiler warning: unreferenced formal parameter
+- watt32 compilation fix
 
-Daniel Stenberg (23 May 2008)
-- list all local sources the (demo) tools need, add a few missing scripts to
-  the dist tarball and remove a two duplicate file names from EXTRA_DIST
-  (most of it pointed out by Yang Tse)
+- Added another VS10 version string
 
-- this is not used (anymore)
+- fix line break
 
-- make sure the configure.ac file with the correct version number is shipped
-  in the tarball
+- removed usage of 's6_addr', fixing compilation issue triggered with no
+  longer using 'in6_addr' but only our 'ares_in6_addr' struct
 
-Yang Tse (22 May 2008)
-- MSVC6+ clean-up targets must also remove acountry.exe
+Daniel Stenberg (5 Mar 2010)
+- Daniel Johnson provided fixes for building with the clang compiler
 
-- sync with reality
+Yang Tse (5 Mar 2010)
+- Added IPv6 name servers support
 
-- fix: [action-if-found] part of AC_CHECK_TYPE macro cannot be quoted when empty
+Gisle Vanem (5 Mar 2010)
+- Ops!. Readded ares_nowarn.h.
 
-- fix: remove need and definition of HAVE_SOCKLEN_T symbol
+- Added ares_nowarn.c.
 
-- fix: socklen_t definition comment
+Yang Tse (28 Feb 2010)
+- Added SIZEOF_INT and SIZEOF_SHORT definitions for non-configure systems
 
-- update several macros using AC_TRY_LINK with AC_LINK_IFELSE
+- Added ares_nowarn.* to VC6 project file
 
-- fix underquoting of AC_LANG_PROGRAM arguments
+- Added SIZEOF_INT definition
 
-- if'def out private function ares__tvdiff(), it is not in use yet.
+- fix compiler warning
 
-- update several macros using AC_TRY_LINK with AC_LINK_IFELSE
+- fix compiler warning
 
-- fix socklen_t equivalent detection when cross compiling Windows target
+- fix compiler warning
 
-- if WINSOCK2 API is used link with 'ws2_32', else
-  
-  if WINSOCK API is used under WinCE link with 'winsock', else
+Daniel Stenberg (17 Feb 2010)
+- ares_reinit()
   
-  if WINSOCK API is used link with 'wsock32'.
-
-- on winsock systems linking is done using library 'ws2_32' when
-  winsock2.h is available, and library 'winsock' is used when only
-  winsock.h is available.
-
-- minor change for wince-cegcc and wince-mingw32ce support
-
-- millisecond resolution support followup
-
-Gisle Vanem (15 May 2008)
-- Replaced "-DHAVE_FIONBIO" with "-DHAVE_IOCTLSOCKET".
-  Added "-DHAVE_GETTIMEOFDAY". Trimmed lines.
-
-Yang Tse (15 May 2008)
-- sync with reality
+  - To allow an app to force a re-read of /etc/resolv.conf etc, pretty much
+    like the res_init() resolver function offers
 
-- remove compilation time generated files
+- - Tommie Gannert pointed out a silly bug in ares_process_fd() since it didn't
+    check for broken connections like ares_process() did. Based on that, I
+    merged the two functions into a single generic one with two front-ends.
 
-- use same time source for timeout initialization and processing
+Yang Tse (30 Dec 2009)
+- VMS specific preprocessor symbol checking adjustments
 
-- Improve toolchain detection for WinCE cross compilation:
-  
-  When cross compiling WinCE with the arm-wince-cegcc-gcc C compiler
-  symbol __CEGCC__ is defined and the unix-like compatibility layer
-  is used. For our purposes this is not a native Windows build.
-  
-  When cross compiling WinCE with the arm-wince-mingw32ce-gcc C compiler
-  symbol __MINGW32CE__ is defined and the unix-like compatibility layer
-  is not used. For our purposes this _is_ a native Windows build.
+- Mention last changes
 
-- skip checks for Windows specific header files
-  when build target is not a native Windows one
+- - Fix configure_socket() to use ares_socket_t instead of int data type.
 
-- WinCE cross compilation adjustments:
+- - Where run-time error checks enabling compiler option /GZ was used it is now
+    replaced with equivalent /RTCsu for Visual Studio 2003 and newer versions.
   
-  HAVE_WINSOCK2_H shall not be defined.
-  HAVE_WS2TCPIP_H shall not be defined.
-
-Daniel Stenberg (13 May 2008)
-- - Introducing millisecond resolution support for the timeout option. See
-    ares_init_options()'s ARES_OPT_TIMEOUTMS.
+  - Compiler option /GX is now replaced with equivalent /EHsc for all versions.
 
-Yang Tse (13 May 2008)
-- also ignore this
+- - Ingmar Runge noticed that Windows config-win32.h configuration file
+    did not include a definition for HAVE_CLOSESOCKET which resulted in
+    function close() being inappropriately used to close sockets.
 
-- also ignore this
+Daniel Stenberg (30 Nov 2009)
+- start working on 1.7.1
 
-- ignore this compilation time generated files
+Version 1.7.0 (27 Nov 2009)
 
-- don't keep in CVS this compilation time generated file
+Yang Tse (27 Nov 2009)
+- Preserve empty line following last target
 
-- add MSVC6 project for acountry sample program
+- - Larry Lansing fixed ares_parse_srv_reply to properly parse replies
+    which might contain non-SRV answers, skipping over potential non-SRV
+    ones such as CNAMEs.
 
-- update MSVC6 projects to use the multithreaded DLL runtime library
+- When using icc, compile with -fpic and link with intel dynamic libraries.
 
-- add MSVC6 project for acountry sample program
+- Added 'currently' in italics to insist on transient situation.
 
-- skip libtool C++ preprocessor compiler and linker checks
+- Fix language
 
-- ignore libcares.pc
+- Daniel wants upcoming release to be 1.7.0
 
-- configure script will now define HAVE_CLOCK_GETTIME_MONOTONIC symbol only
-  when function clock_gettime() is available and the monotonic timer is
-  also available. Otherwise, in some cases, librt or libposix4 could be used
-  for linking even when finally not using the clock_gettime() function due
-  to lack of the monotonic clock.
+- Mention last changes
 
-- fix syntax error: missing semicolon
+- - Removed from external interface preprocessor symbol definition for
+    CARES_HAVE_ARES_FREE_DATA. Current functionality of ares_free_data()
+    makes it unnecessary.
 
-- Add library checking for clock_gettime() support
+- Added README.msvc
 
-- Use monotonic time source if available.
+- Changed c-ares naming conventions when using MSVC as described in README.msvc
 
-Daniel Stenberg (9 May 2008)
-- Removed AC_PROG_CC_STDC again. It enforces C99/gnu99 stdandard which is too
-  liberal for me. Also, autoconf 2.61 and earlier doesn't work with icc 10.1
-  for this macro. (2.62 confirmed to work though). See discusson on the mailing
-  list starting here:
-  
-  http://daniel.haxx.se/projects/c-ares/mail/c-ares-archive-2008-05/0001.shtml
+- - Mention other recent changes
 
-- include strings.h (if available) for the strcasecmp() proto
+- - Jakub Hrozek renamed addrttl and addr6ttl structs to ares_addrttl and
+    ares_addr6ttl in order to prevent name space pollution, along with
+    necessary changes to code base and man pages.This change does not break
+    ABI, there is no need to recompile existing applications. But existing
+    applications using these structs with the old name will need source code
+    adjustments when recompiled using c-ares 1.6.1.
 
-- check for strings.h in configure and use it for the strcasecmp() proto
+- - Jakub Hrozek fixed more function prototypes in man pages to sync them
+    with the ones declared in ares.h
 
-- adjusted to work with the updated configure.ac
+- Make configure remove the ares_build.h file included in distribution tarballs.
 
-- - Sebastian made c-ares able to return all PTR-records when doing reverse
-    lookups. It is not common practice to have multiple PTR-Records for a single
-    IP, but its perfectly legal and some sites have those.
+- Fix macro redefinition.
 
-- - Doug Goldstein provided a configure patch: updates autoconf 2.13 usage to
-    autoconf 2.57 usage (which is the version you have specified as the minimum
-    version). It's a minor change but it does clean up some warnings with newer
-    autoconf (specifically 2.62).
+- Fix name space pollution.
 
-Yang Tse (5 May 2008)
-- Improved parsing of resolver configuration files
+- Allow using different extra import libraries for debug and release builds.
 
-- make previous compiler warning fix more portable
+- Add manifest stuff to msvc makefile
 
-- fix compiler warning: indirection to slightly different base types
+- Sync man page with reality
 
-- fix compiler warning: local variable may be used without having been initialized
+- Add missing external API decoration for ares_set_socket_callback()
 
-- fix compiler warning: unreferenced formal parameter
+- Add ares_free_data() man page.
 
-- fix compiler warning: assignment within conditional expression
+- - Provide in external interface preprocessor symbol definitions for
+    CARES_HAVE_ARES_FREE_DATA as an indication of function availability.
 
-Daniel Stenberg (4 Apr 2008)
-- - Alexey Simak fixed the VC dsp file by adding the missing source file
-    ares_expand_string.c
+- Remove typecast
 
-- Alexey Simak made adig support NAPTR records
+- Fix comment
 
-- Eino Tuominen improved the code when a file is used to seed the randomizer
+- Add ares_data.c and ares_data.h
 
-Yang Tse (29 Feb 2008)
-- Force AIX xlc to fail and not generate object code if the source code has
-  compiled with errors. This behaviour is needed for autoconf macros which
-  rely on the ability to compile with or without errors, and is safer than
-  xlc's default of failing only upon severe errors.
+- Jakub Hrozek modified ares_parse_srv_reply() and ares_parse_txt_reply() API
+  to return a linked lists of results. These were also modified to internally
+  use the ares_data memory struct and as such its result must be free'ed with
+  ares_free_data().
 
-Gunter Knauf (27 Feb 2008)
-- added get_ver.awk since c-ares is a standalone project, and should therefore also compile when cURL is absent.
+- Initial support for the generic ares_free_data() function that will allow
+  applications to free memory allocated and returned by some c-ares funtions.
 
-- a couple of small fixes to the makefile:
-  fixed comments; fixed INSTDIR define, simplified rules;
-  changed to use get_ver.awk in current dir rather than the curl one.
+- Make usage of calloc()'s arguments consistent with rest of code base
 
-- fixed linker def file for tools when compiled with gcc/nlmconv.
+- workaround icc 9.1 optimizer issue
 
-- added some files which were missing in release tarballs.
+- Add icc fvisibility bug test
 
-- updated copyright for new year.
+- Fix icc 9.0 compiler warning: external definition with no prior declaration
 
-Gisle Vanem (2 Jan 2008)
-- Added '-d' option for Watt-32 debugging.
+- Fix three var names
 
-Yang Tse (18 Dec 2007)
-- MSVC 9.0 (VS2008) does not support Windows build targets prior to WinXP,
-  and makes wrong asumptions of build target when it isn't specified. So,
-  if no build target has been defined we will target WinXP when building
-  with MSVC 9.0 (VS2008).
+- Add check for assert.h header file
 
-Daniel Stenberg (11 Dec 2007)
-- build acountry too
+- getaddrinfo is fully thread safe on solaris versions which
+  implement the function even when h_errno is not a macro.
+  
+  The h_errno macro test now only done on systems for which there
+  is no hard coded knowledge about getaddrinfo's thread safeness.
 
-Gisle Vanem (11 Dec 2007)
-- Added acountry.c.
+- Remove files generated on previous buildconf/configure run
 
-- Added build of acountry.nlm.
+- Remove enable-thread / disable-thread configure option. These were only placebo
+  options. The library is always built as thread safe as possible on every system.
 
-- Added build of acountry.exe.
+- Refactor how preprocessor symbol _THREAD_SAFE definition is done.
 
-- Build acountry.exe. Added 'socklen_t' define.
+- Assume that getaddrinfo is thread safe, unless hard coded
+  knowledge says the contrary or h_errno is not defined.
 
-- Another sample application that returns country-code and
-  name from an IPv4-address or host-name. Using the service of
-  countries.nerd.dk.
+- Related with the threadsafe capability of getaddrinfo:
+  
+  - Constantine Sapuntzakis reported that Darwin 6.0 a.k.a. MAC OS X 10.2
+    and newer have a threadsafe getaddrinfo.
+  
+  - Fix Dragonfly BSD triplet detection.
+  
+  - In case the hard-coded knowledge says that getaddrinfo is threadsafe,
+    an additional check is done to verify that h_errno is also defined.
+    If h_errno isn't defined, we finally assume that it isn't threadsafe.
+    Jamie Lokier provided the inspiration for this extra check.
 
-Daniel Stenberg (10 Dec 2007)
-- grrr, the previous commit was meant to properly make sure that we don't
-  link any executables when doing debug builds since they kind of assume
-  symbols provided by libcurl, but it also wrongly included acountry.c
+- AIX 5.2 and newer have threadsafe getaddrinfo.
+  
+  Add some comments to better understand what the regex's pretend to achieve.
 
-- when building
+- HP-UX 11.11 and later have threadsafe getaddrinfo
 
-- build ahost and adig by default but don't install them
+- Check if getaddrinfo is threadsafe when function check allows it to be used
 
-Gisle Vanem (10 Dec 2007)
-- Fix for targets that do have 'struct in6_addr', but which doesn't
-  define 's6_addr' as a macro.
+- Renamed fpGetNetworkParams and fpSystemFunction036 to avoid namespace pollution with static library
 
-Yang Tse (3 Dec 2007)
-- Fix three issues previous cleanup introduces.
+- Add kernel32.lib
 
-Daniel Stenberg (3 Dec 2007)
--  Erik Kline cleaned up ares_gethostbyaddr.c:next_lookup() somewhat
+- Mention last changes
 
-- Brad Spencer fixed the configure script to assume that there's no
-  /dev/urandom when built cross-compiled as then the script cannot check for
-  it.
+- Reinstate copyright symbol lost in previous commit
 
-- the gethostbyname fix applied here as well
+- Make some strings different in resource file for debug or release builds
 
-- fix next_lookup() to continue searching even if c-ares failed to load the
-  /etc/hosts file, pointed out by Erik Kline:
-  http://daniel.haxx.se/projects/c-ares/mail/c-ares-archive-2007-11/0027.shtml
+- Ignore more subdirs
 
-- Remove the check for libdl since that isn't actually used and it causes
-  warnings. Pointed out by Robin Cornelius.
+- Fix compiler warning: conditional expression is constant
 
-- pkgconfig fix by Andreas Schuldei
+- Sync linker and resource compiler options with Makefile.msvc
 
-- spellfix
+- Follow Makefile.msvc subdirectory naming scheme, and sync compiler options
 
-- and we start on 1.5.2!
+- Updated MSVC makefile that allows building dynamic and static
+  c-ares libraries in debug and release flavours.
+  
+  Additionally each of the three sample programs is built against
+  each of the four possible c-ares libraries, generating all this
+  a total number of 12 executables and 4 libraries.
 
-Version 1.5.1 (21 Nov 2007)
+- Test for USE_WINSOCK since it is more restrictive than WIN32
 
-Daniel Stenberg (21 Nov 2007)
-- change
+- Make header inclusion depend on HAVE_*_H definition
 
-- oops
+- Remove unneeded preprocessor directives
 
-- start working on 1.5.1 now
+- Adjust c-ares include paths for memory tracking enabled (--enable-curldebug) builds
 
-Version 1.5.0 (21 Nov 2007)
+- source files used by sample programs
 
-Daniel Stenberg (21 Nov 2007)
-- this is what 1.5.0 is
+- Renamed c-ares setup.h to ares_setup.h
 
-- fill in missing copyrights
+- Adjust include paths to take in account that currently:
+  
+  c-ares with --enable-curldebug uses memdebug.h from libcurl's lib subdirectory.
+  
+  memdebug.h needs access to libcurl's setup.h from libcurl's lib subdirectory
+  and also needs access to libcurl's generated curl_config.h
 
-Gunter Knauf (18 Nov 2007)
-- removed now obsolete defines;
-  updated external library versions to latest.
+- Undo old temporary change once used for testing purposes
 
-Steinar H. Gunderson (16 Nov 2007)
-- Fix a double free.
+- Mention many changes
 
-Yang Tse (15 Nov 2007)
-- Needed now that in6_addr is referenced in ares.h
+- Mention --enable-symbol-hiding configure option
 
-Steinar H. Gunderson (15 Nov 2007)
-- When looking up in DNS and then in the hosts file, return the error code from DNS if both fail, instead of returning the error code from the hosts file, as today. Patch from the Google tree.
+- Symbol hiding configure options renamed to the hopefully less ambiguous
+  --enable-symbol-hiding and --disable-symbol-hiding as well as related
+  macro names and some internal variables used for them.
+  
+  Related configuration file preprocessor symbols named to
+  CARES_SYMBOL_HIDING and CARES_SYMBOL_SCOPE_EXTERN.
 
-- Return TTL data from ares_parse_{a,aaaa}_reply, if the user is so inclined. Patch from the Google tree.
+- Header inclusion depending on HAVE_* symbol.
+  Fix two typos.
 
-Yang Tse (8 Nov 2007)
-- Define WIN32 when build target is Win32 API.
-  This also defines it for WinCE even though it is a subset of WIN32.
+- Comparison of the Initial revision of this file with ares_parse_a_reply.c
+  shows that this one is actually a modified copy of ares_parse_a_reply.c.
+  
+  In order to comply with ares_parse_a_reply.c's M.I.T. license, the old
+  1998 M.I.T. copyright notice is now also preserved in this file the same
+  as it is done in other ares_parse_*.c files.
 
-- The only libraries actually needed for sample programs adig and
-  ahost are ws2_32.lib and advapi32.lib
+- Add CVS Id tag.
+  Fix identation of some license lines.
 
-- MSVC versions prior to VS2005 do not complain about portable C functions
+- Add CVS Id tag.
 
-- Windows build targets have socklen_t definition in ws2tcpip.h but some
-  versions of ws2tcpip.h do not have the definition. It seems that when
-  the socklen_t definition is missing from ws2tcpip.h the definition for
-  INET_ADDRSTRLEN is also missing, and that when one definition is present
-  the other one also is available.
+- Fix comment
 
-Gunter Knauf (22 Oct 2007)
-- removed dependency on gettimeofday() since we use only 1 sec resolution here.
+- In no particular order, changed/fixed all of the following in
+  ares_parse_txt_reply() current version:
+  
+  - Fixed a couple of potential double free's.
+  
+  - Fixed memory leaks upon out of memory condition.
+  
+  - Fixed pointer arithmetic.
+  
+  - Setting ntxtreply to zero upon entry for all failure cases.
+  
+  - Changed data type to size_t for variables substr_len, str_len and
+    the length member of ares_txt_reply struct.
+  
+  - Avoided a couple of memcpy() calls.
+  
+  - Changed i data type to unsigned int to prevent compiler warnings.
+  
+  - Adjusted a comment.
+  
+  - Use ARES_SUCCESS literal for successfull completion.
+  
+  - Added CVS Id tag.
 
-Yang Tse (20 Oct 2007)
-- Fix compiler warning: conversion from "int" to "unsigned short" may lose significant bits
+- Add c-ares DLL resource file to distribution archive
 
-- Fix message shown when detecting icc version
+- ignore files
 
-- Avoid shadowing a global declaration
+- Empty subdir
 
-- Renamed a variable to avoid shadowing a global declaration
+- Updated MSVC 6.0 workspace and project files that allows building
+  dynamic and static c-ares libraries in debug and release flavours.
+  
+  Additionally each of the three sample programs is built against
+  each of the four possible c-ares libraries, generating all this
+  a total number of 12 executables and 4 libraries.
 
-- Renamed internal function to avoid a variable shadowing it
+Daniel Stenberg (29 Oct 2009)
+- no need to check for NULL pointers before dereferencing, as the pointers
+  MUST be valid and they are dereferenced further down in the function
+  unconditionally!
 
-- Fix compiler warning: feupdateenv is not implemented and will always fail.
-  Specifically for linux x86-64 with Intel's icc.
+- shorten the descriptions somewhat
 
-- Sync PLATFORM_AIX_V3 detection and CURL_CC_DEBUG_OPTS()
-  icc warning level with libcurl's
+- update to the new struct name
 
-- Fix compiler warning: conversion from "int" to "unsigned char"
-  may lose significant bits
+- Jakub Hrozek added ares_parse_txt_reply() for TXT parsing
 
-- actually sync with lib/setup_once.h
+- use 'ares_srv_reply' for proper name-spacing
 
-- sync with lib/setup_once.h
+Yang Tse (29 Oct 2009)
+- Add reference for ares_parse_srv_reply.pdf
 
-Steinar H. Gunderson (16 Oct 2007)
-- Fix a bug where fallback from AF_INET6 to AF_INET would not work properly together with relative search; if you had a search path of .a.com and .b.com, and foo.a.com would return ARES_ENODATA and foo.b.com would return ARES_ENOTFOUND, the lookup would not properly retry with AF_INET as it forgot the first ARES_ENODATA.
+- Add reference for ares_parse_srv_reply docs
 
-Dan Fandrich (15 Oct 2007)
-- Mention first version with CURLOPT_COPYPOSTFIELDS.
-  Don't confuse NUL with NULL.
+- External API function linkage decoration adjustment
 
-Gisle Vanem (8 Oct 2007)
-- Added needed 'HAVE_*' defines.
+- External API function linkage decoration adjustment
 
-- 'FD_CLOXEC' is meaningless on MSDOS/Watt-32.
+- Initial step towards the ability to reduce c-ares exported symbols
+  based on the 'visibility' attribute for GNUC and __global for Sun
+  compilers, taking also in account __declspec function decoration
+  for Win32 and Symbian DLL's.
+  
+  Introducing configure options --enable-hidden-symbols and
+  --disable-hidden-symbols following libcurl's naming.
 
-Steinar H. Gunderson (4 Oct 2007)
-- Removed a piece of redundant code (process_answer already takes care of it).
+- Fix comment
 
-- Another timeout fix in ares_getnameinfo().
+- Fix spelling
 
-- Send the timeout count in ares_getnameinfo().
+- Fix Pelles C Win32 target compilation issues
 
-- Moved the NULL check for channel upwards in ares_destroy().
+- John Engelhart noticed an unreleased problem relative to a duplicate
+  ARES_ECANCELLED error code value and missing error code description.
 
-- Clarified the comment over ares_cancel.
+- Fix compiler warning: local variable may be used without having been initialized
 
-Yang Tse (2 Oct 2007)
-- Avoid a segfault when generating a DNS "Transaction ID" in internal
-  function init_id_key() under low memory conditions.
+- Use *_CHECK_PATH_SEPARATOR_REQUIRED to ensure that *_CHECK_PATH_SEPARATOR
+  is only expanded and included once in the configure script.
 
-- Add ares_llist.c and ares_llist.h to MSCV project file.
+- Our _AS_PATH_SEPARATOR_PREPARE override is now m4_defun'd instead of m4_define'd
+  due to autoconf 2.64 m4_require'ing it in _AS_SHELL_SANITIZE indirectly through
+  _AS_PATH_WALK.
 
-Daniel Stenberg (2 Oct 2007)
-- Fixed the problem where next_lookup would use 'status' uninitialized. Now
-  it gets passed the initial value as an argument.
+- Fix compiler warning: argument is incompatible with corresponding format string conversion
 
-Yang Tse (2 Oct 2007)
-- Avoid inline C99ism, and move c-ares routines for managing doubly-linked lists.
+- Fix potential out-of-bounds read
 
-Daniel Stenberg (1 Oct 2007)
-- ares_strerror() segfaulted if the input error number was out of the currently
-  supported range.
+- Fix compiler warning: loop without body
 
-- Prevent ares_strerror() from segfaulting if an invalid error code is passed
-  in as argument!
+- Fix compiler warning
 
-Yang Tse (30 Sep 2007)
 - Fix compiler warning
 
-- check availability of <netinet/tcp.h>
+- Fix compiler warning
 
-- improve portability, defining MAXDNAME and MAXCDNAME
+- Fix compiler warning: addition result could be truncated before cast to bigger sized type
 
-Steinar H. Gunderson (30 Sep 2007)
-- Fix a memory leak that I recently inadvertedly introduced.
+- Overhauled ares__get_hostent()
+  
+  - Fixing out of bounds memory overwrite triggered with malformed /etc/hosts file.
+  - Improving parsing of /etc/hosts file.
+  - Validating requested address family.
+  - Ensuring that failures always return a NULL pointer.
+  - Adjusting header inclusions.
 
-- Use ISDIGIT instead of isdigit; fixes a gcc warning.
+- Fix ssize_t redefinition errors on WIN64 reported by Alexey Simak
 
-- Port the TCP socket fix made in ares_fds() to ares_getsock() as well.
+- more files to ignore
 
-- Previously, processing a large batch of timeouts was O(n^2) in the number of
-  outstanding queries, and processing a DNS response packet was O(n) in the
-  number of outstanding queries. To speed things up in Google, we added a few circular,
-  doubly-linked lists of queries that are hash-bucketed based on
-  the attributes we care about, so most important operations are now O(1).
-  
-  It might be that the number of buckets are higher than most people would need,
-  but on a quick calculation it should only be 100kB or so even on a 64-bit
-  system, so I've let it stay as-is.
+- Check if _REENTRANT definition is required to
+  make errno available as a preprocessor macro.
 
-Gisle Vanem (29 Sep 2007)
-- We should standarise on C comments.
+- Attempt to silence bogus compiler warning: "Potential null pointer dereference"
 
-- Fix compiler warning in setsockopt().
+- ignore more files
 
-Steinar H. Gunderson (29 Sep 2007)
-- TCP queries can time out too, not just UDP queries. (Patch from the Google tree.)
+Gisle Vanem (7 Sep 2009)
+- Suppress warnings about unused prototypes in Watt32 and Win32 programs.
 
-- Read and process as many packets as possible in read_udp_packets, to avoid having to run the entire event loop once per packet. (Patch from the Google tree.)
+- Update email address.
 
-- There are two different places in write_tcp_data() that advance the send_queue; however, they are slightly different and only the first one properly uses a while loop. Consolidate both into a single function that DTTR. (Patch from the Google tree.)
+- Update my email address. Add ares_config.h as dependency for 'make depend'.
 
-- Reject names that are longer than 255 characters, to avoid problems with strict or buggy DNS server implementations. (Patch from the Google tree)
+Yang Tse (6 Sep 2009)
+- T_SRV portability check
 
-- In ares_mkquery, make sure we set buflen and buf to reasonable values if there's an error. (Patch from the Google tree)
+Gunter Knauf (5 Sep 2009)
+- changed includes to match style how we do with all other *.c files.
 
-- Be stricter about what's a valid IP address in fake_hostent. (Patch from the Google tree.)
+- changed u_int16_t to unsigned short because it is the only place within ares and curl where such a type would be used;
+  also it broke many autobuilds. We should probably introduce an ares_port_t if we want to use a type here.
 
-- Handle the root of the DNS tree correctly in ares_expand_name.
+Gisle Vanem (5 Sep 2009)
+- Replace 'uint16_t' with 'u_int16_t' since the latter is used in ares.h.
 
-Daniel Stenberg (28 Sep 2007)
-- today's modifications by Steinar and me
+- Added 'ares_parse_srv_reply.obj'. Added definition of 'u_int16_t'. This is I don't like; we should not depend on such non-universal types in a public header. But this is just a quick fix.
 
-- Bumped version to 1.5.0 for next release and soname bumped to 2 due to ABI
-  and API changes in the progress callback (and possibly more coming up from
-  Steinar)
+Daniel Stenberg (4 Sep 2009)
+- - Jakub Hrozek added ares_parse_srv_reply() for SRV parsing
 
-Steinar H. Gunderson (28 Sep 2007)
-- Unrevert previous 'missing' hunks. They were missing since the patch is still in for review :-)
+Steinar H. Gunderson (27 Aug 2009)
+- Support lookup of IPv4 literals in ares_gethostbyname(), even when the address family is set to AF_INET6.
 
-- Yet more missing hunks... Nggh.
+Gisle Vanem (3 Aug 2009)
+- Remove call to LoadLibrary(). (leftover from debugging).
 
-- Always register for TCP events even if there are no outstanding queries, as the other side could always close the connection, which is a valid event which should be responded to.
+- Fix bad sentence.
 
-- Forgot to include a few hunks from ares_process.c earlier. Fixing now.
+Daniel Stenberg (3 Aug 2009)
+- - Timo Teras changed the reason code used in the resolve callback done when
+    ares_cancel() is used, to be ARES_ECANCELLED instead of ARES_ETIMEOUT to
+    better allow the callback to know what's happening.
 
-- Support a few more socket options, and refactor the option setting a bit. (Patch from the Google tree.)
+- - Joshua Kwan fixed the init routine to fill in the defaults for stuff that
+    fails to get inited by other means. This fixes a case of when the c-ares
+    init fails when internet access is fone.
 
-- Make the query callbacks return the number of timeouts that happened during the execution of a query, and update documentation accordingly. (Patch from the Google tree.)
+Gunter Knauf (16 Jul 2009)
+- test if adding ../lib to includes can fix the current break ...
 
-- Three fixes in one commit (sorry): a) Take care of the tcpbuf if it ends while queued for transmission, note broken servers and close them in the main loop, and store TCP socket generation number in order not to send the same query twice over the same socket.
+- renamed generated config.h to ares_config.h in order to avoid clashes when libcurl is used with other projects which also have a config.h.
 
-- Don't skip a server if it's the only one. (Bugfix from the Google tree.)
+Yang Tse (21 Jun 2009)
+- Refactor how libraries are checked for connect() function, follow-up.
 
-Daniel Stenberg (27 Sep 2007)
-- wrong, revert the previous "fix" and instead check that the fd_set pointer
-  is non-NULL before we FD_CLR
+- Refactor how libraries are checked for connect() function,
+  and check for connect() as it is done for other functions.
 
-- eek, fix the conditions to return on either problem instead of requiring
-  both to occur
+Gisle Vanem (20 Jun 2009)
+- Remove unneeded defines.
 
-- Steinar H. Gunderson fixed: Correctly clear sockets from the fd_set on in
-  several functions (write_tcp_data, read_tcp_data, read_udp_packets) so that
-  if it fails and the socket is closed the following code doesn't try to use
-  the file descriptor.
+- Use select_s() and not select().
 
-- Steinar H. Gunderson modified c-ares to now also do to DNS retries even when
-  TCP is used since there are several edge cases where it still makes sense.
+Yang Tse (19 Jun 2009)
+- sclose() function-like macro definition used to close a socket,
+  now solely based on HAVE_CLOSESOCKET and HAVE_CLOSESOCKET_CAMEL
+  config file preprocessor definitions.
 
-- Brad House provided a fix for ares_save_options(): Apparently I overlooked
-  something with the ares_save_options() where it would try to do a malloc(0)
-  when no options of that type needed to be saved.  On most platforms, this was
-  fine because malloc(0) doesn't actually return NULL, but on AIX it does, so
-  ares_save_options would return ARES_ENOMEM.
+- add CloseSocket camel case function check
 
-- added initial pkg-config file (attempt)
+- check for socket() and closesocket() as it is done for other functions
 
-Gunter Knauf (20 Jul 2007)
-- added curl include for debug builds.
+- Remove HAVE_CONFIG_H definition from here,
+  CFLAGS from common.dj already defines it.
 
-Daniel Stenberg (14 Jul 2007)
-- added another SEE ALSO
+- initial step towards decoupling c-ares from libcurl for DOS
 
-- Brad House's fix to hish a win32 compiler warning
+- don't ignore these subdirs, they must be removed first
 
-- added Vlad's entire description of his valgrind fix
+- Remove DEBUGBUILD symbol definition, is not required for programs using the library.
 
-- Vlad Dinulescu fixed two outstanding valgrind reports
+- DEBUGBUILD symbol definition for debug builds
 
-Gunter Knauf (8 Jul 2007)
-- added better CodeWarrior detection.
+- ignore some subdirs
 
-- removed some obsolete include paths and defines.
+- fix comment
 
-- add test for gettimeofday() so that HAVE_GETTIMEOFDAY gets defined.
+- Try to make more clear that --enable-curldebug has nothing to do with --enable-debug for this library.
 
-- although the check for HAVE_STRUCT_TIMEVAL solved the redefine it is incorrect; lets see if a check for HAVE_GETTIMEOFDAY also works; if gettimeofday() is present then we can assume we have the timezone struct too.
+- Revert last change, it is inappropriate.
 
-- added check for sys/param.h.
+Gisle Vanem (12 Jun 2009)
+- Replace CURLDEBUG with DEBUGBUILD.
 
-- trial to catch problem with Daniels cross-mingw ares builds.
+Yang Tse (11 Jun 2009)
+- when running automake copy missing files instead of symlinking them
 
-- added NetWare CLIB-own header to solve gcc warnings.
+- Adjusted to take in account that...
+  
+  With the curl memory tracking feature decoupled from the debug build feature,
+  CURLDEBUG and DEBUGBUILD preprocessor symbol definitions are used as follows:
+  
+  CURLDEBUG used for curl debug memory tracking specific code (--enable-curldebug)
+  
+  DEBUGBUILD used for debug enabled specific code (--enable-debug)
 
-- few minor changes to make ares compile for NetWare CLIB architecture.
+- c-ares' --enable-debug --enable-curldebug decoupling follow-up
 
-- changed to build for CLIB / LIBC.
+- mention last changes
 
-- sync'd with lib makefile changes: use var for awk; fixed RECV* / SEND* defines; debug var can be overwritten; added better compiler path handling.
+- Remove buildconf.bat from release and daily snapshot archives.
+  
+  buildconf.bat is only for CVS tree builds.
 
-Daniel Stenberg (8 Jun 2007)
-- start working on 1.4.1
+- Ensure that buildconf.bat does nothing unless it is used with a CVS checkout.
 
-Version 1.4.0 (8 Jun 2007)
+- CVS-INFO file only present in CVS tree, never in release nor daily snapshot
+  archives. Used as a sentinel file in buildconf.bat to differentiate CVS builds.
 
-Daniel Stenberg (8 Jun 2007)
-- 1.4.0 preps
+Gisle Vanem (8 Jun 2009)
+- Update comment about "ML". Removed "-D_USE_32BIT_TIME_T" (not a requirement).
 
-- the revert
+Yang Tse (8 Jun 2009)
+- just comment it out
 
-- Revered Ashish Sharma's multiple entries patch, as it caused memory madness
+- For debugging purposes...
+  
+  Disable the '-export-symbols-regex' to discard this as the origin
+  of link failures related with shared libraries and non-GNU linkers.
 
-- minor edit since getting an ID seems pointless when failure happens
+- c-ares Makefile.am back to using $(top_builddir) for *_LDADD
 
-- fix the bad bad bad mess this caused on name resolves returning more than
-  one name... Reported by James Bursa
+- c-ares' -no-undefined and --enable-curldebug adjustments
 
-- Brad Spencer found and fixed three flaws in the code, found with the new
-  gcc 4.2.0 warning: -Waddress
+- Use relative path to built c-ares tree libtool library
 
-- Brad House fixed VS2005 compiler warnings due to time_t being 64bit.
-  He also made recent Microsoft compilers use _strdup() instead of strdup().
+- John E. Malmberg noticed that the configure script was failing to detect the
+  timeval struct on VMS when building with _XOPEN_SOURCE_EXTENDED undefined due
+  to definition taking place in socket.h instead of time.h
 
-- Ashish Sharma provided a patch for supporting multiple entries in the
-  /etc/hosts file. Patch edited for coding style and functionality by me
-  (Daniel).
+- Fix compiler warning: out of bound access