File::SearchPath - Search for a file in a PATH-like environment variable

This module can be used to search for files (which do not have to be
executable) in a set of directories specified in a PATH-like
environment variable such as $PATH, $LD_LIBRARY_PATH (or any
environment variable).

INSTALLATION

 % perl Makefile.PL
 % make
 % make test
 % make install

REQUIREMENTS

Should work on any perl. Can use the Env::Path module if it is
present, else colon-separated path variables are assumed.

SEE ALSO

File::Which, File::Where.

AUTHOR

Tim Jenness E<lt>t.jenness@jach.hawaii.eduE<gt>

Copyright 2005,2006 Particle Physics and Astronomy Research Council.
All Rights Reserved.

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

CHANGES

v0.02   + Add compatibility with Robert Spier's File::SearchPath
          module (that was no longer on CPAN)
        + If an absolute filename is given, test it and return
          it if it passes those tests (else return undef)
        + Document returning of undef if no files are found.

V0.001  First version.
