From 43eb9428a29c91a19bb46a4ce2c117aae4dddb84 Mon Sep 17 00:00:00 2001 From: Asher Gordon 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 + + * 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 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{}, 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