Re: doc updates for section "Particular Functions"

From e9bfc7c7582a6b69bf753f2bea5d4cb1f669759a Mon Sep 17 00:00:00 2001
From: Paul Eggert <[email protected]>
Date: Fri, 31 Jul 2020 14:09:31 -0700
Subject: [PATCH] * doc/autoconf.texi: Tweak wording.

---
 doc/autoconf.texi | 40 ++++++++++++++++++++--------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 2a279ef2..6ad4dca1 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -4655,10 +4655,10 @@ on some architectures.  This section tries to make an inventory of these
 portability issues.  By definition, this list always requires
 additions.  A much more complete list is maintained by the Gnulib
 project (@pxref{Gnulib}), covering @ref{Function Substitutes, ,
-Current Posix Functions, gnulib, GNU gnulib}, @ref{Legacy Function
-Substitutes, , Legacy Functions, gnulib, GNU gnulib}, and @ref{Glibc
-Function Substitutes, , Glibc Functions, gnulib, GNU gnulib}.  Please
-help us keep the gnulib list as complete as possible.
+Current Posix Functions, gnulib, Gnulib}, @ref{Legacy Function
+Substitutes, , Legacy Functions, gnulib, Gnulib}, and @ref{Glibc
+Function Substitutes, , Glibc Functions, gnulib, Gnulib}.  Please
+help us keep the Gnulib list as complete as possible.
 
 @table @asis
 @item @code{exit}
@@ -4700,7 +4700,7 @@ typically assume @code{double} arguments.  On such a system,
 @code{isinf} incorrectly returns true for a finite @code{long double}
 argument that is outside the range of @code{double}.
 
-The best workaround for these issues is to use gnulib modules
+The best workaround for these issues is to use Gnulib modules
 @code{isinf} and @code{isnan} (@pxref{Gnulib}).  But a lighter weight
 solution involves code like the following.
 
@@ -4983,7 +4983,7 @@ should accept @option{-1} for @code{uid} and @code{gid}), define
 @code{HAVE_CHOWN}.  The result of this macro is cached in the
 @code{ac_cv_func_chown_works} variable.
 
-If you actually want a workaround, that is, a @code{chown} function is
+If you want a workaround, that is, a @code{chown} function that is
 available and works, you can use the Gnulib module @code{chown}.
 @xref{Gnulib}.
 @end defmac
@@ -5121,7 +5121,7 @@ may occur when compiling with @code{AC_SYS_LARGEFILE} on
 largefile-sensitive systems where @code{off_t} does not default to a
 64bit entity.  All systems with @code{fseeko} also supply @code{ftello}.
 
-Gnulib contains a module @code{fseeko}, that invokes @code{AC_FUNC_FSEEKO}
+The Gnulib module @code{fseeko} invokes @code{AC_FUNC_FSEEKO}
 and also contains workarounds for other portability problems of
 @code{fseeko}.  @xref{Gnulib}.
 @end defmac
@@ -5139,7 +5139,7 @@ define @code{HAVE_GETGROUPS}.  Set @code{GETGROUPS_LIBS} to any libraries
 needed to get that function.  This macro runs @code{AC_TYPE_GETGROUPS}.
 
 This macro is obsolescent. New programs need not use this macro.  But
-they may want to use the Gnulib module @code{getgroups}, that provides
+they may want to use the Gnulib module @code{getgroups}, which provides
 workarounds to other portability problems of this function.
 @end defmac
 
@@ -5337,8 +5337,8 @@ type @code{mbstate_t} are properly declared.
 The result of this macro is cached in the @code{ac_cv_func_mbrtowc}
 variable.
 
-Gnulib contains a module @code{mbrtowc} that not only ensures that the
-function is declared, but also works around a number of other portability
+The Gnulib module @code{mbrtowc} not only ensures that the
+function is declared, but also works around other portability
 problems of this function.
 @end defmac
 
@@ -5540,9 +5540,9 @@ the buffer argument.
 The result of this macro is cached in the
 @code{ac_cv_func_strerror_r_char_p} variable.
 
-Gnulib contains a module @code{strerror_r} that not only ensures that the
-function has the return type specified by Posix, but also works around a
-dozen of other portability problems of this function.
+The Gnulib module @code{strerror_r} not only ensures that the function
+has the return type specified by Posix, but also works around other
+portability problems of this function.
 @end defmac
 
 @anchor{AC_FUNC_STRFTIME}
@@ -5587,8 +5587,8 @@ If the @code{strtold} function exists and conforms to C99 or later, define
 
 This macro caches its result in the @code{ac_cv_func_strtold} variable.
 
-Gnulib contains a module @code{strtold} that not only ensures that the
-function exists, but also works around a dozen of other portability
+The Gnulib module @code{strtold} not only ensures that the
+function exists, but also works around other portability
 problems of this function.
 @end defmac
 
@@ -5846,9 +5846,9 @@ This section documents some collected knowledge about common headers,
 and the problems they cause.  By definition, this list always requires
 additions.  A much more complete list is maintained by the Gnulib
 project (@pxref{Gnulib}), covering @ref{Header File Substitutes, ,
-Posix Headers, gnulib, GNU gnulib} and @ref{Glibc Header File
-Substitutes, , Glibc Headers, gnulib, GNU gnulib}.  Please help us keep
-the gnulib list as complete as possible.
+Posix Headers, gnulib, Gnulib} and @ref{Glibc Header File
+Substitutes, , Glibc Headers, gnulib, Gnulib}.  Please help us keep
+the Gnulib list as complete as possible.
 
 When we say that a header ``may require'' some set of other headers, we
 mean that it may be necessary for you to manually include those other
@@ -13597,7 +13597,7 @@ instance you might have to refer to @samp{$m4_flags}.
 Any token matching @var{pattern} is allowed, including if it matches an
 @code{m4_pattern_forbid} pattern.
 
-For example, gnulib uses @code{m4_pattern_forbid([^gl_])} to reserve the
+For example, Gnulib uses @code{m4_pattern_forbid([^gl_])} to reserve the
 @code{gl_} namespace for itself, but also uses
 @code{m4_pattern_allow([^gl_ES$])} to avoid a false negative on the
 valid locale name.
@@ -26199,7 +26199,7 @@ myprog-paths.h: Makefile
 @end example
 
 @noindent
-The gnulib module @samp{configmake} provides such a header with all the
+The Gnulib module @samp{configmake} provides such a header with all the
 standard directory variables defined, @pxref{configmake,,, gnulib, GNU
 Gnulib}.
 
-- 
2.17.1