annotate doc/posix-functions/unsetenv.texi @ 13948:4d99f06b61cd

unsetenv: Add missing declaration on OSF/1 5.1. * lib/stdlib.in.h (setenv): Test HAVE_DECL_UNSETENV, not HAVE_UNSETENV. * m4/setenv.m4 (gl_FUNC_UNSETENV): Test whether unsetenv is declared. Don't set HAVE_UNSETENV. In the test program, set _BSD. * m4/stdlib_h.m4 (gl_STDLIB_H_DEFAULTS): Initialize HAVE_DECL_UNSETENV, not HAVE_UNSETENV. * modules/stdlib (Makefile.am): Substitute HAVE_DECL_UNSETENV, not HAVE_UNSETENV. * doc/posix-functions/unsetenv.texi: Mention the OSF/1 5.1 problem.
author Bruno Haible <bruno@clisp.org>
date Sun, 19 Dec 2010 18:35:54 +0100
parents 3bbfc7e37ec2
children 1af1ed4871ed
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 @node unsetenv
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 @section @code{unsetenv}
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3 @findex unsetenv
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
13549
bb0ceefd22dc avoid some overlong lines from posix urls, etc.
Karl Berry <karl@freefriends.org>
parents: 12433
diff changeset
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/unsetenv.html}
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6
13656
bc9f00d2bbf1 unsetenv: fix OpenBSD bug
Eric Blake <eblake@redhat.com>
parents: 13549
diff changeset
7 Gnulib module: unsetenv
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 Portability problems fixed by Gnulib:
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 @itemize
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 @item
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 This function is missing on some platforms:
13891
ebdba224d075 Update for HP-UX 11.23 and HP-UX 11.31.
Bruno Haible <bruno@clisp.org>
parents: 13656
diff changeset
13 AIX 5.1, HP-UX 11.23, IRIX 6.5, Solaris 9, mingw, BeOS.
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
14 @item
13948
4d99f06b61cd unsetenv: Add missing declaration on OSF/1 5.1.
Bruno Haible <bruno@clisp.org>
parents: 13917
diff changeset
15 This function is not declared on some platforms:
4d99f06b61cd unsetenv: Add missing declaration on OSF/1 5.1.
Bruno Haible <bruno@clisp.org>
parents: 13917
diff changeset
16 OSF/1 5.1.
4d99f06b61cd unsetenv: Add missing declaration on OSF/1 5.1.
Bruno Haible <bruno@clisp.org>
parents: 13917
diff changeset
17 @item
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 This function has the return type @samp{void} instead of @samp{int} on some
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19 platforms:
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 MacOS X 10.3, FreeBSD 6.0, NetBSD 1.6, OpenBSD 3.8, OSF/1 5.1.
12300
c8288fd3f281 setenv, unsetenv: work around various bugs
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
21 @item
c8288fd3f281 setenv, unsetenv: work around various bugs
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
22 On some platforms, this function does not fail with @samp{EINVAL} when
12433
cc761de06d4f setenv: relax requirement in light of POSIX ruling
Eric Blake <ebb9@byu.net>
parents: 12413
diff changeset
23 passed an empty string or a string containing @samp{=}:
13656
bc9f00d2bbf1 unsetenv: fix OpenBSD bug
Eric Blake <eblake@redhat.com>
parents: 13549
diff changeset
24 FreeBSD 6.0, NetBSD 1.6, OpenBSD 4.7.
12413
ad699b96bf6b unsetenv: Document last workaround.
Bruno Haible <bruno@clisp.org>
parents: 12300
diff changeset
25 @item
ad699b96bf6b unsetenv: Document last workaround.
Bruno Haible <bruno@clisp.org>
parents: 12300
diff changeset
26 This function removes only the first value association for the given
ad699b96bf6b unsetenv: Document last workaround.
Bruno Haible <bruno@clisp.org>
parents: 12300
diff changeset
27 environment variable, not all of them, on some platforms:
13917
3bbfc7e37ec2 Update for Solaris 11 2010-11.
Bruno Haible <bruno@clisp.org>
parents: 13891
diff changeset
28 Solaris 11 2010-11.
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 @end itemize
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
30
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31 Portability problems not fixed by Gnulib:
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32 @itemize
12433
cc761de06d4f setenv: relax requirement in light of POSIX ruling
Eric Blake <ebb9@byu.net>
parents: 12413
diff changeset
33 @item
cc761de06d4f setenv: relax requirement in light of POSIX ruling
Eric Blake <ebb9@byu.net>
parents: 12413
diff changeset
34 Older versions of POSIX required that @code{unsetenv(NULL)} gracefully
cc761de06d4f setenv: relax requirement in light of POSIX ruling
Eric Blake <ebb9@byu.net>
parents: 12413
diff changeset
35 fail with @code{EINVAL}, but not all implementations guarantee this,
cc761de06d4f setenv: relax requirement in light of POSIX ruling
Eric Blake <ebb9@byu.net>
parents: 12413
diff changeset
36 and the requirement was removed.
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
37 @end itemize