summaryrefslogtreecommitdiffstats
path: root/docs/xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/xml')
-rw-r--r--docs/xml/faq.xml42
-rw-r--r--docs/xml/installation.xml37
2 files changed, 31 insertions, 48 deletions
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">
diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml
index d1fa2401b..9f94feb7a 100644
--- a/docs/xml/installation.xml
+++ b/docs/xml/installation.xml
@@ -522,41 +522,6 @@
until you run the post-install
<filename>checksetup.pl</filename>
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 mozilla.org. 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="http://bugzilla.mozilla.org/">bugzilla.mozilla.org</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 Bug.pm syncshadowdb
- </programlisting>
-
- Change <filename>/usr/bin/perl</filename> to match the location
- of Perl on your machine.
- </para>
</section>
<section>
@@ -1185,7 +1150,7 @@ system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filena
url="http://httpd.apache.org/docs-2.0/mod/core.html#scriptinterpretersource">ScriptInterpreterSource</ulink>
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>.
</para>
</note>