|
|
TMAPIX 0.2 (Filter branch)
09-03-2008
|
|
Pod::Abstract::Filter(3pm) User Contributed Perl Documentation Pod::Abstract::Filter(3pm) NAME
Pod::Abstract::Filter - Generic Pod-in to Pod-out filter. DESCRIPTION
This is a superclass for filter modules using Pod::Abstract. Subclasses should override the "filter" sub. Pod::Abstract::Filter classes in the Pod::Abstract::Filter namespace will be used by the "paf" utility. To create a filter, you need to implement: filter Takes a Pod::Abstract::Node tree, and returns either another tree, or a string. If a string is returned, it will be re-parsed to be input to any following filter, or output directly if it is the last filter in the list. It is recommended your filter method produce a Node tree if you are able to, as this will improve interoperability with other "Pod::Abstract" based software. require_params If you want positional arguments following your filter in the style of: paf find [thing] Pod::Abstract then override require_params to list the named arguments that are to be accepted after the filter name. METHODS
new Create a new filter with the specified arguments. require_params Override to return a list of parameters that must be provided. This will be accepted in order on the command line, unless they are first set using the "-flag=xxx" notation. param Get the named param. Read only. filter Stub method. Does nothing, just returns the original tree. run Run the filter. If $arg is a string, it will be parsed first. Otherwise, the Abstract tree will be used. Returns either a string or an abstract tree (which may be the original tree, modified). 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(3pm)