NAME

isis_fixpath - This program returns an improved path to use for an ISIS-enabled terminal.


COPYRIGHT

Copyright (C) 2005 Ross A. Beyer, rbeyer@rossbeyer.net

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 or visit their website at www.gnu.org.


SYNOPSIS

isis_fixpath [--delimiter <path_delimiter>][--version] [--help] [--man]


DESCRIPTION

This program is designed to be used after the appropriate ISIS cshrc file has been sourced. The problem is that ISIS appends its path elements to the end of the user's $PATH. This can be a real pain if your system already has programs named `mosaic', `geom', or any of the other ISIS program names. So this program reads in the user's path and returns a string with an improved $PATH order.

I use this program like so. I have an alias in my .cshrc that looks like this:

alias isis2 'source /usr/local/isis2/isis_cshrc; \ setenv PATH `isis_fixpath`'

On my system, the isis_cshrc file lives in /usr/local/isis2/, but it may be somewhere else on your system, ask your system administrator. So when you want to turn your terminal into an ISIS-enabled terminal, you type ``isis2'', and the alias first sources the isis_cshrc file which will put all of the ISIS paths at the end of your $PATH. Then the alias changes your $PATH to the output of this program (that's what the backticks around the program name mean). Depending on where you have isis_fixpath located, you may need to include the full path to the program inside those backticks.

This program will put /bin first, then any paths that potentially reside in user home directories. This assumes that users intend to override ISIS paths, use at your own risk. Then the ISIS paths, and then the rest of the user's original path.

It is highly suggested that you run this program by itself from an ISIS-enabled command line so that you can see what it will do with your path before you start setting your $PATH.


OPTIONS

--delimiter <path_delimiter>
When specified, the given string will be used as the path delimiter, both for reading the current $PATH and for outputing the juggled $PATH. If not specified, the default is to use the colon (:).

--version
Display the version number and information, and then exit.

--help
Display a short usage statement and exit.

--man
Display manual page and exit.


AUTHOR

Ross A. Beyer, rbeyer@rossbeyer.net


SEE ALSO

Integrated Software for Imagers and Spectrometers (http://isis.astrogeology.usgs.gov/)