diff options
Diffstat (limited to 'docs/sgml')
| -rw-r--r-- | docs/sgml/faq.sgml | 42 | ||||
| -rw-r--r-- | docs/sgml/installation.sgml | 37 |
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 @@ <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/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 <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> |