perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject cvs commit: modperl-docs/src/docs/2.0/api/Apache PerlSections.pod
Date Mon, 09 Jun 2003 05:58:44 GMT
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: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org


Mime
View raw message