Merge branch 'thirdparty_dev' into dev

Source commit: bcec7f20f40885d6c682e543a29257ee581ae8bb

libs/neon/.release.sh

@@ -29,6 +29,7 @@ ALL_LINGUAS=`echo po/*.po | sed 's,po/,,g;s,\.po,,g'`
 tmp=`mktemp /tmp/neon-XXXXXX`
 sed -e 's,@SET_MAKE@,,;s,@SHELL@,/bin/sh,' \
     -e "s,@top_srcdir@,`pwd`," \
+    -e "s,@srcdir@,`pwd`," \
     -e "s,@ALL_LINGUAS@,${ALL_LINGUAS}," \
     < Makefile.in > $tmp
 make -f $tmp docs compile-gmo

libs/neon/.version

@@ -1 +1 @@
-0.31.2
+0.32.1

libs/neon/ChangeLog

@@ -1,6 +1,6 @@
 ------------------------------------------------------------------------
-r1590 | joe.orton | 2020-06-20 08:09:24 +0100 (Sat, 20 Jun 2020) | 2 lines
+r1718 | joe.orton | 2021-09-20 20:17:44 +0100 (Mon, 20 Sep 2021) | 2 lines
 
-Bump to 0.31.2.
+Bump for 0.32.1.
 
 ------------------------------------------------------------------------

libs/neon/Makefile.in

@@ -77,7 +77,7 @@ cover: subdirs
 	@cd test && $(MAKE) check
 	@cd src && $(GCOV) -cb $(MODULE)
 
-# as per 'cover' target; prints list of functions without 100% coverage 
+# as per 'cover' target; prints list of functions without 100% coverage
 uncover: subdirs
 	@rm -f src/*.*da test/common/*.*da test/*.*da
 	@cd test && $(MAKE) check
@@ -93,23 +93,23 @@ subdirs:
 docs: docs-man docs-html
 
 docs-man:
-	rm -rf doc/man; mkdir doc/man
-	$(XMLTO) -o `pwd`/doc/man -x doc/man.xsl man doc/manual.xml
+	rm -rf doc/man; mkdir -p doc/man
+	$(XMLTO) -o `pwd`/doc/man -x $(srcdir)/doc/man.xsl man $(srcdir)/doc/manual.xml
 
 docs-pdf:
-	$(XMLTO) -o `pwd`/doc pdf doc/manual.xml
+	$(XMLTO) -o `pwd`/doc pdf $(srcdir)/doc/manual.xml
 
 docs-ps:
-	$(XMLTO) -o `pwd`/doc ps doc/manual.xml
+	$(XMLTO) -o `pwd`/doc ps $(srcdir)/doc/manual.xml
 
 docs-html:
 	test -d doc/html && rm -rf doc/html || true
-	mkdir doc/html
-	$(XMLTO) -o `pwd`/doc/html -x doc/html.xsl html doc/manual.xml
+	mkdir -p doc/html
+	$(XMLTO) -o `pwd`/doc/html -x $(srcdir)/doc/html.xsl html $(srcdir)/doc/manual.xml
 
 # Validate the manual source
 docs-valid:
-	xmllint --noout --valid doc/manual.xml
+	xmllint --noout --valid $(srcdir)/doc/manual.xml
 
 clean:
 	@cd src && $(MAKE) clean
@@ -128,18 +128,18 @@ neon-config: $(srcdir)/neon-config.in
 
 install-docs: install-man install-html
 
-install-html:
+install-html: docs-html
 	$(INSTALL) -d $(DESTDIR)$(docdir)/html
-	for d in $(srcdir)/doc/html/*.html; do \
+	for d in doc/html/*.html; do \
 		$(INSTALL_DATA) $$d $(DESTDIR)$(docdir)/html; \
 	done
 
-install-man:
+install-man: docs-man
 	$(INSTALL) -d $(DESTDIR)$(man3dir)
 	$(INSTALL) -d $(DESTDIR)$(man1dir)
-	for m in $(srcdir)/doc/man/*.3; do \
+	for m in doc/man/*.3; do \
 	 $(INSTALL_DATA) $$m $(DESTDIR)$(man3dir); done
-	for m in $(srcdir)/doc/man/*.1; do \
+	for m in doc/man/*.1; do \
 	 $(INSTALL_DATA) $$m $(DESTDIR)$(man1dir); done
 
 install: install-@ALLOW_INSTALL@
@@ -218,4 +218,3 @@ doc-status:
 	@for f in `nm src/.libs/libneon.so | grep ' T ' | colrm 1 11`; do \
 	   test -f doc/man/$$f.3 || echo -n " $$f"; \
 	done; echo
-

libs/neon/NEWS

@@ -1,3 +1,40 @@
+Changes in release 0.32.1:
+* Fix configure CFLAGS handling in Kerberos detection.
+* Various spelling fixes.
+
+Changes in release 0.32.0:
+* Interface changes:
+ - API and ABI backwards-compatible with 0.27.x and later
+ - NE_AUTH_DIGEST now only enables RFC 2617/7616 auth by default;
+   to enable weaker RFC 2069 Digest, use NE_AUTH_LEGACY_DIGEST
+   (treated as a security enhancement, not an API/ABI break)
+* Interface clarifications:
+ - ne_auth.h: use of non-ASCII usernames with the ne_auth_creds
+   callback type is now rejected for Digest auth since the
+   encoding is not specified.  ne_add_auth() can be used instead.
+ - ne_request.h: the ne_create_request_fn callback is passed the
+   request-target using RFC 7230 terminology
+* New interfaces and features:
+ - ne_string.h: added ne_strhash(), ne_vstrhash(), ne_strparam()
+ - ne_auth.h: added RFC 7616 (Digest authentication) support,
+   including userhash=, username*= and SHA-2 algorithms
+   (SHA-2 requires GnuTLS/OpenSSL).  added NE_AUTH_LEGACY_DIGEST
+ - ne_auth.h: added ne_add_auth() unified auth callback interface,
+   accepts (only) UTF-8 usernames, uses a larger password buffer,
+   and has different/improved attempt counter semantics.
+ - RFC 7617 scoping rules are now applied for Basic authentication.
+ - ne_ssl.h: added ne_ssl_cert_hdigest()
+ - ne_socket.h: added ne_sock_shutdown()
+ - sendmsg()/send() are used with the MSG_NOSIGNAL flag to write to
+   sockets on Unix, rather than write()/writev(), avoiding SIGPIPE
+ - explicit_bzero() is used where available to clear credentials
+* Bug fixes:
+ - fixed TLS connection shutdown handling for OpenSSL 3
+ - fix various Coverity and cppcheck warnings (Sebastian Reschke)
+ - Kerberos library detection uses pkg-config where possible.
+ - fix some configure checks on Win32 (Christopher Degawa)
+ - fix some configure errors on MacOS (Ryan Schmidt)
+
 Changes in release 0.31.2:
 * Fix ne_md5_read_ctx() with OpenSSL on big-endian architectures.
 * Fix GCC 10 warning in PKCS#11 build.

libs/neon/README.md

@@ -1,5 +1,6 @@
 
-[![Travis CI Build Status](https://travis-ci.org/notroj/neon.svg?branch=0.31.x)](https://travis-ci.org/notroj/neon)
+[![Travis CI Build Status](https://travis-ci.com/notroj/neon.svg?branch=master)](https://travis-ci.com/github/notroj/neon)
+[![Build and test](https://github.com/notroj/neon/actions/workflows/ci.yml/badge.svg)](https://github.com/notroj/neon/actions/workflows/ci.yml)
 
 # neon
 
@@ -16,17 +17,18 @@ Features:
  - Low-level interface to HTTP request handling, to allow implementing
    new methods easily.
  - Persistent connection support (HTTP/1.1 and HTTP/1.0 aware)
- - Basic and digest authentication (RFC2617) (including auth-int, md5-sess)
- - Proxy support (including basic/digest authentication)
- - SSL/TLS support using OpenSSL (including client certificate support)
+ - Basic and Digest authentication (RFC 7616/7617, including SHA-2, userhash)
+ - Kerberos (Negotiate) and SSPI/NTLM authentication (Unix and Windows)
+ - HTTP and SOCKS (v4/5) proxy support (including authentication)
+ - SSL/TLS support using OpenSSL or GnuTLS (client certs via files or PKCS#11)
  - Generic WebDAV 207 XML response handling mechanism
- - XML parsing using expat or libxml (1.x or 2.x) parser
+ - XML parsing using expat or libxml2
  - Easy generation of error messages from 207 error responses
  - Basic HTTP/1.1 methods: GET, PUT, HEAD, OPTIONS, conditional PUT
  - WebDAV resource manipulation: MOVE, COPY, DELETE, MKCOL.
  - WebDAV metadata support: set and remove properties (PROPPATCH), query
    any set of properties (PROPFIND).
- - WebDAV locking support
+ - WebDAV locking and ACL (RFC 3744) support
  - Autoconf macros supplied for easily embedding neon directly inside 
    an application source tree.
 
@@ -41,7 +43,7 @@ The autoconf macros in the "macros" directory are under a less
 restrictive license, see each file for details.
 
 ~~~
-neon is Copyright (C) 1999-2008 Joe Orton
+neon is Copyright (C) 1999-2021 Joe Orton
 Portions are:
 Copyright (C) Aleix Conchillo Flaque
 Copyright (C) Arfrever Frehtes Taifersar Arahesis

libs/neon/aclocal.m4

@@ -1,6 +1,6 @@
-# generated automatically by aclocal 1.16.1 -*- Autoconf -*-
+# generated automatically by aclocal 1.16.2 -*- Autoconf -*-
 
-# Copyright (C) 1996-2018 Free Software Foundation, Inc.
+# Copyright (C) 1996-2020 Free Software Foundation, Inc.
 
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -9046,7 +9046,7 @@ m4_ifndef([_LT_PROG_CXX],		[AC_DEFUN([_LT_PROG_CXX])])
 
 # AM_CONDITIONAL                                            -*- Autoconf -*-
 
-# Copyright (C) 1997-2018 Free Software Foundation, Inc.
+# Copyright (C) 1997-2020 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -9077,7 +9077,7 @@ AC_CONFIG_COMMANDS_PRE(
 Usually this means the macro was only invoked conditionally.]])
 fi])])
 
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
+# Copyright (C) 2006-2020 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,

libs/neon/autogen.sh

@@ -8,21 +8,21 @@ if test ! -f .version; then
    echo 0.0.0-dev > .version
    # for the documentation:
    date +"%e %B %Y" | tr -d '\n' > doc/date.xml
-   echo -n 0.0.0-dev > doc/version.xml
+   echo 0.0.0-dev > doc/version.xml
 fi
 set -e
-echo -n "libtoolize... "
-LIBTOOLIZE=${LIBTOOLIZE:-libtoolize}
+printf  "libtoolize... "
+LIBTOOLIZE=${LIBTOOLIZE:-`which libtoolize || which glibtoolize`}
 if ${LIBTOOLIZE} --help | grep -- --install > /dev/null; then
    ${LIBTOOLIZE} --copy --force --install >/dev/null;
 else
    ${LIBTOOLIZE} --copy --force >/dev/null
 fi
-echo -n "aclocal... "
+printf  "aclocal... "
 ${ACLOCAL:-aclocal} -I macros
-echo -n "autoheader... "
+printf  "autoheader... "
 ${AUTOHEADER:-autoheader}
-echo -n "autoconf... "
+printf  "autoconf... "
 ${AUTOCONF:-autoconf} -Wall
 echo okay.
 # remove the autoconf cache

libs/neon/config.h.in

@@ -42,6 +42,9 @@
 /* Define if you have expat */
 #undef HAVE_EXPAT
 
+/* Define to 1 if you have the `explicit_bzero' function. */
+#undef HAVE_EXPLICIT_BZERO
+
 /* Define to 1 if you have the `fcntl' function. */
 #undef HAVE_FCNTL
 
@@ -166,6 +169,9 @@
 /* Define if OpenSSL support is enabled */
 #undef HAVE_OPENSSL
 
+/* Enable OpenSSL 1.1 support */
+#undef HAVE_OPENSSL11
+
 /* Define to 1 if you have the <openssl/opensslv.h> header file. */
 #undef HAVE_OPENSSL_OPENSSLV_H
 
@@ -187,6 +193,9 @@
 /* Define to 1 if you have the `pthread_mutex_lock' function. */
 #undef HAVE_PTHREAD_MUTEX_LOCK
 
+/* Define to 1 if you have the `sendmsg' function. */
+#undef HAVE_SENDMSG
+
 /* Define to 1 if you have the `setlocale' function. */
 #undef HAVE_SETLOCALE
 

libs/neon/config.hw

@@ -25,9 +25,9 @@
 
 #ifdef WIN32
 
-#define NEON_VERSION "0.31.2"
+#define NEON_VERSION "0.32.1"
 #define NE_VERSION_MAJOR (0)
-#define NE_VERSION_MINOR (31)
+#define NE_VERSION_MINOR (32)
 
 #define HAVE_ERRNO_H
 #define HAVE_LIMITS_H

libs/neon/doc/date.xml

@@ -1 +1 @@
-20 June 2020
+20 September 2021

libs/neon/doc/html/compliance.html

@@ -1,12 +1,12 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Standards compliance</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="intro.html" title="Chapter 1. Introduction"><link rel="prev" href="using.html" title="How to use neon from your application"><link rel="next" href="security.html" title="HTTP Client Security"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Standards compliance</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="using.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Introduction</th><td width="20%" align="right"> <a accesskey="n" href="security.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="compliance"></a>Standards compliance</h2></div></div></div><p>neon is intended to be compliant with the IETF and W3C
 	standards which it implements, with a few exceptions due to
 	practical necessity or interoperability issues.  These
-	exceptions are documented in this section.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46200848345840"></a>RFC 2518, HTTP Extensions for Distributed Authoring—WebDAV</h3></div></div></div><p>neon is deliberately not compliant with section
+	exceptions are documented in this section.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46097884355344"></a>RFC 2518, HTTP Extensions for Distributed Authoring—WebDAV</h3></div></div></div><p>neon is deliberately not compliant with section
 	23.4.2, and treats property names as a (namespace-URI, name)
 	pair.  This is <a class="ulink" href="http://lists.w3.org/Archives/Public/w3c-dist-auth/1999OctDec/0343.html" target="_top">generally
 	considered</a> to be correct behaviour by the WebDAV
 	working group, and is likely to formally adopted in a future
-	revision of the specification.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46200848344016"></a>RFC 2616, Hypertext Transfer Protocol—HTTP/1.1</h3></div></div></div><p>There is some confusion in this specification about the
+	revision of the specification.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46097884616112"></a>RFC 2616, Hypertext Transfer Protocol—HTTP/1.1</h3></div></div></div><p>There is some confusion in this specification about the
         use of the <span class="quote">“<span class="quote">identity</span>”</span>
         <em class="firstterm">transfer-coding</em>.  neon ignores the
         <code class="literal">Transfer-Encoding</code> response header if it
@@ -15,7 +15,7 @@
         the header was not present.  neon will give an error if a
         response includes a <code class="literal">Transfer-Encoding</code>
         header with a value other than <span class="quote">“<span class="quote">identity</span>”</span> or
-        <span class="quote">“<span class="quote">chunked</span>”</span>.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46200848339248"></a>RFC 2617, HTTP Authentication: Basic and Digest Access Authentication</h3></div></div></div><p>neon is not strictly compliant with the quoting rules
+        <span class="quote">“<span class="quote">chunked</span>”</span>.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46097885255024"></a>RFC 2617, HTTP Authentication: Basic and Digest Access Authentication</h3></div></div></div><p>neon is not strictly compliant with the quoting rules
         given in the grammar for the <code class="literal">Authorization</code>
         header.  The grammar requires that the <code class="literal">qop</code>
         and <code class="literal">algorithm</code> parameters are not quoted,
@@ -23,7 +23,7 @@
         (Microsoft® IIS 5) rejects the request if these parameters
         are not quoted.  neon sends these parameters with
         quotes—this is not known to cause any problems with
-        other server implementations.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46200848335424"></a>Namespaces in XML</h3></div></div></div><p>The neon XML parser interface will accept and parse
+        other server implementations.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46097884956352"></a>Namespaces in XML</h3></div></div></div><p>The neon XML parser interface will accept and parse
         without error some XML documents which are well-formed
         according to the XML specification but do not conform to the
         "Namespaces in XML" specification <a class="xref" href="biblio.html#bib.xmlnames" title="Namespaces in XML">[<abbr class="abbrev">REC-XML-names</abbr>]</a>.  Specifically: the restrictions on

libs/neon/doc/html/refbuf.html

@@ -4,9 +4,9 @@ typedef struct {
     char *data;
     size_t used;
     size_t length;
-} <em class="type">ne_buffer</em>;</pre></div></div><div class="refsect1"><a name="idm46200847797200"></a><h2>Description</h2><p>The <em class="type">ne_buffer</em> type represents an expandable
+} <em class="type">ne_buffer</em>;</pre></div></div><div class="refsect1"><a name="idm46097882466048"></a><h2>Description</h2><p>The <em class="type">ne_buffer</em> type represents an expandable
 memory buffer for holding <code class="literal">NUL</code>-terminated strings.  The
-<em class="structfield"><code>data</code></em> field points to the beginnning of the
+<em class="structfield"><code>data</code></em> field points to the beginning of the
 string, the length of which is given by the
 <em class="structfield"><code>used</code></em> field.  The current size of memory
 allocated is given by the <em class="structfield"><code>length</code></em> field.  It

libs/neon/doc/html/refconfig.html

@@ -1,11 +1,11 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>neon-config</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="refneon.html" title="neon"><link rel="next" href="refresolve.html" title="ne_addr_resolve"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">neon-config</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="refneon.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refresolve.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refconfig"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>neon-config — script providing information about installed copy
-	of neon library</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">neon-config</code>  [<code class="option">--prefix</code>] [[<code class="option">--cflags</code>] |  [<code class="option">--libs</code>] |  [<code class="option">--la-file</code>] |  [<code class="option">--support</code> <em class="replaceable"><code>feature</code></em>] |  [<code class="option">--help</code>] |  [<code class="option">--version</code>]]</p></div></div><div class="refsect1"><a name="idm46200847967408"></a><h2>Description</h2><p>The <span class="command"><strong>neon-config</strong></span> script provides
+	of neon library</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">neon-config</code>  [<code class="option">--prefix</code>] [[<code class="option">--cflags</code>] |  [<code class="option">--libs</code>] |  [<code class="option">--la-file</code>] |  [<code class="option">--support</code> <em class="replaceable"><code>feature</code></em>] |  [<code class="option">--help</code>] |  [<code class="option">--version</code>]]</p></div></div><div class="refsect1"><a name="idm46097882636160"></a><h2>Description</h2><p>The <span class="command"><strong>neon-config</strong></span> script provides
 information about an installed copy of the neon library.  The
 <code class="option">--cflags</code> and <code class="option">--libs</code> options instruct
 how to compile and link an application against the library; the
 <code class="option">--version</code> and <code class="option">--support</code> options can
 help determine whether the library meets the applications
-requirements.</p></div><div class="refsect1"><a name="idm46200847963904"></a><h2>Options</h2><div class="variablelist"><table border="0" class="variablelist"><colgroup><col align="left" valign="top"><col></colgroup><tbody><tr><td><p><span class="term"><code class="option">--cflags</code></span></p></td><td>Print the flags which should be passed to
+requirements.</p></div><div class="refsect1"><a name="idm46097882632656"></a><h2>Options</h2><div class="variablelist"><table border="0" class="variablelist"><colgroup><col align="left" valign="top"><col></colgroup><tbody><tr><td><p><span class="term"><code class="option">--cflags</code></span></p></td><td>Print the flags which should be passed to
 the C compiler when compiling object files, when the object files use
 neon header files.</td></tr><tr><td><p><span class="term"><code class="option">--libs</code></span></p></td><td>Print the flags which should be passed to
 the linker when linking an application which uses the neon

libs/neon/doc/html/reffeat.html

@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_has_support</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="refgetst.html" title="ne_get_status"><link rel="next" href="refi18n.html" title="ne_i18n_init"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_has_support</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="refgetst.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refi18n.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="reffeat"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_has_support — determine feature support status</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_utils.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">ne_has_support</b>(</code></td><td>int <var class="pdparam">feature</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46200847477872"></a><h2>Description</h2><p>The <code class="function">ne_has_support</code> function can be used
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_has_support</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="refgetst.html" title="ne_get_status"><link rel="next" href="refi18n.html" title="ne_i18n_init"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_has_support</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="refgetst.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refi18n.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="reffeat"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_has_support — determine feature support status</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_utils.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">ne_has_support</b>(</code></td><td>int <var class="pdparam">feature</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46097882031872"></a><h2>Description</h2><p>The <code class="function">ne_has_support</code> function can be used
     to determine whether a particular optional feature, given by the
     feature code <code class="parameter">feature</code>, is supported.  The
     following feature codes are available:
@@ -6,5 +6,5 @@
     </p><div class="variablelist"><table border="0" class="variablelist"><colgroup><col align="left" valign="top"><col></colgroup><tbody><tr><td><p><span class="term"><code class="constant">NE_FEATURE_SSL</code></span></p></td><td>Indicates support for SSL/TLS</td></tr><tr><td><p><span class="term"><code class="constant">NE_FEATURE_ZLIB</code></span></p></td><td>Indicates support for compressed responses</td></tr><tr><td><p><span class="term"><code class="constant">NE_FEATURE_IPV6</code></span></p></td><td>Indicates support for IPv6</td></tr><tr><td><p><span class="term"><code class="constant">NE_FEATURE_LFS</code></span></p></td><td>Indicates support for large files</td></tr><tr><td><p><span class="term"><code class="constant">NE_FEATURE_SOCKS</code></span></p></td><td>Indicates support for SOCKSv5</td></tr><tr><td><p><span class="term"><code class="constant">NE_FEATURE_TS_SSL</code></span></p></td><td>Indicates support for thread-safe SSL
           initialization — see <a class="xref" href="refsockinit.html#ne_sock_init">ne_sock_init</a></td></tr></tbody></table></div><p>
 
-    </p></div><div class="refsect1"><a name="idm46200847464608"></a><h2>Return value</h2><p><code class="function">ne_has_support</code> returns non-zero if 
-    the given feature is supported, or zero otherwise.</p></div><div class="refsect1"><a name="idm46200847462960"></a><h2>See also</h2><p><a class="xref" href="refvers.html" title="ne_version_match"><span class="refentrytitle">ne_version_match</span></a>, <a class="xref" href="refsockinit.html" title="ne_sock_init"><span class="refentrytitle">ne_sock_init</span></a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="refgetst.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="refi18n.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ne_get_status </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ne_i18n_init</td></tr></table></div></body></html>
+    </p></div><div class="refsect1"><a name="idm46097882018608"></a><h2>Return value</h2><p><code class="function">ne_has_support</code> returns non-zero if 
+    the given feature is supported, or zero otherwise.</p></div><div class="refsect1"><a name="idm46097882016960"></a><h2>See also</h2><p><a class="xref" href="refvers.html" title="ne_version_match"><span class="refentrytitle">ne_version_match</span></a>, <a class="xref" href="refsockinit.html" title="ne_sock_init"><span class="refentrytitle">ne_sock_init</span></a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="refgetst.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="refi18n.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ne_get_status </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ne_i18n_init</td></tr></table></div></body></html>

libs/neon/doc/html/refgetst.html

@@ -1,10 +1,10 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_get_status</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="referr.html" title="ne_get_error"><link rel="next" href="reffeat.html" title="ne_has_support"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_get_status</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="referr.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="reffeat.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refgetst"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_get_status — retrieve HTTP response status for request</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_request.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">const ne_status *<b class="fsfunc">ne_get_status</b>(</code></td><td>const ne_request *<var class="pdparam">request</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46200847584032"></a><h2>Description</h2><p>The <code class="function">ne_get_status</code> function returns
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_get_status</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="referr.html" title="ne_get_error"><link rel="next" href="reffeat.html" title="ne_has_support"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_get_status</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="referr.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="reffeat.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refgetst"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_get_status — retrieve HTTP response status for request</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_request.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">const ne_status *<b class="fsfunc">ne_get_status</b>(</code></td><td>const ne_request *<var class="pdparam">request</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46097882137088"></a><h2>Description</h2><p>The <code class="function">ne_get_status</code> function returns
 a pointer to the HTTP status object giving the result of a request.
 The object returned only becomes valid once the request has been
 <span class="emphasis"><em>successfully</em></span> dispatched (the return value of
 <code class="function">ne_request_dispatch</code> or
 <code class="function">ne_begin_request</code> was zero).  The object remains
-valid until the associated request object is destroyed.</p></div><div class="refsect1"><a name="idm46200847506976"></a><h2>See also</h2><p><a class="xref" href="refstatus.html#ne_status">ne_status</a>, <a class="xref" href="refreq.html#ne_request_create">ne_request_create</a></p></div><div class="refsect1"><a name="idm46200847505088"></a><h2>Example</h2><p>Display the response status code of applying the
+valid until the associated request object is destroyed.</p></div><div class="refsect1"><a name="idm46097882060864"></a><h2>See also</h2><p><a class="xref" href="refstatus.html#ne_status">ne_status</a>, <a class="xref" href="refreq.html#ne_request_create">ne_request_create</a></p></div><div class="refsect1"><a name="idm46097882058976"></a><h2>Example</h2><p>Display the response status code of applying the
 <code class="literal">HEAD</code> method to some resource.</p><pre class="programlisting">ne_request *req = ne_request_create(sess, "HEAD", "/foo/bar");
 if (ne_request_dispatch(req))
    /* handle errors... */

libs/neon/doc/html/refi18n.html

@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_i18n_init</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="reffeat.html" title="ne_has_support"><link rel="next" href="refiaddr.html" title="ne_iaddr_make"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_i18n_init</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="reffeat.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refiaddr.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refi18n"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_i18n_init — functions to initialize internationalization support</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_i18n.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">ne_i18n_init</b>(</code></td><td>const char *<var class="pdparam">encoding</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46200847426448"></a><h2>Description</h2><p>The <code class="function">ne_i18n_init</code> function can be used
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_i18n_init</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="reffeat.html" title="ne_has_support"><link rel="next" href="refiaddr.html" title="ne_iaddr_make"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_i18n_init</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="reffeat.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refiaddr.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refi18n"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_i18n_init — functions to initialize internationalization support</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_i18n.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">ne_i18n_init</b>(</code></td><td>const char *<var class="pdparam">encoding</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46097881980448"></a><h2>Description</h2><p>The <code class="function">ne_i18n_init</code> function can be used
     to enable support for translated messages in the neon library.
     The <code class="parameter">encoding</code> parameter, if non-<code class="literal">NULL</code>,
     specifies the character encoding required for generated translated
@@ -15,4 +15,4 @@
     will otherwise operate correctly.</p><p>Note that the encoding used is a process-global setting and
     so results may be unexpected if other users of neon within the
     process call <code class="function">ne_i18n_init</code> with a different
-    encoding parameter.</p></div><div class="refsect1"><a name="idm46200847417280"></a><h2>See also</h2><p><a class="xref" href="refsockinit.html#ne_sock_init">ne_sock_init</a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="reffeat.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="refiaddr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ne_has_support </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ne_iaddr_make</td></tr></table></div></body></html>
+    encoding parameter.</p></div><div class="refsect1"><a name="idm46097881971200"></a><h2>See also</h2><p><a class="xref" href="refsockinit.html#ne_sock_init">ne_sock_init</a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="reffeat.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="refiaddr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ne_has_support </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ne_iaddr_make</td></tr></table></div></body></html>

libs/neon/doc/html/refneon.html

@@ -1,11 +1,11 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>neon</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="ref.html" title="neon API reference"><link rel="next" href="refconfig.html" title="neon-config"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">neon</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ref.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refconfig.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refneon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>neon — HTTP and WebDAV client library</p></div><div class="refsect1"><a name="idm46200848159056"></a><h2>Description</h2><p>neon is an HTTP and WebDAV client library.  The major
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>neon</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="ref.html" title="neon API reference"><link rel="next" href="refconfig.html" title="neon-config"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">neon</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ref.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refconfig.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refneon"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>neon — HTTP and WebDAV client library</p></div><div class="refsect1"><a name="idm46097882827776"></a><h2>Description</h2><p>neon is an HTTP and WebDAV client library.  The major
     abstractions exposed are the HTTP <span class="emphasis"><em>session</em></span>,
     created by <a class="xref" href="refsess.html#ne_session_create">ne_session_create</a>; and the HTTP
     <span class="emphasis"><em>request</em></span>, created by <a class="xref" href="refreq.html#ne_request_create">ne_request_create</a>.  HTTP authentication is handled
     transparently for server and proxy servers, see <a class="xref" href="refauth.html#ne_set_server_auth">ne_set_server_auth</a>; complete SSL/TLS support is also
-    included, see <a class="xref" href="refsslvfy.html#ne_ssl_set_verify">ne_ssl_set_verify</a>.</p></div><div class="refsect1"><a name="idm46200848126064"></a><h2>Conventions</h2><p>Some conventions are used throughout the neon API, to
+    included, see <a class="xref" href="refsslvfy.html#ne_ssl_set_verify">ne_ssl_set_verify</a>.</p></div><div class="refsect1"><a name="idm46097882785808"></a><h2>Conventions</h2><p>Some conventions are used throughout the neon API, to
     provide a consistent and simple interface; these are documented
-    below.</p><div class="refsect2"><a name="idm46200848124896"></a><h3>Thread-safeness and global initialization</h3><p>neon itself is implemented to be thread-safe (avoiding any
+    below.</p><div class="refsect2"><a name="idm46097882784640"></a><h3>Thread-safeness and global initialization</h3><p>neon itself is implemented to be thread-safe (avoiding any
     use of global state), but relies on the operating system providing
     a thread-safe resolver interface.  Modern operating systems offer
     the thread-safe <code class="function">getaddrinfo</code> interface, which
@@ -35,11 +35,11 @@
     (and <a class="xref" href="refsockinit.html#ne_sock_exit">ne_sock_exit</a>); neon neither checks whether
     these functions are called nor calls them itself.</p><p>For some applications and configurations it may be necessary
     to call <a class="xref" href="refi18n.html#ne_i18n_init">ne_i18n_init</a> to initialize the support
-    for internationalization in neon.</p></div><div class="refsect2"><a name="idm46200848097552"></a><h3>Asynchronous signal safety</h3><p>No function in neon is defined to be <span class="quote">“<span class="quote">async-signal safe</span>”</span> -
+    for internationalization in neon.</p></div><div class="refsect2"><a name="idm46097882766256"></a><h3>Asynchronous signal safety</h3><p>No function in neon is defined to be <span class="quote">“<span class="quote">async-signal safe</span>”</span> -
     that is, no function is safe to call from a signal handler.  Any
     call into the neon library from a signal handler will have
     undefined behaviour - in other words, it may crash the
-    process.</p></div><div class="refsect2"><a name="idm46200848095680"></a><h3>Functions using global state</h3><p>Any function in neon may modify the
+    process.</p></div><div class="refsect2"><a name="idm46097882764384"></a><h3>Functions using global state</h3><p>Any function in neon may modify the
     <code class="literal">errno</code> global variable as a side-effect.  Except
     where explicitly documented, the value of <code class="literal">errno</code>
     is unspecified after any neon function call.</p><p>Other than in the use of <code class="literal">errno</code>, the only
@@ -51,7 +51,7 @@
       <code class="function">ne_debug</code>, if enabled at compile time; for
       debugging output</li><li class="listitem"><a class="xref" href="refalloc.html#ne_oom_callback">ne_oom_callback</a> for
       installing a process-global callback to be invoked on
-      <code class="function">malloc</code> failure</li></ul></div></div><div class="refsect2"><a name="idm46200848086736"></a><h3>Namespaces</h3><p>To avoid possible collisions between names used for symbols
+      <code class="function">malloc</code> failure</li></ul></div></div><div class="refsect2"><a name="idm46097882755440"></a><h3>Namespaces</h3><p>To avoid possible collisions between names used for symbols
     and preprocessor macros by an application and the libraries it
     uses, it is good practice for each library to reserve a particular
     <span class="emphasis"><em>namespace prefix</em></span>.  An application which
@@ -80,28 +80,28 @@
         library and dependencies thereof; a number of symbols lie
         outside these prefixes.</td></tr><tr><td><p><span class="term">pakchois_</span></p></td><td>Namespace used by the pakchois 
          library.</td></tr><tr><td><p><span class="term">px_</span></p></td><td>Namespace used by the libproxy
-         library.</td></tr></tbody></table></div></div><div class="refsect2"><a name="idm46200848071232"></a><h3>Argument validation</h3><p>neon does not attempt to validate that the parameters
+         library.</td></tr></tbody></table></div></div><div class="refsect2"><a name="idm46097882739936"></a><h3>Argument validation</h3><p>neon does not attempt to validate that the parameters
     passed to functions conform to the API (for instance, checking
     that pointer arguments are not <code class="literal">NULL</code>).  Any use of the neon API
     which is not documented to produce a certain behaviour results is
     said to produce <span class="emphasis"><em>undefined behaviour</em></span>; it is
-    likely that neon will segfault under these conditions.</p></div><div class="refsect2"><a name="idm46200848067792"></a><h3>URI paths, WebDAV metadata</h3><p>The path strings passed to any function must be
+    likely that neon will segfault under these conditions.</p></div><div class="refsect2"><a name="idm46097882736496"></a><h3>URI paths, WebDAV metadata</h3><p>The path strings passed to any function must be
     <span class="emphasis"><em>URI-encoded</em></span> by the application; neon never
     performs any URI encoding or decoding internally.  WebDAV property
     names and values must be valid UTF-8 encoded Unicode
-    strings.</p></div><div class="refsect2"><a name="idm46200848065488"></a><h3>User interaction</h3><p>As a pure library interface, neon will never produce
+    strings.</p></div><div class="refsect2"><a name="idm46097882734192"></a><h3>User interaction</h3><p>As a pure library interface, neon will never produce
     output on <code class="constant">stdout</code> or
     <code class="constant">stderr</code>; all user interaction is the
-    responsibility of the application.</p></div><div class="refsect2"><a name="idm46200848063376"></a><h3>Memory handling</h3><p>neon does not attempt to cope gracefully with an
+    responsibility of the application.</p></div><div class="refsect2"><a name="idm46097882732080"></a><h3>Memory handling</h3><p>neon does not attempt to cope gracefully with an
     out-of-memory situation; instead, by default, the
     <code class="function">abort</code> function is called to immediately
     terminate the process.  An application may register a custom
     function which will be called before <code class="function">abort</code> in
-    such a situation; see <a class="xref" href="refalloc.html#ne_oom_callback">ne_oom_callback</a>.</p></div><div class="refsect2"><a name="idm46200848060016"></a><h3>Callbacks and userdata</h3><p>Whenever a callback is registered, a
+    such a situation; see <a class="xref" href="refalloc.html#ne_oom_callback">ne_oom_callback</a>.</p></div><div class="refsect2"><a name="idm46097882728720"></a><h3>Callbacks and userdata</h3><p>Whenever a callback is registered, a
     <code class="literal">userdata</code> pointer is also used to allow the
     application to associate a context with the callback.  The
     userdata is of type <em class="type">void *</em>, allowing any pointer to
-    be used.</p></div><div class="refsect2"><a name="idm46200848057568"></a><h3>Large File Support</h3><p>Since version 0.27.0, neon transparently uses the "LFS
+    be used.</p></div><div class="refsect2"><a name="idm46097882726272"></a><h3>Large File Support</h3><p>Since version 0.27.0, neon transparently uses the "LFS
     transitional" interfaces in functions which use file descriptors.
     This allows use of files larger than 2GiB on platforms with a
     native 32-bit <code class="literal">off_t</code> type, where LFS support is
@@ -109,5 +109,5 @@
     type, which is defined to be either <code class="literal">off_t</code> or
     <code class="literal">off64_t</code> according to whether LFS support is
     detected at build time.  neon does not use or require the
-    <code class="literal">-D_FILE_OFFSET_BITS=64</code> macro definition.</p></div></div><div class="refsect1"><a name="idm46200848052304"></a><h2>See also</h2><p><a class="xref" href="refsess.html" title="ne_session_create"><span class="refentrytitle">ne_session_create</span></a>, <a class="xref" href="refalloc.html#ne_oom_callback">ne_oom_callback</a>,
+    <code class="literal">-D_FILE_OFFSET_BITS=64</code> macro definition.</p></div></div><div class="refsect1"><a name="idm46097882721008"></a><h2>See also</h2><p><a class="xref" href="refsess.html" title="ne_session_create"><span class="refentrytitle">ne_session_create</span></a>, <a class="xref" href="refalloc.html#ne_oom_callback">ne_oom_callback</a>,
     <a class="ulink" href="https://notroj.github.io/neon/" target="_top">https://notroj.github.io/neon/</a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ref.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="refconfig.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">neon API reference </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> neon-config</td></tr></table></div></body></html>

libs/neon/doc/html/refparam.html

@@ -0,0 +1,19 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_strparam</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="refhash.html" title="ne_strhash"><link rel="next" href="referr.html" title="ne_get_error"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_strparam</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="refhash.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="referr.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refparam"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_strparam — HTTP extended parameter value encoding</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_string.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">char *<b class="fsfunc">ne_strparam</b>(</code></td><td>const char *<var class="pdparam">charset</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">lang</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">value</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46097882158848"></a><h2>Description</h2><p>The <code class="function">ne_strparam</code> function can be
+	used to encode an extended parameter value for an HTTP header,
+	as defined in RFC 5987.  The function takes as arguments the
+	<code class="parameter">value</code> to encode, using a given MIME
+	<code class="parameter">charset</code> character set, and
+	<code class="parameter">lang</code> language tag.  The extended
+	parameter encoding is used in HTTP protocol specifications to
+	allow easily embedding special characters (such as quote
+	marks, separators or non-ASCII) in header values.</p><p>In accordance with RFC 5987, the
+        <code class="parameter">charset</code> argument must be either
+        <code class="constant">"UTF-8"</code> or
+        <code class="constant">"IS0-8859-1"</code>, but the
+        <code class="parameter">lang</code> argument may be <code class="literal">NULL</code>.</p></div><div class="refsect1"><a name="idm46097882152016"></a><h2>Return value</h2><p>The return value is either:
+
+	</p><div class="variablelist"><table border="0" class="variablelist"><colgroup><col align="left" valign="top"><col></colgroup><tbody><tr><td><p><span class="term"><code class="literal">NULL</code></span></p></td><td>if the value parameter is a "regular
+            parameter" and does not need extended
+            encoding</td></tr><tr><td><p><span class="term">non-<code class="literal">NULL</code></span></p></td><td>the encoding of the input value as an
+            extended parameter as a NUL-terminated, malloc-allocated
+            string</td></tr></tbody></table></div></div><div class="refsect1"><a name="idm46097882146912"></a><h2>See also</h2><p><a class="ulink" href="https://tools.ietf.org/html/rfc5987" target="_top">https://tools.ietf.org/html/rfc5987</a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="refhash.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="referr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ne_strhash </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ne_get_error</td></tr></table></div></body></html>

libs/neon/doc/html/refshave.html

@@ -1,7 +1,7 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_shave</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="refauth.html" title="ne_set_server_auth"><link rel="next" href="refsockinit.html" title="ne_sock_init"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_shave</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="refauth.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refsockinit.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refshave"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_shave — trim whitespace from a string</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_string.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">char *<b class="fsfunc">ne_shave</b>(</code></td><td>char *<var class="pdparam">str</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">whitespace</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46200846415344"></a><h2>Description</h2><p><code class="function">ne_shave</code> returns a portion of
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_shave</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="refauth.html" title="ne_set_server_auth"><link rel="next" href="refsockinit.html" title="ne_sock_init"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_shave</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="refauth.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refsockinit.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refshave"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_shave — trim whitespace from a string</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_string.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">char *<b class="fsfunc">ne_shave</b>(</code></td><td>char *<var class="pdparam">str</var>, </td></tr><tr><td> </td><td>const char *<var class="pdparam">whitespace</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46097880969584"></a><h2>Description</h2><p><code class="function">ne_shave</code> returns a portion of
 <code class="parameter">str</code> with any leading or trailing characters in
 the <code class="parameter">whitespace</code> array removed.
 <code class="parameter">str</code> may be modified.  Note that the return
-value may not be equal to <code class="parameter">str</code>.</p></div><div class="refsect1"><a name="idm46200846411200"></a><h2>Examples</h2><p>The following code segment will output
+value may not be equal to <code class="parameter">str</code>.</p></div><div class="refsect1"><a name="idm46097880965440"></a><h2>Examples</h2><p>The following code segment will output
 	<code class="literal">"fish"</code>:</p><pre class="programlisting">char s[] = ".!.fish!.!";
 puts(ne_shave(s, ".!"));</pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="refauth.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="refsockinit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ne_set_server_auth </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ne_sock_init</td></tr></table></div></body></html>

libs/neon/doc/html/refsockinit.html

@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_sock_init</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="refshave.html" title="ne_shave"><link rel="next" href="refcert.html" title="ne_ssl_cert_identity"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_sock_init</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="refshave.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refcert.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refsockinit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_sock_init, ne_sock_exit — perform library initialization</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_socket.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">ne_sock_init</b>(</code></td><td><code>void)</code>;</td><td> </td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">ne_sock_exit</b>(</code></td><td><code>void)</code>;</td><td> </td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46200846383456"></a><h2>Description</h2><p>In some platforms and configurations, neon may be using
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>ne_sock_init</title><link rel="stylesheet" type="text/css" href="../manual.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="neon HTTP/WebDAV client library"><link rel="up" href="ref.html" title="neon API reference"><link rel="prev" href="refshave.html" title="ne_shave"><link rel="next" href="refcert.html" title="ne_ssl_cert_identity"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ne_sock_init</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="refshave.html">Prev</a> </td><th width="60%" align="center">neon API reference</th><td width="20%" align="right"> <a accesskey="n" href="refcert.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="refsockinit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ne_sock_init, ne_sock_exit — perform library initialization</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include &lt;ne_socket.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">ne_sock_init</b>(</code></td><td><code>void)</code>;</td><td> </td></tr></table><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">ne_sock_exit</b>(</code></td><td><code>void)</code>;</td><td> </td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm46097880937696"></a><h2>Description</h2><p>In some platforms and configurations, neon may be using
     some socket or SSL libraries which require global initialization
     before use.  To perform this initialization, the
     <code class="function">ne_sock_init</code> function must be called before
@@ -25,7 +25,7 @@
     section.  Otherwise, it is not safe to use neon with SSL in a
     multi-threaded process.  The <a class="xref" href="reffeat.html#ne_has_support">ne_has_support</a>
     function can be used to determine whether neon is built to
-    enable thread-safety support in the SSL library.</p><div class="refsect2"><a name="idm46200846371984"></a><h3>Thread-safe SSL with OpenSSL</h3><p>neon follows two simple rules when dealing with the
+    enable thread-safety support in the SSL library.</p><div class="refsect2"><a name="idm46097880926224"></a><h3>Thread-safe SSL with OpenSSL</h3><p>neon follows two simple rules when dealing with the
       OpenSSL locking callbacks:
 
       </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><code class="function">ne_sock_init</code> will set
@@ -37,7 +37,7 @@
 
       Applications and libraries should be able to co-operate to
       ensure that SSL use is always thread-safe if similar rules are
-      always followed.</p></div><div class="refsect2"><a name="idm46200846367392"></a><h3>Thread-safe SSL with GnuTLS</h3><p>The cryptography library used by GnuTLS, libgcrypt, only
+      always followed.</p></div><div class="refsect2"><a name="idm46097880921632"></a><h3>Thread-safe SSL with GnuTLS</h3><p>The cryptography library used by GnuTLS, libgcrypt, only
       supports an initialization operation to register thread-safety
       callbacks.  <code class="function">ne_sock_init</code> will register the
       thread-safe locking callbacks on first use;
@@ -46,6 +46,6 @@
       unsafe to dynamically unload neon from the process if neon
       is configured with thread-safe SSL support enabled (since the
       callbacks would be left pointing at unmapped memory once neon
-      is unloaded).</p></div></div><div class="refsect1"><a name="idm46200846364224"></a><h2>Return value</h2><p><code class="function">ne_sock_init</code> returns zero on success,
+      is unloaded).</p></div></div><div class="refsect1"><a name="idm46097880918464"></a><h2>Return value</h2><p><code class="function">ne_sock_init</code> returns zero on success,
     or non-zero on error.  If an error occurs, no further use of the
-    neon library should be attempted.</p></div><div class="refsect1"><a name="idm46200846362320"></a><h2>See also</h2><p><a class="xref" href="refneon.html" title="neon"><span class="refentrytitle">neon</span></a>, <a class="xref" href="reffeat.html" title="ne_has_support"><span class="refentrytitle">ne_has_support</span></a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="refshave.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="refcert.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ne_shave </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ne_ssl_cert_identity</td></tr></table></div></body></html>
+    neon library should be attempted.</p></div><div class="refsect1"><a name="idm46097880916560"></a><h2>See also</h2><p><a class="xref" href="refneon.html" title="neon"><span class="refentrytitle">neon</span></a>, <a class="xref" href="reffeat.html" title="ne_has_support"><span class="refentrytitle">ne_has_support</span></a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="refshave.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="refcert.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ne_shave </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ne_ssl_cert_identity</td></tr></table></div></body></html>

libs/neon/doc/html/refstatus.html

@@ -4,7 +4,7 @@ typedef struct {
     int major_version, minor_version;
     int code, klass;
     const char *reason_phrase;
-} <em class="type">ne_status</em>;</pre></div></div><div class="refsect1"><a name="idm46200845892192"></a><h2>Description</h2><p>An <em class="type">ne_status</em> type represents an HTTP
+} <em class="type">ne_status</em>;</pre></div></div><div class="refsect1"><a name="idm46097880446752"></a><h2>Description</h2><p>An <em class="type">ne_status</em> type represents an HTTP
 response status; used in response messages giving a result of request.
 The <em class="structfield"><code>major_version</code></em> and
 <em class="structfield"><code>minor_version</code></em> fields give the HTTP version
@@ -12,11 +12,11 @@ supported by the server issuing the response.  The
 <em class="structfield"><code>code</code></em> field gives the status code of the
 result (lying between 100 and 999 inclusive), and the
 <em class="structfield"><code>klass</code></em> field gives the
-class<a href="#ftn.idm46200845889152" class="footnote" name="idm46200845889152"><sup class="footnote">[2]</sup></a>, which is equal to the most significant digit
+class<a href="#ftn.idm46097880443712" class="footnote" name="idm46097880443712"><sup class="footnote">[2]</sup></a>, which is equal to the most significant digit
 of the status.</p><p>There are five classes of HTTP status code defined by
 	RFC2616:</p><div class="variablelist"><table border="0" class="variablelist"><colgroup><col align="left" valign="top"><col></colgroup><tbody><tr><td><p><span class="term"><code class="literal">1xx</code></span></p></td><td>Informational response.</td></tr><tr><td><p><span class="term"><code class="literal">2xx</code></span></p></td><td>Success: the operation was successful</td></tr><tr><td><p><span class="term"><code class="literal">3xx</code></span></p></td><td>Redirection</td></tr><tr><td><p><span class="term"><code class="literal">4xx</code></span></p></td><td>Client
 	    error: the request made was incorrect in some
-	    manner.</td></tr><tr><td><p><span class="term"><code class="literal">5xx</code></span></p></td><td>Server error</td></tr></tbody></table></div></div><div class="refsect1"><a name="idm46200845877984"></a><h2>See also</h2><p><a class="xref" href="refgetst.html#ne_get_status">ne_get_status</a>.</p></div><div class="footnotes"><br><hr style="width:100; text-align:left;margin-left: 0"><div id="ftn.idm46200845889152" class="footnote"><p><a href="#idm46200845889152" class="para"><sup class="para">[2] </sup></a>the field is named <span class="quote">“<span class="quote">klass</span>”</span> not
+	    manner.</td></tr><tr><td><p><span class="term"><code class="literal">5xx</code></span></p></td><td>Server error</td></tr></tbody></table></div></div><div class="refsect1"><a name="idm46097880432544"></a><h2>See also</h2><p><a class="xref" href="refgetst.html#ne_get_status">ne_get_status</a>.</p></div><div class="footnotes"><br><hr style="width:100; text-align:left;margin-left: 0"><div id="ftn.idm46097880443712" class="footnote"><p><a href="#idm46097880443712" class="para"><sup class="para">[2] </sup></a>the field is named <span class="quote">“<span class="quote">klass</span>”</span> not
 <span class="quote">“<span class="quote">class</span>”</span> so that the header can be used from a C++
 program, in which <span class="quote">“<span class="quote">class</span>”</span> is a reserved
 word)</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="refclicert.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="reftok.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">ne_ssl_client_cert </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ne_token</td></tr></table></div></body></html>

libs/neon/doc/html/security.html

@@ -4,7 +4,7 @@
   application) can be tricked into accessing an HTTP server which is
   controlled by an attacker.  This section documents various types of
   possible attack and describes what mitigation is used in
-  neon.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46200853782144"></a>CPU or memory consumption attacks</h3></div></div></div><p>neon uses fixed resource limits to prevent the following
+  neon.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46097888446992"></a>CPU or memory consumption attacks</h3></div></div></div><p>neon uses fixed resource limits to prevent the following
     attacks:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>memory/CPU consumption attack using an unbounded number
         of response header fields</p></li><li class="listitem"><p>memory consumption attack using an unbounded length of
         individual response header lines (or continuation
@@ -17,7 +17,7 @@
     must be mitigated at application level.  Memory consumption in
     neon itself is fixed and is not proportional to the response
     size.</p><p>Test cases for all the above attacks are present in the
-    neon test suite.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46200853773616"></a>SSL/TLS connection security</h3></div></div></div><p>When using a connection secured by SSL/TLS, it is necessary
+    neon test suite.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46097888494800"></a>SSL/TLS connection security</h3></div></div></div><p>When using a connection secured by SSL/TLS, it is necessary
     for clients to verify that the X.509 certificate presented by the
     server matches the server's expected identity.  The algorithm
     required for this purpose is described in RFC 2818 and RFC 3280,
@@ -35,14 +35,14 @@
     present the certificate details to a user for manual/off-line
     verification, if possible.</p><p>Test cases for the correctness of the implementation of the
     identity verification algorithm are present in the neon test
-    suite.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46200848285312"></a>Control character insertion in error messages</h3></div></div></div><p>Where error messages (as returned by
+    suite.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46097882952960"></a>Control character insertion in error messages</h3></div></div></div><p>Where error messages (as returned by
     (<a class="xref" href="referr.html#ne_get_error">ne_get_error</a>) contain data supplied by the
     server, the untrusted data is sanitised to remove both control
     characters and non-ASCII characters.  This prevents any attacks
     where such error messages are exposed to the user and can
     potentially distort the presentation of the interface (for
     example, through the use of a carriage return character in a text
-    user interface).</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46200848283264"></a>Attacks against authentication credentials</h3></div></div></div><p>Authentication credentials can be compromised by a
+    user interface).</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idm46097882950912"></a>Attacks against authentication credentials</h3></div></div></div><p>Authentication credentials can be compromised by a
     "downgrade attack" by an active attacker; for example, where a
     MITM presents a Basic authentication challenge in place of the
     server's Digest challenge.  neon mitigates these attacks by

libs/neon/doc/man/ne_add_request_header.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_add_request_header
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_ADD_REQUEST_HEADE" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_ADD_REQUEST_HEADE" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_addr_resolve.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_addr_resolve
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_ADDR_RESOLVE" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_ADDR_RESOLVE" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_buffer.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_buffer
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_BUFFER" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_BUFFER" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -49,7 +49,7 @@ The
 type represents an expandable memory buffer for holding
 NUL\-terminated strings\&. The
 \fIdata\fR
-field points to the beginnning of the string, the length of which is given by the
+field points to the beginning of the string, the length of which is given by the
 \fIused\fR
 field\&. The current size of memory allocated is given by the
 \fIlength\fR

libs/neon/doc/man/ne_buffer_append.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_buffer_append
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_BUFFER_APPEND" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_BUFFER_APPEND" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_buffer_clear.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_buffer_clear
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_BUFFER_CLEAR" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_BUFFER_CLEAR" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_buffer_create.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_buffer_create
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_BUFFER_CREATE" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_BUFFER_CREATE" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_buffer_destroy.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_buffer_destroy
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_BUFFER_DESTROY" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_BUFFER_DESTROY" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_get_error.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_get_error
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_GET_ERROR" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_GET_ERROR" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_get_response_header.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_get_response_header
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_GET_RESPONSE_HEAD" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_GET_RESPONSE_HEAD" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_get_status.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_get_status
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_GET_STATUS" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_GET_STATUS" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_has_support.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_has_support
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_HAS_SUPPORT" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_HAS_SUPPORT" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_i18n_init.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_i18n_init
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_I18N_INIT" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_I18N_INIT" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_iaddr_make.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_iaddr_make
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_IADDR_MAKE" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_IADDR_MAKE" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_malloc.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_malloc
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_MALLOC" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_MALLOC" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_request_create.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_request_create
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_REQUEST_CREATE" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_REQUEST_CREATE" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_session_create.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_session_create
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SESSION_CREATE" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SESSION_CREATE" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_session_proxy.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_session_proxy
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SESSION_PROXY" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SESSION_PROXY" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_set_request_body_buffer.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_set_request_body_buffer
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SET_REQUEST_BODY_" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SET_REQUEST_BODY_" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_set_request_flag.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_set_request_flag
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SET_REQUEST_FLAG" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SET_REQUEST_FLAG" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_set_server_auth.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_set_server_auth
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SET_SERVER_AUTH" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SET_SERVER_AUTH" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_set_session_flag.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_set_session_flag
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SET_SESSION_FLAG" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SET_SESSION_FLAG" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_set_useragent.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_set_useragent
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SET_USERAGENT" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SET_USERAGENT" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_shave.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_shave
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SHAVE" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SHAVE" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_sock_init.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_sock_init
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SOCK_INIT" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SOCK_INIT" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_ssl_cert_cmp.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_ssl_cert_cmp
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SSL_CERT_CMP" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SSL_CERT_CMP" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_ssl_cert_identity.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_ssl_cert_identity
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SSL_CERT_IDENTITY" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SSL_CERT_IDENTITY" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_ssl_cert_read.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_ssl_cert_read
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SSL_CERT_READ" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SSL_CERT_READ" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_ssl_clicert_read.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_ssl_client_cert
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SSL_CLIENT_CERT" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SSL_CLIENT_CERT" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_ssl_readable_dname.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_ssl_dname
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SSL_DNAME" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SSL_DNAME" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_ssl_set_verify.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_ssl_set_verify
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SSL_SET_VERIFY" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SSL_SET_VERIFY" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_ssl_trust_cert.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_ssl_trust_cert
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_SSL_TRUST_CERT" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_SSL_TRUST_CERT" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_status.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_status
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_STATUS" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_STATUS" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_strhash.3

@@ -0,0 +1,106 @@
+'\" t
+.\"     Title: ne_strhash
+.\"    Author: 
+.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
+.\"      Date: 20 September 2021
+.\"    Manual: neon API reference
+.\"    Source: neon 0.32.1
+.\"  Language: English
+.\"
+.TH "NE_STRHASH" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+ne_strhash, ne_vstrhash \- string hash interface
+.SH "SYNOPSIS"
+.sp
+.ft B
+.nf
+#include <ne_string\&.h>
+.fi
+.ft
+.HP \w'char\ *ne_strhash('u
+.BI "char *ne_strhash(unsigned\ int\ " "flags" ", " "\&.\&.\&." ");"
+.HP \w'char\ *ne_vstrhash('u
+.BI "char *ne_vstrhash(unsigned\ int\ " "flags" ", va_list\ " "ap" ");"
+.SH "DESCRIPTION"
+.PP
+The
+\fBne_strhash\fR
+and
+\fBne_vstrhash\fR
+functions can be used to create hashes\&. The varargs argument list must be
+\fBconst char *\fR
+strings followed by a
+NULL
+terminator\&. The
+\fIflags\fR
+argument must select exactly one hash algorithm from the list below, which can be optionally bitwise\-ORed with one of the formatting option\&. The hash is calculated for the concatenation of the argument list, without separators\&.
+.SS "Hash algorithms"
+.PP
+The following hash algorithms are available:
+.PP
+\fBNE_HASH_MD5\fR
+.RS 4
+MD5
+.RE
+.PP
+\fBNE_HASH_SHA256\fR
+.RS 4
+SHA\-256 (SHA\-2)
+.RE
+.PP
+\fBNE_HASH_SHA512\fR
+.RS 4
+SHA\-512 (SHA\-2)
+.RE
+.PP
+\fBNE_HASH_SHA256_256\fR
+.RS 4
+SHA\-512/256 (SHA\-2)
+.RE
+.SS "Formatting options"
+.PP
+By default, the hash is returned as a hexadecimal lower\-case character string\&. The following formatting options are available:
+.PP
+\fBNE_HASH_COLON\fR
+.RS 4
+colon\-separated hex pairs, e\&.g\&.
+"aa:11:22\&.\&.\&."
+.RE
+.PP
+\fBNE_HASH_SPACE\fR
+.RS 4
+space\-separated hex pairs, e\&.g\&.
+"aa 11 22\&.\&.\&."
+.RE
+.SH "RETURN VALUE"
+.PP
+The return value is the ASCII hexadecimal representation of the hash as a malloc\-allocated, NUL\-terminated string, or
+NULL
+if the hash cannot be created\&. The string length is determined by the hash algorithm (and formatting options used)\&. Support for hash algorithms is specific to the SSL toolkit with which neon is compiled\&. Some systems will further restrict hash availability at runtime, e\&.g\&. due to FIPS mode\&.
+.SH "AUTHOR"
+.PP
+\fBJoe Orton\fR <\&[email protected]\&>
+.RS 4
+Author.
+.RE
+.SH "COPYRIGHT"
+.br

libs/neon/doc/man/ne_strparam.3

@@ -0,0 +1,85 @@
+'\" t
+.\"     Title: ne_strparam
+.\"    Author: 
+.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
+.\"      Date: 20 September 2021
+.\"    Manual: neon API reference
+.\"    Source: neon 0.32.1
+.\"  Language: English
+.\"
+.TH "NE_STRPARAM" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+ne_strparam \- HTTP extended parameter value encoding
+.SH "SYNOPSIS"
+.sp
+.ft B
+.nf
+#include <ne_string\&.h>
+.fi
+.ft
+.HP \w'char\ *ne_strparam('u
+.BI "char *ne_strparam(const\ char\ *" "charset" ", const\ char\ *" "lang" ", const\ char\ *" "value" ");"
+.SH "DESCRIPTION"
+.PP
+The
+\fBne_strparam\fR
+function can be used to encode an extended parameter value for an HTTP header, as defined in RFC 5987\&. The function takes as arguments the
+\fIvalue\fR
+to encode, using a given MIME
+\fIcharset\fR
+character set, and
+\fIlang\fR
+language tag\&. The extended parameter encoding is used in HTTP protocol specifications to allow easily embedding special characters (such as quote marks, separators or non\-ASCII) in header values\&.
+.PP
+In accordance with RFC 5987, the
+\fIcharset\fR
+argument must be either
+\fB"UTF\-8"\fR
+or
+\fB"IS0\-8859\-1"\fR, but the
+\fIlang\fR
+argument may be
+NULL\&.
+.SH "RETURN VALUE"
+.PP
+The return value is either:
+.PP
+NULL
+.RS 4
+if the value parameter is a "regular parameter" and does not need extended encoding
+.RE
+.PP
+non\-NULL
+.RS 4
+the encoding of the input value as an extended parameter as a NUL\-terminated, malloc\-allocated string
+.RE
+.SH "SEE ALSO"
+.PP
+\m[blue]\fB\%https://tools.ietf.org/html/rfc5987\fR\m[]
+.SH "AUTHOR"
+.PP
+\fBJoe Orton\fR <\&[email protected]\&>
+.RS 4
+Author.
+.RE
+.SH "COPYRIGHT"
+.br

libs/neon/doc/man/ne_token.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_token
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_TOKEN" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_TOKEN" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_version_match.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_version_match
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_VERSION_MATCH" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_VERSION_MATCH" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/ne_vstrhash.3

@@ -0,0 +1 @@
+.so man3/ne_strhash.3

libs/neon/doc/man/ne_xml_create.3

@@ -2,12 +2,12 @@
 .\"     Title: ne_xml_create
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NE_XML_CREATE" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NE_XML_CREATE" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/neon-config.1

@@ -2,12 +2,12 @@
 .\"     Title: neon-config
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NEON\-CONFIG" "1" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NEON\-CONFIG" "1" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/man/neon.3

@@ -2,12 +2,12 @@
 .\"     Title: neon
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 20 June 2020
+.\"      Date: 20 September 2021
 .\"    Manual: neon API reference
-.\"    Source: neon 0.31.2
+.\"    Source: neon 0.32.1
 .\"  Language: English
 .\"
-.TH "NEON" "3" "20 June 2020" "neon 0.31.2" "neon API reference"
+.TH "NEON" "3" "20 September 2021" "neon 0.32.1" "neon API reference"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

libs/neon/doc/manual.xml

@@ -65,6 +65,8 @@
 <!ENTITY refbufapp SYSTEM "ref/bufapp.xml">
 <!ENTITY refbufdest SYSTEM "ref/bufdest.xml">
 <!ENTITY refbufutil SYSTEM "ref/bufutil.xml">
+<!ENTITY refhash SYSTEM "ref/hash.xml">
+<!ENTITY refparam SYSTEM "ref/param.xml">
 <!ENTITY reftok SYSTEM "ref/tok.xml">
 <!ENTITY refshave SYSTEM "ref/shave.xml">
 <!ENTITY refvers SYSTEM "ref/vers.xml">
@@ -87,7 +89,7 @@
       </personname>
       <email>[email protected]</email>
     </author>
-    <copyright><year>2001-2008</year><holder>Joe Orton</holder></copyright>
+    <copyright><year>2001-2021</year><holder>Joe Orton</holder></copyright>
 
     <legalnotice>
 
@@ -170,6 +172,8 @@ ignoring the WebDAV support if desired.</para>
     &refbufutil; <!-- ne_buffer_clear -->
     &refbufcr; <!-- ne_buffer_create -->
     &refbufdest; <!-- ne_buffer_destroy -->
+    &refhash; <!-- ne_strhash -->
+    &refparam; <!-- ne_strparam -->
     &referr; <!-- ne_get_error -->
     &refgetst; <!-- ne_get_status -->
     &reffeat; <!-- ne_has_support -->

libs/neon/doc/ref/buf.xml

@@ -27,7 +27,7 @@ typedef struct {
 
 	<para>The <type>ne_buffer</type> type represents an expandable
 memory buffer for holding &nul;-terminated strings.  The
-<structfield>data</structfield> field points to the beginnning of the
+<structfield>data</structfield> field points to the beginning of the
 string, the length of which is given by the
 <structfield>used</structfield> field.  The current size of memory
 allocated is given by the <structfield>length</structfield> field.  It

libs/neon/doc/ref/hash.xml

@@ -0,0 +1,108 @@
+    <refentry id="refhash">
+
+      <refmeta>
+	<refentrytitle>ne_strhash</refentrytitle>
+	<manvolnum>3</manvolnum>
+      </refmeta>
+
+      <refnamediv>
+	<refname id="ne_strhash">ne_strhash</refname>
+	<refname id="ne_vstrhash">ne_vstrhash</refname>
+	<refpurpose>string hash interface</refpurpose>
+      </refnamediv>
+      
+      <refsynopsisdiv>
+
+	<funcsynopsis>
+          <funcsynopsisinfo>#include &lt;ne_string.h&gt;</funcsynopsisinfo>
+
+	  <funcprototype>
+	    <funcdef>char *<function>ne_strhash</function></funcdef>
+	    <paramdef>unsigned int <parameter>flags</parameter></paramdef>
+	    <paramdef><parameter>...</parameter></paramdef>
+	  </funcprototype>
+
+	  <funcprototype>
+	    <funcdef>char *<function>ne_vstrhash</function></funcdef>
+	    <paramdef>unsigned int <parameter>flags</parameter></paramdef>
+	    <paramdef>va_list <parameter>ap</parameter></paramdef>
+	  </funcprototype>
+        </funcsynopsis>
+
+      </refsynopsisdiv>
+
+      <refsect1>
+	<title>Description</title>
+
+	<para>The <function>ne_strhash</function> and
+	<function>ne_vstrhash</function> functions can be used to
+	create hashes.  The varargs argument list must be <type>const
+	char *</type> strings followed by a &null; terminator.  The
+	<parameter>flags</parameter> argument must select exactly one
+	hash algorithm from the list below, which can be optionally
+	bitwise-ORed with one of the formatting option.  The hash is
+	calculated for the concatenation of the argument list, without
+	separators.</para>
+
+        <refsect2>
+          <title>Hash algorithms</title>
+        
+        <para>The following hash algorithms are available:
+	<variablelist>
+	  <varlistentry>
+            <term><constant>NE_HASH_MD5</constant></term>
+	    <listitem><simpara>MD5</simpara></listitem>
+	  </varlistentry>
+	  <varlistentry>
+            <term><constant>NE_HASH_SHA256</constant></term>
+	    <listitem><simpara>SHA-256 (SHA-2)</simpara></listitem>
+	  </varlistentry>
+	  <varlistentry>
+            <term><constant>NE_HASH_SHA512</constant></term>
+	    <listitem><simpara>SHA-512 (SHA-2)</simpara></listitem>
+	  </varlistentry>
+	  <varlistentry>
+            <term><constant>NE_HASH_SHA256_256</constant></term>
+	    <listitem><simpara>SHA-512/256 (SHA-2)</simpara></listitem>
+	  </varlistentry>
+        </variablelist>
+
+        </para></refsect2>
+        
+        <refsect2>
+          <title>Formatting options</title>
+          
+          <para>By default, the hash is returned as a hexadecimal
+          lower-case character string. The following formatting
+          options are available:
+        
+	<variablelist>
+	  <varlistentry>
+            <term><constant>NE_HASH_COLON</constant></term>
+	    <listitem><simpara>colon-separated hex pairs, e.g. <literal>"aa:11:22..."</literal> </simpara></listitem>
+	  </varlistentry>
+	  <varlistentry>
+            <term><constant>NE_HASH_SPACE</constant></term>
+	    <listitem><simpara>space-separated hex pairs, e.g. <literal>"aa 11 22..."</literal></simpara></listitem>
+	  </varlistentry>
+          </variablelist></para>
+
+        </refsect2>
+        
+      </refsect1>
+
+      <refsect1>
+	<title>Return value</title>
+
+        <para>The return value is the ASCII hexadecimal representation
+        of the hash as a malloc-allocated, NUL-terminated string, or
+        &null; if the hash cannot be created.  The string length is
+        determined by the hash algorithm (and formatting options
+        used).  Support for hash algorithms is specific to the SSL
+        toolkit with which &neon; is compiled.  Some systems will
+        further restrict hash availability at runtime, e.g. due to
+        FIPS mode.</para>
+
+      </refsect1>
+
+    </refentry>

libs/neon/doc/ref/param.xml

@@ -0,0 +1,74 @@
+    <refentry id="refparam">
+
+      <refmeta>
+	<refentrytitle>ne_strparam</refentrytitle>
+	<manvolnum>3</manvolnum>
+      </refmeta>
+
+      <refnamediv>
+	<refname id="ne_strparam">ne_strparam</refname>
+	<refpurpose>HTTP extended parameter value encoding</refpurpose>
+      </refnamediv>
+
+      <refsynopsisdiv>
+
+	<funcsynopsis>
+          <funcsynopsisinfo>#include &lt;ne_string.h&gt;</funcsynopsisinfo>
+
+	  <funcprototype>
+	    <funcdef>char *<function>ne_strparam</function></funcdef>
+	    <paramdef>const char *<parameter>charset</parameter></paramdef>
+	    <paramdef>const char *<parameter>lang</parameter></paramdef>
+	    <paramdef>const char *<parameter>value</parameter></paramdef>
+	  </funcprototype>
+	</funcsynopsis>
+
+      </refsynopsisdiv>
+
+      <refsect1>
+	<title>Description</title>
+
+	<para>The <function>ne_strparam</function> function can be
+	used to encode an extended parameter value for an HTTP header,
+	as defined in RFC 5987.  The function takes as arguments the
+	<parameter>value</parameter> to encode, using a given MIME
+	<parameter>charset</parameter> character set, and
+	<parameter>lang</parameter> language tag.  The extended
+	parameter encoding is used in HTTP protocol specifications to
+	allow easily embedding special characters (such as quote
+	marks, separators or non-ASCII) in header values.</para>
+
+        <para>In accordance with RFC 5987, the
+        <parameter>charset</parameter> argument must be either
+        <constant>"UTF-8"</constant> or
+        <constant>"IS0-8859-1"</constant>, but the
+        <parameter>lang</parameter> argument may be &null;.</para>
+      </refsect1>
+
+      <refsect1>
+	<title>Return value</title>
+
+        <para>The return value is either:
+
+	<variablelist>
+	  <varlistentry>
+            <term>&null;</term>
+            <listitem><simpara>if the value parameter is a "regular
+            parameter" and does not need extended
+            encoding</simpara></listitem> </varlistentry>
+            <varlistentry>
+            <term>non-&null;</term>
+            <listitem><simpara>the encoding of the input value as an
+            extended parameter as a NUL-terminated, malloc-allocated
+            string</simpara></listitem>
+	  </varlistentry>
+        </variablelist></para>
+      </refsect1>
+
+  <refsect1>
+    <title>See also</title>
+
+    <para><ulink url="https://tools.ietf.org/html/rfc5987"/></para>
+  </refsect1>
+
+</refentry>