Author: stas Date: Tue Dec 14 18:43:02 2004 New Revision: 111919 URL: http://svn.apache.org/viewcvs?view=rev&rev=111919 Log: start using <Perl>, chances are that noone uses 2.0.47 anymore, which requried <Perl >, but in any case this is logged in the: <Perl> directive missing closing '>' entry of this manpage
Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache/PerlSections.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache/PerlSections.pod Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache/PerlSections.pod?view=diff&rev=111919&p1=perl/modperl/docs/trunk/src/docs/2.0/api/Apache/PerlSections.pod&r1=111918&p2=perl/modperl/docs/trunk/src/docs/2.0/api/Apache/PerlSections.pod&r2=111919 ============================================================================== --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache/PerlSections.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache/PerlSections.pod Tue Dec 14 18:43:02 2004 @@ -8,7 +8,7 @@ =head1 Synopsis - <Perl > + <Perl> @PerlModule = qw(Mail::Send Devel::Peek); #run the server as whoever starts it @@ -26,10 +26,10 @@ =head1 Description -With C<E<lt>Perl E<gt>>...C<E<lt>/PerlE<gt>> sections, it is possible +With C<E<lt>PerlE<gt>>...C<E<lt>/PerlE<gt>> sections, it is possible to configure your server entirely in Perl. -C<E<lt>Perl E<gt>> sections can contain I<any> and as much Perl code as +C<E<lt>PerlE<gt>> sections can contain I<any> and as much Perl code as you wish. These sections are compiled into a special package whose symbol table mod_perl can then walk and grind the names and values of Perl variables/structures through the Apache core configuration gears. @@ -67,7 +67,7 @@ To pass all environment variables to the children with a single configuration directive, rather than listing each one via C<PassEnv> -or C<PerlPassEnv>, a C<E<lt>Perl E<gt>> section could read in a file and: +or C<PerlPassEnv>, a C<E<lt>PerlE<gt>> section could read in a file and: push @PerlPassEnv, [$key => $val]; @@ -86,19 +86,19 @@ aren't I<exactly> the same (e.g. the C<ServerName> directive) it's not quite that simple. -C<E<lt>Perl E<gt>> sections come to rescue. Now you have a single +C<E<lt>PerlE<gt>> sections come to rescue. Now you have a single configuration file and the full power of Perl to tweak the local configuration. For example to solve the problem of the C<ServerName> -directive you might have this C<E<lt>Perl E<gt>> section: +directive you might have this C<E<lt>PerlE<gt>> section: - <Perl > + <Perl> $ServerName = `hostname`; </Perl> For example if you want to allow personal directories on all machines except the ones whose names start with I<secure>: - <Perl > + <Perl> $ServerName = `hostname`; if ($ServerName !~ /^secure/) { $UserDir = "public.html"; @@ -133,7 +133,7 @@ =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. +behaviour of C<E<lt>PerlE<gt>> sections. @@ -252,8 +252,8 @@ __END__ -It is important to put the call to C<dump> in it's own C<E<lt>Perl E<gt>> -section, otherwise the content of the current C<E<lt>Perl E<gt>> section +It is important to put the call to C<dump> in it's own C<E<lt>PerlE<gt>> +section, otherwise the content of the current C<E<lt>PerlE<gt>> section will not be dumped. @@ -272,7 +272,7 @@ =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 +C<E<lt>PerlE<gt>> sections. Apache::PerlSections simply being the default handler for them. To specify a different handler for a given perl section, an extra @@ -290,7 +290,7 @@ #do your thing! } -So, when that given C<E<lt>Perl E<gt>> block in encountered, the code +So, when that given C<E<lt>PerlE<gt>> block in encountered, the code within will first be evaluated, then the handler routine will be invoked with 3 arguments: @@ -315,7 +315,7 @@ $args->{'handler'} = 'My::PerlSection::Handler'; $args->{'package'} = 'Apache::ReadConfig'; -Other C<name="value"> pairs given on the C<E<lt>Perl E<gt>> line will +Other C<name="value"> pairs given on the C<E<lt>PerlE<gt>> line will also be included. =back --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
