From 5a7a41a7dbae47049cba9f56aa62803668a75d2f Mon Sep 17 00:00:00 2001 From: "jocuri%softhome.net" <> Date: Tue, 28 Feb 2006 18:20:46 +0000 Subject: Documentation patch for bug 213262: add instructions on how to get sendmail to work with Bugzilla on Mac OS X; patch by A. Karl Kornel , r=colin.ogilvie, r=justdave. --- docs/xml/installation.xml | 126 +++++++++++++++++++++++++++------------------- 1 file changed, 75 insertions(+), 51 deletions(-) (limited to 'docs/xml/installation.xml') diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml index a040d306c..45e95cba5 100644 --- a/docs/xml/installation.xml +++ b/docs/xml/installation.xml @@ -1,5 +1,5 @@ - + Installing Bugzilla @@ -1638,67 +1638,91 @@ C:\perl> ppm install <module name>
<productname>Mac OS X</productname> - Apple did not include the GD library with Mac OS X. Bugzilla - needs this for bug graphs. + Making Bugzilla work on Mac OS X requires the following + adjustments. - You can install it using a program called - Fink, which is similar in nature to the CPAN installer, but installs - common GNU utilities. Fink is available from - . +
+ Sendmail - Follow the instructions for setting up Fink. Once it's installed, - you'll want to use it to install the gd2 package. - + In Mac OS X 10.3 and later, + Postfix + is used as the built-in email server. Postfix provides an executable + that mimics sendmail enough to fool Bugzilla, as long as Bugzilla can + find it. - It will prompt you for a number of dependencies, type 'y' and hit - enter to install all of the dependencies and then watch it work. You will - then be able to use CPAN to - install the GD Perl module. - + As of version 2.20, Bugzilla will be able to find the fake + sendmail executable without any assistance. However, you will have + to turn on the sendmailnow parameter before you do anything that would + result in email being sent. For more information, see the description + of the sendmailnow parameter in . - - To prevent creating conflicts with the software that Apple - installs by default, Fink creates its own directory tree at - /sw where it installs most of - the software that it installs. This means your libraries and headers - will be at /sw/lib and - /sw/include instead of - /usr/lib and - /usr/include. When the - Perl module config script asks where your libgd - is, be sure to tell it - /sw/lib. +
+ +
+ Libraries & Perl Modules on Mac OS X + + Apple did not include the GD library with Mac OS X. Bugzilla + needs this for bug graphs. + + You can install it using a program called + Fink, which is similar in nature to the CPAN installer, but installs + common GNU utilities. Fink is available from + . + + Follow the instructions for setting up Fink. Once it's installed, + you'll want to use it to install the gd2 package. - - Also available via Fink is expat. After using - fink to install the expat package you will be able to install - XML::Parser using CPAN. There is one caveat. Unlike recent versions of - the GD module, XML::Parser doesn't prompt for the location of the - required libraries. When using CPAN, you will need to use the following - command sequence: - + It will prompt you for a number of dependencies, type 'y' and hit + enter to install all of the dependencies and then watch it work. You will + then be able to use CPAN to + install the GD Perl module. + - + + To prevent creating conflicts with the software that Apple + installs by default, Fink creates its own directory tree at + /sw where it installs most of + the software that it installs. This means your libraries and headers + will be at /sw/lib and + /sw/include instead of + /usr/lib and + /usr/include. When the + Perl module config script asks where your libgd + is, be sure to tell it + /sw/lib. + + + + Also available via Fink is expat. After using + fink to install the expat package you will be able to install + XML::Parser using CPAN. There is one caveat. Unlike recent versions of + the GD module, XML::Parser doesn't prompt for the location of the + required libraries. When using CPAN, you will need to use the following + command sequence: + + + # perl -MCPAN -e'look XML::Parser' # perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include # make; make test; make install # exit - - - - The look command will download the module and spawn a - new shell with the extracted files as the current working directory. - The exit command will return you to your original shell. - - - - You should watch the output from these make commands, - especially make test as errors may prevent XML::Parser - from functioning correctly with Bugzilla. - - - + + + + The look command will download the module and spawn a + new shell with the extracted files as the current working directory. + The exit command will return you to your original shell. + + + + You should watch the output from these make commands, + especially make test as errors may prevent + XML::Parser from functioning correctly with Bugzilla. + + + +
-- cgit v1.2.3-24-g4f1b