[mp2] Documentation patch for install.pod

[prev] [thread] [next] [Date index for 2005/02/14]

--vJguvTgX93MxBIIe
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

I finally took the plunge and installed mp2 onto my FreeBSD virtual
server. Here are a few updates to the install.pod which would have made
the installation process a bit easier for me.

I'm not sure about the modification I made at line ~617. I installed a
static mod_perl so presume that the server had to be rebuilt. When I
first read the recipe, it didn't make much sense that I would install
Apache then build mod_perl. The line I added helps clear it up. Does the
server also get rebuilt if compiling a dynamic mod_perl?


Thanks,
William

        -- 
        Knowmad Services Inc.
http://www.knowmad.com

--vJguvTgX93MxBIIe
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="install.pod.diff"

--- install.pod.orig	2005-02-13 09:18:58.000000000 -0500
+++ install.pod	2005-02-14 00:17:24.000000000 -0500
@@ -289,7 +289,11 @@
   % cd modperl-1.99_xx
   % perl Makefile.PL <options>
 
-where I<options> is an optional list of (key,value) pairs.
+where I<options> is an optional list of (key,value) pairs. These options can
+include all the usual options supported by ExtUtils::MakeMaker (e.g., PREFIX,
+LIB, etc.). This is particuarly useful when installing the Apache::* libraries
+to non-standard locations such as when doing non-root or virtual server
+installations.
 
 The following sections give the details about all the available
 options, but let's mention first an important one.
@@ -616,7 +620,8 @@
 
 =head2 Installing mod_perl
 
-Once the test suite has passed, it's a time to install mod_perl.
+Once the test suite has passed, it's a time to install mod_perl. This step
+will rebuild the Apache server.
 
   % make install
 
@@ -634,6 +639,18 @@
 installation process from scratch, while verifying all the steps with
 this document.
 
+=over
+
+=item *
+make test exists with "Error code 1" before any tests begin
+
+Be sure that you are not trying to run the tests as root. Log in as a regular
+user and be sure that user has rwx privileges to the files in the source
+directory.
+
+
+=back
+
 If the problem persists L<report the
 problem|docs::2.0::user::help::help/Reporting_Problems>.
 

--vJguvTgX93MxBIIe--