perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ran...@apache.org
Subject cvs commit: modperl-docs/src/docs/2.0/os/win32 faq.pod config.cfg config.pod install.pod
Date Thu, 02 Jan 2003 07:56:04 GMT
randyk      2003/01/01 23:56:04

  Modified:    src/docs/1.0/os/win32 config.pod install.pod
               src/docs/2.0/os/win32 config.cfg config.pod install.pod
  Added:       src/docs/2.0/os/win32 faq.pod
  Log:
  added win32 faq
  
  Revision  Changes    Path
  1.6       +3 -1      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.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- config.pod	28 Dec 2002 20:35:27 -0000	1.5
  +++ config.pod	2 Jan 2003 07:56:04 -0000	1.6
  @@ -126,7 +126,9 @@
   
   The directions for L<installing mod_perl 1.0 on
   Win32|docs::1.0::os::win32::install>, the L<mod_perl
  -documentation|docs::index>, L<http://take23.org/>.
  +documentation|docs::index>, L<http://take23.org/>,
  +and the
  +L<FAQs for mod_perl on Win32|docs::2.0::os::win32::faq>.
   Help is also available through the archives of and subscribing to
   the L<mod_perl mailing list|maillist::modperl>.
   
  
  
  
  1.18      +3 -1      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.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- install.pod	31 Dec 2002 19:24:25 -0000	1.17
  +++ install.pod	2 Jan 2003 07:56:04 -0000	1.18
  @@ -334,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>, L<http://take23.org/>.
  +documentation|docs::index>, L<http://take23.org/>,
  +and the
  +L<FAQs for mod_perl on Win32|docs::2.0::os::win32::faq>.
   Help is also available through the archives of and subscribing to
   the L<mod_perl mailing list|maillist::modperl>.
   
  
  
  
  1.8       +1 -0      modperl-docs/src/docs/2.0/os/win32/config.cfg
  
  Index: config.cfg
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/config.cfg,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- config.cfg	21 Dec 2002 07:26:16 -0000	1.7
  +++ config.cfg	2 Jan 2003 07:56:04 -0000	1.8
  @@ -12,6 +12,7 @@
       chapters => [qw(
           install.pod
           config.pod
  +        faq.pod
       )],
   
       copy_glob => [qw(
  
  
  
  1.9       +4 -2      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.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- config.pod	28 Dec 2002 20:35:28 -0000	1.8
  +++ config.pod	2 Jan 2003 07:56:04 -0000	1.9
  @@ -187,8 +187,10 @@
   The directions for L<installing mod_perl 2.0 on
   Win32|docs::2.0::os::win32::install>, the L<mod_perl
   documentation|docs::index>, L<http://perl.apache.org/>,
  -L<http://take23.org/>, L<http://httpd.apache.org/>, and
  -L<http://www.activestate.com/>.  
  +L<http://take23.org/>, L<http://httpd.apache.org/>,
  +L<http://www.activestate.com/>,
  +and the
  +L<FAQs for mod_perl on Win32|docs::2.0::os::win32::faq>.
   Help is also available through the archives of and subscribing to
   the L<mod_perl mailing list|maillist::modperl>.
   
  
  
  
  1.16      +3 -1      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.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- install.pod	31 Dec 2002 19:24:25 -0000	1.15
  +++ install.pod	2 Jan 2003 07:56:04 -0000	1.16
  @@ -223,7 +223,9 @@
   The directions for L<configuring mod_perl 2.0 on
   Win32|docs::2.0::os::win32::config>, the L<mod_perl
   documentation|docs::index>, L<http://take23.org/>,
  -L<http://httpd.apache.org/>, and L<http://www.activestate.com/>.  
  +L<http://httpd.apache.org/>, L<http://www.activestate.com/>,
  +and the
  +L<FAQs for mod_perl on Win32|docs::2.0::os::win32::faq>.  
   Help is also available through the archives of and subscribing to
   the L<mod_perl mailing list|maillist::modperl>.
   
  
  
  
  1.1                  modperl-docs/src/docs/2.0/os/win32/faq.pod
  
  Index: faq.pod
  ===================================================================
  =head1 NAME
  
  Frequently asked questions for mod_perl on Win32
  
  =head1 Description
  
  This document discusses some questions that arise often
  with mod_perl on Win32.
  
  =head1 Obtaining mod_perl
  
  =head2 Do I need Perl to use mod_perl?
  
  Yes, Perl is required. You can obtain a Win32 Perl
  binary from L<http://www.activestate.com/>. See also
  the all-in-one binary packages for both
  L<mod_perl 1.0|docs::1.0::os::win32::install/All_in_one_packages>
  and
  L<mod_perl 2.0|docs::2.0::os::win32::install/All_in_one_packages>
  which include Perl, Apache, and mod_perl.
  
  =head2 Are mod_perl ppm packages available?
  
  PPM packages for both
  L<mod_perl 1.0|docs::1.0::os::win32::install/PPM_Packages>
  and 
  L<mod_perl 2.0|docs::2.0::os::win32::install/PPM_Packages>
  are available.
  
  =head2 Should I use mod_perl 1.0 or mod_perl 2.0?
  
  L<mod_perl 1.0|docs::1.0::guide::intro>, for use with Apache 1.0, 
  is stable and well tested, while 
  L<mod_perl 2.0|docs::2.0::user::intro::overview>, for use with 
  Apache 2.0, is in a development stage. Normally, therefore, one
  would recommend mod_perl 2.0 only in a testing and development
  environment. However, on Win32 mod_perl 1.0 is subject to some serious
  L<threading limitations|docs::1.0::os::win32::multithread>
  which are overcome with mod_perl 2.0; this, coupled
  with the improved performance of Apache 2.0 on Win32, may
  make mod_perl 2.0 a better choice.
  
  =head1 Installing mod_perl
  
  =head2 I get an "unable to load mod_perl.so" error when starting
  Apache.
  
  This can be due to a number of reasons.
  
  =over 
  
  =item Verify that mod_perl.so was compiled against the same Perl and Apache
  versions that you are using.
  
  =item Check that the directory containing C<perl.exe> is in your I<PATH> environment
variable.
  
  =item Try inserting a directive
  
     LoadFile "C:/Path/to/your/Perl/bin/perlxx.dll"
  
  before the
  
     LoadModule perl_module modules/mod_perl.so
  
  directive.
  
  =item Try a reboot.
  
  =back
  
  =head2 How do I set the PATH environment variable?
  
  This differs according to the flavour of Win32 you are using.
  Search for I<set PATH environment> within the Windows
  Help utility under the Start menu for instructions.
  
  =head1 Configuring mod_perl
  
  =head2 How do I know scripts are running under mod_perl?
  
  You can test this by using a script which prints out the
  L<environment
  variables|docs::1.0::guide::install/Testing_via_a_CGI_script>; 
  note that for mod_perl 2.0 a slightly L<different
  configuration|docs::2.0::os::win32::config/Registry_scripts>
  is required.
  
  =head2 My script gets returned as plain text.
  
  See the discussion of configuring 
  L<Apache::Registry|docs::1.0::guide::config/My_CGI_Perl_Code_Gets_Returned_as_Plain_Text_Instead_of_Being_Executed_by_the_Webserver>;
for mod_perl 2.0, a
  L<different
  configuration|docs::2.0::user::compat::compat/The_C_Apache__Registry__Family>
  is required.
  
  =head2 I get a "Save-As" dialogue box when calling a script.
  
  See the discussion about 
  L<PerlSendHeader|docs::1.0::guide::config/My_Script_Works_under_mod_cgi__but_when_Called_via_mod_perl_I_Get_a__Save_As__Prompt>;
note that for mod_perl 2.0, 
  there is a L<different
  syntax|docs::2.0::user::compat::compat/C_PerlSendHeader_>.
  
  =head2 My script displays a "Content-type" header in the browser.
  
  Check the setting of 
  L<PerlSendHeader|docs::1.0::guide::porting/Generating_correct_HTTP_Headers>;
  note that for mod_perl 2.0, there is a L<different
  syntax|docs::2.0::user::compat::compat/C_PerlSendHeader_>.
  
  =head1 Using mod_perl
  
  =head2 One request must finish before another is processed.
  
  You are probably running into 
  L<multithreading limitations|docs::1.0::os::win32::multithread>
  of mod_perl 1.0; if this is a major problem, you should 
  consider using
  L<mod_perl 2.0|docs::2.0::os::win32::install>.
  
  =head2 My script just hangs.
  
  You should check the setting of 
  L<PerlSendHeader|docs::1.0::guide::porting/Generating_correct_HTTP_Headers>;
  for mod_perl 2.0, there is a L<different
  syntax|docs::2.0::user::compat::compat/C_PerlSendHeader_>.
  If this setting is correct, and
  this occurs under mod_perl 2.0 and
  Perl-5.6.1, try upgrading to
  L<Perl-5.8.0|docs::2.0::os::win32::install>.
  
  =head2 How do I run ASP scripts?
  
  For a mod_perl solution, check L<http://www.apache-asp.org/>
  for a discussion of the Apache::ASP module.
  
  =head2 How do I install additional Apache modules?
  
  If these aren't available via ppm from the repositories
  for 
  L<mod_perl 1.0|docs::1.0::os::win32::install/PPM_Packages>
  or
  L<mod_perl 2.0|docs::2.0::os::win32::install/PPM_Packages>,
  you can build them using the
  L<CPAN.pm|docs::1.0::os::win32::config/Apache_modules>
  module.
  
  =head1 See Also
  
  The discussion of 
  L<frequent mod_perl problems|docs::1.0::guide::frequent>,
  the L<troubleshooting index|docs::1.0::guide::troubleshooting>,
  L<debugging mod_perl|docs::1.0::guide::debug>, and
  a L<troubleshooting guide for mod_perl 
  2.0|docs::2.0::user::troubleshooting::troubleshooting>.
  Help is also available through the archives of and subscribing to
  the L<mod_perl mailing list|maillist::modperl>; you will
  probably find the
  L<guide to getting help|docs::1.0::guide::help>
  useful reading beforehand.
  
  =head1 Maintainers
  
  Maintainer is the person(s) you should contact with updates,
  corrections and patches.
  
  =over
  
  =item * 
  
  Randy Kobes E<lt>randy@theoryx5.uwinnipeg.caE<gt>
  
  =back
  
  
  =head1 Authors
  
  =over
  
  =item *
  
  Randy Kobes E<lt>randy@theoryx5.uwinnipeg.caE<gt>
  
  =back
  
  Only the major authors are listed above. For contributors see the
  Changes file.
  
  =cut
  
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org


Mime
View raw message