faqpods(1p) [debian man page]

FAQPODS(1p)						User Contributed Perl Documentation					       FAQPODS(1p)

NAME

       faqpods - print out pod paths for the standard perl faqs

DESCRIPTION

       This program uses your configuration's "installprivlib" directory to look up the full paths to those pod pages.	Any files in that
       directory whose names start in "perlfaq" 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.

EXAMPLES

	   $ podgrep typeglob `faqpods`
	   ....

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

	   $ podgrep -i thread `filsperl faqpods`
	   ....

SEE ALSO

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

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

perl v5.10.1							    2010-02-22							       FAQPODS(1p)

PODGREP(1p)						User Contributed Perl Documentation					       PODGREP(1p)

NAME

       podgrep - grep in pod sections only

SYNOPSIS

       podgrep [-i] [-p] [-f] [-h] pattern [ files ... ]

DESCRIPTION

       This program searches each paragraph in a pod document and prints each paragraph that matches the supplied pattern.  This pod may be mixed
       with program code, such as in a module.

       Options are:

       -i  means case insensitive match

       -p  means page output though the user's pager.  The pager will be primed with an argument to search for the string.  This highlights the
	   result.

       -f  means format output though the pod2text program.

       -h  means check for matches in pod "=head" and "=item" headers alone, and to keep printing podagraphs until the next header is found.

EXAMPLES

	   $ podgrep mail `pmpath CGI`
	   (prints out podagraphs from the CGI.pm manpage that mention mail)

	   $ podgrep -i destructor `sitepods`
	   (prints out podagraphs that mention destructors in the
	    site-installed pods)

	   $ podgrep -i 'type.?glob' `stdpods`

	   (prints out podagraphs that mention typeglob in the
	    standard pods)

	   $ podgrep -hpfi "lock" `faqpods`

	   (prints out all podagraphs with "lock" in the headers
	   case-insensitively, then then formats these with pod2text, then
	   shows them in the pager with matches high-lighted)

	   $ podgrep -fh seek `podpath perlfunc`
	   (prints out and formats podagraphs from the standard perlfunc manpage
	   whose headers or items contain "seek".)

SEE ALSO

       faqpods(1), pfcat(1), pmpath(1), pod2text(1), podpath(1), sitepods(1), stdpods(1), and tcgrep(1).

NOTE

       For a pager, the author likes these environment settings (in the login startup, of course):

	   $ENV{PAGER} = "less";
	   $ENV{LESS}  = "MQeicsnf";

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

perl v5.10.1							    2010-02-22							       PODGREP(1p)