svn commit: r111932 - /perl/modperl/docs/trunk/src/docs/2.0/user/config/config.pod

[st...@apache.org]

Author: stas
Date: Tue Dec 14 20:01:36 2004
New Revision: 111932

URL: http://svn.apache.org/viewcvs?view=rev&rev=111932
Log:
new section: C<=pod>, C<=over> and C<=cut>

Modified:
   perl/modperl/docs/trunk/src/docs/2.0/user/config/config.pod

Modified: perl/modperl/docs/trunk/src/docs/2.0/user/config/config.pod
Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/config/config.pod?view=diff&rev=111932&p1=perl/modperl/docs/trunk/src/docs/2.0/user/config/config.pod&r1=111931&p2=perl/modperl/docs/trunk/src/docs/2.0/user/config/config.pod&r2=111932
==============================================================================
--- perl/modperl/docs/trunk/src/docs/2.0/user/config/config.pod	(original)
+++ perl/modperl/docs/trunk/src/docs/2.0/user/config/config.pod	Tue Dec 14 20:01:36 2004
@@ -203,6 +203,55 @@
 
 
 
+
+=head2 C<=pod>, C<=over> and C<=cut>
+
+It's known that anything written between tokens C<=pod> and C<=cut> is
+ignored by the Perl parser. mod_perl allows you to use the same
+technique to make Apache ignore things in F<httpd.conf> (similar to #
+comments). With an exception to C<=over apache> and C<=over httpd>
+sections which are visible to Apache.
+
+For example the following configuration:
+
+  #file: httpd.conf
+  =pod
+  
+  PerlSetVar A 1
+  
+  =over apache
+  
+  PerlSetVar B 2
+  
+  =back
+  
+  PerlSetVar C 3
+  
+  =cut
+  
+  PerlSetVar D 4
+
+
+Apache will see:
+
+  PerlSetVar B 2
+  PerlSetVar D 4
+
+but not:
+
+  PerlSetVar A 1
+  PerlSetVar C 3
+
+C<=over httpd> is just an alias to C<=over apache>. Remember that
+C<=over> requires a corresponding C<=back>.
+
+
+
+
+
+
+
+
 =head2 C<PerlAddVar>
 
   META: to be written

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org