From: Bruno Haible <bruno@clisp.org>
Date: Fri, 31 Jul 2020 20:58:21 +0000 (-0700)
Subject: doc: Update some more macro descriptions.
X-Git-Tag: v2.69c~61
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ca67a088dc3cbbebfcd9dcaa11a6fbb0c926e113;p=thirdparty%2Fautoconf.git

doc: Update some more macro descriptions.

* doc/autoconf.texi (Particular Functions): Add a remark about AC_FUNC_MMAP.
Clarify AC_FUNC_STRCOLL.
---

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 79ecc9da..2a279ef2 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -5393,6 +5393,10 @@ memory.
 
 The result of this macro is cached in the
 @code{ac_cv_func_mmap_fixed_mapped} variable.
+
+Note: This macro asks for more than what an average program needs from
+@code{mmap}.  In particular, the use of @code{MAP_FIXED} fails on
+HP-UX 11, whereas @code{mmap} otherwise works fine on this platform.
 @end defmac
 
 @defmac AC_FUNC_OBSTACK
@@ -5509,7 +5513,8 @@ New programs need not use these macros.
 If the @code{strcoll} function exists and works correctly, define
 @code{HAVE_STRCOLL}.  This does a bit more than
 @samp{AC_CHECK_FUNCS(strcoll)}, because some systems have incorrect
-definitions of @code{strcoll} that should not be used.
+definitions of @code{strcoll} that should not be used.  But it does
+not check against a known bug of this function on Solaris 10.
 
 The result of this macro is cached in the @code{ac_cv_func_strcoll_works}
 variable.