From 9665c0e6a0ee98cdd113e11b86d3efab474464c0 Mon Sep 17 00:00:00 2001
From: "jake%bugzilla.org" <>
Date: Thu, 27 Mar 2003 08:06:37 +0000
Subject: Bug 196433 - Bugzilla now uses /usr/bin/perl as the shebang line
 r=justdave a=justdave

---
 docs/xml/faq.xml | 42 ++++++++++++++++++++++++++++++------------
 1 file changed, 30 insertions(+), 12 deletions(-)

(limited to 'docs/xml/faq.xml')

diff --git a/docs/xml/faq.xml b/docs/xml/faq.xml
index df80794cd..d0f78b75a 100644
--- a/docs/xml/faq.xml
+++ b/docs/xml/faq.xml
@@ -204,25 +204,43 @@
       <qandaentry>
 	<question id="faq-general-bonsaitools">
 	  <para>
-	    Why do the scripts say "/usr/bonsaitools/bin/perl" instead of
-	    "/usr/bin/perl" or something else?
+	    What is <filename>/usr/bonsaitools/bin/perl</filename>?
 	  </para>
 	</question>
 	<answer>
 	  <para>
-	     Mozilla.org uses /usr/bonsaitools/bin/perl, because originally
-       Terry wanted a place to put a version of Perl and other tools 
-       that was strictly under his control. 
-    </para>
-		<para>
-		  We always recommend that, if possible, you keep the path
-		  as /usr/bonsaitools/bin/perl, and simply add symlink.  
-      This will make upgrading
-		  your Bugzilla much easier in the future.
-		</para>
+            Bugzilla used to have the path to perl on the shebang line set to
+            <filename>/usr/bonsaitools/bin/perl</filename> because when
+            Terry first started writing the code for mozilla.org he needed a
+            version of Perl and other tools that were completely under his
+            control.  This location was abandoned for the 2.18 release in favor
+            of the more sensible <filename>/usr/bin/perl</filename>.  If you
+            installed an older verion of Bugzilla and created the symlink we
+            suggested, you can remove it now (provided that you don't have
+            anything else, such as Bonsai, using it and you don't intend to
+            reinstall an older version of Bugzilla).
+          </para>
 	</answer>
       </qandaentry>
 
+      <qandaentry>
+        <question id="faq-general-perlpath">
+          <para>
+            My perl is not located at <filename>/usr/bin/perl</filename>, is
+            there an easy way to change it everywhere it needs to be changed?
+          </para>
+        </question>
+        <answer>
+          <para>
+            Yes, the following bit of perl magic will change all the shebang
+            lines.  Be sure to change <filename>/usr/local/bin/perl</filename>
+            to your path to the perl binary.
+          </para>
+          <programlisting>
+perl -pi -e 's@#\!/usr/bin/perl@#\!/usr/local/bin/perl@' *cgi *pl
+          </programlisting>
+        </answer>
+      </qandaentry>
 
       <qandaentry>
 	<question id="faq-general-cookie">
-- 
cgit v1.2.3-24-g4f1b