From f3d8514681a6a9a0664d3ad0b6b72eb87346f92f Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Thu, 14 Jan 2021 23:24:53 +0000
Subject:  Prepare for 2.3.5.0, s6dns_message_get_domain_nodecode() now public

---
 doc/index.html                  |  4 ++--
 doc/libs6dns/s6dns-message.html | 19 ++++++++++++++++---
 doc/upgrade.html                | 10 ++++++++++
 3 files changed, 28 insertions(+), 5 deletions(-)

(limited to 'doc')

diff --git a/doc/index.html b/doc/index.html
index 7af0349..f7b0ed7 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -46,7 +46,7 @@ point in the future.
  <li> A POSIX-compliant system with a standard C development environment </li>
  <li> GNU make, version 3.81 or later </li>
  <li> <a href="//skarnet.org/software/skalibs/">skalibs</a> version
-2.10.0.0 or later. It's a build-time requirement. It's also a run-time
+2.10.0.1 or later. It's a build-time requirement. It's also a run-time
 requirement if you link against the shared version of the skalibs library. </li>
 </ul>
 
@@ -60,7 +60,7 @@ requirement if you link against the shared version of the skalibs library. </li>
 <h3> Download </h3>
 
 <ul>
- <li> The current released version of s6-dns is <a href="s6-dns-2.3.4.0.tar.gz">2.3.4.0</a>. </li>
+ <li> The current released version of s6-dns is <a href="s6-dns-2.3.5.0.tar.gz">2.3.5.0</a>. </li>
  <li> Alternatively, you can checkout a copy of the
 <a href="//git.skarnet.org/cgi-bin/cgit.cgi/s6-dns/">s6-dns
 git repository</a>:
diff --git a/doc/libs6dns/s6dns-message.html b/doc/libs6dns/s6dns-message.html
index 315b375..14c5527 100644
--- a/doc/libs6dns/s6dns-message.html
+++ b/doc/libs6dns/s6dns-message.html
@@ -134,9 +134,14 @@ the series of character-strings.
 </p>
 
 <p>
-<code> unsigned int s6dns_message_get_domain (s6dns_domain_t *d, char const *packet, unsigned int packetlen, unsigned int *pos) </code> <br />
-Reads a domain and stores it, in string form, into *<em>d</em>.
-Returns 1 on success and 0 on failure, and sets errno:
+<code> size_t s6dns_message_get_domain_nodecode (char *out, size_t outmax, char const *packet, unsigned int packetlen, unsigned int *pos) </code> <br />
+Reads a domain and stores it, in packet form, into *<em>out</em>, which is a character
+array that must have been preallocated by the user; <em>outmax</em> is the maximum
+number of characters that can be stored in <em>out</em>. As a special
+case, <em>out</em> can be NULL, in which case nothing will be written, but
+the domain will still be parsed and <em>pos</em> will still be updated.
+The function returns the number of characters written to <em>out</em>
+(or that would have been). If 0, it denotes a failure, and errno is set:
 </p>
 
 <ul>
@@ -145,8 +150,16 @@ Returns 1 on success and 0 on failure, and sets errno:
 misused. </li>
  <li> EPROTONOSUPPORT: the domain encoding uses an extension that the function
 does not recognize. </li>
+ <li> ENAMETOOLONG: the domain cannot be stored in <em>outmax</em> characters. </li>
 </ul>
 
+<p>
+<code> unsigned int s6dns_message_get_domain (s6dns_domain_t *d, char const *packet, unsigned int packetlen, unsigned int *pos) </code> <br />
+Reads a domain and stores it, in string form, into *<em>d</em>.
+Returns 1 on success and 0 on failure, and sets errno just like the
+function above.
+</p>
+
 <p>
 <code> int s6dns_message_get_hinfo (s6dns_message_rr_hinfo_t *p, char const *packet, unsigned int packetlen, unsigned int *pos) </code> <br />
 Reads a HINFO RR and stores it into *<em>p</em>. Returns 1 on success or 0
diff --git a/doc/upgrade.html b/doc/upgrade.html
index 5b7b9bb..496066e 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -18,6 +18,16 @@
 
 <h1> What has changed in s6-dns </h1>
 
+<h2> in 2.3.5.0 </h2>
+
+<ul>
+ <li> <a href="//skarnet.org/software/skalibs/">skalibs</a>
+dependency bumped to 2.10.0.1. </li>
+ <li> The <tt>s6dns_message_get_domain_internal()</tt> function
+has been made public under the name
+<a href="libs6dns/s6dns-message.html">s6dns_message_get_domain_nodecode()</a>. </li>
+</ul>
+
 <h2> in 2.3.4.0 </h2>
 
 <ul>
-- 
cgit v1.3.1