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,2008 Particle Physics and Astronomy Research Council. Copyright (C) 2009-2010 Science and Technology Facilities 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.06 Fix path separator problem on VMS (thanks to Peter Edwards)

Use Module::Build

v0.05 Fix test for CPAN testers.

v0.03 Fix volume handling (thanks to David Golden).

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.