You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs-cvs@perl.apache.org by st...@apache.org on 2002/04/03 10:07:16 UTC

cvs commit: modperl-docs/src/docs/1.0/win32 binaries.pod compile.pod multithread.pod

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 <pe...@skynet.be>
  
  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: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org