You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs-dev@perl.apache.org by Fred Moyer <fr...@taperfriendlymusic.org> on 2004/08/05 18:31:51 UTC
Suggestion for INSTALL doc
Greetings,
I've installed mp2 several times, always using the the INSTALL file as a
quick reference. Last night I dug into the docs to fine tune a production
installation and came across this gem of a link:
http://perl.apache.org/docs/2.0/user/install/install.html#Apache
The unescaped logs have been driving me nuts for the past few months. It
is my fault that I did not read the pod initially, but in case there are
other dorks out there like me I would like to suggest the following
addition to the INSTALL file.
--- INSTALL 2003-08-29 14:29:44.000000000 -0400
+++ INSTALL 2004-08-05 12:13:37.896644688 -0400
@@ -27,3 +27,7 @@
PerlModule Apache::compat
See docs/user/config/config.pod for details.
+
+If your error_log is unescaped using Apache >= 2.0.49 see this link
+
+http://perl.apache.org/docs/2.0/user/install/install.html#Apache
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: Suggestion for INSTALL doc
Posted by Stas Bekman <st...@stason.org>.
Fred Moyer wrote:
>>This is not going to work. Attempting to keep two sources in sync is
>>mad. I'd rather see INSTALL shrinking to:
>>
>>INSTALL:
>>Refer to docs/user/intro/start_fast.pod
>>or for more detailed documentation see:
>>docs/user/install/install.pod and docs/user/config/config.pod
>
>
> I think this approach would encourage users to read the docs rather than
> using the current INSTALL file as a cheat sheet, which is a bad habit I
> got into unfortunately.
Thanks Fred, I'll do that.
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: Suggestion for INSTALL doc
Posted by Fred Moyer <fr...@taperfriendlymusic.org>.
> This is not going to work. Attempting to keep two sources in sync is
> mad. I'd rather see INSTALL shrinking to:
>
> INSTALL:
> Refer to docs/user/intro/start_fast.pod
> or for more detailed documentation see:
> docs/user/install/install.pod and docs/user/config/config.pod
I think this approach would encourage users to read the docs rather than
using the current INSTALL file as a cheat sheet, which is a bad habit I
got into unfortunately.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: Suggestion for INSTALL doc
Posted by Stas Bekman <st...@stason.org>.
Fred Moyer wrote:
> Greetings,
>
> I've installed mp2 several times, always using the the INSTALL file as a
> quick reference. Last night I dug into the docs to fine tune a production
> installation and came across this gem of a link:
>
> http://perl.apache.org/docs/2.0/user/install/install.html#Apache
>
> The unescaped logs have been driving me nuts for the past few months. It
> is my fault that I did not read the pod initially, but in case there are
> other dorks out there like me I would like to suggest the following
> addition to the INSTALL file.
>
> --- INSTALL 2003-08-29 14:29:44.000000000 -0400
> +++ INSTALL 2004-08-05 12:13:37.896644688 -0400
> @@ -27,3 +27,7 @@
> PerlModule Apache::compat
>
> See docs/user/config/config.pod for details.
> +
> +If your error_log is unescaped using Apache >= 2.0.49 see this link
> +
> +http://perl.apache.org/docs/2.0/user/install/install.html#Apache
This is not going to work. Attempting to keep two sources in sync is
mad. I'd rather see INSTALL shrinking to:
INSTALL:
Refer to docs/user/intro/start_fast.pod
or for more detailed documentation see:
docs/user/install/install.pod and docs/user/config/config.pod
--
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org