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: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]