randyk 2002/12/28 12:35:28
Modified: src/docs/1.0/os/win32 config.pod install.pod multithread.pod
src/docs/2.0/os/win32 config.pod install.pod
Log:
link fixes, and pointer to new perl-5.8 Win32 binary
Revision Changes Path
1.5 +4 -2 modperl-docs/src/docs/1.0/os/win32/config.pod
Index: config.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/config.pod,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- config.pod 18 Nov 2002 17:35:42 -0000 1.4
+++ config.pod 28 Dec 2002 20:35:27 -0000 1.5
@@ -120,13 +120,15 @@
the B<nmake> utility for this, download it from
http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe
(it's a self extracting archive, so run it and then copy the files
-into your F<Windows> directory).
+to somewhere in your I<PATH> environment variable).
=head1 See Also
The directions for L<installing mod_perl 1.0 on
Win32|docs::1.0::os::win32::install>, the L<mod_perl
-documentation|docs::index>, and http://take23.org/.
+documentation|docs::index>, L<http://take23.org/>.
+Help is also available through the archives of and subscribing to
+the L<mod_perl mailing list|maillist::modperl>.
=head1 Maintainers
1.16 +35 -30 modperl-docs/src/docs/1.0/os/win32/install.pod
Index: install.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/install.pod,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- install.pod 21 Dec 2002 07:26:16 -0000 1.15
+++ install.pod 28 Dec 2002 20:35:27 -0000 1.16
@@ -6,25 +6,21 @@
This document discusses how to install mod_perl 1.0 under Win32, both
in building from sources and in installing pre-compiled binary
-packages. Unless you are using an all-in-one package, you should
-first install Perl and Apache, either from the sources or as binaries.
-The Perl sources are available from
+packages.
- http://www.cpan.org/src/
+=head1 Synopsis
+Unless you are using an all-in-one package, you should
+first install Perl and Apache, either from the sources or as binaries.
+The Perl sources are available from L<http://www.cpan.org/src/>,
with directions for building contained in F<README.win32>.
ActiveState also makes the sources available for their binary
-builds at
-
- ftp://ftp.activestate.com/ActivePerl/src/
-
+builds at L<ftp://ftp.activestate.com/ActivePerl/src/>,
which may contain, in particular, Win32-specific fixes not in the
CPAN Perl sources. As a binary, at present, an ActivePerl-compatible
Perl, compiled with Visual C++, is the most common one used in the Win32
mod_perl/Apache environment; you can obtain such a prebuilt Perl
-binary from
-
- http://www.activestate.com/
+binary from L<http://www.activestate.com/>.
Note that, currently, mod_perl 1.0 does not work with an
ActivePerl Perl in the 8xx series (based on perl-5.8), due
@@ -40,8 +36,7 @@
for details.
The Apache sources and binaries are available at
-
- http://httpd.apache.org/
+L<http://httpd.apache.org/>.
When installing Perl or other related binaries, subtleties may arise
in using path names that have spaces in them - you may, for example,
@@ -78,10 +73,8 @@
=back
-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.
@@ -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
There are two major types of binary packages
@@ -219,11 +226,11 @@
=head2 All-in-one packages
There are at least two binary packages for Win32 that contain the
-necessary Perl and Apache binaries:
-
- http://www.indigostar.com/
-
- ftp://theoryx5.uwinnipeg.ca/pub/other/perl-win32-bin.exe
+necessary Perl and Apache binaries: IndigoPerl from
+L<http://www.indigostar.com/>, and the self-extracting archive
+F<perl-win32-bin.exe> from
+L<ftp://theoryx5.uwinnipeg.ca/pub/other/> (see the file
+F<perl-win32-bin.readme> for a description).
As well as including a number of non-core modules, both of these
packages contain mod_perl. See the documentation on the web sites and
@@ -241,16 +248,12 @@
=head2 PPM Packages
For users of ActivePerl builds 6xx I<only>, obtainable from
-
- http://www.activestate.com/
-
+L<http://www.activestate.com/>,
there are also C<PPM> mod_perl packages available (as discussed
in the introduction, no C<ppm> mod_perl-1 ppm packages for
ActivePerl builds 8xx are presently available). For this, if you
don't already have it, get and install the latest Win32 Apache binary
-from
-
- http://httpd.apache.org/
+from L<http://httpd.apache.org/>.
Both ActivePerl and Apache binaries are available as C<MSI> files for
use by the Microsoft Installer - as discussed on the ActiveState site,
@@ -309,7 +312,7 @@
offer to copy this file to your Apache modules directory (eg,
I<C:\Apache\modules>). This might not occur with C<ppm3>, in
which case you can grab F<mod_perl.tar.gz> from
-http://theoryx5.uwinnipeg.ca/ppmpackages/x86/; when
+L<http://theoryx5.uwinnipeg.ca/ppmpackages/x86/>; when
unpacked, this will contain F<mod_perl.so> in the top-level
directory.
@@ -331,7 +334,9 @@
The directions for L<configuring mod_perl 1.0 on
Win32|docs::1.0::os::win32::config>, the L<mod_perl
-documentation|docs::index>, and http://take23.org/.
+documentation|docs::index>, L<http://take23.org/>.
+Help is also available through the archives of and subscribing to
+the L<mod_perl mailing list|maillist::modperl>.
=head1 Maintainers
1.4 +4 -1 modperl-docs/src/docs/1.0/os/win32/multithread.pod
Index: multithread.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/os/win32/multithread.pod,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- multithread.pod 15 Dec 2002 17:36:38 -0000 1.3
+++ multithread.pod 28 Dec 2002 20:35:27 -0000 1.4
@@ -102,8 +102,11 @@
=head1 See Also
-http://perl.apache.org and http://httpd.apache.org, especially the
+The L<mod_perl
+documentation|docs::index> and L<http://httpd.apache.org/>, especially the
discussion of Apache-2 and modperl-2.
+Help is also available through the archives of and subscribing to
+the L<mod_perl mailing list|maillist::modperl>.
=head1 Maintainers
1.8 +5 -5 modperl-docs/src/docs/2.0/os/win32/config.pod
Index: config.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/config.pod,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- config.pod 18 Nov 2002 17:35:42 -0000 1.7
+++ config.pod 28 Dec 2002 20:35:28 -0000 1.8
@@ -186,11 +186,11 @@
The directions for L<installing mod_perl 2.0 on
Win32|docs::2.0::os::win32::install>, the L<mod_perl
-documentation|docs::index>, http://perl.apache.org/,
-http://take23.org/, http://httpd.apache.org/, and
-http://www.activestate.com/. Help on setting up and configuring
-mod_perl 2.0 can be found by subscribing to the mod_perl mailing list,
-details of which are at http://perl.apache.org/.
+documentation|docs::index>, L<http://perl.apache.org/>,
+L<http://take23.org/>, L<http://httpd.apache.org/>, and
+L<http://www.activestate.com/>.
+Help is also available through the archives of and subscribing to
+the L<mod_perl mailing list|maillist::modperl>.
=head1 Maintainers
1.14 +31 -49 modperl-docs/src/docs/2.0/os/win32/install.pod
Index: install.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/install.pod,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- install.pod 21 Dec 2002 07:26:16 -0000 1.13
+++ install.pod 28 Dec 2002 20:35:28 -0000 1.14
@@ -6,39 +6,39 @@
This document deals with installation specifics on Win32 platforms.
+=head1 Synopsis
+
As described in the discussion of issues in L<multithreaded
win32|docs::1.0::os::win32::multithread>, a mod_perl 1.0 enabled server
based on Apache 1.3 on Win32 is limited to a single thread serving a
request at a time. This effectively prevents concurrent processing,
which can have serious implications for busy sites. This problem is
addressed in the multi-thread/multi-process approach of mod_perl
-2.0/Apache 2.0. This document discusses how to obtain mod_perl 2.0.
+2.0/Apache 2.0.
+
+Note that there are some threading issues in perl-5.6
+(upon which ActivePerl builds 6xx are based) which may cause
+problems with mod_perl-2. Because of this, it is (I<strongly>)
+recommended
+that perl-5.8 (ActivePerl builds 8xx) be used with mod_perl-2
+on Win32.
=head1 Installing
Unless you are using an all-in-one package, you should
first install Perl and Apache, either from the sources or as binaries.
-The Perl sources are available from
-
- http://www.cpan.org/src/
-
+The Perl sources are available from L<http://www.cpan.org/src/>,
with directions for building contained in F<README.win32>.
ActiveState also makes the sources available for their binary
-builds at
-
- ftp://ftp.activestate.com/ActivePerl/src/
-
+builds at L<ftp://ftp.activestate.com/ActivePerl/src/>,
which may contain, in particular, Win32-specific fixes not in the
CPAN Perl sources. As a binary, at present, an ActivePerl-compatible
Perl, compiled with Visual C++, is the most common one used in the Win32
mod_perl/Apache environment; you can obtain such a prebuilt Perl
-binary from
-
- http://www.activestate.com/
+binary from L<http://www.activestate.com/>.
The Apache sources and binaries are available at
-
- http://httpd.apache.org/
+L<http://httpd.apache.org/>.
As of this writing, mod_perl-2 is known to compile and work
with an ActivePerl-compatible Perl, both for builds 6xx, based
@@ -64,13 +64,14 @@
If you are building mod_perl 2.0 from sources, it is probably also
best to do the same for Apache 2.0. The Apache 2.0 sources can be
-obtained from http://httpd.apache.org/, which when unpacked will
+obtained from L<http://httpd.apache.org/>, which when unpacked will
contain at the top-level a Visual Studio project file. Choose the
C<InstallBin - Win32 Release> target to build and install Apache 2.0,
which by default will be placed in F</Apache2>.
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
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 @@
The first, for ActivePerl users, is through C<PPM> - this assumes you
already have ActivePerl (build 8xx is recommended) from
-http://www.activestate.com/ and a Win32 Apache 2.0 binary from
-http://httpd.apache.org/. In installing this, you might avoid
+L<http://www.activestate.com/> and a Win32 Apache 2.0 binary from
+L<http://httpd.apache.org/>. In installing this, you might avoid
some future problems by choosing installation directories that do
not have spaces in their names (eg, F<C:/Apache2>).
@@ -194,9 +195,9 @@
offer to copy this file to your Apache2 modules directory (eg,
F<C:/Apache2/modules/>). If this is not done, get either
F<mod_perl-2.tar.gz> from
-http://theoryx5.uwinnipeg.ca/ppmpackages/x86/, for builds 6xx, or
+L<http://theoryx5.uwinnipeg.ca/ppmpackages/x86/>, for builds 6xx, or
F<mod_perl.tar.gz> from
-http://theoryx5.uwinnipeg.ca/ppms/x86/, for builds 8xx;
+L<http://theoryx5.uwinnipeg.ca/ppms/x86/>, for builds 8xx;
when unpacked, this file
contains F<mod_perl.so> in the top-level directory.
@@ -221,29 +222,11 @@
=item Apache/mod_perl binary
-At ftp://theoryx5.uwinnipeg.ca/pub/other/ one can find an archive
-F<Apache2.tar.gz> containing a binary version of Apache 2.0/mod_perl
-2.0 - see the F<Apache2.readme> file for further information. This
-archive unpacks into an F<Apache2> directory, underneath which is a
-F<blib> subdirectory containing the necessary mod_perl files (enabled
-with a C<PerlSwitches> directive in F<httpd.conf>). Some editing of
-F<httpd.conf> will be necessary to reflect the location of the
-installed directory.
-
-This package, which is updated periodically, is compiled against
-recent cvs sources of Apache 2.0 and mod_perl 2.0. As such, it may
-contain features, and bugs, not present in the current official
-releases. Also for this reason, these may not be binary compatible
-with other versions of Apache 2.0/mod_perl 2.0.
-
-As well, at ftp://theoryx5.uwinnipeg.ca/pub/other/ there is an
-archive F<perl-5.8-win32-bin.tar.gz> containing a binary version
-of a release candidate of perl-5.8, together with Apache 2.0
-and mod_perl 2.0. Installation instructions are contained in
-the file F<perl-5.8-win32-bin.readme>. Although at this time
-perl-5.8 is not yet stable, you may be interested in previewing
-it, as once it is stable, this will be the recommended Perl version
-for use with Win32 mod_perl 2.0.
+At L<ftp://theoryx5.uwinnipeg.ca/pub/other/> there is a self-extracting
+archive F<Perl-5.8-win32-bin.exe> containing a binary version
+of perl-5.8 (compatible with ActivePerl 8xx), together with Apache 2.0
+and mod_perl 2.0. See the file F<Perl-5.8-win32-bin.readme> for
+a description.
=back
@@ -251,11 +234,10 @@
The directions for L<configuring mod_perl 2.0 on
Win32|docs::2.0::os::win32::config>, the L<mod_perl
-documentation|docs::index>, http://take23.org/,
-http://httpd.apache.org/, and http://www.activestate.com/. Help on
-setting up and configuring mod_perl 2.0 can be found by subscribing to
-the mod_perl mailing list, details of which are at
-http://perl.apache.org/.
+documentation|docs::index>, L<http://take23.org/>,
+L<http://httpd.apache.org/>, and L<http://www.activestate.com/>.
+Help is also available through the archives of and subscribing to
+the L<mod_perl mailing list|maillist::modperl>.
=head1 Maintainers
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
