You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs-cvs@perl.apache.org by ra...@apache.org on 2005/04/03 00:46:25 UTC
svn commit: r159840 - in perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl:
Const.pod Global.pod MethodLookup.pod Registry.pod RegistryCooker.pod
RegistryLoader.pod Util.pod
Author: randyk
Date: Sat Apr 2 14:46:23 2005
New Revision: 159840
URL: http://svn.apache.org/viewcvs?view=rev&rev=159840
Log:
s/Apache/Apache2/
Modified:
perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Const.pod
perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Global.pod
perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/MethodLookup.pod
perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Registry.pod
perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/RegistryCooker.pod
perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/RegistryLoader.pod
perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Util.pod
Modified: perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Const.pod
URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Const.pod?view=diff&r1=159839&r2=159840
==============================================================================
--- perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Const.pod (original)
+++ perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Const.pod Sat Apr 2 14:46:23 2005
@@ -26,8 +26,8 @@
This package contains constants specific to mod_perl features.
-Refer to C<L<the Apache::Const description
-section|docs::2.0::api::Apache::Const/Description>> for more
+Refer to C<L<the Apache2::Const description
+section|docs::2.0::api::Apache2::Const/Description>> for more
information.
Modified: perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Global.pod
URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Global.pod?view=diff&r1=159839&r2=159840
==============================================================================
--- perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Global.pod (original)
+++ perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Global.pod Sat Apr 2 14:46:23 2005
@@ -8,7 +8,7 @@
=head1 Synopsis
use ModPerl::Global ();
- my $package = 'MyApache::Package';
+ my $package = 'MyApache2::Package';
# make the END blocks of this package special
ModPerl::Global::special_list_register(END => $package);
Modified: perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/MethodLookup.pod
URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/MethodLookup.pod?view=diff&r1=159839&r2=159840
==============================================================================
--- perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/MethodLookup.pod (original)
+++ perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/MethodLookup.pod Sat Apr 2 14:46:23 2005
@@ -11,36 +11,36 @@
ModPerl::MethodLookup::lookup_method('print');
# return only module names containing method 'print' which
- # expects the first argument to be of type 'Apache::Filter'
- # (here $filter is an Apache::Filter object)
+ # expects the first argument to be of type 'Apache2::Filter'
+ # (here $filter is an Apache2::Filter object)
my($hint, @modules) =
ModPerl::MethodLookup::lookup_method('print', $filter);
# or
my($hint, @modules) =
- ModPerl::MethodLookup::lookup_method('print', 'Apache::Filter');
+ ModPerl::MethodLookup::lookup_method('print', 'Apache2::Filter');
- # what XS methods defined by module 'Apache::Filter'
+ # what XS methods defined by module 'Apache2::Filter'
my($hint, @methods) =
- ModPerl::MethodLookup::lookup_module('Apache::Filter');
+ ModPerl::MethodLookup::lookup_module('Apache2::Filter');
# what XS methods can be invoked on the object $r (or a ref)
my($hint, @methods) =
ModPerl::MethodLookup::lookup_object($r);
# or
my($hint, @methods) =
- ModPerl::MethodLookup::lookup_object('Apache::RequestRec');
+ ModPerl::MethodLookup::lookup_object('Apache2::RequestRec');
# preload all mp2 modules in startup.pl
ModPerl::MethodLookup::preload_all_modules();
# command line shortcuts
- % perl -MApache2 -MModPerl::MethodLookup -e print_module \
- Apache::RequestRec Apache::Filter
- % perl -MApache2 -MModPerl::MethodLookup -e print_object Apache
- % perl -MApache2 -MModPerl::MethodLookup -e print_method \
+ % perl -MModPerl::MethodLookup -e print_module \
+ Apache2::RequestRec Apache2::Filter
+ % perl -MModPerl::MethodLookup -e print_object Apache2
+ % perl -MModPerl::MethodLookup -e print_method \
get_server_built request
- % perl -MApache2 -MModPerl::MethodLookup -e print_method read
- % perl -MApache2 -MModPerl::MethodLookup -e print_method read APR::Bucket
+ % perl -MModPerl::MethodLookup -e print_method read
+ % perl -MModPerl::MethodLookup -e print_method read APR::Bucket
@@ -110,16 +110,16 @@
ModPerl::MethodLookup::lookup_method('print');
Return only module names containing method I<print> which expects the
-first argument to be of type C<Apache::Filter>:
+first argument to be of type C<Apache2::Filter>:
- my $filter = bless {}, 'Apache::Filter';
+ my $filter = bless {}, 'Apache2::Filter';
my($hint, @modules) =
ModPerl::MethodLookup::lookup_method('print', $filter);
or:
my($hint, @modules) =
- ModPerl::MethodLookup::lookup_method('print', 'Apache::Filter');
+ ModPerl::MethodLookup::lookup_method('print', 'Apache2::Filter');
@@ -157,10 +157,10 @@
Example:
-What XS methods defined by module C<Apache::Filter>:
+What XS methods defined by module C<Apache2::Filter>:
my($hint, @methods) =
- ModPerl::MethodLookup::lookup_module('Apache::Filter');
+ ModPerl::MethodLookup::lookup_module('Apache2::Filter');
@@ -205,7 +205,7 @@
because these methods are written in pure XS and manipulate the
arguments stack themselves. Currently these are mainly XS functions,
not methods, which of course aren't invoked on objects. There are also
-logging function wrappers (C<Apache::Log>).
+logging function wrappers (C<Apache2::Log>).
Examples:
@@ -214,10 +214,10 @@
my($hint, @methods) =
ModPerl::MethodLookup::lookup_object($r);
-or C<$r>'s class -- C<Apache::RequestRec>:
+or C<$r>'s class -- C<Apache2::RequestRec>:
my($hint, @methods) =
- ModPerl::MethodLookup::lookup_object('Apache::RequestRec');
+ ModPerl::MethodLookup::lookup_object('Apache2::RequestRec');
@@ -255,19 +255,19 @@
from the command line. For example to print all the modules which
define method I<read> execute:
- % perl -MApache2 -MModPerl::MethodLookup -e print_method read
+ % perl -MModPerl::MethodLookup -e print_method read
Since this will return more than one module, we can narrow the query
to only those methods which expect the first argument to be blessed
into class C<APR::Bucket>:
- % perl -MApache2 -MModPerl::MethodLookup -e print_method read APR::Bucket
+ % perl -MModPerl::MethodLookup -e print_method read APR::Bucket
You can pass more than one method and it'll perform a lookup on each
of the methods. For example to lookup methods C<get_server_built> and
C<request> you can do:
- % perl -MApache2 -MModPerl::MethodLookup -e print_method \
+ % perl -MModPerl::MethodLookup -e print_method \
get_server_built request
The function C<print_method()> is exported by default.
@@ -286,11 +286,11 @@
C<print_module()> is a convenience wrapper for
C<L<lookup_module()|/C_lookup_module___>>, mainly designed to be used
from the command line. For example to print all the methods defined in
-the module C<Apache::RequestRec>, followed by methods defined in the
-module C<Apache::Filter> you can run:
+the module C<Apache2::RequestRec>, followed by methods defined in the
+module C<Apache2::Filter> you can run:
- % perl -MApache2 -MModPerl::MethodLookup -e print_module \
- Apache::RequestRec Apache::Filter
+ % perl -MModPerl::MethodLookup -e print_module \
+ Apache2::RequestRec Apache2::Filter
The function C<print_module()> is exported by default.
@@ -309,10 +309,10 @@
C<print_object()> is a convenience wrapper for
C<L<lookup_object()|/C_lookup_object___>>, mainly designed to be used
from the command line. For example to print all the methods that can
-be invoked on object blessed into a class C<Apache::RequestRec> run:
+be invoked on object blessed into a class C<Apache2::RequestRec> run:
- % perl -MApache2 -MModPerl::MethodLookup -e print_object \
- Apache::RequestRec
+ % perl -MModPerl::MethodLookup -e print_object \
+ Apache2::RequestRec
Similar to C<L<print_object()|/C_print_object___>>, more than one
class can be passed to this function.
@@ -406,7 +406,7 @@
module is called.
A similar technique is used by
-C<L<Apache::porting|docs::2.0::api::Apache::porting>>.
+C<L<Apache2::porting|docs::2.0::api::Apache2::porting>>.
META: there is a better version of AUTOLOAD discussed on the dev
@@ -428,13 +428,13 @@
mod_perl complains:
Can't locate object method "construct_url" via package
- "Apache::RequestRec" at ...
+ "Apache2::RequestRec" at ...
you can ask C<ModPerl::MethodLookup> for help:
- % perl -MApache2 -MModPerl::MethodLookup -e print_method construct_url
+ % perl -MModPerl::MethodLookup -e print_method construct_url
To use method 'construct_url' add:
- use Apache::URI ();
+ use Apache2::URI ();
and after copy-n-pasting the use statement in our code, the problem
goes away.
@@ -442,17 +442,17 @@
One can create a handy alias for this technique. For example, C-style
shell users can do:
- % alias lookup "perl -MApache2 -MModPerl::MethodLookup -e print_method"
+ % alias lookup "perl -MModPerl::MethodLookup -e print_method"
For Bash-style shell users:
- % alias lookup="perl -MApache2 -MModPerl::MethodLookup -e print_method"
+ % alias lookup="perl -MModPerl::MethodLookup -e print_method"
Now the lookup is even easier:
% lookup construct_url
to use method 'construct_url' add:
- use Apache::URI;
+ use Apache2::URI;
Similar aliases can be provided for
C<L<print_object()|/C_print_object___>> and
@@ -502,7 +502,7 @@
=item *
-C<L<Apache::porting|docs::2.0::api::Apache::porting>>
+C<L<Apache2::porting|docs::2.0::api::Apache2::porting>>
=back
Modified: perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Registry.pod
URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Registry.pod?view=diff&r1=159839&r2=159840
==============================================================================
--- perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Registry.pod (original)
+++ perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Registry.pod Sat Apr 2 14:46:23 2005
@@ -29,7 +29,7 @@
For example:
- my $r = Apache->request;
+ my $r = Apache2->request;
$r->content_type("text/html");
$r->send_http_header;
$r->print("mod_perl rules!");
@@ -78,7 +78,7 @@
=item *
Only once, if pulled in by the parent process via
-C<Apache::RegistryLoader>.
+C<Apache2::RegistryLoader>.
=item *
Modified: perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/RegistryCooker.pod
URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/RegistryCooker.pod?view=diff&r1=159839&r2=159840
==============================================================================
--- perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/RegistryCooker.pod (original)
+++ perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/RegistryCooker.pod Sat Apr 2 14:46:23 2005
@@ -46,7 +46,7 @@
C<$class> -- the registry class, usually C<__PACKAGE__> can be used.
-C<$r> -- C<L<Apache::Request>> object.
+C<$r> -- C<L<Apache2::Request>> object.
default: new()
Modified: perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/RegistryLoader.pod
URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/RegistryLoader.pod?view=diff&r1=159839&r2=159840
==============================================================================
--- perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/RegistryLoader.pod (original)
+++ perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/RegistryLoader.pod Sat Apr 2 14:46:23 2005
@@ -21,7 +21,7 @@
sub trans {
my $uri = shift;
$uri =~ s|^/registry/|cgi-bin/|;
- return File::Spec->catfile(Apache::ServerUtil::server_root, $uri);
+ return File::Spec->catfile(Apache2::ServerUtil::server_root, $uri);
}
my $rl = ModPerl::RegistryLoader->new(
package => 'ModPerl::Registry',
@@ -133,13 +133,13 @@
use DirHandle ();
use strict;
- my $dir = File::Spec->catdir(Apache::ServerUtil::server_root,
+ my $dir = File::Spec->catdir(Apache2::ServerUtil::server_root,
"cgi-bin");
sub trans {
my $uri = shift;
$uri =~ s|^/registry/|cgi-bin/|;
- return File::Spec->catfile(Apache::ServerUtil::server_root,
+ return File::Spec->catfile(Apache2::ServerUtil::server_root,
$uri);
}
@@ -180,7 +180,7 @@
=head1 Authors
-The original C<Apache::RegistryLoader> implemented by Doug MacEachern.
+The original C<Apache2::RegistryLoader> implemented by Doug MacEachern.
Stas Bekman did the porting to the new registry framework based on
C<ModPerl::RegistryLoader>.
Modified: perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Util.pod
URL: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Util.pod?view=diff&r1=159839&r2=159840
==============================================================================
--- perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Util.pod (original)
+++ perl/modperl/docs/trunk/src/docs/2.0/api/ModPerl/Util.pod Sat Apr 2 14:46:23 2005
@@ -173,7 +173,7 @@
=item arg1: C<$stash> ( string )
-The Perl stash to unload. e.g. C<MyApache::MyData>.
+The Perl stash to unload. e.g. C<MyApache2::MyData>.
=item ret: no return value
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org