stas 02/04/03 00:07:16
Modified: src/docs/1.0/win32 binaries.pod compile.pod multithread.pod
Log:
normalize the case, change the titles slightly (we won't need underscored
titles for the documentation, normal ones are much more readable), and
corrected some minors things (reference to nmake, and changed some spacing
in examples to make it one long code section as is advised in style.pod).
PR: Obtained from: Submitted by: Per Einar Ellefsen <[EMAIL PROTECTED]>
Revision Changes Path
1.2 +15 -11 modperl-docs/src/docs/1.0/win32/binaries.pod
Index: binaries.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/win32/binaries.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- binaries.pod 20 Mar 2002 17:43:28 -0000 1.1
+++ binaries.pod 3 Apr 2002 08:07:16 -0000 1.2
@@ -1,14 +1,14 @@
=head1 NAME
-win32_binaries - obtaining Apache mod_perl-1.xx binaries for Win32
+Obtaining Apache mod_perl binaries for Win32
-=head1 DESCRIPTION
+=head1 Description
This document discusses the two major types of binary packages
available for Win32 mod_perl - all-in-one Perl/Apache/mod_perl
binaries, and mod_perl ppm (Perl Package Manager) packages.
-=head1 ALL-IN-ONE PACKAGES
+=head1 All-in-one packages
There are at least two binary packages for Win32 that contain the
necessary Perl and Apache binaries:
@@ -88,7 +88,7 @@
Win32 world it is particularly a good idea to use the latest version,
for bug and security fixes.
-=head1 CONFIGURATION
+=head1 Configuration
Add this line to F<C:\Apache\conf\httpd.conf>:
@@ -133,14 +133,14 @@
package Apache::Hello;
use strict;
use Apache::Constants qw(OK);
-
+
sub handler {
my $r = shift;
$r->send_http_header;
$r->print("<html><body>Hello World!</body></html>\n");
return OK;
}
-
+
1;
and save it in, for example, the F<C:\Perl\site\lib\Apache\>
@@ -159,18 +159,22 @@
will use C<Apache::Hello> to deliver the content.
-=head1 APACHE MODULES
+=head1 Apache modules
The C<theorxy5> repository containing the mod_perl ppm package also
contains a number of other Apache modules, such as C<Apache::ASP>,
C<HTML::Embperl>, and C<HTML::Mason>. However, there may be ones you
find that are not available through a repository; in such cases, you
might try sending a message to the maintainer of the repository asking
-if a particular package could be included, or you could use the
-C<CPAN.pm> module to fetch, build, and install the module - see
-C<perldoc CPAN> for details.
+if a particular package could be included.
+
+Alternatively, you can use the C<CPAN.pm> module to fetch, build, and
+install the module - see C<perldoc CPAN> for details. You will need 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).
-=head1 SEE ALSO
+=head1 See Also
The I<mod_perl> manpage, the L<Apache> manpage,
http://perl.apache.org/, especially the guide, http://take23.org/,
1.2 +17 -7 modperl-docs/src/docs/1.0/win32/compile.pod
Index: compile.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/win32/compile.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- compile.pod 20 Mar 2002 17:43:28 -0000 1.1
+++ compile.pod 3 Apr 2002 08:07:16 -0000 1.2
@@ -1,20 +1,30 @@
=head1 NAME
-win32_compile - Apache mod_perl-1.xx installation instructions for Win32
+Apache mod_perl-1.xx cpilation instructions for Win32
-=head1 DESCRIPTION
+=head1 Description
This document discusses how to build, test, configure and
install mod_perl under Win32.
-=head1 PREREQUISITES
+If you are only interested in running mod_perl, it might be a better idea
+to L<get and install one of the binary
+packages|docs::1.0::win32::binaries>.
-=over 3
+=head1 Prerequisites
+
+=over
+
+=item *
patience - mod_perl is considered alpha under Win32.
+=item *
+
MSVC++ 5.0+, Apache version 1.3-dev or higher and Perl 5.004_02 or higher.
+=item *
+
As of version 1.24_01, mod_perl will build on Win32 ActivePerls
based on Perl-5.6.x (builds 6xx). For binary compatibility you
should use the same compiler in building mod_perl that was used
@@ -22,7 +32,7 @@
=back
-=head1 BUILDING
+=head1 Building
Obtain the mod_perl sources from CPAN:
@@ -151,7 +161,7 @@
Apache and mod_perl header files, which can then be accessed
through the Apache::src module.
-=head1 CONFIGURATION
+=head1 Configuration
Add this line to F<C:\Apache\conf\httpd.conf>:
@@ -167,7 +177,7 @@
directives in the Apache documents for more details, especially
concerning the relative order of these and the C<LoadModule> directive.
-=head1 SEE ALSO
+=head1 See Also
The I<mod_perl> manpage, the L<Apache> manpage,
http://perl.apache.org/, especially the guide, and http://take23.org/.
1.2 +3 -3 modperl-docs/src/docs/1.0/win32/multithread.pod
Index: multithread.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/1.0/win32/multithread.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- multithread.pod 20 Mar 2002 17:43:29 -0000 1.1
+++ multithread.pod 3 Apr 2002 08:07:16 -0000 1.2
@@ -1,8 +1,8 @@
=head1 NAME
-win32_multithread - discussion of multithreading on Win32 mod_perl-1.xx
+Discussion of multithreading on Win32 mod_perl-1.xx
-=head1 DESCRIPTION
+=head1 Description
This document discusses the multithreading limitations of
mod_perl-1.xx on Win32.
@@ -111,7 +111,7 @@
package should be more or less covered. (A IIS-FastCGI accelerator is,
regrettably, no longer available.)
-=head1 SEE ALSO
+=head1 See ALso
http://perl.apache.org and http://httpd.apache.org, especially the
discussion of Apache-2 and modperl-2.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
