[PATCH] getaddrinfo: Doc fix.

[Simon Josefsson]

Hi.  There were discussion about libidn/libidn2 support for GNU
InetUtils, and today I believe the recommended way for GNU applications
is to use system getaddrinfo for IDN functionality and not link to
libidn/libidn2 directly.  This works fine on modern glibc systems, and
using it reduces complexity in InetUtils.  However gnulib's replacement
for getaddrinfo does not support IDN, so then IDN will not work on
non-GNU platforms.  I have pushed the doc fix below to document that
fact until we have IDN-functionality in our getaddrinfo-replacement.

/Simon

From e1f404f4bf6f840c4f1238baa7ec5ad2ca3c722c Mon Sep 17 00:00:00 2001
From: Simon Josefsson <simon@josefsson.org>
Date: Mon, 25 Jan 2021 08:51:29 +0100
Subject: [PATCH] getaddrinfo: Doc fix.

* doc/posix-functions/getaddrinfo.texi (getaddrinfo): Gnulib does
not support IDN.
---
 ChangeLog                            | 6 ++++++
 doc/posix-functions/getaddrinfo.texi | 3 +++
 2 files changed, 9 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 12bb66a4e..22c66ea3f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2021-01-25  Simon Josefsson  <simon@josefsson.org>
+
+       getaddrinfo: Doc fix.
+       * doc/posix-functions/getaddrinfo.texi (getaddrinfo): Gnulib does
+       not support IDN.
+
 2021-01-24  Bruno Haible  <bruno@clisp.org>
 
        getcwd: Fix cross-compilation guess for musl libc.
diff --git a/doc/posix-functions/getaddrinfo.texi 
b/doc/posix-functions/getaddrinfo.texi
index eae5b8b59..8c2bc7f0d 100644
--- a/doc/posix-functions/getaddrinfo.texi
+++ b/doc/posix-functions/getaddrinfo.texi
@@ -21,4 +21,7 @@ that is different from @code{cdecl}.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+Unlike glibc's implementation, gnulib's replacement does not support
+internationalized domain names (IDN) encoding.
 @end itemize
-- 
2.20.1

signature.asc
Description: PGP signature