stas 02/02/28 08:23:23
Modified: src/docs/1.0/faqs mod_perl_faq.pod mod_perl_tuning.pod
perl_myth.pod
src/docs/1.0/guide config.pod control.pod debug.pod help.pod
src/docs/2.0/api/mod_perl-2.0/APR Table.pod
src/docs/2.0/devel/testing testing.pod
src/docs/2.0/user config.cfg
src/maillist email-etiquette.pod
Log:
- fix tons of broken links
Revision Changes Path
1.4 +4 -5 modperl-docs/src/docs/1.0/faqs/mod_perl_faq.pod
Index: mod_perl_faq.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/mod_perl_faq.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- mod_perl_faq.pod 27 Feb 2002 18:03:35 -0000 1.3
+++ mod_perl_faq.pod 28 Feb 2002 16:23:22 -0000 1.4
@@ -149,7 +149,7 @@
PerlHandler Apache::Status
</Location>
-Then look at the URL http://www.your.host/perl-status
+Then look at the URL http://www.example.com/perl-status
Joel Wagner reports that calling an undefined subroutine in a module
can cause a tight loop that consumes all memory. Here is a way to
@@ -380,10 +380,9 @@
=head2 Where can I get help that I did not find in here?
There is a mailing-list dedicated to mod_perl. It is archived at
-http://outside.organic.com/mail-archives/modperl/ and at
-http://mathforum.org/epigone/modperl (which has a search
-engine) and also at
-http://www.progressive-comp.com/Lists/?l=apache-modperl&r=1#apache-modperl
+http://mathforum.org/epigone/modperl (which has a search engine) and
+also at
+http://marc.theaimsgroup.com/?l=apache-modperl&r=1&w=2#apache-modperl
(threaded and indexed).
You can subscribe to the list by sending a mail with the line C<subscribe
1.3 +3 -3 modperl-docs/src/docs/1.0/faqs/mod_perl_tuning.pod
Index: mod_perl_tuning.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/mod_perl_tuning.pod,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- mod_perl_tuning.pod 22 Feb 2002 08:33:09 -0000 1.2
+++ mod_perl_tuning.pod 28 Feb 2002 16:23:22 -0000 1.3
@@ -26,9 +26,9 @@
The basic configuration for mod_perl is as follows. In the
F<httpd.conf> file, I add configuration parameters to make the
-C<http://www.domain.com/programs> URL be the base location for all
+C<http://www.example.com/programs> URL be the base location for all
mod_perl programs. Thus, access to
-C<http://www.domain.com/programs/printenv> will run the printenv
+C<http://www.example.com/programs/printenv> will run the printenv
script, as we'll see below. Also, any *.perl file will be interpreted
as a mod_perl program just as if it were in the programs directory,
and *.rperl will be mod_perl, but I<without> any HTTP headers
@@ -284,7 +284,7 @@
that you have included the mod_proxy module in your server when it was
built.
-Now, when you access http://www.domain.com/programs/printenv it will
+Now, when you access http://www.example.com/programs/printenv it will
internally be passed through to your HTTPD running on port 8042 as the
URL http://localhost:8042/programs/printenv and the result relayed
back transparently. To the client, it all seems as if it is just one
1.4 +2 -4 modperl-docs/src/docs/1.0/faqs/perl_myth.pod
Index: perl_myth.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/faqs/perl_myth.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- perl_myth.pod 5 Jan 2002 20:42:52 -0000 1.3
+++ perl_myth.pod 28 Feb 2002 16:23:22 -0000 1.4
@@ -138,7 +138,7 @@
Click> ( http://valueclick.com ), B<Paramount Digital Entertainment>,
B<CMP> ( http://cmpnet.com ), B<HotBot Mail>/B<HotBot Homepages>, and
B<DejaNews> to name a few. Even B<Microsoft> has taken interest in
-Perl, ( http://www.activestate.com/press/releases/Microsoft.htm ).
+Perl via http://www.activestate.com/.
=back
@@ -292,9 +292,7 @@
email: [EMAIL PROTECTED]
-WWW: http://sm.pm.org/
-
-WWW: http://www.cnation.com
+www: http://www.cnation.com
=head1 VERSION
1.4 +12 -11 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.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- config.pod 27 Feb 2002 18:03:36 -0000 1.3
+++ config.pod 28 Feb 2002 16:23:22 -0000 1.4
@@ -488,7 +488,7 @@
mod_cgi mode from a mod_perl-enabled server--the resource consumption
is too high. It is better to run these on a plain Apache server. See
L<Standalone mod_perl Enabled Apache
-Server|guide::strategy/Standalone_mod_perl_Enabled_Apac>.
+Server|guide::strategy/Standalone_mod_perl_Enabled_Apache_Server>.
=head2 E<lt>LocationE<gt> Configuration
@@ -1031,7 +1031,7 @@
PerlFreshRestart On
Make sure you read L<Evil things might happen when using
-PerlFreshRestart|guide::troubleshooting/Evil_things_might_happen_when_us>.
+PerlFreshRestart|guide::troubleshooting/Evil_things_might_happen_when_using_PerlFreshRestart>.
Starting from mod_perl version 1.22 C<PerlFreshRestart> is ignored
when mod_perl is compiled as a DSO. But it almost doesn't matter,
@@ -1057,7 +1057,7 @@
Regarding the setting of C<PerlPassEnv PERL5LIB> in I<httpd.conf>: if
you turn on taint checks (C<PerlTaintCheck On>), C<$ENV{PERL5LIB}>
will be ignored (unset). See the 'L<Switches -w,
--T|guide::porting/Command_Line_Switches_w_T_e>' section.
+-T|guide::porting/Command_Line_Switches___w___T__etc_>' section.
C<PerlSetVar> is very similar to C<PerlSetEnv>, but you extract it
with another method.
@@ -1124,7 +1124,7 @@
=head2 PerlWarn and PerlTaintCheck
For B<PerlWarn> and B<PerlTaintCheck> directives see the 'L<Switches
--w, -T|guide::porting/Command_Line_Switches_w_T_e>' section.
+-w, -T|guide::porting/Command_Line_Switches___w___T__etc_>' section.
=head2 MinSpareServers MaxSpareServers StartServers MaxClients
MaxRequestsPerChild
@@ -1144,8 +1144,8 @@
These five directives are very important for achieving the best
performance from your server. The section ' L<Performance Tuning by
Tweaking Apache
-Configuration|guide::performance/Performance_Tuning_by_Tweaking_A>' provides
-all the details.
+Configuration|guide::performance/Performance_Tuning_by_Tweaking_Apache_Configuration>'
+provides all the details.
=head1 The Startup File
@@ -1310,7 +1310,8 @@
But the old method is still available for backward compatibility.
See also the 'L<Apache::Status -- Embedded interpreter status
-information|guide::debug/Apache_Status_Embedded_Inter>' section.
+information|guide::debug/Apache__Status____Embedded_Interpreter_Status_Information>'
+section.
=head2 What Modules You Should Add to the Startup File and Why
@@ -1320,9 +1321,9 @@
You can even preload your CGI script with C<Apache::RegistryLoader>
(See L<Preload Perl modules at server
-startup|guide::performance/Preloading_Perl_Modules_at_Serve>) and you can get
-the children to preopen their database connections with
-C<Apache::DBI>.
+startup|guide::performance/Preloading_Perl_Modules_at_Server_Startup>)
+and you can get the children to preopen their database connections
+with C<Apache::DBI>.
=head2 The Confusion with use() in the Server Startup File
@@ -1977,7 +1978,7 @@
on.
For more information see L<Publishing Port Numbers other than
-80|guide::config/Publishing_Port_Numbers_other_th>.
+80|guide::config/Publishing_Port_Numbers_other_than_80>.
The more modules you have in your web server, the more complex the
code.
1.4 +13 -13 modperl-docs/src/docs/1.0/guide/control.pod
Index: control.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/guide/control.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- control.pod 27 Feb 2002 18:03:36 -0000 1.3
+++ control.pod 28 Feb 2002 16:23:22 -0000 1.4
@@ -28,10 +28,10 @@
children) processes. You are looking for the parent process. If you
run your server as root, you will easily locate it since it belongs to
root. If you run the server as some other user (when you L<don't have
-root access|guide::install/Installation_Without_Superuser_P>, the processes
-will belong to that user unless defined differently in I<httpd.conf>.
-It's still easy to find which is the parent--usually it's the process
-with the smallest PID.
+root access|guide::install/nstallation_Without_Superuser_Privileges>,
+the processes will belong to that user unless defined differently in
+I<httpd.conf>. It's still easy to find which is the parent--usually
+it's the process with the smallest PID.
You will see several C<httpd> processes running on your system, but you
should never need to send signals to any of them except the parent,
@@ -124,7 +124,7 @@
PerlFreshRestart On
Make sure you read L<Evil things might happen when using
-PerlFreshRestart|guide::troubleshooting/Evil_things_might_happen_when_us>.
+PerlFreshRestart|guide::troubleshooting/Evil_things_might_happen_when_using_PerlFreshRestart>.
=head1 Speeding up the Apache Termination and Restart
@@ -304,8 +304,8 @@
happened> message or perhaps a customized error message if you have
added code to trap and customize the errors. See L<Redirecting Errors
to the Client instead of to the
-error_log|guide::snippets/Redirecting_Errors_to_the_Client> for the latter
-case.
+error_log|guide::snippets/Redirecting_Errors_to_the_Client_Instead_of_error_log>
+for the latter case.
A much friendlier approach is to confess to your users that you are
doing some maintenance work and plead for patience, promising (keep
@@ -910,11 +910,11 @@
Often while developing new code, you will want to run the server in
single process mode. See L<Sometimes it works Sometimes it does
-Not|guide::porting/Sometimes_it_Works_Sometimes_it> and L<Names collisions
-with Modules and libs|guide::porting/Name_collisions_with_Modules_and>.
-Running in single process mode inhibits the server from "daemonizing",
-and this allows you to run it under the control of a debugger more
-easily.
+Not|guide::porting/Sometimes_it_Works__Sometimes_it_Doesn_t> and
+L<Names collisions with Modules and
+libs|guide::porting/Name_collisions_with_Modules_and_libs>. Running in
+single process mode inhibits the server from "daemonizing", and this
+allows you to run it under the control of a debugger more easily.
% /usr/local/sbin/httpd_perl/httpd_perl -X
@@ -1583,7 +1583,7 @@
For swapping monitoring techniques see the section 'L<Apache::VMonitor
-- Visual System and Apache Server
-Monitor|guide::debug/Apache_VMonitor_Visual_Syste>'.
+Monitor|guide::debug/Apache__VMonitor____Visual_System_and_Apache_Server_Monitor>'.
=head1 Preventing mod_perl Processes From Going Wild
1.4 +1 -1 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.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- debug.pod 27 Feb 2002 18:03:36 -0000 1.3
+++ debug.pod 28 Feb 2002 16:23:22 -0000 1.4
@@ -1323,7 +1323,7 @@
=head2 Apache::VMonitor -- Visual System and Apache Server Monitor
This module is covered in the section "L<Apache::*
-Modules|guide::modules/Apache_VMonitor_Visual_Syste>"
+Modules|guide::modules/Apache__VMonitor____Visual_System_and_Apache_Server_Monitor>"
=head1 Sometimes My Script Works, Sometimes It Does Not
1.4 +1 -1 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.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- help.pod 27 Feb 2002 18:03:36 -0000 1.3
+++ help.pod 28 Feb 2002 16:23:22 -0000 1.4
@@ -709,7 +709,7 @@
=item * Memory system management and architecture:
The Solaris memory system, sizing, tools and architecture:
-http://www.sun.com/solutions/third-party/global/SAS/pdf/vmsizing.pdf
+http://www.sun.com/sun-on-net/performance/vmsizing.pdf
=item *
1.6 +1 -1 modperl-docs/src/docs/2.0/api/mod_perl-2.0/APR/Table.pod
Index: Table.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/mod_perl-2.0/APR/Table.pod,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- Table.pod 15 Jan 2002 12:34:19 -0000 1.5
+++ Table.pod 28 Feb 2002 16:23:23 -0000 1.6
@@ -49,7 +49,7 @@
same key is requested, the whole table it lineary searched, which is
very inefficient unless the table is very small.
-C<APR::Table> provides a L<TIE Interface>.
+C<APR::Table> provides a L<TIE Interface|/TIE_Interface>.
See I<apr/include/apr_tables.h> in ASF's I<apr> project for low level
details.
1.13 +3 -3 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.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- testing.pod 27 Feb 2002 18:03:38 -0000 1.12
+++ testing.pod 28 Feb 2002 16:23:23 -0000 1.13
@@ -81,7 +81,7 @@
mode and send you back the report. It'll be much easier to understand
what the problem is if you get these debug printings from the user.
-In the section L</"Writing_Tests"> several helper functions which make
+In the section L<Writing Tests|/"Writing_Tests"> several helper functions
which make
the tests writing easier are discussed.
For more details about the C<Test::Harness> module please refer to its
@@ -676,7 +676,7 @@
=back
The debugging options I<-debug> and I<-breakpoint> are covered in the
-L</Debugging> section.
+L<Debugging Tests|/Debugging_Tests> section.
For a complete list of available switches see the output of C<t/TEST
-help>.
@@ -1211,7 +1211,7 @@
"testing TestApache::cool",
);
-See the L<Apache::TestUtil> manpage for more info on the t_cmp()
+See the C<Apache::TestUtil> manpage for more info on the t_cmp()
function (e.g. it works with regexs as well).
And the corresponding response part:
1.4 +6 -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.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- config.cfg 15 Jan 2002 12:34:19 -0000 1.3
+++ config.cfg 28 Feb 2002 16:23:23 -0000 1.4
@@ -31,5 +31,10 @@
)
],
-
+ group => 'Help',
+ chapters => [
+ qw(
+ help/help.pod
+ )
+ ],
);
1.3 +1 -1 modperl-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.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- email-etiquette.pod 27 Feb 2002 18:03:38 -0000 1.2
+++ email-etiquette.pod 28 Feb 2002 16:23:23 -0000 1.3
@@ -383,7 +383,7 @@
http://www.cpan.org/authors/id/S/ST/STAS/
-=head2 Corrections And Contributions
+=head2 Corrections and Contributions
Corrections and additions to the Guide are welcome. The original is
kept in .pod format, and it is converted to other formats by Perl
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
