perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From go...@apache.org
Subject cvs commit: modperl-docs/src/docs/2.0/api/Apache PerlSections.pod
Date Mon, 09 Aug 2004 00:56:46 GMT
gozer       2004/08/08 17:56:46

  Modified:    todo     release
               src/docs/2.0/api/Apache PerlSections.pod
  Log:
  The only remaining issue in this todo/release entry regarding <Perl>
  sections was that you can't write <Perl>1;</Perl> to trigger an early
  interpreter startup, for instance.
  
  This is a limitation of httpd's configuration parser and is just not
  practical to try and fix. Instead, document the absence of this feature,
  and suggest using multi-line blocks.
  
  Another worthy possibility for early interpreter startup and perl one-liners
  is to use the (currently under-documented) Perl directive in httpd.conf :
  
    Perl 1;
    Perl warn "Hello World";
  
  Revision  Changes    Path
  1.40      +0 -5      modperl-2.0/todo/release
  
  Index: release
  ===================================================================
  RCS file: /home/cvs/modperl-2.0/todo/release,v
  retrieving revision 1.39
  retrieving revision 1.40
  diff -u -r1.39 -r1.40
  --- release	7 Aug 2004 02:52:08 -0000	1.39
  +++ release	9 Aug 2004 00:56:46 -0000	1.40
  @@ -59,11 +59,6 @@
     of child_exit.
     owner: stas
   
  -* <Perl> sections:
  -  A few issues with <Perl> sections:
  -  http://marc.theaimsgroup.com/?l=apache-modperl-dev&m=106074969831522&w=2
  -  owner: gozer
  -
   * Fixing Apache->warn("foo")
   
     Report: http://mathforum.org/epigone/modperl-dev/noxtramcay/3D11A4E5.6010202@stason.org
  
  
  
  1.14      +27 -0     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.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- PerlSections.pod	16 Jul 2004 01:53:20 -0000	1.13
  +++ PerlSections.pod	9 Aug 2004 00:56:46 -0000	1.14
  @@ -334,6 +334,33 @@
   
   
   
  +=head2 E<lt>PerlE<gt>[...]> was not closed.
  +
  +On encountering a one-line E<lt>PerlE<gt> block, 
  +httpd's configuration parser will cause a startup
  +failure with an error similar to this one:
  +
  +  Starting httpd:
  +  Syntax error on line ... of /etc/httpd/conf/httpd.conf:
  +  <Perl>use> was not closed.
  +
  +If you have written a simple one-line E<lt>PerlE<gt>
  +section like this one :
  +
  +  <Perl>use Apache::DBI;</Perl>
  +
  +change it to be:
  +
  +   <Perl>
  +   use Apache::DBI;
  +   </Perl>
  +
  +This is caused by a limitation of httpd's configuration
  +parser and is not likely to be changed to allow one-line
  +block like the example above. Use multi-line blocks instead.
  +
  +
  +
   
   =head1 See Also
   
  
  
  

---------------------------------------------------------------------
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