File: basepods

package info (click to toggle)
pmtools 1.10%2Bds1-2
  • links: PTS, VCS
  • area: main
  • in suites: squeeze, wheezy
  • size: 188 kB
  • ctags: 14
  • sloc: perl: 505; makefile: 11
file content (63 lines) | stat: -rwxr-xr-x 1,801 bytes parent folder | download
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
#!/usr/bin/env perl
# basepods - print out the standard perl*.pod manpages pod paths

use Config;
$lib = "$Config{'installprivlib'}/pod";
opendir(LIB, $lib) || die "$0: can't opendir $lib: $!\n";
while ($_ = readdir(LIB)) { 
    print "$lib/$_\n" if /\.pod$/;
} 

__END__

=head1 NAME

basepods - print out pod paths for the standard perl manpages 

=head1 DESCRIPTION

This program uses your configuration's C<installprivlib> directory
to look up the full paths to those pod pages.  Any files in that
directory whose names end in C<.pod> will be printed to the standard
output, one per line.  This is normally used in backticks to produce
a list of filenames for other commands.

=head1 EXAMPLES

    $ podgrep typeglob `basepods`

    $ basepods | grep delt
    /usr/local/devperl/lib/5.00554/pod/perl5004delta.pod
    /usr/local/devperl/lib/5.00554/pod/perl5005delta.pod
    /usr/local/devperl/lib/5.00554/pod/perldelta.pod

You can also run this using alternate perl binaries, like so:

    $ oldperl -S basepods | grep delt
    /usr/lib/perl5/pod/perldelta.pod

    $ podgrep -i thread `filsperl basepods | grep delt`
    ....

=head1 SEE ALSO

faqpods(1), modpods(1), pods(1), sitepod(1), podpath(1), and stdpod(1).

=head1 AUTHORS and COPYRIGHTS

Copyright (C) 1999 Tom Christiansen.

Copyright (C) 2006-2008 Mark Leighton Fisher.

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".