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

docs/en/xml/administration.xml

@@ -82,6 +82,22 @@
 
       <varlistentry>
         <term>
+          maildeliverymethod
+        </term>
+        <listitem>
+          <para>
+            This is used to specify how email is sent, or if it is sent at 
+            all.  There are several options included for different MTAs, 
+            along with two additional options that disable email sending.  
+            "testfile" does not send mail, but instead saves it in 
+            <filename>data/mailer.testfile</filename> for later review.  
+            "none" disables email sending entirely.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>
           shadowdb
         </term>
         <listitem>
@@ -154,25 +170,6 @@
 
       <varlistentry>
         <term>
-          passwordmail
-        </term>
-        <listitem>
-          <para>
-            Every time a user creates an account, the text of this parameter
-            (with substitutions) is sent to the new user along with their
-            password message.
-          </para>
-
-          <para>
-            Add any text you wish to the "passwordmail" parameter box. For
-            instance, many people choose to use this box to give a quick 
-            training blurb about how to use Bugzilla at your site.
-          </para>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry>
-        <term>
           movebugs
         </term>
         <listitem>
@@ -294,6 +291,22 @@
         </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>
 
@@ -1295,7 +1308,9 @@
              resulted in a user acquiring permanent membership in a group.
              To remove a user from a group the user was in due to a regular
              expression in version 2.16 or earlier, the user must be explicitly
-             removed from the group.</para>
+             removed from the group. This can easily be done by pressing
+             buttons named 'Remove Memberships' or 'Remove Memberships
+             included in regular expression' under the table.</para>
            </note>
            <warning>
              <para>If specifying a domain in the regexp, make sure you end

docs/en/xml/installation.xml

 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.113 2008/04/04 06:47:43 jocuri%softhome.net Exp $ -->
+<!-- $Id: installation.xml,v 1.114 2008/04/04 06:47:44 jocuri%softhome.net Exp $ -->
 <chapter id="installing-bugzilla">
   <title>Installing Bugzilla</title>
 
@@ -1638,6 +1638,29 @@ C:\perl&gt; <command>ppm install &lt;module name&gt;</command>
     <section id="os-macosx">
       <title><productname>Mac OS X</productname></title>
 
+      <para>Making Bugzilla work on Mac OS X requires the following 
+      adjustments.</para>
+
+      <section id="macosx-sendmail">
+        <title>Sendmail</title>
+
+        <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>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 <xref linkend="parameters"/>.</para>
+
+      </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>
 
@@ -1694,12 +1717,13 @@ C:\perl&gt; <command>ppm install &lt;module name&gt;</command>
           </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.
+            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">
       <title>Linux-Mandrake 8.0</title>