cvs commit: modperl-docs/src/download third_party.pod
stas02/05/20 11:00:17 Modified:src/download third_party.pod Log: update the links to perl sources Revision ChangesPath 1.3 +4 -4 modperl-docs/src/download/third_party.pod Index: third_party.pod === RCS file: /home/cvs/modperl-docs/src/download/third_party.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- third_party.pod 20 May 2002 17:51:41 - 1.2 +++ third_party.pod 20 May 2002 18:00:17 - 1.3 @@ -12,10 +12,10 @@ Perl is probably already installed on your machine, but you should at least check the version you are using. It is highly recommended that you have at least Perl version 5.004. You can get the latest perl -version from http://www.perl.com/ . Try the direct download link -http://www.perl.com/pace/pub/perldocs/latest.html . You can get Perl -documentation from the same location (although copious documentation -is included in the downloaded Perl distribution). +version from http://cpan.org/src/. Try the direct download link +http://cpan.org/src/stable.tar.gz. You can get Perl documentation +from the same location (although copious documentation is included in +the downloaded Perl distribution). =head1 CPAN Downloads - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/products app-server.pod
stas02/05/19 01:47:13 Modified:src/products app-server.pod Log: add the Databreeze modperl product Submitted by: Per Einar Ellefsen [EMAIL PROTECTED] Revision ChangesPath 1.6 +21 -0 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.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- app-server.pod11 May 2002 11:54:45 - 1.5 +++ app-server.pod19 May 2002 08:47:12 - 1.6 @@ -99,5 +99,26 @@ Apache/mod_perl interface to the Template Toolkit, providing a quick and simple way to integrate its processing power into your web site. +=head1 DataBreeze Web Database Platform + +DataBreeze is written entirely in Perl and utilizes mod_perl within +Apache to speed performance. Feedback from the Perl/mod_perl/Apache +community is important. You may download the software for evaluation +at http://www.databreeze.com or simply logon and try DataBreeze +directly online. + +DataBreeze is very different from typical development tools because it +utilizes a pre-built application framework that requires no +programming. DataBreeze provides a template environment for building +database applications that list, search, explore and edit relational +data. The system includes integrated menus, forms, tree-views, +security, session/state management and more, all in a Web +Browser. DataBreeze can also be extended through the use of Event +programs using Perl. + +This is not free software but nothing is hidden, the complete Perl +source code is included so that you may explore how it works. + + =cut - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/download source.pod
stas02/05/19 02:20:17 Modified:src/download source.pod Log: tidy up Revision ChangesPath 1.6 +7 -5 modperl-docs/src/download/source.pod Index: source.pod === RCS file: /home/cvs/modperl-docs/src/download/source.pod,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- source.pod19 May 2002 09:19:27 - 1.5 +++ source.pod19 May 2002 09:20:17 - 1.6 @@ -19,7 +19,7 @@ distribution package) and the longer Lthe installation guide|docs::1.0::guide::install. -=head2 Stable source distribution +=head2 Stable Source Distribution =over @@ -33,7 +33,7 @@ =back -=head2 Development source distribution +=head2 Development Source Distribution =over @@ -48,7 +48,8 @@ % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl -For more information on using CVS see Lthe CVS HowTo|docs::general::cvs_howto +For more information on using CVS see Lthe CVS +HowTo|docs::general::cvs_howto =back @@ -58,7 +59,7 @@ distribution package) and the longer mod_perl 2.x Linstallation guide|docs::2.0::user::install::install. -=head2 2.x Development source distribution +=head2 2.x Development Source Distribution =over @@ -79,7 +80,8 @@ % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co apr % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co apr-util -For more information on using CVS see Lthe CVS HowTo|docs::general::cvs_howto +For more information on using CVS see Lthe CVS +HowTo|docs::general::cvs_howto =back - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/devel/testing testing.pod
stas02/05/19 02:37:17 Modified:src/docs/2.0/devel/testing testing.pod Log: - adjust have_module docs - document the APACHE_TEST_COLOR feature Revision ChangesPath 1.21 +14 -5 modperl-docs/src/docs/2.0/devel/testing/testing.pod Index: testing.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/devel/testing/testing.pod,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- testing.pod 17 May 2002 17:59:18 - 1.20 +++ testing.pod 19 May 2002 09:37:17 - 1.21 @@ -258,7 +258,7 @@ choice. that's approximately the time it takes to configure and start the server on a quite slow machine. -=head2 Verbose Testing +=head2 Verbose Mode In case something goes wrong you should run the tests in the verbose mode: @@ -283,12 +283,21 @@ -clean is run, It/logs/error_log gets deleted, therefore you have to run the tail(1) command again, when the server is started. -=head2 Controlling the Apache::Test's Sound to Noise Ratio +=head2 Colored Trace Mode + +If your terminal supports colored text you may want to set the +environment variable CAPACHE_TEST_COLOR to 1 to enable the colored +tracing which makes it easier to tell the reported errors and +warnings, from the rest of the notifications. Make sure that the +environment variable CAPACHE_TEST_COLOR is set to 0 (or not set at +all) if you redirect the output from the testing to a file. + +=head2 Controlling the Apache::Test's Signal to Noise Ratio In addition to controlling the verbosity of the test scripts, you can control the amount of information printed by the CApache::Test framework itself. Similar to Apache's log levels, CApache::Test uses -these levels for controlling its sound to noise ratio: +these levels for controlling its signal to noise ratio: emerg alert crit error warning notice info debug @@ -1827,10 +1836,10 @@ at least one of the modules is not found it returns a false value, otherwise it returns a true value. For example: - plan tests = 5, have_module qw(Chatbot::Eliza Apache::AI); + plan tests = 5, have_module qw(Chatbot::Eliza CGI mod_proxy); will skip the whole test unless both Perl modules CChatbot::Eliza -and CApache::AI are available. +and CCGI and the C module Imod_proxy.c are available. =item * have - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/install install.pod
stas02/05/19 02:38:21 Modified:src/docs/2.0/user/install install.pod Log: document the APACHE_TEST_COLOR feature Revision ChangesPath 1.12 +7 -0 modperl-docs/src/docs/2.0/user/install/install.pod Index: install.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/install/install.pod,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- install.pod 14 Apr 2002 07:11:49 - 1.11 +++ install.pod 19 May 2002 09:38:21 - 1.12 @@ -186,6 +186,13 @@ Command line options override those from Imakepl_args.mod_perl2 and those from CMP_OPTIONS_FILE. +If your terminal supports colored text you may want to set the +environment variable CAPACHE_TEST_COLOR to 1 to enable the colored +tracing which makes it easier to tell the reported errors and +warnings, from the rest of the notifications. Make sure that the +environment variable CAPACHE_TEST_COLOR is set to 0 (or not set at +all) if you redirect the output from the testing to a file. + =head2 Compile mod_perl % make - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs TODO
stas02/05/19 03:09:26 Modified:.TODO Log: todo update Revision ChangesPath 1.46 +7 -0 modperl-docs/TODO Index: TODO === RCS file: /home/cvs/modperl-docs/TODO,v retrieving revision 1.45 retrieving revision 1.46 diff -u -r1.45 -r1.46 --- TODO 14 May 2002 05:31:53 - 1.45 +++ TODO 19 May 2002 10:09:26 - 1.46 @@ -19,6 +19,10 @@ it's not a doc. STATUS: need to extend pod parser with Utitle (url|relative url) +- DocSet doesn't check if there are two indentical fragment anchors on + the same page. need to do that checking and unconditionally complain + when this happens. + Menu: - @@ -75,6 +79,9 @@ Search: --- + +- looks that the search checkboxes are messed up! offsite and + tutorials are in the 1.0 group - consider adding auto-focus feature: - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/compat compat.pod
stas02/05/19 03:40:02 Modified:src/docs/2.0/user/compat compat.pod Log: more markup Submitted by: per einar Revision ChangesPath 1.16 +3 -3 modperl-docs/src/docs/2.0/user/compat/compat.pod Index: compat.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/compat/compat.pod,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- compat.pod19 May 2002 09:43:55 - 1.15 +++ compat.pod19 May 2002 10:40:02 - 1.16 @@ -157,7 +157,7 @@ =head2 Cargs() -$r-Egtargs() in 2.0 returns the query string without parsing and +C$r-Egtargs() in 2.0 returns the query string without parsing and splitting it into an array. You can also set the query string by passing a string to this method. @@ -173,13 +173,13 @@ =head2 C$r-Egtconnection-Egtuser -This method is deprecated in 1.x and $r-Egtuser should be used +This method is deprecated in 1.x and C$r-Egtuser should be used instead for both versions of mod_perl. CApache::user() method is available since mod_perl version 1.24_01. =head2 Ccontent() -$r-Egtcontent() is not available in 2.0. +C$r-Egtcontent() is not available in 2.0. XXX: the reason? - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/help help_with_site.pod
stas02/05/19 03:40:51 Modified:src/help help_with_site.pod Log: add a note regarding small fonts in IE Submitted by:per einar Revision ChangesPath 1.8 +7 -0 modperl-docs/src/help/help_with_site.pod Index: help_with_site.pod === RCS file: /home/cvs/modperl-docs/src/help/help_with_site.pod,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- help_with_site.pod12 May 2002 18:09:13 - 1.7 +++ help_with_site.pod19 May 2002 10:40:51 - 1.8 @@ -28,6 +28,13 @@ somewhere and post the URL to the location of the shapshot, especially if the snapshot is of a big size. +=head2 Q. Fonts are too small/unreadable. + +This is a known problem with Internet Explorer, which comes shipped +with its Font setting to ISmaller. You'll have to set it to +IMedium unless you have extremely good eyes, which can be done by +going to CView -Egt Text Size and selecting IMedium. + =head2 Q. I cannot read the PDF version of the documents BA. The PDF files require a browser plugin or standalone PDF reader - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/win32 binaries.pod compile.pod multithread.pod
stas02/05/19 03:42:32 Modified:src/docs/1.0/win32 binaries.pod compile.pod multithread.pod Log: bring the win32 docs up to date with 2.0 development Revision ChangesPath 1.3 +9 -9 modperl-docs/src/docs/1.0/win32/binaries.pod Index: binaries.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/win32/binaries.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- binaries.pod 3 Apr 2002 08:07:16 - 1.2 +++ binaries.pod 19 May 2002 10:42:32 - 1.3 @@ -14,7 +14,7 @@ necessary Perl and Apache binaries: http://www.indigostar.com/ - + ftp://theoryx5.uwinnipeg.ca/pub/other/perl-win32-bin-x.x.exe As well as including a number of non-core modules, both of these @@ -79,7 +79,7 @@ The mod_perl PPM package also includes the necessary Apache DLL Cmod_perl.so; a post-installation script should be run which will offer to copy this file to your Apache modules directory (eg, -FC:\Apache\modules). +IC:\Apache\modules). Note that the mod_perl package available from this site will always use the latest mod_perl sources compiled against the latest official @@ -169,16 +169,16 @@ if a particular package could be included. Alternatively, you can use the CCPAN.pm module to fetch, build, and -install the module - see Cperldoc CPAN for details. You will need the -Bnmake utility for this, download it from http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe -(it's a self extracting archive, so run it and then copy the files into -your FWindows directory). +install the module - see Cperldoc CPAN for details. You will need +the Bnmake utility for this, download it from +http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe +(it's a self extracting archive, so run it and then copy the files +into your FWindows directory). =head1 See Also -The Imod_perl manpage, the LApache manpage, -http://perl.apache.org/, especially the guide, http://take23.org/, -http://httpd.apache.org/, and http://www.activestate.com/. +The Lmod_perl documentation|docs::index, http://httpd.apache.org/, +and http://www.activestate.com/. =head1 Maintainers 1.4 +1 -2 modperl-docs/src/docs/1.0/win32/compile.pod Index: compile.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/win32/compile.pod,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- compile.pod 13 Apr 2002 18:11:59 - 1.3 +++ compile.pod 19 May 2002 10:42:32 - 1.4 @@ -179,8 +179,7 @@ =head1 See Also -The Imod_perl manpage, the LApache manpage, -http://perl.apache.org/, especially the guide, and http://take23.org/. +The Lmod_perl documentation|docs::index, and http://take23.org/. =head1 Maintainers 1.3 +5 -18 modperl-docs/src/docs/1.0/win32/multithread.pod Index: multithread.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/win32/multithread.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- multithread.pod 3 Apr 2002 08:07:16 - 1.2 +++ multithread.pod 19 May 2002 10:42:32 - 1.3 @@ -18,23 +18,10 @@ production servers that often must handle concurrent or long-running requests. -This situation will change with Apache/mod_perl 2.0, which is -based on a multi-process/multi-thread approach using a native -Win32 threads implementation. See -http://perl.apache.org/~dougm/modperl_2.0.html for details. - -At the time of writing, Apache-2.0 is in a beta stage of -development. mod_perl-2.0 is being actively developed, including the -Win32 port; if you would like a preview and/or would like to -contribute to the development process, see the documents on obtaining -mod_perl-2.0 by cvs, which can be obtained from mod_perl's home page -at http://perl.apache.org/. Alternatively, a -mod_perl-2.0/Apache-2.0 binary distribution based on these cvs -sources is available from -ftp://theoryx5.uwinnipeg.ca/pub/other/Apache2.tar.gz. -See the accompanying FApache2.readme file in this directory for more -details. Be aware though that, being a pre-release version, -bugs are most likely present. +This situation changes with Apache/mod_perl 2.0, which is based on a +multi-process/multi-thread approach using a native Win32 threads +implementation See the Lmod_perl 2 +overview|docs::2.0::user::overview::overview for more details. =head1 Does it really matter? @@ -111,7 +98,7 @@ package should be more or less covered. (A IIS-FastCGI accelerator is, regrettably, no longer available
cvs commit: modperl-docs/src/outstanding/stats netcraft.html securityspace.html index.html
stas02/05/19 07:14:14 Modified:src/outstanding/stats netcraft.html securityspace.html Removed: src/outstanding/stats index.html Log: - Added descriptions to the stats and changed the wording/added a paragraph/changed the HTML. Submitted by: per einar Revision ChangesPath 1.3 +18 -13modperl-docs/src/outstanding/stats/netcraft.html Index: netcraft.html === RCS file: /home/cvs/modperl-docs/src/outstanding/stats/netcraft.html,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- netcraft.html 6 May 2002 08:14:34 - 1.2 +++ netcraft.html 19 May 2002 14:14:14 - 1.3 @@ -1,29 +1,34 @@ html head titleNetcraft's mod_perl statistics/title +meta name=description content=Netcraft provides monthly statistics +of mod_perl use, which we collect here and create statistics of /head -body bgcolor=#ff +body bgcolor=#ff -hr -img src=graph.jpg height=400 width=600 border=0 alt=Netcraft mod_perl usage Graph -br -br -The a href=graph.pl script /a that produced this graph and the a href=input.data -raw input data /a -br +p +a href=http://www.netcraft.co.uk/;Netcraft/a provides usage +statistics for mod_perl, grouped by host name or unique IP addresses, +which we collect here every month to create a graph displaying the +evolution of mod_perl usage./p + +img src=graph.jpg height=400 width=600 border=0 alt=Netcraft +mod_perl usage Graph + +pThe a href=graph.pl script /a that produced this graph and +the a href=input.data raw input data /a is available./p p If your site is running mod_perl, a href=http://www.netcraft.co.uk/up/graph/;tell/a the Netcraft survey. /p -p + !-- monthly reports can be retrieved from -http://www.netcraft.com/survey/Reports/200204/mod_perl.txt, -adjust the year/month if needed -- -/p +http://www.netcraft.com/survey/Reports/200204/mod_perl.txt, adjust the +year/month if needed -- table cellpadding=3 border=1 cellspacing=0 -trtdSurvey/tdtdhostnames/tdtdunique ip addresses/td/tr +trthSurvey/ththHostnames/ththUnique IP Addresses/th/tr trtd April 2002 /tdtd3633952/tdtd411314/td/tr trtd March 2002 /tdtd3478130/tdtd393860/td/tr trtd February 2002 /tdtd3354370/tdtd388506/td/tr 1.3 +10 -11modperl-docs/src/outstanding/stats/securityspace.html Index: securityspace.html === RCS file: /home/cvs/modperl-docs/src/outstanding/stats/securityspace.html,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- securityspace.html6 May 2002 08:14:34 - 1.2 +++ securityspace.html19 May 2002 14:14:14 - 1.3 @@ -1,20 +1,19 @@ html head titleSecurity Space's mod_perl statistics/title +meta name=description content=Security Space collects +statistics on all Apache modules, including mod_perl /head body bgcolor=#ff -p -SecuritySpace provides a -href=http://www.securityspace.com/s_survey/data/man.200204/apachemods.html; -mod_perl usage report/a. Once you reach their site, make sure to -click on the menu at the left to pick the latest month, since the link -hardcodes the month. They also provide a a -href=http://www.securityspace.com/s_survey/data/man.200204/apachemods.html?mod=cGVybA==;page/a -similar to this one with statistics and a graph based on the data -collected by a -href=http://www.securityspace.com/;www.securityspace.com/a -/p +p SecuritySpace provides an a +href=http://www.securityspace.com/s_survey/data/man.200204/apachemods.html?mod=cGVybA==;Apache +Module Report on mod_perl/a comprising statistics and a graph based +on the data collected by a +href=http://www.securityspace.com/;www.securityspace.com/a. They +also feature a +href=http://www.securityspace.com/s_survey/data/man.200204/apachemods.html;a +comparison/a between all the Apache modules they survey. /p /body /html - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/compat compat.pod
stas02/05/17 10:59:55
Modified:src/docs/2.0/user/compat compat.pod
Log:
bring the compat layer doc up to date
Revision ChangesPath
1.14 +230 -21 modperl-docs/src/docs/2.0/user/compat/compat.pod
Index: compat.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/compat/compat.pod,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- compat.pod14 May 2002 17:28:56 - 1.13
+++ compat.pod17 May 2002 17:59:55 - 1.14
@@ -7,6 +7,10 @@
This chapter explains how to port code from mod_perl 1.x to mod_perl
2.x.
+
+
+
+
=head1 Code Porting from 1.x to 2.x
mod_perl 2.x is trying hard to be back compatible with mod_perl
@@ -19,6 +23,14 @@
at the server startup. And unless there are forgotten things or bugs,
your code should work without any changes under 2.x series.
+If you have mod_perl 1.x and 2.x installed on the same system and the
+two use the same perl libraries directories (e.g. I/usr/lib/perl5),
+make sure to load first the CApache2 module which will perform the
+necessary adjustments to C@INC.
+
+ use Apache2; # if you have 1.x and 2.x installed
+ use Apache::compat;
+
However, unless you want to keep the 1.x compatibility, you should try
to remove the compatibility layer and adjust your code to work under
2.x without it. You want to do it mainly for the performance
@@ -27,6 +39,13 @@
This document explains what APIs have changed and what new APIs should
be used instead.
+
+
+
+
+
+
+
=head1 Configuration Directives
To migrate the configuration files to the 2.x syntax, you may need to
@@ -73,16 +92,111 @@
-=head1 Apache API
-To continue using Apache API from 1.x, load the compatibility module
-as early as possible:
- use Apache::compat;
-at the server startup.
+=head1 Apache::Constants
+
+CApache::Constants has been replaced by three classes:
+
+=over
+
+=item CApache::Const
+
+Apache constants
+
+=item CAPR::Const
+
+Apache Portable Runtime constants
+
+=item CModPerl::Const
+
+mod_perl specific constants
+
+=back
+
+See the manpages of the respective modules to figure out which
+constants they provide. (XXX: the manpages don't exist)
+
+META: add the info how to perform the transition. XXX: may be write a
+script, which can tell you how to port the constants to 2.0? Currently
+CApache::compat doesn't provide a complete back compatibility layer.
+
-=head2 Apache::gensym
+
+
+
+
+
+=head1 CApache:: functions
+
+=head2 args()
+
+$r-args() in 2.0 returns the query string without parsing and
+splitting it into an array. You can also set the query string by
+passing a string to this method.
+
+See the LApache::RequestRec manpage for more information.
+
+XXX: When Apache::Request will be ported to 2.0, you can use its
+params() and similar methods to do the parsing for you.
+
+=head2 chdir_file()
+
+XXX: Not implemented yet. And won't be implemented for the threaded
+mpms, since chdir is not thread-safe.
+
+=head2 $r-Egtconnection-Egtuser
+
+This method is deprecated in 1.x and $r-Egtuser should be used
+instead for both versions of mod_perl. CApache::user() method is
+available since mod_perl version 1.24_01.
+
+=head2 content()
+
+$r-content() is not available in 2.0.
+
+XXX: the reason?
+
+Instead you should perform something like the following:
+
+ sub content {
+ my $r = shift;
+
+ $r-setup_client_block;
+
+ return undef unless $r-should_client_block;
+
+ my $len = $r-headers_in-get('content-length');
+
+ my $buf;
+ $r-get_client_block($buf, $len);
+
+ return $buf unless wantarray;
+ return $r-parse_args($buf)
+ }
+
+=head2 exit()
+
+CApache::exit() has been replaced with CModPerl::Util::exit(),
+which is a function (not a method) and accepts a single optional
+argument: status, whose default is 0 (== do nothing).
+
+See the LModPerl::Util manpage for more information.
+
+
+=head2 finfo()
+
+XXX: not implemented yet. To be implemented. CApache::compat handles
+that for now with:
+
+ sub finfo {
+ my $r = shift;
+ stat $r-filename;
+ \*_;
+ }
+
+=head2 gensym()
Since Perl 5.6.1 filehandlers are autovivified and there is no need
for CApache::gensym() function, since now it can be done with:
@@ -90,18 +204,103 @@
open my $fh, foo or die $!;
Though the C function modperl_perl_gensym() is available for XS/C
-extension writers.
+extensions writers.
+
+=head2 header_in(), header_out() and err_header_out()
+
+Cheader_in(), Cheader_out() and Cerr_header_out() are not
+available in 2.0
cvs commit: modperl-docs/src/docs/1.0/api/Apache RegistryLoader.pod
stas02/05/16 05:16:48 Modified:src/docs/1.0/api Apache.pod src/docs/1.0/api/Apache RegistryLoader.pod Log: the PerlScript directive is deprecated, use PerlRequire instead Revision ChangesPath 1.11 +1 -1 modperl-docs/src/docs/1.0/api/Apache.pod Index: Apache.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/api/Apache.pod,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- Apache.pod12 May 2002 05:41:21 - 1.10 +++ Apache.pod16 May 2002 12:16:47 - 1.11 @@ -508,7 +508,7 @@ =item $s = Apache-Egtserver Same as above, but only available during server startup for use in -CEltPerlEgt sections, BPerlScript or BPerlModule. +CEltPerlEgt sections, BPerlRequire or BPerlModule. =item $s-Egtserver_admin 1.4 +1 -1 modperl-docs/src/docs/1.0/api/Apache/RegistryLoader.pod Index: RegistryLoader.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/api/Apache/RegistryLoader.pod,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- RegistryLoader.pod12 May 2002 05:41:21 - 1.3 +++ RegistryLoader.pod16 May 2002 12:16:48 - 1.4 @@ -33,7 +33,7 @@ ServerRoot /opt/www/apache Alias /perl/ /opt/www/apache/perl - #in PerlScript + #in startup.pl use Apache::RegistryLoader (); #/opt/www/apache/perl/test.pl - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide Changes.pod snippets.pod
stas02/05/15 08:33:15
Modified:src/docs credits.pod
src/docs/1.0/guide Changes.pod snippets.pod
Log:
new recipe: File Upload with Apache::Request
Submitted by: Rich Bowen [EMAIL PROTECTED]
Revision ChangesPath
1.4 +2 -0 modperl-docs/src/docs/credits.pod
Index: credits.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/credits.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- credits.pod 13 May 2002 04:47:24 - 1.3
+++ credits.pod 15 May 2002 15:33:15 - 1.4
@@ -450,6 +450,8 @@
=item * Rex Staples
+=item * Rich Bowen
+
=item * Richard A. Wells
=item * Richard Chen
1.25 +4 -0 modperl-docs/src/docs/1.0/guide/Changes.pod
Index: Changes.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/Changes.pod,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- Changes.pod 13 May 2002 07:16:37 - 1.24
+++ Changes.pod 15 May 2002 15:33:15 - 1.25
@@ -11,6 +11,10 @@
=head1 ??? ver 1.32
+* snippets.pod:
+
+ o new recipe: File Upload with Apache::Request [Rich Bowen]
+
* cookbook
o ported Passing Arguments to a SSI script from the modperl faq
1.10 +97 -0 modperl-docs/src/docs/1.0/guide/snippets.pod
Index: snippets.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/snippets.pod,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- snippets.pod 12 May 2002 07:29:30 - 1.9
+++ snippets.pod 15 May 2002 15:33:15 - 1.10
@@ -7,6 +7,103 @@
A collection of mod_perl code snippets which you can either adapt to
your own use or integrate directly into your own code.
+=head1 File Upload with Apache::Request
+
+The CApache::Request module gives you an easy way to get form
+content, including uploaded files. In order to add file upload
+functionality to your form, you need to add two things.
+
+First, you'll need to add a form field which is type Ifile. This
+will put a Cbrowse button on the form that will allow the user to
+choose a file to upload.
+
+Second, you'll neet to make sure to add, to the Cform tag the
+following:
+
+enctype=multipart/form-data
+
+You won't be able to upload a file unless you have added this to the
+Cform tag.
+
+In your code, you'll need to take a few extra steps to actually
+retrieve that file that has been uploaded. Using the following
+Cform() method will allow you to have a standard function that
+handles all of your forms, and does the right thing in the event that
+there was a file uploaded. You can put this function in your
+Cmod_perl handler, or in whatever module you want.
+
+ sub form {
+ use Apache::Request;
+ my $r = Apache-request();
+ my $apr = Apache::Request-new($r);
+ my @keys = $apr-param;
+
+ my %form;
+ foreach my $key(@keys) {
+
+ my @value = $apr-param($key);
+ next unless scalar @value;
+
+ if ( @value 1 ) {
+ $form{$key} = [EMAIL PROTECTED];
+} else {
+ $form{$key} = $value[0];
+ }
+ }
+
+ my $upload = $apr-upload;
+ if ($upload) {
+ $form{UPLOAD} = $upload;
+ }
+
+ return \%form;
+ }
+
+In your code, you can get the contents of the form by calling this
+function:
+
+ my $form = Your::Class::form(); # Wherever you put this function
+
+The value returned from this function is compatible with CCGI.pm and
+other modules such as CCGI::Lite Which is to say, the function
+returns a hashref. The keys of the hash are the names in your
+form. The values in the hash are the values entered in those fields,
+with the exception that a multiple select list with multiple things
+selected will return a listref of the selected values.
+
+IIf your form contained a file upload element, then C$form{UPLOAD}
+will contain a file upload object, which you can make calls back into.
+
+For example:
+
+ my $form = Your::Class::form(); # Wherever you put this function
+ if (my $file = $form-{UPLOAD}) {
+ my $filename = $file-filename; # If you need the name
+
+ # And, if you want to save the file at $filelocation ...
+ open F, $filelocation;
+ my $filehandle = $file-fh;
+ while (my $d = $filehandle) {
+ print F $d;
+ }
+ close F;
+ }
+
+That should give you the general idea of how this works. This lets you
+have a generic form handler that does normal forms as well
cvs commit: modperl-docs/tmpl/custom/html page_toc
stas02/05/13 20:58:58 Modified:tmpl/custom/html page_toc Log: provide a better solution for when to display the Table of Contents header. This should be a catch all clean solution. Revision ChangesPath 1.10 +1 -1 modperl-docs/tmpl/custom/html/page_toc Index: page_toc === RCS file: /home/cvs/modperl-docs/tmpl/custom/html/page_toc,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- page_toc 12 May 2002 12:01:56 - 1.9 +++ page_toc 14 May 2002 03:58:58 - 1.10 @@ -5,7 +5,7 @@ # toc - an array ref with keys: link, title, abstract, subs # (subs is optional and includes a similar array) -%] -[%- IF toc.size -%] +[%- IF toc.size toc.0.title -%] h3Table of Contents/h3 div class=toc - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/tmpl/custom/html left_box
stas02/05/13 22:16:06 Modified:tmpl/custom/html left_box Log: remove unnneeded ifs Revision ChangesPath 1.4 +0 -2 modperl-docs/tmpl/custom/html/left_box Index: left_box === RCS file: /home/cvs/modperl-docs/tmpl/custom/html/left_box,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- left_box 19 Apr 2002 19:53:34 - 1.3 +++ left_box 14 May 2002 05:16:06 - 1.4 @@ -14,7 +14,6 @@ br -[% IF 1 %] !-- search begin -- [%- INCLUDE search -%] @@ -22,7 +21,6 @@ !-- search end -- br -[% END %] !-- menu short_cuts begin -- - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs TODO
stas02/05/13 22:31:53
Modified:.TODO
Log:
shrinking TODO
Revision ChangesPath
1.45 +0 -18 modperl-docs/TODO
Index: TODO
===
RCS file: /home/cvs/modperl-docs/TODO,v
retrieving revision 1.44
retrieving revision 1.45
diff -u -r1.44 -r1.45
--- TODO 9 May 2002 10:21:43 - 1.44
+++ TODO 14 May 2002 05:31:53 - 1.45
@@ -10,23 +10,11 @@
- NS4, the navigation widgets are moved to the right, and need to
scroll horizontally to get to them. e.g. download/source.html
-- TOC's stylesheet needs fixing, so the visited links will show as
- such (they aren't now)
-
- check that the stylesheet doesn't have fixed sizes, especially fonts!
DocSet:
---
-- the sitemap doesn't show up as selected in the menu when you go there.
-
-- # if the pre section is too long ps2pdf fails to generate pdf,
-# so split it into 40 lines chunks.
-$result = '';
-while ($text =~ /((?:[^\n]*\n){1,40})/sg) {
- $result .= PRE$1/PRE\n;
-}
-
- how do we make Lfoo|../search/swish.cgi I cannot do search::swish,
it's not a doc.
STATUS: need to extend pod parser with Utitle (url|relative url)
@@ -65,10 +53,6 @@
- rewrite 404.html to be a plain hmtl to be copied as is to dst_html,
with a link to perl.apache.org only.
-- move docs/2.0/world to docs/offsite and rename 'offsite' to 'other'
- or something like that
- STATUS: this is going to happen as a part of a bigger revamp by Thomas.
-
- need to make the content review and adjust config.cfg files to
provide good abstracts. The same goes for src html files -- should
use the meta name=description value= to add abstracts here.
@@ -88,8 +72,6 @@
- ask perl.com to link to perl.apache.org from 'perl sites' section.
+ also they need to add theperlreview.com
-
-- link 'books' title in the menu to the books section.
Search:
---
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/bin makeindex
stas02/05/13 22:42:11
Modified:bin makeindex
Log:
make bin/makeindex is silent by default
run with -v to enable the verbose mode
Revision ChangesPath
1.6 +12 -3 modperl-docs/bin/makeindex
Index: makeindex
===
RCS file: /home/cvs/modperl-docs/bin/makeindex,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- makeindex 21 Apr 2002 16:34:24 - 1.5
+++ makeindex 14 May 2002 05:42:11 - 1.6
@@ -1,6 +1,12 @@
#!/usr/bin/perl -w
-# do the indexing process
+# run with -v to enable the verbose mode
+
+my %opts;
+use Getopt::Std;
+getopt('v', \%opts);
+
+# does the indexing process
# relies on setting of the following env varibles:
#
# the root of the site, without the trailing /
@@ -38,6 +44,9 @@
use FindBin qw($Bin);
use Cwd ();
+my $verbose_level = exists $opts{v} ? 1 : 0;
+my $verbose_level_reverse = exists $opts{v} ? 0 : 1;
+
my $swish_binary = $ENV{SWISH_BINARY_PATH} || './swish-e';
die Cannot find swish-e at $swish_binary: $! unless -x $swish_binary;
@@ -45,8 +54,8 @@
chdir $Bin/../dst_html/search;
# index
-my $command = $swish_binary -S prog -c swish.conf;
-#print $command;
+my $command = SPIDER_QUIET=$verbose_level_reverse $swish_binary -v
$verbose_level -S prog -c swish.conf;
+#print $command\n;
CORE::system($command);
chdir $cwd;
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/bin makeindex
stas02/05/13 22:51:38
Modified:bin makeindex
Log:
use a more portable solution to set env vars
Revision ChangesPath
1.7 +3 -1 modperl-docs/bin/makeindex
Index: makeindex
===
RCS file: /home/cvs/modperl-docs/bin/makeindex,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- makeindex 14 May 2002 05:42:11 - 1.6
+++ makeindex 14 May 2002 05:51:38 - 1.7
@@ -53,8 +53,10 @@
my $cwd = Cwd::fastcwd();
chdir $Bin/../dst_html/search;
+$ENV{SPIDER_QUIET} = $verbose_level_reverse;
+
# index
-my $command = SPIDER_QUIET=$verbose_level_reverse $swish_binary -v
$verbose_level -S prog -c swish.conf;
+my $command = $swish_binary -v $verbose_level -S prog -c swish.conf;
#print $command\n;
CORE::system($command);
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/lib/DocSet/DocSet PSPDF.pm
stas02/05/14 03:13:32
Modified:lib/DocSet/Doc Common.pm
lib/DocSet/DocSet PSPDF.pm
Log:
DocSet sync:
- provide the same data for the ps/index template as it was provided
for html/index
- bug fix in pre sections
Revision ChangesPath
1.10 +2 -1 modperl-docs/lib/DocSet/Doc/Common.pm
Index: Common.pm
===
RCS file: /home/cvs/modperl-docs/lib/DocSet/Doc/Common.pm,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- Common.pm 14 May 2002 05:24:57 - 1.9
+++ Common.pm 14 May 2002 10:13:32 - 1.10
@@ -158,7 +158,8 @@
# if the pre section is too long ps2pdf fails to generate pdf,
# so split it into 40 lines chunks.
my $result = '';
-while ($text =~ /((?:[^\n]*\n){1,40})/sg) {
+while ($text =~ /((?:[^\n]*\n?){1,40})/sg) {
+next unless length($1); # skip empty matches
$result .= qq{pre class=pre-section$1/pre\n};
}
1.4 +61 -4 modperl-docs/lib/DocSet/DocSet/PSPDF.pm
Index: PSPDF.pm
===
RCS file: /home/cvs/modperl-docs/lib/DocSet/DocSet/PSPDF.pm,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- PSPDF.pm 22 Mar 2002 02:01:52 - 1.3
+++ PSPDF.pm 14 May 2002 10:13:32 - 1.4
@@ -44,7 +44,9 @@
}
-
+# XXX: almost the same code as in ::HTML counterpart, consider
+# creating ::Common and re-use
+#
# generate the index.html file based on the doc entities it includes,
# in the following order: docsets, books, chapters
#
@@ -54,9 +56,36 @@
sub write_index_file {
my($self) = @_;
+my @toc = ();
+my $cache = $self-cache;
+
+# TOC
+my @node_groups = @{ $self-node_groups };
+my @ids = $cache-ordered_ids;
+
+# create the toc while skipping over hidden files
+if (@node_groups @ids) {
+# index's toc is built from groups of items' meta data
+while (@node_groups) {
+my($title, $count) = splice @node_groups, 0, 2;
+push @toc, {
+group_title = $title,
+subs = [map {$cache-get($_, 'meta')}
+ grep !$cache-is_hidden($_),
+ splice @ids, 0, $count],
+};
+}
+}
+else {
+# index's toc is built from items' meta data
+for my $id (grep !$cache-is_hidden($_), $cache-ordered_ids) {
+push @toc, $cache-get($id, 'meta');
+}
+}
+
my $dir = {
-abs_doc_root = $self-get_dir('abs_doc_root'),
-rel_doc_root = '..', # META: probably wrong, could be ../..! (see
write_index_html_file())
+abs_doc_root = $self-get_dir('abs_doc_root'),
+rel_doc_root = $self-get_dir('rel_parent_root'),
path_from_base = $self-get_dir('path_from_base'),
};
@@ -65,18 +94,46 @@
abstract = $self-get('abstract'),
};
-use DocSet::NavigateCache;
my $navigator = DocSet::NavigateCache-new($self-cache-path,
$self-get('id'));
my %args =
(
nav = $navigator,
+ toc = [EMAIL PROTECTED],
meta = $meta,
dir = $dir,
version = $self-get('version')||'',
date = get_date(),
last_modified = get_timestamp(),
);
+
+# plaster index top and bottom docs if defined (after converting them)
+if (my $body = $self-get('body')) {
+my $src_root = $self-get_dir('src_root');
+my $dst_mime = $self-get('dst_mime');
+
+for my $sec (qw(top bot)) {
+my $src_file = $body-{$sec};
+next unless $src_file;
+
+my $src_ext = filename_ext($src_file)
+or die cannot get an extension for $src_file;
+my $src_mime = $self-ext2mime($src_ext)
+or die unknown extension: $src_ext;
+my $conv_class = $self-conv_class($src_mime, $dst_mime);
+require_package($conv_class);
+
+my $chapter = $conv_class-new(
+tmpl_mode= $self-get('tmpl_mode'),
+tmpl_root= $self-get_dir('tmpl'),
+src_uri = $src_file,
+src_path = $src_root/$src_file,
+);
+$chapter-scan();
+$args{body}{$sec} = $chapter-converted_body();
+}
+
+}
my $dst_root = $self-get_dir('dst_root');
my $dst_file = $dst_root/index.html;
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e
cvs commit: modperl-docs/tmpl/custom/ps index_toc index_toc_section body index tail
stas02/05/14 03:16:48
Modified:tmpl/custom/ps body index tail
Added: tmpl/custom/ps index_toc index_toc_section
Log:
add index templates like in html/ so we can have the bot/top text in the
pdf, and as well, the descriptions of the chapters in the front TOC
- fix a few alignments
Revision ChangesPath
1.5 +1 -1 modperl-docs/tmpl/custom/ps/body
Index: body
===
RCS file: /home/cvs/modperl-docs/tmpl/custom/ps/body,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- body 29 Apr 2002 14:32:55 - 1.4
+++ body 14 May 2002 10:16:47 - 1.5
@@ -14,7 +14,7 @@
[% doc.meta.title %]
/h1
-hr class=PAGE-BREAK
+hr class=PAGE-BREAK
[% FOREACH sec = doc.body;
sec;
1.4 +43 -8 modperl-docs/tmpl/custom/ps/index
Index: index
===
RCS file: /home/cvs/modperl-docs/tmpl/custom/ps/index,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- index 25 Jan 2002 09:06:10 - 1.3
+++ index 14 May 2002 10:16:47 - 1.4
@@ -2,24 +2,59 @@
paget = doc.meta.title
title = mod_perl: $paget
%]
-pnbsp;/p
-pnbsp;/p
-pnbsp;/p
-pnbsp;/p
-pnbsp;/p
+
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
div align=centerfont size=7b[% doc.meta.title %]/b/font/div
-pnbsp;/p
-pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
-table align=center width=60%
+[%- IF doc.meta.abstract -%]
+table align=center width=60%
tr
td
[% doc.meta.abstract %]
/td
/tr
/table
+[% END -%]
+
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+pnbsp;/p
+
+p align=centerLast modified [% doc.last_modified %]/p
+
+hr class=PAGE-BREAK
+
+
+[%-
+IF doc.body.top;
+${doc.body.top}\n;
+END;
+
+PROCESS index_toc toc=doc.toc;
+
+IF doc.body.bot;
+${doc.body.bot}\n;
+END;
+
+-%]
[% INCLUDE tail %]
1.2 +2 -1 modperl-docs/tmpl/custom/ps/tail
Index: tail
===
RCS file: /home/cvs/modperl-docs/tmpl/custom/ps/tail,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- tail 5 Jan 2002 19:29:54 - 1.1
+++ tail 14 May 2002 10:16:47 - 1.2
@@ -1,3 +1,4 @@
/body
/html
-hr class=PAGE-BREAK
\ No newline at end of file
+hr class=PAGE-BREAK
+
1.1 modperl-docs/tmpl/custom/ps/index_toc
Index: index_toc
===
[%-#
# expected args:
# toc - an array with keys: link, stitle, title, abstract, subs
# (subs is optional and includes a similar array)
-%]
[%- numbers = ['I', 'II', 'III', 'IV', 'V', 'VI', 'VII', 'VIII', 'IX', 'X']
-%]
[%- IF toc.size -%]
[% SET chap_counter = 0 %]
div class=toc
[%- IF toc.0.group_title.defined;
SET counter = 0;
FOREACH group = toc;
bPart ${numbers.$counter}: ${group.group_title}/b;
PROCESS index_toc_section subs=group.subs;
counter = counter + 1;
END;
ELSE;
INCLUDE index_toc_section subs=toc;
END;
-%]
/div
[%- END -%]
1.1 modperl-docs/tmpl/custom/ps/index_toc_section
Index: index_toc_section
===
[%-# render one level of toc and call recursively itself if there are
# nested levels.
# expected args:
# subs - an array with keys indentical to 'toc' from above.
# chap_counter - is a global variable, which should be set to 0
#in the caller for the first loop
-%]
[%- FOREACH sec = subs -%]
[% SET chap_counter = chap_counter + 1%]
dl
dta href=[%- sec.link -%]img src=[%- doc.dir.abs_doc_root
-%]/images/arrow_right.gif alt=- align=bottom border=0 height=10
width=18[%- chap_counter -%]. [%- sec.title -%]/a/dt
[%- IF sec.abstract -%]
dd[%- sec.abstract -%]/dd
[%- END -%]
/dl
[%- END -%]
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/tmpl/custom/html index_toc index_toc_section
stas02/05/14 03:17:29
Modified:tmpl/custom/html index_toc index_toc_section
Log:
align
Revision ChangesPath
1.8 +12 -12modperl-docs/tmpl/custom/html/index_toc
Index: index_toc
===
RCS file: /home/cvs/modperl-docs/tmpl/custom/html/index_toc,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- index_toc 3 Apr 2002 05:18:27 - 1.7
+++ index_toc 14 May 2002 10:17:29 - 1.8
@@ -8,18 +8,18 @@
[%- IF toc.size -%]
div class=toc
-[%- IF toc.0.group_title.defined;
- SET counter = 0;
- FOREACH group = toc;
-h3Part ${numbers.$counter}: ${group.group_title}/h3;
-INCLUDE index_toc_section subs=group.subs;
-counter = counter + 1;
- END;
-ELSE;
- INCLUDE index_toc_section subs=toc;
-END;
--%]
+[%- IF toc.0.group_title.defined;
+SET counter = 0;
+FOREACH group = toc;
+bPart ${numbers.$counter}: ${group.group_title}/b;
+PROCESS index_toc_section subs=group.subs;
+counter = counter + 1;
+END;
+ELSE;
+INCLUDE index_toc_section subs=toc;
+END;
+-%]
/div
-[%- END -%]
\ No newline at end of file
+[%- END -%]
1.7 +2 -2 modperl-docs/tmpl/custom/html/index_toc_section
Index: index_toc_section
===
RCS file: /home/cvs/modperl-docs/tmpl/custom/html/index_toc_section,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- index_toc_section 8 Apr 2002 10:52:55 - 1.6
+++ index_toc_section 14 May 2002 10:17:29 - 1.7
@@ -9,9 +9,9 @@
dl
dta href=[%- sec.link -%]img src=[%-
doc.dir.abs_doc_root -%]/images/arrow_right.gif alt=- align=bottom
border=0 height=10 width=18[%- sec.title -%]/a/dt
-[%- IF sec.abstract -%]
+[%- IF sec.abstract -%]
dd[%- sec.abstract -%]/dd
-[%- END -%]
+[%- END -%]
/dl
[%- END -%]
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide getwet.pod intro.pod
stas02/05/14 03:20:58 Modified:src/docs/1.0/guide getwet.pod intro.pod Log: cleanups Revision ChangesPath 1.6 +9 -9 modperl-docs/src/docs/1.0/guide/getwet.pod Index: getwet.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/getwet.pod,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- getwet.pod12 May 2002 18:09:12 - 1.5 +++ getwet.pod14 May 2002 10:20:58 - 1.6 @@ -84,7 +84,7 @@ APACHE_PREFIX=/home/httpd DO_HTTPD=1 USE_APACI=1 EVERYTHING=1 % make make test % su - panic# make install + # make install That's all! @@ -228,12 +228,12 @@ command line. To become Iroot, use the Isu command. % su - panic# make install + # make install If you have the proper permission, you might also chain all three Imake commands into a single command line: - panic# make make test make install + # make make test make install C in shell program is similar to Perl's C. Each section of the statement will be executed left to right, untill all sections will @@ -257,8 +257,8 @@ Apache's header files (I*.h), default configuration files (I*.conf), the Ihttpd executable, and a few other programs. - panic# cd ../apache_x.x.x - panic# make install + # cd ../apache_x.x.x + # make install Note that, as with a plain Apache installation, any configuration files left from a previous installation will not be overwritten by @@ -305,11 +305,11 @@ server. One of the ways to start and stop the server is to use the Capachectl utility. This can be used to start the server with: - panic# /usr/local/apache/bin/apachectl start + # /usr/local/apache/bin/apachectl start And stop it with: - panic# /usr/local/apache/bin/apachectl stop + # /usr/local/apache/bin/apachectl stop Note that if the server is going to listen on port C80 or another privileged port (Any port with a number less than 1024 can be accessed @@ -501,7 +501,7 @@ which is insecure since other users on the same machine can read your files. - panic# chmod 0755 /home/stas/modperl + # chmod 0755 /home/stas/modperl If you aren't running the server with your username, you have to set these permissions for all the files created under this directory, so @@ -547,7 +547,7 @@ Now make the script executable and readable by the server, as explained in the previous section. - panic# chmod 0700 /home/stas/modperl/mod_perl_rules1.pl + # chmod 0700 /home/stas/modperl/mod_perl_rules1.pl The Imod_perl_rules1.pl script can be tested from the command line, since it is essentially a regular Perl script. 1.13 +1 -1 modperl-docs/src/docs/1.0/guide/intro.pod Index: intro.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/intro.pod,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- intro.pod 12 May 2002 05:44:11 - 1.12 +++ intro.pod 14 May 2002 10:20:58 - 1.13 @@ -1,6 +1,6 @@ =head1 NAME -Introduction. Incentives. Credits. +Introduction. Incentives. =head1 Description - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/devel/core_explained core_explained.pod
stas02/05/14 03:22:14 Modified:src/docs/2.0/devel/core_explained core_explained.pod Log: MP_GENERATE_XS=1 is the default now Revision ChangesPath 1.21 +6 -6 modperl-docs/src/docs/2.0/devel/core_explained/core_explained.pod Index: core_explained.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/devel/core_explained/core_explained.pod,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- core_explained.pod25 Mar 2002 17:00:37 - 1.20 +++ core_explained.pod14 May 2002 10:22:13 - 1.21 @@ -283,20 +283,20 @@ Ixs/tables/current. For example Ixs/maps/modperl_functions.map is converted into Ixs/tables/current/ModPerl/FunctionTable.pm. -If you don't want to do a visual check on how XS code will be -generated, just rebuild the project starting with Cperl Makefile.PL -MP_GENERATE_XS=1. Otherwise run: +If you want to do a visual check on how XS code will be generated, run: % make xs_generate -and verify that the autogenerated XS code under the I./Wrap -directory is correct. +and verify that the autogenerated XS code under the directory +I./WrapXS is correct. Otherwise build the project normally: + + % perl Makefile.PL ... =head2 XS generation process As mentioned before XS code is generated in the IWrapXS directory either during Cperl Makefile.PL via xs_generate() if -CMP_GENERATE_XS=1 is used or explicitly via: +CMP_GENERATE_XS=1 is used (which is the default) or explicitly via: % make xs_generate - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/api config.cfg
stas02/05/14 03:40:10
Modified:lib/Apache Reload.pm
src/docs/2.0/api config.cfg
Added: src/docs/2.0/api/mod_perl-2.0/Apache Reload.pod
Log:
- move the Apache::Reload doc into the docs area
- mark it up
Revision ChangesPath
1.4 +0 -115modperl-2.0/lib/Apache/Reload.pm
Index: Reload.pm
===
RCS file: /home/cvs/modperl-2.0/lib/Apache/Reload.pm,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- Reload.pm 7 Apr 2002 17:56:46 - 1.3
+++ Reload.pm 14 May 2002 10:40:10 - 1.4
@@ -141,118 +141,3 @@
1;
__END__
-
-=head1 NAME
-
-Apache::Reload - Reload changed modules
-
-=head1 SYNOPSIS
-
-In httpd.conf:
-
- PerlInitHandler Apache::Reload
- PerlSetVar ReloadAll Off
- #PerlSetVar ReloadDebug On
-
-Then your module:
-
- package My::Apache::Module;
-
- use Apache::Reload;
-
- sub handler { ... }
-
- 1;
-
-=head1 DESCRIPTION
-
-This module is two things. First it is an adaptation of Randal
-Schwartz's Stonehenge::Reload module that attempts to be a little
-more intuitive and makes the usage easier. Stonehenge::Reload was
-written by Randal to make specific modules reload themselves when
-they changed. Unlike Apache::StatINC, Stonehenge::Reload only checked
-the change time of modules that registered themselves with
-Stonehenge::Reload, thus reducing stat() calls. Apache::Reload also
-offers the exact same functionality as Apache::StatINC, and is thus
-designed to be a drop-in replacement. Apache::Reload only checks modules
-that register themselves with Apache::Reload if you explicitly turn off
-the StatINC emulation method (see below). Like Apache::StatINC,
-Apache::Reload must be installed as an Init Handler.
-
-=head2 StatINC Replacement
-
-To use as a StatINC replacement, simply add the following configuration
-to your httpd.conf:
-
- PerlInitHandler Apache::Reload
-
-=head2 Register Modules Implicitly
-
-To only reload modules that have registered with Apache::Reload,
-add the following to the httpd.conf:
-
- PerlInitHandler Apache::Reload
- PerlSetVar ReloadAll Off
- # ReloadAll defaults to On
-
-Then any modules with the line:
-
- use Apache::Reload;
-
-Will be reloaded when they change.
-
-=head2 Register Modules Explicitly
-
-You can also register modules explicitly in your httpd.conf file that
-you want to be reloaded on change:
-
- PerlInitHandler Apache::Reload
- PerlSetVar ReloadAll Off
- PerlSetVar ReloadModules My::Foo My::Bar Foo::Bar::Test
-
-Note that these are split on whitespace, but the module list Bmust
-be in quotes, otherwise Apache tries to parse the parameter list.
-
-=head2 Special Touch File
-
-You can also set a file that you can touch() that causes the reloads to be
-performed. If you set this, and don't touch() the file, the reloads don't
-happen. This can be a great boon in a live environment:
-
- PerlSetVar ReloadTouchFile /tmp/reload_modules
-
-Now when you're happy with your changes, simply go to the command line and
-type:
-
- % touch /tmp/reload_modules
-
-And your modules will be magically reloaded on the next request. This option
-works in both StatINC emulation mode and the registered modules mode.
-
-=head2 Debug
-
-You can enable the debugging mode with the setting:
-
- PerlSetVar ReloadDebug On
-
-=head1 PSUEDOHASHES
-
-The short summary of this is: Don't use psuedohashes. Use an array with
-constant indexes. Its faster in the general case, its more guaranteed, and
-generally, it works.
-
-The long summary is that I've done some work to get this working with
-modules that use psuedo hashes, but its still broken in the case of a
-single module that contains multiple packages that all use psuedohashes.
-
-So don't do that.
-
-=head1 AUTHOR
-
-Matt Sergeant, [EMAIL PROTECTED]
-
-=head1 SEE ALSO
-
-Stonehenge::Reload
-
-=cut
1.1
modperl-docs/src/docs/2.0/api/mod_perl-2.0/Apache/Reload.pod
Index: Reload.pod
===
=head1 NAME
Apache::Reload - Reload changed modules
=head1 Synopsis
In Ihttpd.conf:
PerlInitHandler Apache::Reload
PerlSetVar ReloadAll Off
#PerlSetVar ReloadDebug On
Then your module:
package My::Apache::Module;
use Apache::Reload;
sub handler { ... }
1;
=head1 Description
This module is two things. First it is an adaptation of Randal
Schwartz's CStonehenge::Reload module that attempts to be a little
more intuitive and makes the usage easier. CStonehenge::Reload was
written by Randal to make specific modules reload themselves when they
changed
cvs commit: modperl-docs/tmpl/custom/ps index
stas02/05/14 08:17:23 Modified:tmpl/custom/ps index Log: non need for so many newlines before last modified, since it slides off the page when the abstract is big Revision ChangesPath 1.5 +0 -6 modperl-docs/tmpl/custom/ps/index Index: index === RCS file: /home/cvs/modperl-docs/tmpl/custom/ps/index,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- index 14 May 2002 10:16:47 - 1.4 +++ index 14 May 2002 15:17:23 - 1.5 @@ -31,12 +31,6 @@ pnbsp;/p pnbsp;/p pnbsp;/p -pnbsp;/p -pnbsp;/p -pnbsp;/p -pnbsp;/p -pnbsp;/p -pnbsp;/p p align=centerLast modified [% doc.last_modified %]/p - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide performance.pod
stas02/05/14 10:42:14 Modified:src/docs/1.0/guide performance.pod Log: cleanup Revision ChangesPath 1.15 +4 -2 modperl-docs/src/docs/1.0/guide/performance.pod Index: performance.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/performance.pod,v retrieving revision 1.14 retrieving revision 1.15 diff -u -r1.14 -r1.15 --- performance.pod 13 May 2002 07:16:38 - 1.14 +++ performance.pod 14 May 2002 17:42:14 - 1.15 @@ -457,13 +457,15 @@ containing Perl/JSP/HTML/JavaScript/etc. and generates a detailed test report. -Available from CPAN. +It's available from CPAN. =item * CHTTP::Monkeywrench CHTTP::Monkeywrench is a test-harness application to test the integrity of a user's path through a web site. +It's available from CPAN. + =item * CHTTP::TestEngine CHTTP::TestEngine acts as an HTTP session recorder. An user @@ -471,7 +473,7 @@ CHTTP::Monkeywrench is currently supported, with plans for CHTTP::WebTest support in the future. -Available from http://sourceforge.net/projects/http-recorder/. +It's available from http://sourceforge.net/projects/http-recorder/. =back - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general Changes.pod perl_reference.pod
stas02/05/12 21:47:25
Modified:src/docs credits.pod
src/docs/general Changes.pod perl_reference.pod
Log:
o use the caller() trick instead of $^S to figure out whether we are
inside the eval() block. [Michael G. Schwern]
Revision ChangesPath
1.3 +2 -0 modperl-docs/src/docs/credits.pod
Index: credits.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/credits.pod,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- credits.pod 12 May 2002 10:38:17 - 1.2
+++ credits.pod 13 May 2002 04:47:24 - 1.3
@@ -376,6 +376,8 @@
=item * Michael Finke
+=item * Michael G. Schwern
+
=item * Michael Hall
=item * Michael Rendell
1.5 +4 -1 modperl-docs/src/docs/general/Changes.pod
Index: Changes.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/general/Changes.pod,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- Changes.pod 12 May 2002 10:50:32 - 1.4
+++ Changes.pod 13 May 2002 04:47:25 - 1.5
@@ -17,9 +17,12 @@
o inlined Mike Guy's news article about closures
+ o use the caller() trick instead of $^S to figure out whether we are
+inside the eval() block. [Michael G. Schwern]
+
* correct headers.pod
- o rewrite the headers of this chapter (Per Einar Ellefsen)
+ o rewrite the headers of this chapter [Per Einar Ellefsen]
* multiuser.pod
1.5 +28 -14modperl-docs/src/docs/general/perl_reference.pod
Index: perl_reference.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/general/perl_reference.pod,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- perl_reference.pod12 May 2002 10:29:20 - 1.4
+++ perl_reference.pod13 May 2002 04:47:25 - 1.5
@@ -2232,14 +2232,27 @@
However this won't work under CApache::Registry - you're always in
an eval block there!
-The other problem with C$SIG{__DIE__} also relates to its global nature.
-Because you might have more than one application running under mod_perl,
-you can't be sure which has set a C$SIG{__DIE__} handler when and for
-what. This can become extremely confusing when you start scaling up
-from a set of simple registry scripts that might rely on CGI::Carp for
-global exception handling (which uses C$SIG{__DIE__} to trap exceptions)
-to having many applications installed with a variety of exception
-handling mechanisms in place.
+C$^S isn't totally reliable in certain Perl versions. e.g. 5.005_03
+and 5.6.1 both do the wrong thing with it in certain situations.
+Instead, you use can use the caller() function to figure out if we are
+called in the eval() context:
+
+ $SIG{__DIE__} = sub {
+ my $in_eval = 0;
+ for(my $stack = 1; my $sub = (CORE::caller($stack))[3]; $stack++) {
+ $in_eval = 1 if $sub =~ /^\(eval\)/;
+ }
+ my_die_handler(@_) unless $in_eval;
+ };
+
+The other problem with C$SIG{__DIE__} also relates to its global
+nature. Because you might have more than one application running
+under mod_perl, you can't be sure which has set a C$SIG{__DIE__}
+handler when and for what. This can become extremely confusing when
+you start scaling up from a set of simple registry scripts that might
+rely on CGI::Carp for global exception handling (which uses
+C$SIG{__DIE__} to trap exceptions) to having many applications
+installed with a variety of exception handling mechanisms in place.
You should warn people about this danger of C$SIG{__DIE__} and
inform them of better ways to code. The following material is an
@@ -2255,19 +2268,20 @@
that string into something meaningful (unless of course all you want
your exception handler to do is dump the error to the browser). The
other problem is that you have no way of automatically detecting where
-the exception occurred using Ceval{} construct. In a C$SIG{__DIE__}
-block you always have the use of the caller() function to detect where
-the error occurred. But we can fix that...
+the exception occurred using Ceval{} construct. In a
+C$SIG{__DIE__} block you always have the use of the caller()
+function to detect where the error occurred. But we can fix that...
A little known fact about exceptions in perl 5.005 is that you can
call die with an object. The exception handler receives that object in
C$@. This is how you are advised to handle exceptions now, as it
-provides an extremely flexible and scalable exceptions solution, potentially
-providing almost all of the power Java exceptions.
+provides an extremely
cvs commit: modperl-docs/src/docs/1.0/guide Changes.pod performance.pod
stas02/05/13 00:16:38 Modified:src/docs/1.0/guide Changes.pod performance.pod Log: o add more benchmarking tools refs: HTTP::WebTest, HTTP::Monkeywrench, HTTP::TestEngine, HTTPD::Bench::ApacheBench Revision ChangesPath 1.24 +3 -0 modperl-docs/src/docs/1.0/guide/Changes.pod Index: Changes.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/Changes.pod,v retrieving revision 1.23 retrieving revision 1.24 diff -u -r1.23 -r1.24 --- Changes.pod 12 May 2002 09:56:53 - 1.23 +++ Changes.pod 13 May 2002 07:16:37 - 1.24 @@ -83,6 +83,9 @@ * performance.pod + o add more benchmarking tools refs: HTTP::WebTest, +HTTP::Monkeywrench, HTTP::TestEngine, HTTPD::Bench::ApacheBench + o update the benchmark in the section Apache::args vs. Apache::Request::param vs. CGI::param using Apache::Request 1.0. 1.14 +35 -2 modperl-docs/src/docs/1.0/guide/performance.pod Index: performance.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/performance.pod,v retrieving revision 1.13 retrieving revision 1.14 diff -u -r1.13 -r1.14 --- performance.pod 12 May 2002 18:09:12 - 1.13 +++ performance.pod 13 May 2002 07:16:38 - 1.14 @@ -247,11 +247,11 @@ =head4 ApacheBench -ApacheBench (Bab) is a tool for benchmarking your Apache HTTP +ApacheBench (Cab) is a tool for benchmarking your Apache HTTP server. It is designed to give you an idea of the performance that your current Apache installation can give. In particular, it shows you how many requests per second your Apache server is capable of -serving. The Bab tool comes bundled with the Apache source +serving. The Cab tool comes bundled with the Apache source distribution. Let's try it. We will simulate 10 users concurrently requesting a @@ -291,6 +291,9 @@ efficient we will try to improve it and run the benchmark again, to see whether we have any improve in performance. +CHTTPD::Bench::ApacheBench, available from CPAN, provides a Perl +interface for Cab. + =head4 httperf httperf is a utility written by David Mosberger. Just like @@ -441,6 +444,36 @@ The CApache::Timeit package is a part of the IApache-Perl-contrib files collection available from CPAN. + +=head3 Other Benchmarking Tools + +Other tools you may want to take a look at: + +=over + +=item * CHTTP::WebTest + +CHTTP::WebTest module runs tests on remote URLs or local web files +containing Perl/JSP/HTML/JavaScript/etc. and generates a detailed test +report. + +Available from CPAN. + +=item * CHTTP::Monkeywrench + +CHTTP::Monkeywrench is a test-harness application to test the +integrity of a user's path through a web site. + +=item * CHTTP::TestEngine + +CHTTP::TestEngine acts as an HTTP session recorder. An user +service's usage session is recorded and then can be played back. +CHTTP::Monkeywrench is currently supported, with plans for +CHTTP::WebTest support in the future. + +Available from http://sourceforge.net/projects/http-recorder/. + +=back =head2 Code Profiling Techniques - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general Changes.pod perl_reference.pod
stas02/05/11 22:11:34
Modified:src/docs/general Changes.pod perl_reference.pod
Log:
added a section on overriding functions to trace their failure.
Revision ChangesPath
1.2 +4 -0 modperl-docs/src/docs/general/Changes.pod
Index: Changes.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/general/Changes.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Changes.pod 29 Apr 2002 16:48:06 - 1.1
+++ Changes.pod 12 May 2002 05:11:33 - 1.2
@@ -11,6 +11,10 @@
=head1 ???
+* perf_reference:
+
+ o added a section on overriding functions to trace their failure.
+
* started the general documents docset [Thomas Klausner]
=cut
1.3 +60 -0 modperl-docs/src/docs/general/perl_reference.pod
Index: perl_reference.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/general/perl_reference.pod,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- perl_reference.pod11 May 2002 11:54:45 - 1.2
+++ perl_reference.pod12 May 2002 05:11:33 - 1.3
@@ -2573,6 +2573,66 @@
=back
+
+=head1 Customized __DIE__ hanlder
+
+As we saw in the previous sections it's a bad idea to do:
+
+ require Carp;
+ $SIG{__DIE__} = \Carp::confess;
+
+since it breaks the error propogations within eval {} blocks,. But
+starting from perl 5.6.x you can use another solution to trace
+errors. For example you get an error:
+
+ exit is not exported by the GLOB(0x88414cc) module at (eval 397) line 1
+
+and you have no clue where it comes from, you can override the exit()
+function and plug the tracer inside:
+
+ require Carp;
+ use subs qw(CORE::GLOBAL::die);
+ *CORE::GLOBAL::die = sub {
+ if ($_[0] =~ /exit is not exported/){
+ local *CORE::GLOBAL::die = sub { CORE::die(@_) };
+ Carp::confess(@_); # Carp uses die() internally!
+ } else {
+ CORE::die(@_); # could write CORE::die to forward @_
+ }
+ };
+
+Now we can test that it works properly without breaking the eval {}
+blocks error propogation:
+
+ eval { foo(); }; warn $@ if $@;
+ print \n;
+ eval { poo(); }; warn $@ if $@;
+
+ sub foo{ bar(); }
+ sub bar{ die qq{exit is not exported}}
+
+ sub poo{ tar(); }
+ sub tar{ die normal exit}
+
+prints:
+
+ $ perl -w test
+ Subroutine die redefined at test line 5.
+ exit is not exported at test line 6
+ main::__ANON__('exit is not exported') called at test line 17
+ main::bar() called at test line 16
+ main::foo() called at test line 12
+ eval {...} called at test line 12
+
+ normal exit at test line 5.
+
+the 'local' in:
+
+ local *CORE::GLOBAL::die = sub { CORE::die(@_) };
+
+is important, so you won't lose the overloaded CCORE::GLOBAL::die.
+
+
=head1 Maintainers
Maintainer is the person(s) you should contact with updates,
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general Changes.pod
stas02/05/11 22:20:25 Modified:src/docs/1.0/guide Changes.pod src/docs/general Changes.pod Log: remove guide:: from Changes files and move the relevant recent changes to the Changes file in the new directory Revision ChangesPath 1.21 +12 -22modperl-docs/src/docs/1.0/guide/Changes.pod Index: Changes.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/Changes.pod,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- Changes.pod 11 May 2002 11:54:44 - 1.20 +++ Changes.pod 12 May 2002 05:20:25 - 1.21 @@ -11,20 +11,20 @@ =head1 ??? ver 1.32 -* guide::method_handlers +* method_handlers.pod o moved here from the faqs -* guide::databases +* databases.pod o correct the notes regarding Opening Connections With Different Parameters for Apache::DBI. Must localize local changes. -* guide::getwet +* getwet.pod o a new chapter to get you started fast -* guide::porting +* porting.pod o add a new section Preventing Apache::Constants Stringification [Per Einar] @@ -38,7 +38,7 @@ o cover the 5.6's CHECK block in addition to INIT (Rafael Garcia-Suarez) -* guide::troubleshooting +* troubleshooting.pod o solution to the 'readdir()/opendir() not working' problem (Louis Semprini) @@ -46,32 +46,22 @@ o clearify how to solve the segfault problem caused by built-in mysql support in mod_php (Paul Buder) -* guide::modules +* modules.pod o extend on Apache::Filter(Per Einar Ellefsen) -* guide::correct headers - - o rewrite the headers of this chapter (Per Einar Ellefsen) - -* guide::config +* config.pod o extended on method handlers (Per Einar Ellefsen) o show an example on how to load the mod_perl related config only when mod_perl is loaded (Rafael Garcia-Suarez) -* guide::debug +* debug.pod o extended on curinfo macro (Per Einar Ellefsen) -* guide::multiuser - - o chroot(1) info - - o jail(8) info (Andrew McNaughton) - -* guide::help +* help.pod o chroot(1) urls @@ -79,12 +69,12 @@ o link to the internal resources (Per Einar Ellefsen) -* guide::install +* install.pod o James G Smith has uploaded his Apache Builder to CPAN, update the download links, to reflect this change. -* guide::performance +* performance.pod o update the benchmark in the section Apache::args vs. Apache::Request::param vs. CGI::param using Apache::Request @@ -97,7 +87,7 @@ o added a new section: Potential Drawbacks of Memory Sharing Restriction -* guide:: +* guide o most of the internal links were changed to use the whole title and not only first few words. The new build system support this. 1.3 +10 -0 modperl-docs/src/docs/general/Changes.pod Index: Changes.pod === RCS file: /home/cvs/modperl-docs/src/docs/general/Changes.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- Changes.pod 12 May 2002 05:11:33 - 1.2 +++ Changes.pod 12 May 2002 05:20:25 - 1.3 @@ -15,6 +15,16 @@ o added a section on overriding functions to trace their failure. +* correct headers.pod + + o rewrite the headers of this chapter (Per Einar Ellefsen) + +* multiuser.pod + + o chroot(1) info + + o jail(8) info (Andrew McNaughton) + * started the general documents docset [Thomas Klausner] =cut - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide intro.pod
stas02/05/11 22:32:24 Modified:src/docs/1.0/guide intro.pod Log: cut off the dups Revision ChangesPath 1.11 +0 -133modperl-docs/src/docs/1.0/guide/intro.pod Index: intro.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/intro.pod,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- intro.pod 12 May 2002 05:31:26 - 1.10 +++ intro.pod 12 May 2002 05:32:24 - 1.11 @@ -212,139 +212,6 @@ to contribute to this document please feel free to send me an email at [EMAIL PROTECTED] . -=head1 High-Profile Sites Running mod_perl - -A report prepared by Rex Staples at Thu, 14 Oct 1999: - -=over - -=item * - -Macromedia - -4,273,000 unique visitors/month Aug-1999 - -http://www.macromedia.com - -Apache/1.3.4 (Unix) mod_perl/1.18 on Solaris - -=item * - -ValueClick: Results-based advertising network - -80 million page views/day May 2000 using about 45 machines - -http://valueclick.com - -Apache/1.3.9-dev (Unix) mod_perl/1.21_01 on FreeBSD - -=item * - -Deja.com - -130 million pageviews/month Oct-1999 - -http://www.deja.com - -Apache/1.3b5 mod_perl/1.08 on Linux - -=item * - -MP3.com, Inc. - -77 million page views/month Aug-1999 - -408,000 unique visitors/day Aug-1999 - -http://www.mp3.com -http://www.mp3.com/pr/990914-keymetrics.html - -Apache/1.3.4-9 (Unix) mod_perl/1.18-21 on Linux/FreeBSD - -=item * - -IMDB: Internet Movie Database - -1.25 million page views/day Mar-1998 - -http://www.imdb.com/ - -* They are now an Amazon.com company - -Apache/1.3.7-dev (Unix) mod_perl/1.19_01-dev - -=item * - -Flash.net: Internet Service Provider - -1,603,000 unique visitors/month Aug-1999 - -http://www.flash.net/ - -Apache/1.2.4 mod_perl/1.00 on Solaris - -=item * - -At Hand Network Yellow Pages - -917,000 unique visitors/month Aug-1999 - -http://www.athand.com/ -http://www.mediametrix.com/ - -Stronghold/2.3 Apache/1.2.6 (Unix) mod_perl/1.15 on Solaris - -=item * - -Commissioner.com: Subscription Fantasy Football - -12 million page views/day Oct-1999 - -http://www.commissioner.com - -Apache/1.35b mod_perl/1.10 on Linux - -=item * - -Slashdot: News For Nerds - -400,000 page views/day Oct-1999 - -http://www.slashdot.org - -Apache/1.3.6 (Unix) mod_perl/1.21 on Linux - -=item * - -Hot Bot mail and member web pages: - -http://members.hotbot.com - -Also widely used on HotWired, WiredNews, Webmonkey, and Suck.com - -Apache/1.3.4 (Unix) mod_perl/1.21 on Solaris - -=item * - -Art Today: subscription clip-art service - -250k hits/day - -http://www.arttoday.com - -Oracle 7 + 1 Sun Ultra w/150GB storage -Apache/1.3.4 (Unix) mod_perl/1.17 on Solaris - -=item * - -CMPnet: a technology information network - -500k hits/day - -http://www.cmpnet.com - -Apache/1.3.9 (Unix) mod_perl/1.16 - =back =head1 Maintainers - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide Changes.pod
stas02/05/12 00:30:27 Modified:src/docs/1.0/guide Changes.pod Log: update changes Revision ChangesPath 1.22 +4 -0 modperl-docs/src/docs/1.0/guide/Changes.pod Index: Changes.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/Changes.pod,v retrieving revision 1.21 retrieving revision 1.22 diff -u -r1.21 -r1.22 --- Changes.pod 12 May 2002 05:20:25 - 1.21 +++ Changes.pod 12 May 2002 07:30:27 - 1.22 @@ -11,6 +11,10 @@ =head1 ??? ver 1.32 +* cookbook + + o ported Passing Arguments to a SSI script from the modperl faq + * method_handlers.pod o moved here from the faqs - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/outstanding sites.html
stas02/05/12 02:20:40 Modified:src/outstanding sites.html Log: adopt modperl sites removed from the intro.pod in the guide Submitted by: Per Einar Ellefsen [EMAIL PROTECTED] Revision ChangesPath 1.5 +24 -15modperl-docs/src/outstanding/sites.html Index: sites.html === RCS file: /home/cvs/modperl-docs/src/outstanding/sites.html,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- sites.html28 Apr 2002 12:58:29 - 1.4 +++ sites.html12 May 2002 09:20:40 - 1.5 @@ -133,6 +133,10 @@ href=http://www.slashcode.org/;SlashCode/a) which keeps things nice and speedy. /p +p bMacromedia: /b The creators of Flash and other interesting +web technologies and programs use mod_perl for a +href=http://www.macromedia.com/;their website/a./p + p bSearch engine: /b a href=http://www.sol.no/;Scandinavia @@ -153,6 +157,9 @@ CPAN multiplexer code to choose a nearby mirror of the archive, if available and desired. /p +p The a href=http://www.athand.com/;AtHand Network Yellow +pages/a serve their content thanks to mod_perl./p + p bPicture database:/b Gerald Richter and ECOS are using mod_perl @@ -200,7 +207,7 @@ 100,000,000 page views a month. Of course it's running under mod_perl. /p -p bMatch-making site:/b a +p bOnline communities:/b a href=http://www.webpersonals.com/;Webpersonals/a uses ttHTML::Embperl/tt running under mod_perl to drive this nice match making site. @@ -208,7 +215,7 @@ p -bInteractive text network:/b Alvar Freude uses mod_perl on +Alvar Freude uses mod_perl on a href=http://www.a-blast.org/;Assoziations-Blaster/a. It is a truly interactive text network, written completely in mod_perl. For a quick, non-technical overview take a look a @@ -241,6 +248,20 @@ are compressed on-the-fly with ttCompress::Zlib/tt, so we keep bandwidth (and transmission time to the users) small. /p +p + +Jayme Cox explains that at Broderbund Software, we have a site running +mod_perl to keep persistant database connections open between our +Apache web farm and our Oracle database server. We have a a +href=http://www.warlords3.com;game site/a that checks our Oracle +DB for a customers email address and lets them download additional +game maps if they have registered the software. Using persistant DB +connections increased the perceived response time by over 200%. +/p + +pThe a href=http://members2.fantasy.sportsline.com/;Fantasy +Sports/a site, which puts you in the position of manager of a group +of athletes, runs mod_perl to server its dynamic content./p p bOvulation calendar: /b a href=http://conceptionstore.com;Conceptionstore.com/a's a @@ -260,18 +281,6 @@ p -bGame site:/b Jayme Cox explains that at Broderbund Software, we -have a site running mod_perl to keep persistant database connections -open between our Apache web farm and our Oracle database server. We -have a a href=http://www.warlords3.com;game site/a that checks -our Oracle DB for a customers email address and lets them download -additional game maps if they have registered the software. Using -persistant DB connections increased the perceived response time by -over 200%. -/p - -p - bStatistics: /b Rick Mangi and a href=http://www.tgix.com/;Thaumaturgix, Inc./a use mod_perl to provide a method for gathering stats on web usage including a logging @@ -348,7 +357,7 @@ hr pIs byour/b site running mod_perl? a -href=../maillist/list-docs-dev.htmlLet us know!/a. /p +href=../maillist/docs-dev.htmlLet us know!/a. /p /body /html - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general perl_reference.pod
stas02/05/12 03:29:20
Modified:src/docs/general perl_reference.pod
Log:
put the news article with explanations of inner sub problems inline
Revision ChangesPath
1.4 +107 -3modperl-docs/src/docs/general/perl_reference.pod
Index: perl_reference.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/general/perl_reference.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- perl_reference.pod12 May 2002 05:11:33 - 1.3
+++ perl_reference.pod12 May 2002 10:29:20 - 1.4
@@ -365,9 +365,10 @@
=head2 Additional reading references
For more information see: LUsing global variables and sharing them
-between
modules/packages|general::perl_reference/Using_Global_Variables_and_Shari and
an
-article by Mark-Jason Dominus about how Perl handles variables and
-namespaces, and the difference between Cuse vars() and Cmy() -
+between
+modules/packages|general::perl_reference/Using_Global_Variables_and_Shari
+and an article by Mark-Jason Dominus about how Perl handles variables
+and namespaces, and the difference between Cuse vars() and Cmy() -
http://www.plover.com/~mjd/perl/FAQs/Namespaces.html .
=head1 my() Scoped Variable in Nested Subroutines
@@ -640,6 +641,109 @@
message. A Imy variable in a named subroutine context is generating
identical code references and therefore it ignores any future changes
to the lexical variables outside of it.
+
+=head2 Mike Guy's Explanation of the Inner Subroutine Behavior
+
+ From: [EMAIL PROTECTED] (M.J.T. Guy)
+ Newsgroups: comp.lang.perl.misc
+ Subject: Re: Lexical scope and embedded subroutines.
+ Date: 6 Jan 1998 18:22:39 GMT
+ Message-ID: [EMAIL PROTECTED]
+
+ In article [EMAIL PROTECTED], Aaron Harsh [EMAIL PROTECTED]
+ wrote:
+
+ Before I read this thread (and perlsub to get the details) I would
+ have assumed the original code was fine.
+
+ This behavior brings up the following questions:
+o Is Perl's behavior some sort of speed optimization?
+
+ No, but see below.
+
+o Did the Perl gods just decide that scheme-like behavior was less
+ important than the pseduo-static variables described in perlsub?
+
+ This subject has been kicked about at some length on perl5-porters.
+ The current behaviour was chosen as the best of a bad job. In the
+ context of Perl, it's not obvious what scheme-like behavior means.
+ So it isn't an option. See below for details.
+
+o Does anyone else find Perl's behavior counter-intuitive?
+
+ *Everyone* finds it counterintuitive. The fact that it only generates
+ a warning rather than a hard error is part of the Perl Gods policy of
+ hurling thunderbolts at those so irreverent as not to use -w.
+
+o Did programming in scheme destroy my ability to judge a decent
+ language
+ feature?
+
+ You're still interested in Perl, so it can't have rotted your brain
+ completely.
+
+o Have I misremembered how scheme handles these situations?
+
+ Probably not.
+
+o Do Perl programmers really care how much Perl acts like scheme?
+
+ Some do.
+
+o Should I have stopped this message two or three questions ago?
+
+ Yes.
+
+ The problem to be solved can be stated as
+
+When a subroutine refers to a variable which is instantiated more
+than once (i.e. the variable is declared in a for loop, or in a
+subroutine), which instance of that variable should be used?
+
+ The basic problem is that Perl isn't Scheme (or Pascal or any of the
+ other comparators that have been used).
+
+ In almost all lexically scoped languages (i.e. those in the Algol60
+ tradition), named subroutines are also lexically scoped. So the scope
+ of the subroutine is necessarily contained in the scope of any
+ external variable referred to inside the subroutine. So there's an
+ obvious answer to the which instance? problem.
+
+ But in Perl, named subroutines are globally scoped. (But in some
+ future Perl, you'll be able to write
+
+my sub lex { ... }
+
+ to get lexical scoping.) So the solution adopted by other languages
+ can't be used.
+
+ The next suggestion most people come up with is Why not use the most
+ recently instantiated variable?. This Does The Right Thing in many
+ cases, but fails when recursion or other complications are involved.
+
+ Consider:
+
+sub outer {
+inner();
+outer();
+my $trouble;
+inner();
+sub inner { $trouble };
+outer();
+inner();
+}
+
+ Which instance of $trouble is to be used for each call of inner()?
+ And why?
+
+ The consensus
cvs commit: modperl-docs/src/docs/1.0/faqs .cvsignore
stas02/05/12 03:31:21 Removed: src/docs/1.0/faqs .cvsignore Log: last of the mohicans - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src .htaccess
stas02/05/12 03:36:14 Modified:src .htaccess Log: adjust redirects for the recent moves Revision ChangesPath 1.7 +14 -14modperl-docs/src/.htaccess Index: .htaccess === RCS file: /home/cvs/modperl-docs/src/.htaccess,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- .htaccess 18 Apr 2002 07:53:10 - 1.6 +++ .htaccess 12 May 2002 10:36:14 - 1.7 @@ -6,24 +6,24 @@ Redirect permanent /guide/ http://perl.apache.org/docs/1.0/guide/ # Distributed with mod_perl -Redirect permanent /src/mod_perl.html http://perl.apache.org/docs/1.0/faqs/mod_perl.html +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/cgi_to_mod_perl.html http://perl.apache.org/docs/1.0/faqs/cgi_to_mod_perl.html -Redirect permanent /src/mod_perl_traps.html http://perl.apache.org/docs/1.0/faqs/mod_perl_traps.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/1.0/faqs/mod_perl.html +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/cgi_to_mod_perl.html http://perl.apache.org/docs/1.0/faqs/cgi_to_mod_perl.html -Redirect permanent /dist/mod_perl_traps.html http://perl.apache.org/docs/1.0/faqs/mod_perl_traps.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/1.0/faqs/mod_perl_cgi.html -Redirect permanent /mod_perl_cvs.html http://perl.apache.org/docs/1.0/faqs/mod_perl_cvs.html -Redirect permanent /faq/index.html http://perl.apache.org/docs/1.0/faqs/mod_perl_faq.html -Redirect permanent /tuning/index.html http://perl.apache.org/docs/1.0/faqs/mod_perl_tuning.html -Redirect permanent /faq/mod_perl_api.html http://perl.apache.org/docs/1.0/faqs/mod_perl_api.html -Redirect permanent /features/tmpl-cmp.html http://perl.apache.org/docs/2.0/world/templates/choosing.html -Redirect permanent /perl_myth.html http://perl.apache.org/docs/1.0/faqs/perl_myth.html +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/index.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 /perl_myth.html http://perl.apache.org/docs/general/perl_myth.html Redirect permanent /distributions.html http://perl.apache.org/download/index.html Redirect permanent /tidbits.html http://perl.apache.org/docs/offsite/articles.html @@ -61,7 +61,7 @@ Redirect permanent /email-etiquette.html http://perl.apache.org/maillist/email-etiquette.html # Jobs -Redirect permanent /jobs.html http://perl.apache.org/about/jobs.html +Redirect permanent /jobs.html http://perl.apache.org/jobs/jobs.html # Stats Redirect permanent /netcraft/index.html http://perl.apache.org/outstanding/stats/netcraft.html - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs credits.pod
stas02/05/12 03:38:17 Modified:src/docs credits.pod Log: update credits from the removed faqs Revision ChangesPath 1.2 +2 -0 modperl-docs/src/docs/credits.pod Index: credits.pod === RCS file: /home/cvs/modperl-docs/src/docs/credits.pod,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- credits.pod 12 May 2002 05:31:26 - 1.1 +++ credits.pod 12 May 2002 10:38:17 - 1.2 @@ -302,6 +302,8 @@ =item * Jeffrey W. Baker +=item * Jens Heunemann + =item * Jie Gao =item * Joao Fonseca - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide config.pod
stas02/05/12 03:38:45 Modified:src/docs/1.0/guide config.pod Log: link to the PerlTaintCheck discussion Revision ChangesPath 1.10 +4 -3 modperl-docs/src/docs/1.0/guide/config.pod Index: config.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/config.pod,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- config.pod12 May 2002 09:56:53 - 1.9 +++ config.pod12 May 2002 10:38:45 - 1.10 @@ -2074,9 +2074,10 @@ PerlTaintCheck On -setting in the Ihttpd.conf file. This doesn't ensure that your code -is completely safe from external hacks, but it does prevent many -security problems. Refer to the perlsec manpage for more information. +setting in the Ihttpd.conf file. LTaint +checking|/PerlWarn_and_PerlTaintCheck doesn't ensure that +your code is completely safe from external hacks, but it does forces +you to improve your code to prevent many potential security problems. =head2 Exposing Information About the Server's Component - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general Changes.pod
stas02/05/12 03:50:32 Modified:src/docs/general Changes.pod Log: log the change Revision ChangesPath 1.4 +2 -0 modperl-docs/src/docs/general/Changes.pod Index: Changes.pod === RCS file: /home/cvs/modperl-docs/src/docs/general/Changes.pod,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- Changes.pod 12 May 2002 05:20:25 - 1.3 +++ Changes.pod 12 May 2002 10:50:32 - 1.4 @@ -15,6 +15,8 @@ o added a section on overriding functions to trace their failure. + o inlined Mike Guy's news article about closures + * correct headers.pod o rewrite the headers of this chapter (Per Einar Ellefsen) - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/search .swishcgi.conf search_options
stas02/05/12 04:54:13 Modified:src/search .swishcgi.conf search_options Log: shorten the label Revision ChangesPath 1.9 +1 -1 modperl-docs/src/search/.swishcgi.conf Index: .swishcgi.conf === RCS file: /home/cvs/modperl-docs/src/search/.swishcgi.conf,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- .swishcgi.conf12 May 2002 10:37:45 - 1.8 +++ .swishcgi.conf12 May 2002 11:54:13 - 1.9 @@ -25,7 +25,7 @@ 2 docs/2.0/api API 1 docs/general General Docs 1 docs/tutorialsTutorials -1 docs/offsite OffSite Resources +1 docs/offsite OffSite Docs 0 help Getting Help 0 products Products 0 contribute Contribute 1.5 +1 -1 modperl-docs/src/search/search_options Index: search_options === RCS file: /home/cvs/modperl-docs/src/search/search_options,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- search_options12 May 2002 10:32:37 - 1.4 +++ search_options12 May 2002 11:54:13 - 1.5 @@ -36,7 +36,7 @@ docs/2.0/api = 'API' docs/general = '..General Docs' docs/tutorials= '..Tutorials' -docs/offsite = '..OffSite Resources' +docs/offsite = '..OffSite Docs' help = 'Getting Help' maillist = 'Mailing Lists' products = 'Products' - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/tmpl/custom/html short_cuts
stas02/05/12 04:56:35
Modified:tmpl/custom/html short_cuts
Log:
add shortcuts for reporting problems
Revision ChangesPath
1.4 +2 -0 modperl-docs/tmpl/custom/html/short_cuts
Index: short_cuts
===
RCS file: /home/cvs/modperl-docs/tmpl/custom/html/short_cuts,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- short_cuts12 May 2002 11:51:51 - 1.3
+++ short_cuts12 May 2002 11:56:35 - 1.4
@@ -7,6 +7,8 @@
[ ${doc.dir.abs_doc_root}/maillist/modperl.html#Searchable_Archives,
'Maillist Archives'],
[${doc.dir.abs_doc_root}/docs/1.0/guide/index.html, 'The 1.x guide'],
[${doc.dir.abs_doc_root}/download/source.html#Stable_source_distribution,
'The 1.x source'],
+
[${doc.dir.abs_doc_root}/docs/1.0/guide/help.html#How_to_Report_Problems,
'Reporting 1.x Problems'],
+
[${doc.dir.abs_doc_root}/docs/2.0/user/help/help.html#Reporting_Problems,
'Reporting 2.x Problems'],
];
-%]
[%- WRAPPER wrap_box
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/tmpl/custom/html page_toc
stas02/05/12 05:01:56 Modified:tmpl/custom/html page_toc Log: - always display TOC, since it breaks links checking for #anchor, when there is only one item. - the current logic was wrong anyway because it was checked whether there is only one top level header, and will not print TOC even if there were 20 =head2 headers Revision ChangesPath 1.9 +1 -1 modperl-docs/tmpl/custom/html/page_toc Index: page_toc === RCS file: /home/cvs/modperl-docs/tmpl/custom/html/page_toc,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- page_toc 3 Apr 2002 05:18:27 - 1.8 +++ page_toc 12 May 2002 12:01:56 - 1.9 @@ -5,7 +5,7 @@ # toc - an array ref with keys: link, title, abstract, subs # (subs is optional and includes a similar array) -%] -[%- IF toc.size toc.size 1 -%] +[%- IF toc.size -%] h3Table of Contents/h3 div class=toc - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/outstanding sites.html
stas02/05/12 05:10:40 Modified:src/outstanding sites.html Log: fix back the list prefix Revision ChangesPath 1.8 +1 -1 modperl-docs/src/outstanding/sites.html Index: sites.html === RCS file: /home/cvs/modperl-docs/src/outstanding/sites.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- sites.html12 May 2002 12:04:29 - 1.7 +++ sites.html12 May 2002 12:10:40 - 1.8 @@ -10,7 +10,7 @@ This document contains information to give you an idea of where and more importantly, bhow/b mod_perl is being used. If you have an interesting mod_perl application, let a -href=../maillist/list-docs-dev.htmlus/a know about it! +href=../maillist/docs-dev.htmlus/a know about it! /p p Of course, the sites described on this page are not the only sites - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide performance.pod
stas02/05/12 09:38:32 Modified:src/docs/1.0/guide performance.pod Log: fix broken internal links Revision ChangesPath 1.12 +17 -16modperl-docs/src/docs/1.0/guide/performance.pod Index: performance.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/performance.pod,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- performance.pod 11 May 2002 11:54:44 - 1.11 +++ performance.pod 12 May 2002 16:38:32 - 1.12 @@ -2591,7 +2591,7 @@ There are very important OS parameters that you might want to change in order to improve the server performance. This topic is discussed in the section: LSetting the Buffering Limits on Various -OSes|guide::scenario/Setting_the_Buffering_Limits_on_ +OSes|guide::scenario/Setting_the_Buffering_Limits_on_Various_OSs =head1 Performance Tuning by Tweaking Apache Configuration @@ -2985,12 +2985,12 @@ Your children can share memory between them when the OS supports that. You must take action to allow the sharing to happen - See LPreload Perl modules at server -startup|guide::performance/Preloading_Perl_Modules_at_Serve. If you do -this, the chances are that your CMaxClients can be even higher. But -it seems that it's not so simple to calculate the absolute number. If -you come up with a solution please let us know! If the shared memory -was of the same size throughout the child's life, we could derive a -much better formula: +startup|guide::performance/Preloading_Perl_Modules_at_Server_Startup. +If you do this, the chances are that your CMaxClients can be even +higher. But it seems that it's not so simple to calculate the +absolute number. If you come up with a solution please let us know! +If the shared memory was of the same size throughout the child's life, +we could derive a much better formula: Total_RAM + Shared_RAM_per_Child * (MaxClients - 1) MaxClients = --- @@ -4497,10 +4497,11 @@ reference to an object, but even then it can be passed by value. I strongly endorse LApache::Request (libapreq) - Generic Apache -Request Library|guide::modules/Apache_Request_libapreq_Gen. Its core is -written in C, giving it a significant memory and performance benefit. -It has all the functionality of CCGI.pm except the HTML generation -functions. +Request +Library|guide::modules/Apache__Request__libapreqGeneric_Apache_Request_Library. +Its core is written in C, giving it a significant memory and +performance benefit. It has all the functionality of CCGI.pm except +the HTML generation functions. =head2 Interpolation, Concatenation or List @@ -4683,7 +4684,7 @@ processes would show only one entry or none at all, since they might not serve the same requests as the others. For more hints see the section LRun the server in single -mode|general::control/Running_a_Server_in_Single_Proce. +mode|general::control/Running_a_Server_in_Single_Process_Mode. =head1 Improving Performance by Prevention @@ -4974,7 +4975,7 @@ from Growing|guide::performance/Preventing_Your_Processes_from_Growing and LLimiting Other Resources Used by Apache Child -Processes|guide::performance/Limiting_Other_Resources_Used_by. +Processes|guide::performance/Limiting_Other_Resources_Used_by_Apache_Child_Processes. =head2 Preventing Your Processes from Growing @@ -5366,7 +5367,7 @@ =head2 Sending Plain HTML as Compressed Output See LApache::GzipChain - compress HTML (or anything) in the -OutputChain|guide::modules/Apache_GzipChain_compress_HTM +OutputChain|guide::modules/Apache__GzipChain___compress_HTML__or_anything__in_the_OutputChain =head2 Caching Components with HTML::Mason @@ -5856,7 +5857,7 @@ Proxy gives you a great performance increase in most cases. It's discussed in the section LAdding a Proxy Server in http Accelerator -Mode|guide::strategy/Adding_a_Proxy_Server_in_http_Ac. +Mode|guide::strategy/Adding_a_Proxy_Server_in_http_Accelerator_Mode. =head1 Upload and Download of Big Files @@ -5872,7 +5873,7 @@ downloading of big files, you probably want it to be executed on a plain apache server under mod_cgi (i.e. performing this operation on the front-end server, if you use La dual-server -setup|guide::scenario/One_Plain_and_One_mod_perl_enabl. +setup|guide::scenario/One_Plain_and_One_mod_perl_enabled_Apache_Servers. This of course assumes that the script requires none of the functionality of the mod_perl server, such as custom authentication - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/maillist README index_top.html
stas02/05/12 11:09:13 Modified:src/docs/1.0/api/Apache Registry.pod src/docs/1.0/guide frequent.pod getwet.pod performance.pod troubleshooting.pod src/docs/offsite other.pod src/help help_with_site.pod index_top.html src/maillist README index_top.html Log: broken links fixing crusade Revision ChangesPath 1.4 +1 -1 modperl-docs/src/docs/1.0/api/Apache/Registry.pod Index: Registry.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/api/Apache/Registry.pod,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- Registry.pod 12 May 2002 05:41:21 - 1.3 +++ Registry.pod 12 May 2002 18:09:12 - 1.4 @@ -21,7 +21,7 @@ scripts very fast under mod_perl, by compiling all scripts once and then caching them in memory. -URIs in the form of Ihttp://www.host.com/perl/file.pl will be +URIs in the form of Ihttp://www.example.com/perl/file.pl will be compiled as the body of a perl subroutine and executed. Each server process or 'child' will compile the subroutine once and store it in memory. It will recompile it whenever the file is updated on disk. 1.6 +2 -2 modperl-docs/src/docs/1.0/guide/frequent.pod Index: frequent.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/frequent.pod,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- frequent.pod 11 May 2002 11:54:44 - 1.5 +++ frequent.pod 12 May 2002 18:09:12 - 1.6 @@ -6,8 +6,8 @@ Some problems come up very often on the mailing list. If there is some important problem that is being reported frequently on the list -which is not included below, even if it is found elsewhere in the Guide, -please Ltell me|guide::help/Contacting_me. +which is not included below, even if it is found elsewhere in the +Guide, please report to Lmod_perl mailing list|maillist::modperl. =head1 my() scoped variable in nested subroutines 1.5 +3 -3 modperl-docs/src/docs/1.0/guide/getwet.pod Index: getwet.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/getwet.pod,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- getwet.pod10 May 2002 07:47:40 - 1.4 +++ getwet.pod12 May 2002 18:09:12 - 1.5 @@ -325,11 +325,11 @@ mod_perl/1.24 configured -- resuming normal operations Now point the browser to Ihttp://localhost/ or -Ihttp://your.server.name/ as configured with the CServerName +Ihttp://example.name/ as configured with the CServerName directive. If the CPort directive has been set with a value different from C80, add this port number at the end of the server name. For example, if the port is 8080, test the server with -Ihttp://localhost:8080/ or Ihttp://your.server.name:8080/. The +Ihttp://localhost:8080/ or Ihttp://example.com:8080/. The infamous IIt worked page should appear in the browser, which is an Cindex.html file that Cmake install in the Apache source tree installs automatically. If this page does not appear, something went @@ -582,7 +582,7 @@ the same machine as the server. If not, use the real server name for this test. For example: - http://your.server.name/perl/mod_perl_rules1.pl + http://example.com/perl/mod_perl_rules1.pl If there is any problem please refer to the Ierror_log file for the error messages. 1.13 +3 -2 modperl-docs/src/docs/1.0/guide/performance.pod Index: performance.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/performance.pod,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- performance.pod 12 May 2002 16:38:32 - 1.12 +++ performance.pod 12 May 2002 18:09:12 - 1.13 @@ -5414,8 +5414,9 @@ notoriously latency-sensitive which in most cases generates a network transaction per row returned which slows things down if the query execution matches many rows. You may want to read the Tim Bunce's -Advanced DBI talk at http://www.carumba.com/talk/perl/DBI_Talk3_1999/ -which covers a lot of techniques to reduce latency. +Advanced DBI talk at +http://dbi.perl.org/doc/conferences/tim_1999/index.html which covers a +lot of techniques to reduce latency. So here is the basic approach of making the connection persistent: 1.11 +3 -3 modperl-docs/src/docs/1.0/guide/troubleshooting.pod Index: troubleshooting.pod
cvs commit: modperl-docs/src/start/tips registry.pod
stas02/05/11 04:54:45
Modified:src config.cfg
src/docs/1.0/api Apache.pod
src/docs/1.0/guide Changes.pod config.pod debug.pod
frequent.pod help.pod install.pod intro.pod
modules.pod performance.pod porting.pod
scenario.pod snippets.pod strategy.pod
troubleshooting.pod
src/docs/general correct_headers.pod hardware.pod
multiuser.pod perl_reference.pod
src/maillist email-etiquette.pod
src/products app-server.pod
src/start/tips registry.pod
Added: src/docs/tutorials .cvsignore
Log:
fix links after the files were moved around
Revision ChangesPath
1.26 +1 -0 modperl-docs/src/config.cfg
Index: config.cfg
===
RCS file: /home/cvs/modperl-docs/src/config.cfg,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- config.cfg10 May 2002 08:03:43 - 1.25
+++ config.cfg11 May 2002 11:54:44 - 1.26
@@ -88,6 +88,7 @@
docs/2.0
docs/1.0/api
docs/1.0
+ docs
.
)],
# what extensions to search for
1.9 +1 -1 modperl-docs/src/docs/1.0/api/Apache.pod
Index: Apache.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/api/Apache.pod,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- Apache.pod27 Apr 2002 03:34:13 - 1.8
+++ Apache.pod11 May 2002 11:54:44 - 1.9
@@ -1029,7 +1029,7 @@
perl,
LApache::Constants,
LApache::Registry,
-LApache::Debug,
+CApache::Debug,
LApache::Options,
CGI
1.20 +1 -1 modperl-docs/src/docs/1.0/guide/Changes.pod
Index: Changes.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/Changes.pod,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- Changes.pod 10 May 2002 07:47:40 - 1.19
+++ Changes.pod 11 May 2002 11:54:44 - 1.20
@@ -112,7 +112,7 @@
* Minor corrections:
- o remove qw() or variables list in guide::perl (Tim Noll
+ o remove qw() or variables list in general::perl_reference (Tim Noll
[EMAIL PROTECTED])
o install: (Per Einar Ellefsen [EMAIL PROTECTED], Karl Olson
1.8 +1 -1 modperl-docs/src/docs/1.0/guide/config.pod
Index: config.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/config.pod,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- config.pod5 May 2002 18:22:33 - 1.7
+++ config.pod11 May 2002 11:54:44 - 1.8
@@ -1402,7 +1402,7 @@
the startup file and in the script itself. The confusion arises due to
misunderstanding the Cuse() function. Cuse() normally performs two
operations, namely Crequire() and Cimport(), called within a
-CBEGIN block. See the section Luse()|guide::perl/use__ for a detailed
+CBEGIN block. See the section Luse()|general::perl_reference/use__ for
a detailed
explanation of the use(), require() and import() functions.
In the startup file we don't want to import any symbols since they
1.9 +4 -4 modperl-docs/src/docs/1.0/guide/debug.pod
Index: debug.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/debug.pod,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- debug.pod 13 Apr 2002 19:26:54 - 1.8
+++ debug.pod 11 May 2002 11:54:44 - 1.9
@@ -1097,7 +1097,7 @@
It was recently discovered that Clocal $SIG{'ALRM'} does not restore
the original underlying C handler. This was fixed in mod_perl 1.19_01
-(LCVS version|guide::download/mod_perl). As a matter of fact none of the
+(LCVS version|download::third_party/mod_perl). As a matter of fact none
of the
Clocal $SIG{FOO} signals restores the original C handler - read
LDebugging Signal Handlers
($SIG{FOO})|guide::debug/Debugging_Signal_Handlers___SIG_FOO__ for a debug
@@ -3036,7 +3036,7 @@
resolve it and notify the administrator using a simple crontab
watchdog that requests some very light script periodically. (See
LMonitoring the Server. A
-watchdog.|guide::control/Monitoring_the_Server___A_watchdog_)
+watchdog.|general::control/Monitoring_the_Server___A_watchdog_)
In the watchdog you set a timeout appropriate for your service, which
cvs commit: modperl-docs/src/docs/1.0/guide style.css
stas02/05/11 04:56:22 Removed: src/docs/1.0/guide style.css Log: no need for the old style.css here - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/start index_top.html
stas02/05/11 05:14:21 Modified:src/start index_top.html Log: add a link to asf Revision ChangesPath 1.3 +7 -5 modperl-docs/src/start/index_top.html Index: index_top.html === RCS file: /home/cvs/modperl-docs/src/start/index_top.html,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- index_top.html26 Apr 2002 22:41:09 - 1.2 +++ index_top.html11 May 2002 12:14:21 - 1.3 @@ -142,17 +142,19 @@ /blockquote -/blockquote -brbr -Now, it's time to a href=../docs/1.0/guide/getwet.htmlGet Your Feet Wet/a with bmod_perl/b. +/blockquote + +brbr Now, it's time to a href=../docs/1.0/guide/getwet.htmlGet +Your Feet Wet/a with bmod_perl/b. h1License/h1 -pLike all Apache Software Foundation projects, mod_perl is licensed -under a href=LICENSE.txtThe Apache License/a./p +pLike all a href=http://www.apache.org;Apache Software +Foundation/a projects, mod_perl is licensed under a +href=LICENSE.txtThe Apache License/a./p /body - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/tutorials/templates - New directory
stas02/05/10 00:37:04 modperl-docs/src/docs/tutorials/templates - New directory - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide method_handlers.pod Changes.pod config.cfg getwet.pod help.pod advocacy.pod browserbugs.pod control.pod correct_headers.pod download.pod hardware.pod multiuser.pod perl.pod start.pod
stas02/05/10 00:47:40 Modified:src/docs/1.0/guide Changes.pod config.cfg getwet.pod help.pod Added: src/docs/1.0/guide method_handlers.pod Removed: src/docs/1.0/guide advocacy.pod browserbugs.pod control.pod correct_headers.pod download.pod hardware.pod multiuser.pod perl.pod start.pod Log: mod_perl version independent docs have moved to general:: Revision ChangesPath 1.19 +4 -0 modperl-docs/src/docs/1.0/guide/Changes.pod Index: Changes.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/Changes.pod,v retrieving revision 1.18 retrieving revision 1.19 diff -u -r1.18 -r1.19 --- Changes.pod 9 May 2002 10:37:36 - 1.18 +++ Changes.pod 10 May 2002 07:47:40 - 1.19 @@ -11,6 +11,10 @@ =head1 ??? ver 1.32 +* guide::method_handlers + + o moved here from the faqs + * guide::databases o correct the notes regarding Opening Connections With Different 1.5 +3 -15 modperl-docs/src/docs/1.0/guide/config.cfg Index: config.cfg === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/config.cfg,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- config.cfg20 Apr 2002 06:36:02 - 1.4 +++ config.cfg10 May 2002 07:47:40 - 1.5 @@ -2,7 +2,7 @@ @c = ( id = 'guide', -title = mod_perl guide, +title = mod_perl 1.x User Guide, abstract = EOB, Deploying mod_perl technology to give rocket speed to your CGI/Perl scripts. @@ -12,30 +12,21 @@ chapters = [qw( getwet.pod intro.pod -start.pod install.pod config.pod )], group= 'Coding', chapters = [qw( -perl.pod porting.pod -correct_headers.pod +method_handlers.pod databases.pod dbm.pod +security.pod snippets.pod modules.pod )], -group= 'Maintenance', -chapters = [qw( -control.pod -multiuser.pod -hardware.pod -security.pod -)], - group= 'Advanced Setup and Performance', chapters = [qw( strategy.pod @@ -48,14 +39,11 @@ frequent.pod troubleshooting.pod debug.pod -browserbugs.pod help.pod )], group= 'Miscellaneous', chapters = [qw( -advocacy.pod -download.pod Changes.pod )], 1.4 +26 -26modperl-docs/src/docs/1.0/guide/getwet.pod Index: getwet.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/getwet.pod,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- getwet.pod26 Apr 2002 18:08:48 - 1.3 +++ getwet.pod10 May 2002 07:47:40 - 1.4 @@ -50,9 +50,9 @@ distributions will have installed Perl by default. To check that the tools are available and learn about their version numbers, try: - panic% make -v - panic% gcc -v - panic% perl -v + % make -v + % gcc -v + % perl -v If any of these responds with CCommand not found, it will need to be installed. @@ -76,14 +76,14 @@ I/home/stas/src/, proceed with the described steps and you will have mod_perl installed: - panic% cd /home/stas/src - panic% tar -zvxf apache_x.x.x.tar.gz - panic% tar -zvxf mod_perl-x.xx.tar.gz - panic% cd mod_perl-x.xx - panic% perl Makefile.PL APACHE_SRC=../apache_x.x.x/src \ + % cd /home/stas/src + % tar -zvxf apache_x.x.x.tar.gz + % tar -zvxf mod_perl-x.xx.tar.gz + % cd mod_perl-x.xx + % perl Makefile.PL APACHE_SRC=../apache_x.x.x/src \ APACHE_PREFIX=/home/httpd DO_HTTPD=1 USE_APACI=1 EVERYTHING=1 - panic% make make test - panic% su + % make make test + % su panic# make install That's all! @@ -134,19 +134,19 @@ The next step is to move to the directory with the source files: - panic% cd /home/stas/src + % cd /home/stas/src Uncompress and untar both sources. GNU Itar allows this using a single command per file: - panic% tar -zvxf apache_x.x.x.tar.gz - panic% tar -zvxf mod_perl-x.xx.tar.gz + % tar -zvxf apache_x.x.x.tar.gz + % tar -zvxf mod_perl-x.xx.tar.gz For non-GNU Itar's, you may need to do this with two steps (which you can combine via a pipe): - panic% gzip -dc apache_x.x.x.tar.gz | tar -xvf - - panic% gzip -dc mod_perl-x.xx.tar.gz | tar -xvf - + % gzip -dc apache_x.x.x.tar.gz | tar -xvf - + % gzip
cvs commit: modperl-docs/src/docs/2.0/user config.cfg
stas02/05/10 00:48:23 Modified:src/docs/2.0/user config.cfg Log: a better title Submitted by: Thomas Klausner [EMAIL PROTECTED] Revision ChangesPath 1.6 +1 -1 modperl-docs/src/docs/2.0/user/config.cfg Index: config.cfg === RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/config.cfg,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- config.cfg20 Mar 2002 17:44:04 - 1.5 +++ config.cfg10 May 2002 07:48:23 - 1.6 @@ -27,7 +27,7 @@ coding/coding.pod )], -group= 'Help', +group= 'Troubleshooting', chapters = [ qw( help/help.pod )], - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/tmpl/custom/html short_cuts
stas02/05/10 01:04:03 Modified:tmpl/custom/html short_cuts Log: s/hot short/short/ Revision ChangesPath 1.2 +1 -1 modperl-docs/tmpl/custom/html/short_cuts Index: short_cuts === RCS file: /home/cvs/modperl-docs/tmpl/custom/html/short_cuts,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- short_cuts13 Apr 2002 18:25:48 - 1.1 +++ short_cuts10 May 2002 08:04:02 - 1.2 @@ -10,7 +10,7 @@ ]; -%] [%- WRAPPER wrap_box -title = 'Hot Short Cuts' +title = 'Short Cuts' -%] [%- FOREACH but = buttons -%] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs TODO
stas02/05/09 03:21:43
Modified:.TODO
Log:
update
Revision ChangesPath
1.44 +9 -0 modperl-docs/TODO
Index: TODO
===
RCS file: /home/cvs/modperl-docs/TODO,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- TODO 29 Apr 2002 17:39:51 - 1.43
+++ TODO 9 May 2002 10:21:43 - 1.44
@@ -18,6 +18,15 @@
DocSet:
---
+- the sitemap doesn't show up as selected in the menu when you go there.
+
+- # if the pre section is too long ps2pdf fails to generate pdf,
+# so split it into 40 lines chunks.
+$result = '';
+while ($text =~ /((?:[^\n]*\n){1,40})/sg) {
+ $result .= PRE$1/PRE\n;
+}
+
- how do we make Lfoo|../search/swish.cgi I cannot do search::swish,
it's not a doc.
STATUS: need to extend pod parser with Utitle (url|relative url)
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide Changes.pod databases.pod
stas02/05/09 03:34:43
Modified:src/docs/1.0/guide Changes.pod databases.pod
Log:
o correct the notes regarding Opening Connections With Different
Parameters for Apache::DBI. Must localize local changes.
Revision ChangesPath
1.17 +5 -0 modperl-docs/src/docs/1.0/guide/Changes.pod
Index: Changes.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/Changes.pod,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- Changes.pod 5 May 2002 18:22:33 - 1.16
+++ Changes.pod 9 May 2002 10:34:43 - 1.17
@@ -11,6 +11,11 @@
=head1 ??? ver 1.32
+* guide::databases
+
+ o correct the notes regarding Opening Connections With Different
+ Parameters for Apache::DBI. Must localize local changes.
+
* guide::getwet
o a new chapter to get you started fast
1.9 +99 -7 modperl-docs/src/docs/1.0/guide/databases.pod
Index: databases.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/databases.pod,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- databases.pod 28 Apr 2002 09:20:29 - 1.8
+++ databases.pod 9 May 2002 10:34:43 - 1.9
@@ -199,18 +199,110 @@
172800 seconds is equal to 48 hours. This change solves the problem,
but the ping() method works properly in CDBD::mysql as well.
-=head3 Opening connections with different parameters
+=head3 Opening Connections With Different Parameters
-When it receives a connection request, before it decides to use an
-existing cached connection, CApache::DBI insists that the new
+When CApache::DBI receives a connection request, before it decides
+to use an existing cached connection it insists that the new
connection be opened in exactly the same way as the cached
-connection. If I have one script that sets CLongReadLen and one that
-does not, CApache::DBI will make two different connections. So instead
-of having a maximum of 40 open connections, I can end up with 80.
+connection. If you have one script that sets CAutoCommit and one
+that does not, CApache::DBI will make two different connections. So
+if for example you have limited Apache to 40 servers at most, instead
+of having a maximum of 40 open connections you may end up with 80.
+
+So these two connect() calls will create two different connections:
+
+ my $dbh = DBI-connect
+ (DBI:mysql:test:localhost, '', '',
+ {
+PrintError = 1, # warn() on errors
+RaiseError = 0, # don't die on error
+AutoCommit = 1, # commit executes immediately
+ }
+ ) or die Cannot connect to database: $DBI::errstr;
+
+ my $dbh = DBI-connect
+ (DBI:mysql:test:localhost, '', '',
+ {
+PrintError = 1, # warn() on errors
+RaiseError = 0, # don't die on error
+AutoCommit = 0, # don't commit executes immediately
+ }
+ ) or die Cannot connect to database: $DBI::errstr;
+
+Notice that the only difference is in the value of CAutoCommit.
However, you are free to modify the handle immediately after you get
it from the cache. So always initiate connections using the same
-parameters and set CLongReadLen (or whatever) afterwards.
+parameters and set CAutoCommit (or whatever) afterwards. Let's
+rewrite the second connect call to do the right thing (not to create
+a new connection):
+
+ my $dbh = DBI-connect
+ (DBI:mysql:test:localhost, '', '',
+ {
+PrintError = 1, # warn() on errors
+RaiseError = 0, # don't die on error
+AutoCommit = 1, # commit executes immediately
+ }
+ ) or die Cannot connect to database: $DBI::errstr;
+ $dbh-{AutoCommit} = 0; # don't commit if not asked to
+
+When you aren't sure whether you're doing the right thing, turn debug
+mode on.
+
+However, when the C$dbh attribute is altered after connect() it
+affects all other handlers retrieving this database handle. Therefore
+it's best to restore the modified attributes to their original value
+at the end of database handle usage. As of CApache::DBI version 0.88
+the caller has to do it manually. The simplest way to handle this is
+to localize the attributes when modifying them:
+
+ my $dbh = DBI-connect(...) ...
+ {
+local $dbh-{LongReadLen} = 40;
+ }
+
+Here the CLongReadLen attribute overrides the value set in the
+connect() call or its default value only within the enclosing block.
+
+The problem with this approach is that prior to Perl version 5.8.0
+this causes memory leaks. So the only clean alternative for older Perl
+versions is to manually restore the Cdbh's values:
+
+ my @attrs = qw
cvs commit: modperl-docs/src/docs/2.0/world/templates choosing.pod
stas02/05/07 09:01:59 Modified:src/docs/2.0/world/templates choosing.pod Log: minor html corrections Submitted by: allan Revision ChangesPath 1.8 +6 -7 modperl-docs/src/docs/2.0/world/templates/choosing.pod Index: choosing.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/world/templates/choosing.pod,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- choosing.pod 18 Apr 2002 18:11:28 - 1.7 +++ choosing.pod 7 May 2002 16:01:59 - 1.8 @@ -921,20 +921,19 @@ =for html TABLE BORDER=1 TR - TH - /TD + THbr/TH TH Application Framework - /TD + /TH TH Pipeline or Callback - /TD + /TH TH Parsing Method - /TD + /TH TH Language - /TD + /TH /TR TR TD @@ -1041,7 +1040,7 @@ TR TD HTML::Template - /TH + /TD TD Just Templates /TD - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide config.pod Changes.pod
stas02/05/05 11:22:34 Modified:src/docs/1.0/guide config.pod Changes.pod Log: * guide::config o show an example on how to load the mod_perl related config only when mod_perl is loaded (Rafael Garcia-Suarez) Revision ChangesPath 1.7 +8 -0 modperl-docs/src/docs/1.0/guide/config.pod Index: config.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/config.pod,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- config.pod3 Apr 2002 09:16:08 - 1.6 +++ config.pod5 May 2002 18:22:33 - 1.7 @@ -402,6 +402,14 @@ Include conf/mod_perl.conf +If you want to include this configuration conditionally, depending on +whether your apache has been compiled with mod_perl, you can use the +CIfModule directive: + + IfModule mod_perl.c + Include conf/mod_perl.conf + /IfModule + mod_perl adds two further directives: CEltPerlEgt sections allow you to execute Perl code from within any configuration file at server startup time, and as you will see later, a file containing any Perl 1.16 +3 -0 modperl-docs/src/docs/1.0/guide/Changes.pod Index: Changes.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/Changes.pod,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- Changes.pod 27 Apr 2002 18:32:39 - 1.15 +++ Changes.pod 5 May 2002 18:22:33 - 1.16 @@ -49,6 +49,9 @@ o extended on method handlers (Per Einar Ellefsen) + o show an example on how to load the mod_perl related config only +when mod_perl is loaded (Rafael Garcia-Suarez) + * guide::debug o extended on curinfo macro (Per Einar Ellefsen) - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/products products.html
stas02/05/01 09:10:45 Modified:src/products products.html Log: new products to drool the marketing department! Submitted by: Per Einar Ellefsen [EMAIL PROTECTED] Revision ChangesPath 1.8 +28 -2 modperl-docs/src/products/products.html Index: products.html === RCS file: /home/cvs/modperl-docs/src/products/products.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- products.html 28 Apr 2002 14:46:42 - 1.7 +++ products.html 1 May 2002 16:10:45 - 1.8 @@ -2,8 +2,8 @@ head titlemod_perl Related Software/title meta name=Description content=A short list of some software, open -source and commercial, based on mod_perl or compatible with mod_perl, -which might be interesting for anyone using mod_perl +source and commercial, based on or compatible with mod_perl, which +might be interesting for anyone using mod_perl /head body bgcolor=#ff @@ -69,6 +69,20 @@ weblogs. The Movable Type system runs on your own webserver, giving you complete control over your site. /li +li a href=http://www.metadot.com/;Metadot/a provides secure, +web-based collaboration and content management software that allows +non-technical users to build and manage intranets, extranets, and +project spaces. /li + +li a href=http://www.plainblack.com/index.pl/webgui;WebGUI/a +(pronounced web-gooey) is one of the most popular open source content +management systems (CMS) available today. It is a platform built to +allow average business users to build and maintain complex web +sites. It is modular, pluggable, and platform independent. It was +designed to allow the people who create the content, to manage it +online, rather than content management taking up the time of the busy +IT Staff. /li + /ul h4Forum Software/h4 @@ -123,6 +137,14 @@ is a calendar of events program for the web and PDAs written entirely in Perl. /li +li a href=http://www.ma.utexas.edu/webcalendar/;WebCalendar/a +is a powerful group calendaring and scheduling system. It is a web +based application that makes it easy to publish and manage calendar +events on the internet. WebCalendar includes an impressive set of +business class features. Its easy to use interface, rich +functionality, and sophisticated scheduling system makes it one of the +best calendar applications on the internet. /li + li a href=http://www.ringlink.org/;Ringlink/a is a Perl program that provides the tools you need to run one or more rings of web sites, i.e. systems of links between web sites of a similar topic, @@ -148,6 +170,10 @@ Namp! lets you create a virtual jukebox of your MP3, WAV and Ogg Vorbis music files, browse them over the web, create playlists, and stream them. /li + +li a href=http://users.ox.ac.uk/~mbeattie/wing/;WING/a is an +Open Source Apache/mod_perl based system which allows users to access +email held on an IMAP server via any web browser. /li /ul - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src style.css
stas02/04/29 21:39:14
Modified:src style.css
Log:
revert the change we didn't decide upon
Revision ChangesPath
1.68 +3 -1 modperl-docs/src/style.css
Index: style.css
===
RCS file: /home/cvs/modperl-docs/src/style.css,v
retrieving revision 1.67
retrieving revision 1.68
diff -u -r1.67 -r1.68
--- style.css 30 Apr 2002 04:38:14 - 1.67
+++ style.css 30 Apr 2002 04:39:14 - 1.68
@@ -65,7 +65,9 @@
a.pdfsrc {
font-family: verdana, arial, helvetica, sans-serif;
-font-size: 0.8em;
+font-size: 0.9em;
+font-weight: bold;
+color: #525d76;
}
a.pdfsrc:link,
a.pdfsrc:visited,
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src style.css
stas02/04/29 21:43:57
Modified:src style.css
Log:
shutting at least one warning
Revision ChangesPath
1.69 +1 -0 modperl-docs/src/style.css
Index: style.css
===
RCS file: /home/cvs/modperl-docs/src/style.css,v
retrieving revision 1.68
retrieving revision 1.69
diff -u -r1.68 -r1.69
--- style.css 30 Apr 2002 04:39:14 - 1.68
+++ style.css 30 Apr 2002 04:43:56 - 1.69
@@ -4,6 +4,7 @@
font-family: helvetica, arial, verdana, sans-serif;
font-size: 1.0em;
color: #00;
+background-color: #ff;
}
p {
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/tmpl/custom/html sitemap
stas02/04/29 22:42:56 Modified:tmpl/custom/html sitemap Log: fix the template so the breadcrumb will work Revision ChangesPath 1.5 +1 -0 modperl-docs/tmpl/custom/html/sitemap Index: sitemap === RCS file: /home/cvs/modperl-docs/tmpl/custom/html/sitemap,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- sitemap 29 Apr 2002 17:37:49 - 1.4 +++ sitemap 30 Apr 2002 05:42:56 - 1.5 @@ -14,6 +14,7 @@ [%- INCLUDE logo -%] [%- INCLUDE navbar_global nav=doc.nav +rel_doc_root=doc.dir.rel_doc_root; -%] !-- camel begin -- - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/2.0/user/compat compat.pod
stas02/04/30 11:46:38 Modified:src/docs/2.0/user/compat compat.pod Log: $r-user should be used instead of $r-connection-user Submitted by: Doug MacEachern [EMAIL PROTECTED] Revision ChangesPath 1.12 +5 -0 modperl-docs/src/docs/2.0/user/compat/compat.pod Index: compat.pod === RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/compat/compat.pod,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- compat.pod14 Apr 2002 07:11:48 - 1.11 +++ compat.pod30 Apr 2002 18:46:38 - 1.12 @@ -108,8 +108,13 @@ characters long. See the CAPR::String manpage for more information. +=head1 $r-Egtconnection-Egt... +=head2 $r-Egtconnection-Egtuser +This method is deprecated in 1.x and $r-Egtuser should be used +instead for both versions of mod_perl. CApache::user method is +available since mod_perl version 1.24_01. =head1 Miscellaneous - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src style.css
stas02/04/28 18:39:35 Modified:src style.css Log: fix properties sizes to use px Revision ChangesPath 1.64 +7 -7 modperl-docs/src/style.css Index: style.css === RCS file: /home/cvs/modperl-docs/src/style.css,v retrieving revision 1.63 retrieving revision 1.64 diff -u -r1.63 -r1.64 --- style.css 28 Apr 2002 05:57:51 - 1.63 +++ style.css 29 Apr 2002 01:39:35 - 1.64 @@ -419,12 +419,12 @@ font-style: normal; font-weight: bold; text-align: justify; -padding-top: 10; -padding-right: 40; -padding-bottom: 10; -padding-left: 40; -margin-right: 20; -margin-left: 20; +padding-top: 10px; +padding-right: 40px; +padding-bottom: 10px; +padding-left: 40px; +margin-right: 20px; +margin-left: 20px; border-width: 0; border-style: solid; } @@ -434,6 +434,6 @@ font-family: helvetica, arial, verdana, sans-serif; font-weight: normal; font-size: 0.9em; -margin-top: 10; +margin-top: 10px; float: right; } - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/download docs.pod
stas02/04/29 09:27:53 Modified:src/contribute docs.pod maillist.pod share_code.pod src/download docs.pod Log: - changed the prompts in docs.pod to ai%, as stated in style.pod. - add missing descriptions Submitted by: Per Einar Ellefsen [EMAIL PROTECTED] Revision ChangesPath 1.4 +14 -3 modperl-docs/src/contribute/docs.pod Index: docs.pod === RCS file: /home/cvs/modperl-docs/src/contribute/docs.pod,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- docs.pod 27 Apr 2002 03:19:40 - 1.3 +++ docs.pod 29 Apr 2002 16:27:53 - 1.4 @@ -2,6 +2,11 @@ Contribute to the Documentation +=head1 Description + +Once you have read the documentation provided for mod_perl, you will +probably have some additions of your own, which are always welcome. + =head1 Submit Corrections There is a lot of mod_perl documentation. And we are sure it includes @@ -9,7 +14,7 @@ The documentation includes code examples, which sometimes were written without testing, so it's possible that they are broken. If some -example doesn't work for you, please, let us know. +example doesn't work for you, please let us know. If you notice bad grammar of English and speling, don't hesitate to tell us where and what you think is the best way to korrectink @@ -40,7 +45,13 @@ talking about. If the correction is medium to large use the cvs repository and submit -the patch against the latest version. LThis document|download::docs -explains how to use the cvs repository. +the patch against the latest version, or even better, just send us the +modified document. LThis document|download::docs explains how to use +the cvs repository. + +Note that if you for some reason cannot use the CVS repository, each +page contains a Isrc link in the upper-right corner. From there you +can access the POD/HTML source of documents, which you can then modify +and send to us. =cut 1.3 +5 -0 modperl-docs/src/contribute/maillist.pod Index: maillist.pod === RCS file: /home/cvs/modperl-docs/src/contribute/maillist.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- maillist.pod 26 Apr 2002 15:32:23 - 1.2 +++ maillist.pod 29 Apr 2002 16:27:53 - 1.3 @@ -2,6 +2,11 @@ Contribute at the Mailing List +=head1 Description + +The first way to contribute to the mod_perl community is by following +the mailing list and helping out anyone else having problems. + =head1 Answering Questions Since mod_perl is an open source technology, its main support facility 1.3 +5 -0 modperl-docs/src/contribute/share_code.pod Index: share_code.pod === RCS file: /home/cvs/modperl-docs/src/contribute/share_code.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- share_code.pod26 Apr 2002 15:32:23 - 1.2 +++ share_code.pod29 Apr 2002 16:27:53 - 1.3 @@ -2,6 +2,11 @@ Contribute by Sharing Code +=head1 Description + +Your Perl and mod_perl know-how is more than welcome as contributions +to Apache modules or to mod_perl itself. + =head1 mod_perl Patches If you have modified the mod_perl source code, improved and extended 1.4 +39 -10modperl-docs/src/download/docs.pod Index: docs.pod === RCS file: /home/cvs/modperl-docs/src/download/docs.pod,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- docs.pod 27 Apr 2002 18:45:56 - 1.3 +++ docs.pod 29 Apr 2002 16:27:53 - 1.4 @@ -5,7 +5,7 @@ =head1 Description You may want to download and install the mod_perl documentation -locally for easier reading. +locally for easier reading, or to submit documentation patches. To install the documentation you will have to install the whole site at the same time though, but this should just be a benefit because you @@ -19,9 +19,9 @@ CVS installed, run the following commands from the directory you want to place the Imodperl-docs directory in: - % cvs -d:pserver:[EMAIL PROTECTED]:/home/cvspublic login + ai% cvs -d:pserver:[EMAIL PROTECTED]:/home/cvspublic login (use the password anoncvs) - % cvs -d:pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl-docs + ai% cvs -d:pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl-docs You will now find a directory called Imodperl-docs in the current working directory which contains all the sources needed to build the @@ -63,17 +63,20
cvs commit: modperl-docs/src/docs/general - New directory
stas02/04/29 09:47:04 modperl-docs/src/docs/general - New directory - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/general config.cfg cvs_howto.pod Changes.pod
stas02/04/29 09:48:06 Added: src/docs/general config.cfg cvs_howto.pod Changes.pod Log: - added General Documentation to src/docs - added CVS HowTo Submitted by: Thomas Klausner [EMAIL PROTECTED] Revision ChangesPath 1.1 modperl-docs/src/docs/general/config.cfg Index: config.cfg === use vars qw(@c); @c = ( id = 'general', title = General Documentation, abstract = EOB, Here you can find documentation not directly concerned with mod_perl, but still usefull for most mod_perl projects. EOB chapters = [qw( cvs_howto.pod Changes.pod )], ); 1.1 modperl-docs/src/docs/general/cvs_howto.pod Index: cvs_howto.pod === =head1 NAME CVS HowTo =head1 Description A short description how to use CVS to access the mod_perl and related projects source distributions. Just as cvs access to the Apache development tree, the mod_perl code pulled from cvs is not guaranteed to do anything, especially not compile or work. But, that's exactly why we are using cvs, so everyone has access the latest version and can help see to it that mod_perl does compile and work on all platforms, with the various versions and configurations of Perl and Apache. Patches are always welcome, simply testing the latest snapshots is just as, if not more helpful. It's recommended to subscribe to the Lmodperl-cvs|maillist::list-cvs list, which is the place cvs commit logs and diffs are mailed to; at least if you're going to work on the code. =head1 anoncvs You can get cvs here: http://www.cvshome.org/ =head2 checkout To checkout a fresh copy run the following commands from the directory you want the sources to stay in: % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login (use the password anoncvs) % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl After cvs finished downloading the files you will find a new directory calles Imodperl in the current working directory. =head2 keeping your copy up to date To keep your local copy in sync with the repository, do % cvs -dP update in the top directory of the project. You should run update evertime before you start working on the project. =head2 sending patches To send a patch, first run: % cvs diff -u in the top directory of the project. The output of diff will be sent to STDOUT, so it might be better to redirect the output to a file: % cvs diff -u patch If you added files or directories to the project, do a diff against I/dev/null: % diff -u /dev/null newdir/newfilename When this patch is applied, the new dir and the new file will be automatically created. On Windows-based systems, you can do % diff -u NUL newdir/newfilename instead. Then send your patch to the maintainer of the project. =head2 usefull default parameters Here are some recommended parameters. Save them in I~/.cvsrc, so you don't have to type them everytime you use cvs. cvs -z9 update -dP diff -u Icvs -z9 sets the compression level to 9 (the highest value) to speed up downloading. Iupdate -d automatically creates directories that are missing in your local copy because they where added to the repository after your initial checkout or your last update. Iupdate -P automatically deletes empty directories. Idiff -U to use the unified output format so that your changes can be easily merged back into the repository. =head1 cvsup Cvsup has come out of the FreeBSD group. It's a client/server beast that offers an efficient way to sync collections of files over the net, and it is very CVS aware, allowing synchronisation of repositories or checked out files using the cvs deltas to bring the client side files up to date with minimal data transfer. For a FreeBSD cvsup client see: http://www.freebsd.org/cgi/ports.cgi?query=cvsupstype=all Others (SunOS, alpha.osf, linux, Solaris2.4, HPAA 10.2, irix) ftp://ftp.postgresql.org/pub/CVSup/ Here's a config file for the client (cvsup) to sync modperl sources. *default tag=. # comment out the above if you want the raw cvs files *default host=cvs.apache.org *default prefix=/path/on/this/machine/to/install/ # a subdir for modperl will appear here ^^^ *default base=/path/on/this/machine/where/cvsup/will/keep/status/info # you'll never need to look in the 'base' dir. *default release=cvs delete use-rel-suffix compress modperl #apache-src #apache-docs #uncomment these two for the latest apache src and/or docs if you want them =head1 mod_perl and related projects
cvs commit: modperl-docs/src/download source.pod
stas02/04/29 09:48:27 Modified:src/docs config.cfg src/download source.pod Log: - download::source: added info on how to get 2.x, links to cvs_howto Submitted by: Thomas Klausner [EMAIL PROTECTED] Revision ChangesPath 1.6 +9 -1 modperl-docs/src/docs/config.cfg Index: config.cfg === RCS file: /home/cvs/modperl-docs/src/docs/config.cfg,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- config.cfg21 Apr 2002 07:29:25 - 1.5 +++ config.cfg29 Apr 2002 16:48:27 - 1.6 @@ -10,7 +10,7 @@ mod_perl 1.x and 2.x. If there is anything you need to learn about mod_perl, you'll learn it here. EOB - + group = 'mod_perl 1.x Documentation', docsets = [qw( @@ -35,4 +35,12 @@ offsite )], +group = 'General Documentation', + +docsets = [qw( +general +)], + ); + + 1.4 +47 -27modperl-docs/src/download/source.pod Index: source.pod === RCS file: /home/cvs/modperl-docs/src/download/source.pod,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- source.pod18 Apr 2002 15:49:05 - 1.3 +++ source.pod29 Apr 2002 16:48:27 - 1.4 @@ -4,65 +4,85 @@ =head1 Description -This document explains how to get the mod_perl stable and development -source distributions. +This document explains how to get the mod_perl 1.x and 2.x source +distributions. + +Please note that mod_perl 2.x is considered BETA and should not be +used in a production environment. See also Lthe binary distributions|download::binaries and the Lbundles|download::bundles. -=head1 How to build the source distribution +=head1 mod_perl 1.x Be sure to read the IREADME and IINSTALL documents (in the distribution package) and the longer Lthe installation -guide|guide::install. +guide|docs::1.0::guide::install. -=head1 How to get the stable source distribution +=head2 Stable source distribution =over -=item * +=item * Master Source distribution -Master Source distribution: Release http://perl.apache.org/dist +Release http://perl.apache.org/dist -=item * +=item * CPAN -CPAN: http://www.cpan.org/modules/by-module/Apache/ +http://www.cpan.org/modules/by-module/Apache/ -=item * +=back -SRPMs: +=head2 Development source distribution -by David Harris: http://www.davideous.com/modperlrpm/distrib/ +=over -by Vladimir Ivaschenko: http://www.hazard.maks.net/apache/ +=item * The latest CVS snapshot +http://cvs.apache.org/snapshots/modperl/ -=back +=item * Access to the CVS repository -=head1 How to get the development source distribution +Using anoncvs (password is anoncvs): -=over + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl + +For more information on using CVS see Lthe CVS HowTo|docs::general::cvs_howto + +=back -=item * +=head1 mod_perl 2.x -The latest CVS snapshot: http://cvs.apache.org/snapshots/modperl/ +Be sure to read the IREADME and IINSTALL documents (in the +distribution package) and the longer mod_perl 2.x Linstallation +guide|docs::2.0::user::install::install. -For more information about using the cvs distribution refer to the -Lmod_perl_cvs|faqs::mod_perl_cvs document. +=head2 Development source distribution -=item * +=over -Anonymous CVS: +=item * tarballs -To checkout a fresh copy from anoncvs use: +Download the httpd-2.0 (http://www.apache.org/dist/httpd/) and +modperl-2.0 tarballs, and extract them in the same directory. - % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login +=item * cvs -with the password Ianoncvs. +Using anoncvs (password is anoncvs): - % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl-2.0 + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co httpd-2.0 + % cd httpd-2.0/srclib + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co apr + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co apr-util -=back +For more information on using CVS see Lthe CVS HowTo|docs::general::cvs_howto +=back =cut + + + - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/lib/DocSet/DocSet HTML.pm
stas02/04/29 10:36:55
Modified:lib/DocSet Cache.pm Config.pm DocSet.pm NavigateCache.pm
lib/DocSet/Doc POD2HTML.pm
lib/DocSet/DocSet HTML.pm
Log:
sync with DocSet
- implemented a special docset type: sitemap which automatically
generates a sitemap from the root of the docset the sitemap is
located in and all the way down including all sub-docsets.
- implemented the down() method in the NavigateCache class. Now it's
possible to traverse the whole set of docsets in both directions
starting from any node in any docset.
Revision ChangesPath
1.5 +11 -1 modperl-docs/lib/DocSet/Cache.pm
Index: Cache.pm
===
RCS file: /home/cvs/modperl-docs/lib/DocSet/Cache.pm,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- Cache.pm 21 Apr 2002 15:36:53 - 1.4
+++ Cache.pm 29 Apr 2002 17:36:54 - 1.5
@@ -8,7 +8,7 @@
use Storable;
use Carp;
-my %attrs = map {$_ = 1} qw(toc meta order);
+my %attrs = map {$_ = 1} qw(toc meta order child_cache_path);
sub new {
my($class, $path, $update) = @_;
@@ -230,6 +230,16 @@
$self-{cache}{_parent}{rel_path})
: (undef, undef, undef);
}
+}
+
+# get the child node's cache if any
+sub child_cache_path {
+my($self, $id) = @_;
+croak must specify a id unless defined $id;
+
+return exists $self-{cache}{$id}{child_cache_path}
+? $self-{cache}{$id}{child_cache_path}
+: undef;
}
1.8 +60 -14modperl-docs/lib/DocSet/Config.pm
Index: Config.pm
===
RCS file: /home/cvs/modperl-docs/lib/DocSet/Config.pm,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- Config.pm 21 Apr 2002 15:36:53 - 1.7
+++ Config.pm 29 Apr 2002 17:36:54 - 1.8
@@ -54,7 +54,7 @@
}
-my %attr = map {$_ = 1} qw(chapters docsets links);
+my %attr = map {$_ = 1} qw(chapters docsets links sitemap);
sub read_config {
my($self, $config_file) = @_;
die Configuration file is not specified unless $config_file;
@@ -364,21 +364,26 @@
}
-sub docsets {
-my $self = shift;
-return exists $self-{docsets} ? @{ $self-{docsets} } : ();
-}
+#sub docsets {
+#my $self = shift;
+#return exists $self-{docsets} ? @{ $self-{docsets} } : ();
+#}
-sub links {
-my $self = shift;
-return exists $self-{links} ? @{ $self-{links} } : ();
-}
+#sub links {
+#my $self = shift;
+#return exists $self-{links} ? @{ $self-{links} } : ();
+#}
-sub src_chapters {
+sub sitemap {
my $self = shift;
-return exists $self-{chapters} ? @{ $self-{chapters} } : ();
+return exists $self-{sitemap} ? $self-{sitemap} : ();
}
+#sub src_chapters {
+#my $self = shift;
+#return exists $self-{chapters} ? @{ $self-{chapters} } : ();
+#}
+
# chapter paths as they go into production
# $self-trg_chapters(@paths) : push a chapter(s)
# $self-trg_chapters : retrieve the list
@@ -460,11 +465,13 @@
$self-get_file($key);
$self-get_dir($dir_name);
- my @docsets = $self-docsets();
- my @links = $self-links();
- my @chapters = $self-src_chapters();
+#XXX my @docsets = $self-docsets();
+#XXX my @links = $self-links();
+#XXX my @chapters = $self-src_chapters();
my @chapters = $self-trg_chapters();
+ my $sitemap = $self-sitemap();
+
$self-cache($cache);
my $cache = $self-cache();
@@ -665,22 +672,54 @@
linked to after it gets copied via Icopy_glob attribute in the same
or another docset.
+=item * sitemap
+
+Sitemap is a special kind of chapter rendered by calling the
+Csitemap template, which usually traverses the caches and builds a
+nested tree of all documents in the docset and below it. Note that if
+using this attribute in the inner docsets, it'll work the same as
+using it in the outmost docset, but the tree will show only the from
+the inner docset and below it. DWIM.
+
+The specification is exactly like the Ilinks attribute, but there
+can be only one sitemap entry per config file, therefore its value is
+a reference to a hash with the same keys as the Ilinks nodes. In the
+example below you can see how it get specified. The only thing to
+think about is the link entry:
+
+ link = 'sitemap.html',
+
+which says where the file will be generated relative to the directory
+Iconfig.cfg resides in. So normally you will just use the same entry
+as the one in the example that follows.
+
+As we mentioned, the autogenerated sitemap will be automatically
+linked together with chapters, docsets and links, depending
cvs commit: modperl-docs/tmpl/custom/html sitemap_body sitemap
stas02/04/29 10:37:49
Modified:tmpl/custom/html sitemap
Added: tmpl/custom/html sitemap_body
Log:
add the sitemap generator templates
Revision ChangesPath
1.4 +43 -55modperl-docs/tmpl/custom/html/sitemap
Index: sitemap
===
RCS file: /home/cvs/modperl-docs/tmpl/custom/html/sitemap,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- sitemap 22 Feb 2002 11:06:01 - 1.3
+++ sitemap 29 Apr 2002 17:37:49 - 1.4
@@ -1,62 +1,50 @@
-[% # site map
- # expects to be set:
- # nav - cache navigator object
- # rel_doc_root - relative docs path (only for chapters!)
+[%- INCLUDE head
+paget = doc.meta.title
+title = mod_perl: $paget
+content = ''
-%]
-[%
- # first go up to the absolute root
- l = nav; # remember last valid node
- p = nav.up;
- WHILE p;
- l = p;
- p = p.up;
- END;
-
- p = l; # last valid node
-
- # now go to the left
- p = p.first;
-
- # now recursively render all levels
+!-- Swishcommand noindex --
+!-- logobox begin --
+div class=logobox
+table border=0 cellspacing=0 cellpadding=0 width=100%
+tr valign=top
+
+[%- INCLUDE logo -%]
+[%- INCLUDE navbar_global
+nav=doc.nav
+-%]
+
+!-- camel begin --
+td align=rightimg src=[%- doc.dir.abs_doc_root
-%]/images/logo/logo_blend_camel.gif border=0 alt=mod_perl icon width=40
height=49/td
+!-- camel end --
+/tr
+/table
+/div
+!-- logobox end --
+!-- left box begin --
+div class=leftbox
+
+[%- INCLUDE left_box
+nav=doc.nav
+-%]
- IF p.parent_rel_path.defined;
- prefix = p.parent_rel_path;
- ELSE;
- prefix = .;
- END;
- IF rel_doc_root.defined;
- prefix = $prefix/$rel_doc_root;
- END;
-
- # walk through the top level nodes
- count = 0;
- selected = 0;
- current = p;
- buttons = [];
- p = p.first;
- WHILE p;
- count = count + 1;
- link = INCLUDE link prefix=prefix link=p.meta.link;
- buttons.push({link = link, text = p.meta.stitle});
- IF p.id == current.id;
- selected = count;
- END;
- p = p.next; # next node
- END;
--%]
-div class=logo
-a href=http://perl.apache.org/;img src=[% doc.dir.abs_doc_root
%]/images/mod_perl2.jpg border=0 alt=mod_perl icon height=59
width=150/abr
/div
-br
-div class=menu
-[% INCLUDE splash/pulldown
- select = selected
- width = 5%
- pad= 0
- border = 0
- align = 'left'
-%]
+!-- left box end --
+
+!-- right box begin--
+div class=rightbox
+[%- INCLUDE sitemap_body -%]
+
+br
+hr noshade size=1
+
+[%- INCLUDE tail -%]
+
/div
+!-- right box end --
+
+/body
+/html
1.1 modperl-docs/tmpl/custom/html/sitemap_body
Index: sitemap_body
===
[% # site map
# expects to be set:
# nav - cache navigator object
# rel_doc_root - relative docs path (only for chapters!)
-%]
[%-
INCLUDE navbar_local_top
nav=doc.nav.up
rel_doc_root=doc.dir.rel_doc_root;
INCLUDE title;
-%]
!-- content begin --
p[% doc.meta.abstract %]/p
[%
# p;
# INCLUDE print_item c = doc;
# /p;
# now recursively render all levels
'ul class=toc';
INCLUDE print_node c = doc.nav.first prefix = .;
/ul;
-%]
[% BLOCK print_node;
WHILE c;
li;
INCLUDE print_item;
'ul class=toc';
INCLUDE print_node c=c.down prefix=$prefix/${c.meta.rel_path};
c = c.next;
/ul;
/li;
END;
END;
%]
[%- BLOCK print_item -%]
[%- link = INCLUDE link prefix=prefix link=c.meta.link -%]
a href=[% link %][% c.meta.title %]/a
[%- END -%]
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/download binaries.pod
stas02/04/27 21:56:24 Modified:src/download binaries.pod Log: - moved all =item to =head for better readability - added link to win32-documentation - added link to modperl mailing list Submitted by: Thomas Klausner [EMAIL PROTECTED] Revision ChangesPath 1.4 +9 -11 modperl-docs/src/download/binaries.pod Index: binaries.pod === RCS file: /home/cvs/modperl-docs/src/download/binaries.pod,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- binaries.pod 25 Mar 2002 16:25:54 - 1.3 +++ binaries.pod 28 Apr 2002 04:56:23 - 1.4 @@ -7,16 +7,14 @@ This document includes links to various binary mod_perl distributions. If you know about a distribution that isn't listed here, please tell -us (by announcing it at the mod_perl list). +us (by announcing it at the Lmod_perl list|maillist::list-modperl). See also Lthe source distributions|download::source and the Lbundles|download::bundles. =head1 How to get pre-compiled mod_perl -=over - -=item * +=head2 Win32 mod_perl 1.x Win32 mod_perl Binaries (made by Randy Kobes) - ftp://theoryx5.uwinnipeg.ca/pub/other/. Grab a perl-win32-bin-x.x.exe @@ -24,7 +22,9 @@ on the particular versions of packages included. These all include Perl and some common modules, so are largish. -=item * +For more information please read the LWin32 Documentation|docs::1.0::win32::index + +=head2 Win32 mod_perl 2.x (BETA) An experimental mod_perl-2.0 win32 binary package is available at ftp://theoryx5.uwinnipeg.ca/pub/other/Apache2.tar.gz for those Win32 @@ -52,7 +52,7 @@ information at http://perl.apache.org/ on subscribing to the dev mailing list. -=item * +=head2 Win32 Active Perl Win32 ActivePerl mod_perl ppms - suitable for builds 6xx. You can install this by, within the ppm shell, setting the repository to @@ -64,24 +64,22 @@ (http://theoryx5.uwinnipeg.ca/ppmpackages/mod_perl-legacy/), as are some ppms of other Apache modules (http://theoryx5.uwinnipeg.ca/ppmpackages/). -=item * +=head2 RedHat Linux Static mod_perl and libapreq (Apache::Request) RPMs and SRPMs (made by David Harris ) http://www.davideous.com/modperlrpm/distrib/. Mirrored at http://perl.apache.org/rpm/. -=item * +=head2 RedHat Linux (including php3) i386 RPMs + SRPM (RedHat) of Apache with mod_perl and php3 built staticaly. (made by Vladimir Ivaschenko) http://www.hazard.maks.net/apache/ -=item * +=head2 other OS OS vendors may supply their own pre-compiled version of mod_perl. Refer to your OS vendor to figure out if they provide a binary version of mod_perl. - -=back =cut - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/admin changes_file.pod
stas02/04/27 22:27:20
Added: adminchanges_file.pod
Log:
This doc clears the confusion regarding the need and the maintenance
guidelines of IChanges.pod files in the project.
Revision ChangesPath
1.1 modperl-docs/admin/changes_file.pod
Index: changes_file.pod
===
=head1 NAME
mod_perl Documentation project's Changes File Specs
=head1 Description
This doc clears the confusion regarding the need and the maintenance
guidelines of IChanges.pod files in the project.
=head1 Who Has Contributed What And When
All the modifications of every single file can be viewed via Ccvs
log command. e.g., to check the history of this very file, one would
run:
% cvs log admin/changes_file.pod
Which will display all the commit logs, who has committed the change,
who has submitted the changes, etc.
=head1 The Art of Changes File
The IChanges.pod document is not the same as the history of all
changes. This document is for end user consumption, who is interested
to know what are the major changes since the last time she read the
documents. Or minor but important changes, like bug fixes.
Therefore the IChanges.pod document is only needed when some
sub-project goes through changes which will be of interest to the
reader. Don't just add IChanges.pod everywhere, until you really
think it's needed.
The format of this document should be as dense as possible, so the
reader can read through it fast and pin-point if there is something
interesting to it.
There is no need to log the date every time the change is done ('cvs
log' has all the info). Though it's nice to group the changes by
certain milestones, so let's say every few month a time stamp is added
in front of the group of the changes since the last timestamp and new
changes will go to the new group. The change entries in the
Idocs/1.0/guide/Changes.pod is a good example of that. In addition
it used to add a version number for each milestone, which is very
optional now.
=head1 The Scope of Changes.pod
Usually we have a separate IChanges.pod file for each sub-set of the
documents. If you feel that the changes for a few sub-sets nested in
the same super-set of docs can be maintained in one file, have only
one IChanges.pod. Later if this file becomes too overloaded and its
added value is getting diminished, split it into a few IChanges.pod
files placed in each sub-set. Or if you think that this will happen in
the near future do this from the beginning to avoid the slicing work
later.
=head1 Adding Credits
If you are the maintainer of the document, you don't have to credit
each change done by you, with your name, simply leave the change entry
un-credited, which automatically implies that you did that.
If someone commits something to the document maintained by someone
else simply mark it with your name e.g. [Thomas Klausner]. Those who
commit all the time, should pick some short (nick?)name that will
distinguish them from others and make their changes with it. e.g
[thomas]. The idea is to have the changes file with as little noise as
possible.
There is a special case where we want to credit people who contributed
very minor fixes, which don't deserve a separate changes entry. In
this case just have a special entry like CMinor fixes, where you
simply list the names of those who contributed because we want to give
credits to everybody. Again the Idocs/1.0/guide/Changes.pod file
perfectly demonstrates that.
=head1 Sample Changes.pod
See docs/1.0/guide/Changes.pod.
=cut
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src style.css
stas02/04/27 22:45:11
Modified:src style.css
Log:
oops
Revision ChangesPath
1.62 +1 -1 modperl-docs/src/style.css
Index: style.css
===
RCS file: /home/cvs/modperl-docs/src/style.css,v
retrieving revision 1.61
retrieving revision 1.62
diff -u -r1.61 -r1.62
--- style.css 27 Apr 2002 05:28:43 - 1.61
+++ style.css 28 Apr 2002 05:45:11 - 1.62
@@ -36,7 +36,7 @@
/*** headers ***/
-h1, h2, h3, h4, {
+h1, h2, h3, h4 {
font-family: helvetica, arial, verdana, sans-serif;
color: #00;
}
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src style.css
stas02/04/27 22:57:51
Modified:src style.css
Log:
use the default style for links
Revision ChangesPath
1.63 +0 -8 modperl-docs/src/style.css
Index: style.css
===
RCS file: /home/cvs/modperl-docs/src/style.css,v
retrieving revision 1.62
retrieving revision 1.63
diff -u -r1.62 -r1.63
--- style.css 28 Apr 2002 05:45:11 - 1.62
+++ style.css 28 Apr 2002 05:57:51 - 1.63
@@ -51,14 +51,6 @@
/*** links ***/
-a:link{ color: #ff;}
-a:visited { color: #99;}
-a:active { color: #66;}
-a:hover {
-color: #66;
-text-decoration: underline; /* needed for opera */
-}
-
/* hidden links */
h1 a:link,h2 a:link,h3 a:link,h4 a:link,
h1 a:visited, h2 a:visited, h3 a:visited, h4 a:visited,
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/admin style.pod
stas02/04/28 02:01:59 Modified:adminstyle.pod Log: add a note on how to submit a patch for a new file Submitted by: per einar Revision ChangesPath 1.8 +15 -0 modperl-docs/admin/style.pod Index: style.pod === RCS file: /home/cvs/modperl-docs/admin/style.pod,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- style.pod 28 Apr 2002 08:34:07 - 1.7 +++ style.pod 28 Apr 2002 09:01:58 - 1.8 @@ -348,6 +348,21 @@ [Stas: if you know about these functionalities, please let me know so we can share the knowledge with others who don't use emacs.] +To submit normal patches (when they are minor changes, and you're sure +the document hasn't changed), use the Ccvs diff method: + + ai% cvs diff -u src/docs/1.0/...pod + +If you're adding a file, especially if it needs a new directory, it +might be a good idea to submit a patch against C/dev/null, which +will automatically create the new directory, like this. + + ai% diff -u /dev/null newdir/newfilename.pod + +Or on Windows: + + ai% diff -u NUL newdir/newfilename.pod + =head2 Adding Inline Remarks =over 4 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide databases.pod
stas02/04/28 02:19:02 Modified:src/docs/1.0/guide databases.pod Log: - add some clarifications regarding opening connections with different login arguments Revision ChangesPath 1.7 +7 -4 modperl-docs/src/docs/1.0/guide/databases.pod Index: databases.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/databases.pod,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- databases.pod 3 Apr 2002 09:16:08 - 1.6 +++ databases.pod 28 Apr 2002 09:19:02 - 1.7 @@ -75,10 +75,13 @@ request from your CDBI module. This can be a huge benefit for a server with a high volume of database traffic. -You must Bnot use this module if you are opening a special connection -for each of your users. Each connection will stay persistent and in a -short time the number of connections will be so big that your machine -will scream in agony and die. +You must Bnot use this module if you are opening a special +connection for each of your users (meaning that the login arguments +are different for each user). Each connection will stay persistent +and in after a certain time the number of opened connections will +reach the allowed limit (configured by the database server) and new +connection opening requests wouldn't be granted, rendering your +service unusable for some of your users. If you want to use CApache::DBI but you have both situations on one machine, at the time of writing the only solution is to run two - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide databases.pod
stas02/04/28 02:20:29 Modified:src/docs/1.0/guide databases.pod Log: better wording Revision ChangesPath 1.8 +4 -4 modperl-docs/src/docs/1.0/guide/databases.pod Index: databases.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/databases.pod,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- databases.pod 28 Apr 2002 09:19:02 - 1.7 +++ databases.pod 28 Apr 2002 09:20:29 - 1.8 @@ -78,10 +78,10 @@ You must Bnot use this module if you are opening a special connection for each of your users (meaning that the login arguments are different for each user). Each connection will stay persistent -and in after a certain time the number of opened connections will -reach the allowed limit (configured by the database server) and new -connection opening requests wouldn't be granted, rendering your -service unusable for some of your users. +and after a certain period the number of open connections will reach +the allowed limit (configured by the database server) and new database +connection opening requests will be refused, rendering your service +unusable for some of your users. If you want to use CApache::DBI but you have both situations on one machine, at the time of writing the only solution is to run two - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/products products.html
stas02/04/28 07:46:42 Modified:src/products products.html Log: Added DnsZone as an application in products Submitted by: Per Einar Ellefsen [EMAIL PROTECTED] Revision ChangesPath 1.7 +4 -0 modperl-docs/src/products/products.html Index: products.html === RCS file: /home/cvs/modperl-docs/src/products/products.html,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- products.html 27 Apr 2002 03:24:28 - 1.6 +++ products.html 28 Apr 2002 14:46:42 - 1.7 @@ -105,6 +105,10 @@ ul +lia href=http://dnszone.org/;DnsZone/a is a fully functional +application for Apache/mod_perl. It implements a web based interface +for managing zones with a nameserver running BIND./li + li a href=http://www.sklar.com/dad/;DAD/a is a comprehensive website ad management system. It is a mod_perl application with advanced targeting capabilities, a comprehensive administrative - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/products config.cfg apache-modlist.html
stas02/04/26 20:33:12 Modified:src/products config.cfg apache-modlist.html Log: better descriptions Submitted by: Per Einar Ellefsen [EMAIL PROTECTED] Revision ChangesPath 1.2 +12 -10modperl-docs/src/products/config.cfg Index: config.cfg === RCS file: /home/cvs/modperl-docs/src/products/config.cfg,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- config.cfg5 Jan 2002 19:15:41 - 1.1 +++ config.cfg27 Apr 2002 03:33:12 - 1.2 @@ -1,16 +1,18 @@ use vars qw(@c); @c = ( - id = 'products', +id = 'products', - title = Products, +title = Products, - abstract = mod_perl based software, +abstract = EOB, +There is a lot of software out there ready to run with mod_perl and/or +help you with your programming project. +EOB + +chapters = [qw( +apache-modlist.html +app-server.pod +products.html +)], - chapters = [ - qw( - apache-modlist.html - app-server.pod - products.html -) - ], ); 1.4 +5 -1 modperl-docs/src/products/apache-modlist.html Index: apache-modlist.html === RCS file: /home/cvs/modperl-docs/src/products/apache-modlist.html,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- apache-modlist.html 13 Apr 2002 16:02:06 - 1.3 +++ apache-modlist.html 27 Apr 2002 03:33:12 - 1.4 @@ -1,12 +1,16 @@ html head titleThe Apache/Perl Module List/title +meta name=description content=The Apache/Perl Module List is the +equivalent of the Perl module list, but for mod_perl, and features a +significant amount of modules which you can take advantage of for your +mod_perl server, both to help you coding and as stand-along modules /head body h1The Apache/Perl Module List/h1 Maintained by a href=mailto:[EMAIL PROTECTED]Doug MacEachern/a, -bri $Revision: 1.3 $ $Date: 2002/04/13 16:02:06 $/i +bri $Revision: 1.4 $ $Date: 2002/04/27 03:33:12 $/i h3Contents/h3 a href=#introIntroduction/abr - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/api Apache.pod
stas02/04/26 20:34:13 Modified:src/docs/1.0/api Apache.pod Log: use real links Submitted by: per einar Revision ChangesPath 1.8 +6 -6 modperl-docs/src/docs/1.0/api/Apache.pod Index: Apache.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/api/Apache.pod,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- Apache.pod19 Apr 2002 16:02:22 - 1.7 +++ Apache.pod27 Apr 2002 03:34:13 - 1.8 @@ -1026,12 +1026,12 @@ =head1 See Also -perl(1), -Apache::Constants(3), -Apache::Registry(3), -Apache::Debug(3), -Apache::Options(3), -CGI::Apache(3) +perl, +LApache::Constants, +LApache::Registry, +LApache::Debug, +LApache::Options, +CGI Apache C API notes at http://httpd.apache.org/docs/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide Changes.pod porting.pod
stas02/04/27 11:32:39
Modified:src/docs/1.0/guide Changes.pod porting.pod
Log:
new section Preventing Apache::Constants Stringification
Submitted by: Per Einar Ellefsen [EMAIL PROTECTED]
Revision ChangesPath
1.15 +3 -0 modperl-docs/src/docs/1.0/guide/Changes.pod
Index: Changes.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/Changes.pod,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- Changes.pod 21 Apr 2002 05:00:09 - 1.14
+++ Changes.pod 27 Apr 2002 18:32:39 - 1.15
@@ -17,6 +17,9 @@
* guide::porting
+ o add a new section Preventing Apache::Constants Stringification
+[Per Einar]
+
o add a new section presenting a hackish solution for libraries
collision, via do() or %INC mangling.
1.9 +51 -0 modperl-docs/src/docs/1.0/guide/porting.pod
Index: porting.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/porting.pod,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- porting.pod 17 Apr 2002 04:38:52 - 1.8
+++ porting.pod 27 Apr 2002 18:32:39 - 1.9
@@ -3157,6 +3157,57 @@
=back
+=head1 Preventing Apache::Constants Stringification
+
+In mod_perl, you are going to use a certain number of constants in
+your code, mainly exported from CApache::Constants. However, in some
+cases, Perl will not understand that the constant you're trying to
+call is really a constant, but interprets it as a string. This is the
+case with the hash notation C=Egt, which automatically stringifies
+the key.
+
+For example:
+
+ $r-custom_response(FORBIDDEN = File size exceeds quota.);
+
+This will not set a custom response for CFORBIDDEN, but for the
+string CFORBIDDEN, which clearly isn't what is expected. You'll
+get an error like this:
+
+ [Tue Apr 23 19:46:14 2002] null: Argument FORBIDDEN isn't numeric
+ in subroutine entry at ...
+
+Therefore, you can avoid this by not using the hash notation for
+things that don't require it.
+
+ $r-custom_response(FORBIDDEN, File size exceeds quota.);
+
+There are other workarounds, which you should avoid using unless you
+really have to use hash notation:
+
+ my %hash = (
+ FORBIDDEN()= 'this is forbidden',
+ +AUTH_REQUIRED = You aren't authorized to enter!,
+ );
+
+Another important note is that you should be using the correct
+constants defined here, and not direct HTTP codes. For example:
+
+ sub handler {
+ return 200;
+ }
+
+Is not correct. The correct use is:
+
+ use Apache::Constants qw(OK);
+
+ sub handler {
+ return OK;
+ }
+
+Also remember that COK != HTTP_OK.
+
+
=head1 Transitioning from Apache::Registry to Apache handlers
Even if you are a CGI script die-hard at some point you might want to
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/download docs.pod
stas02/04/27 11:45:56 Modified:src/download docs.pod Log: changed the order around slightly and added Pod::POM as a prerequisite. Submitted by: Per Einar Ellefsen [EMAIL PROTECTED] Revision ChangesPath 1.3 +28 -29modperl-docs/src/download/docs.pod Index: docs.pod === RCS file: /home/cvs/modperl-docs/src/download/docs.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- docs.pod 27 Apr 2002 03:19:40 - 1.2 +++ docs.pod 27 Apr 2002 18:45:56 - 1.3 @@ -27,8 +27,36 @@ working directory which contains all the sources needed to build the site. +Another way to download the sources, if you don't want to use CVS, is +to get the snapshots available from +http://cvs.apache.org/snapshots/modperl-docs/ . However, it will be a +major drag for you to keep these up to date, so you are better advised +to use the CVS access. + =head1 Build +The build process is very simple, as we have developed a number of +tools which are very helpful in this task. However, you will need a +number of prerequisites before starting. + +=head2 Prerequisites + +DocSet: while it is included with the CVS distribution, please +download and install the latest version of DocSet from +http://www.apache.org/~stas/. It will install the tool Chtml2ps, +which is used to build the PDF version, and also a number of Perl +modules. + +You will also need CPod::POM for DocSet to work. You can get it from +CPAN. + +For the PDF version, you will also need a command-line tool called +Cps2pdf, which is included with the Ghostscript distribution: see +http://www.ghostscript.com/ . You will probably also need the +Inetpbm package. + + META: we need specifics about netpbm + =head2 Normal build process The programs used to build the site are included in the directory you @@ -41,35 +69,6 @@ open Iindex.html in there to start browsing the site. =head2 PDF version - -=head3 Prerequisites - -To build the PDF documents, you will need to have some extra tools -installed: Ips2pdf (which should come with the Ghostscript -distribution, see http://www.ghostscript.com/), and maybe the -Inetpbm tools too. For Windows platforms, see the file -IINSTALL.win32 for information. - -Please also note that to build the PDF version, you will have to have -Ihtml2ps installed. This tool is distributed with DocSet, the -framework used to build the site. DocSet is available in the Ilib/ -directory of the site repository, but you will have to download the -DocSet distribution to get Ihtml2ps: download the latest from -http://www.apache.org/~stas/ , and then install it with the usual: - - % tar -zxvf DocSet-0.xx.tar.gz - % cd DocSet-0.xx - % perl Makefile.PL - % make - % make test - % make install - -(replace Cmake with Cnmake on Windows systems, this implies that -you have Cnmake installed, see the ActivePerl docs for this: -http://aspn.activestate.com//ASPN/Reference/Products/ActivePerl/faq/Windows/ActivePerl-Winfaq9.html#Where_do_I_get_a_Win32_make -) - -=head3 Building Now, you can go back to your Imodperl-docs directory. Building the PDF version is as easy as with the HTML version, just do a simple: - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/start/tips config.pod favicon.pod handler.pod logging.pod registry.pod
stas02/04/25 18:43:11
Modified:src/start/tips config.pod favicon.pod handler.pod
logging.pod registry.pod
Log:
apply styles, indentation and markup as explained in admin/style.pod
Revision ChangesPath
1.2 +26 -24modperl-docs/src/start/tips/config.pod
Index: config.pod
===
RCS file: /home/cvs/modperl-docs/src/start/tips/config.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- config.pod25 Apr 2002 07:01:02 - 1.1
+++ config.pod26 Apr 2002 01:43:11 - 1.2
@@ -4,34 +4,36 @@
=head1 Configure virtual hosts
-With mod_perl, Perl code can be embedded directly in the Apache
configuration file.
-Perl in httpd.conf is commonly used to dynamically configure Apache, but
anything from
-URL translation to content generation can be accomplished directly in the
configuation file.
+With mod_perl, Perl code can be embedded directly in the Apache
+configuration file. Perl in httpd.conf is commonly used to
+dynamically configure Apache, but anything from URL translation to
+content generation can be accomplished directly in the configuation
+file.
-This example reads configuration settings from a text file and configures
Apache's
-virtual hosts.
+This example reads configuration settings from a text file and
+configures Apache's virtual hosts.
-The httpd.conf setup:
+The Ihttpd.conf setup:
-NameVirtualHost 192.168.0.1:80
-Perl
-open(HOSTS,'/etc/apache/vhosts.txt')
-or die Failed to open vhosts.txt: $!;
-
-while (HOSTS) {
-my %config;
-my @params = qw/ServerName DocumentRoot ErrorLog TransferLog
ServerAdmin/;
-@config{ @params } = split /\t/;
-$config{Directory}{$config{DocumentRoot}} = { Allow = 'from
all'};
-
-push @{$VirtualHost{'192.168.0.1:80'}}, \%config;
-}
-close HOSTS;
-
-/Perl
+ NameVirtualHost 192.168.0.1:80
+ Perl
+ open HOSTS, '/etc/apache/vhosts.txt'
+ or die Failed to open vhosts.txt: $!;
+
+ while (HOSTS) {
+ my %config;
+ my @params = qw/ServerName DocumentRoot ErrorLog TransferLog
ServerAdmin/;
+ @config{ @params } = split /\t/;
+ $config{ Directory }{ $config{DocumentRoot} } = { Allow = 'from
all' };
+
+ push @{ $VirtualHost{'192.168.0.1:80'} }, \%config;
+ }
+ close HOSTS;
+
+ /Perl
-See LThe Guide|guide::config/Apache_Configuration_in_Perl
-for other examples of configuring Apache with mod_perl.
+See LThe Guide|guide::config/Apache_Configuration_in_Perl for other
+examples of configuring Apache with mod_perl.
=for html
a class=more href=../index.html#config#171nbsp;back/a
1.2 +28 -24modperl-docs/src/start/tips/favicon.pod
Index: favicon.pod
===
RCS file: /home/cvs/modperl-docs/src/start/tips/favicon.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- favicon.pod 25 Apr 2002 07:01:02 - 1.1
+++ favicon.pod 26 Apr 2002 01:43:11 - 1.2
@@ -4,35 +4,39 @@
=head1 Using mod_perl to rewrite URLs
-Anyone that's looked at web logs will quickly see the usefulness of this
little
-mod_perl script. It catches all requests for favicon.ico and rewrites the
request
-to point to a vaild location. No more logs full of 404 errors.
+Anyone that's looked at web logs will quickly see the usefulness of
+this little mod_perl script. It catches all requests for
+Ifavicon.ico and rewrites the request to point to a vaild location.
+No more logs full of 404 errors.
+
+This example is adapted from the Lmod_perl Devekioer's
+Cookbook|http://modperlcookbook.com, chapter 12.
+
+ file:Cookbook/Favicon.pm
+
+ package Cookbook::Favicon;
+
+ use Apache::Constants qw(DECLINED);
+ use strict;
+
+ sub handler {
+ my $r = shift;
+
+ $r-uri('/images/favicon.ico')
+ if $r-uri =~ m!/favicon\.ico$!
+
+ return DECLINED;
+ }
+ 1;
-This example is adapted from the Lmod_perl Devekioer's
Cookbook|http://modperlcookbook.com, chapter 12.
-
-package Cookbook::Favicon;
-
-use Apache::Constants qw(DECLINED);
-use strict;
-
-sub handler {
-my $r = shift;
-
-$r-uri('/images/favicon.ico')
-if $r-uri =~ m!/favicon\.ico$!
-
-return DECLINED;
-}
-1;
-
-And configure in Fhttpd.conf with:
+And configure in Ihttpd.conf with:
PerlModule Cookbook::Favicon
PerlTransHandler
cvs commit: modperl-docs/src/start/tips handler.pod
stas02/04/25 18:44:31
Modified:src/start/tips handler.pod
Log:
print here closing token must start at the column 0
Revision ChangesPath
1.4 +3 -3 modperl-docs/src/start/tips/handler.pod
Index: handler.pod
===
RCS file: /home/cvs/modperl-docs/src/start/tips/handler.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handler.pod 26 Apr 2002 01:43:11 - 1.3
+++ handler.pod 26 Apr 2002 01:44:31 - 1.4
@@ -26,9 +26,9 @@
$r-send_http_header('text/plain');
print EOT;
- Thanks for visiting $server_name.
- The local time is $now.
- EOT
+ Thanks for visiting $server_name.
+ The local time is $now.
+ EOT
return Apache::Constants::OK;
}
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide perl.pod
stas02/04/24 22:44:29 Modified:src/docs/1.0/guide perl.pod Log: fix the syntax for declaring vars with our(). Submitted by: Larry Wall [EMAIL PROTECTED] Revision ChangesPath 1.8 +1 -1 modperl-docs/src/docs/1.0/guide/perl.pod Index: perl.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/perl.pod,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- perl.pod 23 Apr 2002 13:29:28 - 1.7 +++ perl.pod 25 Apr 2002 05:44:29 - 1.8 @@ -1524,7 +1524,7 @@ With perl5.6 you can use the Cour operator instead: - our ($scalar %hash @array); + our($scalar, %hash, @array); If you want to share package global variables between packages, here is what you can do. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/help help_with_site.pod index_top.html
stas02/04/20 21:35:54 Modified:src/help help_with_site.pod index_top.html Log: - added some more information to help.pod - added link to how to report problem in index_top.html Submitted by: Per Einar Ellefsen [EMAIL PROTECTED] Revision ChangesPath 1.3 +26 -11modperl-docs/src/help/help_with_site.pod Index: help_with_site.pod === RCS file: /home/cvs/modperl-docs/src/help/help_with_site.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- help_with_site.pod14 Apr 2002 06:05:04 - 1.2 +++ help_with_site.pod21 Apr 2002 04:35:54 - 1.3 @@ -30,27 +30,34 @@ =head2 Q. I cannot read the PDF version of the documents -BA. The PDF files require a browser plugin or standalone PDF reader to be read: -You can get the Adobe Acrobat Reader for many different platforms from their -website: http://www.adobe.com/products/acrobat/readstep2.html . +BA. The PDF files require a browser plugin or standalone PDF reader +to be read: You can get the Adobe Acrobat Reader for many different +platforms from their website: +http://www.adobe.com/products/acrobat/readstep2.html . =head2 Q. How the site search works BA. The search page reachable from the menu includes a complete usage documentation. But here is a short description: -In the menu on the left there is a search widget which can search the current -subset of documents, or the whole site. For example if you are reading one of -the documents in the mod_perl developers guide the search will return hits within -this document subset. If you are searching at the root of all -documentation, all documentation subsets will be searched. And finally -if you search at the root of the site, the whole site will be -searched. This widget is not intended to replace the IFind in the -current document feature implemented in most web browsers. +In the menu on the left there is a search widget which can search the +current subset of documents, or the whole site. For example if you are +reading one of the documents in the mod_perl developers guide the +search will return hits within this document subset. If you are +searching at the root of all documentation, all documentation subsets +will be searched. And finally if you search at the root of the site, +the whole site will be searched. This widget is not intended to +replace the IFind in the current document feature implemented in +most web browsers. The Ldedicated search page|XXX provides a more flexible search options, including the explanation of these options. +=head2 Q. Why isn't your site running mod_perl? + +BA. 99% of this site is comprised of a static content, so it doesn't +make sense to run mod_perl to serve it. You can see mod_perl in action +Lhere|outstanding::index. =head1 Contact Info @@ -63,6 +70,14 @@ The site is automatically generated from a collection of HTML and POD files, using Perl DocSet Framework, which in turn is based on Template Toolkit. + +If you are interested in downloading the site sources, you can get them from CVS: + + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login + +password: anoncvs. + + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl-docs META: add the URL of the DocSet when it gets released. 1.3 +6 -3 modperl-docs/src/help/index_top.html Index: index_top.html === RCS file: /home/cvs/modperl-docs/src/help/index_top.html,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- index_top.html13 Apr 2002 18:45:59 - 1.2 +++ index_top.html21 Apr 2002 04:35:54 - 1.3 @@ -5,9 +5,12 @@ body bgcolor=white p -mod_perl is an open source project and is very successfully supported -by its users and developers community. Most of the questions are -answered on the a href=../maillist/index.htmlmailing lists/a. +mod_perl is an open source project and is very successfully +supported by its users and developers community. Most of the questions +are answered on the a href=../maillist/index.htmlmailing +lists/a. Please read about a +href=../docs/1.0/guide/help.html#How_to_Report_Problemshow to +report problems/a if that's what you need to do. /p p - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/lib/DocSet/DocSet HTML.pm
stas02/04/21 00:25:18
Modified:lib/DocSet Config.pm DocSet.pm RunTime.pm Util.pm
lib/DocSet/DocSet HTML.pm
Log:
- I cannot reproduce the trailing punctuation character bug
(http://foo.com/bar.html.) in automatic POD URLifier, removed from
the TODO list.
- copy_glob = [foo/*] doesn't pick .dot_files in the first level of
subdir, because in unix glob() '*' doesn't match .files.
'copy_glob = [foo]' works correctly. Now this behavior is documented.
also fixed wrong documentation about copy_glob regarding creating
empty dirs.
- improve the logic for searing resources. If I have a setting of
search_paths as:
search_paths = [qw(
docs/1.0
.
)],
and the resource request is for Lfoo|win32::binaries everything is
cool if there is docs/1.0/win32/binaries.pod. However if somebody is
doing a better job and doing a fully qualified request like
Lfoo|docs::1.0::win32::binaries the page used to be reported as not
found, because it's cached in the prescan as 'docs/1.0' =
'win32/binaries.pod'. Now this problem is solved.
- add a special handling for L...|foo::bar::index so only
foo::bar is checked that it's a dir in the search path and
index.html is autogenerated. This allows us to do Lthe
guide|guide::index
- improve the exception handling of incorrect paths in config.cfg,
when a chapter item cannot be found.
Revision ChangesPath
1.6 +17 -8 modperl-docs/lib/DocSet/Config.pm
Index: Config.pm
===
RCS file: /home/cvs/modperl-docs/lib/DocSet/Config.pm,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- Config.pm 22 Mar 2002 02:01:51 - 1.5
+++ Config.pm 21 Apr 2002 07:25:18 - 1.6
@@ -59,6 +59,8 @@
my($self, $config_file) = @_;
die Configuration file is not specified unless $config_file;
+$self-{config_file} = $config_file;
+
my $package = path2package($config_file);
$self-{package} = $package;
@@ -737,22 +739,29 @@
=item * copy_glob
-Accepts a reference to an array of files and directories to copy. Note
-that you must use shell wildcharacters if you want deep directory
-copies, which also works for things like: C*.html. If you simply
-specify a directory name it'll be copied without any contents (this is
-a feature!). For example:
+Accepts a reference to an array of files and directories to copy. The
+items of the array are run through glob(), therefore wild characters
+can be used to match only certain files. But be careful since if you
+say:
+
+ images/*
+
+and there are some hidden files (and dirs) that need to be copied,
+they won't be copied, since C* doesn't match them.
+
+For example:
# non-pod/html files or dirs to be copied unmodified
copy_glob = [
qw(
style.css
-images/*
+images
)
],
-will copy Istyle.css and all the files under the Iimages/
-directory.
+will copy the file Istyle.css and all the files and directories
+under the Iimages/ directory into the parallel tree at the
+destination directory.
=item * copy_skip
1.8 +48 -4 modperl-docs/lib/DocSet/DocSet.pm
Index: DocSet.pm
===
RCS file: /home/cvs/modperl-docs/lib/DocSet/DocSet.pm,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- DocSet.pm 3 Apr 2002 11:47:56 - 1.7
+++ DocSet.pm 21 Apr 2002 07:25:18 - 1.8
@@ -21,7 +21,6 @@
return $self;
}
-
sub init {
my($self, $config_file, $parent_o, $src_rel_dir) = @_;
@@ -177,7 +176,7 @@
my $dst_root = $self-get_dir('dst_root');
my $dst_index = $dst_root/$src_rel_dir/index.html;
my($should_update, $reason) =
-should_update($cfg_file, $dst_index);
+$self-should_update($cfg_file, $dst_index);
$docset-modified(1) if $should_update;
note \n; # mark the end of scan
@@ -223,7 +222,7 @@
$self-trg_chapters($rel_dst_path) unless $hidden;
### to rebuild or not to rebuild
-my($should_update, $reason) = should_update($src_path, $dst_path);
+my($should_update, $reason) = $self-should_update($src_path, $dst_path);
if (!$should_update) {
note --- $src_file: skipping ($reason);
return undef;
@@ -283,7 +282,7 @@
# to rebuild or not to rebuild
my($should_update, $reason) =
-should_update($src_path, $dst_path);
+$self-should_update($src_path, $dst_path);
if (!$should_update) {
note --- skipping cp $src_path $dst_path
cvs commit: modperl-docs/src/docs/offsite .cvsignore
stas02/04/21 00:45:24 Added: src/docs/offsite .cvsignore Log: .cvsignore Revision ChangesPath 1.1 modperl-docs/src/docs/offsite/.cvsignore Index: .cvsignore === cache.*.dat - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src config.cfg
stas02/04/21 00:53:59 Modified:src config.cfg Log: complete the move of jobs and start pages Revision ChangesPath 1.21 +2 -9 modperl-docs/src/config.cfg Index: config.cfg === RCS file: /home/cvs/modperl-docs/src/config.cfg,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- config.cfg20 Apr 2002 08:07:45 - 1.20 +++ config.cfg21 Apr 2002 07:53:59 - 1.21 @@ -14,15 +14,9 @@ bot = 'index_bot.html', }, - chapters = [ - qw( -about/about.html -about/tips/registry.html - ) - ], - docsets = [ qw( +start outstanding download docs @@ -35,7 +29,7 @@ chapters = [ qw( -about/jobs.html +jobs/jobs.html ) ], @@ -55,7 +49,6 @@ robots.txt .htaccess search -about/LICENSE.txt ) ], - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/maillist email-etiquette.pod
stas02/04/21 07:31:05 Modified:src/outstanding/success_stories allakhazam.com.pod allakhazam.com.txt src/maillist email-etiquette.pod Log: use L|guide::index to point to the guide Revision ChangesPath 1.3 +1 -1 modperl-docs/src/outstanding/success_stories/allakhazam.com.pod Index: allakhazam.com.pod === RCS file: /home/cvs/modperl-docs/src/outstanding/success_stories/allakhazam.com.pod,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- allakhazam.com.pod14 Apr 2002 06:40:13 - 1.2 +++ allakhazam.com.pod21 Apr 2002 14:31:04 - 1.3 @@ -35,7 +35,7 @@ which are replicated, and the one mod_perl server (PIII 800, FreeBSD, Apache/mod_perl). The idea to use the proxy server to intercept any requests for text or images which was not dynamic came directly from - the mod_perl guide (http://perl.apache.org/guide/). + the mod_perl guide (http://perl.apache.org/docs/1.0/guide/). It's been a rough ride sometimes, as I've been in the process of 1.2 +1 -1 modperl-docs/src/outstanding/success_stories/allakhazam.com.txt Index: allakhazam.com.txt === RCS file: /home/cvs/modperl-docs/src/outstanding/success_stories/allakhazam.com.txt,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- allakhazam.com.txt13 Apr 2002 17:42:10 - 1.1 +++ allakhazam.com.txt21 Apr 2002 14:31:04 - 1.2 @@ -11,7 +11,7 @@ which are replicated, and the one mod_perl server (PIII 800, FreeBSD, Apache/mod_perl). The idea to use the proxy server to intercept any requests for text or images which was not dynamic came directly from -the mod_perl guide (http://perl.apache.org/guide/). +the mod_perl guide (http://perl.apache.org/docs/1.0/guide/). It's been a rough ride sometimes, as I've been in the process of learning the guts of Apache and more about perl than I ever thought 1.8 +19 -19modperl-docs/src/maillist/email-etiquette.pod Index: email-etiquette.pod === RCS file: /home/cvs/modperl-docs/src/maillist/email-etiquette.pod,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- email-etiquette.pod 18 Apr 2002 16:40:03 - 1.7 +++ email-etiquette.pod 21 Apr 2002 14:31:05 - 1.8 @@ -13,8 +13,7 @@ =head1 What is mod_perl? -http://perl.apache.org/guide/intro.html#What_is_mod_perl - +See the Lmod_perl Guide|docs::1.0::guide::intro. =head1 What you need to know to be able to use mod_perl @@ -48,9 +47,7 @@ =head2 Other documentation There are dozens of references to many authoritative resources at - -http://perl.apache.org/guide/help.html - +the Lmod_perl Guide's help chapter|docs::1.0::guide::help =head1 How to get on (and off!) the mod_perl mailing list @@ -368,16 +365,7 @@ =head2 Finding the Guide -META: when we get links to work, we need to change the links here - -The URL of the Guide is: - -http://perl.apache.org/guide/ - -The sources are available from CPAN and other mirrors: - -http://www.cpan.org/authors/id/S/ST/STAS/ - +Simply go to the mod_perl Guide|docs::1.0::guide::index. =head2 Corrections and Contributions @@ -387,11 +375,23 @@ kept in .pod format, and it is converted to other formats by Perl code. The Guide changes rather frequently (the CVS snapshot is updated every six hours!) so if you want to make a contribution make -sure that you get the latest version of the Guide source from +sure that you get the latest version of the Guide source from the cvs +repository: + + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login + +password: anoncvs. + + % cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl-docs + +The guide's in the Isrc/docs/1.0/guide directory. + +Please make your changes to the .pod source only and then post the +output of -http://stason.org/guide-snapshots + % cvs diff -u filename(s) -and make your changes to the .pod source only. In the first instance, -post your changes to the mod_perl List for comment. +ot the whole modified files to the Lmodperl-docs mailing +list|maillist::list-docs-dev. =cut - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide correct_headers.pod help.pod
stas02/04/21 07:31:26 Modified:src/docs/1.0/api/Apache SizeLimit.pod src/docs/1.0/guide correct_headers.pod help.pod Log: use L|guide::index to point to the guide Revision ChangesPath 1.2 +3 -2 modperl-docs/src/docs/1.0/api/Apache/SizeLimit.pod Index: SizeLimit.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/api/Apache/SizeLimit.pod,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- SizeLimit.pod 21 Apr 2002 07:26:37 - 1.1 +++ SizeLimit.pod 21 Apr 2002 14:31:26 - 1.2 @@ -80,8 +80,9 @@ In addition to simply checking the total size of a process, this module can factor in how much of the memory used by the process is actually being shared by copy-on-write. If you don't understand how -memory is shared in this way, take a look at the mod_perl Guide at -http://perl.apache.org/guide/. +memory is shared in this way, take a look at the Lmod_perl +Guide|docs::1.0::guide::index. + META: change link when site is live. 1.6 +2 -2 modperl-docs/src/docs/1.0/guide/correct_headers.pod Index: correct_headers.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/correct_headers.pod,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- correct_headers.pod 3 Apr 2002 09:16:08 - 1.5 +++ correct_headers.pod 21 Apr 2002 14:31:26 - 1.6 @@ -123,7 +123,7 @@ use Date::Parse; # Date::Parse parses RCS format, Apache::Util::parsedate doesn't $Mtime ||= -Date::Parse::str2time(substr q$Date: 2002/04/03 09:16:08 $, 6); +Date::Parse::str2time(substr q$Date: 2002/04/21 14:31:26 $, 6); $r-set_last_modified($Mtime); =head3 Expires and Cache-Control @@ -575,7 +575,7 @@ =head2 [1] -Stas Bekman: mod_perl Guide. http://perl.apache.org/guide/ +Stas Bekman: Lmod_perl Guide|docs::1.0::guide::index =head2 [2] 1.14 +2 -2 modperl-docs/src/docs/1.0/guide/help.pod Index: help.pod === RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/help.pod,v retrieving revision 1.13 retrieving revision 1.14 diff -u -r1.13 -r1.14 --- help.pod 15 Apr 2002 08:55:42 - 1.13 +++ help.pod 21 Apr 2002 14:31:26 - 1.14 @@ -225,9 +225,9 @@ =back -=item * mod_perl Guide +=item * -by Stas Bekman at http://perl.apache.org/guide +Lmod_perl Guide|docs::1.0::guide::index by Stas Bekman. =item * mod_perl FAQ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/lib/DocSet Cache.pm Config.pm DocSet.pm
stas02/04/21 08:36:53
Modified:lib/DocSet Cache.pm Config.pm DocSet.pm
Log:
- force rebuild of the docset if the cache file is missing, even if
the target files aren't older than the source files. (this is the
case where for some reason the cache file was deleted)
- set the 'stitle' attr to 'title' for 'links' type, if missing.
- handle the case where docsets, links or chapters get removed
from docset. The cache uses only active items (listed in config.cfg)
changed the way the ordered list of items is constructed
- fix the bug where a change in the main config.cfg won't indicate a
modified docset and therefore a rebuild.
Revision ChangesPath
1.4 +40 -10modperl-docs/lib/DocSet/Cache.pm
Index: Cache.pm
===
RCS file: /home/cvs/modperl-docs/lib/DocSet/Cache.pm,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- Cache.pm 5 Feb 2002 10:27:19 - 1.3
+++ Cache.pm 21 Apr 2002 15:36:53 - 1.4
@@ -11,7 +11,7 @@
my %attrs = map {$_ = 1} qw(toc meta order);
sub new {
-my($class, $path) = @_;
+my($class, $path, $update) = @_;
die no cache path specified unless defined $path;
@@ -21,6 +21,20 @@
}, ref($class)||$class;
$self-read();
+if ($update) {
+# we will reconstruct the ids order to make sure to reflect the
+# changes in added and removed items (and those who have changed
+# their order)
+$self-{cache}{_ordered_ids} = [];
+
+# XXX: because we rewrite _order_ids on each invocation, we have to
sync
+# the cache to the disk, even if it didn't really change. In the
+# future we may do somechecksum check and write the file only if
+# the checksum has changed, so at this moment the dirty mechanism
+# does nothing
+$self-{dirty} = 1;
+}
+
return $self;
}
@@ -51,6 +65,12 @@
}
}
+sub add {
+my($self, $id) = @_;
+push @{ $self-{cache}{_ordered_ids} }, $id;
+$self-{cache}{$id}{seq} = $#{ $self-{cache}{_ordered_ids} };
+}
+
# set a cache entry (overrides a prev entry if any exists)
sub set {
my($self, $id, $attr, $data, $hidden) = @_;
@@ -59,11 +79,12 @@
croak must specify an attribute unless defined $attr;
croak unknown attribute $attr unless exists $attrs{$attr};
-# remember the addition order (unless it's an update)
-unless (exists $self-{cache}{$id}) {
-push @{ $self-{cache}{_ordered_ids} }, $id;
-$self-{cache}{$id}{seq} = $#{ $self-{cache}{_ordered_ids} };
-}
+## remember the addition order (unless it's an update)
+#unless (exists $self-{cache}{$id}) {
+#push @{ $self-{cache}{_ordered_ids} }, $id;
+#$self-{cache}{$id}{seq} = $#{ $self-{cache}{_ordered_ids} };
+#}
+
$self-{cache}{$id}{$attr} = $data;
$self-{cache}{$id}{_hidden} = $hidden;
$self-{dirty} = 1;
@@ -144,7 +165,7 @@
my($self, $seq) = @_;
croak must specify a seq number unless defined $seq;
-if ($self-{cache}{_ordered_ids}) {
+if ($self-{cache}{_ordered_ids} defined
$self-{cache}{_ordered_ids}-[$seq]) {
return $self-{cache}{_ordered_ids}-[$seq];
}
else {
@@ -244,15 +265,24 @@
use DocSet::Cache ();
- my $cache = DocSet::Cache-new($cache_path);
- $cache-read;
+ my $cache = DocSet::Cache-new($cache_path, 1);
+
+ # $cache-read; # read by new() already
$cache-write;
+ # add a cache item to the ordered list
+ $cache-add($id);
+
+ # set/unset cached item's attributes
$cache-set($id, $attr, $data);
+ $cache-unset($id, $attr)
+
+ # get cached item's attributes
my $data = $cache-get($id, $attr);
print $id is cached if $cache-is_cached($id);
+
+ # invalidate cache (deletes all items)
$cache-invalidate();
- $cache-unset($id, $attr)
my $seq = $cache-id2seq($id);
my $id = $cache-seq2id($seq);
1.7 +25 -3 modperl-docs/lib/DocSet/Config.pm
Index: Config.pm
===
RCS file: /home/cvs/modperl-docs/lib/DocSet/Config.pm,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- Config.pm 21 Apr 2002 07:25:18 - 1.6
+++ Config.pm 21 Apr 2002 15:36:53 - 1.7
@@ -118,8 +118,8 @@
# - make sure that at least title or stitle were specified
# - alias one to another if only one was specified
-$self-{title} ||= $self-{stitle};
-$self-{stitle} ||= $self-{title};
+$self-{title} = $self-{stitle} unless exists $self-{title};
+$self-{stitle} = $self-{title} unless exists $self-{stitle};
die
cvs commit: modperl-docs/src/images/nav page_prev.gif
stas02/04/21 09:30:48
Modified:.TODO
bin makeindex
src config.cfg style.css
src/images/nav page_prev.gif
Log:
todo updates
Revision ChangesPath
1.41 +0 -6 modperl-docs/TODO
Index: TODO
===
RCS file: /home/cvs/modperl-docs/TODO,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- TODO 20 Apr 2002 07:22:47 - 1.40
+++ TODO 21 Apr 2002 16:30:47 - 1.41
@@ -17,12 +17,6 @@
it's not a doc.
STATUS: need to extend pod parser with Utitle (url|relative url)
-- need to have a special handling for L...|foo::bar::index so only
- foo::bar is checked that it's a dir in the search path and
- index.html is autogenerated. This allows us to do Lthe
- guide|guide::index
- STATUS: need to implement this
-
Menu:
-
1.4 +8 -2 modperl-docs/bin/makeindex
Index: makeindex
===
RCS file: /home/cvs/modperl-docs/bin/makeindex,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- makeindex 3 Apr 2002 05:17:07 - 1.3
+++ makeindex 21 Apr 2002 16:30:47 - 1.4
@@ -1,5 +1,9 @@
#!/usr/bin/perl -w
+my %opts;
+use Getopt::Std;
+getopt('v', \%opts);
+
# do the indexing process
# relies on setting of the following env varibles:
#
@@ -38,6 +42,8 @@
use FindBin qw($Bin);
use Cwd ();
+my $verbose_level = exists $opts{v} ? 1 : 0;
+
my $swish_binary = $ENV{SWISH_BINARY_PATH} || './swish-e';
die Cannot find swish-e at $swish_binary: $! unless -x $swish_binary;
@@ -45,8 +51,8 @@
chdir $Bin/../dst_html/search;
# index
-my $command = $swish_binary -S prog -c swish.conf;
-#print $command;
+my $command = SPIDER_QUIET=$verbose_level $swish_binary -v $verbose_level
-S prog -c swish.conf;
+print $command\n;
CORE::system($command);
chdir $cwd;
1.22 +17 -1 modperl-docs/src/config.cfg
Index: config.cfg
===
RCS file: /home/cvs/modperl-docs/src/config.cfg,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- config.cfg21 Apr 2002 07:53:59 - 1.21
+++ config.cfg21 Apr 2002 16:30:47 - 1.22
@@ -14,9 +14,25 @@
bot = 'index_bot.html',
},
+ hidden = [
+ docsets = [
+ qw(
+start
+ )
+ ],
+ ],
+
+ links = [
+ {
+ id = 'what_is_mod_perl',
+ link = 'start/about.html',
+ title= 'What is mod_perl',
+ abstract = Bara Bara,
+ },
+ ],
+
docsets = [
qw(
-start
outstanding
download
docs
1.57 +2 -0 modperl-docs/src/style.css
Index: style.css
===
RCS file: /home/cvs/modperl-docs/src/style.css,v
retrieving revision 1.56
retrieving revision 1.57
diff -u -r1.56 -r1.57
--- style.css 20 Apr 2002 08:07:45 - 1.56
+++ style.css 21 Apr 2002 16:30:47 - 1.57
@@ -48,6 +48,8 @@
/* dark blue bg-color for selected menu-items */
td.sel-bg { background-color: #525d76; }
+li.search { list-style: none; }
+
div.nonselectedmenuitem {
padding: 3px;
background-color: #ee;
1.3 +3 -2 modperl-docs/src/images/nav/page_prev.gif
Binary file
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/images/nav page_prev.gif
stas02/04/21 09:34:24
Modified:bin makeindex
src config.cfg style.css
src/images/nav page_prev.gif
Log:
revert a stray commit
Revision ChangesPath
1.5 +2 -8 modperl-docs/bin/makeindex
Index: makeindex
===
RCS file: /home/cvs/modperl-docs/bin/makeindex,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- makeindex 21 Apr 2002 16:30:47 - 1.4
+++ makeindex 21 Apr 2002 16:34:24 - 1.5
@@ -1,9 +1,5 @@
#!/usr/bin/perl -w
-my %opts;
-use Getopt::Std;
-getopt('v', \%opts);
-
# do the indexing process
# relies on setting of the following env varibles:
#
@@ -42,8 +38,6 @@
use FindBin qw($Bin);
use Cwd ();
-my $verbose_level = exists $opts{v} ? 1 : 0;
-
my $swish_binary = $ENV{SWISH_BINARY_PATH} || './swish-e';
die Cannot find swish-e at $swish_binary: $! unless -x $swish_binary;
@@ -51,8 +45,8 @@
chdir $Bin/../dst_html/search;
# index
-my $command = SPIDER_QUIET=$verbose_level $swish_binary -v $verbose_level
-S prog -c swish.conf;
-print $command\n;
+my $command = $swish_binary -S prog -c swish.conf;
+#print $command;
CORE::system($command);
chdir $cwd;
1.23 +1 -17 modperl-docs/src/config.cfg
Index: config.cfg
===
RCS file: /home/cvs/modperl-docs/src/config.cfg,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- config.cfg21 Apr 2002 16:30:47 - 1.22
+++ config.cfg21 Apr 2002 16:34:24 - 1.23
@@ -14,25 +14,9 @@
bot = 'index_bot.html',
},
- hidden = [
- docsets = [
- qw(
-start
- )
- ],
- ],
-
- links = [
- {
- id = 'what_is_mod_perl',
- link = 'start/about.html',
- title= 'What is mod_perl',
- abstract = Bara Bara,
- },
- ],
-
docsets = [
qw(
+start
outstanding
download
docs
1.58 +0 -2 modperl-docs/src/style.css
Index: style.css
===
RCS file: /home/cvs/modperl-docs/src/style.css,v
retrieving revision 1.57
retrieving revision 1.58
diff -u -r1.57 -r1.58
--- style.css 21 Apr 2002 16:30:47 - 1.57
+++ style.css 21 Apr 2002 16:34:24 - 1.58
@@ -48,8 +48,6 @@
/* dark blue bg-color for selected menu-items */
td.sel-bg { background-color: #525d76; }
-li.search { list-style: none; }
-
div.nonselectedmenuitem {
padding: 3px;
background-color: #ee;
1.4 +2 -3 modperl-docs/src/images/nav/page_prev.gif
Binary file
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/lib/DocSet DocSet.pm
stas02/04/21 09:36:36
Modified:lib/DocSet DocSet.pm
Log:
handle properly hidden chapters rebuild
Revision ChangesPath
1.10 +5 -2 modperl-docs/lib/DocSet/DocSet.pm
Index: DocSet.pm
===
RCS file: /home/cvs/modperl-docs/lib/DocSet/DocSet.pm,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- DocSet.pm 21 Apr 2002 15:36:53 - 1.9
+++ DocSet.pm 21 Apr 2002 16:36:35 - 1.10
@@ -140,8 +140,11 @@
} elsif ($type eq 'chapters') {
my $chapter = $self-chapter_scan_n_cache($data, $hidden);
-$self-object_store($chapter)
-if defined $chapter and ref $chapter;
+if (defined $chapter and ref $chapter) {
+# modified chapter -- modified docset
+$self-modified(1);
+$self-object_store($chapter)
+}
} else {
# nothing
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/guide perl.pod
stas02/04/21 10:30:56
Modified:src/docs/1.0/guide perl.pod
Log:
typo
Submitted by: Sören Stuckenbrock [EMAIL PROTECTED]
Revision ChangesPath
1.6 +5 -5 modperl-docs/src/docs/1.0/guide/perl.pod
Index: perl.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/perl.pod,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- perl.pod 4 Apr 2002 02:24:28 - 1.5
+++ perl.pod 21 Apr 2002 17:30:56 - 1.6
@@ -1749,21 +1749,21 @@
In the Istartup.pl we might have the following code:
-# retrieve the configuration module path
- use Apache:
+ # retrieve the configuration module path
+ use Apache;
my $s = Apache-server;
my $base_dir = $s-dir_config('FooBaseDir') || '';
my $config_module = $s-dir_config('FooConfigModule') || '';
die FooBaseDir and FooConfigModule aren't set in httpd.conf
unless $base_dir and $config_module;
-# build the real path to the config module
+ # build the real path to the config module
my $path = $base_dir/$config_module;
$path =~ s|::|/|;
$path .= .pm;
-# we have something like /home/httpd/foo/Foo/Config.pm
+ # we have something like /home/httpd/foo/Foo/Config.pm
-# now we can pull in the configuration module
+ # now we can pull in the configuration module
require $path;
Now we know the module name and it's loaded, so for example if we need
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/support .cvsignore
stas02/04/21 10:56:57 Removed: src/support .cvsignore Log: remove the old dir (was hold by .cvsignore) - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/help isps.html
stas02/04/21 11:01:59 Modified:src/help isps.html Log: one ISP dies, the other comes to pick the falling flag Revision ChangesPath 1.2 +3 -1 modperl-docs/src/help/isps.html Index: isps.html === RCS file: /home/cvs/modperl-docs/src/help/isps.html,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- isps.html 13 Apr 2002 17:38:10 - 1.1 +++ isps.html 21 Apr 2002 18:01:59 - 1.2 @@ -96,7 +96,9 @@ ul -lia href=http://www.dwc.ch/;DWC/a, Zurich (a href=mailto:[EMAIL PROTECTED][EMAIL PROTECTED]/a)/li +lia href=http://www.simple.ch/;Simplicity GmbhH/a +(a href=mailto:[EMAIL PROTECTED][EMAIL PROTECTED]/a and +more a href=http://www.simple.ch/philosophy/technology/software;details/a)/li /ul - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/help isps.html
stas02/04/21 11:04:10 Modified:src/help isps.html Log: forgot to add that the new ISP is based in Basel Revision ChangesPath 1.3 +1 -1 modperl-docs/src/help/isps.html Index: isps.html === RCS file: /home/cvs/modperl-docs/src/help/isps.html,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- isps.html 21 Apr 2002 18:01:59 - 1.2 +++ isps.html 21 Apr 2002 18:04:10 - 1.3 @@ -96,7 +96,7 @@ ul -lia href=http://www.simple.ch/;Simplicity GmbhH/a +lia href=http://www.simple.ch/;Simplicity GmbhH/a, Basel (a href=mailto:[EMAIL PROTECTED][EMAIL PROTECTED]/a and more a href=http://www.simple.ch/philosophy/technology/software;details/a)/li - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src/docs/1.0/api Constants.pod File.pod Include.pod Log.pod Options.pod PerlRun.pod PerlSections.pod Registry.pod RegistryLoader.pod Resource.pod SIG.pod SizeLimit.pod StatINC.pod Status.pod Symbol.pod Symdump.pod Table.pod test.pod Changes.pod config.cfg
stas02/04/20 03:38:51
Modified:src/docs/1.0/api Changes.pod config.cfg
Added: src/docs/1.0/api Constants.pod File.pod Include.pod Log.pod
Options.pod PerlRun.pod PerlSections.pod
Registry.pod RegistryLoader.pod Resource.pod
SIG.pod SizeLimit.pod StatINC.pod Status.pod
Symbol.pod Symdump.pod Table.pod test.pod
Log:
clean the pods from the rest of the 1.x API and add them to the /api/
Submitted by: Per Einar Ellefsen [EMAIL PROTECTED]
Revision ChangesPath
1.3 +10 -1 modperl-docs/src/docs/1.0/api/Changes.pod
Index: Changes.pod
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/api/Changes.pod,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- Changes.pod 19 Apr 2002 16:02:22 - 1.2
+++ Changes.pod 20 Apr 2002 10:38:50 - 1.3
@@ -1,6 +1,6 @@
=head1 NAME
-CHANGES
+Changes
=head1 Description
@@ -8,6 +8,15 @@
documents, since you've read these last time.
The most recent changes are listed first.
+
+=head1 Sat Apr 20 11:41:00 CET 2002
+
+Per Einar Ellefsen:
+
+* Added CApache::* modules from core to complete the API. Reviewed
+ the content, added right tags and indentation where needed.
+
+* Apache::File: added synopsis.
=head1 Thu Apr 18 12:28:00 CET 2002
1.4 +20 -2 modperl-docs/src/docs/1.0/api/config.cfg
Index: config.cfg
===
RCS file: /home/cvs/modperl-docs/src/docs/1.0/api/config.cfg,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- config.cfg3 Apr 2002 07:46:13 - 1.3
+++ config.cfg20 Apr 2002 10:38:50 - 1.4
@@ -5,8 +5,8 @@
title = mod_perl 1.0 API,
abstract = EOB,
-This is only a partial API, the rest of the API documentation is in
-the source distribution
+Here is the documentation for the whole API provided with the mod_perl
+distribution, ie. of various Apache:: modules you will need to use.
EOB
body = {
@@ -15,6 +15,24 @@
chapters = [qw(
Apache.pod
+Constants.pod
+Table.pod
+File.pod
+Include.pod
+Log.pod
+Registry.pod
+RegistryLoader.pod
+PerlRun.pod
+StatINC.pod
+test.pod
+Options.pod
+PerlSections.pod
+Status.pod
+Symbol.pod
+Resource.pod
+SizeLimit.pod
+SIG.pod
+Symdump.pod
Changes.pod
)],
);
1.1 modperl-docs/src/docs/1.0/api/Constants.pod
Index: Constants.pod
===
=head1 NAME
Apache::Constants - Constants defined in apache header files
=head1 Synopsis
use Apache::Constants;
use Apache::Constants ':common';
use Apache::Constants ':response';
=head1 Description
Server constants used by apache modules are defined in
Bhttpd.h and other header files, this module gives Perl access
to those constants.
=head1 Export Tags
=over 4
=item common
This tag imports the most commonly used constants.
OK
DECLINED
DONE
NOT_FOUND
FORBIDDEN
AUTH_REQUIRED
SERVER_ERROR
=item response
This tag imports the Bcommon response codes, plus these
response codes:
DOCUMENT_FOLLOWS
MOVED
REDIRECT
USE_LOCAL_COPY
BAD_REQUEST
BAD_GATEWAY
RESPONSE_CODES
NOT_IMPLEMENTED
CONTINUE
NOT_AUTHORITATIVE
BCONTINUE and BNOT_AUTHORITATIVE are aliases for BDECLINED.
=item methods
This are the method numbers, commonly used with
the Apache Bmethod_number method.
METHODS
M_CONNECT
M_DELETE
M_GET
M_INVALID
M_OPTIONS
M_POST
M_PUT
M_TRACE
M_PATCH
M_PROPFIND
M_PROPPATCH
M_MKCOL
M_COPY
M_MOVE
M_LOCK
M_UNLOCK
=item options
These constants are most commonly used with
the Apache Ballow_options method:
OPT_NONE
OPT_INDEXES
OPT_INCLUDES
OPT_SYM_LINKS
OPT_EXECCGI
OPT_UNSET
OPT_INCNOEXEC
OPT_SYM_OWNER
OPT_MULTI
OPT_ALL
=item satisfy
These constants are most commonly used with
the Apache Bsatisfies method:
SATISFY_ALL
SATISFY_ANY
SATISFY_NOSPEC
=item remotehost
These constants are most commonly used with
the Apache Bget_remote_host method:
REMOTE_HOST
REMOTE_NAME
REMOTE_NOLOOKUP
REMOTE_DOUBLE_REV
=item http
This is the full set of HTTP response codes:
(NOTE: not all implemented here)
HTTP_OK
HTTP_MOVED_TEMPORARILY
HTTP_MOVED_PERMANENTLY
HTTP_METHOD_NOT_ALLOWED
HTTP_NOT_MODIFIED
cvs commit: modperl-docs/tmpl/custom/html tail
stas02/04/17 21:10:47 Modified:tmpl/custom/html tail Log: add a new line at the end Revision ChangesPath 1.12 +1 -1 modperl-docs/tmpl/custom/html/tail Index: tail === RCS file: /home/cvs/modperl-docs/tmpl/custom/html/tail,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- tail 13 Apr 2002 14:14:02 - 1.11 +++ tail 18 Apr 2002 04:10:47 - 1.12 @@ -9,4 +9,4 @@ /div !-- end footer (tail)-- -brbr \ No newline at end of file +brbr - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: modperl-docs/src style.css index_top.html
stas02/04/15 21:59:56
Modified:src style.css index_top.html
Log:
- add lincoln's quote to the front page.
- add a supporting style definition
Submitted by: Per Einar Ellefsen [EMAIL PROTECTED]
Revision ChangesPath
1.48 +9 -0 modperl-docs/src/style.css
Index: style.css
===
RCS file: /home/cvs/modperl-docs/src/style.css,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -r1.47 -r1.48
--- style.css 13 Apr 2002 15:46:11 - 1.47
+++ style.css 16 Apr 2002 04:59:56 - 1.48
@@ -293,3 +293,12 @@
}
.hr { height: 1px; }
+
+/* quotations, mainly for the first page */
+
+.quotation {
+font-style: italic;
+}
+p.quotation { /* Used to cite the author */
+text-align: right;
+}
1.3 +16 -0 modperl-docs/src/index_top.html
Index: index_top.html
===
RCS file: /home/cvs/modperl-docs/src/index_top.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- index_top.html6 Feb 2002 04:32:17 - 1.2
+++ index_top.html16 Apr 2002 04:59:56 - 1.3
@@ -3,6 +3,22 @@
titleindex top/title
/head
body bgcolor=white
+
+blockquote class=quotation
+mod_perl is more than CGI scripting on steroids. It is a whole new way to
+create dynamic content by utilizing the full power of the Apache web server
+to create stateful sessions, customized user authentication systems, smart
+proxies, and much more. Yet, magically, your old CGI scripts will continue
+to work, and work very fast indeed. With mod_perl you give up nothing, and
+ gain so much!
+/blockquote
+p class=quotation
+-- Lincoln Stein, author of the popular
+a href=http://stein.cshl.org/WWW/software/CGI/;CGI/a module and
+of a href=http://www.modperl.com/;Writing Apache Modules in Perl and C/a
+/p
+
+
pmod_perl brings together the full power of the a
href=http://www.perl.org;Perl/a programming language and the A
href=http://www.apache.org/;Apache/a HTTP server. You can use
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
