USE(1)
NAME
use - Frontend to the Usepackage Environment Manager
SYNOPSIS
csh and derivatives: source /usr/share/usepackage/use.csh bourne shell and derivatives: source /usr/share/usepackage/use.bsh korn shell: . /usr/share/usepackage/use.ksh use [-vs] [-f file] package ... use -l
DESCRIPTION
Usepackage is an environment management program. It is based on the
principle of packages - collections of executables that share a common
set of necessary environment variables, such as PATH, MANPATH or
LD_LIBRARY_PATH.
- For each given package, use sources the appropriate environment information into the current shell. The environment information is specified in a configuration file, see usepackage(1).
- OPTIONS
- -v Output verbose information to the standard error stream.
- -s Silence warnings for un-matched packages. This is useful in a
shell rc script when a package is known not to be available on all architectures that the shell is used on.
- -f file
Specify an alternate initial configuration file.
- -l List available packages and groups.
FILES
- /usr/share/usepackage/usepackage.conf
- The default configuration file.
- /usr/share/usepackage/use.csh
- Shell setup for csh and derivatives.
- /usr/share/usepackage/use.bsh
- Shell setup for bourne shell and derivatives.
- /usr/share/usepackage/use.ksh
- Shell setup for ksh.
- /usr/bin/usepackage
- The underlying Usepackage executable.
ENVIRONMENT
Other than the reading and re-definition of environment variables for
package setup, use also uses the following environment variables for
user configuration:
- PACKAGES_PATH Colon-separated path list giving the directories to
- search for configuration files. Shell-style tilde (~) user-directory escapes are expanded.
- HOME If present in the environment, this is used to provide
- the expansion for the tilde (~) user-directory.
- SHELL If present in the environment, the last path component
- of this is used for shell matching (see SYNTAX) and detecting the style of environment output that should be used, see usepackage(1).
COPYRIGHT
Usepackage Environment Manager
Copyright (C) 1995-2005 Jonathan Hogg
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA