/usr/bin/pman is in pmtools 2.0.0-2.
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 89 90 91 92 93 94 | #!/usr/bin/env perl
# pman -- show a module's man page
# ------ pragmas
use strict;
use warnings;
use pmtools;
our $VERSION = '2.0.0';
# ------ define variables
my $module; # module name
my $pager; # $ENV{PAGER} - pager program
my $path; # path for pod2text
BEGIN { $^W = 1 }
BEGIN { die "usage: $0 module ...\n" unless @ARGV }
use FindBin qw($Bin);
unless ($pager = $ENV{PAGER}) {
require Config;
$pager = $Config::Config{"pager"} || "more";
}
for $module (@ARGV) {
$module =~ s#::#/#gmsx;
my $found = 0;
my $iter = pmtools::new_pod_iterator($module);
while (my $pod = $iter->()) {
if (-s $pod) {
$path = $pod;
$found++;
last;
}
}
if (!$found) {
next;
}
system "pod2text $path | $pager";
}
exit(0);
__END__
=head1 NAME
pman - show a module's man page
=head1 DESCRIPTION
Send a module's pod through pod2text and your pager.
This is mostly here for people too lazy to type
$ pod2text `pmpath CGI` | $PAGER
=head1 EXAMPLES
$ pman CGI
$ pman Curses
Or running under different versions of Perl:
$ oldperl -S pman CGI
$ filsperl -S pman Threads
=head1 SEE ALSO
pod2text(1), perlpod(1), pod2man(1), pod2html(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".
|