Documentation patch for bug 213262: add instructions on how to get sendmail to work...

diff --git a/docs/xml/administration.xml b/docs/xml/administration.xml
index b6019a12d2f5c81588db920c1163c045202efc9f..81944aa876855e6b7ffc49eb5b949d74da2c1d2f 100644 (file)
--- a/docs/xml/administration.xml
+++ b/docs/xml/administration.xml
@@ -294,6 +294,23 @@
         </listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term>   
+          sendmailnow
+        </term>    
+        <listitem>
+          <para>
+            When Bugzilla is using Sendmail older than 8.12, turning this option
+            off will improve performance by not waiting for Sendmail to actually
+            send mail.  If Sendmail 8.12 or later is being used, there is
+            nothing to gain by turning this off.  If another MTA is being used,
+            such as Postfix, then this option *must* be turned on (even if you
+            are using the fake sendmail executable that Postfix provides).
+          </para>
+        </listitem>
+      </varlistentry>
+
+
     </variablelist>
   </section>
 

diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml
index d3dbc4b42ac0053b703d9fc631e1b746761a533d..76953b75542938cec6acce987f4a8022acd4c237 100644 (file)
--- a/docs/xml/installation.xml
+++ b/docs/xml/installation.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.72.2.28 2006/02/24 01:26:15 jocuri%softhome.net Exp $ -->
+<!-- $Id: installation.xml,v 1.72.2.29 2006/02/28 10:22:24 jocuri%softhome.net Exp $ -->
 <chapter id="installing-bugzilla">
   <title>Installing Bugzilla</title>
 
@@ -1518,67 +1518,105 @@ $smtp->quit;
     <section id="os-macosx">
       <title><productname>Mac OS X</productname></title>
 
-      <para>Apple did not include the GD library with Mac OS X. Bugzilla
-      needs this for bug graphs.</para>
+      <section id="macosx-sendmail">
+        <title>Sendmail</title>
 
-      <para>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
-      <ulink url="http://sourceforge.net/projects/fink/"/>.</para>
+        <para>In Mac OS X 10.3 and later,
+        <ulink url="http://www.postfix.org/">Postfix</ulink>
+        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.</para>
 
-      <para>Follow the instructions for setting up Fink. Once it's installed,
-      you'll want to use it to install the <filename>gd2</filename> package.
-      </para>
+        <para>The substitute Sendmail executable is located at
+        <filename>/usr/sbin/sendmail</filename>, while Bugzilla expects the
+        executable to be located at <filename>/usr/lib/sendmail</filename>.
+        Rather than copying the sendmail executable, a symbolic link can be
+        used.  To create the symbolic link, launch the Terminal application
+        and execute the following command:</para>
 
-      <para>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 <glossterm linkend="gloss-cpan">CPAN</glossterm> to
-      install the GD Perl module.
-      </para>
+        <screen>
+<prompt>[localhost:~]</prompt> <command>sudo ln -s /usr/sbin/sendmail /usr/lib/sendmail</command> <co id="macosx-sendmail-sudo"/>
+<prompt>Enter Password:</prompt> <command>********</command>
+        </screen>
+        <calloutlist>
+          <callout arearefs="macosx-sendmail-sudo">
+            <para>You must be logged in as an administrator to run this      
+            command.  Enter your password if prompted.</para>
+          </callout>
+        </calloutlist>
+
+        <para>The other change to be made involves turning on the sendmailnow 
+        Bugzilla parameter, which is described in <xref linkend="parameters"/>.
+        </para>
 
-      <note>
-        <para>To prevent creating conflicts with the software that Apple
-        installs by default, Fink creates its own directory tree at 
-        <filename class="directory">/sw</filename> where it installs most of
-        the software that it installs. This means your libraries and headers
-        will be at <filename class="directory">/sw/lib</filename> and
-        <filename class="directory">/sw/include</filename> instead of
-        <filename class="directory">/usr/lib</filename> and
-        <filename class="directory">/usr/include</filename>. When the
-        Perl module config script asks where your <filename>libgd</filename>
-        is, be sure to tell it
-        <filename class="directory">/sw/lib</filename>.
+      </section>
+
+      <section id="macosx-libraries">
+        <title>Libraries &amp; Perl Modules on Mac OS X</title>
+
+        <para>Apple did not include the GD library with Mac OS X. Bugzilla
+        needs this for bug graphs.</para>
+
+        <para>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
+        <ulink url="http://sourceforge.net/projects/fink/"/>.</para>
+
+        <para>Follow the instructions for setting up Fink. Once it's installed,
+        you'll want to use it to install the <filename>gd2</filename> package.
         </para>
-      </note>
 
-      <para>Also available via Fink is <filename>expat</filename>. 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:
-      </para>
+        <para>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 
+        wille then be able to use 
+        <glossterm linkend="gloss-cpan">CPAN</glossterm> to install the GD Perl 
+        module.
+        </para>
 
-      <screen>
+        <note>
+          <para>To prevent creating conflicts with the software that Apple
+          installs by default, Fink creates its own directory tree at 
+          <filename class="directory">/sw</filename> where it installs most of
+          the software that it installs. This means your libraries and headers
+          will be at <filename class="directory">/sw/lib</filename> and
+          <filename class="directory">/sw/include</filename> instead of
+          <filename class="directory">/usr/lib</filename> and
+          <filename class="directory">/usr/include</filename>. When the
+          Perl module config script asks where your <filename>libgd</filename>
+          is, be sure to tell it
+          <filename class="directory">/sw/lib</filename>.
+          </para>
+        </note>
+
+        <para>Also available via Fink is <filename>expat</filename>. 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:
+        </para>
+
+        <screen>
 # perl -MCPAN -e'look XML::Parser'        <co id="macosx-look"/>
 # perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include
 # make; make test; make install           <co id="macosx-make"/>
 # exit                                    <co id="macosx-exit"/>
-      </screen>
-      <calloutlist>
-        <callout arearefs="macosx-look macosx-exit">
-          <para>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.
-          </para>
-        </callout>
-        <callout arearefs="macosx-make">
-          <para>You should watch the output from these make commands,
-          especially <quote>make test</quote> as errors may prevent XML::Parser
-          from functioning correctly with Bugzilla.
-          </para>
-        </callout>
-      </calloutlist>
+        </screen>
+        <calloutlist>
+          <callout arearefs="macosx-look macosx-exit">
+            <para>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.
+            </para>
+          </callout>
+          <callout arearefs="macosx-make">
+            <para>You should watch the output from these make commands,
+            especially <quote>make test</quote> as errors may prevent 
+            XML::Parser from functioning correctly with Bugzilla.
+            </para>
+          </callout>
+        </calloutlist>
+      </section>
     </section>
 
     <section id="os-mandrake">