stas 2003/06/08 22:58:44
Modified: src/docs/2.0/api/Apache PerlSections.pod
Log:
paras need to be wrapped < 74
Revision Changes Path
1.2 +33 -25 modperl-docs/src/docs/2.0/api/Apache/PerlSections.pod
Index: PerlSections.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/PerlSections.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- PerlSections.pod 9 Jun 2003 05:06:34 -0000 1.1
+++ PerlSections.pod 9 Jun 2003 05:58:44 -0000 1.2
@@ -101,29 +101,32 @@
=head1 Configuration Variables
-There are a few variables that can be set to change the default behaviour of
C<E<lt>Perl
-E<gt>> sections.
+There are a few variables that can be set to change the default
+behaviour of C<E<lt>Perl E<gt>> sections.
=head2 C<$Apache::Server::SaveConfig>
-By default, the namespace in which C<E<lt>Perl E<gt>> sections are evaluated
is cleared after
-each block closes. By setting it to a true value, the content of those
namespaces will be preserved
-and will be available for inspection by modules like L<Apache::Status>
+By default, the namespace in which C<E<lt>Perl E<gt>> sections are
+evaluated is cleared after each block closes. By setting it to a true
+value, the content of those namespaces will be preserved and will be
+available for inspection by modules like L<Apache::Status>
=head2 C<$Apache::Server::StrictPerlSections>
-By default, compilation and run-time errors within C<E<lt>Perl E<gt>>
sections will cause a warning
-to be printed in the error_log. By setting this variable to a true value,
code in the sections will
-be evaluated as if "use strict" was in usage, and all warning and errors
will cause the server to
-abort startup and report the first error.
+By default, compilation and run-time errors within C<E<lt>Perl E<gt>>
+sections will cause a warning to be printed in the error_log. By
+setting this variable to a true value, code in the sections will be
+evaluated as if "use strict" was in usage, and all warning and errors
+will cause the server to abort startup and report the first error.
=head1 Advanced API
-mod_perl 2.0 now introduces the same general concept of handlers to
C<E<lt>Perl E<gt>> sections.
-Apache::PerlSections simply being the default handler for them.
+mod_perl 2.0 now introduces the same general concept of handlers to
+C<E<lt>Perl E<gt>> sections. Apache::PerlSections simply being the
+default handler for them.
-To specify a different handler for a given perl section, an extra handler
argument must be given to
-the section:
+To specify a different handler for a given perl section, an extra
+handler argument must be given to the section:
<Perl handler="My::PerlSection::Handler" somearg="test1">
$foo = 1;
@@ -137,31 +140,36 @@
#do your thing!
}
-So, when that given C<E<lt>Perl E<gt>> block in encountered, the code within
will first be evaluated, then
-the handler routine will be invoked with 3 arguments
+So, when that given C<E<lt>Perl E<gt>> block in encountered, the code
+within will first be evaluated, then the handler routine will be
+invoked with 3 arguments
C<$self> is self-explanatory
-C<$parms> is the L<Apache::CmdParms> for this Container, for example, you
might want to call C<$parms>-E<gt>server()
-to get the current server.
+C<$parms> is the L<Apache::CmdParms> for this Container, for example,
+you might want to call C<$parms>-E<gt>server() to get the current
+server.
-C<$args> is a L<APR::Table> of the section arguments, the 2 guaranteed ones
will be:
+C<$args> is a L<APR::Table> of the section arguments, the 2 guaranteed
+ones will be:
$args->{'handler'} = 'My::PerlSection::Handler';
$args->{'package'} = 'Apache::ReadConfig';
-Other name="value" pairs given on the C<E<lt>Perl E<gt>> line will also be
included.
+Other C<name="value"> pairs given on the C<E<lt>Perl E<gt>> line will
+also be included.
-At this point, it's up to the handler routing to inspect the namespace of
the C<$args>-E<gt>{'package'} and
-chooses what to do.
+At this point, it's up to the handler routing to inspect the namespace
+of the C<$args>-E<gt>{'package'} and chooses what to do.
-The most likely thing to do is to feed configuration data back into apache.
To do that, use
-Apache::Server-E<gt>add_config("directive"), for example:
+The most likely thing to do is to feed configuration data back into
+apache. To do that, use Apache::Server-E<gt>add_config("directive"),
+for example:
$parms->server->add_config("Alias /foo /bar");
-Would create a new alias. The source code of L<Apache::PerlSections> is a
good place to look for a practical
-example.
+Would create a new alias. The source code of L<Apache::PerlSections>
+is a good place to look for a practical example.
=cut
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
