[EMAIL PROTECTED] wrote:
Hi Randy,
I wasn't closely following the win32 docs commits, but I've noticed a few things from this commit that I wanted to comment on.
The idea behind perl.apache.org/docs/ is to have a consistent documentation, with minimum duplication across different docs.
So rather than duplicating all the relevant docs for win32 I suggest to try hard to have only win32 specific material under win32/ and crossreference to the main docs where possible. In the long run this will keep the docs more maintainable. I hope that this is doable without ruining the win32 user's learning/referencing experience. What do you think? Comment below.
-Obtain the mod_perl sources from CPAN: - - http://www.cpan.org/authors/id/D/DO/DOUGM/mod_perl-1.xx.tar.gz - +Obtain the mod_perl sources (F<mod_perl-1.xx.tar.gz>) from CPAN +under L<http://www.cpan.org/authors/id/D/DO/DOUGM/>. When unpacked, using Winzip or similar tools, a subdirectory F<mod_perl-1.xx> will be created.
I'd rather point to http://perl.apache.org/download/, where the latest version is automatically linked to.
@@ -210,6 +203,20 @@
Apache and mod_perl header files, which can then be accessed
through the Apache::src module.
+If this build fails, you may want to try the sources obtained
+from cvs (you may also want to use the Apache cvs sources). +To do this, first obtain a Win32 cvs client from, for example,
+L<http://www.cvshome.org/>. The cvs sources may be obtained as
+
+ C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login
+ C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co apache-1.3
+ C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl
+
+The build then proceeds as above. Be aware, though,
+that as well as providing bug fixes, there may be new features being
+added and tested in the cvs versions, so at any given time there are
+no guarantees that these packages will build and test successfully.
+
=head1 Binaries
Any reason to duplicate docs? We already have this documented at: http://perl.apache.org/download/source.html#Development_Source_Distribution
discussion of Apache-2 and modperl-2.
Can we please have consistently Apache 2.0 and mod_perl 2.0? Notice that Apache 2.1 is not the same as Apache 2.0, so Apache-2 is definitely not a good choice.
Having built and installed Apache 2.0, next obtain the mod_perl 2.0 -sources from http://www.cpan.org/authors/id/D/DO/DOUGM/. After +sources (F<mod_perl-1.99_xx>) +from L<http://www.cpan.org/authors/id/D/DO/DOUGM/>. After unpacking, run the command
Same here, better point to perl.apache.org/download/
C:\modperl_src> perl Makefile.PL MP_AP_PREFIX=\Path\to\Apache2
@@ -106,7 +107,7 @@
official releases, you may want to try the sources obtained
from cvs (it is a good idea to also use the cvs httpd-2.0 sources).
To do this, first obtain a Win32 cvs client from, for example,
-http://www.cvshome.org/. The cvs sources may be obtained as
+L<http://www.cvshome.org/>. The cvs sources may be obtained as
C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login
C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co httpd-2.0
@@ -127,8 +128,8 @@
similar as for 1.3, a pointer to /download/ would be better.
If things change, we need to adjust only one place and all the docs already point to the latest info.
__________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
