'\"macro stdmacro
.if n .pH g1.olsetvar @(#)olsetvar	40.3 of 1/9/90
.nr X
.if \nX=0 .ds x} OLSETVAR 1 "12/1/89" "OPEN LOOK 2.0" "\&"
.if \nX=1 .ds x} OLSETVAR 1 "12/1/89" "OPEN LOOK 2.0"
.if \nX=2 .ds x} OLSETVAR 1 "" "\&"
.if \nX=3 .ds x} OLSETVAR "" "" "\&"
.TH \*(x}
.tr ~
.IX applications supported, olsetvar
.IX \f2olsetvar\f1 command
.nr % 1
.SH NAME
olsetvar - sets a shell variable to a value in the 
user's \f2$HOME/.olsetup\f1 file.
.SH SYNOPSIS
.B olsetvar 
- variable value [user]
.tr ~~
.SH DESCRIPTION
The
\f2olsetvar\f1 program
edits the file \f2\~user/.olsetup\f1 (\~user refers to the home
directory of the user \f2user\f1) to add a shell assignment
statement with the variable \f2variable\f1 to the value
\f2value\f1. The variable is exported as well so that programs
that shell \f2.olsetup\f1 will have these new variables set in
their respective environments. If a user is not specified
through \f2user, $HOME\f1 is the home directory used. This
command is used by the OPEN LOOK workspace manager to assign
the variable \f2OLINVOKE\f1 a value and it is used by the
command \f2oladduser\f1 to set up other variables. 
.P
If the name of the login ID is not the same as the $HOME
variable, the user should invoke \f2olsetvar\f1 with the
login ID on the command line.
.P
\f2olsetvar\f1
will ensure that no duplicate entries of variable assignments
are made. 
If a value already exists for the specified variable,
\f2olsetvar\f1
will reset this value to the new value.
\f2olsetvar\f1
will write an error message on standard error and exit if the
\f2\~user/.olsetup\f1 does not exist, if the \f2user\f1 does
not exist, or if write permissions are not granted on the
user's \f2\~user/.olsetup\f1 file.
.SH EXAMPLES
.TP 30
.B olsetvar OLINVOKE yes usera
.TP 30
.B olsetvar PATH '$PATH:/usr/X/bin'
.SH FILES
$HOME/.olsetup
.SH "SEE ALSO"
oladduser(1), olunsetvar(1)
