Add ARM files
[dh-make-perl] / dev / arm / libfile-which-perl / libfile-which-perl-0.05 / debian / libfile-which-perl / usr / share / doc / libfile-which-perl / README
1 File::Which
2 ===========
3
4 File::Which is a portable implementation (in Perl) of `which', and can
5 be used to get the absolute filename of an executable program
6 installed somewhere in your PATH, or just check for its existence. It
7 includes the command-line utility `pwhich' which has the same function
8 as `which'.
9
10 INSTALLATION
11
12 To install this module type the following (on Windows, use `nmake',
13 which can be obtained freely from Microsoft: see ActivePerl
14 documentation):
15
16    $ tar zxvf File-Which-x.xx.tar.gz  (replace x.xx with the correct version number)
17    $ cd File-Which-x.xx
18    $ perl Makefile.PL
19    $ make
20    $ make test
21    $ make install
22
23 Using the CPAN shell:
24
25    $ perl -MCPAN -eshell
26    cpan> install File::Which
27    cpan> exit
28
29 TESTING
30
31 When you run `make test', File::Which will test some of its
32 functionality. It uses the t/test-bin/ directory for this, treating
33 the files below it as programs.
34
35 The tests might still be a bit shaky because there is a bit of magic
36 involved in doing this -- please report any problems you might have.
37
38 Furthermore, the files under t/test-bin/ are *not* supposed to be
39 executed: do so at your own risk. Especially, the *.exe files are not
40 valid applications as they aren't compiled and might make your system
41 crash or whatever. Execute them at your own risk. (But don't worry,
42 this package doesn't bite otherwise :)
43
44 DEPENDENCIES
45
46 This module requires these other modules and libraries:
47
48   File::Spec - distributed with perl.
49
50 COPYRIGHT AND LICENCE
51
52 Copyright (C) 2002 Per Einar Ellefsen <per.einar (at) skynet.be>
53
54 This library is free software; you can redistribute it and/or modify
55 it under the same terms as Perl itself. 
56