Bug 346554: Remove checksetup's checks for modules that are included with perl 5.8.0

Patch By Max Kanat-Alexander <mkanat@bugzilla.org> (module owner) r=colin for docs, a=myk

4 files changed, 54 insertions, 130 deletions

diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml
index 8de7be914..71d9fb8e3 100644
--- a/docs/en/xml/installation.xml
+++ b/docs/en/xml/installation.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.125 2008/04/04 06:47:55 mkanat%bugzilla.org Exp $ -->
+<!-- $Id: installation.xml,v 1.126 2008/04/04 06:47:56 mkanat%bugzilla.org Exp $ -->
 <chapter id="installing-bugzilla">
   <title>Installing Bugzilla</title>
 
@@ -293,12 +293,6 @@
 
         <listitem>
           <para>
-            Data::Dumper (&min-data-dumper-ver;)
-          </para>
-        </listitem>
-    
-        <listitem>
-          <para>
             Date::Format (&min-date-format-ver;)
           </para>
         </listitem>
@@ -330,12 +324,6 @@
 
         <listitem>
           <para>
-            File::Temp (&min-file-temp-ver;)
-          </para>
-        </listitem>
-
-        <listitem>
-          <para>
             <link linkend="install-modules-template">Template</link>
             (&min-template-ver;)
           </para>
@@ -343,12 +331,6 @@
 
         <listitem>
           <para>
-            Text::Wrap (&min-text-wrap-ver;)
-          </para>
-        </listitem>
-
-        <listitem>
-          <para>
             Mail::Mailer (&min-mail-mailer-ver;)
           </para>
         </listitem>
@@ -364,12 +346,6 @@
             MIME::Parser (&min-mime-parser-ver;)
           </para>
         </listitem>
-
-        <listitem>
-          <para>
-            Storable (&min-storable-ver;)
-          </para>
-        </listitem>
       </orderedlist>
 
       Optional Perl modules:
diff --git a/docs/en/xml/modules.xml b/docs/en/xml/modules.xml
index e2912d6a8..2e20bdc56 100644
--- a/docs/en/xml/modules.xml
+++ b/docs/en/xml/modules.xml
@@ -104,15 +104,6 @@
     </para>
 
     <para>
-      File::Temp:
-      <literallayout>
-        CPAN Download Page: <ulink url="http://search.cpan.org/dist/File-Temp/"/>
-        PPM Download Page: Part of core distribution.
-        Documentation: <ulink url="http://www.perldoc.com/perl5.8.0/lib/File/Temp.html"/>
-      </literallayout>
-    </para>
-
-    <para>
       Template-Toolkit:
       <literallayout>
         CPAN Download Page: <ulink url="http://search.cpan.org/dist/Template-Toolkit/"/>
@@ -122,15 +113,6 @@
     </para>
 
     <para>
-       Text::Wrap:
-      <literallayout>
-        CPAN Download Page: <ulink url="http://search.cpan.org/dist/Text-Tabs+Wrap/"/>
-        PPM Download Link: Part of core distribution.
-        Documentation: <ulink url="http://www.perldoc.com/perl5.8.0/lib/Text/Wrap.html"/>
-      </literallayout>
-    </para>
- 
-    <para>
       GD:
       <literallayout>
         CPAN Download Page: <ulink url="http://search.cpan.org/dist/GD/"/>
diff --git a/docs/en/xml/requiredsoftware.xml b/docs/en/xml/requiredsoftware.xml
index f32f0dc2f..4a751c0c7 100644
--- a/docs/en/xml/requiredsoftware.xml
+++ b/docs/en/xml/requiredsoftware.xml
@@ -6,59 +6,48 @@
   stay current for a while.</para>
 
   <para>Apache Web Server: 
-  <ulink url="http://www.apache.org/">http://www.apache.org</ulink>
+  <ulink url="http://www.apache.org/"/>
 
   Optional web server for Bugzilla, but recommended because of broad user
   base and support.</para>
 
   <para>Bugzilla: 
-  <ulink url="http://www.bugzilla.org/">
-  http://www.bugzilla.org/</ulink>
+  <ulink url="http://www.bugzilla.org/"/>
   </para>
 
   <para>MySQL: 
-  <ulink url="http://www.mysql.com/">http://www.mysql.com/</ulink>
+  <ulink url="http://www.mysql.com/"/>
   </para>
 
   <para>Perl: 
-  <ulink url="http://www.perl.org">http://www.perl.org/</ulink>
+  <ulink url="http://www.perl.org/"/>
   </para>
 
   <para>CPAN: 
-  <ulink url="http://www.cpan.org/">http://www.cpan.org/</ulink>
+  <ulink url="http://www.cpan.org/"/>
   </para>
 
   <para>DBI Perl module: 
-  <ulink url="http://www.cpan.org/modules/by-module/DBI/">
-  http://www.cpan.org/modules/by-module/DBI/</ulink>
-  </para>
-
-  <para>Data::Dumper module: 
-  <ulink url="http://www.cpan.org/modules/by-module/Data/">
-  http://www.cpan.org/modules/by-module/Data/</ulink>
+  <ulink url="http://www.cpan.org/modules/by-module/DBI/"/>
   </para>
 
   <para>MySQL related Perl modules: 
-  <ulink url="http://www.cpan.org/modules/by-module/Mysql/">
-  http://www.cpan.org/modules/by-module/Mysql/</ulink>
+  <ulink url="http://www.cpan.org/modules/by-module/Mysql/"/>
   </para>
 
   <para>TimeDate Perl module collection: 
-  <ulink url="http://www.cpan.org/modules/by-module/Date/">
-  http://www.cpan.org/modules/by-module/Date/</ulink>
+  <ulink url="http://www.cpan.org/modules/by-module/Date/"/>
   </para>
 
   <para>GD Perl module: 
-  <ulink url="http://www.cpan.org/modules/by-module/GD/">
-  http://www.cpan.org/modules/by-module/GD/</ulink>
+  <ulink url="http://www.cpan.org/modules/by-module/GD/"/>
 
   Alternately, you should be able to find the latest version of GD at 
-  <ulink url="http://www.boutell.com/gd/">http://www.boutell.com/gd/</ulink>
+  <ulink url="http://www.boutell.com/gd/"/>
   </para>
 
   <para>Chart::Base module: 
-  <ulink url="http://www.cpan.org/modules/by-module/Chart/">
-  http://www.cpan.org/modules/by-module/Chart/</ulink>
+  <ulink url="http://www.cpan.org/modules/by-module/Chart/"/>
   </para>
 
   <para>(But remember, Bundle::Bugzilla will install all the modules for you.)
@@ -80,7 +69,7 @@ sgml-local-ecat-files:nil
 sgml-minimize-attributes:nil
 sgml-namecase-general:t
 sgml-omittag:t
-sgml-parent-document:("Bugzilla-Guide.sgml" "book" "chapter")
+sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter")
 sgml-shorttag:t
 sgml-tag-region-if-active:t
 End:
diff --git a/docs/en/xml/troubleshooting.xml b/docs/en/xml/troubleshooting.xml
index 3500f5251..5905f964c 100644
--- a/docs/en/xml/troubleshooting.xml
+++ b/docs/en/xml/troubleshooting.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: troubleshooting.xml,v 1.4 2008/04/04 06:48:16 jake%bugzilla.org Exp $ -->
+<!-- $Id: troubleshooting.xml,v 1.12 2008/04/04 06:48:24 mkanat%bugzilla.org Exp $ -->
 
 <appendix id="troubleshooting">
 <title>Troubleshooting</title>
@@ -15,7 +15,7 @@
     completion, it normally explains what's wrong and how to fix it.
     If you can't work it out, or if it's being uncommunicative, post 
     the errors in the 
-    <ulink url="news://news.mozilla.org/netscape.public.mozilla.webtools">netscape.public.mozilla.webtools</ulink>
+    <ulink url="news://news.mozilla.org/mozilla.support.bugzilla">mozilla.support.bugzilla</ulink>
     newsgroup.
     </para>
 
@@ -29,6 +29,19 @@
     fix the problem. If not, see below for some commonly-encountered 
     errors. If that doesn't help, post the errors to the newsgroup.
     </para>
+
+    <para>
+      Bugzilla can also log all user-based errors (and many code-based errors)
+      that occur, without polluting the web server error log.  To enable
+      Bugzilla error logging, create a file that Bugzilla can write to, named
+      <filename>errorlog</filename>, in the Bugzilla <filename>data</filename>
+      directory.  Errors will be logged as they occur, and will include the type
+      of the error, the IP address and username (if available) of the user who
+      triggered the error, and the values of all environment variables; if a
+      form was being submitted, the data in the form will also be included.
+      To disable error logging, delete or rename the
+      <filename>errorlog</filename> file.
+    </para>
   </section>
         
   <section id="trbl-testserver">
@@ -69,24 +82,6 @@ TEST-OK Webserver is preventing fetch of http://landfill.bugzilla.org/bugzilla-t
       </listitem>
     </orderedlist>
   </section>
-    
-  <section id="trbl-bundleBugzilla">
-  <title>Bundle::Bugzilla makes me upgrade to Perl 5.6.1</title>
-
-    <para>Try executing <command>perl -MCPAN -e 'install CPAN'</command>
-    and then continuing.
-    </para>
-      
-    <para>Certain older versions of the CPAN toolset were somewhat naive about
-    how to upgrade Perl modules. When a couple of modules got rolled into the
-    core Perl distribution for 5.6.1, CPAN thought that the best way to get
-    those modules up to date was to haul down the Perl distribution itself and
-    build it. Needless to say, this has caused headaches for just about
-    everybody. Upgrading to a newer version of CPAN with the
-    commandline above should fix things.
-    </para>
-  </section>
-
 
   <section id="trbl-dbdSponge">
   <title>DBD::Sponge::db prepare failed</title>
@@ -144,49 +139,6 @@ TEST-OK Webserver is preventing fetch of http://landfill.bugzilla.org/bugzilla-t
     </para>
   </section>    
 
-  <section id="trouble-filetemp">
-  <title>Your vendor has not defined Fcntl macro O_NOINHERIT</title>
-
-    <para>This is caused by a bug in the version of
-    <productname>File::Temp</productname> that is distributed with perl
-    5.6.0. Many minor variations of this error have been reported:
-    </para>
-
-    <programlisting>Your vendor has not defined Fcntl macro O_NOINHERIT, used 
-at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 208.
-
-Your vendor has not defined Fcntl macro O_EXLOCK, used 
-at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 210.
-
-Your vendor has not defined Fcntl macro O_TEMPORARY, used 
-at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.</programlisting>
-
-    <para>Numerous people have reported that upgrading to version 5.6.1
-    or higher solved the problem for them. A less involved fix is to apply
-    the following patch, which is also
-    available as a <ulink url="../xml/filetemp.patch">patch file</ulink>.
-    </para>
-
-    <programlisting><![CDATA[--- File/Temp.pm.orig   Thu Feb  6 16:26:00 2003
-+++ File/Temp.pm        Thu Feb  6 16:26:23 2003
-@@ -205,6 +205,7 @@
-     # eg CGI::Carp
-     local $SIG{__DIE__} = sub {};
-     local $SIG{__WARN__} = sub {};
-+    local *CORE::GLOBAL::die = sub {};
-     $bit = &$func();
-     1;
-   };
-@@ -226,6 +227,7 @@
-     # eg CGI::Carp
-     local $SIG{__DIE__} = sub {};
-     local $SIG{__WARN__} = sub {};
-+    local *CORE::GLOBAL::die = sub {};
-     $bit = &$func();
-     1;
-   };]]></programlisting>
-  </section>
-
   <section id="trbl-relogin-everyone">
   <title>Everybody is constantly being forced to relogin</title>
   
@@ -261,7 +213,7 @@ at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.</programlisting>
     </para>
   </section>
 
-  <section>
+  <section id="trbl-relogin-some">
   <title>Some users are constantly being forced to relogin</title>
 
     <para>First, make sure cookies are enabled in the user's browser.
@@ -305,6 +257,31 @@ at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.</programlisting>
 
   </section>
 
+  <section id="trbl-passwd-encryption">
+    <title>
+      checksetup.pl reports "Client does not support authentication protocol
+      requested by server..."
+    </title>
+
+    <para>
+      This error is occurring because you are using the new password
+      encryption that comes with MySQL 4.1, while your
+      <filename>DBD::mysql</filename> module was compiled against an
+      older version of MySQL. If you recompile <filename>DBD::mysql</filename>
+      against the current MySQL libraries (or just obtain a newer version
+      of this module) then the error may go away.
+    </para>
+
+    <para>
+      If that does not fix the problem, or if you cannot recompile the
+      existing module (e.g. you're running Windows) and/or don't want to
+      replace it (e.g. you want to keep using a packaged version), then a
+      workaround is available from the MySQL docs:
+      <ulink url="http://dev.mysql.com/doc/mysql/en/Old_client.html"/>
+    </para>
+
+  </section>
+
 </appendix> 
 
 <!-- Keep this comment at the end of the file