Re: [mp2] Documentation patch for install.pod

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

William McKee wrote:
> 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 for the patch, William. See the comments below.

> --- 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.

committed the first part of it (those who know what options to use don't 
need extra explanation, those who don't know won't find the extra 
explanation sufficient).

>  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.

It's never the case. In the case of DSO it never happens. In the case of 
static build Apache server is built during 'make'.
as you say above, it's not the case with DSO.

>    % 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.

Why do you say so? It should work fine under root. If it doesn't, it 
should be fixed rather than documented. please follow the usual routine
as explained here: http://perl.apache.org/bugs/

        -- 
        __________________________________________________________________
Stas Bekman            JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/     mod_perl Guide ---> http://perl.apache.org
mailto:stas@xxxxxx.xxx http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org   http://ticketmaster.com