/usr/bin/podpath is in pmtools 2.0.0-1.
This file is owned by root:root, with mode 0o755.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 | #!/usr/bin/env perl
# podpath - print the path to the Pod
# ------ pragmas
use strict;
use warnings;
use pmtools;
our $VERSION = '2.0.0';
for my $module (@ARGV) {
if ( $module =~ /^perl/ ) {
system("$^X -S stdpods | grep $module");
} else {
$module =~ s#::#/#gmsx;
my $found = 0;
my $pod_iter = pmtools::new_pod_iterator($module);
while (my $pod_file = $pod_iter->()) {
if (-s $pod_file) {
print "$pod_file\n";
$found++;
last;
}
}
if (!$found) {
print STDERR "$0: Can't locate $module.pm or $module.pod "
. "in \@INC (\@INC contains: " . join(' ', @INC) . ")\n";
}
}
}
__END__
=head1 NAME
podpath - print the path to the Pod
=head1 DESCRIPTION
podpath prints the path to the Pod. podpath calls stdpods underneath
if the Pod name includes 'perl'. Otherwise, it searches down
@INC, printing the '.pod' filename if there is a separate Pod
file, otherwise printing the 'pm' filename. This accommodates
systems where the Pod lives in a separate file from the module file.
=head1 EXAMPLES
$ podpath Cwd
/usr/local/devperl/lib/5.00554/Cwd.pm
It works with alternate installations, too:
$ devperl -S podpath perlfunc
/usr/local/devperl/lib/5.00554/pod/perlfunc.pod
$ oldperl -S podpath IO::Handle
/usr/lib/perl5/i386-linux/5.00404/IO/Handle.pm
$ filsperl -S podpath Thread
/usr/local/filsperl/lib/5.00554/i686-linux-thread/Thread.pm
=head1 SEE ALSO
stdpods(1),
pmpath(1),
perlmodlib(1).
=head1 AUTHORS and COPYRIGHTS
Copyright (C) 1999 Tom Christiansen.
Copyright (C) 2006-2014 Mark Leighton Fisher.
=head1 LICENSE
This is free software; you can redistribute it and/or modify it
under the terms of either:
(a) the GNU General Public License as published by the Free
Software Foundation; either version 1, or (at your option) any
later version, or
(b) the Perl "Artistic License".
(This is the Perl 5 licensing scheme.)
Please note this is a change from the
original pmtools-1.00 (still available on CPAN),
as pmtools-1.00 were licensed only under the
Perl "Artistic License".
|