From e278485bd22e912bd976e3eb83c1512b924105c6 Mon Sep 17 00:00:00 2001
From: "jocuri%softhome.net" <jocuri%softhome.net>
Date: Sat, 9 Oct 2004 20:49:42 +0000
Subject: [PATCH] Patch for bug 251338: Installation section should mention
 that you need an MTA installed; patch by Colin S. Ogilvie
 <colin.ogilvie@gmail.com>; r=vladd, a=justdave.

---
 webtools/bugzilla/docs/xml/installation.xml | 27 ++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/webtools/bugzilla/docs/xml/installation.xml b/webtools/bugzilla/docs/xml/installation.xml
index 7310b1f0fd7..306de30147d 100644
--- a/webtools/bugzilla/docs/xml/installation.xml
+++ b/webtools/bugzilla/docs/xml/installation.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.75 2004-09-14 05:48:54 justdave%bugzilla.org Exp $ -->
+<!-- $Id: installation.xml,v 1.76 2004-10-09 20:49:42 jocuri%softhome.net Exp $ -->
 <chapter id="installing-bugzilla">
   <title>Installing Bugzilla</title>
 
@@ -75,6 +75,10 @@
         <para><link linkend="install-perlmodules">Install Perl modules</link>
         </para>
       </step>
+      <step>
+        <para><link linkend="install-MTA">Install a Mail Transfer Agent</link>
+        </para>
+      </step>
       <step>
         <para>Configure all of the above.
         </para>
@@ -478,6 +482,27 @@
         </para>
       </section>
     </section>    
+    <section id="install-MTA">
+      <title>Mail Transfer Agent (MTA)</title>
+    
+      <para>Bugzilla is dependent on the availability of an e-mail system for its user
+      authentication and for other tasks. </para>
+    
+      <para>On Linux, any Sendmail-compatible MTA (Mail Transfer Agent) will suffice.
+      Sendmail, Postfix, qmail and Exim are examples of common MTAs. Sendmail is the 
+      original Unix MTA, but the others are easier to configure, and therefore many people
+      replace Sendmail with Postfix or Exim. They are drop-in replacements, so that Bugzilla
+      will not distinguish between them.</para>
+
+      <para>Consult the manual for the specific MTA you choose for detailed installation
+      instructions. Each of these programs will have their own configuration files where you must
+      configure certain parameters to ensure that the mail is delivered properly. They
+      are implemented as services, and you should ensure that the MTA is in the
+      auto-start list of services for the machine.</para>
+
+      <para>If a simple mail sent with the command-line 'mail' program succeeds, then
+      Bugzilla should also be fine.</para>
+    </section>  
   </section>