debian man page for pod::abstract::filter::find

Query: pod::abstract::filter::find

OS: debian

Section: 3pm

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

Pod::Abstract::Filter::find(3pm)			User Contributed Perl Documentation			  Pod::Abstract::Filter::find(3pm)

NAME
Pod::Abstract::Filter::find - paf command to find specific nodes that contain a string.
DESCRIPTION
The intention of this filter is to allow a reduction of large Pod documents to find a specific function or method. You call "paf find -f=function YourModule", and you get a small subset of nodes matching "function". For this to work, there has to be some assumptions about Pod structure. I am presuming that find is not useful if it returns anything higher than a head2, so as long as your module wraps function doco in a head2, head3, head4 or list item, we're fine. If you use head1 then it won't be useful. In order to be useful as an end user tool, head1 nodes (...) are added between the found nodes. This stops perldoc from dying with no documentation. These can be easily stripped using: "$pa->select('/head1')", then hoist and detach, or reparent to other Node types. A good example of this working as intended is: paf find select Pod::Abstract::Node
AUTHOR
Ben Lilburne <bnej@mac.com>
COPYRIGHT AND LICENSE
Copyright (C) 2009 Ben Lilburne This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.10.1 2010-01-03 Pod::Abstract::Filter::find(3pm)
Related Man Pages
pod::abstract(3pm) - debian
pod::abstract::buildnode(3pm) - debian
pod::abstract::filter::find(3pm) - debian
pod::abstract::node(3pm) - debian
pod::coverage::trustpod(3pm) - debian
Similar Topics in the Unix Linux Community
find command
Need find a file based length
Can't figure out how to find specific characters in specific columns
Replace string and create new file multiple times
Weird 'find' results