Mailing List Archive: Patch to clarify need for space in ""

Patch to clarify need for space in "<Perl >"

Oct 8, 2003, 10:19 AM

Post #1 of 3 (2534 views)

Hi -

Appending patches for 2 files related to this issue:

> > Starting httpd: Syntax error on line 1110 of /etc/httpd/conf/httpd.conf:
> > <Perl> directive missing closing '>' [FAILED]
>
> It should be <Perl > in mp2.
> ^
> space

Larry Leszczynski
larryl@furph.com

-----
Index: PerlSections.pod
===================================================================
RCS
file: /home/cvspublic/modperl-docs/src/docs/2.0/api/Apache/PerlSections.pod,v
retrieving revision 1.5
diff -u -r1.5 PerlSections.pod
--- PerlSections.pod 9 Jun 2003 06:07:25 -0000 1.5
+++ PerlSections.pod 8 Oct 2003 17:10:19 -0000
@@ -20,6 +20,10 @@
With C<E<lt>Perl E<gt>>...C<E<lt>/PerlE<gt>> sections, it is possible
to configure your server entirely in Perl.

+B<Note:> There is a known limitation in Apache 2.0 that requires you
+to include a trailing space in the opening tag of the Perl section.
+I.e. you must use C<E<lt>Perl E<gt>> instead of C<E<lt>PerlE<gt>>.
+
C<E<lt>Perl E<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
@@ -28,7 +32,7 @@
Block sections such as C<E<lt>LocationE<gt>>..C<E<lt>/LocationE<gt>>
are represented in a C<%Location> hash, e.g.:

- <Perl>
+ <Perl >

$Location{"/~dougm/"} = {
AuthUserFile => '/tmp/htpasswd',
-----
Index: config.pod
===================================================================
RCS
file: /home/cvspublic/modperl-docs/src/docs/2.0/user/config/config.pod,v
retrieving revision 1.45
diff -u -r1.45 config.pod
--- config.pod 8 Oct 2003 15:16:47 -0000 1.45
+++ config.pod 8 Oct 2003 17:15:57 -0000
@@ -163,10 +163,13 @@

META: to be written

-=head2 C<E<lt>PerlE<gt>> Sections
+=head2 C<E<lt>Perl E<gt>> Sections

- META: to be written. probably needs a dedicated chapter.
+With C<E<lt>Perl E<gt>>...C<E<lt>/PerlE<gt>> sections, it is possible
+to configure your server entirely in Perl.

+Please refer to the
+L<Apache::PerlSections|docs::2.0::api::Apache::PerlSections> manpage

=head2 C<PerlSwitches>

@@ -488,7 +491,7 @@

Suppose one of the hosts does not want to allow users to configure
C<PerlAuthenHandler>, C<PerlAuthzHandler>, C<PerlAccessHandler> and
-E<lt>PerlE<gt> sections:
+E<lt>Perl E<gt> sections:

<VirtualHost ...>
PerlOptions -Authen -Authz -Access -Sections
@@ -966,7 +969,7 @@
PerlAddVar ITERATE2 DIR
PerlSetEnv TAKE2 DIR
PerlPassEnv TAKE1 SRV
- <Perl> Sections RAW_ARGS SRV
+ <Perl > Sections RAW_ARGS SRV
PerlTrace TAKE1 SRV

Handler assignment directives:
-----

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

Re: Patch to clarify need for space in "<Perl >" [ In reply to ]

stas at stason

Oct 8, 2003, 10:10 PM

Post #2 of 3 (2388 views)

Permalink

Larry Leszczynski wrote:
> Hi -
>
> Appending patches for 2 files related to this issue:
>
>
>>>Starting httpd: Syntax error on line 1110 of /etc/httpd/conf/httpd.conf:
>>><Perl> directive missing closing '>' [FAILED]
>>
>>It should be <Perl > in mp2.
>> ^
>> space
>
>

Thanks Larry.

I'll hold off on committing this patch, as Philippe has submitted a patch to
httpd-dev that makes the old behavior possible. So if his patch is committed,
we will only add a note "that for httpd version < foo, you need to use <Perl
>" and keep the rest of the docs untouched. We are waiting for the feedback.

__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com

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

Re: Patch to clarify need for space in "<Perl >" [ In reply to ]

stas at stason

Oct 13, 2003, 8:48 PM

Post #3 of 3 (2392 views)

Permalink

Stas Bekman wrote:
> Larry Leszczynski wrote:
>
>> Hi -
>>
>> Appending patches for 2 files related to this issue:
>>
>>
>>>> Starting httpd: Syntax error on line 1110 of
>>>> /etc/httpd/conf/httpd.conf:
>>>> <Perl> directive missing closing '>' [FAILED]
>>>
>>>
>>> It should be <Perl > in mp2.
>>> ^
>>> space
>>
>>
>>
>
> Thanks Larry.
>
> I'll hold off on committing this patch, as Philippe has submitted a
> patch to httpd-dev that makes the old behavior possible. So if his patch
> is committed, we will only add a note "that for httpd version < foo,
> you need to use <Perl >" and keep the rest of the docs untouched. We are
> waiting for the feedback.

The patch is now in the stable httpd-2.0 tree. So it should be included with
2.0.48 or the latest 2.0.49. I'll update the docs.

__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com

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