From 6be4a08f71935a92510818dd7d79cb4bd28f476e 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. * 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/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/windows-sockets.texi: Likewise. --- ChangeLog | 77 ++++++++++++++++++++++++++ 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/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/windows-sockets.texi | 2 +- 74 files changed, 157 insertions(+), 80 deletions(-) diff --git a/ChangeLog b/ChangeLog index 7b7e7d34c1..f7adf2722e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,80 @@ +2020-06-01 Asher Gordon + + doc: Change '.' to '@.' where appropriate. + * 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/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/windows-sockets.texi: Likewise. + 2020-05-31 Paul Eggert getrandom-tests: do not assume GRND_RANDOM yields short read diff --git a/doc/c-ctype.texi b/doc/c-ctype.texi index 5b7cfb6e4c..e5938cf33d 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 8b58818919..87617294bc 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 1cf3204ead..12ec251f31 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 35ea302bf4..a0faa77d7f 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 9f8e74dc24..ba7037e94e 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 3aded86d18..da483d1051 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 9792180e5a..3298e2852e 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 58bf7488bd..95076c6cf8 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 cd5947457c..f06edec006 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 606cecc280..4b3f763e51 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 78d6774201..4da43317a0 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 736772b6aa..deef25c807 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 486e0bac78..aaae5b9315 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 44a393a699..fb2b01922b 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 c6543dbe6f..24d1921818 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 f91ba25bfe..3267bd483d 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 d226bc8d02..630272c98f 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/pastposix-functions/bcmp.texi b/doc/pastposix-functions/bcmp.texi index 8544b6701d..13906aabd2 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 294493d782..20e6e5585b 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 d3074316e0..832ccb6a11 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 51c8bde45d..ec4ce77dca 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 9a6dd964c3..5d6c1a35eb 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 1edd6d0124..64c644d106 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 50e00b76cd..2c03bae2ab 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 9a2a2bdf41..1551ca5acb 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 21509fad3e..786a2b50f2 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 436b954f1e..258fac2b76 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 39759c7bad..c19c3ba27d 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 c703d8cb0c..1f80d7b199 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 48d26cf3b9..645fcd816e 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 c2eb0ee547..7dfbb7dd30 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 6f2a6ce1e0..605e4314a6 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 a70138eefa..29087f09ed 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 aecf4af86e..b802a2581d 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 bc49bc5095..12efb7939a 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 062841e981..0705bebbe9 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 171475c9ec..e7cc57e90c 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 ba15b8a5ca..d9e194c2b3 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 8aa6c27942..af4eeb3106 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 723f4a2e72..607673ddf6 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 6c562a6e58..401367bcb6 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 c31349bc0b..4b6cd8b13b 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 55ac85390c..b327600624 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 d03abe6fd6..f955970d38 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 3530fa539c..b75f42189b 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 97d45deb6e..805902f21e 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 9d0a95cc1b..2561c5d65e 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 3ab6cf37ff..2abf1053ee 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 7cfc9a1359..53e2c0465e 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 ae9bfe2b46..34a0465b25 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 b5f75ec4cf..040102b9bc 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 7690fa6c22..f5f06ce4e9 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 138d9130ea..0ec65f1b58 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 b9e261fd9f..bf4be18366 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 3c4a7e60a3..1451f58604 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 810bad8dfe..96b99f3e95 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 055addf586..906866ecd6 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 a7e7c2dab7..6dfe9772ba 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 e8ac0e3ad6..3faf7263b2 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 3ec36bdbbc..195d16c363 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 61534488d9..5a7391bfd6 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 58a14cbb99..560b58f13c 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 e11f4a9fe7..d4e92ac850 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 cf43531580..3599c57974 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 4e637ad547..3515a01444 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 3bd7214bda..13605c24c2 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 13474e606f..72ac57465e 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 7de727234f..5297c77c22 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 ce8955ccdd..0df5901dd1 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 a109b36ad7..85a4dbe9bb 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 ab88634af9..ae86dff1fb 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 2b7bde6fe9..323ac2152b 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/windows-sockets.texi b/doc/windows-sockets.texi index f820b4b2ee..9f81e51ac2 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.39.5