Bug 171674 - Adding a section to the Troubleshooting section describing how to fix...

diff --git a/docs/sgml/filetemp.patch b/docs/sgml/filetemp.patch
new file mode 100644 (file)
index 0000000..9fb70ad
--- /dev/null
+++ b/docs/sgml/filetemp.patch
@@ -0,0 +1,18 @@
+--- 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;
+   };

diff --git a/docs/sgml/installation.sgml b/docs/sgml/installation.sgml
index 1ebe0bcb1db1d2862ee8ed349bad85903e08cd4f..9b4518e0f4414b1446b224bed3874e751a2b220c 100644 (file)
--- a/docs/sgml/installation.sgml
+++ b/docs/sgml/installation.sgml
@@ -1995,6 +1995,62 @@ binmode(STDOUT);
       as root to fix this problem.
       </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. Examples
+      can be found in <xref linkend="trouble-filetemp-errors"/>.
+      </para>
+
+      <figure id="trouble-filetemp-errors">
+        <title>Other File::Temp error messages</title>
+
+        <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>
+      </figure>
+
+      <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 patch in <xref linkend="trouble-filetemp-patch"/>. The patch is also
+      available as a <ulink url="../sgml/filetemp.patch">patch file</ulink>.
+      </para>
+
+      <figure id="trouble-filetemp-patch">
+        <title>Patch for File::Temp in Perl 5.6.0</title>
+
+        <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>
+      </figure>
+    </section>
   </section>
 </chapter>
 

diff --git a/docs/xml/filetemp.patch b/docs/xml/filetemp.patch
new file mode 100644 (file)
index 0000000..9fb70ad
--- /dev/null
+++ b/docs/xml/filetemp.patch
@@ -0,0 +1,18 @@
+--- 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;
+   };

diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml
index 1ebe0bcb1db1d2862ee8ed349bad85903e08cd4f..9b4518e0f4414b1446b224bed3874e751a2b220c 100644 (file)
--- a/docs/xml/installation.xml
+++ b/docs/xml/installation.xml
@@ -1995,6 +1995,62 @@ binmode(STDOUT);
       as root to fix this problem.
       </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. Examples
+      can be found in <xref linkend="trouble-filetemp-errors"/>.
+      </para>
+
+      <figure id="trouble-filetemp-errors">
+        <title>Other File::Temp error messages</title>
+
+        <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>
+      </figure>
+
+      <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 patch in <xref linkend="trouble-filetemp-patch"/>. The patch is also
+      available as a <ulink url="../sgml/filetemp.patch">patch file</ulink>.
+      </para>
+
+      <figure id="trouble-filetemp-patch">
+        <title>Patch for File::Temp in Perl 5.6.0</title>
+
+        <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>
+      </figure>
+    </section>
   </section>
 </chapter>