stas 02/03/20 09:42:05
Modified: src/docs/1.0/faqs cgi_to_mod_perl.pod config.cfg
mod_perl.pod mod_perl_api.pod mod_perl_cgi.pod
mod_perl_cvs.pod mod_perl_faq.pod
mod_perl_method_handlers.pod mod_perl_traps.pod
mod_perl_tuning.pod perl_myth.pod
Added: src/docs/1.0/faqs Changes.pod
Log:
- using a consistent pages layout
- adding the Description header where needed (for the benefit of index
pages)
- adding the Changes.pod file for the docset
Revision Changes Path
1.3 +29 -0 modperl-docs/src/docs/1.0/faqs/cgi_to_mod_perl.pod
Index: cgi_to_mod_perl.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/cgi_to_mod_perl.pod,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- cgi_to_mod_perl.pod 27 Feb 2002 18:03:35 -0000 1.2
+++ cgi_to_mod_perl.pod 20 Mar 2002 17:42:05 -0000 1.3
@@ -118,3 +118,32 @@
=head1 SEE ALSO
Apache::PerlRun(3)
+
+=head1 Maintainers
+
+Maintainer is the person(s) you should contact with updates,
+corrections and patches.
+
+=over
+
+=item *
+
+L<modperl docs list|maillist::list-docs-dev>
+
+=back
+
+=head1 Authors
+
+=over
+
+=item *
+
+Doug MacEachern
+
+=back
+
+Only the major authors are listed above. For contributors see the
+Changes file.
+
+
+=cut
1.4 +21 -22 modperl-docs/src/docs/1.0/faqs/config.cfg
Index: config.cfg
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/config.cfg,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- config.cfg 27 Feb 2002 18:03:35 -0000 1.3
+++ config.cfg 20 Mar 2002 17:42:05 -0000 1.4
@@ -1,28 +1,27 @@
use vars qw(@c);
@c = (
- id => 'faqs',
+ id => 'faqs',
- title => "mod_perl FAQs",
+ title => "mod_perl FAQs",
- abstract => 'Miscellaneous mod_perl documentation',
+ abstract => 'Miscellaneous mod_perl 1.x documentation',
- chapters => [
- qw(
- cgi_to_mod_perl.pod
- mod_perl_cgi.pod
- mod_perl_cvs.pod
- mod_perl_faq.pod
- mod_perl.pod
- mod_perl_traps.pod
- mod_perl_tuning.pod
- mod_perl_api.pod
- mod_perl_method_handlers.pod
- perl_myth.pod
- ),
- ],
- copy_glob => [
- qw(
- mjtg-news.txt
- )
- ],
+ chapters => [qw(
+ cgi_to_mod_perl.pod
+ mod_perl_cgi.pod
+ mod_perl_cvs.pod
+ mod_perl_faq.pod
+ mod_perl.pod
+ mod_perl_traps.pod
+ mod_perl_tuning.pod
+ mod_perl_api.pod
+ mod_perl_method_handlers.pod
+ perl_myth.pod
+ Changes.pod
+ )],
+ copy_glob => [
+ qw(
+ mjtg-news.txt
+ )
+ ],
);
1.3 +25 -3 modperl-docs/src/docs/1.0/faqs/mod_perl.pod
Index: mod_perl.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/mod_perl.pod,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- mod_perl.pod 27 Feb 2002 18:03:35 -0000 1.2
+++ mod_perl.pod 20 Mar 2002 17:42:05 -0000 1.3
@@ -819,11 +819,33 @@
=head1 REVISION
-$Id: mod_perl.pod,v 1.2 2002/02/27 18:03:35 stas Exp $
+$Id: mod_perl.pod,v 1.3 2002/03/20 17:42:05 stas Exp $
-=head1 AUTHOR
+=head1 Maintainers
-Doug MacEachern
+Maintainer is the person(s) you should contact with updates,
+corrections and patches.
+=over
+=item *
+L<modperl docs list|maillist::list-docs-dev>
+
+=back
+
+=head1 Authors
+
+=over
+
+=item *
+
+Doug MacEachern
+
+=back
+
+Only the major authors are listed above. For contributors see the
+Changes file.
+
+
+=cut
1.2 +28 -0 modperl-docs/src/docs/1.0/faqs/mod_perl_api.pod
Index: mod_perl_api.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/mod_perl_api.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- mod_perl_api.pod 5 Jan 2002 19:20:01 -0000 1.1
+++ mod_perl_api.pod 20 Mar 2002 17:42:05 -0000 1.2
@@ -116,4 +116,32 @@
...stuff for httpd w/o mod_perl...
</IfModule>
+=head1 Maintainers
+
+Maintainer is the person(s) you should contact with updates,
+corrections and patches.
+
+=over
+
+=item *
+
+L<modperl docs list|maillist::list-docs-dev>
+
+=back
+
+
+=head1 Authors
+
+=over
+
+=item *
+
+Doug MacEachern
+
+=back
+
+Only the major authors are listed above. For contributors see the
+Changes file.
+
+
=cut
1.4 +29 -0 modperl-docs/src/docs/1.0/faqs/mod_perl_cgi.pod
Index: mod_perl_cgi.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/mod_perl_cgi.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- mod_perl_cgi.pod 27 Feb 2002 18:03:35 -0000 1.3
+++ mod_perl_cgi.pod 20 Mar 2002 17:42:05 -0000 1.4
@@ -189,3 +189,32 @@
if($ENV{GATEWAY_INTERFACE} =~ /^CGI-Perl/) {
Apache->request->register_cleanup(sub { doProcess($query) });
}
+
+=head1 Maintainers
+
+Maintainer is the person(s) you should contact with updates,
+corrections and patches.
+
+=over
+
+=item *
+
+L<modperl docs list|maillist::list-docs-dev>
+
+=back
+
+=head1 Authors
+
+=over
+
+=item *
+
+Doug MacEachern
+
+=back
+
+Only the major authors are listed above. For contributors see the
+Changes file.
+
+
+=cut
1.2 +28 -0 modperl-docs/src/docs/1.0/faqs/mod_perl_cvs.pod
Index: mod_perl_cvs.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/mod_perl_cvs.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- mod_perl_cvs.pod 5 Jan 2002 19:20:01 -0000 1.1
+++ mod_perl_cvs.pod 20 Mar 2002 17:42:05 -0000 1.2
@@ -93,3 +93,31 @@
cvs(1)
+=head1 Maintainers
+
+Maintainer is the person(s) you should contact with updates,
+corrections and patches.
+
+=over
+
+=item *
+
+L<modperl docs list|maillist::list-docs-dev>
+
+=back
+
+=head1 Authors
+
+=over
+
+=item *
+
+Doug MacEachern
+
+=back
+
+Only the major authors are listed above. For contributors see the
+Changes file.
+
+
+=cut
1.5 +22 -14 modperl-docs/src/docs/1.0/faqs/mod_perl_faq.pod
Index: mod_perl_faq.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/mod_perl_faq.pod,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- mod_perl_faq.pod 28 Feb 2002 16:23:22 -0000 1.4
+++ mod_perl_faq.pod 20 Mar 2002 17:42:05 -0000 1.5
@@ -377,23 +377,31 @@
starts up, whereas GATEWAY_INTERFACE may not be set yet when BEGIN
blocks are being processed.
-=head2 Where can I get help that I did not find in here?
+=head1 Maintainers
-There is a mailing-list dedicated to mod_perl. It is archived at
-http://mathforum.org/epigone/modperl (which has a search engine) and
-also at
-http://marc.theaimsgroup.com/?l=apache-modperl&r=1&w=2#apache-modperl
-(threaded and indexed).
+Maintainer is the person(s) you should contact with updates,
+corrections and patches.
-You can subscribe to the list by sending a mail with the line C<subscribe
-modperl> to C<[EMAIL PROTECTED]>.
+=over
-The mod_perl homepage http://perl.apache.org/ has links to other
-mod_perl resources.
+=item *
-The pod source of this FAQ is available at
-http://www.ping.de/~fdc/mod_perl/mod_perl_faq.tar.gz
+Frank D. Cringle E<lt>[EMAIL PROTECTED]<gt> or the L<modperl docs
+list|maillist::list-docs-dev>
-=head2 Where do I send suggestions and corrections concerning this FAQ?
+=back
-mailto:[EMAIL PROTECTED]
+=head1 Authors
+
+=over
+
+=item *
+
+Frank D. Cringle E<lt>[EMAIL PROTECTED]<gt>
+
+=back
+
+Only the major authors are listed above. For contributors see the
+Changes file.
+
+=cut
1.4 +29 -0
modperl-docs/src/docs/1.0/faqs/mod_perl_method_handlers.pod
Index: mod_perl_method_handlers.pod
===================================================================
RCS file:
/home/cvs/modperl-docs/src/docs/1.0/faqs/mod_perl_method_handlers.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- mod_perl_method_handlers.pod 27 Feb 2002 18:03:35 -0000 1.3
+++ mod_perl_method_handlers.pod 20 Mar 2002 17:42:05 -0000 1.4
@@ -180,3 +180,32 @@
The L<faqs::mod_perl>, the I<Apache>, the I<perltoot> manpages (also
available at C<http://www.perl.com/CPAN/doc/FMTEYEWTK/perltoot.html>)
+
+=head1 Maintainers
+
+Maintainer is the person(s) you should contact with updates,
+corrections and patches.
+
+=over
+
+=item *
+
+L<modperl docs list|maillist::list-docs-dev>
+
+=back
+
+=head1 Authors
+
+=over
+
+=item *
+
+Doug MacEachern
+
+=back
+
+Only the major authors are listed above. For contributors see the
+Changes file.
+
+
+=cut
1.3 +26 -6 modperl-docs/src/docs/1.0/faqs/mod_perl_traps.pod
Index: mod_perl_traps.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/mod_perl_traps.pod,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- mod_perl_traps.pod 27 Feb 2002 18:03:35 -0000 1.2
+++ mod_perl_traps.pod 20 Mar 2002 17:42:05 -0000 1.3
@@ -361,11 +361,31 @@
The Camel Book, 2nd edition, p. 538 (p. 356 in the 1st edition).
-=head1 AUTHORS
+=head1 Maintainers
-Doug MacEachern, with contributions from
-Jens Heunemann E<lt>[EMAIL PROTECTED]<gt>,
-David Landgren E<lt>[EMAIL PROTECTED]<gt>,
-Mark Mills E<lt>[EMAIL PROTECTED]<gt> and
-Randal Schwartz E<lt>[EMAIL PROTECTED]<gt>
+Maintainer is the person(s) you should contact with updates,
+corrections and patches.
+=over
+
+=item *
+
+L<modperl docs list|maillist::list-docs-dev>
+
+=back
+
+=head1 Authors
+
+=over
+
+=item *
+
+Doug MacEachern
+
+=back
+
+Only the major authors are listed above. For contributors see the
+Changes file.
+
+
+=cut
1.4 +23 -10 modperl-docs/src/docs/1.0/faqs/mod_perl_tuning.pod
Index: mod_perl_tuning.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/mod_perl_tuning.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- mod_perl_tuning.pod 28 Feb 2002 16:23:22 -0000 1.3
+++ mod_perl_tuning.pod 20 Mar 2002 17:42:05 -0000 1.4
@@ -403,20 +403,33 @@
and try to tweak the perl code to be as small and lean as possible,
and to share the virtual memory pages by pre-loading the code.
-=head1 AUTHOR
+=head1 Maintainers
-This document is written by Vivek Khera. If you need to contact me,
-just send email to the mod_perl mailing list.
+Maintainer is the person(s) you should contact with updates,
+corrections and patches.
+
+=over
+
+=item *
+
+The L<modperl docs list|maillist::list-docs-dev>
+
+=back
This document is copyright (c) 1997-1998 by Vivek Khera.
-If you have contributions for this document, please post them to the
-mailing list. Perl POD format is best, but plain text will do, too.
+=head1 Authors
+
+=over
+
+=item *
+
+Vivek Khera
+
+=back
-If you need assistance, contact the mod_perl mailing list at
[EMAIL PROTECTED] first (send 'subscribe' to [EMAIL PROTECTED]
-to subscribe). There are lots of people there that can help. Also,
-check the web pages http://perl.apache.org/ and http://www.apache.org/
-for explanations of the configuration options.
+Only the major authors are listed above. For contributors see the
+Changes file.
+=cut
1.5 +49 -27 modperl-docs/src/docs/1.0/faqs/perl_myth.pod
Index: perl_myth.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/perl_myth.pod,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- perl_myth.pod 28 Feb 2002 16:23:22 -0000 1.4
+++ perl_myth.pod 20 Mar 2002 17:42:05 -0000 1.5
@@ -2,6 +2,11 @@
Popular Perl Complaints and Myths
+=head1 Description
+
+This document tries to explain the myths about Perl and overturn the
+FUD certain bodies try to spread.
+
=head1 Abbreviations
=over 4
@@ -48,22 +53,24 @@
code. Ultimately, all interpreted code needs to eventually be converted
to native instructions at some point, and this is invariably has to be
done by a compiled application.
- That said, an interpreted language CAN be faster than a comprable
+
+That said, an interpreted language CAN be faster than a comprable
native application in certain situations, given certain, common
-programming practices. For example, the allocation and de-allocation of
-memory can be a relatively expensive process in a tightly scoped
+programming practices. For example, the allocation and de-allocation
+of memory can be a relatively expensive process in a tightly scoped
compiled language, wheras interpreted languages typically use garbage
collectors which don't need to do expensive deallocation in a tight
loop, instead waiting until additional memory is absolutely necessary,
or for a less computationally intensive period. Of course, using a
-garbage collector in C would eliminate this edge in this situation, but
-where using garbage collectors in C is uncommon, Perl and most other
-interpreted languages have built-in garbage collectors.
- It is also important to point out that few people use the full
-potential of their modern CPU with a single application. Modern CPUs are
-not only more than fast enough to run interpreted code, many processors
-include instruction sets designed to increase the performance of
-interpreted code.
+garbage collector in C would eliminate this edge in this situation,
+but where using garbage collectors in C is uncommon, Perl and most
+other interpreted languages have built-in garbage collectors.
+
+It is also important to point out that few people use the full
+potential of their modern CPU with a single application. Modern CPUs
+are not only more than fast enough to run interpreted code, many
+processors include instruction sets designed to increase the
+performance of interpreted code.
=back
@@ -86,11 +93,13 @@
memory, 5MB of that might be shared meaning it only really uses 1MB
per child. Even 5 MB of memory per child is not uncommon for most web
applications on other languages.
- Also, most modern operating systems support the concept of shared
libraries. Perl
-can be compiled as a shared library, enabling the bulk of the perl
-interpreter to be shared between processes. Some executable formats on
-some platforms (I believe ELF is one such format) are able to share
-entire executable TEXT segments between unrelated processes.
+
+Also, most modern operating systems support the concept of shared
+libraries. Perl can be compiled as a shared library, enabling the bulk
+of the perl interpreter to be shared between processes. Some
+executable formats on some platforms (I believe ELF is one such
+format) are able to share entire executable TEXT segments between
+unrelated processes.
=back
@@ -227,9 +236,10 @@
programs which are freely downloadable, and Perl is cross platform,
able to run on Solaris, Linux, SCO, Digital Unix, Unix V, AIX, OS2,
VMS MacOS, Win95-98 and NT to name a few.
- Also, Benchmarks show that embedded Perl solutions outperform ASP/VB on IIS
-by several orders of magnitude. Perl is a much easier language for some
-to learn, especially those with a background in C or C++.
+
+Also, Benchmarks show that embedded Perl solutions outperform ASP/VB
+on IIS by several orders of magnitude. Perl is a much easier language
+for some to learn, especially those with a background in C or C++.
=back
@@ -284,20 +294,32 @@
=back
-=head1 AUTHOR
+=head1 Maintainers
+
+Maintainer is the person(s) you should contact with updates,
+corrections and patches.
+
+=over
+
+=item *
+
+Contact the L<modperl docs list|maillist::list-docs-dev>
+
+=back
+
-Adam Pisoni
+=head1 Authors
-=head2 Contact info
+=over
-email: [EMAIL PROTECTED]
+=item *
-www: http://www.cnation.com
+Adam Pisoni E<lt>[EMAIL PROTECTED]<gt>
-=head1 VERSION
+=back
-Ver 1.04
+Only the major authors are listed above. For contributors see the
+Changes file.
-Tue Aug 5 9:45:00 PST 1999
=cut
1.1 modperl-docs/src/docs/1.0/faqs/Changes.pod
Index: Changes.pod
===================================================================
=head1 NAME
CHANGES
=head1 Description
Refer to this document to learn what changes were made to the
documents, since you've read these last time.
The most recent changes are listed first.
=head1 Sat Sep 15 19:45:41 SGT 2001
* docs ported from the old site
* faqs::mod_perl_trap
These contributors to the ported to the new site version were:
Jens Heunemann E<lt>[EMAIL PROTECTED]<gt>,
David Landgren E<lt>[EMAIL PROTECTED]<gt>,
Mark Mills E<lt>[EMAIL PROTECTED]<gt> and
Randal Schwartz E<lt>[EMAIL PROTECTED]<gt>
Now maintained by the modperl community
=cut
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
