updated neon.changes
[platform/upstream/neon.git] / NEWS
1 Changes in release 0.30.0:
2 * Interface changes:
3  - none, API and ABI backwards-compatible with 0.27.x and later
4 * New interfaces and features:
5  - ne_ssl.h: added ne_ssl_clicert_import, ne_ssl_context_get_flag
6  - ne_session.h: added ne_set_addrlist2
7  - ne_socket.h: added ne_addr_canonical
8  - ne_auth.h: added NE_AUTH_GSSAPI_ONLY, NE_AUTH_SSPI (Nathanael Rensen)
9  - ne_basic.h: added NE_CAP_EXT_MKCOL options test
10  - ne_request.h: support chunked bodies with negative length passed to
11    ne_set_request_body_provider (Julien Reichel)
12 * Bug fixes:
13  - ne_path_escape: fix excessive memory allocation (Pierre Crokaert)
14  - SSPI auth: use canonical server hostname, clear SSPI context after
15    successful auth (Nathanael Rensen)
16  - build fixes for Open Watcom compiler (NormW)
17  - fix Win32 error code handling for local ne_sock_prebind bind failure
18  - Win32: support LFS, thread-safe OpenSSL (Diego Santa Cruz)
19  - GnuTLS: fix GnuTLS 3.x support (Matthias Petschick, Bartosz Brachaczek)
20
21 Changes in release 0.29.6:
22 * Don't abort SSL handshake with GnuTLS if a client cert is requested
23   but none is configured/available (thanks to Patrick Ohly)
24 * Fix the method string passed to create_request hooks to have the same
25   lifetime as the request object (Patrick Ohly)
26 * Docs updates.
27
28 Changes in release 0.29.5:
29 * Fix GnuTLS handshakes failures with 'TLS warning alert' (Bryan Cain)
30 * Further fix for SSPI support on Win32 (Danil Shopyrin)
31
32 Changes in release 0.29.4:
33 * Fix SNI support (Tobias Gruetzmacher)
34 * Fix possible Solaris linker errors if building static library
35 * Win32: Fix Kerberos authentication support with SSPI (Danil Shopyrin)
36 * Fix error handling when pulling a request body from an file
37   (thanks to Lou Montulli)
38 * Fix ne_request_dispatch() return value for SOCKS proxy failure cases
39 * Tighten SSL cert ID checks to deny a wildcard match against an IP address
40
41 Changes in release 0.29.3:
42 * Change ne_sock_close() to no longer wait for SSL closure alert:
43  - fixes possible hang with IIS servers when closing SSL connection
44  - this reverts the behaviour with OpenSSL to match 0.28.x, and
45    changes the behaviour with GnuTLS to match that with OpenSSL
46 * Fix memory leak with GnuTLS
47 * API clarification in ne_sock_close():
48  - SSL closure handling now documented
49  - return value semantics fixed to describe the implementation
50
51 Changes in release 0.29.2:
52 * Fix spurious 'certificate verify failed' errors with OpenSSL (Tom C)
53 * Fix unnecessary re-authentication with SSPI (Danil Shopyrin)
54
55 Changes in release 0.29.1:
56 * Fixes for (Unix) NTLM implementation:
57  - fix handling of session timeout (Kai Sommerfeld)
58  - fix possible crash (basic@mozdev.org)
59 * Fix unnecessary re-authentication with SSPI (Danil Shopyrin)
60 * Build fixes for Win32:
61   - fix use of socklen_t with recent SDKs (Stefan Kung)
62   - fix USE_GETADDRINFO on Win2K (Kai Sommerfeld)
63 * Fix build with versions of GnuTLS older than 2.8.0.
64
65 Changes in release 0.29.0:
66 * Interface changes:
67  - none, API and ABI backwards-compatible with 0.28.x and 0.27.x
68 * New interfaces and features:
69  - added NTLM auth support for Unix builds (Kai Sommerfeld, Daniel Stenberg)
70  - ne_auth.h: added NE_AUTH_GSSAPI and NE_AUTH_NTLM auth protocol codes
71  - added ne_acl3744.h, updated WebDAV ACL support (Henrik Holst)
72  - added built-in SOCKS v4/v4a/v5 support: ne_socket.h:ne_sock_proxy(),       
73    and ne_session.h:ne_session_socks_proxy()
74  - added support for system-default proxies: ne_session_system_proxy(),
75    implemented using libproxy where available
76  - ne_session.h: added NE_SESSFLAG_EXPECT100 session flag, SSL verification
77    failure bits extended by NE_SSL_BADCHAIN and NE_SSL_REVOKED, better 
78    handling of failures within the cert chain (thanks to Ludwig Nussel)
79  - ne_utils.h: added feature code NE_FEATURE_SYSPROXY
80  - ne_socket.h: ne_sock_writev() (Julien Reichel), ne_sock_set_error(),
81    ne_iaddr_raw(), ne_iaddr_parse()
82  - ne_string.h: ne_buffer_qappend(), ne_strnqdup()
83 * Deprecated interfaces:
84  - ne_acl.h is obsoleted by ne_acl3744.h (but is still present)
85  - obsolete feature "NE_FEATURE_SOCKS" now never marked present
86 * Other changes:
87  - fix handling of "stale" flag in RFC2069-style Digest auth challenge
88  - ne_free() implemented as a function on Win32 (thanks to Helge Hess)
89  - symbol versioning used for new symbols, where supported
90  - ensure SSL connections are closed cleanly with OpenSSL
91  - fix build with OpenSSL 1.0 beta
92  - updated Polish (pl) translation (Arfrever Frehtes Taifersar Arahesis)
93
94 Changes in release 0.28.6:
95 * SECURITY (CVE-2009-2473): Fix "billion laughs" attack against expat;
96   could allow a Denial of Service attack by a malicious server.
97 * SECURITY (CVE-2009-2474): Fix handling of an embedded NUL byte in
98   a certificate subject name with OpenSSL; could allow an undetected
99   MITM attack against an SSL server if a trusted CA issues such a cert.
100
101 Changes in release 0.28.5:
102 * Enable support for X.509v1 CA certificates in GnuTLS.
103 * Fix handling of EINTR in connect() calls.
104 * Fix use of builds with SOCK_CLOEXEC support on older Linux kernels.
105
106 Changes in release 0.28.4:
107 * Fix ne_forget_auth (Kai Sommerfeld)
108 * GnuTLS support fixes:
109  - fix handling of PKCS#12 client certs with multiple certs or keys
110  - fix crash with OpenPGP certificate
111  - use pkg-config data in configure, in preference to libgnutls-config
112 * Add PKCS#11 support for OpenSSL builds (where pakchois is available)
113 * Fix small memory leak in PKCS#11 code.
114 * Fix build on Haiku (scott mc)
115
116 Changes in release 0.28.3:
117 * SECURITY (CVE-2008-3746): Fix potential NULL pointer dereference in
118   Digest domain parameter support; could allow a DoS by a malicious server
119 * Fix parsing of *-Authenticate response header with LWS after quoted value
120 * Fix ne_set_progress(, NULL, ) to match pre-0.27 behaviour (and not crash)
121 * Fix to disable Nagle on Win32 with newer toolchain (thanks to Stefan Küng)
122 * Fix build on Netware (Guenter Knauf)
123 * Document existing ne_uri_parse() API postcondition and ne_uri_resolve()
124   pre/postconditions regarding the ->path field in ne_uri structures 
125 * Mark ne_{,buffer_}concat with sentinel attribute for GCC >= 4.
126 * Distinguish the error message for an SSL handshake which fails after a 
127  client cert was requested.
128 * Compile with PIC flags by default even for static library builds
129
130 Changes in release 0.28.2:
131 * Support "Proxy-Connection: Keep-Alive" for compatibility with HTTP/1.0
132  proxies which require persistent connections for NTLM authentication
133 * Fix an fd leak in ne_ssl_{,cli}cert_read (GnuTLS only)
134 * Enable fast initialization in GnuTLS.
135
136 Changes in release 0.28.1:
137 * Fix Win32 build
138 * Fix build on SCO OpenServer 5.0.x (thanks to Nico Kadel-Garcia)
139 * Fix handling of Digest domain parameter values without a trailing slash
140 * Fix build against apr-util's bundled libexpat.la in Subversion
141 * Add --without-pakchois to configure (Arfrever Frehtes Taifersar Arahesis)
142 * zh message catalog renamed to zh_CN, translation updated (Dongsheng Song)
143
144 Changes in release 0.28.0:
145 * Interface changes:
146  - none, API and ABI backwards-compatible with 0.27.x
147 * New interfaces:
148  - ne_pkcs11.h: added basic PKCS#11 support (requires GnuTLS and pakchois)
149  - ne_auth.h: added NE_AUTH_ALL and NE_AUTH_DEFAULT constants
150  - ne_socket.h: added ne_sock_peer(), ne_sock_prebind(), ne_sock_cipher()
151  - ne_session.h: NE_SESSFLAG_TLSSNI flag added; TLS SNI support is enabled
152    by default, where supported; ne_set_localaddr() added
153  - ne_request.h: added close_conn hooks (Robert J. van der Boon)
154  - ne_basic.h: added ne_options2()
155 * Other changes:
156  - add Polish (pl) translation (Arfrever Frehtes Taifersar Arahesis)
157  - add support for the 'domain' parameter in Digest authentication
158  - fix fd leak in ne_sock_connect() error path (Andrew Teirney)
159  - the FD_CLOEXEC flag is set on socket fds
160  - fix timezone handling in ne_dates for more platforms (Alessandro Vesely)
161  - fix ne_simple_propfind() to print XML namespaces in flat property values
162  - fix ne_get_range() for unspecified end-range case (Henrik Holst)
163  - fix ne_strclean() to be locale-independent and avoid possible Win32 crash
164  - fix ne_get_error() to not "clean" localized error strings
165  - fix ne_ssl_clicert_read() to fail for client certs missing cert or key
166  - Win32: fix build with VS 2008 (Stefan Kueng)
167  - Win32: fix neon.mak to not double-quote $(MAKE) (Henrik Holst)
168  - improve strength of Digest cnonces in GnuTLS builds
169
170 Changes in release 0.27.2:
171 * Fix crash in GSSAPI Negotiate response header verification (regression
172   since 0.26.x)
173
174 Changes in release 0.27.1:
175 * Fix regression in response progress counter for notifier/progress callbacks
176 * Fix interface description for ne_set_notifier() callback; sr.total
177   is set to -1 not 0 for an indeterminate response length
178
179 Changes in release 0.27.0:
180 * New interfaces:
181  - ne_session.h: ne_fill_proxy_uri() retrieves configured proxy,
182    ne_hook_post_headers() adds a hook after response headers are read,
183    ne_set_connect_timeout() sets session connection timeout,
184    NE_SESSFLAG_RFC4918, NE_SESSFLAG_CONNAUTH flags added
185  - ne_socket.h: ne_sock_connect_timeout() sets connection timeout,
186    ne_iaddr_reverse() performs reverse DNS lookup
187  - ne_string.h: ne_buffer_snprintf() prints to a buffer object
188  - ne_xml.h: ne_xml_resolve_nspace() resolves namespace prefixes
189 * Interface changes:
190  - ne_set_notifier() replaces ne_set_status(); finer-grained and type-safe
191    connection status information now provided; obsoletes ne_set_progress()
192  - ne_xml_dispatch_request() now only invokes the XML parser for 
193    response entities with an XML content-type, following RFC 3023 rules
194  - ne_acl_set() now takes a "const" entries array
195  - LFS compatibility functions *64 removed: all functions taking an
196    off_t now take an ne_off_t which is off64_t for LFS builds
197 * GnuTLS support now mostly feature-complete with OpenSSL support:
198  - greatly improved SSL distinguished name handling with GnuTLS >= 1.7.8
199 * Other changes:
200  - descriptive error messages for authentication failures
201  - SSPI support uses canonical DNS server name (Yves Martin)
202  - fixes for handling of "stale" parameter in Digest authentication
203  - added support for URIs in SSL server certificate subjectAltName field
204  - fix compiler warnings with expat 2.x
205  - fix handling of "Transfer-Encoding: identity" responses from privoxy
206
207 Changes in release 0.26.4:
208 * Fix Negotiate Authentication-Info response header verification with GSSAPI
209 * Fix multiple handlers with ne_add_{server,proxy}_auth (Werner Baumann)
210 * Fix SSPI build with some versions of MinGW (Gisle Vanem)
211 * Fix for SSPI segfault in response header verification (Mike DiCuccio)
212 * Fix error strings for CONNECT SSL proxy tunnel request failure
213 * Fix install-nls for VPATH builds (Hans Meine)
214 * Fix use of unencrypted client certs with GnuTLS
215 * Fix ne_lock* If: header insertion to use CRLF-terminated headers
216 * Fix test suite failures on QNX by working around send() length limit
217 * Fix handling of POSIX strerror_r failure case in ne_strerror
218 * Fix alignment issues in test suite MD5 code
219
220 Changes in release 0.26.3:
221 * Fix buffer under-read in URI parser (Laszlo Boszormenyi, CVE-2007-0157)
222 * Fix regression in handling of "attempt" argument passed to auth callbacks;
223   ensure the value only increments for each invocation of the callback
224 * Fix handling of "nextnonce" parameter in Digest authentication
225
226 Changes in release 0.26.2:
227 * Fix error reported for LOCK responses lacking a Lock-Token header.
228 * Use Libs.private in neon.pc for newer versions of pkg-config.
229 * Build fix for platforms without libintl.h.
230 * Build fixes for MinGW. (Matthias Miller)
231 * Build fix for h_errno detection on HP-UX 10. (Albert Chin)
232 * Win32: enable debugging; build fixes with some SDKs. (Kiyo Kelvin Lee)
233
234 Changes in release 0.26.1:
235 * Build fixes for Win32 (D.J. Heap) and OS X.
236 * Add Simplified Chinese translation (Dongsheng Song).
237
238 Changes in release 0.26.0:
239 * Added internationalization support:
240  - ne_i18n.h exposes ne_i18n_init(), a process-global initializer
241    which may be required for some applications
242  - (partial) message catalogs for cs, de, fr, ja, nn, ru and tr
243  - NE_FEATURE_I18N feature code added to indicate support
244 * Added support for GnuTLS (thanks to Aleix Conchillo Flaque):
245  - pass --with-ssl=gnutls to configure; GnuTLS >= 1.0.22 required
246  - use --with-ca-bundle to specify a default SSL CA root bundle
247  - some remaining issues with PKCS#12 certs in current GnuTLS releases,
248    distinguished name handling is sub-standard relative to OpenSSL
249 * Changes and additions to URI support:
250  - ne_uri structure: add query, fragment fields; authinfo renamed
251    to userinfo
252  - ne_uri_parse() now takes a URI-reference as input rather than 
253    the previous pseudo-URI syntax; the query and fragment components
254    are now parsed out.  Many malformed URIs are now rejected
255  - ne_uri_unparse() changed to respect the new fields
256  - ne_uri_resolve(): new function; resolves relative URI references
257  - ne_uri_copy(): new function, copies a URI structure
258 * Changed results callbacks for ne_lock_discover, PROPFIND interfaces:
259  - take URI as parsed ne_uri * structure rather than char *
260 * Added functions which give control over authentication protocol use:
261  - ne_add_server_auth(), ne_add_proxy_auth()
262 * Added ne_unhook_* functions to remove hooks
263 * Added ne_set_session_flags()/ne_get_session_flags() functions:
264  - flags to disable persistent connection support, enable "ICY"
265    protocol support, and to disable SSLv2 protocol support.
266  - replaces ne_set_persist()
267 * Added ne_set_request_flags()/ne_get_request_flags() functions:
268  - flags to enable 100-continue support, mark requests as non-idempotent
269  - replaces ne_set_request_expect100()
270 * Change ne_md5.h interface to make struct ne_md5_ctx opaque:
271  - added ne_md5_create_ctx(), ne_md5_destroy_ctx(), ne_md5_reset_ctx(),
272    ne_md5_finish_ascii(); removed ne_md5_init_ctx()
273  - fix alignment issues which could cause crashes in Digest code
274 * Fixed ne_get_range(), added ne_get_range64() (thanks to Lennart Poettering)
275 * Removed NE_FREE() macro from ne_alloc.h
276 * Added ne_strcasecmp(), ne_strncasecmp(), ne_tolower() functions
277   to ne_string.h - locale-independent string comparison
278 * Changed ne_sock_init()/ne_sock_exit() such that ne_sock_exit() 
279   only has effect once called an equal number of times to _init().
280 * Added "--enable-threadsafe-ssl=posix" configure flag, to enable
281   thread-safe SSL support using POSIX threads in OpenSSL/GnuTLS
282  - NE_FEATURE_TS_SSL feature code added to indicate support
283 * The manual is now licensed under the GPL rather than the GFDL
284
285 Changes in release 0.25.5:
286 * ne_ssl_clicert_decrypt(): catch and fail to load a client cert
287   with mismatched key/cert pair.
288 * Fix build issue on AIX 5.1.
289 * Fix warnings if built against OpenSSL >= 0.9.8.
290 * Win32: fix issues in SSPI implementation (Stefan Küng).
291
292 Changes in release 0.25.4:
293 * GSSAPI fixes for non-MIT implementations (Mikhail Teterin).
294 * Fix ne_print_request_header() et al to use 8K buffer size on all
295  platforms (fixes issue with long Destination: URLs on Win32).
296 * Win32 build fix for !USE_GETADDRINFO configuration.
297 * Documentation updates.
298
299 Changes in release 0.25.3:
300 * ne_lock() and ne_unlock(): fix cases where NE_ERROR would be returned 
301   instead of e.g. NE_AUTH on auth failure.
302 * Prevent use of poll() on Darwin.
303 * Fix gethostbyname-based resolver on LP64 platforms (Matthew Sanderson).
304
305 Changes in release 0.25.2:
306 * Really fix the Win32 build.
307
308 Changes in release 0.25.1:
309 * ne_get_content_type(): fix cases where the charset field was not set
310   to NULL after successful return (Johannes Schneider)
311 * Compressed response handling fixes:
312  - fix double invocation of reader callback with len=0
313  - fix cases where the reader callback return value was ignored
314 * Cache the new SSL session if the old one was expired (Robert Eiglmaier)
315 * Win32: fix build issues.
316
317 Changes in release 0.25.0:
318 * New interfaces:
319  - ne_get_response_header() replaces ne_add_response_header_handler
320  - ne_read_response_to_fd() and ne_discard_response() for use with
321    ne_begin_request/ne_end_request style response handling
322  - ne_xmlreq.h: ne_xml_parse_response() and ne_xml_dispatch_request()
323  - ne_has_support() for feature detection, replaces ne_support_ssl()
324  - ne_set_addrlist() can be used to bypass normal DNS hostname resolver
325  - ne_buffer_czappend(), convenience wrapper for ne_buffer_append.
326  - ne_iaddr_typeof() returns type of a socket object
327  - ne_get_content_type() replaces ne_content_type_handler()
328  - ne_set_request_expect100() replaces ne_set_expect100()
329 * New interfaces on LFS systems for large file support:
330  - ne_set_request_body_fd64() call for using an fd opened using O_LARGEFILE
331  - ne_set_request_body_provider64(), takes an off64_t length argument
332 * Interface changes:
333  - ne_set_request_body_fd takes offset and length arguments and returns void
334  - ne_set_request_body_provider takes length as off_t rather than size_t;
335    provider callbacks now MUST set session error string if returning an error
336  - response body reader callback returns an integer and can abort the response
337  - ne_decompress_destroy() returns void; errors are caught earlier
338  - ne_xml_failed() replaces ne_xml_valid(), with different return value logic
339  - ne_xml_parse() can return an error; ne_xml_parse_v() aborts the response if 
340    the parse either fails or is aborted by a handler returning NE_XML_ABORT
341  - ne_path_escape() now escapes all but unreserved characters
342  - ne_ssl_clicert_name() and ne_ssl_cert_identity() clarified to return UTF-8
343  - ne_ssl_clicert_name() clicert object argument is now const
344  - ne_uri_parse()/ne_uri_free() memory handling clarified
345  - removed the buffer length requirement for ne_read_response_block()
346 * Bug fixes:
347  - properly handle multiple Authentication challenges per request
348  - fixes and improvements to the Negotiate auth implementation
349  - handle proxies which send a 401 auth challenge to a CONNECT request
350  - XML: handle the UTF-8 BOM even if the underlying parser does not
351  - Win32: Fix timezone handling (Jiang Lei)
352  - ne_lock_refresh() works and will update timeout of passed-in lock
353  - persistent connection timeout handling fixes for CygWin et al
354  - impose hard limit of 1024 props per resource in ne_props.h response parsing
355 * New platform-specific features:
356  - Win32: Negotiate/NTLM support using SSPI (Vladimir Berezniker)
357  - Win32: Add IPv6 support using ENABLE_IPV6 neon.mak flag (Kai Sommerfeld)
358 * Removed features:
359  - the cookies interface has been removed
360  - removed functions: ne_service_lookup(), ne_put_if_unmodified()
361  - "qop=auth-int" support removed from Digest auth implementation
362 * Default XML parser search changed to check for expat before libxml2.
363
364 Changes in release 0.24.7:
365 * Compression interface fixes:
366  - fix issues handling content decoding and request retries from
367  authentication challenges (Justin Erenkrantz)
368  - fix places where reader callback would receive spurious size=0 calls
369  - fix to pass user-supplied userdata to user-supplied acceptance callback
370 * Fix for RFC2617-style digest authentication (Hideaki Takahashi).
371 * Fix to pick up gethostbyname() on QNX 6.2.
372
373 Changes in release 0.24.6:
374 * SECURITY (CVE CAN-2004-0398): Fix sscanf overflow in ne_rfc1036_parse,
375  thanks to Stefan Esser.
376 * Link libneon against libexpat during Subversion build using bundled neon.
377 * Win32 build script update (Jon Foster).
378
379 Changes in release 0.24.5:
380 * SECURITY (CVE CAN-2004-0179): Fix format string vulnerabilities in
381  XML/207 response handling, reported by greuff@void.at.
382 * Performance fix: avoid seeding the SSL PRNG if not creating an SSL socket.
383 * ne_ssl_readable_dname() is now defined to return UTF-8 strings.
384 * Fix case where gssapi/gssapi_generic.h was included but not present.
385 * Fix ne_utils.c build on platforms where zlib does "#define const".
386 * Fix use of ne_proppatch_operation with some C++ compilers.
387 * Update libtool for fix to --enable-shared on Darwin.
388 * BeOS: check for gethostbyname in -lbind (David Reid).
389
390 Changes in release 0.24.4:
391 * Ignore unclean SSL closure when response body is delimited by EOF
392  ("Could not read response body: Secure connection truncated" errors
393  with some buggy SSL servers).
394 * Fix test/ssl.c syntax errors with C89 compilers (Radu Greab).
395
396 Changes in release 0.24.3:
397 * Respect configure's --datadir argument (Max Bowsher).
398 * Fix build on Windows when OpenSSL is not used.
399 * Fix use of SSLv2 (spurious "Server did not present certificate" error).
400 * When using SSL via a proxy, prevent leaking server auth credentials
401  to the proxy, or proxy auth credentials to the server.
402
403 Changes in release 0.24.2:
404 * Fix name resolver with some old versions of glibc.
405 * Fix problems with configure's "time_t format string" detection.
406 * Fix problems when a broken Kerberos installation is found.
407 * When verifying SSL certificates, check iPaddress names in the
408  subjectAltName extension.
409
410 Changes in release 0.24.1:
411 * Add support for "GSS-Negotiate" Kerberos authentication scheme (from
412  Risko Gergely and Burjan Gabor).
413 * Disable Nagle to improve performance of small requests (thanks to
414  Jim Whitehead and Teng Xu).
415 * Fix compatibility with OpenSSL 0.9.6 (broken in 0.24.0).
416 * Fix prototype mismatch in ne_207.c.
417 * Define ssize_t from ne_request.h for Win32.
418 * Prevent segfault on zlib initialization failures.
419 * ne_sock_init does not fail if PRNG could not be seeded.
420 * Fix segfault in cookies code (Markus Mueller).
421 * Documentation updates.
422
423 Changes in release 0.24.0:
424 * Major changes to XML interface:
425  - have the start-element callback either accept, decline, abort, 
426  or return a state integer.
427  - remove 'struct ne_xml_elm'; callbacks are passed {nspace, name}
428  strings along with a state integer.
429  - dropped "collect", "strip-leading-whitespace" modes
430  - push responsibility for accumulating cdata onto caller; drop 'cdata'
431  argument from end-element callback.
432  - don't abort if no handler accepts a particular element, just ignore
433  that branch of the tree.
434  - dropped support for libxml 1.x and expat < 1.95.0.
435  - guarantee that start_element callback is not passed attrs=NULL
436  - add ne_xml_doc_encoding() to retrieve encoding of parsed XML document.
437 * Major changes to SSL interface:
438  - rewrite of interfaces for handling server and client certificates;
439  ne_ssl.h: many new functions available.
440  - only PKCS#12-encoded client certs are supported.
441  - changes to most names of SSL-related functions operating on an
442  ne_session, e.g. ne_ssl_load_cert->ne_ssl_trust_cert.
443  - client cert provider callback is passed the set of acceptable CA
444  names sent by the server
445  - the entire chain of certs presented by server is now accessible
446 * Remove unused ne_register_progress() from socket layer.
447 * Changes to resolver interface: ne_addr_first and _next return const;
448  ne_addr_print renamed to ne_iaddr_print; ne_iaddr_make and ne_iaddr_free
449  have been added.
450 * ne_request_create() now duplicates the method string passed in.
451 * ne_redirect_location() will now return NULL in some cases.
452 * Split socket creation to ne_sock_create() from ne_sock_connect:
453  - should report connect() error messages properly on Win32.
454 * Fix several memory leaks in error handling paths.
455 * Add a pkg-config file, neon.pc.in.
456
457 Changes in release 0.23.9:
458 * Fix inability to connect on AIX 4.3.
459 * neon-config exports includes needed for OpenSSL given by pkg-config.
460 * ne_redirect_location will return NULL if redirect hooks have not
461  been registered for the session (Ralf Mattes <rm@fabula.de>).
462
463 Changes in release 0.23.8:
464 * SECURITY: Prevent control characters from being included in the
465  reason_phrase field filled in by ne_parse_statusline(), and in
466  the session error string.
467 * Disable getaddrinfo() support on HP-UX; fix resolver for HP-UX 11.11.
468 * Fix digest auth response verification for >9 responses in session
469  (bug manifests as "Server was not authenticated correctly" error).
470 * On Linux, skip slow lookup for IPv6 addresses when IPv6 support is
471  not loaded in kernel (thanks to Daniel Stenberg for this technique).
472 * Update to autoconf 2.57 and libtool 1.4.3.
473
474 Changes in release 0.23.7:
475 * Fix for handling EINTR during write() call (Sergey N Ushakov).
476 * When available, use pkg-config to determine compiler flags needed to 
477  use OpenSSL headers and libraries.
478
479 Changes in release 0.23.6:
480 * Fixes for error handling in socket layer on Win32 from Johan Lindh
481  and Sergey N Ushakov <ushakov@int.com.ru>:
482  - meaningful error messages rather than "No error"
483  - handle persistent connection timeouts properly
484 * Fix to use RFC2617-style digest auth when possible (had reverted to 
485  only using RFC2068-style in 0.16.1).
486 * Fix NULL pointer dereference on certain ill-formed PROPFIND responses.
487 * Allow ne_sock_init to re-initialize after ne_sock_finish has been called
488  (Sergey N Ushakov).
489
490 Changes in release 0.23.5:
491 * Fix rejection of SSL server certificates which had commonName as
492  the least specific attribute in the subject name.
493 * Fix to dereference entities (e.g. "&amp;") in attribute values with libxml.
494 * Fix ne_socket.c build on HP-UX 10.20 (thanks to Branko Èibej)
495 * Remove misguided insistence on "secure" versions of zlib/OpenSSL;
496  no checks for zlib version are now performed, only OpenSSL 0.9.6 is
497  required.  --with-force-ssl, --with-force-zlib option removed.
498 * Add --with-egd[=PATH] option, conditionally enable EGD support; either 
499  using EGD socket at PATH, or fall back on system defaults.  $EGDSOCKET 
500  and $HOME/.entropy are no longer used.
501 * Add support for `--la-file' argument to neon-config, which prints the
502  full path of the installed libneon.la file.
503
504 Changes in release 0.23.4:
505 * Ignore an unclean SSL shutdown on persistent connection timeout
506  (fixing spurious "Secure connection truncated" errors).
507 * Fix a segfault on second and subsequent requests using a given
508  session, when the first fails with NE_LOOKUP.
509 * Fix configure for gcc installations which produce warnings by default
510  (such as gcc on hppa2.0n-hp-hpux11.00 using native as)
511
512 Changes in release 0.23.3:
513 * Further build fixes for Win32 (Blair Zajac).
514 * Another fix for use of SSL against Tomcat 3.2.
515
516 Changes in release 0.23.2:
517 * Build fix for Win32 (Blair Zajac).
518
519 Changes in release 0.23.1:
520 * Identify as correct version, not 0.22.
521
522 Changes in release 0.23.0:
523 * Improved address resolver (ne_addr_*) replacing ne_name_lookup():
524  - use getaddrinfo() if found; include support for IPv6 (based on work
525  by Noriaki Takamiya <takamiya@po.ntts.co.jp>)
526 * For a hostname with multiple addresses, each address is tried in turn
527  until a connection is made.
528 * Support for seeding OpenSSL's PRNG via $EGDSOCKET or $HOME/.entropy,
529  to enable SSL on platforms which lack a /dev/random device.
530 * RFC2818 compliance for certificate identity checks in SSL:
531  - use `dNSname' values in subjectAltName extension if present
532  - hostname comparison fixed to not be case-sensitive
533 * Fix interop with buggy SSL implementation in Tomcat 3.2.
534 * Added NE_DBG_SSL debug channel.
535 * ne_strerror changed to return the passed-in buffer.
536 * Added ne_strnzcpy macro to ne_string.h.
537 * Win32 build fixes, improvements, and documentation updates, from 
538  Blair Zajac <blair@orcaware.com>.
539 * Fix ne_sock_init so SIGPIPE signals are ignored even if SSL library
540  initialization fails (e.g. platforms without /dev/random).
541 * Added reference documentation:
542  - ne_sock_init, ne_addr_*.
543
544 Changes in release 0.22.0:
545 * Remove the const qualifier from the reason_phrase field in ne_status.
546  - ne_parse_statusline() now strdup's the reason_phrase
547 * Remove the status_line argument from ne_207_end_propstat and _end_response
548 * Change ne_session_create, ne_session_proxy, ne_sock_connect, and the 
549  'port' field of the ne_uri structure to use an unsigned int for port numbers
550 * ne_uri_defaultport returns unsigned and '0' on an unknown port (not -1).
551 * Changes to hooks interface:
552  - pass an ne_request pointer to per-request hooks
553  - replace "accessor" hooks with ne_{get,set}_{request,session}_private
554 * Authentication changes:
555  - the hooks changes fix a segfault if auth is enabled for an SSL session
556  through a proxy server
557  - fix ne_forget_auth segfault if either proxy or server auth are not used
558 * Improvements to persistent connection retry logic and error handling 
559  in request code; fixing some cases where some errors where incorrectly
560  treated as a persistent connection timeout
561  - a TCP RST at the appropriate time is now treated as a persistent 
562  connection timeout.
563  - handle persistent connection timeouts on SSL connections
564 * Changes to SSL support:
565  - improved error handling
566  - OpenSSL 0.9.6f or later is required for security fixes and functional
567  correctness; 0.9.6 or later required for functional correctness
568  - use --with-force-ssl to override OpenSSL version check
569  - fix for proxy CONNECT tunnelling with some proxies (e.g. Traffic-Server)
570  - fix potential segfault if client cert. provider callback is used
571  - fix to use supplied password callback for PEM-encoded client certificates
572  (Daniel Berlin <dberlin@dberlin.org>)
573 * strerror_r is used if available for thread-safe error handling.
574 * Remove ne_read_file().
575 * ne_version_match replaces ne_version_minimum (semantics changed slightly).
576 * XML request bodies use a content-type of "application/xml" now; 
577  applications can use NE_XML_MEDIA_TYPE from ne_xml.h
578 * Fix decompress code on big-endian or 64-bit platforms.
579 * Fix to build on Darwin 6 (aka Mac OS X 10.2) (Wilfredo Sánchez,
580  <wsanchez@mit.edu>)
581 * Win32 changes:
582  - remove conflict between OpenSSL's X509_NAME and recent versions of
583  the Platform SDK (Branko Èibej)
584  - fix inverted debug/non-debug build logic (Branko Èibej)
585  - add NODAV and OPENSSL_STATIC flags to neon.mak (Gerald Richter)
586
587 Changes in release 0.21.3:
588 * Fix segfault if using proxy server with SSL session and server
589  certificate verification fails.
590 * Fix leak of proxy hostname once per session (if a proxy is used).
591 * Add --with-libs configure argument; e.g. --with-libs=/usr/local picks
592  up any support libraries in /usr/local/{lib,include}
593
594 Changes in release 0.21.2:
595 * Fix 'make install' for VPATH builds.
596 * Use $(mandir) for installing man pages (Rodney Dawes).
597 * Follow some simple (yet illegal) relativeURI redirects.
598 * Always build ne_compress.obj in Win32 build (Branko Èibej).
599 * Fix decompression logic bug (Justin Erenkrantz <jerenkrantz@apache.org>)
600  (could give a decompress failure for particular responses)
601 * Fix ne_proppatch() to submit lock tokens for available locks.
602 * More optimisation of ne_sock_readline.
603
604 Changes in release 0.21.1:
605 * Don't include default SSL port in Host request header, which can
606  help interoperability with misbehaving servers (thanks to Rodney Dawes
607  <dobey@ximian.com>).
608 * Don't give a "truncated response" error from ne_decompress_destroy if
609  the acceptance function returns non-zero.
610 * Fix for Win32 build (Sander Striker <striker@apache.org>).
611 * Fix for cookie name/value being free()d (thanks to Dan Mullen).
612 * Optimisation of ne_sock_readline.
613
614 Changes in release 0.21.0:
615 * Socket layer implements read buffering; efficiency and performance 
616  improvement. Based on work by Jeff Johnson <jbj@redhat.com>
617 * Cleanup of socket interface:
618  - renamed everything, s/sock_/ne_sock_/, s/SOCK_/NE_SOCK_/
619  - removed unused and inappropriate interfaces.
620  - renaming done by Olof Oberg <mill@pedgr571.sn.umu.se>
621  - see src/ChangeLog for the gory details.
622 * Fix typoed 'ne_destroy_fn' typedef (Olof Oberg).
623 * Support OpenSSL/ENGINE branch.
624 * Bogus ne_utf8_encode/decode functions removed.
625 * ne_base64() moved to ne_string.[ch].
626 * ne_token drops 'quotes' parameter; ne_qtoken added.
627 * ne_buffer_create_sized renamed to ne_buffer_ncreate.
628 * ne_xml_get_attr takes extra arguments and can resolve namespaces.
629 * ne_accept_response function type takes const ne_status pointer.
630 * Drop support for automatically following redirects:
631  - ne_redirect_register just takes a session pointer
632  - ne_redirect_location returns an ne_uri pointer
633 * configure changes: --with-ssl and --with-socks no longer take a directory
634  argument.  To use SOCKS or SSL libraries/headers in non-system locations, 
635  use ./configure CPPFLAGS=-I/... LDFLAGS=-L/... 
636 * Reference documentation included for most of ne_alloc.h and ne_string.h,
637  and parts of ne_session.h and ne_request.h.
638  - see installed man pages, HTML documentation.
639
640 Changes in release 0.20.0:
641 * Major changes to DAV lock handling interface (ne_locks.h):
642  - struct ne_lock uses a full URI structure to identify locked resource
643  - ne_lock() requires that owner/token fields are malloc-allocated (or NULL)
644  on entry
645  - introduce a "lock store" type, ne_lock_store, to replace the lock session;
646  accessor functions all renamed to ne_lockstore_*.
647  - ne_lock_iterate replaced with a first/next "cursor"-style interface
648  - If: headers use an absoluteURI (RFC2518 compliance fix).
649  - fix for handling shared locks on DAV servers which return many active locks
650  in the LOCK response (thanks to Keith Wannamaker)
651 * Moved URI/path manipulation functions under ne_* namespace (ne_uri.h):
652  - path handling functions renamed to ne_path_*
653  - URI structure handling to ne_uri_*; struct uri becomes ne_uri.
654  - ne_uri_parse doesn't take a 'defaults' parameter any more
655  - if URI port is unspecified, ne_uri_parse sets port to 0 not -1.
656  - added ne_uri_unparse and ne_uri_defaultport functions.
657 * New 'ne_fill_server_uri' function to initialize a URI structure with
658  the server details for a given session (useful with locks interface).
659 * ne_decompress_{reader,destroy} are defined as passthrough-functions
660  if zlib support is not enabled.
661 * API change: ne_ssl_provide_fn returns void not int.
662 * Added NE_SSL_FAILMASK for verify failure sanity check.
663 * Removed return codes NE_SERVERAUTH and and NE_AUTHPROXY; correct
664  documentation, NE_PROXYAUTH is given for proxy auth failure.
665 * Require zlib >= 1.1.4 to avoid possible vulnerability in earlier versions.
666  See http://www.gzip.org/zlib/advisory-2002-03-11.txt for more details.
667  (version check can be skipped by passing --with-force-zlib to configure)
668 * New 'ne_ssl_readable_dname' function to create a human-readable string
669  from an X509 distinguished name.
670 * Fix support for newer versions of libxml2 (thanks to Jon Trowbridge 
671  <trow@gnu.org>).
672 * Fix corruption of reason_phrase in status object returned by
673  ne_propset_status.
674 * More lenient handling of whitespace in response headers.
675 * ne_content_type_handler will give a charset of "ISO-8859-1" if no charset
676  parameter is specified for a text/* media type (as per RFC2616).
677 * Miscellaneous cleanups and fixes (Jeff Johnson <jbj@redhat.com>).
678
679 Changes in release 0.19.4:
680 * Support bundled build of expat 1.95.x (Branko Èibej).
681
682 Changes in release 0.19.3:
683 * For platforms lacking snprintf or vsnprintf in libc, require trio.
684 * Add NE_FMT_OFF_T to fix Win32 build (Dan Berlin, Branko Èibej).
685 * Fix SSL support in Win32 build (Branko Èibej).
686
687 Changes in release 0.19.2:
688 * Fix non-SSL build broken in 0.19.1.
689 * Working SOCKSv5 support (thanks to Torsten Kalix <torsten.kalix@bredex.de>)
690
691 Changes in release 0.19.1:
692 * Add missing stubs for ne_ssl_* functions for non-SSL build.
693 * Fix some error messages in new SSL code.
694
695 Changes in release 0.19.0:
696 * Major API change: ne_session_create now takes (scheme, hostname, port) 
697  arguments: a session is clarified to be "a group of requests to a
698  certain server".
699  - removal of ne_session_server, ne_set_secure, and ne_set_proxy_decider
700  - ne_session_proxy returns void.
701  - DNS lookups are delayed until request dispatch time.
702 * Significant improvements to TLS/SSL support:
703  - SSL is enabled if scheme passed to ne_session_create is "https"
704  - new interfaces to load CA certs and to load SSL library's bundled CA certs
705  - add server cert verification callback.  An SSL connection to a server
706  with an unknown CA will now fail unless a verification callback is used.
707  - enable SSL session caching (performance improvement)
708  - support for wildcard server certs where commonName is "*.example.com".
709  - thanks to Tommi Komulainen for the contribution of code from mutt's
710  IMAP/SSL implementation under the LGPL, from which bits of this were derived.
711 * Improved SSL client certificate support:
712  - far simpler interface, all done at ne_session.h level.
713  - supports PKCS#12 and PEM-encoded certificates.
714  - optional callback for only providing client when demanded by server.
715 * Support for TLS upgrade is removed, since it isn't useful.
716 * If NEON_SSL is defined, API extensions are available to:
717  - allow access to the SSL_CTX * to adjust session SSL options
718  - retrieve the server certificate (X509 *)
719 * Decompress fixes:
720  - fix potential segfault in ne_decompress_destroy
721  - check the CRC of the deflated output (and fail if it doesn't match)
722  - fail appropriately on truncated responses, and trailing bytes in response. 
723 * Added ne_set_read_timeout to use configurable timeout on socket reads.
724 * Malformed response headers will be ignored rather than failing the request.
725 * ne_set_error takes printf-style vararg.
726 * Fixes for ne_get_range and improve error handling. 
727 * Functions which append to an ne_buffer do not return a success value,
728  but they do use ne_realloc/ne_malloc under the hood now, so an OOM callback
729  will be used (with the usual caveats).
730 * XML interface does not strip leading whitespace from cdata by default,
731  the NE_XML_STRIPWS flag is available to restore this feature if required.
732 * Upgraded to libtool 1.4.2:
733  - should fix --enable-shared on Mac OS X 10.1
734 * Test suite now contains over one hundred tests.
735
736 Changes in release 0.18.5:
737 * Removed old neon.dsp, neon.dsw.
738 * Update Win32 build to add OpenSSL and zlib support (Branko Èibej).
739 * Fix ne_compress.c to compile on Win32 (Branko Èibej).
740
741 Changes in release 0.18.4:
742 * Fixes for Content-Type parsing using ne_content_type_handler (Greg Stein)
743  - also now parses the charset parameter from header value.
744 * Removed ne_concat() function, which didn't work and wasn't used.
745
746 Changes in release 0.18.3:
747 * Fix parsing lock timeout from server (Arun Garg).
748 * Send Timeout headers in LOCK and refresh LOCK requests (Arun Garg).
749 * Updated neon.mak and config.hw.in for Win32 build (patch from
750  Branko Èibej <brane@xbc.nu>).
751 * Define XML_BYTE_ORDER for bundled expat build in support macro
752  NEON_XML_PARSER().
753
754 Changes in release 0.18.2:
755 * Fix --with-neon=PATH in support macros.
756 * Support DESTDIR in Makefile install targets (patch by
757  Pawel Golaszewski <blues@blysk.ds.pg.gda.pl>).
758 * Portability fixes:
759  - fix configure check for time_t on some platforms (e.g Solaris 2.6).
760  - remove expect100_works bitfield in ne_session structure (thanks to 
761  Yan Periard <yperiard@ems.net>).
762
763 Changes in release 0.18.1:
764 * Minor fix for authentication: "attempt" counter was not reset correctly
765  after authentication failed, so subsequent requests would not authenticate
766  correctly either.
767 * API change: ne_session_destroy returns void (there was no error case).
768 * Portability fixes (non-GCC compilers, 64-bit platforms, UnixWare 7)
769 * Optimisations in string manipulation routines.
770 * config.hw is included in the release tarball again.
771 * Improvements in the autoconf support macros:
772  - check for neon-config in PATH if --with-neon is not given
773  - stop if --with-neon is used, and the check for external neon fails
774  - added NEON_WITHOUT_ACL to prevent build of ne_acl.o
775
776 Changes in release 0.18.0:
777 * API change: authentication callback is passed fixed-size username/password
778  buffers, and an 'attempt' counter.  Authentication is retried *forever*
779  until either it succeeds, or the callback returns non-zero.
780 * API clarifications:
781  - ne_propname may have a NULL nspace field, indicating the property has no 
782  namespace.  This holds for properties returned by the propfind interfaces.
783  - added NE_ELM_PROPS_UNUSED as the lowest element number which should
784  be used with handlers added to the XML parser returned by 
785  ne_propfind_get_parser.
786 * Fixes and cleanups of lock discovery interface.
787 * Fix for short write handling in ne_get() (thanks to rado <dzusto@yahoo.com>).
788 * Fix for XML namespace prefix handling where a prefix could be mapped to an 
789  incorrect URI (e.g. in PROPFINDs against mod_dav with >10 namespaces used)
790 * Add '--support <feature>' option to neon-config; the script exits with
791  success if given feature is supported. Known features are ssl, dav, zlib.
792 * Support for SSL, DAV, zlib is exported by neon.m4 as shell variable 
793  NEON_SUPPORTS_{SSL,DAV,ZLIB}={yes,no} for bundled and external builds.
794 * `neon-config --cflags` won't include -I/usr/include for SSL build.
795 * Fix to call progress callbacks while sending request bodies again.
796 * Test changes:
797  - portability fixes, auth interface and progress tests.
798
799 Changes in release 0.17.2:
800 * Accept Status-Lines with no reason phrase (Jeremy Elson).
801 * Fix handling of persistent connection timeout, and better error
802  handling if sending a request fails.
803 * Fix crashes in locking code.
804 * Return parse error on XML namespace prefix declaration with
805  an empty value. Thanks to Julian Reschke.
806 * Allow passing property names with NULL namespace to ne_proppatch.
807 * Fix for cross-compilation (Mo DeJong).
808 * Moved ne_propname definition from ne_207.h to ne_props.h.
809 * Test changes:
810  - updated for Status-Line parsing changes (Jeremy Elson)
811  - better persistent connection tests
812  - fixed for --disable-webdav build
813
814 Changes in release 0.17.1:
815 * Add support for ACL method (Arun Garg <arung@pspl.co.in>),
816  see ne_acl.h.
817 * Fixes and clean up of libraries exported via `neon-config --libs'
818 * Fix timezone handling when parsing dates (on some platforms).
819 * Upgrade to autoconf 2.52 and libtool 1.4 (thanks to Mo DeJong).
820 * Cleanup/simplification of request dispatching:
821  - better handling of error cases, including fix for a possible
822  infinite loop when the server closes the connection prematurely.
823 * Add '--without-zlib' configure option.
824 * Test changes:
825  - prettify output; imitate Perl test suite output.
826  - add tests for interim 1xx responses, persistent connections, more
827  unbounded operations.
828
829 Changes in release 0.17.0:
830 * Add support for decoding gzip Content-Encoding: see ne_compress.h.
831  - built if zlib is found; `neon-config --cflags' will define NEON_ZLIB if so.
832 * Rewrite hooks interface to register individual callbacks.
833  - inspired by the Apache 2.0/APR hooks interface
834 * Register cookies hooks using ne_cookie_register().
835 * Clean up configure scripts to enable use of autoconf 2.5x (Mo DeJong).
836 * Use new endianess configure macro to allow cross-compiling (Mo DeJong).
837 * Fix invalid C code in sock_init() in Win32 build (Mo DeJong).
838 * Fix use of signal() on Win32 (Mo DeJong).
839 * Workaround libxml 1.x string handling not being UTF-8.        
840 * Test changes:
841  - add tests for decompression interface.
842
843 Changes in release 0.16.1:
844 * Also handle write errors in ne_get_range.
845 * Dump request body blocks in debugging mode.
846 * Fix ne_shave() causing memory corruption when the result should 
847   have been the empty string.
848 * Refactor auth header parsing code; more efficient now. 
849  - fixes digest auth RFC2617-style broken in 0.16.0
850
851 Changes in release 0.16.0:
852 * API change: ne_copy takes a depth parameter (thanks to Arun Garg, Medha Atre)
853 * API change: validate callback to ne_xml also takes a userdata arg.
854 * Added 'ne_lock_refresh' for performing lock refresh (Arun Garg).
855 * Add SSL support to Win32 build (Peter Boos <PediB@colorfullife.com>)
856   (see INSTALL.win32 for details).  Compile with USE_DAV_LOCKS also.
857 * Remove Server header parser for 100-continue support in ne_options.
858   (and remove broken_expect100 from ne_server_capabilities).
859 * Set SIGPIPE disposition to "ignored" in sock_init().
860 * On platforms with setvbuf(), turn off buffering for the debug log 
861   stream.
862 * Ignore repeated calls to sock_init().
863 * Fixes to error handling in ne_get_range.
864 * Minor improvements to memory handling in auth code.
865 * Fix for start_propstat callback being called with NULL response
866   argument when given invalid XML, causing a segfault in propfind code.
867 * Test changes:
868  - add regression test for the propfind segfault.
869  - handle segfaults better (reap the child, flush the debug log).
870
871 Changes in release 0.15.3:
872 * Fix --with-expat=DIR build.
873
874 Changes in release 0.15.2:
875 * Fix Win32 for XML parser changes (Gerald Richter).
876 * Substitute versions into config.hw at distribution time.
877 * Add date parser for ISO8601-formatted dates as defined by RFC2518, e.g. 
878   the creationdate property (Taisuke Yamada <tai@iij.ad.jp>).
879 * Fix Y2K bug in RFC1036 date parsing algorithm.
880 * Test changes:
881  - add tests for date parsing functions.
882
883 Changes in release 0.15.1:
884 * Win32 update from Gerald Richter <richter@ecos.de>
885  - new files neon.mak, INSTALL.win32
886 * Fix for ne_socket.h includes (Mo DeJong).
887 * More improvements for XML parser selection logic:
888  - if parser is required, be sure to fail configure if none is found.
889  - added --with-included-expat for bundled expat logic.
890 * Rename --enable-debugging to --enable-debug (Mo DeJong).
891  - added NEON_DEBUG macro to exported autoconf macros.
892 * Call progress callbacks for request bodies.
893 * Test changes:
894  - check that reading response headers is a bounded operation.
895  - use a pipe between child and parent to avoid race condition and 
896  tedious sleep().
897
898 Changes in release 0.15.0:
899 * Major API renaming to use ne_/NE_ namespace:
900  - http_ to ne_, HTTP_ to NE_, dav_ to ne_, DAV_ to NE_, neon_ to ne_
901  - hip_xml_ to ne_xml_, HIP_ELM_ to NE_ELM_, HIP_XML_ -> NE_XML_
902  - sbuffer_ to ne_buffer_
903  - DEBUG() to NE_DEBUG(), DEBUG_ to NE_DBG_
904 * Type renames:
905  - http_req to ne_request
906  - sbuffer to 'ne_buffer *'
907 * Note, 'ne_buffer' is not an implicit pointer type, you must 
908   specify the '*' now, e.g. 'ne_buffer *buf = ne_buffer_create();'.
909 * ne_buffer is no longer opaque.
910  - ne_buffer_data() removed: use buf->data instead.
911  - ne_buffer_size() is a macro.
912 * Header renames and additions:
913  - http_request.h -> ne_request.h
914  - Session code split into ne_session.h
915  - hip_xml.h -> ne_xml.h, nsocket.h -> ne_socket.h, http_utils.h -> ne_utils.h
916  - neon_md5.h -> ne_md5.h, dav_207.h -> ne_207.h
917  - http_basic.h and dav_basic.h merged into ne_basic.h
918 * New functions:
919  - ne_token and ne_shave, to obsolete split_string, shave_string.
920 * Removed: ne_get_request_headers().
921 * autoconf changes:
922  - disable building shared neon library by default.
923  - option --enable-libxml is replaced by --with-libxml1 and
924  --with-libxml2 to force use of a particular parser.
925 * Fix auth code to only take MD5 digests of response body blocks when
926   necessary (thanks to Kai Sommerfeld).
927 * Fix alignment bug in MD5 code which could cause SIGBUS on Sparc 
928   architectures (Kai Sommerfeld).
929 * Rewrite of request body handling:
930  - ne_set_request_body_fd replaces _stream, using an int fd rather than
931  a FILE *.
932  - added ne_set_request_body_provider to give a callback which is called
933  to provide request body blocks.
934  - removal of 'use_body' hook in favour of 'ne_pull_request_body' function
935  to allow hooks to manually read the request body.
936  - ne_{put,get,post,put_if_unmodified} all take an integer fd rather than a
937  FILE * stream.
938 * Test changes:
939  - added framework for testing "over the wire" (fork a server process)
940  - added tests for response message length handling, chunked responses, 
941  header folding, sending request bodies.
942  - start at listing RFC2616 requirements and whether they are met
943  or not in test/STATUS.
944  - test for MD5 alignment bug on Sparc (thanks to Kai Sommerfeld).
945
946 Changes in release 0.14.0:
947 * Add C++ inclusion safety to http_auth.h (Kai Sommerfeld).
948 * Define ssize_t on Win32. (Kai Sommerfeld).
949 * Add C++ inclusion safety to dav_locks.h and ne_alloc.h (thanks to
950   Gregor Bornemann <Gregor.Bornemann@germany.sun.com>).
951 * Significant API change to properties code, to allow use of allprop
952   and complex properties:
953  - dav_propfind_set_complex and _set_flat are removed.
954  - add parameter to dav_propfind_named to take the list of property names 
955    to be fetched.
956  - new function dav_propfind_set_private to set private callback.
957  - all properties not handled by caller are stored as flat properties.
958 * Untested: add basic SOCKSv5 support: configure --with-socks.
959  - please report success/failure to neon@webdav.org
960 * Win32/MSVC build files from Magnus Sirwiö <sirwio@hotmail.com>.
961 * Fix for expat detection from Shane Mayer <shanemayer42@yahoo.com>.
962 * Namespace-protect md5 code and more.
963  - md5_* -> ne_md5_*
964  - ascii_to_md5 -> ne_ascii_to_md5 (and moved to neon_md5.h)
965 * Parse authinfo segment in URIs (Johan Lindh <johan@link-Data.com>).
966  - added 'authinfo' field to struct uri.
967 * New API: hip_xml_get_attr to retrieve attributes.
968 * Store language for properties, access with dav_propset_lang.
969  - only if property is defined on the property element itself.
970 * Started a simple test suite (test/*).
971  - includes some simple HTTP server tests.
972 * Remove "Content-Length: 0" header for request with no body, fixing
973   interop with Squid 2.3-STABLE1 (thanks to Kai Sommerfeld).
974 * http_parse_statusline skips leading whitespace. (Johan Lindh). 
975 * Partial fix for timezone/date parsing problems.
976
977 Changes in release 0.13.0:
978 * Fix ne_strndup allocating one byte less than it should (Kai Sommerfeld)
979  - if you use uri_parse, this bug may have caused subtle memory corruption 
980    in your application. 
981 * Revert API changes in 0.12: property values are not UTF-8 encoded/decoded
982   internally.  (thanks to Greg Stein)
983 * Add another optional argument to NEON_BUNDLED macros, actions to
984   be run if bundled build is *not* selected.
985 * API change: added argument to http_add_hooks to register cleanup function
986   for the cookie.
987 * Removed dav_lock_unregister in favour of automatic cleanup when session
988   is destroyed.
989 * Fixed leaks in redirect code (Kai Sommerfeld).
990 * Fixed crashes in hip_xml_destroy (Kai Sommerfeld).
991 * Redirects to a different hostname/port/scheme are never followed: the request
992   will fail with HTTP_REDIRECT instead.  Redirect notification callback is 
993   only called for *followed* redirects.
994   New API: http_redirect_location() for retrieving location of last redirect.
995 * Authentication is now implemented as a hook, independently of http_request.c:
996  - API change: removed 'hostname' argument from auth callbacks.
997  - API change: you must now include http_auth.h from your application.
998  - Also fixes case of using server and proxy authentication simultaneously
999 * Added 'http_forget_auth' to clear authentication session.
1000 * New API: http_session_hook_private for retrieving private per-session cookie 
1001   for hooks.
1002 * API change: http_set_request_body_stream has a return error value.
1003 * API change: http_set_request_body_buffer now takes the buffer length too.
1004 * New API: caller-pulls interface for reading response body: 
1005   http_begin_request, http_end_request, http_read_response_block. 
1006   An alternative to using the (much simpler) http_request_dispatch.
1007 * Make --disable-webdav build work.
1008 * New API: dav_propnames for retrieving property names.
1009 * New API: dav_propfind_get_request to access request object of handler.
1010 * API change: progress and connection status callbacks implemented at
1011   http_request.h level. Socket-level status callbacks removed, progress
1012   callbacks made per-socket.
1013 * Supports new expat (Sam TH <sam@uchicago.edu>)
1014 * Supports libxml2 (in preference to libxml1).
1015 * API change: added namespace protection to base64 and dates functions:
1016   all have ne_ prefix now.
1017 * Fixed ranged GETs where a specific range is requested (Johan Lindh 
1018   <johan@linkdata.se>).
1019 * Limit number of response header fields to 100.
1020 * Allow requests for the '*' URI even if a proxy server is in use.
1021 * libxml: Get useful error messages for parse errors.
1022
1023 Changes in release 0.12.0:
1024 * Portability fixes to http_request.c and http_auth.c.
1025  - fixes digest auth on big-endian architectures.
1026 * Fix warnings from stray tokens after #endif's in uri.h and string_utils.h.
1027 * Add C++ inclusion safety to http_redirect.h (Kai Sommerfeld 
1028   <kai.sommerfeld@germany.sun.com>).
1029 * Make redirects to a different host work (Kai Sommerfeld).
1030 * Fix reading response bodies when non-chunked and no Content-Length
1031   (Kai Sommerfeld).
1032 * API change: 'http_add_hooks takes a 'const' request object.
1033 * Fixed memory leaks in session hooks (thanks to Kai Sommerfeld).
1034 * Fix passing NULL props argument to dav_simple_propfind, to support
1035   allprop requests.
1036 **** MAJOR INTERFACE CHANGE ****
1037  - URIs passed to http_request_create() are NOT escaped by neon. You 
1038    MUST do this yourself to remain HTTP compliant, using e.g. 
1039    uri_abspath_escape. (Kai Sommerfeld)
1040 * Added --disable-webdav flag to configure, to disable DAV support in
1041   the library.  This allows building neon without an XML parser. 
1042 * Corresponding NEON_WITHOUT_WEBDAV macro for use in bundled builds.
1043 * Fix Makefile dependancies.
1044 * A bundled neon directory builds or doesn't build automatically
1045   (i.e. you recurse into it unconditionally).
1046 * API clarification:
1047  - dav_propset_status may return NULL if the server does not return
1048    a response for the given property (issue is open for debate).
1049 * API change up for debate:
1050  - Property values to dav_proppatch are UTF-8 encoded internally.
1051  - Property values in dav_propfind_* are UTF-8 decoded internally.
1052 * API additions: ne_realloc, ne_utf8_encode.
1053
1054 Changes in release 0.11.0:
1055 * Added SSL client certificate support with 'sock_set_client_cert'.
1056  - Supports certs in PEM-encoded files.
1057  - Specify a callback for prompting the user for the password with 
1058      sock_set_key_prompt.
1059 * Added 'ne_oom_callback', to register a callback which is used if
1060   malloc() returns NULL.  (Mike Rosellini <m@icopyright.com>)
1061 * Register appropriate callback with libxml to handle <![CDATA blocks
1062   as normal character data (fixes PROPFINDs against sharemation.com).
1063 * Added 'NEON_REQUIRE' macro to declare that you require a neon library
1064   of a given minimum version, e.g.  NEON_REQUIRE(0,10) means "I need 
1065   neon 0.11 or later".  The _BUNDLED macros will fall back on the bundled
1066   copy if an external library is found which is not of a new enough version.
1067 * Added neon_version_minimum() function call for run-time version detection.
1068 * neon_config.h has been removed.
1069 * Use closesocket() to close sockets on Win32 (Markus Fleck <fleck@isoc.de>).
1070
1071 Changes in release 0.10.1:
1072 * Default expect-100 to OFF.
1073
1074 Changes in release 0.10.0:
1075 * hip_xml API changes:
1076  - The search for a handler for a new child element begins at the
1077    handler of the parent element, and carries on up the stack.
1078    (previously, it always started from the base of the stack)
1079  - Documentation written: doc/parsing-xml.txt
1080 * Remove memory leaks and tidy debugging output in new properties code.
1081 * API changes to DAV locking interface: 
1082  - New function: dav_lock_copy to copy a lock object.
1083  - Re-ordered arguments to callback of dav_lock_discover, and made the
1084    lock object passed back const.
1085  - Fix leaks and crashes due to vague interface definitions.
1086 * API change to dav_propfind_set_complex: use a callback to return the
1087   'private' structure.
1088 * NEON_NORMAL_BUILD and NEON_LIBTOOL_BUILD macros defined for setting
1089   up neon's Makefile in a bundled build: see macros/neon.m4.
1090 * NEON_VPATH_BUNDLED macro added which takes separate srcdir and
1091   builddir arguments for supporting VPATH builds (thanks to Peter Moulder 
1092   <pjm@bofh.asn.au>).
1093 * Added optional final argument to NEON_(VPATH_)BUNDLED, which gives
1094   a set of actions to be run if the bundled build is chosen.
1095 * NEON_SSL checks for OpenSSL in /usr too.
1096 * API change: when using http_session_decide_proxy, it MUST be called
1097   before using http_session_server to prevent the DNS lookup on the origin
1098   server being optimised out.  The real scheme in use is passed to the 
1099   callback now.
1100 * New function, dav_207_ignore_unknown, to ignore any unknown XML fragments
1101   in the 207 response.  Used by properties layer.
1102
1103 Changes in release 0.9.2:
1104 * Fix using both dav_propfind_set_complex and dav_propfind_set_flat with the
1105   same propfind_handler.
1106
1107 Changes in release 0.9.1:
1108 * dav_propfind interface
1109  - Guarantee that the 'private' structure will be initialized to zero on
1110    creation.
1111  - Make it the *callers* responsibility to free() the private structure.
1112 * Fix a few arguments/variables which mirrored globally declared symbols.
1113
1114 Changes in release 0.9.0:
1115 * Removed old dav_propfind_* interface, replaced with a better, more
1116   powerful, and easier to use interface:
1117  - 'dav_simple_propfind' interface for just fetching "flat" (byte-string)
1118    properties.
1119  - 'dav_propfind_*' interface for fetching flat and/or "complex" (structured
1120    XML) properties.
1121  - Lets you retrieve the 'status' information, to see what happened if
1122    fetching the property failed (e.g 404 Not Found).
1123 * Fixes to doc/using-neon.txt (thanks to Greg Stein).
1124 * Allow building when srcdir != builddir (Mo DeJong <mdejong@cygnus.com>)
1125
1126 Changes in release 0.8.1:
1127 * Fix segfault in PROPFIND code.
1128
1129 Changes in release 0.8.0:
1130 * Fix for using COPY/MOVE over SSL (thanks to David Sloat).
1131 * Fix for using a proxy server and SSL.
1132 * Added 'http_get_scheme' API call.
1133 * Added 'http_redirect.h' to list of installed headers (thanks to everyone ;).
1134 * Changes for building on Windows (Peter Boos <PediB@colorfullife.com>)
1135 * Fixes for building on BeOS (Sam TH <sam@uchicago.edu> and David Reid
1136   <dreid@jetnet.co.uk>).
1137 * Add buffering to socket code for pre-BONE BeOS systems (David Reid).
1138 * Interface changes for hip_xml:
1139  - Renamed hip_xml_add_(mixed_)handler to hip_xml_push_(mixed_)handler
1140  - Documentation updates.
1141  - Added HIP_ELM_UNUSED for lowest element id which should be used.
1142 *** MAJOR INTERFACE CHANGE ***
1143  - Removed 'http_status *' pointer from http_request_dispatch.
1144  - Added http_get_status(req) to retrieve the response-status information
1145    instead. You don't have to declare an http_status object yourself now.
1146 * Similarly, added DAV_ELM_207_UNUSED for lowest element id which should
1147   be used by users of dav_207_* code (incl. use of dav_propfind_*
1148   code).
1149 * New NEON_* autoconf macro interface:
1150  - Use NEON_BUNDLED if sources are bundled, otherwise NEON_LIBRARY.
1151  - The NEON_XML_PARSER macro is NOT called automatically.  You must
1152    call this yourself if using NEON_BUNDLED; see doc/using-neon.txt
1153    for details.
1154 * Fix use of 'socket' in nsocket.h function prototypes (Greg Stein).
1155 * Remove extra backslash at line 69 of src/Makefile.incl (Dirk Bergstrom).
1156 * Examples directory is now a separate package.
1157
1158 Changes in release 0.7.7:
1159 * Another fix for linking against a libtool-built expat (Greg Stein).
1160
1161 Changes in release 0.7.6:
1162 * Better check for closed SSL connection after doing SSL_peek. (thanks
1163   to Jeff Costlow <j.costlow@f5.com>).
1164 * Attempt at correct sock_block() implementation for SSL.
1165 * sock_peek() will return SOCK_CLOSED correctly.
1166
1167 Changes in release 0.7.5:
1168 * Fixed workaround for linking against a libtool-built expat (Greg Stein).
1169
1170 Changes in release 0.7.4:
1171 * Fix for fd leak on connect failure (David Sloat <d.sloat@f5.com>).
1172 * Fix for Digest auth against IIS5 (David Sloat).
1173 * Workaround for linking against a libtool-built libexpat.la (Greg Stein).
1174
1175 Changes in release 0.7.3:
1176 * Check for -lsocket and -linet in configure.
1177 * Workaround for SSL problems.
1178
1179 Changes in release 0.7.2:
1180 * Define SHELL in Makefile (thanks to Eric Mumpower <nocturne@arepa.com>).
1181 * Added 'all' target to Makefile (Greg Stein <gstein@lyra.org>)
1182 * Added '--with-expat' argument to configure (Greg Stein)
1183 * Added 'dav_propfind_destroy' function.
1184
1185 Changes in release 0.7.1:
1186 * Don't register response body/header authentication callbacks if no 
1187   credentials-supplying callback has been registered (speed optimisation).
1188
1189 Changes in release 0.7.0:
1190 * Deprecated use of 'NULL' to http_add_response_header_handler.
1191   New interface, http_add_response_header_catcher, to register
1192   a callback which is passed ALL response headers regardless of name.
1193 * Speed optimisation (~10%?): storing response-header handlers in a
1194   hash table for faster look.
1195 * New SBUFFER_CAST() macro for getting to the 'char *' of an sbuffer
1196   as fast as possible.
1197
1198 Changes in release 0.6.1:
1199 * Fix for retrying request if connection is closed by server.
1200 * Make redirect hook work for >1 request per session.
1201
1202 Changes in release 0.6.0:
1203 * New interface to allow following HTTP redirects (301/302 responses).
1204   A callback must be given to get user confirmation if the request method
1205   is not GET, HEAD, or PROPFIND.
1206 * New interface to determine whether the proxy server should be used
1207   for a given request: http_session_decide_proxy.
1208 * Fix nget build again. Support automatic redirects in 'nget'.
1209 * Add --with-extra-includes and --with-extra-libs configure parameters
1210   to point configure at 
1211
1212 Changes in release 0.5.1:
1213 * Prevent segfault if USE_DAV_LOCKS is defined, and a locking session
1214   is not registered (thanks to David Sloat).
1215
1216 Changes in release 0.5.0:
1217 * Rename xmalloc, xstrdup etc to ne_malloc, ne_strdup etc.
1218 * Some speed optimisation in response-header reading.
1219 * Use 'off_t' rather than 'size_t' in sock_progress callback,
1220   sock_readfile_blocked, and sock_transfer.
1221
1222 Changes in release 0.4.2:
1223 * Fix for sending request bodies after getting 100-continue response.
1224
1225 Changes in release 0.4.1:
1226 * Fix nget build.
1227
1228 Changes in release 0.4.0:
1229 * Install library headers into .../include/neon not .../include/libneon
1230 * Install all necessary library headers.
1231 * Compile support for WebDAV locking throughout the library
1232 * Rename md5.h to neon_md5.h (avoids conflict with md5.h in OpenSSL)
1233 * Rename socket.h to nsocket.h (avoids possible conflict with C library)
1234 * Update licensing notice on macros/neon*.m4: note that these files are
1235   NOT under the LGPL, and can be used in other packages regardless of
1236   the license the package uses.
1237 * Update NEON_LIBRARY m4 function to allow optional specification of
1238   names of bundled neon/expat source directories.
1239 * Increase socket read timeout to 60 seconds.
1240 * Added an POST method: from Sander Alberink <sander.alberink@cmg.nl>.
1241 * Added 'http_get_request_headers' to return the sbuffer containing
1242   all request headers.
1243 * Allow passing NULL as name to http_add_response_header_handler: 
1244   the handler callback is passed the entire header string, of ALL 
1245   response headers.
1246
1247 Changes in release 0.3.1:
1248 * Compile fix for dav_locks.c (thanks to Paul D'Anna)
1249
1250 Changes in release 0.3.0:
1251 * Rewrite of socket handling layer. All sock_* functions changed.
1252 * Added basic SSL support: --with-ssl (requires OpenSSL).
1253   NOTE: Certificates are NOT presented for verification.
1254 * 'nget' accepts URL's using the 'https' scheme.
1255 * New example program, 'nserver', to display the Server: string, 
1256   e.g. 'nserver https://www.eu.c2.net/'
1257 * Fixed request re-send when persistent connection times out.
1258 * "Hooks" support: allow external hooks into the HTTP request/
1259   response dispatch loop.
1260 * New printf-style interface for adding request headers.
1261 * Make symbols used in header files C++-safe (Tom Bednarz).
1262 * WebDAV locking support: lock discovery, LOCK (exclusive/shared)
1263   UNLOCK. "If:" headers are sent as appropriate. Simple interface
1264   for implementors of new methods to indicate which locks are 
1265   required for the method.
1266 * Primitive HTTP cookies support.
1267 * Primitive hack at a GNOME-based GUI example program "nbrowse".
1268   Enable build with --enable-gnome-examples. It crashes, and
1269   not much else. Requires GNOME and POSIX threads. Example usage:
1270        'nbrowse dav.ics.uci.edu /msdav/'
1271   Many thanks to Lee Mallabone for Gtk help, and showing how to
1272   use Gtk and threads. 
1273
1274 Changes in release 0.2.0:
1275 * Use libtool: new configure options to select whether to build
1276   shared and/or static libraries. Should build shared libraries
1277   portably now.  
1278 * Complete rewrite of the hip_xml interface to use opaque pointers.
1279   New functions: hip_xml_create, hip_xml_destroy: create parser.
1280   hip_xml_{set,get}_error: Access to error string.
1281   hip_xml_add_handler: Register callbacks for a set of elements.
1282   hip_xml_valid: Returns whether the parse was valid or not.
1283   Removed functions: hip_xml_init, hip_xml_finish.
1284 * Removed functions made reduntant by above changes in dav_207.
1285 * Don't include config.h in header files
1286 * Fix PROPFIND allprop request body (Michael Sobolev)
1287 * Added C++ safety macros around header files.
1288 * Added neon-config script for getting correct CFLAGS and LIBS
1289   values for using libneon in applications.
1290
1291 Changes in release 0.1.1:
1292 * Fix for short writes in GET
1293
1294 Changes in release 0.1.0:
1295 * Initial release.