1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
4 .\" ========================================================================
5 .de Sh \" Subsection heading
13 .de Sp \" Vertical space (when we can't use .PP)
17 .de Vb \" Begin verbatim text
22 .de Ve \" End verbatim text
26 .\" Set up some character translations and predefined strings. \*(-- will
27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28 .\" double quote, and \*(R" will give a right double quote. | will give a
29 .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30 .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
37 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
51 .\" If the F register is turned on, we'll generate index entries on stderr for
52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53 .\" entries marked with X<> in POD. Of course, you'll have to process the
54 .\" output yourself in some meaningful fashion.
57 . tm Index:\\$1\t\\n%\t"\\$2"
63 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
64 .\" way too many mistakes in technical documents.
68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69 .\" Fear. Run. Save yourself. No user-serviceable parts.
70 . \" fudge factors for nroff and troff
79 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
85 . \" simple accents for nroff and troff
95 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
102 . \" troff and (daisy-wheel) nroff accents
103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110 .ds ae a\h'-(\w'a'u*4/10)'e
111 .ds Ae A\h'-(\w'A'u*4/10)'E
112 . \" corrections for vroff
113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115 . \" for low resolution devices (crt and lpr)
116 .if \n(.H>23 .if \n(.V>19 \
129 .\" ========================================================================
131 .IX Title "Pod::Simple::Methody 3"
132 .TH Pod::Simple::Methody 3 "2008-06-03" "perl v5.8.7" "User Contributed Perl Documentation"
134 Pod::Simple::Methody \-\- turn Pod::Simple events into method calls
136 .IX Header "SYNOPSIS"
140 \& package SomePodFormatter;
141 \& use base qw(Pod::Simple::Methody);
146 \& my($self, $text) = @_;
153 \& my($self, $attrs) = @_;
162 \&...and start_/end_ methods for whatever other events you want to catch.
164 .IX Header "DESCRIPTION"
166 interest to people writing Pod formatters based on Pod::Simple.
168 This class (which is very small \*(-- read the source) overrides
169 Pod::Simple's _handle_element_start, _handle_text, and
170 _handle_element_end methods so that parser events are turned into method
171 calls. (Otherwise, this is a subclass of Pod::Simple and inherits all
174 You can use this class as the base class for a Pod formatter/processor.
176 .IX Header "METHOD CALLING"
177 When Pod::Simple sees a \*(L"=head1 Hi there\*(R", for example, it basically does
181 \& $parser\->_handle_element_start( "head1", \e%attributes );
182 \& $parser\->_handle_text( "Hi there" );
183 \& $parser\->_handle_element_end( "head1" );
186 But if you subclass Pod::Simple::Methody, it will instead do this
187 when it sees a \*(L"=head1 Hi there\*(R":
190 \& $parser\->start_head1( \e%attributes ) if $parser\->can('start_head1');
191 \& $parser\->handle_text( "Hi there" ) if $parser\->can('handle_text');
192 \& $parser\->end_head1() if $parser\->can('end_head1');
195 If Pod::Simple sends an event where the element name has a dash,
196 period, or colon, the corresponding method name will have a underscore
197 in its place. For example, \*(L"foo.bar:baz\*(R" becomes start_foo_bar_baz
200 See the source for Pod::Simple::Text for an example of using this class.
202 .IX Header "SEE ALSO"
203 Pod::Simple, Pod::Simple::Subclassing
204 .SH "COPYRIGHT AND DISCLAIMERS"
205 .IX Header "COPYRIGHT AND DISCLAIMERS"
206 Copyright (c) 2002 Sean M. Burke. All rights reserved.
208 This library is free software; you can redistribute it and/or modify it
209 under the same terms as Perl itself.
211 This program is distributed in the hope that it will be useful, but
212 without any warranty; without even the implied warranty of
213 merchantability or fitness for a particular purpose.
216 Sean M. Burke \f(CW\*(C`sburke@cpan.org\*(C'\fR