The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

pfcat - grep out function definitions from perlfunc

DESCRIPTION

This program uses podgrep program to search your configuration's perlfunc for function definitions. It honors a -f flag to format through pod2text and a -p flag to send the output through the pager. (Actually, it just passes these to podgrep.)

EXAMPLES

$ pfcat seek
(find all seek functions (including sysseek))

$ pfcat -pf sprintf
(sprintf function is formated and sent to pager)

$ pfcat -f '\bint\b'
/usr/local/devperl/lib/5.00554/pod/perlfunc.pod chunk 506
int EXPR
int

Returns the integer portion of EXPR. If EXPR is omitted, uses
`$_'. You should not use this for rounding, because it truncates
towards `0', and because machine representations of floating point
numbers can sometimes produce counterintuitive results. Usually
`sprintf()' or `printf()', or the `POSIX::floor' or `POSIX::ceil'
functions, would serve you better.

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

$ oldperl -S pfcat open
....

SEE ALSO

podgrep(1)

AUTHORS and COPYRIGHTS

Copyright (C) 1999 Tom Christiansen.

Copyright (C) 2006-2014 Mark Leighton Fisher.

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