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-2015  Jonathan Hogg  <me@jonathanhogg.com>

       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

SEE ALSO

       usepackage(1), csh(1), sh(1), ksh(1)