svn commit: r161023 - perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod
Author: gozer Date: Mon Apr 11 23:21:45 2005 New Revision: 161023 URL: http://svn.apache.org/viewcvs?view=revrev=161023 Log: tyop Modified: perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod?view=diffr1=161022r2=161023 == --- perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod Mon Apr 11 23:21:45 2005 @@ -355,7 +355,7 @@ MP_AP_PREFIX=$HOME/src/httpd-2.x \ MP_AP_CONFIGURE=--with-mpm=prefork -CLMP_AP_PREFIX|/MP_AP_PREFIX Bmust point to an extrated Apache +CLMP_AP_PREFIX|/MP_AP_PREFIX Bmust point to an extracted Apache 2.0 source tree. This will configure Apache by passing CLMP_AP_CONFIGURE|/MP_AP_CONFIGURE - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r149231 - perl/modperl/docs/trunk/src/docs/2.0/user/config/config.pod
Author: gozer Date: Sun Jan 30 23:01:10 2005 New Revision: 149231 URL: http://svn.apache.org/viewcvs?view=revrev=149231 Log: Added ARGS_HOW information for PerlConfigRequire and PerlPostConfigRequire 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=diffr1=149230r2=149231 == --- 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 Sun Jan 30 23:01:10 2005 @@ -1323,6 +1323,8 @@ PerlSwitches ITERATESRV PerlRequire ITERATESRV + PerlConfigRequireITERATESRV + PerlPostConfigRequireITERATESRC PerlModule ITERATESRV PerlLoadModule RAW_ARGS SRV PerlOptions ITERATEDIR - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r126024 - /perl/modperl/docs/trunk/src/download/index_top.html
Author: gozer Date: Sat Jan 22 00:50:03 2005 New Revision: 126024 URL: http://svn.apache.org/viewcvs?view=revrev=126024 Log: Releasing 2.0.0-RC4 Modified: perl/modperl/docs/trunk/src/download/index_top.html Modified: perl/modperl/docs/trunk/src/download/index_top.html Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/download/index_top.html?view=diffrev=126024p1=perl/modperl/docs/trunk/src/download/index_top.htmlr1=126023p2=perl/modperl/docs/trunk/src/download/index_top.htmlr2=126024 == --- perl/modperl/docs/trunk/src/download/index_top.html (original) +++ perl/modperl/docs/trunk/src/download/index_top.html Sat Jan 22 00:50:03 2005 @@ -14,7 +14,7 @@ brbr /li -limod_perl 2.0 (in development): Version 2.0.0-RC3 - Jan 5, 2005br +limod_perl 2.0 (in development): Version 2.0.0-RC4 - Jan 22, 2005br a href=http://perl.apache.org/dist/mod_perl-2.0-current.tar.gz;Download/a | a href=http://perl.apache.org/dist/mod_perl-2.0-current;Browse/a | a href=http://perl.apache.org/dist/mod_perl-2.0-current/Changes;Changes/a | - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r125318 - /perl/modperl/docs/trunk/src/help/irc.pod
Author: gozer Date: Sat Jan 15 15:35:49 2005 New Revision: 125318 URL: http://svn.apache.org/viewcvs?view=revrev=125318 Log: Point out irc.perl.org as an alternative to irc.rhizomatic.net Modified: perl/modperl/docs/trunk/src/help/irc.pod Modified: perl/modperl/docs/trunk/src/help/irc.pod Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/help/irc.pod?view=diffrev=125318p1=perl/modperl/docs/trunk/src/help/irc.podr1=125317p2=perl/modperl/docs/trunk/src/help/irc.podr2=125318 == --- perl/modperl/docs/trunk/src/help/irc.pod(original) +++ perl/modperl/docs/trunk/src/help/irc.podSat Jan 15 15:35:49 2005 @@ -10,9 +10,9 @@ =head1 The IRC Channel -Although there is nothing official about, mod_perl people usually -hang out on the Iirc.rhizomatic.net IRC server (on port 6667), on -the channel I#modperl. +Although there is nothing official about it, mod_perl people usually +hang out on the Iirc.perl.org or Iirc.rhizomatic.net IRC servers +(on port 6667), in the channel I#modperl. You might also want to check in at the I#axkit-dahut channel where many mod_perl people hang out for non-serious talk, and the I#axkit - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r124335 - /perl/modperl/docs/trunk/src/download/index_top.html
Author: gozer Date: Wed Jan 5 17:23:26 2005 New Revision: 124335 URL: http://svn.apache.org/viewcvs?view=revrev=124335 Log: Releasing 2.0.0-RC3 Modified: perl/modperl/docs/trunk/src/download/index_top.html Modified: perl/modperl/docs/trunk/src/download/index_top.html Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/download/index_top.html?view=diffrev=124335p1=perl/modperl/docs/trunk/src/download/index_top.htmlr1=124334p2=perl/modperl/docs/trunk/src/download/index_top.htmlr2=124335 == --- perl/modperl/docs/trunk/src/download/index_top.html (original) +++ perl/modperl/docs/trunk/src/download/index_top.html Wed Jan 5 17:23:26 2005 @@ -14,7 +14,7 @@ brbr /li -limod_perl 2.0 (in development): Version 2.0.0-RC2 (Christmas Special: 90% off) - Dec 23, 2004br +limod_perl 2.0 (in development): Version 2.0.0-RC3 - Jan 5, 2005br a href=http://perl.apache.org/dist/mod_perl-2.0-current.tar.gz;Download/a | a href=http://perl.apache.org/dist/mod_perl-2.0-current;Browse/a | a href=http://perl.apache.org/dist/mod_perl-2.0-current/Changes;Changes/a | - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r123147 - /perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod
Author: gozer Date: Wed Dec 22 15:02:37 2004 New Revision: 123147 URL: http://svn.apache.org/viewcvs?view=revrev=123147 Log: Static build with a Perl without ithreads and a non-threaded MPM would segfault on startup. Caused by a bug in perl's perl_shutdown() code. Fixed in Perl 5.8.2, so it's now a build requirement Modified: perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod?view=diffrev=123147p1=perl/modperl/docs/trunk/src/docs/2.0/user/install/install.podr1=123146p2=perl/modperl/docs/trunk/src/docs/2.0/user/install/install.podr2=123147 == --- perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/install/install.pod Wed Dec 22 15:02:37 2004 @@ -66,6 +66,16 @@ Ithreads.pm Perl version 5.8.1 or higher w/ithreads enabled is required. Perl 5.8.0's Ithreads.pm doesn't work with mod_perl 2.0. +=item Static prefork build + +Perl with ithreads support version 5.6.1 or higher + +Perl without ithreads support version 5.8.2 or higher + +=item Static non-prefork build + +Perl with ithreads support version 5.8.0 or higher + =back =item * CPAN Perl Modules - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r123149 - /perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod
Author: gozer Date: Wed Dec 22 15:17:37 2004 New Revision: 123149 URL: http://svn.apache.org/viewcvs?view=revrev=123149 Log: $r-hostname is now writable Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod?view=diffrev=123149p1=perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.podr1=123148p2=perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.podr2=123149 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod Wed Dec 22 15:17:37 2004 @@ -815,13 +815,21 @@ Host, as set by full URI or Host: $hostname = $r-hostname(); + $prev_hostname = $r-hostname($new_hostname); =over 4 =item obj: C$r ( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec ) +=item opt arg1: C$new_hostname ( string ) + +new value + =item ret: C$hostname ( string ) + +the current hostname, or the previous value if the optionnal +C$new_hostname argument was passed =item since: 1.99_12 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r123151 - /perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod
Author: gozer Date: Wed Dec 22 15:22:14 2004 New Revision: 123151 URL: http://svn.apache.org/viewcvs?view=revrev=123151 Log: Forgot to bump since: for $r-hostname change Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod?view=diffrev=123151p1=perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.podr1=123150p2=perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.podr2=123151 == --- perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestRec.pod Wed Dec 22 15:22:14 2004 @@ -831,7 +831,7 @@ the current hostname, or the previous value if the optionnal C$new_hostname argument was passed -=item since: 1.99_12 +=item since: 1.99_19 =back - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r122678 - /perl/modperl/docs/trunk/src/docs/2.0/user/config/config.pod
Author: gozer Date: Fri Dec 17 13:15:22 2004 New Revision: 122678 URL: http://svn.apache.org/viewcvs?view=revrev=122678 Log: New configuration directives - PerlConfigRequire Just like PerlRequire, but _always_ triggers an immediate interpreter startup - PerlPostConfigRequire A delayed form of PerlRequire, that waits until the post_config phase before require'ing files 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=diffrev=122678p1=perl/modperl/docs/trunk/src/docs/2.0/user/config/config.podr1=122677p2=perl/modperl/docs/trunk/src/docs/2.0/user/config/config.podr2=122678 == --- 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 Fri Dec 17 13:15:22 2004 @@ -681,6 +681,52 @@ +=head2 CPerlConfigRequire + + PerlConfigRequire Foo/Bar.pm + +is equivalent to Perl's: + + require Foo/Bar.pm; + +CPerlConfigRequire is used to load files with Perl code. + +It is very similar to CLPerlRequire|/C_PerlRequire_ +with the only difference being that Perl startup is not +Ldelayed|/Startup_Process and will be immediately started +upon encountering this directive. + +META: need to expand on this with examples and suggested usages + + + + + + +=head2 CPerlPostConfigRequire + + PerlPostConfigRequire Foo/Bar.pm + +is equivalent to Perl's: + + require Foo/Bar.pm; + +CPerlPostConfigRequire is used to load files with Perl code +as late as possible during server startup. + +It is very similar to CLPerlRequire|/C_PerlRequire_ and +CLPerlConfigRequire|/C_PerlConfigRequire_. + +CPerlPostConfigRequire delays loading of the file until +the last possible moment before the server is starting, in +the post_config phase. + +META: need to expand on this with examples and suggested usages + + + + + =head2 CPerlSetEnv - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r112031 - /perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod
Author: gozer
Date: Wed Dec 15 14:11:52 2004
New Revision: 112031
URL: http://svn.apache.org/viewcvs?view=revrev=112031
Log:
Use fully-qualified links for external documentation references.
Modified:
perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod
Modified: perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod
Url:
http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod?view=diffrev=112031p1=perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.podr1=112030p2=perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.podr2=112031
==
--- perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod (original)
+++ perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod Wed Dec 15
14:11:52 2004
@@ -674,8 +674,8 @@
To retrieve the contents of a custom container directive, use the
CLApache::Directive object's methods
-CLas_hash|Apache::Directive/C_as_hash_
-or CLas_string|Apache::Directive/C_as_string_ :
+CLas_hash|docs::2.0::api::Apache::Directive/C_as_hash_
+or CLas_string|docs::2.0::api::Apache::Directive/C_as_string_ :
sub MyParameter {
my($self, $parms, $val) = @_;
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r112036 - /perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod
Author: gozer Date: Wed Dec 15 14:23:50 2004 New Revision: 112036 URL: http://svn.apache.org/viewcvs?view=revrev=112036 Log: Changed one more relative link into a fully-qualified one. Spotted-by: stas Modified: perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod Modified: perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod?view=diffrev=112036p1=perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.podr1=112035p2=perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.podr2=112036 == --- perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod (original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod Wed Dec 15 14:23:50 2004 @@ -673,7 +673,7 @@ META: complete the details, which are new to 2.0. To retrieve the contents of a custom container directive, use the -CLApache::Directive object's methods +CLApache::Directive|docs::2.0::api::Apache::Directive object's methods CLas_hash|docs::2.0::api::Apache::Directive/C_as_hash_ or CLas_string|docs::2.0::api::Apache::Directive/C_as_string_ : - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r111875 - /perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod
Author: gozer
Date: Tue Dec 14 13:01:22 2004
New Revision: 111875
URL: http://svn.apache.org/viewcvs?view=revrev=111875
Log:
Give an example of how to get at the contents of a custom configuration
container directive using Apache::Directive::(as_string|as_hash)
Modified:
perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod
Modified: perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod
Url:
http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod?view=diffrev=111875p1=perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.podr1=111874p2=perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.podr2=111875
==
--- perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod (original)
+++ perl/modperl/docs/trunk/src/docs/2.0/user/config/custom.pod Tue Dec 14
13:01:22 2004
@@ -656,7 +656,8 @@
This callback receives three arguments (similar to
CLApache::TAKE1|/C_Apache__TAKE1_), the third of which is a
-string-valued scalar containing the text following the directive.
+string-valued scalar containing the remaining text following the
+directive line.
sub MyParameter {
my($self, $parms, $val) = @_;
@@ -670,6 +671,17 @@
req_override = Apache::OR_ALL | Apache::OR_EXEC_ON_READ,
META: complete the details, which are new to 2.0.
+
+To retrieve the contents of a custom container directive, use the
+CLApache::Directive object's methods
+CLas_hash|Apache::Directive/C_as_hash_
+or CLas_string|Apache::Directive/C_as_string_ :
+
+ sub MyParameter {
+ my($self, $parms, $val) = @_;
+ my $directive = $parms-directive;
+ my $content = $directive-as_string;
+ }
There is one other trick to making configuration containers work. In
order to be recognized as a valid directive, the ILname|/C_name_
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r111670 - /perl/modperl/docs/trunk/src/download/index_top.html
Author: gozer Date: Sun Dec 12 15:10:40 2004 New Revision: 111670 URL: http://svn.apache.org/viewcvs?view=revrev=111670 Log: 1.99.18 is out Modified: perl/modperl/docs/trunk/src/download/index_top.html Modified: perl/modperl/docs/trunk/src/download/index_top.html Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/download/index_top.html?view=diffrev=111670p1=perl/modperl/docs/trunk/src/download/index_top.htmlr1=111669p2=perl/modperl/docs/trunk/src/download/index_top.htmlr2=111670 == --- perl/modperl/docs/trunk/src/download/index_top.html (original) +++ perl/modperl/docs/trunk/src/download/index_top.html Sun Dec 12 15:10:40 2004 @@ -14,7 +14,7 @@ brbr /li -limod_perl 2.0 (in development): Version 1.99_17 - Oct 22, 2004br +limod_perl 2.0 (in development): Version 1.99_18 - Dec 12, 2004br a href=http://perl.apache.org/dist/mod_perl-2.0-current.tar.gz;Download/a | a href=http://perl.apache.org/dist/mod_perl-2.0-current;Browse/a | a href=http://perl.apache.org/dist/mod_perl-2.0-current/Changes;Changes/a | - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r111450 - /perl/modperl/docs/trunk/src/download/source.pod
Author: gozer Date: Thu Dec 9 16:12:29 2004 New Revision: 111450 URL: http://svn.apache.org/viewcvs?view=revrev=111450 Log: it's svn.apache.org for the snapshots now Modified: perl/modperl/docs/trunk/src/download/source.pod Modified: perl/modperl/docs/trunk/src/download/source.pod Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/download/source.pod?view=diffrev=111450p1=perl/modperl/docs/trunk/src/download/source.podr1=111449p2=perl/modperl/docs/trunk/src/download/source.podr2=111450 == --- perl/modperl/docs/trunk/src/download/source.pod (original) +++ perl/modperl/docs/trunk/src/download/source.pod Thu Dec 9 16:12:29 2004 @@ -93,7 +93,7 @@ =item * The latest SVN snapshot -http://cvs.apache.org/snapshots/modperl-2.0/ +http://svn.apache.org/snapshots/modperl-2.0/ =item * SVN Access - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r109780 - /perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestUtil.pod
Author: gozer
Date: Fri Dec 3 22:12:14 2004
New Revision: 109780
URL: http://svn.apache.org/viewcvs?view=revrev=109780
Log:
Apache::RequestUtil : $r-child_terminate() implemented for
non-threaded MPMs.
Modified:
perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestUtil.pod
Modified: perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestUtil.pod
Url:
http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestUtil.pod?view=diffrev=109780p1=perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestUtil.podr1=109779p2=perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestUtil.podr2=109780
==
--- perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestUtil.pod
(original)
+++ perl/modperl/docs/trunk/src/docs/2.0/api/Apache/RequestUtil.pod Fri Dec
3 22:12:14 2004
@@ -78,6 +78,9 @@
# slurp the contents of $r-filename
my $content = ${ $r-slurp_filename() };
+
+ # terminate the current child after this request
+ $r-child_terminate();
@@ -165,6 +168,27 @@
debugging)
+
+
+=head2 Cchild_terminate
+
+Terminate the current worker process as soon as the current request is
+over
+
+ $r-child_terminate();
+
+=over 4
+
+=item obj: C$r
+( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec )
+
+=item ret: no return value
+
+=item since: 1.99_18
+
+=back
+
+This method is not supported in threaded MPMs
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: r105889 - perl/modperl/docs/trunk/src/download
Author: gozer Date: Fri Nov 19 14:17:09 2004 New Revision: 105889 Modified: perl/modperl/docs/trunk/src/download/docs.pod Log: Update docs download section to SVN Modified: perl/modperl/docs/trunk/src/download/docs.pod == --- perl/modperl/docs/trunk/src/download/docs.pod (original) +++ perl/modperl/docs/trunk/src/download/docs.pod Fri Nov 19 14:17:09 2004 @@ -14,24 +14,22 @@ =head1 Download -The mod_perl documentation lives in the Ccvs.apache.org CVS +The mod_perl documentation lives in the Csvn.apache.org Subversion server. To get it, you will need to checkout a copy. Assuming you have -CVS installed, run the following commands from the directory you want -to place the Imodperl-docs directory in: +Subversion installed, run the following command from the directory you +want to place the Imodperl-docs directory in: - % cvs -d:pserver:[EMAIL PROTECTED]:/home/cvspublic login -(use the password anoncvs) - % cvs -d:pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl-docs + % svn co http://svn.apache.org/repos/asf/perl/modperl/docs/trunk modpe You will now find a directory called Imodperl-docs in the current working directory which contains all the sources needed to build the -site. See the LCVS Howto|contribute::cvs_howto for more information. +site. See the LSubversion Howto|contribute::svn_howto for more information. -Another way to download the sources, if you don't want to use CVS, is -to get the snapshots available from +Another way to download the sources, if you don't want to use Subversion, +is to get the snapshots available from http://cvs.apache.org/snapshots/modperl-docs/ . However, it will be a major drag for you to keep these up to date, so you are better advised -to use the CVS access. +to use the Subversion access. =head1 Build @@ -41,7 +39,7 @@ =head2 Prerequisites -DocSet: while it is included with the CVS distribution, please +DocSet: while it is included with the Subversion distribution, please download it from CPAN and install the latest version. It will install the tool Chtml2ps, which is needed to build the PDF version, and also a number of Perl modules (it will tell you the Perl modules @@ -88,11 +86,11 @@ so you might want to follow the Ldocs-cvs mailing list|maillist::docs-cvs to see when changes are made. -Once you see a change is made, you need to update your CVS working -copy, and re-build the site (although it will only rebuilt modified -files). +Once you see a change is made, you need to update your Subversion +working copy, and re-build the site (although it will only rebuild +modified files). - % cvs up + % svn up % bin/build Rebuilding the PDF version is just as easy, just run: @@ -109,8 +107,8 @@ =head1 Submitting documentation patches We warmly welcome any updates to the documentation. To send us a -documentation patch, please update your CVS tree, and then, depending -on the patch: +documentation patch, please update your Subversion tree, and then, +depending on the patch: =over @@ -122,10 +120,10 @@ =item * If you only add a paragraph/modify a line, please make sure you have -the Ilatest CVS version, and then issue: +the Ilatest Subversion version, and then issue: % cd modperl-docs - % cvs diff -u patch + % svn diff -u patch And send the Ipatch file to the maintainer or the Ldocumentation mailing list|maillist::docs-dev, preferably inlined in your e-mail @@ -136,7 +134,7 @@ do: % cd modperl-docs - % cvs diff -u src/docs/2.0/api/Apache/RequestUtil.pod patch + % svn diff -u src/docs/2.0/api/Apache/RequestUtil.pod patch This approach will get the diff of only that file. @@ -220,7 +218,7 @@ $flags .= 'd' if $name =~ /pdf/; $flags = $flags ? -$flags : ; - system(cvs up -dP /dev/null 21); + system(svn up /dev/null 21); system(bin/build $flags); - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
r76184 - in perl/modperl/docs/trunk/src/docs: 1.0/guide 2.0/devel 2.0/user
Author: gozer Date: Wed Nov 17 15:08:40 2004 New Revision: 76184 Modified: perl/modperl/docs/trunk/src/docs/1.0/guide/config.cfg perl/modperl/docs/trunk/src/docs/2.0/devel/config.cfg perl/modperl/docs/trunk/src/docs/2.0/user/config.cfg Log: need to skip .svn directory in a few more places Modified: perl/modperl/docs/trunk/src/docs/1.0/guide/config.cfg == --- perl/modperl/docs/trunk/src/docs/1.0/guide/config.cfg (original) +++ perl/modperl/docs/trunk/src/docs/1.0/guide/config.cfg Wed Nov 17 15:08:40 2004 @@ -48,5 +48,8 @@ code )], +copy_skip = [ +'\.svn', +], ); Modified: perl/modperl/docs/trunk/src/docs/2.0/devel/config.cfg == --- perl/modperl/docs/trunk/src/docs/2.0/devel/config.cfg (original) +++ perl/modperl/docs/trunk/src/docs/2.0/devel/config.cfg Wed Nov 17 15:08:40 2004 @@ -45,5 +45,9 @@ copy_glob = [qw( debug/code )], + +copy_skip = [ +'\.svn', +], ); Modified: perl/modperl/docs/trunk/src/docs/2.0/user/config.cfg == --- perl/modperl/docs/trunk/src/docs/2.0/user/config.cfg(original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/config.cfgWed Nov 17 15:08:40 2004 @@ -62,6 +62,10 @@ handlers/*.jpg )], +copy_skip = [ +'\.svn', +], + changes = 'Changes.pod', ); - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: rev 76176 - in perl/modperl/docs/trunk: bin src
Author: gozer Date: Wed Nov 17 13:46:03 2004 New Revision: 76176 Modified: perl/modperl/docs/trunk/bin/site_build perl/modperl/docs/trunk/src/config.cfg Log: Parts of the move from CVS to subversion. Start generating the site from svn. Modified: perl/modperl/docs/trunk/bin/site_build == --- perl/modperl/docs/trunk/bin/site_build (original) +++ perl/modperl/docs/trunk/bin/site_build Wed Nov 17 13:46:03 2004 @@ -54,7 +54,7 @@ $flags .= 'v' if $name =~ /verbose/; $flags = $flags ? -$flags : ; -system(cvs up -dP /dev/null 21); +system(svn update /dev/null 21); system(bin/build $flags); Modified: perl/modperl/docs/trunk/src/config.cfg == --- perl/modperl/docs/trunk/src/config.cfg (original) +++ perl/modperl/docs/trunk/src/config.cfg Wed Nov 17 13:46:03 2004 @@ -75,7 +75,7 @@ )], copy_skip = [ -'(?:^|\/)CVS(?:\/|$)', # skip cvs control files +'(?:^|\/)\.svn(?:\/|$)', # skip svn control files '#|~', # skip emacs backup files ], - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
svn commit: rev 76184 - in perl/modperl/docs/trunk/src/docs: 1.0/guide 2.0/devel 2.0/user
Author: gozer Date: Wed Nov 17 15:08:40 2004 New Revision: 76184 Modified: perl/modperl/docs/trunk/src/docs/1.0/guide/config.cfg perl/modperl/docs/trunk/src/docs/2.0/devel/config.cfg perl/modperl/docs/trunk/src/docs/2.0/user/config.cfg Log: need to skip .svn directory in a few more places Modified: perl/modperl/docs/trunk/src/docs/1.0/guide/config.cfg == --- perl/modperl/docs/trunk/src/docs/1.0/guide/config.cfg (original) +++ perl/modperl/docs/trunk/src/docs/1.0/guide/config.cfg Wed Nov 17 15:08:40 2004 @@ -48,5 +48,8 @@ code )], +copy_skip = [ +'\.svn', +], ); Modified: perl/modperl/docs/trunk/src/docs/2.0/devel/config.cfg == --- perl/modperl/docs/trunk/src/docs/2.0/devel/config.cfg (original) +++ perl/modperl/docs/trunk/src/docs/2.0/devel/config.cfg Wed Nov 17 15:08:40 2004 @@ -45,5 +45,9 @@ copy_glob = [qw( debug/code )], + +copy_skip = [ +'\.svn', +], ); Modified: perl/modperl/docs/trunk/src/docs/2.0/user/config.cfg == --- perl/modperl/docs/trunk/src/docs/2.0/user/config.cfg(original) +++ perl/modperl/docs/trunk/src/docs/2.0/user/config.cfgWed Nov 17 15:08:40 2004 @@ -62,6 +62,10 @@ handlers/*.jpg )], +copy_skip = [ +'\.svn', +], + changes = 'Changes.pod', ); - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/config custom.pod
gozer 2004/11/08 21:44:12
Modified:src/docs/2.0/api/Apache CmdParms.pod Const.pod Module.pod
src/docs/2.0/user/config custom.pod
Log:
Remove magicness of PerlLoadModule and implement Apache::Module::add()
for modules that implement their own configuration directives
Revision ChangesPath
1.18 +9 -5 modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod
Index: CmdParms.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- CmdParms.pod 13 Sep 2004 22:17:03 - 1.17
+++ CmdParms.pod 9 Nov 2004 05:44:12 - 1.18
@@ -8,15 +8,18 @@
=head1 Synopsis
use Apache::CmdParms ();
+ use Apache::Module ();
use Apache::Const -compile = qw(NOT_IN_LOCATION);
- our @APACHE_MODULE_COMMANDS = (
+ my @directives = (
{
name = 'MyDirective',
cmd_data = 'some extra data',
},
);
+ Apache::Module::add(__PACKAGE__, [EMAIL PROTECTED]);
+
sub MyDirective {
my($self, $parms, $args) = @_;
@@ -35,8 +38,8 @@
# this command's directive object
$directive = $parms-directive;
- # the extra information passed thru cmd_data in
- # @APACHE_MODULE_COMMANDS
+ # the extra information passed thru cmd_data to
+ # Apache::Module::add()
$info = $parms-info;
# which methods are Limited ?
@@ -193,7 +196,7 @@
=head2 Cinfo
The extra information passed through Ccmd_data in
-CL@APACHE_MODULE_COMMANDS|docs::2.0::user::config::custom/C_cmd_data_.
+CLApache::Module::add()|docs::2.0::api::Apache::Module/C_add_.
$info = $parms-info;
@@ -213,7 +216,7 @@
For example here is how to pass arbitrary information to a directive
subroutine:
- our @APACHE_MODULE_COMMANDS = (
+ my @directives = (
{
name = 'MyDirective1',
func = \MyDirective,
@@ -225,6 +228,7 @@
cmd_data = 'Two',
},
);
+ Apache::Module::add(__PACKAGE__, [EMAIL PROTECTED]);
sub MyDirective {
my($self, $parms, $args) = @_;
1.28 +1 -1 modperl-docs/src/docs/2.0/api/Apache/Const.pod
Index: Const.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Const.pod,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- Const.pod 17 Sep 2004 19:28:15 - 1.27
+++ Const.pod 9 Nov 2004 05:44:12 - 1.28
@@ -87,7 +87,7 @@
use Apache::Const -compile = qw(:cmd_how);
The C:cmd_how constants group is used in
-CL@APACHE_MODULE_COMMANDS|docs::2.0::user::config::custom/C_args_how_
+CLApache::Module::add()|docs::2.0::api::Apache::Module/C_add_
and
CL$cmds-Egtargs_how|docs::2.0::api::Apache::Command/C_args_how_.
1.25 +39 -0 modperl-docs/src/docs/2.0/api/Apache/Module.pod
Index: Module.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Module.pod,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- Module.pod17 Sep 2004 00:07:23 - 1.24
+++ Module.pod9 Nov 2004 05:44:12 - 1.25
@@ -9,6 +9,15 @@
use Apache::Module ();
+ #Define a configuration directive
+ my @directives = (
+ {
+ name = 'MyDirective',
+ }
+ );
+
+ Apache::Module::add(__PACKAGE__, [EMAIL PROTECTED]);
+
# iterate over the whole module list
for (my $modp = Apache::Module::top_module(); $modp; $modp = $modp-next) {
my $name = $modp-name;
@@ -62,6 +71,36 @@
=head1 API
CApache::Module provides the following functions and/or methods:
+
+
+
+
+
+=head2 Cadd
+
+Add a module's custom configuration directive to Apache.
+
+ Apache::Module::add($package, $cmds);
+
+=over 4
+
+=item arg1: C$package ( string )
+
+the package of the module to add
+
+=item arg2: C$cmds ( ARRAY of HASH refs )
+
+the list of configuration directives to add
+
+=item ret: no return value
+
+=item since: 1.99_18
+
+=back
+
+See also LApache Server Configuration Customization in
+Perl|docs::2.0::user::config::custom.
+
1.15 +32 -12modperl-docs/src/docs/2.0/user/config/custom.pod
Index: custom.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/config/custom.pod,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- custom.pod14 Sep 2004 20:47:23 - 1.14
+++ custom.pod9 Nov 2004
cvs commit: modperl-docs/src/docs/2.0/user/config config.pod
gozer 2004/11/08 21:49:32 Modified:src/docs/2.0/user/config config.pod Log: Clarify explanation of PerlLoadModule, since it has now lost most of it's magicness wrt custom configuration directives Revision ChangesPath 1.67 +6 -5 modperl-docs/src/docs/2.0/user/config/config.pod Index: config.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/config/config.pod,v retrieving revision 1.66 retrieving revision 1.67 diff -u -r1.66 -r1.67 --- config.pod22 Jul 2004 05:37:30 - 1.66 +++ config.pod9 Nov 2004 05:49:32 - 1.67 @@ -216,11 +216,12 @@ The CPerlLoadModule directive is similar to CLPerlModule|/C_PerlModule_, in a sense that it loads a -module. The difference is that it's used to implement Lnew Apache -directives|docs::2.0::user::config::custom. Since those -directives are needed during the configuration phase, this directive -triggers Lan early Perl startup|/Startup_Process, as a side effect. - +module. The difference is that it's used to triggers +Lan early Perl startup|/Startup_Process. This can be usefull +for modules that need to be loaded early, as is the case for +modules that implement +Lnew Apache directives|docs::2.0::user::config::custom, +which are needed during the configuration phase. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache PerlSections.pod
gozer 2004/11/01 16:17:00
Modified:src/docs/2.0/api/Apache PerlSections.pod
Log:
Clarify the documentation on Apache::PerlSections-dump() about having
to place it in it's own Perl block
Revision ChangesPath
1.21 +9 -1 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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- PerlSections.pod 1 Nov 2004 18:04:18 - 1.20
+++ PerlSections.pod 2 Nov 2004 00:17:00 - 1.21
@@ -165,6 +165,8 @@
Perl
+ $Apache::PerlSections::Save = 1;
+
$Port = 8529;
$Location{/perl} = {
@@ -187,9 +189,10 @@
},
},
};
+ /Perl
+ Perl
print Apache::PerlSections-dump;
-
/Perl
This will print something like this:
@@ -222,6 +225,11 @@
1;
__END__
+
+
+It is important to put the call to Cdump in it's own CEltPerl Egt
+section, otherwise the content of the current CEltPerl Egt section
+will not be dumped.
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache PerlSections.pod
gozer 2004/11/01 10:04:18
Modified:src/docs/2.0/api/Apache PerlSections.pod
Log:
Whitespace fixup
Revision ChangesPath
1.20 +10 -10modperl-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.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- PerlSections.pod 4 Sep 2004 18:37:41 - 1.19
+++ PerlSections.pod 1 Nov 2004 18:04:18 - 1.20
@@ -164,17 +164,17 @@
For example:
Perl
-
+
$Port = 8529;
-
+
$Location{/perl} = {
SetHandler = perl-script,
PerlHandler = Apache::Registry,
Options = ExecCGI,
};
-
+
@DirectoryIndex = qw(index.htm index.html);
-
+
$VirtualHost{www.foo.com} = {
DocumentRoot = /tmp/docs,
ErrorLog = /dev/null,
@@ -187,26 +187,26 @@
},
},
};
-
+
print Apache::PerlSections-dump;
-
+
/Perl
This will print something like this:
$Port = 8529;
-
+
@DirectoryIndex = (
'index.htm',
'index.html'
);
-
+
$Location{'/perl'} = (
PerlHandler = 'Apache::Registry',
SetHandler = 'perl-script',
Options = 'ExecCGI'
);
-
+
$VirtualHost{'www.foo.com'} = (
Location = {
'/' = {
@@ -219,7 +219,7 @@
DocumentRoot = '/tmp/docs',
ErrorLog = '/dev/null'
);
-
+
1;
__END__
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/download index_top.html
gozer 2004/10/22 14:36:23 Modified:src/download index_top.html Log: release 1.99_17 Revision ChangesPath 1.21 +1 -1 modperl-docs/src/download/index_top.html Index: index_top.html === RCS file: /home/cvs/modperl-docs/src/download/index_top.html,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- index_top.html23 Aug 2004 05:53:48 - 1.20 +++ index_top.html22 Oct 2004 21:36:22 - 1.21 @@ -14,7 +14,7 @@ brbr /li -limod_perl 2.0 (in development): Version 1.99_16 - Aug 22, 2004br +limod_perl 2.0 (in development): Version 1.99_17 - Oct 22, 2004br a href=http://perl.apache.org/dist/mod_perl-2.0-current.tar.gz;Download/a | a href=http://perl.apache.org/dist/mod_perl-2.0-current;Browse/a | a href=http://perl.apache.org/dist/mod_perl-2.0-current/Changes;Changes/a | - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/porting compat.pod
gozer 2004/10/19 12:50:58 Modified:src/docs/2.0/user/porting compat.pod Log: Implement Apache-unescape_url_info in Apache::compat and drop it from the official API for CGI::Util::unescape() as a suggested replacement Revision ChangesPath 1.69 +13 -0 modperl-docs/src/docs/2.0/user/porting/compat.pod Index: compat.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/porting/compat.pod,v retrieving revision 1.68 retrieving revision 1.69 diff -u -r1.68 -r1.69 --- compat.pod6 Oct 2004 01:04:53 - 1.68 +++ compat.pod19 Oct 2004 19:50:58 - 1.69 @@ -656,6 +656,19 @@ +=head2 CApache-Egtunescape_url_info + +Apache-Egtunescape_url_info is not available in mod_perl 2.0 +API. Use CCGI::Util::unescape instead +(http://search.cpan.org/dist/CGI.pm/CGI/Util.pm). + +It is also available via +CLApache::compat|docs::2.0::api::Apache::compat +for backwards compatibility. + + + + =head2 CApache::exit() CApache::exit() has been replaced with - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/offsite other.pod
gozer 2004/10/06 20:20:49 Modified:src/docs/offsite other.pod Log: Put back some information that should have been updated, not removed. Revision ChangesPath 1.11 +9 -1 modperl-docs/src/docs/offsite/other.pod Index: other.pod === RCS file: /home/cvs/modperl-docs/src/docs/offsite/other.pod,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- other.pod 6 Oct 2004 19:22:05 - 1.10 +++ other.pod 7 Oct 2004 03:20:49 - 1.11 @@ -220,6 +220,9 @@ Jails: Confining the omnipotent root: http://docs.freebsd.org/44doc/papers/jail/jail.html +FreeBSD Developers' Handbook: The Jail Subsystem +http://www.freebsd.org/doc/en_US.ISO8859-1/books/arch-handbook/jail.html + =back =head1 DBI and SQL @@ -289,13 +292,18 @@ =item * CVS Quick Reference Card -http://refcards.com/refcards/cvs/index.html +http://www.refcards.com/about/cvs.html =back =head1 Performance and Scalability =over + +=item * Techniques and Technologies for Scaling Internet Services mailing list. + +The list's address: [EMAIL PROTECTED] +Subscribe by sending a message to [EMAIL PROTECTED] =item * Solaris 2.x - Tuning Your TCP/IP Stack and More - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/offsite other.pod
gozer 2004/10/06 12:22:05 Modified:src/docs/offsite other.pod Log: Cleanup for Documentation / Offsite / Other Obtained from: Frank Wiles Revision ChangesPath 1.10 +4 -17 modperl-docs/src/docs/offsite/other.pod Index: other.pod === RCS file: /home/cvs/modperl-docs/src/docs/offsite/other.pod,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- other.pod 28 Sep 2004 22:02:13 - 1.9 +++ other.pod 6 Oct 2004 19:22:05 - 1.10 @@ -220,9 +220,6 @@ Jails: Confining the omnipotent root: http://docs.freebsd.org/44doc/papers/jail/jail.html -FreeBSD Developers' Handbook: The Jail Subsystem -http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/jail.html - =back =head1 DBI and SQL @@ -235,7 +232,7 @@ =item * SQL for Web Nerds by Philip Greenspun -http://www.arsdigita.com/books/sql/ +http://philip.greenspun.com/sql =item * Jeffrey Baker's DBI Examples and Performance Tuning @@ -246,14 +243,10 @@ http://dbi.perl.org/ -=item * DBI mailing list information - -http://www.fugue.com/dbi/ - =item * DBI mailing list archives -http://www.bitmechanic.com/mail-archives/dbi-users/ -http://www.xray.mpe.mpg.de/mailing-lists/dbi/ +http://www.mail-archive.com/dbi-users@perl.org/ +http://groups.google.com/groups?hl=enlr=ie=UTF-8oe=UTF-8group=perl.dbi.usershttp://www.xray.mpe.mpg.de/mailing-lists/dbi/ =back @@ -296,19 +289,13 @@ =item * CVS Quick Reference Card -http://www.refcards.com/about/cvs.html +http://refcards.com/refcards/cvs/index.html =back =head1 Performance and Scalability =over - -=item * Techniques and Technologies for Scaling Internet Services mailing list. - -The list's address: [EMAIL PROTECTED] -Subscribe by sending a message to [EMAIL PROTECTED] -Archive: http://archive.develooper.com/[EMAIL PROTECTED]/ =item * Solaris 2.x - Tuning Your TCP/IP Stack and More - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache RequestUtil.pod
gozer 2004/10/04 12:27:36
Modified:src/docs/2.0/api/Apache RequestUtil.pod
Log:
$r-document_root can now be changed when safe to do so
Revision ChangesPath
1.27 +11 -0 modperl-docs/src/docs/2.0/api/Apache/RequestUtil.pod
Index: RequestUtil.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/RequestUtil.pod,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- RequestUtil.pod 9 Sep 2004 20:19:49 - 1.26
+++ RequestUtil.pod 4 Oct 2004 19:27:36 - 1.27
@@ -24,6 +24,9 @@
# get server docroot
$docroot = $r-document_root();
+ # set server docroot
+ $r-document_root($new_root);
+
# what are the registered perl handlers for a given phase
my @handlers = @{ $r-get_handlers('PerlResponseHandler') || [] };
@@ -276,6 +279,7 @@
Retrieve the document root for this server
$docroot = $r-document_root();
+ $docroot = $r-document_root($new_root);
=over 4
@@ -283,6 +287,13 @@
( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec )
The current request
+
+=item opt arg1: C$new_root
+
+Sets the document root to a new value
+
+Note the Llimited functionality under threaded
+MPMs|docs::2.0::api::Apache::ServerRec/Limited_Functionality_under_Threaded_MPMs.
=item ret: C$docroot ( string )
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/porting compat.pod
gozer 2004/09/24 12:55:33
Modified:src/docs/2.0/api/Apache Log.pod
src/docs/2.0/user/porting compat.pod
Log:
$r-log_reason has been ported and moved out of Apache::compat
Revision ChangesPath
1.18 +34 -0 modperl-docs/src/docs/2.0/api/Apache/Log.pod
Index: Log.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Log.pod,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- Log.pod 17 Sep 2004 01:07:30 - 1.17
+++ Log.pod 24 Sep 2004 19:55:33 - 1.18
@@ -60,6 +60,7 @@
$s-log_serror(Apache::Log::LOG_MARK, Apache::LOG_ERR,
APR::ENOTIME, fatal error);
+ $r-log_reason(fatal error);
$r-warn('routine request warning');
$s-warn('routine server warning');
@@ -447,6 +448,39 @@
+
+=head2 C$r-Egtlog_reason
+
+This function provides a convenient way to log of errors in a
+preformatted way
+
+ $r-log_reason($message);
+ $r-log_reason($message, $filename);
+
+=over 4
+
+=item obj: C$r
+( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec )
+
+=item arg1: C$message ( string )
+
+what to log
+
+=item opt arg2: C$filename ( string )
+
+where to report the error as coming from
+
+=item ret: no return value
+
+A sample log entry would look like:
+
+ [Fri Sep 24 11:58:36 2004] [error] access to /someuri failed for
127.0.0.1, reason: $message
+
+
+
+
+
+
=head2 C$r-Egtlog_rerror
1.67 +0 -13 modperl-docs/src/docs/2.0/user/porting/compat.pod
Index: compat.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/porting/compat.pod,v
retrieving revision 1.66
retrieving revision 1.67
diff -u -r1.66 -r1.67
--- compat.pod17 Sep 2004 01:06:55 - 1.66
+++ compat.pod24 Sep 2004 19:55:33 - 1.67
@@ -1024,19 +1024,6 @@
See the LApache::RequestRec manpage.
-=head2 C$r-Egtlog_reason
-
-C$r-Egtlog_reason is not available in mod_perl 2.0 API. Use the
-other standard logging functions provided by the
-CLApache::Log|docs::2.0::api::Apache::Log
-module. For example:
-
- $r-log_error(it works!);
-
-See the CLApache::Log|docs::2.0::api::Apache::Log
-manpage.
-
-
=head2 C$r-Egtregister_cleanup
C$r-Egtregister_cleanup has been replaced with
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/APR OS.pod
gozer 2004/09/22 16:22:03 Modified:src/docs/2.0/api/APR OS.pod Log: APR::OS::thread_current renamed APR::OS::current_thread_id and now returns the actual thread_id instead of an object that needed to be dereferenced to get at the thread_id Revision ChangesPath 1.2 +4 -7 modperl-docs/src/docs/2.0/api/APR/OS.pod Index: OS.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/OS.pod,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- OS.pod19 Aug 2004 06:03:00 - 1.1 +++ OS.pod22 Sep 2004 23:22:03 - 1.2 @@ -10,8 +10,7 @@ use APR::OS (); # get thread id - my $tid_obj = APR::OS::thread_current(); - my $tid = $$tid_obj; + my $tid = APR::OS::current_thread_id(); @@ -41,17 +40,15 @@ -=head2 Cthread_current +=head2 Ccurrent_thread_id Get the thread ID - $tid_obj = APR::OS::thread_current(); + $tid = APR::OS::current_thread_id(); =over 4 -=item ret: C$tid_obj ( CAPR::OS::Thread object ) - -To get the thread id dereference it: C$$tid_obj. +=item ret: C$tid ( integer ) That value is a thread ID under threaded MPMs, otherwise 0. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Const.pod
gozer 2004/09/17 12:28:15 Modified:src/docs/2.0/api/Apache Const.pod Log: xref OR_ALL to it's constants Revision ChangesPath 1.27 +5 -2 modperl-docs/src/docs/2.0/api/Apache/Const.pod Index: Const.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Const.pod,v retrieving revision 1.26 retrieving revision 1.27 diff -u -r1.26 -r1.27 --- Const.pod 14 Sep 2004 20:47:23 - 1.26 +++ Const.pod 17 Sep 2004 19:28:15 - 1.27 @@ -2224,8 +2224,11 @@ =head3 CApache::OR_ALL -CApache::OR_LIMIT | Apache::OR_OPTIONS | Apache::OR_FILEINFO | -Apache::OR_AUTHCFG | Apache::OR_INDEXES +CLApache::OR_LIMIT|/C_Apache__OR_LIMIT_ | +CLApache::OR_OPTIONS|/C_Apache__OR_OPTIONS_ | +CLApache::OR_FILEINFO|/C_Apache__OR_FILEINFO_ | +CLApache::OR_AUTHCFG|/C_Apache__OR_AUTHCFG_ | +CLApache::OR_INDEXES|/C_Apache__OR_INDEXES_ =over - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Module.pod
gozer 2004/09/16 14:59:38
Modified:src/docs/2.0/api/Apache Module.pod
Log:
Apache::Module $mod-version() renamed $mod-apache_api_version()
for clarity
Revision ChangesPath
1.22 +28 -28modperl-docs/src/docs/2.0/api/Apache/Module.pod
Index: Module.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Module.pod,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- Module.pod13 Sep 2004 22:52:46 - 1.21
+++ Module.pod16 Sep 2004 21:59:38 - 1.22
@@ -11,11 +11,11 @@
# iterate over the whole module list
for (my $modp = Apache::Module::top_module(); $modp; $modp = $modp-next) {
- my $name = $modp-name;
- my $index = $modp-module_index;
- my $version = $modp-version;
- my $commands = $modp-cmds;
- my $minor_version = $modp-minor_version;
+ my $name= $modp-name;
+ my $index = $modp-module_index;
+ my $apache_api_version = $modp-apache_api_version;
+ my $commands= $modp-cmds;
+ my $minor_version = $modp-minor_version;
}
# find a specific module
@@ -68,6 +68,29 @@
+=head2 Capache_api_version
+
+Get the httpd API version this module was build against, Bnot
+the module's version; Used to check that module is compatible
+with this version of the server before loading it.
+
+ $version = $module-apache_api_version();
+
+=over 4
+
+=item obj: C$module
+( CLApache::Module object|docs::2.0::api::Apache::Module )
+
+=item ret: C$version ( integer )
+
+=item since: 1.99_12
+
+=back
+
+
+
+
+
=head2 Ccmds
Get the CLApache::Command|docs::2.0::api::Apache::Command object,
@@ -357,29 +380,6 @@
=item ret: C$module
( CLApache::Module object|docs::2.0::api::Apache::Module )
-
-=item since: 1.99_12
-
-=back
-
-
-
-
-
-=head2 Cversion
-
-Get the httpd API version this module was build against, Bnot
-the module's version; Used to check that module is compatible
-with this version of the server before loading it.
-
- $version = $module-version();
-
-=over 4
-
-=item obj: C$module
-( CLApache::Module object|docs::2.0::api::Apache::Module )
-
-=item ret: C$version ( integer )
=item since: 1.99_12
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache compat.pod
gozer 2004/09/13 16:36:55 Modified:src/docs/2.0/api/Apache compat.pod Log: Apache::Module top_module() and get_config() as class methods added to Apache::compat for backwards compatibility Documented 2 missing compat functions: Apache::Util::ht_time APR::URI::unparse Revision ChangesPath 1.11 +7 -1 modperl-docs/src/docs/2.0/api/Apache/compat.pod Index: compat.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/compat.pod,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- compat.pod18 Aug 2004 07:13:39 - 1.10 +++ compat.pod13 Sep 2004 23:36:55 - 1.11 @@ -121,7 +121,13 @@ =item * CApache::Connection::remote_addr -=item * CApache::server_root_relative +=item * CApache::Module::top_module + +=item * CApache::Module::get_config + +=item * CApache::Util::ht_time + +=item * CAPR::URI::unparse =back - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/porting compat.pod
gozer 2004/09/13 17:06:56 Modified:src/docs/2.0/api/Apache compat.pod src/docs/2.0/user/porting compat.pod Log: Apache::Module get_config top_module didn't need to be overriden methods, keep it simple with smart wrappers instead Revision ChangesPath 1.12 +0 -4 modperl-docs/src/docs/2.0/api/Apache/compat.pod Index: compat.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/compat.pod,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- compat.pod13 Sep 2004 23:36:55 - 1.11 +++ compat.pod14 Sep 2004 00:06:56 - 1.12 @@ -121,10 +121,6 @@ =item * CApache::Connection::remote_addr -=item * CApache::Module::top_module - -=item * CApache::Module::get_config - =item * CApache::Util::ht_time =item * CAPR::URI::unparse 1.63 +17 -0 modperl-docs/src/docs/2.0/user/porting/compat.pod Index: compat.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/porting/compat.pod,v retrieving revision 1.62 retrieving revision 1.63 diff -u -r1.62 -r1.63 --- compat.pod25 Aug 2004 21:51:27 - 1.62 +++ compat.pod14 Sep 2004 00:06:56 - 1.63 @@ -703,6 +703,23 @@ +=head1 CApache::Module:: Methods + +=head2 CApache::Module-Egttop_module + +CApache::Module-Egttop_module has been replaced with +the function CApache::Module::top_module() + + + + +=head2 CApache::Module-Egtget_config + +CApache::Module-Egtget_config has been replaced with +the function CApache::Module::get_config() + + + =head1 CApache::Server:: Methods and Variables - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Directive.pod
gozer 2004/09/13 17:20:51
Modified:src/docs/2.0/api/Apache Directive.pod
Log:
Added a few examples
Revision ChangesPath
1.10 +46 -0 modperl-docs/src/docs/2.0/api/Apache/Directive.pod
Index: Directive.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Directive.pod,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- Directive.pod 13 Sep 2004 23:22:18 - 1.9
+++ Directive.pod 14 Sep 2004 00:20:50 - 1.10
@@ -86,6 +86,19 @@
=back
+For example, in Fhttpd.conf:
+
+ PerlSwitches -M/opt/lib -M/usr/local/lib -wT
+
+And later:
+
+ my $tree = Apache::Directive-conftree;
+ my $node = $tree-lookup('PerlSwitches');
+ my $args = $node-args;
+
+C$args now contains the string -M/opt/lib -M/usr/local/lib -wT
+
+
@@ -111,6 +124,26 @@
=back
+For example: in Fhttpd.conf:
+
+ Location /test
+SetHandler perl-script
+PerlHandler Test::Module
+ /Location
+
+And later:
+
+ my $tree = Apache::Directive-conftree;
+ my $node = $tree-lookup('Location', '/test/');
+ my $hash = $node-as_hash;
+
+C$hash now is:
+
+ {
+'SetHandler' = 'perl-script',
+'PerlHandler' = 'Test::Module',
+ }
+
@@ -207,6 +240,19 @@
=back
+For example:
+
+ my $tree = Apache::Directive-conftree;
+ my $node = $tree-lookup('VirtualHost', 'example.com');
+ my $filename = $node-filename;
+
+C$filename is now the full path to the Fhttpd.conf that
+VirtualHost was defined in.
+
+If the directive was added with
+CLadd_config()|docs::2.0::api::Apache::ServerUtil/C_add_config_,
+the filename will be the path to the Fhttpd.conf that trigerred
+that Perl code.
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/config custom.pod
gozer 2004/09/14 13:11:16 Modified:src/docs/2.0/user/config custom.pod Log: That feature was logged as a missing_feature, no need to tease about it. Revision ChangesPath 1.12 +0 -3 modperl-docs/src/docs/2.0/user/config/custom.pod Index: custom.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/config/custom.pod,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- custom.pod13 Sep 2004 22:36:44 - 1.11 +++ custom.pod14 Sep 2004 20:11:16 - 1.12 @@ -246,9 +246,6 @@ This attribute is optional. If not supplied, the default value of CLApache::TAKE1|/C_Apache__TAKE1_ is used. -META: the default may change to use a constant corresponding to the -Ifunc prototype. - =head3 Cerrmsg - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Directive.pod
gozer 2004/09/13 11:42:55
Modified:src/docs/2.0/api/Apache Directive.pod
Log:
Small improvements on the documentation
Revision ChangesPath
1.8 +12 -9 modperl-docs/src/docs/2.0/api/Apache/Directive.pod
Index: Directive.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Directive.pod,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- Directive.pod 10 Aug 2004 23:02:01 - 1.7
+++ Directive.pod 13 Sep 2004 18:42:55 - 1.8
@@ -1,6 +1,6 @@
=head1 NAME
-Apache::Directive - Perl API for manipulating Apache configuration tree
+Apache::Directive - Perl API for manipulating the Apache configuration tree
@@ -24,6 +24,11 @@
print $node-as_string;
#do something with $node
+
+ my $directive = $node-directive;
+ my $args = $node-args;
+ my $filename = $node-filename;
+ my $line_num = $node-line_num;
if (my $kid = $node-first_child) {
$node = $kid;
@@ -47,14 +52,8 @@
=head1 Description
-CApache::Directive allows its users to search and navigate the
-internal Apache configuration.
-
-Internally, this information is stored in a tree structure. Each node
-in the tree has a reference to its parent (if it's not the root), its
-first child (if any), and to its next sibling.
-
-BAll these methods are read-only
+CApache::Directive provides the Perl API for manipulating the Apache
+configuration tree
@@ -256,7 +255,11 @@
=item arg1: C$directive ( string )
+The name of the directive to search for
+
=item opt arg2: Cargs ( string )
+
+Optional args to the directive to filter for
=item ret: C$string ( string / ARRAY of HASHES )
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Command.pod
gozer 2004/09/13 12:09:50 Modified:src/docs/2.0/api/Apache Command.pod Log: fix little markup for undef Revision ChangesPath 1.10 +1 -1 modperl-docs/src/docs/2.0/api/Apache/Command.pod Index: Command.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Command.pod,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- Command.pod 13 Sep 2004 19:01:53 - 1.9 +++ Command.pod 13 Sep 2004 19:09:50 - 1.10 @@ -130,7 +130,7 @@ =item ret: C$next ( CLApache::Command object|docs::2.0::api::Apache::Command ) -Returns the next command in the chain for this module, undef for +Returns the next command in the chain for this module, Cundef for the last command. =item since: 1.99_12 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache CmdParms.pod
gozer 2004/09/13 14:18:56
Modified:src/docs/2.0/api/Apache CmdParms.pod
Log:
add a sample @APACHE_MODULE_COMMANDS to better illustrate info
Revision ChangesPath
1.14 +7 -0 modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod
Index: CmdParms.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- CmdParms.pod 13 Sep 2004 21:07:09 - 1.13
+++ CmdParms.pod 13 Sep 2004 21:18:56 - 1.14
@@ -10,6 +10,13 @@
use Apache::CmdParms ();
use Apache::Const -compile = qw(NOT_IN_LOCATION);
+ our @APACHE_MODULE_COMMANDS = (
+{
+ name = 'MyDirective',
+ cmd_data = 'some extra data',
+},
+ );
+
sub MyDirective {
my($self, $parms, $args) = @_;
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache CmdParms.pod
gozer 2004/09/13 14:42:52 Modified:src/docs/2.0/api/Apache CmdParms.pod Log: Rewrite an unclear sentence Revision ChangesPath 1.16 +1 -1 modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod Index: CmdParms.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- CmdParms.pod 13 Sep 2004 21:38:23 - 1.15 +++ CmdParms.pod 13 Sep 2004 21:42:52 - 1.16 @@ -368,7 +368,7 @@ =head2 Cserver -The server this command is appearing in +The (vhost) server this command was defined in Fhttpd.conf $s = $parms-server; - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Module.pod
gozer 2004/09/13 15:37:30 Modified:src/docs/2.0/api/Apache Module.pod Log: Clarify the meaning of $module-version Revision ChangesPath 1.20 +3 -2 modperl-docs/src/docs/2.0/api/Apache/Module.pod Index: Module.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Module.pod,v retrieving revision 1.19 retrieving revision 1.20 diff -u -r1.19 -r1.20 --- Module.pod13 Sep 2004 22:36:44 - 1.19 +++ Module.pod13 Sep 2004 22:37:30 - 1.20 @@ -370,8 +370,9 @@ =head2 Cversion -Get the API version, Bnot module version; check that module is -compatible with this version of the server. +Get the httpd API version this module was build against, Bnot +the module's version; Used to check that module is compatible +with this version of the server before loading it. $version = $module-version(); - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/ModPerl Util.pod
gozer 2004/09/09 16:17:38
Modified:src/docs/2.0/api/ModPerl Util.pod
Log:
it's called unload_package, not unload_module
Revision ChangesPath
1.14 +5 -5 modperl-docs/src/docs/2.0/api/ModPerl/Util.pod
Index: Util.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/ModPerl/Util.pod,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- Util.pod 9 Sep 2004 22:41:16 - 1.13
+++ Util.pod 9 Sep 2004 23:17:38 - 1.14
@@ -19,7 +19,7 @@
ModPerl::Util::untaint($string);
# removes a module as best as it can
- ModPerl::Util::unload_module($module);
+ ModPerl::Util::unload_package($module);
@@ -161,12 +161,12 @@
-=head2 Cunload_module
+=head2 Cunload_package
Unloads a stash from the current Perl interpreter in the safest way
possible.
- ModPerl::Util::unload_module($stash);
+ ModPerl::Util::unload_package($stash);
=over 4
@@ -190,9 +190,9 @@
This function may wipe off things loaded by other modules, if the
latter have inserted things into the C$stash it was told to unload.
-Cunload_module() takes care not to delete sub-stashes when deleting
+Cunload_package() takes care not to delete sub-stashes when deleting
the requested stash. So for example if CCGI and CCGI::Carp are
-loaded, calling Cunload_module('CGI') won't affect CCGI::Carp.
+loaded, calling Cunload_package('CGI') won't affect CCGI::Carp.
If the module's stash had a corresponding XS shared object loaded it
will be unloaded as well.
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/ModPerl Util.pod
gozer 2004/09/09 16:20:24 Modified:src/docs/2.0/api/ModPerl Util.pod Log: Note that unload_package() will also remove an %INC entry if any. Revision ChangesPath 1.15 +2 -0 modperl-docs/src/docs/2.0/api/ModPerl/Util.pod Index: Util.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/ModPerl/Util.pod,v retrieving revision 1.14 retrieving revision 1.15 diff -u -r1.14 -r1.15 --- Util.pod 9 Sep 2004 23:17:38 - 1.14 +++ Util.pod 9 Sep 2004 23:20:24 - 1.15 @@ -197,6 +197,8 @@ If the module's stash had a corresponding XS shared object loaded it will be unloaded as well. +If the module was in Perl's C%INC, it will be removed from it. + - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Reload.pod
gozer 2004/09/09 11:29:34
Modified:src/docs/2.0/api/Apache Reload.pod
Log:
Add Apache::Reload-unregister_module() to explicitely remove a
module from Apache::Reload's monitoring list
Revision ChangesPath
1.11 +7 -0 modperl-docs/src/docs/2.0/api/Apache/Reload.pod
Index: Reload.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Reload.pod,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- Reload.pod22 May 2004 02:03:27 - 1.10
+++ Reload.pod9 Sep 2004 18:29:34 - 1.11
@@ -151,6 +151,13 @@
magically reloaded on the next request. This option works with any
mode described before.
+=head2 Unregistering a module
+
+In some cases, it might be necessary to explicitely stop reloading
+a module.
+
+ Apache::Reload-unregister_module('Some::Module');
+
=head1 Performance Issues
This modules is perfectly suited for a development environment. Though
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Reload.pod
gozer 2004/09/09 11:43:45
Modified:src/docs/2.0/api/Apache Reload.pod
Log:
Note that Apache::Reload-unregister_module() only unregisters the module
from the current interpreter.
Revision ChangesPath
1.12 +4 -0 modperl-docs/src/docs/2.0/api/Apache/Reload.pod
Index: Reload.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Reload.pod,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- Reload.pod9 Sep 2004 18:29:34 - 1.11
+++ Reload.pod9 Sep 2004 18:43:45 - 1.12
@@ -158,6 +158,10 @@
Apache::Reload-unregister_module('Some::Module');
+But be carefull, since unregistering a module in this way will only
+do so for the current interpreter. This feature should be used with
+care.
+
=head1 Performance Issues
This modules is perfectly suited for a development environment. Though
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/ModPerl Util.pod
gozer 2004/09/09 15:16:39
Modified:src/docs/2.0/api/Apache Reload.pod
src/docs/2.0/api/ModPerl Util.pod
Log:
Added ModPerl::Util::unload_package() to remove a loaded package
as thoroughly as possible by clearing it's stash.
Revision ChangesPath
1.13 +0 -25 modperl-docs/src/docs/2.0/api/Apache/Reload.pod
Index: Reload.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Reload.pod,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- Reload.pod9 Sep 2004 18:43:45 - 1.12
+++ Reload.pod9 Sep 2004 22:16:39 - 1.13
@@ -19,7 +19,6 @@
PerlSetVar ReloadAll Off
PerlSetVar ReloadModules ModPerl::* Apache::*
#PerlSetVar ReloadDebug On
- #PerlSetVar ReloadConstantRedefineWarnings Off
# Reload a single module from within itself:
package My::Apache::Module;
@@ -197,30 +196,6 @@
reloaded, are actually getting reloaded, turn the debug mode on:
PerlSetVar ReloadDebug On
-
-=head1 Silencing 'Constant subroutine ... redefined at' Warnings
-
-If a module defines constants, e.g.:
-
- use constant PI = 3.14;
-
-and gets re-loaded, Perl issues a mandatory warnings which can't be
-silenced by conventional means (since Perl 5.8.0). This is because
-constants are inlined at compile time, so if there are other modules
-that are using constants from this module, but weren't reloaded they
-will see different values. Hence the warning is mandatory. However
-chances are that most of the time you won't modify the constant
-subroutine and you don't want Ierror_log to be cluttered with
-(hopefully) irrelevant warnings. In such cases, if you haven't
-modified the constant subroutine, or you know what you are doing, you
-can tell CApache::Reload to shut those for you (it overrides
-C$SIG{__WARN__} to accomplish that):
-
- PerlSetVar ReloadConstantRedefineWarnings Off
-
-For the reasons explained above this option is turned on by default.
-
-since: mod_perl 1.99_10
=head1 Caveats
1.11 +34 -0 modperl-docs/src/docs/2.0/api/ModPerl/Util.pod
Index: Util.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/ModPerl/Util.pod,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- Util.pod 25 Aug 2004 21:51:27 - 1.10
+++ Util.pod 9 Sep 2004 22:16:39 - 1.11
@@ -17,6 +17,9 @@
# untaint a string (do not use it! see the doc)
ModPerl::Util::untaint($string);
+
+ # removes a module as best as it can
+ ModPerl::Util::unload_module($module);
@@ -153,6 +156,37 @@
Do not use this function unless you know what you are doing. To learn
how to properly untaint variables refer to the Iperlsec manpage.
+
+
+
+
+
+=head2 Cunload_module
+
+Unloads a module from the current perl interpreter in the safest
+way possible.
+
+ ModPerl::Util::unload_module($module);
+
+=over 4
+
+=item arg1: C$module (scalar)
+
+The name of the module to unload
+
+=item ret: no return value
+
+=item since 1.99_17
+
+=back
+
+Unloading a module from Perl is a complicated business. This function
+tries very hard to do the right thing. After calling this module, it
+should be safe to Cuse a new version of the module.
+
+References to module elements (function, variables, etc) that were taken
+from outside the unloaded module will still be valid.
+
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache CmdParms.pod
gozer 2004/09/09 15:39:13
Modified:src/docs/2.0/api/Apache CmdParms.pod
Log:
Added Apache::CmdParms::add_config() to work around a memory
leak discovered with Perl sections in .htaccess files
Revision ChangesPath
1.10 +30 -1 modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod
Index: CmdParms.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- CmdParms.pod 17 Aug 2004 23:40:57 - 1.9
+++ CmdParms.pod 9 Sep 2004 22:39:13 - 1.10
@@ -13,6 +13,9 @@
sub MyDirective {
my($self, $parms, $args) = @_;
+ # push config
+ $parms-add_config(['ServerTokens off']);
+
# this command's command object
$cmd = $parms-cmd;
@@ -65,6 +68,32 @@
+=head2 Cadd_config
+
+Dynamically add Apache configuration at request processing runtime:
+
+ $parms-add_config($lines);
+
+=over 4
+
+=item obj: C$parms
+( CLApache::CmdParms object|docs::2.0::api::Apache::CmdParms )
+
+=item arg1: C$lines (ARRAY ref)
+
+An ARRAY reference containing configuration lines per element, without
+the new line terminators.
+
+=item ret: no return value
+
+=item since: 1.99_17
+
+=back
+
+See also:
+CL$s-Egtadd_config|docs::2.0::api::Apache::ServerUtil/C_add_config_,
+CL$r-Egtadd_config|docs::2.0::api::Apache::RequestUtil/C_add_config_
+
=head2 Ccmd
This module's command information
@@ -79,7 +108,7 @@
=item ret: C$cmd
( CLApache::Command object|docs::2.0::api::Apache::Command )
-=item since: 1.99_12
+=item since: 1.99_17
=back
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/APR URI.pod
gozer 2004/08/25 15:37:11 Modified:src/docs/2.0/api/APR URI.pod Log: Added APR::URI-rpath method. Returns the path of an uri minus path_info, if any. Revision ChangesPath 1.7 +27 -0 modperl-docs/src/docs/2.0/api/APR/URI.pod Index: URI.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/URI.pod,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- URI.pod 29 May 2004 09:56:29 - 1.6 +++ URI.pod 25 Aug 2004 22:37:10 - 1.7 @@ -19,6 +19,7 @@ print $parsed-hostname; print $parsed-port; print $parsed-path; + print $parsed-rpath; print $parsed-query; print $parsed-fragment; @@ -272,6 +273,32 @@ =item ret: C$oldval ( string or undef ) C/ if only Cscheme://host + +=item since: 1.99_15 + +=back + + + + + +=head2 Crpath + +Gets the CLpath minus the +CLpath_info|docs::2.0::api::Apache::RequestRec/C_path_info_ + + $rpath = $parsed-rpath(); + +=over 4 + +=item obj: C$parsed +( CLAPR::URI object|docs::2.0::api::APR::URI ) + +=item opt arg1: C$newval ( string or undef ) + +=item ret: C$oldval ( string or undef ) + +The path minus the Ipath_info =item since: 1.99_15 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache RequestRec.pod
gozer 2004/08/22 13:48:12
Modified:src/docs/2.0/api/Apache RequestRec.pod
Log:
Added $r-content_languages in Apache::RequestRec
Revision ChangesPath
1.30 +37 -26modperl-docs/src/docs/2.0/api/Apache/RequestRec.pod
Index: RequestRec.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/RequestRec.pod,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- RequestRec.pod12 Aug 2004 06:19:38 - 1.29
+++ RequestRec.pod22 Aug 2004 20:48:12 - 1.30
@@ -33,6 +33,9 @@
# Content-Encoding HTTP response header
$r-content_encoding(gzip);
+ # the languages of the content
+ $languages = $r-content_languages();
+
# Content-Encoding HTTP response header
$r-content_type('text/plain');
@@ -459,6 +462,40 @@
+=head2 Ccontent_languages
+
+Get/set content languages (the Content-Language HTTP header).
+Content languages are string like Ien or Ifr.
+
+ $languages = $r-content_languages();
+ $prev_lang = $r-content_languages($nev_lang);
+
+=over 4
+
+=item obj: C$r
+( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec )
+
+=item opt arg1: C$new_lang ( ARRAY ref )
+
+If passed, sets the content languages to new values. It must be an
+ARRAY ref of language names, like Ien or Ifr
+
+=item ret: C$languages ( ARRAY ref )
+
+The current list of content languages.
+
+If C$new_lang is passed, then the previous value is returned.
+
+=item since: 1.99_16
+
+=back
+
+
+
+
+
+
+
=head2 Ccontent_type
@@ -1884,32 +1921,6 @@
META: APR::ArrayHeader is not available at the moment
-
-
-
-
-
-
-=head2 Ccontent_languages
-
-META: Autogenerated - needs to be reviewed/completed
-
-Array of strings representing the content languages
-
- $array_header = $r-content_languages();
-
-=over 4
-
-=item obj: C$r
-( CLApache::RequestRec object|docs::2.0::api::Apache::RequestRec )
-
-=item ret: C$array_header ( CLAPR::ArrayHeader
object|docs::2.0::api::APR::ArrayHeader )
-
-=item since: 1.99_12
-
-=back
-
-META: APR::ArrayHeader is not available at the moment
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache CmdParms.pod
gozer 2004/08/17 16:40:57
Modified:src/docs/2.0/api/Apache CmdParms.pod
Log:
Apache::CmdParms-limited member replaced by is_method_limited()
method
Revision ChangesPath
1.9 +16 -11modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod
Index: CmdParms.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- CmdParms.pod 14 Aug 2004 04:15:25 - 1.8
+++ CmdParms.pod 17 Aug 2004 23:40:57 - 1.9
@@ -30,7 +30,7 @@
$info = $parms-info;
# which methods are Limited ?
- $limit = $parms-limited;
+ $is_limited = $parms-method_is_limited('GET');
# which allow-override bits are set
$override = $parms-override;
@@ -178,28 +178,33 @@
-=head2 Climited
+=head2 Cmethod_is_limited
-Which methods are currently EltLimitEgted
+Discover if a method is EltLimitEgted in the current scope
- $limit = $parms-limited;
+ $is_limited = $parms-method_is_limited($method);
=over 4
=item obj: C$parms
( CLApache::CmdParms object|docs::2.0::api::Apache::CmdParms )
-=item ret: C$limit ( integer )
+=item arg1: C$method (string)
-=item since: 1.99_12
+The name of the method to check for
+
+=item ret: C$is_limited ( boolean )
+
+=item since: 1.99_15
=back
- META: and how exactly is it supposed to be used, should this be
- tested against $r-method_number (e.g. Apache::M_POST) ? what's
- $limit? (notice that the test of this method isn't so good, it
- tests some hardcoded -1 value, how do you know that it does what you
- think it does?)
+For example, to check if the CGET method is being EltLimitEgted
+in the current scope, do:
+
+ if ($parms-method_is_limited('GET') {
+ die ...;
+ }
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Module.pod
gozer 2004/08/17 16:51:46
Modified:src/docs/2.0/api/Apache Module.pod
Log:
Various improvements for Apache::Module.
Revision ChangesPath
1.8 +87 -87modperl-docs/src/docs/2.0/api/Apache/Module.pod
Index: Module.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Module.pod,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- Module.pod15 Aug 2004 00:52:44 - 1.7
+++ Module.pod17 Aug 2004 23:51:45 - 1.8
@@ -8,7 +8,8 @@
=head1 Synopsis
use Apache::Module ();
-
+
+ # iterate over the whole module list
for (my $modp = Apache::Module-top_module; $modp; $modp = $modp-next) {
my $name = $modp-name;
my $version = $modp-version;
@@ -17,23 +18,44 @@
my $commands = $modp-cmds;
}
+ # find a specific module
+ my $module = Apache::Module::find_linked_module('mod_ssl.c');
+
+ # access module configuration from a directive
sub MyDirective {
my ($self, $parms, $args) = @_;
my $srv_cfg = Apache::Module-get_config($self, $parms-server);
[...]
}
+
+ # test if an Apache module is loaded
+ if (Apache::Module::loaded('mod_ssl.c')) {
+ [...]
+ }
+
+ # test if a Perl module is loaded
+ if (Apache::Module::loaded('Apache::Status')) {
+ [...]
+ }
+
+
+
+
=head1 Description
-The API provided by this module opens up access to Apache's internal module
-list. It can be used to find and query currently enabled/loaded modules.
+CApache::Module provides the Perl API for creating and working with
+Apache modules
See LApache Server Configuration Customization in
Perl|docs::2.0::user::config::custom.
+
+
+
=head1 API
CApache::Module provides the following functions and/or methods:
@@ -45,17 +67,17 @@
=head2 Ccmds
-Get an CLApache::Command|docs::2.0::api::Apache::Command object
+The CLApache::Command|docs::2.0::api::Apache::Command object
that describes all of the directives this module defines.
- $cmd_rec = $module-cmds();
+ $commands = $module-cmds();
=over 4
=item obj: C$module
( CLApache::Module object|docs::2.0::api::Apache::Module )
-=item ret: C$cmd_rec
+=item ret: C$commands
( CLApache::Command object|docs::2.0::api::Apache::Command )
=item since: 1.99_12
@@ -71,25 +93,34 @@
=head2 Cget_config
Retrieves a module's configuration. Used by configuration directives.
-
- $cfg = Apache::Module-get_config($self, $parms-server);
- $cfg = Apache::Module-get_config($self, $r-server, $r-per_dir_config);
+
+ $cfg = Apache::Module-get_config($class, $server, [$dir_config]);
+ $cfg = $self-get_config($server, [$dir_config]);
=over 4
-=item obj: C$self ( string or ref )
+=item obj: C$module
+( CLApache::Module object|docs::2.0::api::Apache::Module )
-The name of the Perl module this configuration is for
+=item arg1: C$class ( string )
-=item obj: C$server
+The perl package this configuration is for
+
+=item arg1: C$server
( CLApache::ServerRec object|docs::2.0::api::Apache::ServerRec )
-=item obj: C$dir_config
+The current server, typically C$r-Egtserver or C$parms-Egtserver
+
+=item opt arg1: C$dir_config
( CLApache::ConfVector object|docs::2.0::api::Apache::ConfVector )
-=item ret: C$cfg (HASH)
+By default, the configuration returned is the server level one. To retrieve
+the per directory configuration, use C$r-Egtper_dir_config as a last
+argument.
-The hash holding the module configuration data.
+=item ret: C$cfg (HASH reference)
+
+A reference to the hash holding the module configuration data.
=back
@@ -104,18 +135,18 @@
Find a module based on the name of the module
- $modp = Apache::Module::find_linked_module($name);
+ $module = Apache::Module::find_linked_module($name);
=over 4
-=item obj: C$name ( string )
+=item arg1: C$name ( string )
-the name of the module
+The name of the module ending in C.c
-=item ret: C$modp
+=item ret: C$module
( CLApache::Module object|docs::2.0::api::Apache::Module )
-the module structure if found, undef otherwise
+The module object if found, undef otherwise
=item since: 1.99_12
@@ -129,30 +160,51 @@
Determines if a certain module is loaded
- if (Apache::Module-loaded($module)) {
- [...]
- }
-
- if (Apache::Module-loaded('Apache::Status')) {
- [...]
- }
-
-The argument to this function can be many things. If the module ends in
-'.c', true will be returned if that module is loaded If the module ends
-in '.so', true will be returned if that module is loaded and was loaded
-as a DSO with LoadModule
cvs commit: modperl-docs/src/docs/2.0/api/Apache Module.pod
gozer 2004/08/18 11:06:15
Modified:src/docs/2.0/api/Apache Module.pod
Log:
Geoff pointed out that there was at least one documented use of
$module-remove, so Apache::Module-remove_loaded_module should
not have been removed. Re-adding it with documentation.
Revision ChangesPath
1.11 +24 -0 modperl-docs/src/docs/2.0/api/Apache/Module.pod
Index: Module.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Module.pod,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- Module.pod18 Aug 2004 01:26:45 - 1.10
+++ Module.pod18 Aug 2004 18:06:14 - 1.11
@@ -21,6 +21,9 @@
# find a specific module
my $module = Apache::Module::find_linked_module('mod_ssl.c');
+ # remove a specific module
+ $module-remove_loaded_module();
+
# access module configuration from a directive
sub MyDirective {
my ($self, $parms, $args) = @_;
@@ -290,6 +293,27 @@
=item since: 1.99_12
=back
+
+
+
+
+
+
+=head2 Cremove_loaded_module
+
+Remove a module from the list of loaded modules permanently.
+
+ $module-remove_loaded_module();
+
+=over 4
+
+=item obj: C$module
+( CLApache::Module object|docs::2.0::api::Apache::Module )
+
+=item since: 1.99_12
+
+=back
+
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache CmdParms.pod Command.pod
gozer 2004/08/12 22:45:50
Modified:src/docs/2.0/api/Apache CmdParms.pod Command.pod
Log:
Apache::CmdParms is completed.
Awaiting review by Stas please...
Revision ChangesPath
1.6 +109 -181 modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod
Index: CmdParms.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- CmdParms.pod 10 Aug 2004 03:15:52 - 1.5
+++ CmdParms.pod 13 Aug 2004 05:45:49 - 1.6
@@ -1,6 +1,6 @@
=head1 NAME
-Apache::CmdParms - Perl API for XXX
+Apache::CmdParms - Perl API for Apache command parameters object
@@ -8,15 +8,50 @@
=head1 Synopsis
use Apache::CmdParms ();
+ use Apache::Const -compile = qw(NOT_IN_LOCATION);
+
+ sub MyDirective {
+my ($self, $parms, $args) = @_;
+
+# this command's command object
+$cmd = $parms-cmd;
+
+# check the current command's context
+$error = $parms-check_cmd_context(Apache::NOT_IN_LOCATION);
+
+# this command's context
+$context = $parms-context;
+
+# this command's directive object
+$directive = $parms-directive;
+
+# the extra information passed thru cmd_data in @APACHE_MODULE_COMMANDS
+$info = $parms-info;
+
+# which methods are Limited ?
+$limit = $parms-limited;
+
+# which allow-override bits are set
+$override = $parms-override;
+
+# the path this command is being invoked in
+$path = $parms-path;
+
+# this command's pool
+$p = $parms-pool;
+
+# this command's configuration time pool
+$p = $parms-temp_pool;
+ }
-META: to be completed
=head1 Description
-META: to be completed
+CApache::CmdParms provides the Perl API for Apache command
+parameters object.
@@ -27,110 +62,68 @@
-Comments for Philippe:
-
- should the elements of ap_params_t elements be writable? see the
- comments in the API section of the Command.pod and Directive.pod. if
- unsure, make things read-only. we can always enable them back later.
-
-
-
=head2 Ccmd
-META: Autogenerated - needs to be reviewed/completed
-
-configuration command
+This module's command information
- $obj-cmd($newval);
+ $cmd = $parms-cmd();
=over 4
-=item obj: C$obj
+=item parms: C$parms
( CLApache::CmdParms object|docs::2.0::api::Apache::CmdParms )
-=item arg1: C$newval
+=item ret: C$cmd
( CLApache::Command object|docs::2.0::api::Apache::Command )
-=item ret: no return value
-
-=item since: 1.99_12
-
-=back
-
-
-
-
-
-=head2 Cconfig_file
-
-META: Autogenerated - needs to be reviewed/completed
-
-Config file structure.
-
- $obj-config_file($newval);
-
-=over 4
-
-=item obj: C$obj
-( CLApache::CmdParms object|docs::2.0::api::Apache::CmdParms )
-
-=item arg1: C$newval
-( CLApache::ConfigFile object|docs::2.0::api::Apache::ConfigFile )
-
-=item ret: no return value
-
=item since: 1.99_12
-
=back
-=head2 Ccontext
-META: Autogenerated - needs to be reviewed/completed
+=head2 Ccheck_cmd_context
-per_dir_config vector passed to handle_command
+Check the current command against a context bitmask of forbidden contexts.
- $obj-context($newval);
+ $error = $parms-check_cmd_context(Apache::NOT_IN_LOCATION);
=over 4
-=item obj: C$obj
+=item parms: C$parms
( CLApache::CmdParms object|docs::2.0::api::Apache::CmdParms )
-=item arg1: C$newval
-( CLApache::ConfVector object|docs::2.0::api::Apache::ConfVector )
+=item ret: C$error
-=item ret: no return value
+If the context is forbidden, this method returns a textual description
+of why it was forbidden. If the context is permitted, this method returns
+Cundef.
-=item since: 1.99_12
+=item since: 1.99_16
=back
-
=head2 Cdirective
-META: Autogenerated - needs to be reviewed/completed
-
-the directive specifying this command
+This command's directive object in the configuration tree
- $obj-directive($newval);
+ $directive = $parms-directive;
=over 4
-=item obj: C$obj
+=item parms: C$parms
( CLApache::CmdParms object|docs::2.0::api::Apache::CmdParms )
-=item arg1: C$newval
+=item ret: C$newval
( CLApache::Directive object|docs::2.0::api::Apache::Directive )
-=item ret: no return value
+The current directive node in the configuration tree
=item since: 1.99_12
@@ -141,47 +134,21 @@
-=head2 Cerr_directive
-
-META: Autogenerated - needs to be reviewed/completed
-
-directive with syntax error
-
- $obj
cvs commit: modperl-docs/src/docs/2.0/api/Apache Directive.pod
gozer 2004/08/10 16:02:01
Modified:src/docs/2.0/api/Apache Directive.pod
Log:
Reviewed and completed Apache::Directive API documentation
Revision ChangesPath
1.7 +10 -124 modperl-docs/src/docs/2.0/api/Apache/Directive.pod
Index: Directive.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Directive.pod,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- Directive.pod 10 Aug 2004 03:15:52 - 1.6
+++ Directive.pod 10 Aug 2004 23:02:01 - 1.7
@@ -16,14 +16,13 @@
my $vhost = $tree-lookup('VirtualHost', 'localhost:8000');
my $servername = $vhost-{'ServerName'};
- print $tree-as_string;
-
use Data::Dumper;
print Dumper($tree-as_hash);
my $node = $tree;
while ($node) {
-
+ print $node-as_string;
+
#do something with $node
if (my $kid = $node-first_child) {
@@ -55,7 +54,7 @@
in the tree has a reference to its parent (if it's not the root), its
first child (if any), and to its next sibling.
-
+BAll these methods are read-only
@@ -69,48 +68,18 @@
-Comments for Philippe:
-
- should the elements of ap_directive_t elements be writable? if not
- set those to readonly, e.g to set args to read only change
- xs/maps/apache_structures.map and add '' at the beginning of the
- line:
-
- ap_directive_t
- directive
-args
- next
- ...
- /ap_directive_t
-
- in either case make sure to adjust the docs whether each method is
- readonly or read/write.
-
-
-
-
-
-
-
-=head2 Cargs
-
-META: Autogenerated - needs to be reviewed/completed
+=head2 Cargs
The arguments for the current directive, stored as a space separated
list
$args = $node-args();
- $prev_args = $node-args($new_val);
=over 4
=item obj: C$node
( CLApache::Directive object|docs::2.0::api::Apache::Directive )
-=item opt arg1: C$new_val) ( string )
-
-XXX
-
=item ret: C$args ( string )
=item since: 1.99_12
@@ -121,10 +90,8 @@
=head2 Cas_hash
-META: Autogenerated - needs to be reviewed/completed
-
Returns a hash representation of the configuration tree, in a format
-suitable for inclusion in the EltPerlEgt sections.
+suitable for inclusion in EltPerlEgt sections.
$config_hash = $conftree-as_hash();
@@ -148,16 +115,14 @@
=head2 Cas_string
-META: Autogenerated - needs to be reviewed/completed
-
-Returns a string representation of the configuration tree, in
-Fhttpd.conf format.
+Returns a string representation of the configuration node, in
+Fhttpd.conf format. This does not traverse down to sub-trees.
- $string = $conftree-as_string();
+ $string = $node-as_string();
=over 4
-=item obj: C$conftree
+=item obj: C$node
( CLApache::Directive object|docs::2.0::api::Apache::Directive )
The config tree to stringify
@@ -172,8 +137,6 @@
=head2 Cconftree
-META: Autogenerated - needs to be reviewed/completed
-
Returns the root of the configuration tree.
$tree = Apache::Directive-conftree();
@@ -192,37 +155,8 @@
-=head2 Cdata
-
-META: Autogenerated - needs to be reviewed/completed
-
-directive's module can store add'l data here
-
- $ret = $conftree-data($newval);
-
-=over 4
-
-=item obj: C$conftree
-( CLApache::Directive object|docs::2.0::api::Apache::Directive )
-
-=item arg1: C$newval XXX
-
-=item ret: XXX
-
-=item since: 1.99_12
-
-=back
-
-
-
-
-
-
-
=head2 Cdirective
-META: Autogenerated - needs to be reviewed/completed
-
Returns the name of the directive in C$node.
$name = $node-directive();
@@ -244,8 +178,6 @@
=head2 Cfilename
-META: Autogenerated - needs to be reviewed/completed
-
Returns the filename the configuration node was created from
$filename = $node-filename();
@@ -267,8 +199,6 @@
=head2 Cfirst_child
-META: Autogenerated - needs to be reviewed/completed
-
The first child node of this directive
$subtree = $node-first_child;
@@ -292,8 +222,6 @@
=head2 Cline_num
-META: Autogenerated - needs to be reviewed/completed
-
Returns the line number in Cfilename this node was created from
$lineno = $node-line_num();
@@ -314,8 +242,6 @@
=head2 Clookup
-META: Autogenerated - needs to be reviewed/completed
-
Returns node(s) matching a certain value.
$node = $conftree-lookup($directive, $args);
@@ -332,7 +258,7 @@
=item opt arg2: Cargs ( string )
-=item ret: C$string ( string )
+=item ret: C$string ( string / ARRAY of HASHES )
In list context, it will return all matching nodes
cvs commit: modperl-docs/src/docs/2.0/api/Apache Module.pod
gozer 2004/08/10 16:58:42 Modified:src/docs/2.0/api/Apache Module.pod Log: Apache::Module::find_linked_module is a function not a method Revision ChangesPath 1.6 +1 -1 modperl-docs/src/docs/2.0/api/Apache/Module.pod Index: Module.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Module.pod,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- Module.pod10 Aug 2004 18:13:23 - 1.5 +++ Module.pod10 Aug 2004 23:58:42 - 1.6 @@ -104,7 +104,7 @@ Find a module based on the name of the module - $modp = Apache::Module-find_linked_module($name); + $modp = Apache::Module::find_linked_module($name); =over 4 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Command.pod
gozer 2004/08/10 21:50:56
Modified:src/docs/2.0/api/Apache Command.pod
Log:
Fully reviewed and partially completed.
There is also the issue of
check_cmd_context and soak_end_container
probably belonging in Apache::CmdParams
Revision ChangesPath
1.5 +34 -88modperl-docs/src/docs/2.0/api/Apache/Command.pod
Index: Command.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Command.pod,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- Command.pod 10 Aug 2004 03:15:52 - 1.4
+++ Command.pod 11 Aug 2004 04:50:56 - 1.5
@@ -1,25 +1,31 @@
=head1 NAME
-Apache::Command - Perl API for XXX
+Apache::Command - Perl API for accessing Apache module command information
=head1 Synopsis
+ use Apache::Module ();
use Apache::Command ();
-
-META: to be completed
-
-
-
+ my $module = Apache::Module::find_linked_module('mod_perl.c');
+ my $cmd = $module-cmds();
+
+ while ($cmd) {
+$cmd-args_how();
+$cmd-errmsg();
+$cmd-req_override();
+$cmd = $cmd-next();
+ }
=head1 Description
-META: to be completed
-
-
+Each apache module can define a list of configuration commands it offers.
+This interface gives access to information about these configuration
commands.
+Each module contains a chained-list of Apache::Command objects, each
representing a single directive.
+For example, CPerlRequire is a command offered by mod_perl.
=head1 API
@@ -27,44 +33,20 @@
-Comments for Philippe:
-
- should the elements of ap_command_t elements be writable? if not
- set those to readonly, e.g to set func to read-only change
- xs/maps/apache_structures.map and add '' at the beginning of the
- line:
-
- command_rec
- name
-func
- cmd_data
- ...
- /command_rec
-
- in either case make sure to adjust the docs whether each method is
- readonly or read/write.
-
-
-
-
-
-
=head2 Cargs_how
-META: Autogenerated - needs to be reviewed/completed
-
What the command expects as arguments
- $obj-args_how($newval);
+ $obj-args_how();
=over 4
=item obj: C$obj
( CLApache::Command object|docs::2.0::api::Apache::Command )
-=item arg1: C$newval (integer)
+=item ret: ( integer )
-=item ret: no return value
+The flag value representing the type of command (i.e. ITERATE/TAKE2)
=item since: 1.99_12
@@ -76,7 +58,7 @@
=head2 Ccheck_cmd_context
-META: Autogenerated - needs to be reviewed/completed
+META: This probably belongs in Apache::CmdParams
$ret = $cmd-check_cmd_context($forbidden);
@@ -93,33 +75,7 @@
=item ret: C$ret ( string )
-Error string on error, NULL on success
-
-=item since: 1.99_12
-
-=back
-
-
-
-
-
-=head2 Ccmd_data
-
-META: Autogenerated - needs to be reviewed/completed
-
-Extra data, for functions which implement multiple commands...
-
- $cmd_data = $obj-cmd_data();
- $prev_cmd_data = $obj-cmd_data($new_cmd_data);
-
-=over 4
-
-=item obj: C$obj
-( CLApache::Command object|docs::2.0::api::Apache::Command )
-
-=item opt arg1: C$new_cmd_data (XXX)
-
-=item ret: no return value
+Error string on error, Cundef on success
=item since: 1.99_12
@@ -129,25 +85,20 @@
-
-
-
=head2 Cerrmsg
-META: Autogenerated - needs to be reviewed/completed
-
-'usage' message, in case of syntax errors
+'usage' message for that command, in case of syntax errors
- $obj-errmsg($newval);
+ $obj-errmsg();
=over 4
=item obj: C$obj
( CLApache::Command object|docs::2.0::api::Apache::Command )
-=item arg1: C$newval ( string )
+=item ret: ( string )
-=item ret: no return value
+The error message
=item since: 1.99_12
@@ -161,21 +112,18 @@
=head2 Cname
-META: Autogenerated - needs to be reviewed/completed
-
Name of this command
$name = $obj-name();
- $prev_name = $obj-name($new_name);
=over 4
=item obj: C$obj
( CLApache::Command object|docs::2.0::api::Apache::Command )
-=item opt arg1: C$new_name ( string )
+=item ret: ( string )
-=item ret: no return value
+The command name
=item since: 1.99_12
@@ -187,7 +135,7 @@
=head2 Cnext
-META: Autogenerated - needs to be reviewed/completed
+The next command in the chain of commands for this module
$ret = $cmd-next();
@@ -212,20 +160,18 @@
=head2 Creq_override
-META: Autogenerated - needs to be reviewed/completed
-
What overrides need to be allowed to enable this command.
- $obj-req_override($newval);
+ $obj-req_override
=over 4
=item
cvs commit: modperl-docs/src/docs/2.0/api/Apache Command.pod
gozer 2004/08/11 11:15:07 Modified:src/docs/2.0/api/Apache Command.pod Log: soak_end_container was removed. Revision ChangesPath 1.6 +0 -34 modperl-docs/src/docs/2.0/api/Apache/Command.pod Index: Command.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Command.pod,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- Command.pod 11 Aug 2004 04:50:56 - 1.5 +++ Command.pod 11 Aug 2004 18:15:06 - 1.6 @@ -181,40 +181,6 @@ -=head2 Csoak_end_container - -META: This probably belongs in Apache::CmdParams - -Read all data between the current EltCommandEgt and the matching -Elt/CommandEgt. All of this data is forgotten immediately. - - $ret = $cmd-soak_end_container($directive); - -=over 4 - -=item obj: C$cmd -( CLApache::CmdParms object|docs::2.0::api::Apache::CmdParms ) - -The cmd_parms to pass to the directives inside the container - -=item arg1: C$directive ( string ) - -The directive name to read until - -=item ret: C$ret ( string ) - -Error string on failure, Cundef on success - -=item since: 1.99_12 - -=back - - - - - - - =head1 See Also Lmod_perl 2.0 documentation|docs::2.0::index. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache Const.pod
gozer 2004/08/11 15:52:42 Modified:src/docs/2.0/api/Apache Const.pod Log: Document the new :context group of constants NOT_IN_VIRTUALHOST NOT_IN_LIMIT NOT_IN_DIRECTORY NOT_IN_LOCATION NOT_IN_FILES NOT_IN_DIR_LOC_FILE GLOBAL_ONLY Revision ChangesPath 1.17 +96 -0 modperl-docs/src/docs/2.0/api/Apache/Const.pod Index: Const.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Const.pod,v retrieving revision 1.16 retrieving revision 1.17 diff -u -r1.16 -r1.17 --- Const.pod 9 Aug 2004 00:26:23 - 1.16 +++ Const.pod 11 Aug 2004 22:52:42 - 1.17 @@ -418,6 +418,102 @@ +=head2 C:context + + use Apache::Const -compile = qw(:context); + +The C:context group is for constants that allow directive +handlers to check what kind of context (Location/Directory/Server/etc) +they are in. For more information, see LApache::CmdParms + +=head3 CApache::NOT_IN_VIRTUALHOST + +=over + +=item since: 1.99_16 + +=back + + + +=head3 CApache::NOT_IN_LIMIT + +=over + +=item since: 1.99_16 + +=back + + + + + + +=head3 CApache::NOT_IN_DIRECTORY + +=over + +=item since: 1.99_16 + +=back + + + + + + +=head3 CApache::NOT_IN_LOCATION + +=over + +=item since: 1.99_16 + +=back + + + + + + +=head3 CApache::NOT_IN_FILES + +=over + +=item since: 1.99_16 + +=back + + + + + + + +=head3 CApache::NOT_IN_DIR_LOC_FILE + +=over + +=item since: 1.99_16 + +=back + + + + + + +=head3 CApache::GLOBAL_ONLY + +=over + +=item since: 1.99_16 + +=back + + + + + =head2 C:filter_type - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/advocacy issues.pod
gozer 2004/08/10 09:00:15 Modified:src/advocacy issues.pod Log: Note that David Wheeler is helping out making sure blosxom version 3.0 will run clean under mod_perl 2.0 Revision ChangesPath 1.2 +5 -0 modperl-docs/src/advocacy/issues.pod Index: issues.pod === RCS file: /home/cvs/modperl-docs/src/advocacy/issues.pod,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- issues.pod9 Aug 2004 05:58:59 - 1.1 +++ issues.pod10 Aug 2004 16:00:14 - 1.2 @@ -232,6 +232,11 @@ =item * Mason +=item * Blosxom (Lhttp://www.blosxom.com/) + +David Wheeler is helping in making sure version 3.0 is +mod_perl 2.0 ready + =back =head3 Numbers - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/advocacy - New directory
gozer 2004/08/08 16:48:25 modperl-docs/src/advocacy - New directory - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache PerlSections.pod
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 Perl1;/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 ChangesPath 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 - 1.39 +++ release 9 Aug 2004 00:56:46 - 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-devm=106074969831522w=2 - owner: gozer - * Fixing Apache-warn(foo) Report: http://mathforum.org/epigone/modperl-dev/noxtramcay/[EMAIL PROTECTED] 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 - 1.13 +++ PerlSections.pod 9 Aug 2004 00:56:46 - 1.14 @@ -334,6 +334,33 @@ +=head2 EltPerlEgt[...] was not closed. + +On encountering a one-line EltPerlEgt 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: + Perluse was not closed. + +If you have written a simple one-line EltPerlEgt +section like this one : + + Perluse 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: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/Apache PerlSections.pod
gozer 2004/08/08 21:34:54 Modified:src/docs/2.0/api/Apache PerlSections.pod Log: Fix the typo fix. It wasn't a stray but it needed to be escaped proprely Revision ChangesPath 1.16 +1 -1 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.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- PerlSections.pod 9 Aug 2004 01:20:34 - 1.15 +++ PerlSections.pod 9 Aug 2004 04:34:54 - 1.16 @@ -334,7 +334,7 @@ -=head2 EltPerlEgt[...] was not closed. +=head2 EltPerlEgt[...]Egt was not closed. On encountering a one-line EltPerlEgt block, httpd's configuration parser will cause a startup - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/advocacy .cvsignore config.cfg issues.pod
gozer 2004/08/08 22:58:59 Modified:src config.cfg Added: src/advocacy .cvsignore config.cfg issues.pod Log: Initial advocacy document generated from the OSCon PR BOF as well as last week's traffic on advocacy@perl.apache.org Revision ChangesPath 1.40 +1 -0 modperl-docs/src/config.cfg Index: config.cfg === RCS file: /home/cvs/modperl-docs/src/config.cfg,v retrieving revision 1.39 retrieving revision 1.40 diff -u -r1.39 -r1.40 --- config.cfg20 Aug 2003 21:56:34 - 1.39 +++ config.cfg9 Aug 2004 05:58:59 - 1.40 @@ -22,6 +22,7 @@ maillist products contribute +advocacy about )], 1.1 modperl-docs/src/advocacy/.cvsignore Index: .cvsignore === cache.*.dat 1.1 modperl-docs/src/advocacy/config.cfg Index: config.cfg === use vars qw(@c); @c = ( id = 'advocacy', title = Got mod_perl?, abstract = EOB, Advocacy documents and resources for mod_perl EOB chapters = [qw( issues.pod )], ); 1.1 modperl-docs/src/advocacy/issues.pod Index: issues.pod === =head1 NAME Known advocacy issues =head1 Description This document keeps track of issues brought up on the Lmod_perl Advocacy|maillist::advocacy mailing-list. It serves as a repository of things people volunteered to do, good ideas missing a volunteer, and overall strategies towards world domination. If you want to become a part of the effort, make sure to join the list! =head1 Marketing =head2 New Users =head3 Newbies How can we make it even easier and smoother for newbies to introduce themselves with mod_perl ? =head4 Quick Start Guide It was suggested that we have a better quick start guide for new users with stub handlers, stub apache configs, etc. Maybe have a run in place installation for people to try mod_perl. =head3 Sysadmins =head3 ISPs and Hosting providers Ideas and tasks to increase the overall availability of mod_perl at ISPs and hosting providers =head4 mod_perl web host provider HOWTO It is difficult to find mod_perl friendly hosting providers. Except full hosted server or User Mode Linux which still means they have to maintain an entire server. Should we maybe have a How to be a mod_perl web host provider? HOWTO? =head2 Articles Ideas for possible articles and existing articles awaiting publication =over =item * Protocol Handlers Demonstrate the ability to write protocol handlers in mp2 by creating a server that speaks something other than HTTP. The only trouble is, I'm having a hard time coming up with a scenario where I would really advise using a different protocol... =item * A better DBD::Proxy Build a better DBD::Proxy by making it use XML-RPC or SOAP (or teach mp2 to speak PlRPC with a protocol handler!) and talk to an Apache::DBI-enabled server. This should be much faster than the current system which doesn't use persistent connections, and would allow all the standard apache logging and access control stuff to be used. =item * Post-processing PHP Use an mp2 filter to do something that would have been impossible before, like efficiently post-processing a PHP script (which also demonstrates that PHP has no access to the apache API). =item * Filter to apply XSL transform Use an mp2 filter to apply an XSL transform to some XML content. =item * Filter to automate Cache-Control Use an mp2 filter to automate some of the cache control suggestions from Michael Radwin's OSCON talk: Lhttp://public.yahoo.com/~radwin/talks/http-caching.htm =item * Cookie-less sessions Use an mp2 filter to implement cookie-less sessions by rewriting URLs and adding hidden fields to forms. =item * Version-controlled websites Write a handler that fetches content from CVS or Subversion, with the branch to use being set by a cookie or URL param or virtualhost name. This would be for content people working on version-controlled websites to use. =back =head3 Perrin Harkins Has an article about a client's conversion to mod_perl, thinking about submitting to Linux Journal and/or Dr. Dobbs. =head3 Randal Schwartz Volunteered to interview TicketMaster employees for his column. Has written articles mentioning mod_perl: Lhttp://www.stonehenge.com/merlyn/LinuxMag/col03.html Lhttp://www.stonehenge.com/merlyn/LinuxMag/col17.html Lhttp
cvs commit: modperl-docs/src/docs/2.0/api/Apache PerlSections.pod
gozer 2004/03/17 15:44:07 Modified:src/docs/2.0/api/Apache PerlSections.pod Log: Minimally document @PerlConfig and $PerlConfig in Perl sections Revision ChangesPath 1.10 +13 -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.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- PerlSections.pod 29 Feb 2004 08:54:59 - 1.9 +++ PerlSections.pod 17 Mar 2004 23:44:07 - 1.10 @@ -110,6 +110,19 @@ + +=head1 @PerlConfig and $PerlConfig + +This array and scalar can be used to introduce litteral configuration +into the apache configuration. For example: + + push @PerlConfig, 'Alias /foo /bar'; + +Or: + $PerlConfig .= Alias /foo /bar\n; + +See also CL$r-Egtadd_config|docs::2.0::api::Apache::RequestUtil/C_add_config_ + - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/config custom.pod
gozer 2004/03/08 13:54:05
Modified:src/docs/2.0/user/config custom.pod
Log:
Fix a small typo:
foreach my $k (keys %a, %b) {
does not work as expected, must be written as:
foreach my $k (keys %a, keys %b) {
Revision ChangesPath
1.9 +1 -1 modperl-docs/src/docs/2.0/user/config/custom.pod
Index: custom.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/config/custom.pod,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- custom.pod5 Aug 2003 17:00:45 - 1.8
+++ custom.pod8 Mar 2004 21:54:05 - 1.9
@@ -910,7 +910,7 @@
my($base, $add) = @_;
my %mrg = ();
- for my $key (keys %$base, %$add) {
+ for my $key (keys %$base, keys %$add) {
next if exists $mrg{$key};
if ($key eq 'MyPlus') {
$mrg{$key} = ($base-{$key}||0) + ($add-{$key}||0);
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/api/Apache PerlSections.pod
gozer 2004/02/27 18:52:16 Modified:src/docs/1.0/api/Apache PerlSections.pod Log: typo Revision ChangesPath 1.5 +1 -1 modperl-docs/src/docs/1.0/api/Apache/PerlSections.pod Index: PerlSections.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/api/Apache/PerlSections.pod,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- PerlSections.pod 28 Feb 2004 01:41:34 - 1.4 +++ PerlSections.pod 28 Feb 2004 02:52:16 - 1.5 @@ -19,7 +19,7 @@ =item dump This method will dump out all the configuration variables mod_perl -will be feeding the the apache config gears. The output is suitable +will be feeding to the apache config gears. The output is suitable to read back in via Ceval. Example: - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/products apache-modules.pod
gozer 2004/02/05 13:40:39 Modified:src/products apache-modules.pod Log: I am working on an Apache::Icon port as part of porting Apache::AutoIndex Revision ChangesPath 1.20 +1 -0 modperl-docs/src/products/apache-modules.pod Index: apache-modules.pod === RCS file: /home/cvs/modperl-docs/src/products/apache-modules.pod,v retrieving revision 1.19 retrieving revision 1.20 diff -u -r1.19 -r1.20 --- apache-modules.pod28 Jan 2004 04:18:30 - 1.19 +++ apache-modules.pod5 Feb 2004 21:40:39 - 1.20 @@ -200,6 +200,7 @@ Apache::Requesthttp://httpd.apache.org/apreq/ Apache::Language Philippe M. Chiasson gozer AT cpan.org Apache::AutoIndex Philippe M. Chiasson gozer AT cpan.org + Apache::Icon Philippe M. Chiasson gozer AT cpan.org Apache::Template Geoffrey Young geoff AT modperlcookbook.org =head1 mod_perl 2.0 Specific Modules - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/bugs .cvsignore
gozer 2004/01/21 11:16:49 Added: src/bugs .cvsignore Log: add a missing .cvsignore for cache.*.dat Revision ChangesPath 1.1 modperl-docs/src/bugs/.cvsignore Index: .cvsignore === cache.*.dat - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/about/contributors people.html
gozer 2004/01/15 12:03:28 Modified:src/about/contributors people.html Log: Geoff forgot to run ./make.pl after changing his info in contributors Revision ChangesPath 1.17 +12 -9 modperl-docs/src/about/contributors/people.html Index: people.html === RCS file: /home/cvs/modperl-docs/src/about/contributors/people.html,v retrieving revision 1.16 retrieving revision 1.17 diff -u -r1.16 -r1.17 --- people.html 14 Jan 2004 01:23:46 - 1.16 +++ people.html 15 Jan 2004 20:03:28 - 1.17 @@ -163,7 +163,7 @@ a href=#geoffrey-youngGeoffrey Young/a /td td class=table-bg -Modules, documentation/code patches. Co-authored mod_perl Developer's Cookbook +modules, documentation, development. /td /tr @@ -774,6 +774,8 @@ p a name=geoffrey-young/a +img src=geoffrey-young.jpg alt=Picture of Geoffrey Young align=right + bName: /b Geoffrey Youngbr @@ -787,14 +789,15 @@ /p -pGeoff has co-authored a href=http://www.modperlcookbook.org/;The -mod_perl Developer's Cookbook/a that mod_perl people seem to be -enjoying. He has also written some a -href=http://www.cpan.org/modules/by-authors/id/G/GE/GEOFF/;ttApache::/tt -modules/a and submitted the occasional code patch to mod_perl -proper. On the documentation site, he has contributed a lot of info -about RPM packages, as well as providing helpful comments and -corrections. +pGeoff has co-authored the a href=http://www.modperlcookbook.org/; +mod_perl Developer's Cookbook/a which seems to be getting good reviews. +He has also written a few a href=http://www.perl.com/pub/au/Young_Geoffrey; +articles/a and the occasional +a href=http://www.cpan.org/modules/by-authors/id/G/GE/GEOFF/;ttApache/tt +module/a. + +/p +pGeoff works on mod_perl for a href=http://www.ticketmaster.com;Ticketmaster/a. /p - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api/ModPerl Util.pod
gozer 2003/12/15 12:26:29 Modified:src/docs/2.0/api/ModPerl Util.pod Log: Upgrade my semi-english to something closer to real english ;-) Revision ChangesPath 1.3 +1 -1 modperl-docs/src/docs/2.0/api/ModPerl/Util.pod Index: Util.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/ModPerl/Util.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- Util.pod 15 Dec 2003 19:45:50 - 1.2 +++ Util.pod 15 Dec 2003 20:26:29 - 1.3 @@ -27,7 +27,7 @@ =item * exit Used internally to replace CORE::exit and terminate the request, -not the whole children. +not the current process. =back - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/download index_top.html
gozer 2003/10/07 21:48:10 Modified:src/download index_top.html Log: mod_perl 1.29 is out Revision ChangesPath 1.14 +1 -1 modperl-docs/src/download/index_top.html Index: index_top.html === RCS file: /home/cvs/modperl-docs/src/download/index_top.html,v retrieving revision 1.13 retrieving revision 1.14 diff -u -r1.13 -r1.14 --- index_top.html29 Sep 2003 17:17:06 - 1.13 +++ index_top.html8 Oct 2003 04:48:10 - 1.14 @@ -6,7 +6,7 @@ pCurrent releases:/p ul -limod_perl 1.0: Version 1.28 - Jul 2, 2003br +limod_perl 1.0: Version 1.29 - Oct 7, 2003br a href=http://perl.apache.org/dist/mod_perl-1.0-current.tar.gz;Download/a | a href=http://perl.apache.org/dist/mod_perl-1.0-current;Browse/a | a href=http://perl.apache.org/dist/mod_perl-1.0-current/Changes;Changes/a | - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/os/win32 install.pod
gozer 2003/08/21 13:09:47 Modified:src/docs/1.0/os/win32 install.pod Log: line containing nothing but whitespace was breaking layout Revision ChangesPath 1.28 +1 -1 modperl-docs/src/docs/1.0/os/win32/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v retrieving revision 1.27 retrieving revision 1.28 diff -u -r1.27 -r1.28 --- install.pod 18 Aug 2003 20:04:02 - 1.27 +++ install.pod 21 Aug 2003 20:09:47 - 1.28 @@ -90,7 +90,7 @@ If you're building Apache yourself from sources, make sure to obtain the Iwin32-src.zip archive, which has the necessary VC++ makefiles. - + =head2 Building with MS Developer Studio =over 3 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/products apache-modules.pod
gozer 2003/07/02 04:57:35 Modified:src/products apache-modules.pod Log: Finally started working on porting my 2 Apache::* modules for mp2, so might as well log it in the documentation. Revision ChangesPath 1.6 +2 -0 modperl-docs/src/products/apache-modules.pod Index: apache-modules.pod === RCS file: /home/cvs/modperl-docs/src/products/apache-modules.pod,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- apache-modules.pod18 Jun 2003 01:42:02 - 1.5 +++ apache-modules.pod2 Jul 2003 11:57:35 - 1.6 @@ -181,6 +181,8 @@ Apache::VMonitor Stas Bekman stas AT stason.org Apache::AuthPerLDAPShannon Eric Peevey speeves AT unt.edu Apache::Requesthttp://httpd.apache.org/apreq/ + Apache::Language Philippe M. Chiasson gozer AT cpan.org + Apache::AutoIndex Philippe M. Chiasson gozer AT cpan.org =head1 Maintainers - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/dist KEYS
gozer 2003/06/08 20:26:38 Modified:src/dist KEYS Log: Added my own key Revision ChangesPath 1.5 +130 -0modperl-docs/src/dist/KEYS Index: KEYS === RCS file: /home/cvs/modperl-docs/src/dist/KEYS,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- KEYS 28 Nov 2002 12:20:58 - 1.4 +++ KEYS 9 Jun 2003 03:26:37 - 1.5 @@ -367,3 +367,133 @@ gOE= =Bycf -END PGP PUBLIC KEY BLOCK- + +pub 1024D/88C3A5A5 2001-03-12 Philippe M. Chiasson (http://perl.apache.org/) [EMAIL PROTECTED] +uidPhilippe M. Chiasson (Canonical) [EMAIL PROTECTED] +uidPhilippe M. Chiasson (Home) [EMAIL PROTECTED] +sub 2048g/122FF51B 2001-03-12 +sub 4096g/C634E37B 2001-07-23 + +-BEGIN PGP PUBLIC KEY BLOCK- +Version: GnuPG v1.2.1 (GNU/Linux) + +mQGiBDqslTIRBAC/oTwqLmp2agvZgMwF0BRes5gsez30OFGLzBI37TG9GashVRTX +CHYu9RPTL1EZ5nezR158xCWSyJP8q/RNJXcwsk5FEeR/pY++oVnJLak0GKt9Kf5Z +n8tbGszwsVGwbbickcFKGa3UIVoevFAJdQh88SO4EOy0hVCdZENLm42TgwCgyGW+ +ptlzgVGGkoUUICscSuhp2jUEAKBXLO195PwIjGa4EVxT5oWWp44Yrf+a9lZ2Vz+S +Lym/q1y4mbV1Yjo14CMBMtLo0auztsgxrFGBy0Ig8sbfyLJMmo3Y2PnY9NEQdWzE +t+/RJeYiNpjPkO3JJQpI+eX/ljl+Z/HlwVBaeK/PGzNu6VcwwX1LInthJeKzzH+p +cCssBACQimjNG7wvG/R46pMUb8A5UnpxTe8APP/EVQqi/Pvkc1UHdJjDinWwuI1Y +0BOKvooFFB2rZGwJNco74fGGNsRttihTTYdIY0tYWUK49Qc5YPd8pVdhhkA/e9ph +jMAQ6EqcZIQ64+aaJ54hiolaOhUM9YywFCy1xigdYAb4Ku2umrQxUGhpbGlwcGUg +TS4gQ2hpYXNzb24gKENhbm9uaWNhbCkgPGdvemVyQGNwYW4ub3JnPohXBBMRAgAX +BQI6rJUyBQsHCgMEAxUDAgMWAgECF4AACgkQyzKhB4jDpaWz9QCgxWemvKGKwcKj +v65zCHtxjGp90uoAni4BTMemfG3o8cAHP/2GsW8t0XAYiJwEEAEBAAYFAjrPcBIA +CgkQUwdH5iPp6rUabgP/SyY2Lpm2LdiM60oX4phMnE/5HDn65y6qIlsBtnxzFRAF +fSJnIrvwgN3gsDi2Nrq4h7hx+0uF/voMynei44DvGWVM0gPYkVqbx6mFw6KNut5x +l1CeJTD7BQHghb2RyWeZ6MvkmcqM/tqdJZMwfdEGoVZW0tsRi7mVTHXhb43qjYyI +RgQQEQIABgUCO1IbpQAKCRBVkeLAZmTAeLuzAKD/C8YBYPeVmufBnBCEFPiPP4ox +hACfUOKfgpzX0KAEhO4BGoTK2Y6R6QuIRgQQEQIABgUCO1xs9wAKCRDndeMk20Gz +h94nAKDKHXdzejV5EkVNCgc9Xi94J1MO/ACfYRp6kki1JQH5y599ftQ68gkP8AWI +RgQQEQIABgUCPE0lMgAKCRAejKHQxh6zPMIBAKCbKzL+gqBGddK5TmUt3f7uAQjn +QQCePf2M8UcBKh6zvNwMJuz3843sOuiIRgQQEQIABgUCPjioUgAKCRAi0vs7QyFO +F1AIAJ9YP+Ebkp4j/pFFamx/LTJzTk4cdwCgidDyOMv/KNbaNeWe1RpDq7g/AhWI +RgQQEQIABgUCPWOX+gAKCRBY5tXbSIkkiP5aAJ4o7l8xkJWBttK9c7QXeYgWKzaL +yACfTZT8zmAU7MBsLZUXQJ6gI9r87d2IRgQQEQIABgUCPfWNXwAKCRBrpXhTBfk6 +6iMuAJ9hEPjPICexM3ccpc8HJb3jUvFw8QCgrcGjlXw4vTHcOfhwXYe0ktKjw9OI +RgQTEQIABgUCPjnoSwAKCRCcvtcOOD6LZLjyAJ9EjftxzQsS1EdG0X6Eix2WdvOM +fgCeNmYTTggO6emNCF4thoP0vRLIQsm0MVBoaWxpcHBlIE0uIENoaWFzc29uIChI +b21lKSA8Z296ZXJAZWN0b3BsYXNtLm9yZz6IVwQTEQIAFwUCOqyWBQULBwoDBAMV +AwIDFgIBAheAAAoJEMsyoQeIw6WlucIAn3Rg3i8mIoIMxdq48kzsT4u5bNbUAJ9J +xWfNcujVucQ7rMCyB1piBbPlH4hGBBARAgAGBQI7XGz6AAoJEOd14yTbQbOHx0EA +oMrseYkzZItyZhL2rGRVIlpITXUrAJ0eqf+DOe6/kFqd70Ul3cFsErcabYhGBBAR +AgAGBQI8TSU4AAoJEB6ModDGHrM87SIAoJ5UgXEx0XjKsu41bPFDEp+mOvtnAJ4v +C0441exYAJsrd5cdpyXU6UwgpIhGBBARAgAGBQI9Y5yMAAoJEFjm1dtIiSSINz4A +oO3fcau7GVJ27FCZxgdOR30W4MDOAJ9gAl1vFCqSVjcubHo8MCkSCmiTnIhGBBAR +AgAGBQI99Y1iAAoJEGuleFMF+Trqk5UAoI41kXlRMjvjOfk3IpiKNgf/tMiVAJ4s +bCWb/f/arWZwYN8IcJLZEotVDohGBBARAgAGBQI+OKmtAAoJECLS+ztDIU4XYmMA +n0KrYhzVjoVHinu2gwZl8aYX9UmEAKDNp/mFnA9CsrErQMoHvjkdlsmzMIhGBBMR +AgAGBQI+OehdAAoJEJy+1w44PotkeqEAn3X0ZtHJm9mj6HnpLHc+MCqAg8cMAJ42 +UjEMV4SBHdhuijYBTGYd9up+VbRFUGhpbGlwcGUgTS4gQ2hpYXNzb24gKFNtYXJ0 +V29ya2VyIE1haW50YWluZXIpIDxnb3plckBzbWFydHdvcmtlci5vcmc+iFcEExEC +ABcFAjqslikFCwcKAwQDFQMCAxYCAQIXgAAKCRDLMqEHiMOlpZ0fAJ0WT1Bn59MN +tz7ZwP/MVsn0Hc3CGACdGHNrkdLMMV1JOAdP8oAJx0jjMzeIRgQQEQIABgUCO1xs ++gAKCRDndeMk20Gzh+uZAJ9Mr5EeZ+Iok5MY84tivEUa8XX/fQCeNKGavfEWhGGU +XaIf+VSouAKNP46IRgQQEQIABgUCPE0lOAAKCRAejKHQxh6zPKukAKCQoW3ggLOL +I8yOlFQgHVdotn0WswCgkbaijlpeHVZeo+5EXRtYhWRdySuIRgQQEQIABgUCPWOc +jAAKCRBY5tXbSIkkiFO3AJ9I2lu6DG2gKg6ikGnTh5tE6nGDEQCgtUxNJafbtZ9B +Q2LNrUonJRVRLlaIRgQQEQIABgUCPfWNYgAKCRBrpXhTBfk66moUAJ97oy7hrsga +W0nE6pLNbXIvbKn+WQCfSZBtm04pKnWoib+VQTvocRv7UNyIRgQQEQIABgUCPjip +rQAKCRAi0vs7QyFOFy1JAKDfNZ7b7Ygq6yDVFZy6krvHUOyPPgCfbdUEzVt29SBx +J4czAdByDs5qJFuIRgQTEQIABgUCPjnoXQAKCRCcvtcOOD6LZBOYAKCnTn76IKiF ++u/0ZeFQrj5/S5cghgCfV7DFCujW3ufvN4LZJCNFiXULdjy0M1BoaWxpcHBlIE0u +IENoaWFzc29uIChXb3JrKSA8Z296ZXJAaGJlc29mdHdhcmUuY29tPohXBBMRAgAX +BQI6rJZDBQsHCgMEAxUDAgMWAgECF4AACgkQyzKhB4jDpaVqAwCfY4aFcTmZxr4t +1UMM7nKocbEu1BMAoMRr3tElxFt9MSOlNiTCSD0zVf6EiJwEEAEBAAYFAjsbOTQA +CgkQUwdH5iPp6rWcZgQAimTanL0YK/47O2PaqQVxII6ARIUtyr3itILE6ZFheuGn +8gr5k+LzXqBv4+CiPSRaXRLeb/AbNLzd0iwaTO2Vh7JdJ9+/3XtRzSbmVAiF2wa4 +gZ/PCPeLZmJpA5Y5l9Yqz8rx9Z2jc+WMk9UjbdQUnvf3TPdVNr8DZ4I5NB17bh6I +RgQQEQIABgUCO1IbtgAKCRBVkeLAZmTAeKn2AJ4oyI/EpLzTGjYz8+h6NQt/SUV+ +zgCfX2jpGslHS9Evd4idStjamZh0kSOIRgQQEQIABgUCPE0lOAAKCRAejKHQxh6z +PLwLAKCB6w9OwHTWF2fey/TxN4lSY4spqwCeNsXVnjAOh20ZIcDqr+ne
cvs commit: modperl-docs/src/docs/2.0/api/Apache PerlSections.pod
gozer 2003/06/08 22:06:34
Modified:src/docs/2.0/api config.cfg
Added: src/docs/2.0/api/Apache PerlSections.pod
Log:
Initial shot at documenting Perl sections in mp2. Extended from an
e-mail on dev@perl.apache.org
Revision ChangesPath
1.25 +1 -0 modperl-docs/src/docs/2.0/api/config.cfg
Index: config.cfg
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/config.cfg,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- config.cfg23 May 2003 05:20:53 - 1.24
+++ config.cfg9 Jun 2003 05:06:34 - 1.25
@@ -24,6 +24,7 @@
Apache/Filter.pod
Apache/FilterRec.pod
Apache/Log.pod
+ Apache/PerlSections.pod
Apache/RequestRec.pod
Apache/RequestUtil.pod
Apache/ServerUtil.pod
1.1 modperl-docs/src/docs/2.0/api/Apache/PerlSections.pod
Index: PerlSections.pod
===
=head1 NAME
Apache::PerlSections - Default Handler for CEltPerl Egt sections
=head1 Synopsis
Perl
@PerlModule = qw(Mail::Send Devel::Peek);
#run the server as whoever starts it
$User = getpwuid() || ;
$Group = getgrgid()) || );
$ServerAdmin = $User;
/Perl
=head1 Description
With CEltPerl Egt...CElt/PerlEgt sections, it is possible
to configure your server entirely in Perl.
CEltPerl Egt sections can contain Iany 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.
Block sections such as CEltLocationEgt..CElt/LocationEgt
are represented in a C%Location hash, e.g.:
Perl
$Location{/~dougm/} = {
AuthUserFile = '/tmp/htpasswd',
AuthType = 'Basic',
AuthName = 'test',
DirectoryIndex = [qw(index.html index.htm)],
Limit = {
METHODS = 'GET POST',
require = 'user dougm',
},
};
/Perl
If an Apache directive can take two or three arguments you may push
strings (the lowest number of arguments will be shifted off the
C@list) or use an array reference to handle any number greater than
the minimum for that directive:
push @Redirect, /foo, http://www.foo.com/;;
push @Redirect, /imdb, http://www.imdb.com/;;
push @Redirect, [qw(temp /here http://www.there.com;)];
Other section counterparts include C%VirtualHost, C%Directory and
C%Files.
To pass all environment variables to the children with a single
configuration directive, rather than listing each one via CPassEnv
or CPerlPassEnv, a CEltPerl Egt section could read in a file and:
push @PerlPassEnv, [$key = $val];
or
Apache-httpd_conf(PerlPassEnv $key $val);
These are somewhat simple examples, but they should give you the basic
idea. You can mix in any Perl code you desire. See Ieg/httpd.conf.pl
and Ieg/perl_sections.txt in the mod_perl distribution for more
examples.
Assume that you have a cluster of machines with similar configurations
and only small distinctions between them: ideally you would want to
maintain a single configuration file, but because the configurations
aren't Iexactly the same (e.g. the CServerName directive) it's not
quite that simple.
CEltPerl Egt 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 CServerName
directive you might have this CEltPerl Egt section:
Perl
$ServerName = `hostname`;
/Perl
For example if you want to allow personal directories on all machines
except the ones whose names start with Isecure:
Perl
$ServerName = `hostname`;
if ( $ServerName !~ /^secure/) {
$UserDir = public.html;
} else {
$UserDir = DISABLED;
}
/Perl
=head1 Configuration Variables
There are a few variables that can be set to change the default behaviour of
CEltPerl
Egt sections.
=head2 C$Apache::Server::SaveConfig
By default, the namespace in which CEltPerl Egt sections are evaluated
is cleared after
each block closes. By setting it to a true value, the content of those
namespaces will be preserved
and will be available for inspection by modules like LApache::Status
=head2 C$Apache::Server::StrictPerlSections
By default, compilation and run-time errors within CEltPerl Egt
sections will cause a warning
to be printed in the error_log. By setting this variable to a true value,
code in the sections will
be evaluated as if use strict was in usage, and all warning and errors will
cause the server to
abort
