]> git.ipfire.org Git - thirdparty/gnulib.git/commitdiff
Fix some ungrammatical uses of "allows to"
authorPaul Eggert <eggert@cs.ucla.edu>
Thu, 8 May 2025 07:48:56 +0000 (00:48 -0700)
committerPaul Eggert <eggert@cs.ucla.edu>
Thu, 8 May 2025 07:50:57 +0000 (00:50 -0700)
This buys back some comment changes from Emacs,
and fixes other instances I noticed.

16 files changed:
ChangeLog
build-aux/announce-gen
build-aux/prefix-gnulib-mk
build-aux/useless-if-before-free
doc/posix-functions/utimes.texi
doc/warnings.texi
lib/c-strcaseeq.h
lib/cdefs.h
lib/glthread/thread.c
lib/stackvma.c
lib/streq.h
lib/thrd.c
lib/windows-thread.c
m4/gnulib-common.m4
m4/libgcrypt.m4
tests/test-update-copyright.sh

index 211e45f8a0680b121680da8e50f6ed2cf6b8f91b..50a38d675fbeba5a0b49ff91662b7055347dd8b7 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
        localcharset, localename: MS-Windows support for non-default locales
        * lib/localcharset.c (locale_charset) [WINDOWS_NATIVE]: Before
        falling back on the default system codepage, try extracting
-       the codepage from what 'setlocale' returns.  This allows to
+       the codepage from what 'setlocale' returns.  This can
        take into account changes of the codeset due to non-default
        locale set by a previous call to 'setlocale'.
        * lib/localename.c (LOCALE_NAME_MAX_LENGTH) [WINDOWS_NATIVE]:
        (enum_locales_fn, get_lcid) [WINDOWS_NATIVE]: New functions.
        (gl_locale_name_thread) [WINDOWS_NATIVE]: Produce the
        current locale by calling 'setlocale', then converting the
-       locale name into LCID by calling 'get_lcid'.  This allows to
+       locale name into LCID by calling 'get_lcid'.  This can
        take into account changes in the current locale from the
        default one, in contrast to GetThreadLocale.
 
 
        * lib/argp-help.c (argp_doc): Split the untranslated doc string on
        '\v', and translate the two parts separately, instead of feeding
-       the whole string to gettext.  This allows to exclude
+       the whole string to gettext.  One can exclude
        '\v' from the strings visible to the translator by writing doc
        strings as N_("..") "\v" N_("..").
 
index 8e75608cbdc94913917e484ec2423e35a238c727..3970d3ce48ea0c725602868c632672a22f8dfef5 100755 (executable)
@@ -20,7 +20,7 @@
 #
 # Written by Jim Meyering
 
-# This is a prologue that allows to run a perl script as an executable
+# This prologue allows running a perl script as an executable
 # on systems that are compliant to a POSIX version before POSIX:2017.
 # On such systems, the usual invocation of an executable through execlp()
 # or execvp() fails with ENOEXEC if it is a script that does not start
@@ -35,7 +35,7 @@
 eval 'exec perl -wSx "$0" "$@"'
      if 0;
 
-my $VERSION = '2025-01-31 23:21'; # UTC
+my $VERSION = '2025-05-08 07:37'; # UTC
 # The definition above must lie within the first 8 lines in order
 # for the Emacs time-stamp write hook (at end) to update it.
 # If you change this file with Emacs, please let the write hook
index b2874768349da01587d20a7c61193cf1db9c0718..b2b4867d07ea169a08aeab86ad25addd758d8eda 100755 (executable)
@@ -10,7 +10,7 @@
 #
 # Written by Jim Meyering
 
-# This is a prologue that allows to run a perl script as an executable
+# This prologue allows running a perl script as an executable
 # on systems that are compliant to a POSIX version before POSIX:2017.
 # On such systems, the usual invocation of an executable through execlp()
 # or execvp() fails with ENOEXEC if it is a script that does not start
@@ -25,7 +25,7 @@
 eval 'exec perl -wSx "$0" "$@"'
      if 0;
 
-my $VERSION = '2024-07-04 10:56'; # UTC
+my $VERSION = '2025-05-08 07:38'; # UTC
 # The definition above must lie within the first 8 lines in order
 # for the Emacs time-stamp write hook (at end) to update it.
 # If you change this file with Emacs, please let the write hook
index 99d474ecdfe7d6127e1209dedc111e9ea01631a3..e78fa8659f50af2c97e652a628ed47ec58d9d646 100755 (executable)
@@ -21,7 +21,7 @@
 #
 # Written by Jim Meyering
 
-# This is a prologue that allows to run a perl script as an executable
+# This prologue allows running a perl script as an executable
 # on systems that are compliant to a POSIX version before POSIX:2017.
 # On such systems, the usual invocation of an executable through execlp()
 # or execvp() fails with ENOEXEC if it is a script that does not start
@@ -36,7 +36,7 @@
 eval 'exec perl -wSx "$0" "$@"'
      if 0;
 
-my $VERSION = '2024-07-17 02:10'; # UTC
+my $VERSION = '2025-05-08 07:38'; # UTC
 # The definition above must lie within the first 8 lines in order
 # for the Emacs time-stamp write hook (at end) to update it.
 # If you change this file with Emacs, please let the write hook
index 77142dee5066c18ddd8b218f36ed2c04a6f18d23..3a7b3cbe97317b6ec131565e7dcb91369a72d368 100644 (file)
@@ -53,5 +53,5 @@ On OS/2, this function does not work on an opened file.
 
 @mindex utimens
 Extension: Gnulib provides a module @samp{utimens} that works around these
-problems and allows to set the time with nanosecond resolution (as far as
+problems and can set the time with nanosecond resolution (as far as
 supported by the file system).
index 8b1447cafe3868399478684e871154b0de6c8100..84b7acd105687a3361b34f6f99db384fcea6fe57 100644 (file)
@@ -3,7 +3,7 @@
 
 @mindex warnings
 @mindex manywarnings
-The @code{warnings} module allows to regularly build a package with more
+The @code{warnings} module allows regularly building a package with more
 GCC warnings than the default warnings emitted by GCC.  It is often used
 indirectly through the @code{manywarnings} module
 (@pxref{manywarnings}).
index 0eb19bcfac5061e384f38c8b6e92845e30b64af4..4a3681007eb8a1563caa779af2eecfdc27c8ba0f 100644 (file)
@@ -24,7 +24,7 @@ extern "C" {
 #endif
 
 
-/* STRCASEEQ allows to optimize string comparison with a small literal string.
+/* STRCASEEQ optimizes string comparison with a small literal string.
      STRCASEEQ (s, "UTF-8", 'U','T','F','-','8',0,0,0,0)
    is semantically equivalent to
      c_strcasecmp (s, "UTF-8") == 0
index 65da09dc09679a7a56d0c75ded9bad20137f0f31..2682c092f0e40b8c6ccc4db8133a953531997524 100644 (file)
 # endif
 #endif
 
-/* ISO C99 also allows to declare arrays as non-overlapping.  The syntax is
+/* ISO C99 also allows declaring arrays as non-overlapping.  The syntax is
      array_name[restrict]
    GCC 3.1 and clang support this.
    This syntax is not usable in C++ mode.  */
index 82fbd263d4b7cec99e2e0a60df0bfadeac2051ff..2d015b6b0b70035599270b0591f6053602492e30 100644 (file)
@@ -34,7 +34,7 @@ struct thrd_with_exitvalue
   void * volatile exitvalue;
 };
 
-/* The Thread-Specific Storage (TSS) key that allows to access each thread's
+/* The Thread-Specific Storage (TSS) key that allows accessing each thread's
    'struct thrd_with_exitvalue *' pointer.  */
 static tss_t thrd_with_exitvalue_key;
 
index d08347feced2930c2d325965dc7dcd4973211ec8..68ce5cae607a4e83a0ddff86cdce6826e4358120 100644 (file)
@@ -579,8 +579,8 @@ vma_iterate (struct callback_locals *locals)
 
 /* =========================== stackvma-mincore.c =========================== */
 
-/* mincore() is a system call that allows to inquire the status of a
-   range of pages of virtual memory.  In particular, it allows to inquire
+/* mincore() is a system call that supports inquiring the status of a
+   range of pages of virtual memory.  In particular, it supports inquiring
    whether a page is mapped at all (except on Mac OS X, where mincore
    returns 0 even for unmapped addresses).
    As of 2006, mincore() is supported by:        possible bits:
@@ -593,7 +593,7 @@ vma_iterate (struct callback_locals *locals)
      - AIX,     since AIX 5.3,                   1
    As of 2019, also on
      - Hurd.
-   However, while the API allows to easily determine the bounds of mapped
+   However, while the API allows easily determining the bounds of mapped
    virtual memory, it does not make it easy to find the bounds of _unmapped_
    virtual memory ranges.  We try to work around this, but it may still be
    slow.  */
@@ -1150,8 +1150,8 @@ sigsegv_get_vma (uintptr_t address, struct vma_struct *vma)
 
 /* --------------------------- stackvma-mquery.c --------------------------- */
 
-/* mquery() is a system call that allows to inquire the status of a
-   range of pages of virtual memory.  In particular, it allows to inquire
+/* mquery() is a system call that supports inquiring the status of a
+   range of pages of virtual memory.  In particular, it supports inquiring
    whether a page is mapped at all, and where is the next unmapped page
    after a given address.
    As of 2021, mquery() is supported by:
index 9d91a6a610d15c326cca6580a190c21a3aba7e09..1f1ff38f6bdf7a8f1ed13b31dcb3d4c07f5428f6 100644 (file)
@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 
-/* STREQ_OPT allows to optimize string comparison with a small literal string.
+/* STREQ_OPT optimizes string comparison with a small literal string.
      STREQ_OPT (s, "EUC-KR", 'E', 'U', 'C', '-', 'K', 'R', 0, 0, 0)
    is semantically equivalent to
      strcmp (s, "EUC-KR") == 0
index 4a31cd868f76381d535f837045d7a2026db212f9..ea7f0f53979675127ec320a1ff41aa73c2ca43c0 100644 (file)
@@ -36,7 +36,7 @@
    AIX 7.3.1 has a corrected thrd_start_t.  But the thrd_join function still
    never stores an exit code.  */
 
-/* The Thread-Specific Storage (TSS) key that allows to access each thread's
+/* The Thread-Specific Storage (TSS) key that allows accessing each thread's
    'struct thrd_with_exitcode *' pointer.  */
 static tss_t thrd_with_exitcode_key;
 
index 2cef22f9b7d3755873754be3882b3c57ee90c3bc..9f6fd8b606aaba66cc6a1c51ccad54a22a304f2d 100644 (file)
@@ -29,7 +29,7 @@
 #include "windows-once.h"
 #include "windows-tls.h"
 
-/* The Thread-Local Storage (TLS) key that allows to access each thread's
+/* The Thread-Local Storage (TLS) key that allows accessing each thread's
    'struct glwthread_thread_struct *' pointer.  */
 static DWORD self_key = (DWORD)-1;
 
index d5bf2fb358e7a210635c060e008c15e40d27248b..a07c7dd5a8928182a4cba35c866c3b98c01569bc 100644 (file)
@@ -1630,7 +1630,7 @@ dnl
 dnl This macro sets two variables:
 dnl   - gl_cv_onwards_func_<func>   to yes / no / "future OS version"
 dnl   - ac_cv_func_<func>           to yes / no / no
-dnl The first variable allows to distinguish all three cases.
+dnl The first variable allows distinguishing all three cases.
 dnl The second variable is set, so that an invocation
 dnl   gl_CHECK_FUNCS_ANDROID([func], [[#include <foo.h>]])
 dnl can be used as a drop-in replacement for
@@ -1683,7 +1683,7 @@ dnl
 dnl This macro sets two variables:
 dnl   - gl_cv_onwards_func_<func>   to yes / no / "future OS version"
 dnl   - ac_cv_func_<func>           to yes / no / no
-dnl The first variable allows to distinguish all three cases.
+dnl The first variable allows distinguishing all three cases.
 dnl The second variable is set, so that an invocation
 dnl   gl_CHECK_FUNCS_MACOS([func], [[#include <foo.h>]])
 dnl can be used as a drop-in replacement for
index 353df81b6d739da5b2a8caeaa95b139e3dd32ebc..a891257be9ed39eb244485d31e6d5d8da0985d80 100644 (file)
@@ -105,7 +105,7 @@ dnl MINIMUM-VERSION is a string with the version number optionally prefixed
 dnl with the API version to also check the API compatibility. Example:
 dnl a MINIMUM-VERSION of 1:1.2.5 won't pass the test unless the installed
 dnl version of libgcrypt is at least 1.2.5 *and* the API number is 1.  Using
-dnl this features allows to prevent build against newer versions of libgcrypt
+dnl this feature can prevent builds against newer versions of libgcrypt
 dnl with a changed API.
 dnl
 dnl If a prefix option is not used, the config script is first
index fc405a6214cf2bca137a0eecaf80ff42a077c749..e98c541afe8785bd1d75dfa07dae1558337ec972 100755 (executable)
@@ -34,7 +34,7 @@ s=$TMP-script
 cat <<\EOF > $s
 #!/bin/sh
 #! -*-perl-*-
-# This is a prologue that allows to run a perl script as an executable
+# This prologue allows running a perl script as an executable
 # on systems that are compliant to a POSIX version before POSIX:2017.
 # On such systems, the usual invocation of an executable through execlp()
 # or execvp() fails with ENOEXEC if it is a script that does not start