Pod::Abstract::Filter::find - find specific nodes that contain a string.
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".
paf find -f=function YourModule
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 clear and re-nest.
<$pa-
A good example of this working as intended is:
paf find select Pod::Abstract::Node
Ben Lilburne <bnej@mac.com>
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.
To install Pod::Abstract, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Pod::Abstract
CPAN shell
perl -MCPAN -e shell install Pod::Abstract
For more information on module installation, please visit the detailed CPAN module installation guide.