From: Bruno Haible Date: Fri, 17 May 2024 09:36:47 +0000 (+0200) Subject: putenv-gnu: Update documentation. X-Git-Url: https://gitweb.git.savannah.gnu.org/gitweb/?a=commitdiff_plain;h=2deaf1ffc8d7e1dc22cc4337166c3527679694c8;p=gnulib.git putenv-gnu: Update documentation. * doc/posix-functions/putenv.texi: Refer also to the glibc documentation. Use the usual doc structure. --- diff --git a/ChangeLog b/ChangeLog index 7a08db245c..8c78faa410 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2024-05-17 Bruno Haible + + putenv-gnu: Update documentation. + * doc/posix-functions/putenv.texi: Refer also to the glibc + documentation. Use the usual doc structure. + 2024-05-17 Collin Funk doc: Update outdated module name. diff --git a/doc/posix-functions/putenv.texi b/doc/posix-functions/putenv.texi index ff06ea5062..87fc2f295c 100644 --- a/doc/posix-functions/putenv.texi +++ b/doc/posix-functions/putenv.texi @@ -2,18 +2,32 @@ @section @code{putenv} @findex putenv -POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/putenv.html} +POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/putenv.html}, +amended through @url{https://www.austingroupbugs.net/view.php?id=1598}. + +Documentation:@* +@ifinfo +@ref{Environment Access,,Environment Access,libc}. +@end ifinfo +@ifnotinfo +@url{https://www.gnu.org/software/libc/manual/html_node/Environment-Access.html}. +@end ifnotinfo + +Note: POSIX @code{putenv} supports +adding or changing the value of an environment variable, +while glibc also supports removing an environment variable +(as if by @code{unsetenv}). Gnulib module: putenv-gnu Portability problems fixed by Gnulib: @itemize +@item +This function does not support removing an environment variable +on some platforms: +macOS 12.5, FreeBSD 14.0, NetBSD 10.0, OpenBSD 7.5, AIX 7.3.1, HP-UX 11.31, Solaris 11.4, mingw, MSVC 14, Android 11.0. @end itemize Portability problems not fixed by Gnulib: @itemize @end itemize - -Extension: Gnulib provides a module @samp{putenv-gnu} that substitutes a -@code{putenv} implementation that can also be used to remove environment -variables.