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_("..").
#
# 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
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
#
# 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
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
#
# 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
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
@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).
@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}).
#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
# 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. */
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;
/* =========================== 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:
- 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. */
/* --------------------------- 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:
#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
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;
#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;
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
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
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
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