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 pe...@apache.org on 2002/06/16 14:04:17 UTC

cvs commit: modperl-docs/src/products apache-modules.pod app-server.pod config.cfg apache-modlist.html

pereinar    2002/06/16 05:04:17

  Modified:    .        TODO
               src      .htaccess
               src/about/contributors people.html people.tmpl
               src/docs/1.0/guide modules.pod
               src/docs/1.0/os config.cfg
               src/download binaries.pod
               src/products app-server.pod config.cfg
  Added:       src/docs/1.0/os/win32 config.cfg
               src/products apache-modules.pod
  Removed:     src/products apache-modlist.html
  Log:
  Removed apache-modlist.html, replacing it with apache-modules.pod (yes, name
  change is intentional), which takes some of the info but links to the Perl
  module list. -> corrected TODO to reflect this.
  
  Fixed links that changed because of this.
  
  Removed a period in app-server title.
  
  For 1.0 win32 info: moved them into their own docset. Changed some links to
  reflect that.
  
  Revision  Changes    Path
  1.62      +0 -12     modperl-docs/TODO
  
  Index: TODO
  ===================================================================
  RCS file: /home/cvs/modperl-docs/TODO,v
  retrieving revision 1.61
  retrieving revision 1.62
  diff -u -r1.61 -r1.62
  --- TODO	15 Jun 2002 18:51:10 -0000	1.61
  +++ TODO	16 Jun 2002 12:04:16 -0000	1.62
  @@ -15,12 +15,6 @@
   DocSet:
   -------
   
  -- need to be able to copy elements from the <head> section of the
  -  source html into the target file. Since this may cause collisions
  -  with preset headers, need to override the preset header's elements
  -  with source header elements. meaning that the TT should be able to
  -  reproduce the headers.
  -
   - how do we make L<foo|../search/swish.cgi> I cannot do search::swish,
     it's not a doc.
     STATUS: need to extend pod parser with U<title (url|relative url)>
  @@ -65,12 +59,6 @@
   - Need to resolve prompt issue. (user/root prompt)
   
   - Replace occurences of 1.x and 2.x with 1.0 and 2.0
  -
  -- src/products/apache-modlist.html can be removed after Doug's
  -  blessing
  -  STATUS: Per Einar thinks that some of the material could be re-used
  -  before deleting the file
  -
   
   Search:
   -------
  
  
  
  1.11      +4 -4      modperl-docs/src/.htaccess
  
  Index: .htaccess
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/.htaccess,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -r1.10 -r1.11
  --- .htaccess	16 Jun 2002 09:49:23 -0000	1.10
  +++ .htaccess	16 Jun 2002 12:04:16 -0000	1.11
  @@ -7,22 +7,22 @@
   
   # Distributed with mod_perl
   Redirect permanent /src/mod_perl.html http://perl.apache.org/docs/index.html
  -Redirect permanent /src/apache-modlist.html http://perl.apache.org/products/apache-modlist.html
  +Redirect permanent /src/apache-modlist.html http://perl.apache.org/products/apache-modules.html
   Redirect permanent /src/cgi_to_mod_perl.html http://perl.apache.org/docs/index.html
   Redirect permanent /src/mod_perl_traps.html http://perl.apache.org/docs/index.html
   # (equivalent to those with /src above, but it seems like the dist is kept symlinked in 2 locations)
   Redirect permanent /dist/mod_perl.html http://perl.apache.org/docs/index.html
  -Redirect permanent /dist/apache-modlist.html http://perl.apache.org/products/apache-modlist.html
  +Redirect permanent /dist/apache-modlist.html http://perl.apache.org/products/apache-modules.html
   Redirect permanent /dist/cgi_to_mod_perl.html http://perl.apache.org/docs/index.html
   Redirect permanent /dist/mod_perl_traps.html http://perl.apache.org/docs/index.html
   
   # FAQs
   Redirect permanent /faq/mod_perl_cgi.html http://perl.apache.org/docs/index.html
  -Redirect permanent /mod_perl_cvs.html http://perl.apache.org/docs/general/cvs_howto.html
  +Redirect permanent /mod_perl_cvs.html http://perl.apache.org/contribute/cvs_howto.html
   Redirect permanent /faq/index.html http://perl.apache.org/docs/index.html
   Redirect permanent /tuning/index.html http://perl.apache.org/docs/index.html
   Redirect permanent /faq/mod_perl_api.html http://perl.apache.org/docs/index.html
  -Redirect permanent /features/tmpl-cmp.html http://perl.apache.org/docs/tutorials/templates/comparison.html
  +Redirect permanent /features/tmpl-cmp.html http://perl.apache.org/docs/tutorials/tmpl/comparison/comparison.html
   Redirect permanent /perl_myth.html http://perl.apache.org/docs/general/perl_myth.html
   
   Redirect permanent /distributions.html http://perl.apache.org/download/index.html
  
  
  
  1.9       +1 -1      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.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- people.html	11 Jun 2002 20:07:10 -0000	1.8
  +++ people.html	16 Jun 2002 12:04:16 -0000	1.9
  @@ -22,7 +22,7 @@
   
   <p>Module authors aren't listed here, because keeping track of them
   would be too much work. For information about module authors, please
  -refer to the <a href="../../products/apache-modlist.html">Apache/Perl
  +refer to the <a href="../../products/apache-modules.html">Apache/Perl
   Module list</a>.</p>
   
   <h2>Contributors</h2>
  
  
  
  1.2       +1 -1      modperl-docs/src/about/contributors/people.tmpl
  
  Index: people.tmpl
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/about/contributors/people.tmpl,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- people.tmpl	2 Jun 2002 11:30:52 -0000	1.1
  +++ people.tmpl	16 Jun 2002 12:04:16 -0000	1.2
  @@ -22,7 +22,7 @@
   
   <p>Module authors aren't listed here, because keeping track of them
   would be too much work. For information about module authors, please
  -refer to the <a href="../../products/apache-modlist.html">Apache/Perl
  +refer to the <a href="../../products/apache-modules.html">Apache/Perl
   Module list</a>.</p>
   
   <h2>Contributors</h2>
  
  
  
  1.8       +2 -2      modperl-docs/src/docs/1.0/guide/modules.pod
  
  Index: modules.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/modules.pod,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- modules.pod	22 May 2002 05:27:34 -0000	1.7
  +++ modules.pod	16 Jun 2002 12:04:17 -0000	1.8
  @@ -31,8 +31,8 @@
   
   =back
   
  -For a complete list of modules, see the L<Apache/Perl Module
  -list|products::apache-modlist>.
  +For a complete list of modules, see the L<Apache/Perl Modules
  +|products::apache-modules>.
   
   
   =head1 Apache::Session - Maintain session state across HTTP requests
  
  
  
  1.4       +2 -7      modperl-docs/src/docs/1.0/os/config.cfg
  
  Index: config.cfg
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/config.cfg,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- config.cfg	11 Jun 2002 04:20:52 -0000	1.3
  +++ config.cfg	16 Jun 2002 12:04:17 -0000	1.4
  @@ -8,12 +8,7 @@
   Documents concerning OS-specific installation or pitfalls.
   EOB
   
  -    group => 'Win32 Platforms',
  -
  -    chapters => [qw(
  -        win32/install.pod
  -        win32/config.pod
  -        win32/multithread.pod
  -        win32/Changes.pod
  +    docsets => [qw(
  +        win32
       )],
   );
  
  
  
  1.4       +2 -2      modperl-docs/src/docs/1.0/os/win32/config.cfg
  
  
  
  
  1.10      +1 -1      modperl-docs/src/download/binaries.pod
  
  Index: binaries.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/download/binaries.pod,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- binaries.pod	15 Jun 2002 18:27:01 -0000	1.9
  +++ binaries.pod	16 Jun 2002 12:04:17 -0000	1.10
  @@ -23,7 +23,7 @@
   and some common modules, so are largish.
   
   For more information please read the L<Win32
  -Documentation|docs::1.0::os::index>.
  +Documentation|docs::1.0::os::win32::index>.
   
   =head2 Win32 mod_perl 2.x (BETA)
   
  
  
  
  1.8       +1 -1      modperl-docs/src/products/app-server.pod
  
  Index: app-server.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/products/app-server.pod,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- app-server.pod	8 Jun 2002 16:13:05 -0000	1.7
  +++ app-server.pod	16 Jun 2002 12:04:17 -0000	1.8
  @@ -1,6 +1,6 @@
   =head1 NAME
   
  -Application Servers and Toolkits based on mod_perl.
  +Application Servers and Toolkits based on mod_perl
   
   =head1 Description
   
  
  
  
  1.3       +1 -1      modperl-docs/src/products/config.cfg
  
  Index: config.cfg
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/products/config.cfg,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- config.cfg	27 Apr 2002 03:33:12 -0000	1.2
  +++ config.cfg	16 Jun 2002 12:04:17 -0000	1.3
  @@ -10,7 +10,7 @@
   EOB
   
       chapters => [qw(
  -        apache-modlist.html
  +        apache-modules.pod
           app-server.pod
           products.html
       )],
  
  
  
  1.1                  modperl-docs/src/products/apache-modules.pod
  
  Index: apache-modules.pod
  ===================================================================
  =head1 NAME
  
  Apache/Perl Modules
  
  =head1 Description
  
  On CPAN you will be able to find a number of Perl modules created to
  run under mod_perl. We will give a presentation of them here and ways
  to get at these modules.
  
  Apache/Perl modules are somewhat different from the many others found
  on CPAN (http://www.cpan.org/).  Most Perl modules are "building
  blocks"; developers use them to build applications or even more
  building blocks.  It just so happens that Apache/Perl modules are
  encapsulted inside a namespace and I<.pm> file.  However, this does
  not make them all building blocks, many are just like Apache modules
  written in C: you install them, edit the server configuration files
  and you're done.
  
  Before you start a new module, consider this: Apache/Perl modules are
  useless outside of mod_perl and Apache.  Do your best to design such
  that your C<Apache::*> module will make good use of the building
  blocks found on CPAN, putting together new building blocks where
  appropriate and simply glue them together with the Apache API, keeping
  the C<Apache::*> modules very small.
  
  These modules will also serve as good examples, showing you where
  modules can step in during a stage of a request with C<Perl*Handler>
  callbacks.  You'll also see how and when to use the Apache API
  methods.
  
  
  =head1 Playing Your Part
  
  Apache and Perl are world-wide collaborative efforts; naturally, the
  Apache/Perl integration project is the same.  You've started on the
  right foot simply by reading this document, thanks! Please make sure
  you've read the main Perl module list at
  http://www.cpan.org/modules/00modlist.long.html, all that is said
  there is relevant here!
  
  If you wish to share your module(s) in the Perl way, by putting them
  on CPAN, send a request to modules@perl.org to get set up with a PAUSE
  user id and directory. See http://www.cpan.org/modules/04pause.html
  for more details.
  
  B<HINT>:  For a nice set of template files try this:
  
    % h2xs -AX -n Apache::YourPackageName
  
  =head1 The Module List
  
  Like other CPAN modules, the Apache/Perl modules are listed on the
  Perl module list, under the I<World Wide Web> category:
  http://www.cpan.org/modules/00modlist.long.html#ID15_WorldWideW
  . Browse down the page to find the C<Apache::> modules, organized by
  their role in the requets cycle.
  
  =head1 Where Are The Modules Kept?
  
  Modules listed with the B<APML> as is contact are part of the mod_perl
  distribution package.  Other modules can be found on CPAN in the
  http://www.cpan.org/modules/by-module/Apache/ directory.  If they have
  not made it to CPAN yet, they might be found in the mod_perl
  I<contrib> directory at http://perl.apache.org/dist/contrib/.
  Otherwise, feel free to ask the contact author or the list how you can
  go about getting your hands on a copy. The modules listed with B<MPB>
  as the author were present in the I<Writing Apache Modules with Perl
  and C> book by Lincoln Stein and Doug MacEachern. If you can't find
  these modules on CPAN, look for them at
  http://modperl.com:9000/book/source/.
  
  
  

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