]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/putenv.3
Wrapped long lines, wrapped at sentence boundaries; stripped trailing
[thirdparty/man-pages.git] / man3 / putenv.3
index 041f1478c76f333e0b45f548514507a089d4cd28..8a8c22cdedc3687c6d399d9d8a6b20bb88846b41 100644 (file)
@@ -8,7 +8,7 @@
 .\" manual under the conditions for verbatim copying, provided that the
 .\" entire resulting derived work is distributed under the terms of a
 .\" permission notice identical to this one.
-.\" 
+.\"
 .\" Since the Linux kernel and libraries are constantly changing, this
 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
 .\" responsibility for errors or omissions, or for damages resulting from
@@ -16,7 +16,7 @@
 .\" have taken the same level of care in the production of this manual,
 .\" which is licensed free of charge, as they might when working
 .\" professionally.
-.\" 
+.\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
@@ -43,10 +43,12 @@ putenv \- change or add an environment variable
 .fi
 .SH DESCRIPTION
 The \fBputenv\fP() function adds or changes the value of environment
-variables.  The argument \fIstring\fP is of the form \fIname\fP=\fIvalue\fP.
-If \fIname\fP does not already exist in the environment, then 
-\fIstring\fP is added to the environment.  If \fIname\fP does exist,
-then the value of \fIname\fP in the environment is changed to 
+variables.
+The argument \fIstring\fP is of the form \fIname\fP=\fIvalue\fP.
+If \fIname\fP does not already exist in the environment, then
+\fIstring\fP is added to the environment.
+If \fIname\fP does exist,
+then the value of \fIname\fP in the environment is changed to
 \fIvalue\fP.
 The string pointed to by \fIstring\fP becomes part of the environment,
 so altering the string changes the environment.
@@ -67,7 +69,8 @@ and does not contain an `=' character, then the variable \fIname\fP
 is removed from the environment.
 If \fBputenv\fP() has to allocate a new array \fIenviron\fP,
 and the previous array was also allocated by \fBputenv\fP(),
-then it will be freed. In no case will the old storage associated
+then it will be freed.
+In no case will the old storage associated
 to the environment variable itself be freed.
 .LP
 The libc4 and libc5 and glibc 2.1.2 versions conform to SUSv2:
@@ -79,7 +82,8 @@ as the argument, then return from the calling function while \fIstring\fP
 is still part of the environment.)
 However, glibc 2.0-2.1.1 differs: a copy of the string is used.
 On the one hand this causes a memory leak, and on the other hand
-it violates SUSv2. This has been fixed in glibc2.1.2.
+it violates SUSv2.
+This has been fixed in glibc2.1.2.
 .LP
 The 4.4BSD version, like glibc 2.0, uses a copy.
 .LP