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/general/os/win32 Changes.pod config.cfg faq.pod
Date Mon, 06 Jan 2003 22:21:36 GMT
randyk      2003/01/06 14:21:36

  Modified:    src/docs/1.0/os/win32 config.pod install.pod
               src/docs/2.0/os/win32 config.pod faq.pod install.pod
               src/docs/general config.cfg
  Added:       src/docs/general/os config.cfg
               src/docs/general/os/win32 Changes.pod config.cfg faq.pod
  Log:
  moved bulk of Win32 mod_perl faq to general/os/win32/
  
  Revision  Changes    Path
  1.7       +1 -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.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- config.pod	2 Jan 2003 07:56:04 -0000	1.6
  +++ config.pod	6 Jan 2003 22:21:35 -0000	1.7
  @@ -128,7 +128,7 @@
   Win32|docs::1.0::os::win32::install>, the L<mod_perl
   documentation|docs::index>, L<http://take23.org/>,
   and the
  -L<FAQs for mod_perl on Win32|docs::2.0::os::win32::faq>.
  +L<FAQs for mod_perl on Win32|docs::general::os::win32::faq>.
   Help is also available through the archives of and subscribing to
   the L<mod_perl mailing list|maillist::modperl>.
   
  
  
  
  1.22      +3 -3      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.21
  retrieving revision 1.22
  diff -u -r1.21 -r1.22
  --- install.pod	3 Jan 2003 16:48:43 -0000	1.21
  +++ install.pod	6 Jan 2003 22:21:35 -0000	1.22
  @@ -226,10 +226,10 @@
   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
  +L<http://theoryx5.uwinnipeg.ca/pub/other/> - see the file
   F<perl-win32-bin.readme> for a description. If you have trouble
   fetching the whole file at once, the directory
  -L<ftp://theoryx5.uwinnipeg.ca/pub/other/perl-win32-bin/>
  +L<http://theoryx5.uwinnipeg.ca/pub/other/perl-win32-bin/>
   contains this distribution split across multiple files -
   see F<README.join> for instructions on how to join them.
   Alternatively, if you have Perl already, you can get the script
  @@ -344,7 +344,7 @@
   Win32|docs::1.0::os::win32::config>, the L<mod_perl
   documentation|docs::index>, L<http://take23.org/>,
   and the
  -L<FAQs for mod_perl on Win32|docs::2.0::os::win32::faq>.
  +L<FAQs for mod_perl on Win32|docs::general::os::win32::faq>.
   Help is also available through the archives of and subscribing to
   the L<mod_perl mailing list|maillist::modperl>.
   
  
  
  
  1.10      +1 -1      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.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- config.pod	2 Jan 2003 07:56:04 -0000	1.9
  +++ config.pod	6 Jan 2003 22:21:35 -0000	1.10
  @@ -190,7 +190,7 @@
   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>.
  +L<FAQs for mod_perl on Win32|docs::general::os::win32::faq>.
   Help is also available through the archives of and subscribing to
   the L<mod_perl mailing list|maillist::modperl>.
   
  
  
  
  1.3       +3 -146    modperl-docs/src/docs/2.0/os/win32/faq.pod
  
  Index: faq.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/faq.pod,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- faq.pod	3 Jan 2003 04:43:05 -0000	1.2
  +++ faq.pod	6 Jan 2003 22:21:35 -0000	1.3
  @@ -5,156 +5,13 @@
   =head1 Description
   
   This document discusses some questions that arise often
  -with mod_perl on Win32.
  +with mod_perl 2.0 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, where F<perlxx.dll> is the Perl dll in your Perl I<bin> directory.
  -
  -=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 
  +The L<FAQs for mod_perl on Win32|docs::general::os::win32::faq>,
  +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
  
  
  
  1.20      +3 -3      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.19
  retrieving revision 1.20
  diff -u -r1.19 -r1.20
  --- install.pod	3 Jan 2003 16:48:43 -0000	1.19
  +++ install.pod	6 Jan 2003 22:21:35 -0000	1.20
  @@ -212,13 +212,13 @@
   
   =head2 All in one packages
   
  -At L<ftp://theoryx5.uwinnipeg.ca/pub/other/> there is a self-extracting
  +At L<http://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. If you have trouble
   fetching the whole file at once, the directory
  -L<ftp://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin/>
  +L<http://theoryx5.uwinnipeg.ca/pub/other/Perl-5.8-win32-bin/>
   contains this distribution split across multiple files -
   see F<README.join> for instructions on how to join them. Alternatively,
   if you have Perl already, you can get the script
  @@ -233,7 +233,7 @@
   documentation|docs::index>, 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>.  
  +L<FAQs for mod_perl on Win32|docs::general::os::win32::faq>.  
   Help is also available through the archives of and subscribing to
   the L<mod_perl mailing list|maillist::modperl>.
   
  
  
  
  1.10      +5 -0      modperl-docs/src/docs/general/config.cfg
  
  Index: config.cfg
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/general/config.cfg,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- config.cfg	31 Jul 2002 14:38:31 -0000	1.9
  +++ config.cfg	6 Jan 2003 22:21:35 -0000	1.10
  @@ -42,6 +42,11 @@
           perl_myth/perl_myth.pod
       )],
   
  +    group => 'OS Specific Decumentation',
  +    docsets => [qw(
  +        os
  +    )],
  +
       changes => 'Changes.pod',
   
   );
  
  
  
  1.1                  modperl-docs/src/docs/general/os/config.cfg
  
  Index: config.cfg
  ===================================================================
  use vars qw(@c);
  @c = (
      id => 'os_general',
  
      title => "OS-specific Info",
  
      abstract => <<EOB,
  Documents concerning OS-specific issues.
  EOB
  
      docsets => [qw(
          win32
      )],
  );
  
  
  
  1.1                  modperl-docs/src/docs/general/os/win32/Changes.pod
  
  Index: Changes.pod
  ===================================================================
  =head1 NAME
  
  Changes
  
  =head1 Description
  
  Refer to this document to learn what changes were made to the
  documents, since you've read these last time.
  
  The most recent changes are listed first.
  
  =head1 Mod Jan  1 16:05:30   SGT 2003
  
  * Addition of faq about GUI front ends
    [Terra Info E<lt>info@terranovum.comE<gt>]
  
  =head1 Mod Jan  1 15:40:30   SGT 2003
  
  * Make the os docset, containing the win32 chapter.
    [Randy Kobes E<lt>randy@theoryx5.uwinnipeg.caE<gt>]
  
  =cut
  
  
  
  1.1                  modperl-docs/src/docs/general/os/win32/config.cfg
  
  Index: config.cfg
  ===================================================================
  use vars qw(@c);
  @c = (
      id => 'win32_general',
  
      title => "Win32 Platforms",
      stitle => "Win32",
  
      abstract => <<EOB,
  mod_perl and related issues on Windows platforms
  EOB
  
      chapters => [qw(
          faq.pod
      )],
  
      changes => 'Changes.pod',
  
  );
  
  
  
  1.1                  modperl-docs/src/docs/general/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, where F<perlxx.dll> is the Perl dll in your Perl I<bin> directory.
  
  =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 I get an error about not being able to spawn a process for my CGI script.
  
  This means that the first line of your script (the I<shebang> line),
  
       #!/Path/to/Your/Perl/bin/Perl.exe
  
  is not pointing to the location of your Perl binary. Shebang lines are
  common in a Unix environment, where they are used to indicate with
  which program a script is to be run by, but are not normally used
  as such on Win32, except in this context within Apache.
  
  =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.
  
  =head2 Why can't my scripts execute external programs with GUI frontends from 
  within Apache/mod_perl?
  
  The issue is not an Apache/mod_perl issue per se. Any service that 
  allows execution of external binaries that try to initialize and display 
  GUI components will have problems under OSs like Windows 2K+, Unix, 
  Linux and MacOS X.
  This would have worked in Win 98 because apps all run in the same user 
  space (under the same user ID). Those resources happened to be, for the 
  most part, linked to almost everything else running on the system. Hence 
  when you ran a gui app from within Apache the system would display the 
  gui part of it on the screen. The OS saw no difference between the web 
  server running in the background and the user's desktop.
  The best way to deal with this is to see if the application you are 
  trying to run has a /quiet switch or something that will keep it from 
  trying to draw any GUI components/dialog boxes to the screen. If you 
  wrote the application you are trying to execute then you should put a 
  hook into it that will allow that option (obviously adding the code to 
  bypass the gui code) and then execute it with the new option. The best 
  way to execute programs under Perl's system call is to write a console 
  application. If you would like to take output from that application then 
  you should write to STDOUT all text you want the perl application to see 
  as a return value from your C<qx> or `` (backticks) call.
  
  =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