From 450bdaf16c87131f1d34add4579aaf3b2ee7f7c7 Mon Sep 17 00:00:00 2001
From: "jocuri%softhome.net" <>
Date: Fri, 4 Apr 2008 11:47:06 +0000
Subject: 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.

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

(limited to 'docs/en/xml/installation.xml')

diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml
index 397dc359e..097b21e0b 100644
--- a/docs/en/xml/installation.xml
+++ b/docs/en/xml/installation.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: installation.xml,v 1.75 2008/04/04 06:47:05 justdave%bugzilla.org Exp $ -->
+<!-- $Id: installation.xml,v 1.76 2008/04/04 06:47:06 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>
   
   
-- 
cgit v1.2.3-24-g4f1b