.\" -*-nroff-*-
-.TH env 3 "26 July 1999" mLib
+.TH env 3 "26 July 1999" "Straylight/Edgeware" "mLib utilities library"
.SH "NAME"
env \- efficient fiddling with environment variables
.\" @env_get
.B env_export
creates a Unix environment array from a symbol table. The environment
array is one big block of memory allocated using
-.BR malloc (3);
+.BR xmalloc (3);
hence, one call to
-.BR free (3)
+.BR xfree (3)
releases all the memory used for the pointer array and the strings.
.PP
The
character, it is assumed to be of the form
.IB n = v\fR;
the
-.I value argument is ignored, and the variable
+.I value
+argument is ignored, and the variable
.I n
is assigned the value
.IR v .
.I value
is not a null pointer, the variable
.I name
-is assigned the value
-.I value .
+is assigned
+.IR value .
Finally, if
.I value
is null, the variable
.PP
The
.B env_destroy
-function frees all the memory used by an environment symbol table. The
-table itself is destroyed too.
+function frees an environment symbol table, together with all of the
+environment variables.
.SH "SEE ALSO"
.BR sym (3),
.BR mLib (3).