* Remove license modules
@ 2020-05-12 17:51 Asher Gordon
2020-05-15 23:17 ` Bruno Haible
0 siblings, 1 reply; 9+ messages in thread
From: Asher Gordon @ 2020-05-12 17:51 UTC (permalink / raw)
To: bug-gnulib
[-- Attachment #1.1: Type: text/plain, Size: 1137 bytes --]
Hello all,
Since Savannah requires licenses to be under version control (see
here¹), I don't think it makes sense for Gnulib to provide modules for
them. My reasoning is that if developers are going to use a Gnulib
module, they won't keep the files it provides under version control (in
fact, gnulib-tool itself adds these files to .gitignore). There's no
reason to remove the license *files*, since it could be useful for
developers to copy them directly.
Please see the attached patch, which removes the license modules (but
keeps the license files themselves).
Thanks,
Asher
Footnotes:
¹ https://savannah.nongnu.org/task/?func=detailitem&item_id=15583
--
...very few phenomena can pull someone out of Deep Hack Mode, with two
noted exceptions: being struck by lightning, or worse, your *computer*
being struck by lightning.
-- Matt Welsh
--------
I prefer to send and receive mail encrypted. Please send me your
public key, and if you do not have my public key, please let me
know. Thanks.
GPG fingerprint: 38F3 975C D173 4037 B397 8095 D4C9 C4FC 5460 8E68
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.2: Remove license modules --]
[-- Type: text/x-diff, Size: 4026 bytes --]
From 9bfacca0d43c97d3596650531de7f2eeb6124b92 Mon Sep 17 00:00:00 2001
From: Asher Gordon <AsDaGo@posteo.net>
Date: Tue, 12 May 2020 13:34:34 -0400
Subject: [PATCH] doc: Remove Texinfo-format license modules.
It doesn't make sense to provide these modules, since licenses are
required to be under version control anyway.
* modules/agpl-3.0: Remove.
* modules/fdl: Remove.
* modules/fdl-1.3: Remove.
* modules/gpl-2.0: Remove.
* modules/gpl-3.0: Remove.
* modules/lgpl-2.1: Remove.
* modules/lgpl-3.0: Remove.
---
modules/agpl-3.0 | 19 -------------------
modules/fdl | 19 -------------------
modules/fdl-1.3 | 19 -------------------
modules/gpl-2.0 | 19 -------------------
modules/gpl-3.0 | 19 -------------------
modules/lgpl-2.1 | 19 -------------------
modules/lgpl-3.0 | 19 -------------------
7 files changed, 133 deletions(-)
delete mode 100644 modules/agpl-3.0
delete mode 100644 modules/fdl
delete mode 100644 modules/fdl-1.3
delete mode 100644 modules/gpl-2.0
delete mode 100644 modules/gpl-3.0
delete mode 100644 modules/lgpl-2.1
delete mode 100644 modules/lgpl-3.0
diff --git a/modules/agpl-3.0 b/modules/agpl-3.0
deleted file mode 100644
index 98c3cedf4..000000000
--- a/modules/agpl-3.0
+++ /dev/null
@@ -1,19 +0,0 @@
-Description:
-Provide the GNU Affero General Public License version 3.0 in Texinfo format.
-
-Files:
-doc/agpl-3.0.texi
-
-Depends-on:
-
-configure.ac:
-
-Makefile.am:
-
-Include:
-
-License:
-unmodifiable license text
-
-Maintainer:
-all
diff --git a/modules/fdl b/modules/fdl
deleted file mode 100644
index 6d6f85996..000000000
--- a/modules/fdl
+++ /dev/null
@@ -1,19 +0,0 @@
-Description:
-Provide the GNU Free Documentation License in Texinfo format.
-
-Files:
-doc/fdl.texi
-
-Depends-on:
-
-configure.ac:
-
-Makefile.am:
-
-Include:
-
-License:
-unmodifiable license text
-
-Maintainer:
-all
diff --git a/modules/fdl-1.3 b/modules/fdl-1.3
deleted file mode 100644
index c4d1dd6a7..000000000
--- a/modules/fdl-1.3
+++ /dev/null
@@ -1,19 +0,0 @@
-Description:
-Provide the GNU Free Documentation License version 1.3 in Texinfo format.
-
-Files:
-doc/fdl-1.3.texi
-
-Depends-on:
-
-configure.ac:
-
-Makefile.am:
-
-Include:
-
-License:
-unmodifiable license text
-
-Maintainer:
-all
diff --git a/modules/gpl-2.0 b/modules/gpl-2.0
deleted file mode 100644
index 8633a5c48..000000000
--- a/modules/gpl-2.0
+++ /dev/null
@@ -1,19 +0,0 @@
-Description:
-Provide the GNU General Public License version 2.0 in Texinfo format.
-
-Files:
-doc/gpl-2.0.texi
-
-Depends-on:
-
-configure.ac:
-
-Makefile.am:
-
-Include:
-
-License:
-unmodifiable license text
-
-Maintainer:
-all
diff --git a/modules/gpl-3.0 b/modules/gpl-3.0
deleted file mode 100644
index 95deef885..000000000
--- a/modules/gpl-3.0
+++ /dev/null
@@ -1,19 +0,0 @@
-Description:
-Provide the GNU General Public License version 3.0 in Texinfo format.
-
-Files:
-doc/gpl-3.0.texi
-
-Depends-on:
-
-configure.ac:
-
-Makefile.am:
-
-Include:
-
-License:
-unmodifiable license text
-
-Maintainer:
-all
diff --git a/modules/lgpl-2.1 b/modules/lgpl-2.1
deleted file mode 100644
index 5e0892058..000000000
--- a/modules/lgpl-2.1
+++ /dev/null
@@ -1,19 +0,0 @@
-Description:
-Provide the GNU Lesser General Public License version 2.1 in Texinfo format.
-
-Files:
-doc/lgpl-2.1.texi
-
-Depends-on:
-
-configure.ac:
-
-Makefile.am:
-
-Include:
-
-License:
-unmodifiable license text
-
-Maintainer:
-all
diff --git a/modules/lgpl-3.0 b/modules/lgpl-3.0
deleted file mode 100644
index 6638e7ccd..000000000
--- a/modules/lgpl-3.0
+++ /dev/null
@@ -1,19 +0,0 @@
-Description:
-Provide the GNU Lesser General Public License version 3.0 in Texinfo format.
-
-Files:
-doc/lgpl-3.0.texi
-
-Depends-on:
-
-configure.ac:
-
-Makefile.am:
-
-Include:
-
-License:
-unmodifiable license text
-
-Maintainer:
-all
--
2.26.2
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]
^ permalink raw reply related [flat|nested] 9+ messages in thread
* Re: Remove license modules
2020-05-12 17:51 Remove license modules Asher Gordon
@ 2020-05-15 23:17 ` Bruno Haible
2020-05-16 18:03 ` Asher Gordon
0 siblings, 1 reply; 9+ messages in thread
From: Bruno Haible @ 2020-05-15 23:17 UTC (permalink / raw)
To: bug-gnulib; +Cc: Asher Gordon
Hi,
Asher Gordon wrote:
> Since Savannah requires licenses to be under version control (see
> here¹), I don't think it makes sense for Gnulib to provide modules for
> them. My reasoning is that if developers are going to use a Gnulib
> module, they won't keep the files it provides under version control (in
> fact, gnulib-tool itself adds these files to .gitignore). There's no
> reason to remove the license *files*, since it could be useful for
> developers to copy them directly.
> ...
> Footnotes:
> ¹ https://savannah.nongnu.org/task/?func=detailitem&item_id=15583
At the moment you sent the mail, the discussion in that ticket was still
ongoing.
Now it has completed, and it turned out you were confusing the license
texts in text format (which ought to be added to VCS directly) and the
license texts in Texinfo format (for which gnulib modules are appropriate).
Bruno
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Remove license modules
2020-05-15 23:17 ` Bruno Haible
@ 2020-05-16 18:03 ` Asher Gordon
2020-05-17 17:39 ` Bruno Haible
0 siblings, 1 reply; 9+ messages in thread
From: Asher Gordon @ 2020-05-16 18:03 UTC (permalink / raw)
To: Bruno Haible; +Cc: bug-gnulib
[-- Attachment #1.1: Type: text/plain, Size: 1186 bytes --]
Hi Bruno,
Bruno Haible <bruno@clisp.org> writes:
> Now it has completed, and it turned out you were confusing the license
> texts in text format (which ought to be added to VCS directly) and the
> license texts in Texinfo format (for which gnulib modules are
> appropriate).
Well I didn't include the GFDL in plain text format in my package. I
only included it in Texinfo format, but Ineiev accepted my package
nevertheless. I think the Texinfo format licenses are human readable
enough that it is sufficient to just include those. In fact, it seems
this is what Gnulib itself does.
But as Ineiev points out, the modules are valid for two of the three
methods described in (gnulib) VCS Issues. So I think instead that the
documentation should be updated. See the patch to update the
documentation below. I added an anchor, VCS Omissions, under the VCS
Issues node in gnulib-tool.texi. I think that since the relevant
material is slightly far down on the page, if I link directly to VCS
Issues, it could cause confusion. However, feel free to remove the
anchor if you see fit. I also fixed a minor issue where "VCS" ended with
"." rather than "@." (see (texinfo) Ending a Sentence).
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.2: doc: Update to indicate that license files must always be included. --]
[-- Type: text/x-diff, Size: 3153 bytes --]
From 022bd24bebde0e033a37b6c43770382fed996a39 Mon Sep 17 00:00:00 2001
From: Asher Gordon <AsDaGo@posteo.net>
Date: Sat, 16 May 2020 13:49:02 -0400
Subject: [PATCH] doc: Update to indicate that license files must always be
included.
* doc/gnulib-tool.texi (VCS Omissions): New anchor under the VCS
Issues node. Describe the license issues here.
* doc/license-texi.texi: Mention the license issues and link to
VCS Omissions.
---
ChangeLog | 8 ++++++++
doc/gnulib-tool.texi | 15 +++++++++++----
doc/licenses-texi.texi | 4 ++++
3 files changed, 23 insertions(+), 4 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 889c756eb..75a4c37a5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2020-05-16 Asher Gordon <AsDaGo@posteo.net>
+
+ doc: Update to indicate that license files must always be included.
+ * doc/gnulib-tool.texi (VCS Omissions): New anchor under the VCS
+ Issues node. Describe the license issues here.
+ * doc/license-texi.texi: Mention the license issues and link to
+ VCS Omissions.
+
2020-05-16 Bruno Haible <bruno@clisp.org>
findprog-lgpl: Fix link error (existing since 2008-09-02).
diff --git a/doc/gnulib-tool.texi b/doc/gnulib-tool.texi
index 44a393a69..ca9837240 100644
--- a/doc/gnulib-tool.texi
+++ b/doc/gnulib-tool.texi
@@ -914,12 +914,19 @@ Gnulib also contains files generated by @command{make} (and removed by
into the VCS, but instead added to @file{.gitignore} or equivalent.
@item
+@anchor{VCS Omissions}
In projects which customarily omit from their VCS all files that are
generated from other source files, none of these files and directories
-are added into the VCS. As described in @ref{Modified imports}, there
-are two ways to keep track of options and module names that are passed
-to @code{gnulib-tool}. The command for restoring the omitted files
-depends on it:
+are added into the VCS@. However, please note: licenses must always be
+included in the VCS, whether in plain text format or Texinfo format.
+Projects which omit all generated files from their VCS may prefer to
+copy the license files directly rather than using the Gnulib modules.
+Alternatively, they can include the licenses in plain text format and
+use the Gnulib modules for the licenses in Texinfo format.
+@xref{License Texinfo sources}. As described in @ref{Modified imports},
+there are two ways to keep track of options and module names that are
+passed to @code{gnulib-tool}. The command for restoring the omitted
+files depends on it:
@itemize @bullet
@item
diff --git a/doc/licenses-texi.texi b/doc/licenses-texi.texi
index 60110ef09..2bcb2bed5 100644
--- a/doc/licenses-texi.texi
+++ b/doc/licenses-texi.texi
@@ -12,3 +12,7 @@ The conventional name for the GPL node is @samp{Copying} and for the FDL
a conventional node name.
Of course the license texts themselves should not be changed at all.
+
+Please note that if you use these modules, you must still include a copy
+of the license in plain text format or Texinfo format in the VCS@.
+@xref{VCS Omissions} for more information.
--
2.26.2
[-- Attachment #1.3: Type: text/plain, Size: 157 bytes --]
Thanks,
Asher
--
One meets his destiny often on the road he takes to avoid it.
GPG fingerprint: 38F3 975C D173 4037 B397 8095 D4C9 C4FC 5460 8E68
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]
^ permalink raw reply related [flat|nested] 9+ messages in thread
* Re: Remove license modules
2020-05-16 18:03 ` Asher Gordon
@ 2020-05-17 17:39 ` Bruno Haible
2020-05-17 19:58 ` Asher Gordon
0 siblings, 1 reply; 9+ messages in thread
From: Bruno Haible @ 2020-05-17 17:39 UTC (permalink / raw)
To: Asher Gordon; +Cc: bug-gnulib
Hi Asher,
> I think the Texinfo format licenses are human readable
> enough that it is sufficient to just include those.
This is a hairy question. I don't know whether a judge will be convinced
by the presence of a Texinfo formatted license, when no plain-text
and no PDF version of the license is present - because most judges
don't know how to read a Texinfo file (if they know the concept of a
markup language at all). But anyway, I'll leave that question to others...
I'm going to document existing practice only. I've looked how GNU emacs
and GNU gettext do it; the approaches coincide.
Also, a plain-text license file is often present in the top-level directory
of the VCS because the hoster (Savannah, Gitlab, Github, etc.) requires or
suggests it.
> Well I didn't include the GFDL in plain text format in my package. I
> only included it in Texinfo format, but Ineiev accepted my package
> nevertheless.
Oh, indeed the GFDL is being handled differently than the GPL and LGPL.
Patch below.
> I also fixed a minor issue where "VCS" ended with
> "." rather than "@." (see (texinfo) Ending a Sentence).
I won't spend time on a single instance of this very minor issue. But if
you want to submit a patch that fixes all instances of this issue, I'll
appreciate it.
2020-05-17 Bruno Haible <bruno@clisp.org>
Clarify intended usage of the license file modules.
Reported by Asher Gordon <AsDaGo@posteo.net> in
<https://lists.gnu.org/archive/html/bug-gnulib/2020-05/msg00126.html>.
* doc/licenses-texi.texi (License Texinfo sources): Mention the
GNU AGPL. Explain the intended usage of the modules.
* modules/fdl (Notice): Discourage use as a module.
* modules/fdl-1.3 (Notice): Likewise.
diff --git a/doc/licenses-texi.texi b/doc/licenses-texi.texi
index 60110ef..d226bc8 100644
--- a/doc/licenses-texi.texi
+++ b/doc/licenses-texi.texi
@@ -1,8 +1,8 @@
@node License Texinfo sources
@section License Texinfo sources
-Gnulib provides copies of the GNU GPL, GNU LGPL, and GNU FDL licenses
-in Texinfo form. (The master location is
+Gnulib provides copies of the GNU GPL, GNU LGPL, GNU Affero GPL, and
+GNU FDL licenses in Texinfo form. (The master location is
@url{https://www.gnu.org/licenses/}). These Texinfo documents do not
have any node names and structures built into them; for your manual,
you should @code{@@include} them in an appropriate @code{@@node}.
@@ -12,3 +12,33 @@ The conventional name for the GPL node is @samp{Copying} and for the FDL
a conventional node name.
Of course the license texts themselves should not be changed at all.
+
+The recommended way to make use of these license files, consistently
+with current practice, is as follows:
+@itemize
+@item
+The code license (GNU GPL, GNU LGPL, or GNU Affero GPL) is usually
+present as a file in the top-level directory. This is true not only for
+the release tarballs, but also in the VCS repository. The file is
+typically named @samp{COPYING} for the GNU GPL, or @samp{COPYING.LIB} or
+@samp{COPYING.LESSER} for the GNU LGPL. The presence of this file
+fulfills a legal obligation; see
+@url{https://www.gnu.org/licenses/gpl-faq.html#WhyMustIInclude}.
+
+To make use of the code license in your documentation, you may request
+one of the modules @code{gpl-3.0}, @code{gpl-2.0}, @code{lgpl-3.0},
+@code{lgpl-2.1}, @code{agpl-3.0}, through a @code{gnulib-tool} invocation.
+Or you may copy the relevant Texinfo file directly into your VCS repository.
+Both approaches are equally good. The Texinfo file changes very rarely.
+@item
+The documentation license file (GNU FDL) is usually not present as a
+file in the top-level directory, because that would be ambiguous: When
+you use the GNU FDL, you need to specify the Invariant Sections, the
+Front-Cover Texts, and the Back-Cover Texts.
+
+To make use of this documentation license, copy the relevant Texinfo
+file into your VCS repository. This makes sure that anyone who receives
+a copy of your VCS repository has also received a copy of the
+documentation license. In the documentation, also state what are the
+Invariant Sections, the Front-Cover Texts, and the Back-Cover Texts.
+@end itemize
diff --git a/modules/fdl b/modules/fdl
index 6d6f859..251939a 100644
--- a/modules/fdl
+++ b/modules/fdl
@@ -1,6 +1,9 @@
Description:
Provide the GNU Free Documentation License in Texinfo format.
+Notice:
+Don't use this module! Instead, copy the referenced license file into your version control repository.
+
Files:
doc/fdl.texi
diff --git a/modules/fdl-1.3 b/modules/fdl-1.3
index c4d1dd6..760a707 100644
--- a/modules/fdl-1.3
+++ b/modules/fdl-1.3
@@ -1,6 +1,9 @@
Description:
Provide the GNU Free Documentation License version 1.3 in Texinfo format.
+Notice:
+Don't use this module! Instead, copy the referenced license file into your version control repository.
+
Files:
doc/fdl-1.3.texi
^ permalink raw reply related [flat|nested] 9+ messages in thread
* Re: Remove license modules
2020-05-17 17:39 ` Bruno Haible
@ 2020-05-17 19:58 ` Asher Gordon
2020-05-17 20:12 ` Asher Gordon
2020-06-01 18:00 ` Bruno Haible
0 siblings, 2 replies; 9+ messages in thread
From: Asher Gordon @ 2020-05-17 19:58 UTC (permalink / raw)
To: Bruno Haible; +Cc: bug-gnulib
[-- Attachment #1.1: Type: text/plain, Size: 2102 bytes --]
Hi Bruno,
Bruno Haible <bruno@clisp.org> writes:
>> I also fixed a minor issue where "VCS" ended with
>> "." rather than "@." (see (texinfo) Ending a Sentence).
>
> I won't spend time on a single instance of this very minor issue. But if
> you want to submit a patch that fixes all instances of this issue, I'll
> appreciate it.
See the attached 0001-doc-Change-.-to-.-where-appropriate.patch. It
turns out that there were quite a few instances that should be changed,
but nothing that 'dired-do-find-regexp-and-replace' couldn't
handle. Since there were so many changed files, I wasn't sure if I
should list them all. What I did was list them in the ChangeLog, but not
in the commit message. Feel free to change that if you like.
Also, there were some '.'s that should be changed to '@.' in the license
Texinfo files. I'm not sure what the procedure would be for changing
those, and we might even have to wait for the next release of those
licenses. So I haven't included those changes in the main patch, but
I've attached another patch, licenses.patch, to fix the licenses.
Perhaps Texinfo should change its heuristics so that a '.' preceding a
capital letter always starts a sentence, even when it is preceded by a
capital letter. I think that would do the right thing more often than
the current heuristics. I'll propose that to the Texinfo maintainers and
see what they say. You might want to hold off on the patch I attached
until I hear back from the Texinfo maintainers.
> +Notice:
> +Don't use this module! Instead, copy the referenced license file into your version control repository.
> +
As Ineiev said, it is valid to use these modules as long as the files
are included in version control. So you might want to change the
notice. But then again, even if a project does normally keep all Gnulib
files under version control, the license modules still wouldn't be very
useful since the license text rarely changes.
Thanks,
Asher
--
One picture is worth 128K words.
GPG fingerprint: 38F3 975C D173 4037 B397 8095 D4C9 C4FC 5460 8E68
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.2: Change '.' to '@.' where appropriate. --]
[-- Type: text/x-diff, Size: 65896 bytes --]
From 43eb9428a29c91a19bb46a4ce2c117aae4dddb84 Mon Sep 17 00:00:00 2001
From: Asher Gordon <AsDaGo@posteo.net>
Date: Sun, 17 May 2020 15:34:20 -0400
Subject: [PATCH] doc: Change '.' to '@.' where appropriate.
---
ChangeLog | 79 ++++++++++++++++++++++++++
doc/c-ctype.texi | 2 +-
doc/glibc-functions/fstatfs.texi | 2 +-
doc/glibc-functions/fts_children.texi | 2 +-
doc/glibc-functions/fts_read.texi | 2 +-
doc/glibc-functions/getdirentries.texi | 2 +-
doc/glibc-functions/mkostemp.texi | 2 +-
doc/glibc-functions/mkostemps.texi | 2 +-
doc/glibc-functions/mkstemps.texi | 2 +-
doc/glibc-functions/preadv.texi | 2 +-
doc/glibc-functions/pwritev.texi | 2 +-
doc/glibc-functions/sendfile.texi | 2 +-
doc/glibc-functions/statfs.texi | 2 +-
doc/gnulib-intro.texi | 10 ++--
doc/gnulib-tool.texi | 2 +-
doc/intprops.texi | 4 +-
doc/lib-symbol-visibility.texi | 2 +-
doc/licenses-texi.texi | 2 +-
doc/maintain.texi | 22 +++----
doc/make-stds.texi | 6 +-
doc/pastposix-functions/bcmp.texi | 2 +-
doc/pastposix-functions/bcopy.texi | 2 +-
doc/pastposix-functions/bzero.texi | 2 +-
doc/pastposix-functions/ecvt.texi | 2 +-
doc/pastposix-functions/fcvt.texi | 2 +-
doc/pastposix-functions/ftime.texi | 2 +-
doc/pastposix-functions/gcvt.texi | 2 +-
doc/pastposix-functions/getwd.texi | 2 +-
doc/pastposix-functions/index.texi | 2 +-
doc/pastposix-functions/mktemp.texi | 2 +-
doc/pastposix-functions/rindex.texi | 2 +-
doc/pastposix-functions/wcswcs.texi | 2 +-
doc/posix-functions/aio_cancel.texi | 2 +-
doc/posix-functions/aio_error.texi | 2 +-
doc/posix-functions/aio_fsync.texi | 2 +-
doc/posix-functions/aio_read.texi | 2 +-
doc/posix-functions/aio_return.texi | 2 +-
doc/posix-functions/aio_suspend.texi | 2 +-
doc/posix-functions/aio_write.texi | 2 +-
doc/posix-functions/creat.texi | 2 +-
doc/posix-functions/ctime.texi | 2 +-
doc/posix-functions/daylight.texi | 2 +-
doc/posix-functions/fgetpos.texi | 2 +-
doc/posix-functions/fopen.texi | 2 +-
doc/posix-functions/freopen.texi | 2 +-
doc/posix-functions/fseeko.texi | 2 +-
doc/posix-functions/fsetpos.texi | 2 +-
doc/posix-functions/fstatat.texi | 2 +-
doc/posix-functions/fstatvfs.texi | 2 +-
doc/posix-functions/ftello.texi | 2 +-
doc/posix-functions/ftruncate.texi | 2 +-
doc/posix-functions/getrlimit.texi | 2 +-
doc/posix-functions/lio_listio.texi | 2 +-
doc/posix-functions/localtime.texi | 2 +-
doc/posix-functions/lseek.texi | 2 +-
doc/posix-functions/mkstemp.texi | 2 +-
doc/posix-functions/mktime.texi | 2 +-
doc/posix-functions/open.texi | 2 +-
doc/posix-functions/openat.texi | 2 +-
doc/posix-functions/opendir.texi | 2 +-
doc/posix-functions/pread.texi | 2 +-
doc/posix-functions/pwrite.texi | 2 +-
doc/posix-functions/readdir.texi | 4 +-
doc/posix-functions/readdir_r.texi | 4 +-
doc/posix-functions/scandir.texi | 2 +-
doc/posix-functions/seekdir.texi | 2 +-
doc/posix-functions/setrlimit.texi | 2 +-
doc/posix-functions/statvfs.texi | 2 +-
doc/posix-functions/strftime.texi | 2 +-
doc/posix-functions/telldir.texi | 2 +-
doc/posix-functions/timezone.texi | 2 +-
doc/posix-functions/tmpfile.texi | 2 +-
doc/posix-functions/truncate.texi | 2 +-
doc/posix-functions/tzname.texi | 2 +-
doc/posix-functions/wcsftime.texi | 2 +-
doc/standards.texi | 18 +++---
doc/windows-sockets.texi | 2 +-
77 files changed, 182 insertions(+), 103 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 9551d9934..1104672ea 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,82 @@
+2020-05-17 Asher Gordon <AsDaGo@posteo.net>
+
+ * doc/c-ctype.texi: Change '.' to '@.' where appropriate.
+ * doc/glibc-functions/fstatfs.texi: Likewise.
+ * doc/glibc-functions/fts_children.texi: Likewise.
+ * doc/glibc-functions/fts_read.texi: Likewise.
+ * doc/glibc-functions/getdirentries.texi: Likewise.
+ * doc/glibc-functions/mkostemp.texi: Likewise.
+ * doc/glibc-functions/mkostemps.texi: Likewise.
+ * doc/glibc-functions/mkstemps.texi: Likewise.
+ * doc/glibc-functions/preadv.texi: Likewise.
+ * doc/glibc-functions/pwritev.texi: Likewise.
+ * doc/glibc-functions/sendfile.texi: Likewise.
+ * doc/glibc-functions/statfs.texi: Likewise.
+ * doc/gnulib-intro.texi: Likewise.
+ * doc/gnulib-tool.texi: Likewise.
+ * doc/intprops.texi: Likewise.
+ * doc/lib-symbol-visibility.texi: Likewise.
+ * doc/licenses-texi.texi: Likewise.
+ * doc/maintain.texi: Likewise.
+ * doc/make-stds.texi: Likewise.
+ * doc/pastposix-functions/bcmp.texi: Likewise.
+ * doc/pastposix-functions/bcopy.texi: Likewise.
+ * doc/pastposix-functions/bzero.texi: Likewise.
+ * doc/pastposix-functions/ecvt.texi: Likewise.
+ * doc/pastposix-functions/fcvt.texi: Likewise.
+ * doc/pastposix-functions/ftime.texi: Likewise.
+ * doc/pastposix-functions/gcvt.texi: Likewise.
+ * doc/pastposix-functions/getwd.texi: Likewise.
+ * doc/pastposix-functions/index.texi: Likewise.
+ * doc/pastposix-functions/mktemp.texi: Likewise.
+ * doc/pastposix-functions/rindex.texi: Likewise.
+ * doc/pastposix-functions/wcswcs.texi: Likewise.
+ * doc/posix-functions/aio_cancel.texi: Likewise.
+ * doc/posix-functions/aio_error.texi: Likewise.
+ * doc/posix-functions/aio_fsync.texi: Likewise.
+ * doc/posix-functions/aio_read.texi: Likewise.
+ * doc/posix-functions/aio_return.texi: Likewise.
+ * doc/posix-functions/aio_suspend.texi: Likewise.
+ * doc/posix-functions/aio_write.texi: Likewise.
+ * doc/posix-functions/creat.texi: Likewise.
+ * doc/posix-functions/ctime.texi: Likewise.
+ * doc/posix-functions/daylight.texi: Likewise.
+ * doc/posix-functions/fgetpos.texi: Likewise.
+ * doc/posix-functions/fopen.texi: Likewise.
+ * doc/posix-functions/freopen.texi: Likewise.
+ * doc/posix-functions/fseeko.texi: Likewise.
+ * doc/posix-functions/fsetpos.texi: Likewise.
+ * doc/posix-functions/fstatat.texi: Likewise.
+ * doc/posix-functions/fstatvfs.texi: Likewise.
+ * doc/posix-functions/ftello.texi: Likewise.
+ * doc/posix-functions/ftruncate.texi: Likewise.
+ * doc/posix-functions/getrlimit.texi: Likewise.
+ * doc/posix-functions/lio_listio.texi: Likewise.
+ * doc/posix-functions/localtime.texi: Likewise.
+ * doc/posix-functions/lseek.texi: Likewise.
+ * doc/posix-functions/mkstemp.texi: Likewise.
+ * doc/posix-functions/mktime.texi: Likewise.
+ * doc/posix-functions/open.texi: Likewise.
+ * doc/posix-functions/openat.texi: Likewise.
+ * doc/posix-functions/opendir.texi: Likewise.
+ * doc/posix-functions/pread.texi: Likewise.
+ * doc/posix-functions/pwrite.texi: Likewise.
+ * doc/posix-functions/readdir.texi: Likewise.
+ * doc/posix-functions/readdir_r.texi: Likewise.
+ * doc/posix-functions/scandir.texi: Likewise.
+ * doc/posix-functions/seekdir.texi: Likewise.
+ * doc/posix-functions/setrlimit.texi: Likewise.
+ * doc/posix-functions/statvfs.texi: Likewise.
+ * doc/posix-functions/strftime.texi: Likewise.
+ * doc/posix-functions/telldir.texi: Likewise.
+ * doc/posix-functions/timezone.texi: Likewise.
+ * doc/posix-functions/tmpfile.texi: Likewise.
+ * doc/posix-functions/truncate.texi: Likewise.
+ * doc/posix-functions/tzname.texi: Likewise.
+ * doc/posix-functions/wcsftime.texi: Likewise.
+ * doc/standards.texi: Likewise.
+ * doc/windows-sockets.texi: Likewise.
+
2020-05-17 Bruno Haible <bruno@clisp.org>
Clarify intended usage of the license file modules.
diff --git a/doc/c-ctype.texi b/doc/c-ctype.texi
index 5b7cfb6e4..e5938cf33 100644
--- a/doc/c-ctype.texi
+++ b/doc/c-ctype.texi
@@ -10,7 +10,7 @@
The @code{c-ctype} module contains functions operating on single-byte
characters, like the functions in @code{<ctype.h>}, that operate as if the
-locale encoding was ASCII. (The "C" locale on many systems has the locale
+locale encoding was ASCII@. (The "C" locale on many systems has the locale
encoding "ASCII".)
The functions are:
diff --git a/doc/glibc-functions/fstatfs.texi b/doc/glibc-functions/fstatfs.texi
index 8b5881891..87617294b 100644
--- a/doc/glibc-functions/fstatfs.texi
+++ b/doc/glibc-functions/fstatfs.texi
@@ -18,6 +18,6 @@ AIX 5.1, mingw, MSVC 14.
@item
On platforms where @code{f_blocks} in @samp{struct statfs} is a 32-bit
value, this function may not work correctly on files systems larger than
-4 TiB. The fix is to use the @code{AC_SYS_LARGEFILE} macro. This affects
+4 TiB@. The fix is to use the @code{AC_SYS_LARGEFILE} macro. This affects
Mac OS X.
@end itemize
diff --git a/doc/glibc-functions/fts_children.texi b/doc/glibc-functions/fts_children.texi
index 1cf3204ea..12ec251f3 100644
--- a/doc/glibc-functions/fts_children.texi
+++ b/doc/glibc-functions/fts_children.texi
@@ -18,7 +18,7 @@ AIX 5.1, HP-UX 11, IRIX 6.5, Solaris 11.3, mingw, MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
correctly report the size of files or block devices larger than 2 GB and
-may not work correctly on huge directories larger than 2 GB. Also, on
+may not work correctly on huge directories larger than 2 GB@. Also, on
platforms where @code{ino_t} is a 32-bit type, this function may report
inode numbers incorrectly. The fix is to use the @code{AC_SYS_LARGEFILE}
macro (only on Mac OS X systems).
diff --git a/doc/glibc-functions/fts_read.texi b/doc/glibc-functions/fts_read.texi
index 35ea302bf..a0faa77d7 100644
--- a/doc/glibc-functions/fts_read.texi
+++ b/doc/glibc-functions/fts_read.texi
@@ -18,7 +18,7 @@ AIX 5.1, HP-UX 11, IRIX 6.5, Solaris 11.3, mingw, MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
correctly report the size of files or block devices larger than 2 GB and
-may not work correctly on huge directories larger than 2 GB. Also, on
+may not work correctly on huge directories larger than 2 GB@. Also, on
platforms where @code{ino_t} is a 32-bit type, this function may report
inode numbers incorrectly. The fix is to use the @code{AC_SYS_LARGEFILE}
macro (only on Mac OS X systems).
diff --git a/doc/glibc-functions/getdirentries.texi b/doc/glibc-functions/getdirentries.texi
index 9f8e74dc2..ba7037e94 100644
--- a/doc/glibc-functions/getdirentries.texi
+++ b/doc/glibc-functions/getdirentries.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
Minix 3.1.8, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14, Android 9.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on huge directories larger than 2 GB. The fix is to use
+work correctly on huge directories larger than 2 GB@. The fix is to use
the @code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/glibc-functions/mkostemp.texi b/doc/glibc-functions/mkostemp.texi
index 3aded86d1..da483d105 100644
--- a/doc/glibc-functions/mkostemp.texi
+++ b/doc/glibc-functions/mkostemp.texi
@@ -17,7 +17,7 @@ on some platforms:
Mac OS X 10.13.
@item
On platforms where @code{off_t} is a 32-bit type, @code{mkostemp} may not work
-correctly to create files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly to create files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@end itemize
Portability problems not fixed by Gnulib:
diff --git a/doc/glibc-functions/mkostemps.texi b/doc/glibc-functions/mkostemps.texi
index 9792180e5..3298e2852 100644
--- a/doc/glibc-functions/mkostemps.texi
+++ b/doc/glibc-functions/mkostemps.texi
@@ -17,7 +17,7 @@ on some platforms:
Mac OS X 10.13.
@item
On platforms where @code{off_t} is a 32-bit type, @code{mkostemps} may not work
-correctly to create files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly to create files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@end itemize
Portability problems not fixed by Gnulib:
diff --git a/doc/glibc-functions/mkstemps.texi b/doc/glibc-functions/mkstemps.texi
index 58bf7488b..95076c6cf 100644
--- a/doc/glibc-functions/mkstemps.texi
+++ b/doc/glibc-functions/mkstemps.texi
@@ -18,7 +18,7 @@ on some platforms:
Mac OS X 10.5.
@item
On platforms where @code{off_t} is a 32-bit type, @code{mkstemps} may not work
-correctly to create files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly to create files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@end itemize
Portability problems not fixed by Gnulib:
diff --git a/doc/glibc-functions/preadv.texi b/doc/glibc-functions/preadv.texi
index cd5947457..f06edec00 100644
--- a/doc/glibc-functions/preadv.texi
+++ b/doc/glibc-functions/preadv.texi
@@ -28,6 +28,6 @@ This function is missing on some platforms:
glibc 2.9, Mac OS X 10.5, FreeBSD 5.2.1, Minix 3.1.8, AIX 5.2, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14, Android 6.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/glibc-functions/pwritev.texi b/doc/glibc-functions/pwritev.texi
index 606cecc28..4b3f763e5 100644
--- a/doc/glibc-functions/pwritev.texi
+++ b/doc/glibc-functions/pwritev.texi
@@ -28,6 +28,6 @@ This function is missing on some platforms:
glibc 2.9, Mac OS X 10.5, FreeBSD 5.2.1, Minix 3.1.8, AIX 5.2, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14, Android 6.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/glibc-functions/sendfile.texi b/doc/glibc-functions/sendfile.texi
index 78d677420..4da43317a 100644
--- a/doc/glibc-functions/sendfile.texi
+++ b/doc/glibc-functions/sendfile.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, IRIX 6.5, Solaris 11 2010-11, Cygwin, mingw, MSVC 14, Android 4.4.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/glibc-functions/statfs.texi b/doc/glibc-functions/statfs.texi
index 736772b6a..deef25c80 100644
--- a/doc/glibc-functions/statfs.texi
+++ b/doc/glibc-functions/statfs.texi
@@ -18,6 +18,6 @@ Minix 3.1.8, AIX 5.1, mingw, MSVC 14.
@item
On platforms where @code{f_blocks} in @samp{struct statfs} is a 32-bit
value, this function may not work correctly on files systems larger than
-4 TiB. The fix is to use the @code{AC_SYS_LARGEFILE} macro. This affects
+4 TiB@. The fix is to use the @code{AC_SYS_LARGEFILE} macro. This affects
Mac OS X.
@end itemize
diff --git a/doc/gnulib-intro.texi b/doc/gnulib-intro.texi
index f93587503..a7c75f35a 100644
--- a/doc/gnulib-intro.texi
+++ b/doc/gnulib-intro.texi
@@ -121,7 +121,7 @@ glibc on Linux is frequently tested.
glibc on kFreeBSD is rarely tested.
@end itemize
@item
-Mac OS X. In versions 10.13, it's occasionally tested. In version
+Mac OS X@. In versions 10.13, it's occasionally tested. In version
10.5, it's rarely tested.
@item
FreeBSD 11.0 or newer is occasionally tested.
@@ -392,8 +392,8 @@ proofreading the patch.
@node Copyright
@section Copyright
-Most modules are under the GPL. Some, mostly modules which can
-reasonably be used in libraries, are under LGPL. The source files
+Most modules are under the GPL@. Some, mostly modules which can
+reasonably be used in libraries, are under LGPL@. The source files
always say "GPL", but the real license specification is in the module
description file. If the module description file says "GPL", it means
"GPLv3+" (GPLv3 or newer, at the licensee's choice); if it says "LGPL",
@@ -426,7 +426,7 @@ with or without modifications, as long as this notice is preserved.
@item tests/
If a license statement is not present in a test module, the test files are
-under GPL. Even if the corresponding source module is under LGPL, this is
+under GPL@. Even if the corresponding source module is under LGPL, this is
not a problem, since compiled tests are not installed by ``make install''.
@item doc/
@@ -452,7 +452,7 @@ passing the option @samp{--lgpl=2} to @code{gnulib-tool}.
Keep in mind that when you submit patches to files in Gnulib, you should
license them under a compatible license. This means that sometimes the
contribution will have to be LGPL, if the original file is available
-under LGPL. You can find out about it by looking for a "License: LGPL"
+under LGPL@. You can find out about it by looking for a "License: LGPL"
information in the corresponding module description.
@node Steady Development
diff --git a/doc/gnulib-tool.texi b/doc/gnulib-tool.texi
index 44a393a69..fb2b01922 100644
--- a/doc/gnulib-tool.texi
+++ b/doc/gnulib-tool.texi
@@ -916,7 +916,7 @@ into the VCS, but instead added to @file{.gitignore} or equivalent.
@item
In projects which customarily omit from their VCS all files that are
generated from other source files, none of these files and directories
-are added into the VCS. As described in @ref{Modified imports}, there
+are added into the VCS@. As described in @ref{Modified imports}, there
are two ways to keep track of options and module names that are passed
to @code{gnulib-tool}. The command for restoring the omitted files
depends on it:
diff --git a/doc/intprops.texi b/doc/intprops.texi
index c6543dbe6..24d192181 100644
--- a/doc/intprops.texi
+++ b/doc/intprops.texi
@@ -368,9 +368,9 @@ Although the implementation of these macros is similar to that
suggested in Seacord R, The CERT C Secure Coding Standard (2009,
revised 2011), in its two sections
``@url{https://www.securecoding.cert.org/confluence/display/c/INT30-C.+Ensure+that+unsigned+integer+operations+do+not+wrap,
-INT30-C. Ensure that unsigned integer operations do not wrap}'' and
+INT30-C@. Ensure that unsigned integer operations do not wrap}'' and
``@url{https://www.securecoding.cert.org/confluence/display/c/INT32-C.+Ensure+that+operations+on+signed+integers+do+not+result+in+overflow,
-INT32-C. Ensure that operations on signed integers do not result in
+INT32-C@. Ensure that operations on signed integers do not result in
overflow}'', Gnulib's implementation was derived independently of
CERT's suggestions.
diff --git a/doc/lib-symbol-visibility.texi b/doc/lib-symbol-visibility.texi
index f91ba25bf..3267bd483 100644
--- a/doc/lib-symbol-visibility.texi
+++ b/doc/lib-symbol-visibility.texi
@@ -80,7 +80,7 @@ the shared library, and an ``exported'' attribute for those symbols in these
files that shall be exported.
This is perfect: It burdens the maintainer only for exported API, not
-for library-internal API. And it keeps the annotations in the source code.
+for library-internal API@. And it keeps the annotations in the source code.
@end itemize
GNU libtool's @option{-export-symbols} option implements the first approach.
diff --git a/doc/licenses-texi.texi b/doc/licenses-texi.texi
index d226bc8d0..630272c98 100644
--- a/doc/licenses-texi.texi
+++ b/doc/licenses-texi.texi
@@ -21,7 +21,7 @@ The code license (GNU GPL, GNU LGPL, or GNU Affero GPL) is usually
present as a file in the top-level directory. This is true not only for
the release tarballs, but also in the VCS repository. The file is
typically named @samp{COPYING} for the GNU GPL, or @samp{COPYING.LIB} or
-@samp{COPYING.LESSER} for the GNU LGPL. The presence of this file
+@samp{COPYING.LESSER} for the GNU LGPL@. The presence of this file
fulfills a legal obligation; see
@url{https://www.gnu.org/licenses/gpl-faq.html#WhyMustIInclude}.
diff --git a/doc/maintain.texi b/doc/maintain.texi
index dcbc4d1bc..fea22b2e9 100644
--- a/doc/maintain.texi
+++ b/doc/maintain.texi
@@ -5,7 +5,7 @@
@c For double-sided printing, uncomment:
@c @setchapternewpage odd
@c This date is automagically updated when you save this file:
-@set lastupdate April 24, 2020
+@set lastupdate May 17, 2020
@c %**end of header
@documentencoding UTF-8
@@ -309,7 +309,7 @@ distribute the package, and the standing to defend its GPL-covered
status in court if necessary.
GNU packages need not be FSF-copyrighted; this is up to the author(s),
-generally at the time the package is dubbed GNU. When copyright is
+generally at the time the package is dubbed GNU@. When copyright is
assigned to the FSF, the FSF can act to stop GPL violations about the
package. Otherwise, legal actions are up to the author(s). The rest
of this section is about the case when a package is FSF-copyrighted.
@@ -408,7 +408,7 @@ After receiving the necessary form, the contributor needs to sign
it. Contributors residing in the USA or Italy may use GPG in order to
sign their assignment. Contributors located anywhere else can print,
sign, and then email (or fax) a scanned copy back to the
-FSF. (Specific instructions for both cases are sent with the
+FSF@. (Specific instructions for both cases are sent with the
assignment form.) They may use postal mail, if they prefer. To
emphasize, the necessary distinction is between residents and
non-residents of these countries; citizenship does not matter.
@@ -846,7 +846,7 @@ or both in parallel, as here.
GNU @var{package} is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the GNU
General Public License for more details.
You should have received copies of the GNU General Public License and
@@ -870,7 +870,7 @@ You can use whichever is the most convenient for you.
@item
The @code{gnulib} project on @code{savannah.gnu.org}, which you
-can access via anonymous Git or CVS. See
+can access via anonymous Git or CVS@. See
@uref{https://savannah.gnu.org/projects/gnulib}.
@end itemize
@@ -898,7 +898,7 @@ License, or (at your option) any later version.
GNU @var{package} is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
@@ -916,7 +916,7 @@ the Free Software Foundation; either version 3 of the License, or
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
@@ -1036,7 +1036,7 @@ separately-published general-purpose free modules? (We also call them
matter whether they are packaged as libraries or not.)
It would be unreasonable to ask their authors to assign copyright to
-the FSF. They didn't write those modules as contributions to GNU. We
+the FSF@. They didn't write those modules as contributions to GNU@. We
just happen to want to use them, as any developer might. It would be
rude to ask developers, out of the blue, to give the FSF their
copyright. Please don't ask for that in cases like these.
@@ -1487,7 +1487,7 @@ version, and checking that the result exactly matches the new version.
@section Binary Distribution for Nonfree Platforms
Some package maintainers release pre-compiled binaries for proprietary
-systems such as Microsoft Windows or MacOS. It's entirely up to you
+systems such as Microsoft Windows or MacOS@. It's entirely up to you
whether to do that; we don't ask you to do it, but we don't object.
Please do not let anyone make you feel you have an obligation to do
this.
@@ -2567,7 +2567,7 @@ well.
@cindex GNU/Linux
The GNU Project was formed to develop a free Unix-like operating system,
-GNU. The existence of this system is our major accomplishment.
+GNU@. The existence of this system is our major accomplishment.
However, the widely used version of the GNU system, in which Linux is
used as the kernel, is often called simply ``Linux''. As a result, most
users don't know about the GNU Project's major accomplishment---or more
@@ -2623,7 +2623,7 @@ itself (@pxref{Terminology}). Likewise, avoid promoting nonfree
programs (@pxref{References,,, standards, GNU Coding
Standards}) as you would in the package itself.
-Many GNU users have erroneous ideas about GNU. Outside of our
+Many GNU users have erroneous ideas about GNU@. Outside of our
community, most people think it is Linux. Please use your opportunity
to set them straight. Start the presentation with the answers to
these basic questions:
diff --git a/doc/make-stds.texi b/doc/make-stds.texi
index d37b24418..b0745a8a3 100644
--- a/doc/make-stds.texi
+++ b/doc/make-stds.texi
@@ -549,15 +549,15 @@ should normally be @file{/usr/local/include}, but write it as
Most compilers other than GCC do not look for header files in directory
@file{/usr/local/include}. So installing the header files this way is
-only useful with GCC. Sometimes this is not a problem because some
-libraries are only really intended to work with GCC. But some libraries
+only useful with GCC@. Sometimes this is not a problem because some
+libraries are only really intended to work with GCC@. But some libraries
are intended to work with other compilers. They should install their
header files in two places, one specified by @code{includedir} and one
specified by @code{oldincludedir}.
@item oldincludedir
The directory for installing @samp{#include} header files for use with
-compilers other than GCC. This should normally be @file{/usr/include}.
+compilers other than GCC@. This should normally be @file{/usr/include}.
(If you are using Autoconf, you can write it as @samp{@@oldincludedir@@}.)
The Makefile commands should check whether the value of
diff --git a/doc/pastposix-functions/bcmp.texi b/doc/pastposix-functions/bcmp.texi
index 8544b6701..13906aabd 100644
--- a/doc/pastposix-functions/bcmp.texi
+++ b/doc/pastposix-functions/bcmp.texi
@@ -16,6 +16,6 @@ Portability problems not fixed by Gnulib:
This function is missing on some platforms:
mingw, MSVC 14, Android 9.0.
@item
-This function is marked as ``legacy'' in POSIX. Better use @code{memcmp}
+This function is marked as ``legacy'' in POSIX@. Better use @code{memcmp}
instead.
@end itemize
diff --git a/doc/pastposix-functions/bcopy.texi b/doc/pastposix-functions/bcopy.texi
index 294493d78..20e6e5585 100644
--- a/doc/pastposix-functions/bcopy.texi
+++ b/doc/pastposix-functions/bcopy.texi
@@ -16,6 +16,6 @@ mingw, MSVC 14, Android 9.0.
Portability problems not fixed by Gnulib:
@itemize
@item
-This function is marked as ``legacy'' in POSIX. Better use @code{memcpy}
+This function is marked as ``legacy'' in POSIX@. Better use @code{memcpy}
or @code{memmove} instead.
@end itemize
diff --git a/doc/pastposix-functions/bzero.texi b/doc/pastposix-functions/bzero.texi
index d3074316e..832ccb6a1 100644
--- a/doc/pastposix-functions/bzero.texi
+++ b/doc/pastposix-functions/bzero.texi
@@ -16,6 +16,6 @@ Portability problems not fixed by Gnulib:
This function is missing on some platforms:
mingw, MSVC 14, Android 9.0.
@item
-This function is marked as ``legacy'' in POSIX. Better use @code{memset}
+This function is marked as ``legacy'' in POSIX@. Better use @code{memset}
instead.
@end itemize
diff --git a/doc/pastposix-functions/ecvt.texi b/doc/pastposix-functions/ecvt.texi
index 51c8bde45..ec4ce77dc 100644
--- a/doc/pastposix-functions/ecvt.texi
+++ b/doc/pastposix-functions/ecvt.texi
@@ -16,6 +16,6 @@ Portability problems not fixed by Gnulib:
This function is missing on some platforms:
FreeBSD 6.0, NetBSD 5.0, Android 9.0.
@item
-This function is marked as ``legacy'' in POSIX. Better use @code{sprintf}
+This function is marked as ``legacy'' in POSIX@. Better use @code{sprintf}
instead.
@end itemize
diff --git a/doc/pastposix-functions/fcvt.texi b/doc/pastposix-functions/fcvt.texi
index 9a6dd964c..5d6c1a35e 100644
--- a/doc/pastposix-functions/fcvt.texi
+++ b/doc/pastposix-functions/fcvt.texi
@@ -16,6 +16,6 @@ Portability problems not fixed by Gnulib:
This function is missing on some platforms:
FreeBSD 6.0, NetBSD 5.0, Android 9.0.
@item
-This function is marked as ``legacy'' in POSIX. Better use @code{sprintf}
+This function is marked as ``legacy'' in POSIX@. Better use @code{sprintf}
instead.
@end itemize
diff --git a/doc/pastposix-functions/ftime.texi b/doc/pastposix-functions/ftime.texi
index 1edd6d012..64c644d10 100644
--- a/doc/pastposix-functions/ftime.texi
+++ b/doc/pastposix-functions/ftime.texi
@@ -19,7 +19,7 @@ Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Android 9.0.
On native Windows platforms (mingw, MSVC), this function works incorrectly
when the environment variable @code{TZ} has been set by Cygwin.
@item
-This function is marked as ``legacy'' in POSIX. Better use @code{gettimeofday}
+This function is marked as ``legacy'' in POSIX@. Better use @code{gettimeofday}
or @code{clock_gettime} instead, and use @code{ftime} only as a fallback for
portability to Windows platforms.
@end itemize
diff --git a/doc/pastposix-functions/gcvt.texi b/doc/pastposix-functions/gcvt.texi
index 50e00b76c..2c03bae2a 100644
--- a/doc/pastposix-functions/gcvt.texi
+++ b/doc/pastposix-functions/gcvt.texi
@@ -16,6 +16,6 @@ Portability problems not fixed by Gnulib:
This function is missing on some platforms:
Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, Android 9.0.
@item
-This function is marked as ``legacy'' in POSIX. Better use @code{sprintf}
+This function is marked as ``legacy'' in POSIX@. Better use @code{sprintf}
instead.
@end itemize
diff --git a/doc/pastposix-functions/getwd.texi b/doc/pastposix-functions/getwd.texi
index 9a2a2bdf4..1551ca5ac 100644
--- a/doc/pastposix-functions/getwd.texi
+++ b/doc/pastposix-functions/getwd.texi
@@ -19,5 +19,5 @@ mingw, MSVC 14, Android 9.0.
The size of the buffer required for this function is not a compile-time
constant. Also, the function truncates a result that would be larger than
the minimum buffer size. For these reasons, this function is marked as
-``legacy'' in POSIX. Better use the @code{getcwd} function instead.
+``legacy'' in POSIX@. Better use the @code{getcwd} function instead.
@end itemize
diff --git a/doc/pastposix-functions/index.texi b/doc/pastposix-functions/index.texi
index 21509fad3..786a2b50f 100644
--- a/doc/pastposix-functions/index.texi
+++ b/doc/pastposix-functions/index.texi
@@ -21,6 +21,6 @@ Portability problems not fixed by Gnulib:
This function is missing on some platforms:
mingw, MSVC 14, Android 9.0.
@item
-This function is marked as ``legacy'' in POSIX. Better use @code{strchr}
+This function is marked as ``legacy'' in POSIX@. Better use @code{strchr}
instead.
@end itemize
diff --git a/doc/pastposix-functions/mktemp.texi b/doc/pastposix-functions/mktemp.texi
index 436b954f1..258fac2b7 100644
--- a/doc/pastposix-functions/mktemp.texi
+++ b/doc/pastposix-functions/mktemp.texi
@@ -14,6 +14,6 @@ Portability problems not fixed by Gnulib:
@itemize
@item
This function is not appropriate for creating temporary files. (It has
-security risks.) Therefore it is marked as ``legacy'' in POSIX. Better use
+security risks.) Therefore it is marked as ``legacy'' in POSIX@. Better use
@code{mkstemp} instead.
@end itemize
diff --git a/doc/pastposix-functions/rindex.texi b/doc/pastposix-functions/rindex.texi
index 39759c7ba..c19c3ba27 100644
--- a/doc/pastposix-functions/rindex.texi
+++ b/doc/pastposix-functions/rindex.texi
@@ -16,6 +16,6 @@ Portability problems not fixed by Gnulib:
This function is missing on some platforms:
mingw, MSVC 14, Android 9.0.
@item
-This function is marked as ``legacy'' in POSIX. Better use @code{strrchr}
+This function is marked as ``legacy'' in POSIX@. Better use @code{strrchr}
instead.
@end itemize
diff --git a/doc/pastposix-functions/wcswcs.texi b/doc/pastposix-functions/wcswcs.texi
index c703d8cb0..1f80d7b19 100644
--- a/doc/pastposix-functions/wcswcs.texi
+++ b/doc/pastposix-functions/wcswcs.texi
@@ -19,6 +19,6 @@ Mac OS X 10.5, FreeBSD 6.0, Cygwin, mingw, MSVC 14, Android 9.0.
On Windows and 32-bit AIX platforms, @code{wchar_t} is a 16-bit type and therefore cannot
accommodate all Unicode characters.
@item
-This function is marked as ``legacy'' in POSIX. Better use @code{wcsstr}
+This function is marked as ``legacy'' in POSIX@. Better use @code{wcsstr}
instead.
@end itemize
diff --git a/doc/posix-functions/aio_cancel.texi b/doc/posix-functions/aio_cancel.texi
index 48d26cf3b..645fcd816 100644
--- a/doc/posix-functions/aio_cancel.texi
+++ b/doc/posix-functions/aio_cancel.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
NetBSD 3.0, OpenBSD 3.8, Minix 3.1.8, Cygwin, mingw, MSVC 14, Android 9.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/aio_error.texi b/doc/posix-functions/aio_error.texi
index c2eb0ee54..7dfbb7dd3 100644
--- a/doc/posix-functions/aio_error.texi
+++ b/doc/posix-functions/aio_error.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
NetBSD 3.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, Cygwin, mingw, MSVC 14, Android 9.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/aio_fsync.texi b/doc/posix-functions/aio_fsync.texi
index 6f2a6ce1e..605e4314a 100644
--- a/doc/posix-functions/aio_fsync.texi
+++ b/doc/posix-functions/aio_fsync.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, Cygwin, mingw, MSVC 14, Android 9.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/aio_read.texi b/doc/posix-functions/aio_read.texi
index a70138eef..29087f09e 100644
--- a/doc/posix-functions/aio_read.texi
+++ b/doc/posix-functions/aio_read.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
NetBSD 3.0, OpenBSD 3.8, Minix 3.1.8, Cygwin, mingw, MSVC 14, Android 9.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/aio_return.texi b/doc/posix-functions/aio_return.texi
index aecf4af86..b802a2581 100644
--- a/doc/posix-functions/aio_return.texi
+++ b/doc/posix-functions/aio_return.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
NetBSD 3.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, Cygwin, mingw, MSVC 14, Android 9.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/aio_suspend.texi b/doc/posix-functions/aio_suspend.texi
index bc49bc509..12efb7939 100644
--- a/doc/posix-functions/aio_suspend.texi
+++ b/doc/posix-functions/aio_suspend.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
NetBSD 3.0, OpenBSD 3.8, Minix 3.1.8, Cygwin, mingw, MSVC 14, Android 9.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/aio_write.texi b/doc/posix-functions/aio_write.texi
index 062841e98..0705bebbe 100644
--- a/doc/posix-functions/aio_write.texi
+++ b/doc/posix-functions/aio_write.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
NetBSD 3.0, OpenBSD 3.8, Minix 3.1.8, Cygwin, mingw, MSVC 14, Android 9.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/creat.texi b/doc/posix-functions/creat.texi
index 171475c9e..e7cc57e90 100644
--- a/doc/posix-functions/creat.texi
+++ b/doc/posix-functions/creat.texi
@@ -14,7 +14,7 @@ on some platforms:
MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, @code{creat} may not work
-correctly with files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@item
This function does not fail when the file name argument ends in a slash
and (without the slash) names a nonexistent file, on some platforms:
diff --git a/doc/posix-functions/ctime.texi b/doc/posix-functions/ctime.texi
index ba15b8a5c..d9e194c2b 100644
--- a/doc/posix-functions/ctime.texi
+++ b/doc/posix-functions/ctime.texi
@@ -26,7 +26,7 @@ wrong date in one of the threads, or some undefined string. There is
a re-entrant interface @code{ctime_r}.
@item
Native Windows platforms (mingw, MSVC) support only a subset of time
-zones supported by GNU or specified by POSIX. @xref{tzset}.
+zones supported by GNU or specified by POSIX@. @xref{tzset}.
@end itemize
A more flexible function is @code{strftime}. However, note that it is
diff --git a/doc/posix-functions/daylight.texi b/doc/posix-functions/daylight.texi
index 8aa6c2794..af4eeb310 100644
--- a/doc/posix-functions/daylight.texi
+++ b/doc/posix-functions/daylight.texi
@@ -20,7 +20,7 @@ The address of this variable is not a compile-time constant on some platforms:
Cygwin, mingw.
@item
Native Windows platforms (mingw, MSVC) support only a subset of time
-zones supported by GNU or specified by POSIX. @xref{tzset}.
+zones supported by GNU or specified by POSIX@. @xref{tzset}.
@end itemize
A more portable way of getting the UTC offset is to use
diff --git a/doc/posix-functions/fgetpos.texi b/doc/posix-functions/fgetpos.texi
index 723f4a2e7..607673ddf 100644
--- a/doc/posix-functions/fgetpos.texi
+++ b/doc/posix-functions/fgetpos.texi
@@ -18,6 +18,6 @@ on input streams that are opened in @code{O_TEXT} mode and whose contents
contains Unix line terminators (LF), on some platforms: mingw, MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/fopen.texi b/doc/posix-functions/fopen.texi
index 308d67649..e30e983f9 100644
--- a/doc/posix-functions/fopen.texi
+++ b/doc/posix-functions/fopen.texi
@@ -15,7 +15,7 @@ directory, on some platforms:
HP-UX 11.00, AIX 7.1, Solaris 9.
@item
On platforms where @code{off_t} is a 32-bit type, @code{fopen} may not work
-correctly with files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@item
On Windows platforms (excluding Cygwin), this function does usually not
recognize the @file{/dev/null} filename.
diff --git a/doc/posix-functions/freopen.texi b/doc/posix-functions/freopen.texi
index c31349bc0..4b6cd8b13 100644
--- a/doc/posix-functions/freopen.texi
+++ b/doc/posix-functions/freopen.texi
@@ -14,7 +14,7 @@ file descriptor, @code{freopen} returns the stream without opening
the file: glibc 2.24.
@item
On platforms where @code{off_t} is a 32-bit type, @code{freopen} may not work
-correctly with files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@item
On Windows platforms (excluding Cygwin), this function does usually not
recognize the @file{/dev/null} filename.
diff --git a/doc/posix-functions/fseeko.texi b/doc/posix-functions/fseeko.texi
index 55ac85390..b32760062 100644
--- a/doc/posix-functions/fseeko.texi
+++ b/doc/posix-functions/fseeko.texi
@@ -19,7 +19,7 @@ glibc 2.3.6.
This function fails on seekable stdin, stdout, and stderr: cygwin <= 1.5.24.
@item
On platforms where @code{off_t} is a 32-bit type, @code{fseeko} does not work
-correctly with files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@end itemize
Portability problems not fixed by Gnulib:
diff --git a/doc/posix-functions/fsetpos.texi b/doc/posix-functions/fsetpos.texi
index d03abe6fd..f955970d3 100644
--- a/doc/posix-functions/fsetpos.texi
+++ b/doc/posix-functions/fsetpos.texi
@@ -14,6 +14,6 @@ Portability problems not fixed by Gnulib:
@itemize
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/fstatat.texi b/doc/posix-functions/fstatat.texi
index 3530fa539..b75f42189 100644
--- a/doc/posix-functions/fstatat.texi
+++ b/doc/posix-functions/fstatat.texi
@@ -16,7 +16,7 @@ But the replacement function is not safe to be used in libraries and is not mult
@item
On platforms where @code{off_t} is a 32-bit type, @code{fstatat} may
not correctly report the size of files or block devices larger than 2
-GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@item
On some platforms, @code{fstatat(fd,"file/",buf,flag)} succeeds instead of
failing with @code{ENOTDIR}.
diff --git a/doc/posix-functions/fstatvfs.texi b/doc/posix-functions/fstatvfs.texi
index 97d45deb6..805902f21 100644
--- a/doc/posix-functions/fstatvfs.texi
+++ b/doc/posix-functions/fstatvfs.texi
@@ -18,6 +18,6 @@ OpenBSD 3.8, mingw, MSVC 14, Android 4.3.
@item
On platforms where @code{f_blocks} in @samp{struct statvfs} is a 32-bit
value, this function may not work correctly on files systems larger than
-4 TiB. The fix is to use the @code{AC_SYS_LARGEFILE} macro. This affects
+4 TiB@. The fix is to use the @code{AC_SYS_LARGEFILE} macro. This affects
glibc/Hurd, HP-UX 11, Solaris.
@end itemize
diff --git a/doc/posix-functions/ftello.texi b/doc/posix-functions/ftello.texi
index 9d0a95cc1..2561c5d65 100644
--- a/doc/posix-functions/ftello.texi
+++ b/doc/posix-functions/ftello.texi
@@ -23,7 +23,7 @@ Solaris 11 2010-11.
This function fails on seekable stdin, stdout, and stderr: cygwin <= 1.5.24.
@item
On platforms where @code{off_t} is a 32-bit type, @code{ftello} does not work
-correctly with files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@end itemize
Portability problems not fixed by Gnulib:
diff --git a/doc/posix-functions/ftruncate.texi b/doc/posix-functions/ftruncate.texi
index 3ab6cf37f..2abf1053e 100644
--- a/doc/posix-functions/ftruncate.texi
+++ b/doc/posix-functions/ftruncate.texi
@@ -13,7 +13,7 @@ This function is missing on some platforms:
MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, this function is not
-applicable to arbitrary lengths for files larger than 2 GB. The fix is to
+applicable to arbitrary lengths for files larger than 2 GB@. The fix is to
use the @code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/getrlimit.texi b/doc/posix-functions/getrlimit.texi
index 7cfc9a135..53e2c0465 100644
--- a/doc/posix-functions/getrlimit.texi
+++ b/doc/posix-functions/getrlimit.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
mingw, MSVC 14.
@item
On platforms where @code{rlim_t} is a 32-bit type, this function does not
-allow to retrieve limits larger than 4 GB, such as for RLIMIT_FSIZE. The
+allow to retrieve limits larger than 4 GB, such as for RLIMIT_FSIZE@. The
fix is to use the @code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/lio_listio.texi b/doc/posix-functions/lio_listio.texi
index ae9bfe2b4..34a0465b2 100644
--- a/doc/posix-functions/lio_listio.texi
+++ b/doc/posix-functions/lio_listio.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
NetBSD 3.0, OpenBSD 3.8, Minix 3.1.8, Cygwin, mingw, MSVC 14, Android 9.0.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. The fix is to use the
+work correctly on files larger than 2 GB@. The fix is to use the
@code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/localtime.texi b/doc/posix-functions/localtime.texi
index b5f75ec4c..040102b9b 100644
--- a/doc/posix-functions/localtime.texi
+++ b/doc/posix-functions/localtime.texi
@@ -26,5 +26,5 @@ unsupported arguments (like @math{2^56}), rather than failing:
FreeBSD 10.
@item
Native Windows platforms (mingw, MSVC) support only a subset of time
-zones supported by GNU or specified by POSIX. @xref{tzset}.
+zones supported by GNU or specified by POSIX@. @xref{tzset}.
@end itemize
diff --git a/doc/posix-functions/lseek.texi b/doc/posix-functions/lseek.texi
index 7690fa6c2..f5f06ce4e 100644
--- a/doc/posix-functions/lseek.texi
+++ b/doc/posix-functions/lseek.texi
@@ -10,7 +10,7 @@ Portability problems fixed by Gnulib:
@itemize
@item
On platforms where @code{off_t} is a 32-bit type, @code{lseek} does not work
-correctly with files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@item
This function mistakenly succeeds on pipes on some platforms: mingw, MSVC 14.
@end itemize
diff --git a/doc/posix-functions/mkstemp.texi b/doc/posix-functions/mkstemp.texi
index 138d9130e..0ec65f1b5 100644
--- a/doc/posix-functions/mkstemp.texi
+++ b/doc/posix-functions/mkstemp.texi
@@ -13,7 +13,7 @@ This function is missing on some platforms:
mingw, MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, @code{mkstemp} may not work
-correctly to create files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly to create files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@item
On some older platforms, @code{mkstemp} can create a world or group
writable or readable file, if you haven't set the process umask to
diff --git a/doc/posix-functions/mktime.texi b/doc/posix-functions/mktime.texi
index b9e261fd9..bf4be1836 100644
--- a/doc/posix-functions/mktime.texi
+++ b/doc/posix-functions/mktime.texi
@@ -21,5 +21,5 @@ Portability problems not fixed by Gnulib:
@itemize
@item
Native Windows platforms (mingw, MSVC) support only a subset of time
-zones supported by GNU or specified by POSIX. @xref{tzset}.
+zones supported by GNU or specified by POSIX@. @xref{tzset}.
@end itemize
diff --git a/doc/posix-functions/open.texi b/doc/posix-functions/open.texi
index 3c4a7e60a..1451f5860 100644
--- a/doc/posix-functions/open.texi
+++ b/doc/posix-functions/open.texi
@@ -13,7 +13,7 @@ Some platforms do not support @code{O_CLOEXEC}:
Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, HP-UX 11, IRIX 6.5, Solaris 10, Cygwin, mingw, MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, @code{open} may not work
-correctly with files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@item
This function does not fail when the file name argument ends in a slash
and (without the slash) names a nonexistent file or a file that is not a
diff --git a/doc/posix-functions/openat.texi b/doc/posix-functions/openat.texi
index 810bad8df..96b99f3e9 100644
--- a/doc/posix-functions/openat.texi
+++ b/doc/posix-functions/openat.texi
@@ -18,7 +18,7 @@ Some platforms do not support @code{O_CLOEXEC}:
AIX 7.1, Solaris 10.
@item
On platforms where @code{off_t} is a 32-bit type, @code{open} may not work
-correctly with files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@item
This function does not fail when the file name argument ends in a slash
and (without the slash) names a nonexistent file or a file that is not a
diff --git a/doc/posix-functions/opendir.texi b/doc/posix-functions/opendir.texi
index 055addf58..906866ecd 100644
--- a/doc/posix-functions/opendir.texi
+++ b/doc/posix-functions/opendir.texi
@@ -13,7 +13,7 @@ This function is missing on some platforms:
MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on huge directories larger than 2 GB. Also, on platforms
+work correctly on huge directories larger than 2 GB@. Also, on platforms
where @code{ino_t} is a 32-bit type, this function may report inode numbers
incorrectly. (Cf. @code{AC_SYS_LARGEFILE}.)
@end itemize
diff --git a/doc/posix-functions/pread.texi b/doc/posix-functions/pread.texi
index a7e7c2dab..6dfe9772b 100644
--- a/doc/posix-functions/pread.texi
+++ b/doc/posix-functions/pread.texi
@@ -13,7 +13,7 @@ This function is missing on some platforms:
mingw, MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+work correctly on files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@item
This function returns zero instead of positive values when large file support
is enabled on some platforms:
diff --git a/doc/posix-functions/pwrite.texi b/doc/posix-functions/pwrite.texi
index e8ac0e3ad..3faf7263b 100644
--- a/doc/posix-functions/pwrite.texi
+++ b/doc/posix-functions/pwrite.texi
@@ -13,7 +13,7 @@ This function is missing on some platforms:
mingw, MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+work correctly on files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@item
This function does not fail when an invalid (negative) offset is passed when
large file support is enabled on some platforms:
diff --git a/doc/posix-functions/readdir.texi b/doc/posix-functions/readdir.texi
index 3ec36bdbb..195d16c36 100644
--- a/doc/posix-functions/readdir.texi
+++ b/doc/posix-functions/readdir.texi
@@ -13,10 +13,10 @@ This function is missing on some platforms:
MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on huge directories larger than 2 GB. Also, on platforms
+work correctly on huge directories larger than 2 GB@. Also, on platforms
where @code{ino_t} is a 32-bit type, this function may report inode numbers
incorrectly. This can occur with file systems such as XFS (typically on
-large disks) and NFS. (Cf. @code{AC_SYS_LARGEFILE}.)
+large disks) and NFS@. (Cf. @code{AC_SYS_LARGEFILE}.)
@end itemize
Portability problems not fixed by Gnulib:
diff --git a/doc/posix-functions/readdir_r.texi b/doc/posix-functions/readdir_r.texi
index 61534488d..5a7391bfd 100644
--- a/doc/posix-functions/readdir_r.texi
+++ b/doc/posix-functions/readdir_r.texi
@@ -23,8 +23,8 @@ This function is missing on some platforms:
Minix 3.1.8, mingw, MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on huge directories larger than 2 GB. Also, on platforms
+work correctly on huge directories larger than 2 GB@. Also, on platforms
where @code{ino_t} is a 32-bit type, this function may report inode numbers
incorrectly. This can occur with file systems such as XFS (typically on
-large disks) and NFS. The fix is to use the @code{AC_SYS_LARGEFILE} macro.
+large disks) and NFS@. The fix is to use the @code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/scandir.texi b/doc/posix-functions/scandir.texi
index 58a14cbb9..560b58f13 100644
--- a/doc/posix-functions/scandir.texi
+++ b/doc/posix-functions/scandir.texi
@@ -13,7 +13,7 @@ This function is missing on some platforms:
Minix 3.1.8, Solaris 9, mingw, MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on huge directories larger than 2 GB. Also, on platforms
+work correctly on huge directories larger than 2 GB@. Also, on platforms
where @code{ino_t} is a 32-bit type, this function may report inode numbers
incorrectly. (Cf. @code{AC_SYS_LARGEFILE}.)
@end itemize
diff --git a/doc/posix-functions/seekdir.texi b/doc/posix-functions/seekdir.texi
index e11f4a9fe..d4e92ac85 100644
--- a/doc/posix-functions/seekdir.texi
+++ b/doc/posix-functions/seekdir.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
MSVC 14, Android 5.1.
@item
On platforms where @code{long int} is a 32-bit type, this function may not
-work correctly on huge directories larger than 2 GB. The fix is to use
+work correctly on huge directories larger than 2 GB@. The fix is to use
the @code{AC_SYS_LARGEFILE} macro (only on Mac OS X systems).
@end itemize
diff --git a/doc/posix-functions/setrlimit.texi b/doc/posix-functions/setrlimit.texi
index cf4353158..3599c5797 100644
--- a/doc/posix-functions/setrlimit.texi
+++ b/doc/posix-functions/setrlimit.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
Minix 3.1.8, mingw, MSVC 14.
@item
On platforms where @code{rlim_t} is a 32-bit type, this function does not
-allow to set limits larger than 4 GB, such as for RLIMIT_FSIZE. The fix is
+allow to set limits larger than 4 GB, such as for RLIMIT_FSIZE@. The fix is
to use the @code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/statvfs.texi b/doc/posix-functions/statvfs.texi
index 4e637ad54..3515a0144 100644
--- a/doc/posix-functions/statvfs.texi
+++ b/doc/posix-functions/statvfs.texi
@@ -23,7 +23,7 @@ Linux < 2.6.36.
@item
On platforms where @code{f_blocks} in @samp{struct statvfs} is a 32-bit
value, this function may not work correctly on files systems larger than
-4 TiB. The fix is to use the @code{AC_SYS_LARGEFILE} macro. This affects
+4 TiB@. The fix is to use the @code{AC_SYS_LARGEFILE} macro. This affects
glibc/Hurd, HP-UX 11, Solaris.
@end itemize
diff --git a/doc/posix-functions/strftime.texi b/doc/posix-functions/strftime.texi
index 3bd7214bd..13605c24c 100644
--- a/doc/posix-functions/strftime.texi
+++ b/doc/posix-functions/strftime.texi
@@ -21,7 +21,7 @@ support the %e specifier (and possibly the other more recent SUS
specifiers too, i.e., %C, %D, %h, %n, %r, %R, %t, and %T).
@item
Native Windows platforms (mingw, MSVC) support only a subset of time
-zones supported by GNU or specified by POSIX. @xref{tzset}.
+zones supported by GNU or specified by POSIX@. @xref{tzset}.
@end itemize
Extension: Gnulib offers a module @samp{nstrftime} that provides an
diff --git a/doc/posix-functions/telldir.texi b/doc/posix-functions/telldir.texi
index 13474e606..72ac57465 100644
--- a/doc/posix-functions/telldir.texi
+++ b/doc/posix-functions/telldir.texi
@@ -17,6 +17,6 @@ This function is missing on some platforms:
MSVC 14, Android 5.1.
@item
On platforms where @code{long int} is a 32-bit type, this function may not
-work correctly on huge directories larger than 2 GB. The fix is to use
+work correctly on huge directories larger than 2 GB@. The fix is to use
the @code{AC_SYS_LARGEFILE} macro (only on Mac OS X systems).
@end itemize
diff --git a/doc/posix-functions/timezone.texi b/doc/posix-functions/timezone.texi
index 7de727234..5297c77c2 100644
--- a/doc/posix-functions/timezone.texi
+++ b/doc/posix-functions/timezone.texi
@@ -20,7 +20,7 @@ The address of this variable is not a compile-time constant on some platforms:
mingw.
@item
Native Windows platforms (mingw, MSVC) support only a subset of time
-zones supported by GNU or specified by POSIX. @xref{tzset}.
+zones supported by GNU or specified by POSIX@. @xref{tzset}.
@end itemize
A more portable way of getting the UTC offset is to use
diff --git a/doc/posix-functions/tmpfile.texi b/doc/posix-functions/tmpfile.texi
index ce8955ccd..0df5901dd 100644
--- a/doc/posix-functions/tmpfile.texi
+++ b/doc/posix-functions/tmpfile.texi
@@ -16,7 +16,7 @@ This function often fails for trivial reasons on some platforms:
mingw, MSVC 14.
@item
On platforms where @code{off_t} is a 32-bit type, @code{tmpfile} may not work
-correctly to create files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly to create files larger than 2 GB@. (Cf. @code{AC_SYS_LARGEFILE}.)
@end itemize
Portability problems not fixed by Gnulib:
diff --git a/doc/posix-functions/truncate.texi b/doc/posix-functions/truncate.texi
index a109b36ad..85a4dbe9b 100644
--- a/doc/posix-functions/truncate.texi
+++ b/doc/posix-functions/truncate.texi
@@ -13,7 +13,7 @@ This function is missing on some platforms:
mingw, MSVC 14, Android 4.4 with @code{AC_SYS_LARGEFILE} in effect.
@item
On platforms where @code{off_t} is a 32-bit type, this function is not
-applicable to arbitrary lengths for files larger than 2 GB. The fix is to
+applicable to arbitrary lengths for files larger than 2 GB@. The fix is to
use the @code{AC_SYS_LARGEFILE} macro.
@end itemize
diff --git a/doc/posix-functions/tzname.texi b/doc/posix-functions/tzname.texi
index ab88634af..ae86dff1f 100644
--- a/doc/posix-functions/tzname.texi
+++ b/doc/posix-functions/tzname.texi
@@ -20,7 +20,7 @@ The address of this variable is not a compile-time constant on some platforms:
Cygwin, mingw.
@item
Native Windows platforms (mingw, MSVC) support only a subset of time
-zones supported by GNU or specified by POSIX. @xref{tzset}.
+zones supported by GNU or specified by POSIX@. @xref{tzset}.
@end itemize
A more portable way of getting the time zone abbreviation is to use
diff --git a/doc/posix-functions/wcsftime.texi b/doc/posix-functions/wcsftime.texi
index 2b7bde6fe..323ac2152 100644
--- a/doc/posix-functions/wcsftime.texi
+++ b/doc/posix-functions/wcsftime.texi
@@ -23,5 +23,5 @@ On Windows and 32-bit AIX platforms, @code{wchar_t} is a 16-bit type and therefo
accommodate all Unicode characters.
@item
Native Windows platforms (mingw, MSVC) support only a subset of time
-zones specified by POSIX. @xref{tzset}.
+zones specified by POSIX@. @xref{tzset}.
@end itemize
diff --git a/doc/standards.texi b/doc/standards.texi
index 5c2d97c0d..ef0b08105 100644
--- a/doc/standards.texi
+++ b/doc/standards.texi
@@ -3,7 +3,7 @@
@setfilename standards.info
@settitle GNU Coding Standards
@c This date is automagically updated when you save this file:
-@set lastupdate April 24, 2020
+@set lastupdate May 17, 2020
@c %**end of header
@dircategory GNU organization
@@ -290,7 +290,7 @@ account when designing your program.
@cindex programming languages
When you want to use a language that gets compiled and runs at high
-speed, the best language to use is C. C++ is ok too, but please don't
+speed, the best language to use is C@. C++ is ok too, but please don't
make heavy use of templates. So is Java, if you compile it.
When highest efficiency is not required, other languages commonly used
@@ -303,7 +303,7 @@ the more users are able to extend and combine them (@pxref{The Emacs
Thesis,,, guile, GNU Guile Reference Manual}).
Many programs are designed to be extensible: they include an interpreter
-for a language that is higher level than C. Often much of the program
+for a language that is higher level than C@. Often much of the program
is written in that language, too. The Emacs editor pioneered this
technique.
@@ -951,7 +951,7 @@ so that the same jobs can be done from scripts.
@cindex keyboard interface
@cindex library interface
Please also consider providing a D-bus interface for use from other
-running programs, such as within GNOME. (GNOME used to use CORBA
+running programs, such as within GNOME@. (GNOME used to use CORBA
for this, but that is being phased out.) In addition, consider
providing a library interface (for use from C), and perhaps a
keyboard-driven console interface (for use by users from console
@@ -2936,7 +2936,7 @@ versions. For a GNU program, this kind of portability is desirable, but
not paramount.
The primary purpose of GNU software is to run on top of the GNU kernel,
-compiled with the GNU C compiler, on various types of CPU. So the
+compiled with the GNU C compiler, on various types of CPU@. So the
kinds of portability that are absolutely necessary are quite limited.
But it is important to support Linux-based GNU systems, since they
are the form of GNU that is popular.
@@ -3583,7 +3583,7 @@ See @uref{https://www.gnu.org/copyleft/fdl-howto.html} for more explanation
of how to employ the GFDL.
Note that it is not obligatory to include a copy of the GNU GPL or GNU
-LGPL in a manual whose license is neither the GPL nor the LGPL. It can
+LGPL in a manual whose license is neither the GPL nor the LGPL@. It can
be a good idea to include the program's license in a large manual; in a
short manual, whose size would be increased considerably by including
the program's license, it is probably better not to include it.
@@ -3676,7 +3676,7 @@ you.
Instead of using a file named @file{ChangeLog}, you can record the
change log information as log entries in a version control system such
-as RCS or CVS. This can be converted automatically to a
+as RCS or CVS@. This can be converted automatically to a
@file{ChangeLog} file using @code{rcs2log}; in Emacs, the command
@kbd{C-x v a} (@code{vc-update-change-log}) does the job.
@@ -3949,7 +3949,7 @@ with the FSF about the individual case.
@cindex releasing
Making a release is more than just bundling up your source files in a
-tar file and putting it up for FTP. You should set up your software so
+tar file and putting it up for FTP@. You should set up your software so
that it can be configured to run on a variety of systems. Your Makefile
should conform to the GNU standards described below, and your directory
layout should also conform to the standards discussed below. Doing so
@@ -4252,7 +4252,7 @@ names for one file in different directories, because certain file
systems cannot handle this and that prevents unpacking the
distribution.
-Try to make sure that all the file names will be unique on MS-DOS. A
+Try to make sure that all the file names will be unique on MS-DOS@. A
name on MS-DOS consists of up to 8 characters, optionally followed by a
period and up to three characters. MS-DOS will truncate extra
characters both before and after the period. Thus,
diff --git a/doc/windows-sockets.texi b/doc/windows-sockets.texi
index f820b4b2e..9f81e51ac 100644
--- a/doc/windows-sockets.texi
+++ b/doc/windows-sockets.texi
@@ -10,7 +10,7 @@ This was written for the @code{getaddrinfo} module, but may be applicable to
other functions too.
The @code{getaddrinfo} function exists in @code{ws2tcpip.h} and @code{-lws2_32}
-on Windows XP. The function declaration is present if @code{WINVER >= 0x0501}.
+on Windows XP@. The function declaration is present if @code{WINVER >= 0x0501}.
Windows 2000 does not have @code{getaddrinfo} in its @file{WS2_32.DLL}.
Thus, if you want to assume Windows XP or later, you can add
--
2.26.2
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.3: Do the same for the license files. --]
[-- Type: text/x-diff, Size: 4687 bytes --]
diff --git a/doc/agpl-3.0.texi b/doc/agpl-3.0.texi
index eabb0c6df..ce3bf0d49 100644
--- a/doc/agpl-3.0.texi
+++ b/doc/agpl-3.0.texi
@@ -618,12 +618,12 @@ later version.
@item Disclaimer of Warranty.
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
-APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+APPLICABLE LAW@. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM ``AS IS'' WITHOUT
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
-PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
+A PARTICULAR PURPOSE@. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE PROGRAM IS WITH YOU@. SHOULD THE PROGRAM PROVE
DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
CORRECTION.
@@ -675,7 +675,7 @@ your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the GNU
Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
diff --git a/doc/gpl-2.0.texi b/doc/gpl-2.0.texi
index 38aa91822..4d90f1dd4 100644
--- a/doc/gpl-2.0.texi
+++ b/doc/gpl-2.0.texi
@@ -292,12 +292,12 @@ of promoting the sharing and reuse of software generally.
@item
BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW@. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM ``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
-TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE@. THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU@. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
@@ -344,7 +344,7 @@ the Free Software Foundation; either version 2 of the License, or
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
diff --git a/doc/lgpl-2.1.texi b/doc/lgpl-2.1.texi
index ab03d6cc3..a04ddf472 100644
--- a/doc/lgpl-2.1.texi
+++ b/doc/lgpl-2.1.texi
@@ -11,7 +11,7 @@ Copyright @copyright{} 1991, 1999 Free Software Foundation, Inc.
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
-[This is the first released version of the Lesser GPL. It also counts
+[This is the first released version of the Lesser GPL@. It also counts
as the successor of the GNU Library Public License, version 2, hence the
version number 2.1.]
@end display
@@ -479,8 +479,8 @@ EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
OTHER PARTIES PROVIDE THE LIBRARY ``AS IS'' WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
-LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+PURPOSE@. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU@. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
@item
@@ -523,7 +523,7 @@ your option) any later version.
This library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]
^ permalink raw reply related [flat|nested] 9+ messages in thread
* Re: Remove license modules
2020-05-17 19:58 ` Asher Gordon
@ 2020-05-17 20:12 ` Asher Gordon
2020-06-01 18:00 ` Bruno Haible
1 sibling, 0 replies; 9+ messages in thread
From: Asher Gordon @ 2020-05-17 20:12 UTC (permalink / raw)
To: Bruno Haible; +Cc: bug-gnulib
[-- Attachment #1: Type: text/plain, Size: 885 bytes --]
Asher Gordon <AsDaGo@posteo.net> writes:
> Perhaps Texinfo should change its heuristics so that a '.' preceding a
> capital letter always starts a sentence, even when it is preceded by a
> capital letter.
I just realized that this would treat names such as "J. Random Hacker"
incorrectly. That would then have to be written as "J.@ Random
Hacker". I still think that the new heuristics I described would do the
right thing more often, but perhaps it shouldn't be changed, since many
manuals have names in that format.
So I decided not to proposed the change to the Texinfo maintainers after
all.
Asher
--
<knghtbrd> eek, not another one...
<knghtbrd> Seems ever developer and their mother now has a random
signature using irc quotes ...
<knghtbrd> WHAT HAVE I STARTED HERE??
GPG fingerprint: 38F3 975C D173 4037 B397 8095 D4C9 C4FC 5460 8E68
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Remove license modules
2020-05-17 19:58 ` Asher Gordon
2020-05-17 20:12 ` Asher Gordon
@ 2020-06-01 18:00 ` Bruno Haible
2020-06-01 18:09 ` Paul Eggert
1 sibling, 1 reply; 9+ messages in thread
From: Bruno Haible @ 2020-06-01 18:00 UTC (permalink / raw)
To: Asher Gordon; +Cc: bug-gnulib
Asher Gordon wrote on 2020-05-17:
> >> I also fixed a minor issue where "VCS" ended with
> >> "." rather than "@." (see (texinfo) Ending a Sentence).
> >
> > I won't spend time on a single instance of this very minor issue. But if
> > you want to submit a patch that fixes all instances of this issue, I'll
> > appreciate it.
>
> See the attached 0001-doc-Change-.-to-.-where-appropriate.patch. It
> turns out that there were quite a few instances that should be changed
Thanks. I've applied your patch, except for the changes to
maintain.texi
standards.texi
make-stds.texi
which I've forwarded to bug-standards.
We haven't been paying attention to this detail (write @. instead of .
to terminate a sentence that ends with an uppercase letter). Maybe
your patch will remind us to do it better in the future.
> Also, there were some '.'s that should be changed to '@.' in the license
> Texinfo files.
I don't know whom to contact to change these.
Bruno
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Remove license modules
2020-06-01 18:00 ` Bruno Haible
@ 2020-06-01 18:09 ` Paul Eggert
2020-06-01 19:06 ` Typographical errors in Texinfo format licenses Asher Gordon
0 siblings, 1 reply; 9+ messages in thread
From: Paul Eggert @ 2020-06-01 18:09 UTC (permalink / raw)
To: Bruno Haible, Asher Gordon; +Cc: bug-gnulib
On 6/1/20 11:00 AM, Bruno Haible wrote:
>> Also, there were some '.'s that should be changed to '@.' in the license
>> Texinfo files.
> I don't know whom to contact to change these.
I'd write gnu@gnu.org.
^ permalink raw reply [flat|nested] 9+ messages in thread
* Typographical errors in Texinfo format licenses
2020-06-01 18:09 ` Paul Eggert
@ 2020-06-01 19:06 ` Asher Gordon
0 siblings, 0 replies; 9+ messages in thread
From: Asher Gordon @ 2020-06-01 19:06 UTC (permalink / raw)
To: gnu; +Cc: bug-gnulib, Paul Eggert, Bruno Haible
[-- Attachment #1.1: Type: text/plain, Size: 384 bytes --]
Hello,
I have discovered some typographical errors in some licenses in Texinfo
format. There are some '.'s that end sentences but follow capital
letters. These must be changed to '@.'. See also here¹.
Note: Paul Eggert suggests here² that I should write to gnu@gnu.org for
this issue, so that is what I have done.
See the below patch (created against the Gnulib tree):
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.2: Change '.' to '@.' where appropriate --]
[-- Type: text/x-diff, Size: 4687 bytes --]
diff --git a/doc/agpl-3.0.texi b/doc/agpl-3.0.texi
index eabb0c6df..ce3bf0d49 100644
--- a/doc/agpl-3.0.texi
+++ b/doc/agpl-3.0.texi
@@ -618,12 +618,12 @@ later version.
@item Disclaimer of Warranty.
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
-APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+APPLICABLE LAW@. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM ``AS IS'' WITHOUT
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
-PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
+A PARTICULAR PURPOSE@. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE PROGRAM IS WITH YOU@. SHOULD THE PROGRAM PROVE
DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
CORRECTION.
@@ -675,7 +675,7 @@ your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the GNU
Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
diff --git a/doc/gpl-2.0.texi b/doc/gpl-2.0.texi
index 38aa91822..4d90f1dd4 100644
--- a/doc/gpl-2.0.texi
+++ b/doc/gpl-2.0.texi
@@ -292,12 +292,12 @@ of promoting the sharing and reuse of software generally.
@item
BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW@. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM ``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
-TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE@. THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU@. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
@@ -344,7 +344,7 @@ the Free Software Foundation; either version 2 of the License, or
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
diff --git a/doc/lgpl-2.1.texi b/doc/lgpl-2.1.texi
index ab03d6cc3..a04ddf472 100644
--- a/doc/lgpl-2.1.texi
+++ b/doc/lgpl-2.1.texi
@@ -11,7 +11,7 @@ Copyright @copyright{} 1991, 1999 Free Software Foundation, Inc.
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
-[This is the first released version of the Lesser GPL. It also counts
+[This is the first released version of the Lesser GPL@. It also counts
as the successor of the GNU Library Public License, version 2, hence the
version number 2.1.]
@end display
@@ -479,8 +479,8 @@ EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
OTHER PARTIES PROVIDE THE LIBRARY ``AS IS'' WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
-LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+PURPOSE@. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU@. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
@item
@@ -523,7 +523,7 @@ your option) any later version.
This library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
[-- Attachment #1.3: Type: text/plain, Size: 446 bytes --]
Thanks,
Asher
Footnotes:
¹ https://lists.gnu.org/archive/html/bug-gnulib/2020-05/msg00173.html
² https://lists.gnu.org/archive/html/bug-gnulib/2020-06/msg00005.html
--
...very few phenomena can pull someone out of Deep Hack Mode, with two
noted exceptions: being struck by lightning, or worse, your *computer*
being struck by lightning.
-- Matt Welsh
GPG fingerprint: 38F3 975C D173 4037 B397 8095 D4C9 C4FC 5460 8E68
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]
^ permalink raw reply related [flat|nested] 9+ messages in thread
end of thread, other threads:[~2020-06-01 19:06 UTC | newest]
Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-05-12 17:51 Remove license modules Asher Gordon
2020-05-15 23:17 ` Bruno Haible
2020-05-16 18:03 ` Asher Gordon
2020-05-17 17:39 ` Bruno Haible
2020-05-17 19:58 ` Asher Gordon
2020-05-17 20:12 ` Asher Gordon
2020-06-01 18:00 ` Bruno Haible
2020-06-01 18:09 ` Paul Eggert
2020-06-01 19:06 ` Typographical errors in Texinfo format licenses Asher Gordon
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).