path: root/docs/sgml
diff options
mode: <>2003-03-27 09:06:37 +0100 <>2003-03-27 09:06:37 +0100
commit9665c0e6a0ee98cdd113e11b86d3efab474464c0 (patch)
tree53f75f6c8f1207c6dfba7209709e8a4bb9cca27f /docs/sgml
parentd97f96781715a3d13dc99deb616aa63c4aeb42d5 (diff)
Bug 196433 - Bugzilla now uses /usr/bin/perl as the shebang line
r=justdave a=justdave
Diffstat (limited to 'docs/sgml')
2 files changed, 31 insertions, 48 deletions
diff --git a/docs/sgml/faq.sgml b/docs/sgml/faq.sgml
index df80794cd..d0f78b75a 100644
--- a/docs/sgml/faq.sgml
+++ b/docs/sgml/faq.sgml
@@ -204,25 +204,43 @@
<question id="faq-general-bonsaitools">
- 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>?
- 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 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>
+ <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>
<question id="faq-general-cookie">
diff --git a/docs/sgml/installation.sgml b/docs/sgml/installation.sgml
index d1fa2401b..9f94feb7a 100644
--- a/docs/sgml/installation.sgml
+++ b/docs/sgml/installation.sgml
@@ -522,41 +522,6 @@
until you run the post-install
script, which locks down your installation.</para>
- <para>Lastly, you'll need to set up a symbolic link to
- <filename>/usr/bonsaitools/bin/perl</filename>
- for the correct location of your Perl executable (probably
- <filename>/usr/bin/perl</filename>).
- Otherwise you must hack all the .cgi files to change where they look
- for Perl. This can be done using the following Perl one-liner, but
- I suggest using the symlink approach to avoid upgrade hassles.
- </para>
- <note>
- <para><quote>Bonsaitools</quote> is the name Terry Weissman, the
- original author of Bugzilla, created
- for his suite of webtools at the time he created Bugzilla and several
- other tools in use at He created a directory,
- <filename>/usr/bonsaitools</filename> to house his specific versions
- of perl and other utilities. This usage is still current at
- <ulink url=""></ulink>,
- but in general most other places do not use it. You can either edit
- the paths at the start of each perl file to the correct location of
- perl on your system, or simply bow to history and create a
- <filename>/usr/bonsaitools</filename> and <filename>/usr/bonsaitools/bin
- </filename> directory, placing a symlink to perl on your system
- inside <filename>/usr/bonsaitools/bin</filename>
- </para>
- </note>
- <para>
- <programlisting>
-perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl syncshadowdb
- </programlisting>
- Change <filename>/usr/bin/perl</filename> to match the location
- of Perl on your machine.
- </para>
@@ -1185,7 +1150,7 @@ system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filena
directive in your Apache config, if you don't do this, you'll have
to modify the first line of every script to contain your path to
- perl instead of <filename>/usr/bonsaitools/bin/perl</filename>.
+ perl instead of <filename>/usr/bin/perl</filename>.