From 0ea87e9a68564479a0c5658f27147060d3e88ea8 Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Fri, 26 Jun 2020 13:38:22 +0200 Subject: [PATCH] doc: Mention declaration fixes implemented by some modules. * doc/posix-functions/chdir.texi: Mention the module 'chdir'. * doc/posix-functions/close.texi: Mention that Gnulib makes the function declaration appear in . * doc/posix-functions/dup.texi: Likewise. * doc/posix-functions/dup2.texi: Likewise. * doc/posix-functions/gethostname.texi: Likewise. * doc/posix-functions/isatty.texi: Likewise. * doc/posix-functions/lseek.texi: Likewise. * doc/posix-functions/unlink.texi: Likewise. * doc/posix-functions/read.texi: Mention the module 'read'. * doc/posix-functions/write.texi: Mention the effects of the module 'write'. --- ChangeLog | 16 ++++++++++++++++ doc/posix-functions/chdir.texi | 2 +- doc/posix-functions/close.texi | 4 ++++ doc/posix-functions/dup.texi | 4 ++++ doc/posix-functions/dup2.texi | 5 +++++ doc/posix-functions/gethostname.texi | 4 ++++ doc/posix-functions/isatty.texi | 4 ++++ doc/posix-functions/lseek.texi | 4 ++++ doc/posix-functions/read.texi | 12 ++++++++++-- doc/posix-functions/unlink.texi | 4 ++++ doc/posix-functions/write.texi | 10 +++++++++- 11 files changed, 65 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 0c440be9d8..5adf4f9630 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,19 @@ +2020-06-26 Bruno Haible + + doc: Mention declaration fixes implemented by some modules. + * doc/posix-functions/chdir.texi: Mention the module 'chdir'. + * doc/posix-functions/close.texi: Mention that Gnulib makes the function + declaration appear in . + * doc/posix-functions/dup.texi: Likewise. + * doc/posix-functions/dup2.texi: Likewise. + * doc/posix-functions/gethostname.texi: Likewise. + * doc/posix-functions/isatty.texi: Likewise. + * doc/posix-functions/lseek.texi: Likewise. + * doc/posix-functions/unlink.texi: Likewise. + * doc/posix-functions/read.texi: Mention the module 'read'. + * doc/posix-functions/write.texi: Mention the effects of the module + 'write'. + 2020-06-25 Marc Nieper-Wißkirchen c-dtoastr, c-ldtoastr: new modules diff --git a/doc/posix-functions/chdir.texi b/doc/posix-functions/chdir.texi index 9a65578769..3963271863 100644 --- a/doc/posix-functions/chdir.texi +++ b/doc/posix-functions/chdir.texi @@ -4,7 +4,7 @@ POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/chdir.html} -Gnulib module: --- +Gnulib module: chdir Portability problems fixed by Gnulib: @itemize diff --git a/doc/posix-functions/close.texi b/doc/posix-functions/close.texi index 9f9f66ced9..58f8e9a117 100644 --- a/doc/posix-functions/close.texi +++ b/doc/posix-functions/close.texi @@ -9,6 +9,10 @@ Gnulib module: close Portability problems fixed by Gnulib: @itemize @item +This function is declared in a different header file (namely, @code{}) +on some platforms: +MSVC 14. +@item This function crashes when invoked with invalid arguments on some platforms: MSVC 14. @item diff --git a/doc/posix-functions/dup.texi b/doc/posix-functions/dup.texi index e57a8d57ed..c43ba8c089 100644 --- a/doc/posix-functions/dup.texi +++ b/doc/posix-functions/dup.texi @@ -9,6 +9,10 @@ Gnulib module: dup Portability problems fixed by Gnulib: @itemize @item +This function is declared in a different header file (namely, @code{}) +on some platforms: +MSVC 14. +@item This function crashes when invoked with invalid arguments on some platforms: MSVC 14. @end itemize diff --git a/doc/posix-functions/dup2.texi b/doc/posix-functions/dup2.texi index c7bc2123d6..8635e6c089 100644 --- a/doc/posix-functions/dup2.texi +++ b/doc/posix-functions/dup2.texi @@ -8,6 +8,11 @@ Gnulib module: dup2 or dup2-obsolete Portability problems fixed by either Gnulib module @code{dup2} or @code{dup2-obsolete}: @itemize +@item +This function is declared in a different header file (namely, @code{}) +on some platforms: +MSVC 14. + @item This function always returns 0 for success on some platforms: mingw, MSVC 14. diff --git a/doc/posix-functions/gethostname.texi b/doc/posix-functions/gethostname.texi index a7ff3f6484..d162cea738 100644 --- a/doc/posix-functions/gethostname.texi +++ b/doc/posix-functions/gethostname.texi @@ -9,6 +9,10 @@ Gnulib module: gethostname Portability problems fixed by Gnulib: @itemize @item +This function is declared in a different header file (namely, +@code{}) on some platforms: +MSVC 14. +@item On mingw and MSVC 14, this function has a prototype that differs from that specified by POSIX, and it is defined only in the ws2_32 library. @end itemize diff --git a/doc/posix-functions/isatty.texi b/doc/posix-functions/isatty.texi index 29eee74e2d..d01f8e3a71 100644 --- a/doc/posix-functions/isatty.texi +++ b/doc/posix-functions/isatty.texi @@ -9,6 +9,10 @@ Gnulib module: isatty Portability problems fixed by Gnulib: @itemize @item +This function is declared in a different header file (namely, @code{}) +on some platforms: +MSVC 14. +@item On native Windows, this function also returns true for character devices such as @file{NUL}. @item diff --git a/doc/posix-functions/lseek.texi b/doc/posix-functions/lseek.texi index f5f06ce4e9..4a9d55dcf7 100644 --- a/doc/posix-functions/lseek.texi +++ b/doc/posix-functions/lseek.texi @@ -9,6 +9,10 @@ Gnulib module: lseek Portability problems fixed by Gnulib: @itemize @item +This function is declared in a different header file (namely, @code{}) +on some platforms: +MSVC 14. +@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}.) @item diff --git a/doc/posix-functions/read.texi b/doc/posix-functions/read.texi index 901470fa20..a48e5ea9e2 100644 --- a/doc/posix-functions/read.texi +++ b/doc/posix-functions/read.texi @@ -4,13 +4,21 @@ POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/read.html} -Gnulib module: stdio, nonblocking +Gnulib module: read, stdio, nonblocking -Portability problems fixed by Gnulib module @code{stdio}, together with module @code{nonblocking}: +Portability problems fixed by Gnulib module @code{read}: @itemize @item +This function is declared in a different header file (namely, @code{}) +on some platforms: +mingw, MSVC 14. +@item This function crashes when invoked with invalid arguments on some platforms: MSVC 14. +@end itemize + +Portability problems fixed by Gnulib module @code{stdio}, together with module @code{nonblocking}: +@itemize @item When reading from a non-blocking pipe whose buffer is empty, this function fails with @code{errno} being set to @code{EINVAL} instead of @code{EAGAIN} on diff --git a/doc/posix-functions/unlink.texi b/doc/posix-functions/unlink.texi index 4ee0003e55..15cfd8436b 100644 --- a/doc/posix-functions/unlink.texi +++ b/doc/posix-functions/unlink.texi @@ -9,6 +9,10 @@ Gnulib module: unlink Portability problems fixed by Gnulib: @itemize @item +This function is declared in a different header file (namely, @code{}) +on some platforms: +MSVC 14. +@item Some systems mistakenly succeed on @code{unlink("link-to-file/")}: GNU/Hurd, FreeBSD 7.2, AIX 7.1, Solaris 9. @item diff --git a/doc/posix-functions/write.texi b/doc/posix-functions/write.texi index 1ff902171f..e3042a5018 100644 --- a/doc/posix-functions/write.texi +++ b/doc/posix-functions/write.texi @@ -6,11 +6,19 @@ POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/fun Gnulib module: write, nonblocking, sigpipe -Portability problems fixed by Gnulib module @code{stdio}, together with module @code{nonblocking}: +Portability problems fixed by Gnulib module @code{write}: @itemize @item +This function is declared in a different header file (namely, @code{}) +on some platforms: +mingw, MSVC 14. +@item This function crashes when invoked with invalid arguments on some platforms: MSVC 14. +@end itemize + +Portability problems fixed by Gnulib module @code{stdio}, together with module @code{nonblocking}: +@itemize @item When writing to a non-blocking pipe whose buffer is full, this function fails with @code{errno} being set to @code{ENOSPC} instead of @code{EAGAIN} on some -- 2.39.5