.\" -*-nroff-*-
-.TH env 3 "26 July 1999" mLib
+.TH env 3 "26 July 1999" "Straylight/Edgeware" "mLib utilities library"
.SH "NAME"
-env \- efficient fiddline with environment variables
+env \- efficient fiddling with environment variables
.\" @env_get
.\" @env_put
.\" @env_import
.B "#include <mLib/env.h>"
.BI "char *env_get(sym_table *" t ", const char *" name );
-.BI "void env_put(sym_table * " t ,
+.BI "void env_put(sym_table *" t ,
.BI " const char *" name ", const char *" value );
.BI "void env_import(sym_table *" t ", char **" env );
.BI "char **env_export(sym_table *" t );
.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).
.SH "AUTHOR"
-Mark Wooding, <mdw@nsict.org>
+Mark Wooding, <mdw@distorted.org.uk>