stas 02/05/19 02:40:53
Modified: src/docs/2.0/api/mod_perl-2.0/APR PerlIO.pod Table.pod
src/docs/2.0/api/mod_perl-2.0/Apache RequestRec.pod
ServerUtil.pod compat.pod
Log:
add and adjust descriptions so they will look nice and useful on the index
pages
Revision Changes Path
1.4 +5 -4 modperl-docs/src/docs/2.0/api/mod_perl-2.0/APR/PerlIO.pod
Index: PerlIO.pod
===================================================================
RCS file:
/home/cvs/modperl-docs/src/docs/2.0/api/mod_perl-2.0/APR/PerlIO.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- PerlIO.pod 27 Feb 2002 18:03:38 -0000 1.3
+++ PerlIO.pod 19 May 2002 09:40:53 -0000 1.4
@@ -19,10 +19,11 @@
=head1 DESCRIPTION
C<APR::PerlIO> implements a Perl IO layer using APR's file
-manipulation as its internals. Why do you want to use this? Normally
-you shouldn't, probably it won't be faster than Perl's default
-layer. It's only useful when you need to manipulate a filehandle
-opened at the APR side, while using Perl.
+manipulation as its internals.
+
+Why do you want to use this? Normally you shouldn't, probably it won't
+be faster than Perl's default layer. It's only useful when you need to
+manipulate a filehandle opened at the APR side, while using Perl.
Normally you won't call open() with APR layer attribute, but some
mod_perl functions will return a filehandle which is internally hooked
1.7 +6 -4 modperl-docs/src/docs/2.0/api/mod_perl-2.0/APR/Table.pod
Index: Table.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/mod_perl-2.0/APR/Table.pod,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- Table.pod 28 Feb 2002 16:23:23 -0000 1.6
+++ Table.pod 19 May 2002 09:40:53 -0000 1.7
@@ -37,16 +37,18 @@
=head1 DESCRIPTION
C<APR::Table> allows its users to manipulate opaque string-content
-tables. The table is somewhat similar to the Perl hash, but allows
-multiply values for the same key. An access to the records stored in
-the table always requires a key.
+tables.
+
+The table's structure is somewhat similar to the Perl's hash
+structure, but allows multiply values for the same key. An access to
+the records stored in the table always requires a key.
The key-value pairs are stored in the order they are added.
The keys are case-insensitive.
However as of the current implementation if more than value for the
-same key is requested, the whole table it lineary searched, which is
+same key is requested, the whole table is lineary searched, which is
very inefficient unless the table is very small.
C<APR::Table> provides a L<TIE Interface|/TIE_Interface>.
1.4 +1 -1
modperl-docs/src/docs/2.0/api/mod_perl-2.0/Apache/RequestRec.pod
Index: RequestRec.pod
===================================================================
RCS file:
/home/cvs/modperl-docs/src/docs/2.0/api/mod_perl-2.0/Apache/RequestRec.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- RequestRec.pod 14 Nov 2001 08:50:00 -0000 1.3
+++ RequestRec.pod 19 May 2002 09:40:53 -0000 1.4
@@ -15,7 +15,7 @@
=head1 DESCRIPTION
-META: complete
+C<Apache::RequestRec> provides the Perl API for Apache request object.
=head1 API
1.5 +2 -0
modperl-docs/src/docs/2.0/api/mod_perl-2.0/Apache/ServerUtil.pod
Index: ServerUtil.pod
===================================================================
RCS file:
/home/cvs/modperl-docs/src/docs/2.0/api/mod_perl-2.0/Apache/ServerUtil.pod,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- ServerUtil.pod 27 Feb 2002 18:03:38 -0000 1.4
+++ ServerUtil.pod 19 May 2002 09:40:53 -0000 1.5
@@ -17,6 +17,8 @@
=head1 DESCRIPTION
+C<Apache::ServerUtil> provides the Perl API for Apache server object.
+
META: complete
=head1 API
1.3 +6 -3
modperl-docs/src/docs/2.0/api/mod_perl-2.0/Apache/compat.pod
Index: compat.pod
===================================================================
RCS file:
/home/cvs/modperl-docs/src/docs/2.0/api/mod_perl-2.0/Apache/compat.pod,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- compat.pod 2 Jan 2002 09:35:02 -0000 1.2
+++ compat.pod 19 May 2002 09:40:53 -0000 1.3
@@ -8,9 +8,12 @@
=head1 DESCRIPTION
-C<Apache::compat> includes all the functions that are deprecated in
-mod_perl 2.x. If you code uses any of these functions you should just
-include this module in your code and everything should work.
+C<Apache::compat> provides mod_perl 1.x compatibility layer.
+
+It includes most of the functions that are deprecated in mod_perl
+2.x. If your code uses any of these functions you should just load
+this module at the server startup, and chances are that everything
+should work as it did in 1.x.
However, certain functionality is not optimized and therefore it's the
best to try to port your code not to use deprecated functions and stop
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
