You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs-cvs@perl.apache.org by st...@apache.org on 2004/12/15 03:43:04 UTC
svn commit: r111919 - /perl/modperl/docs/trunk/src/docs/2.0/api/Apache/PerlSections.pod
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: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org