perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject cvs commit: modperl-docs/src/docs/1.0/faqs Changes.pod 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
Date Wed, 20 Mar 2002 17:42:05 GMT
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<majordomo@apache.org>.
  +=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>fdc@cliwe.ping.deE<gt> or the L<modperl docs
  +list|maillist::list-docs-dev>
   
  -=head2 Where do I send suggestions and corrections concerning this FAQ?
  +=back
   
  -mailto:fdc@cliwe.ping.de
  +=head1 Authors
  +
  +=over
  +
  +=item *
  +
  +Frank D. Cringle E<lt>fdc@cliwe.ping.deE<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>heunemann2@janet.deE<gt>,
  -David Landgren E<lt>david@landgren.netE<gt>,
  -Mark Mills E<lt>mark@ntr.netE<gt> and 
  -Randal Schwartz E<lt>merlyn@stonehenge.comE<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
  -modperl@apache.org first (send 'subscribe' to modperl-request@apache.org
  -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: adam@cnation.com
  +=item *
   
  -www: http://www.cnation.com
  +Adam Pisoni E<lt>adam@cnation.comE<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>heunemann2@janet.deE<gt>,
    David Landgren E<lt>david@landgren.netE<gt>,
    Mark Mills E<lt>mark@ntr.netE<gt> and 
    Randal Schwartz E<lt>merlyn@stonehenge.comE<gt>
  
  Now maintained by the modperl community
  
  =cut
  
  
  

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


Mime
View raw message