From bad8c085ffd64655748771fee70e825c978990b6 Mon Sep 17 00:00:00 2001
From: Murray Stokely <murray@FreeBSD.org>
Date: Wed, 22 Aug 2001 06:08:03 +0000
Subject: [PATCH] Standardize the synopsis.

---
 .../books/handbook/mail/chapter.sgml          | 48 +++++++++++++------
 1 file changed, 34 insertions(+), 14 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/mail/chapter.sgml b/en_US.ISO8859-1/books/handbook/mail/chapter.sgml
index 73d949af38..0f10ee033e 100644
--- a/en_US.ISO8859-1/books/handbook/mail/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/mail/chapter.sgml
@@ -1,7 +1,7 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml,v 1.33 2001/08/15 20:14:40 logo Exp $
+     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml,v 1.34 2001/08/16 18:35:05 chern Exp $
 -->
 
 <chapter id="mail">
@@ -31,27 +31,47 @@
     <indexterm><primary>electronic mail</primary></indexterm>
 
     <para>Electronic Mail, better known as email, is one of the most
-      widely used forms of communication today. Millions of people use
-      email every day, and chances are if you are reading this online,
-      you fall into that category and probably even have more than one
-      email address.</para>
+      widely used forms of communication today.  This chapter provides
+      a basic introduction to running a mail server on FreeBSD.
+      However, it is not a complete reference and in fact many
+      important considerations are omitted.  For more complete
+      coverage of the subject, the reader is referred to the many
+      excellent books listed in <xref linkend="bibliography">.</para>
 
-    <para>Electronic Mail configuration is the subject of many <link
-      linkend="bibliography">System Administration</link> books.  If you
-      plan on doing anything beyond setting up one mailhost for your
-      network, you need industrial strength help.</para>
-    <indexterm><primary>DNS</primary></indexterm>
+    <para>After reading this chapter you will know:</para>
+    <itemizedlist>
+      <listitem><para>What software components are involved in sending
+      and receiving electronic mail.</para>
+      </listitem>
+      <listitem><para>Where basic <application>sendmail</application>
+      configuration files are located in FreeBSD.</para>
+      </listitem>
+      <listitem><para>How to block spammers from illegally using your
+      mail server as a relay.</para>
+      </listitem>
+      <listitem><para>How to troubleshoot common mail server
+      problems.</para></listitem>
+    </itemizedlist>
 
-    <para>Some parts of email configuration are controlled in the Domain
-      Name System (DNS).  If you are going to run your own DNS server, be
-      sure to read through the files in <filename>/etc/namedb</filename>
-      and <command>man -k named</command>.</para>
+    <para>Before reading this chapter you should:</para>
+
+    <itemizedlist>
+      <listitem><para>Properly setup your network connection (<xref
+      linkend="advanced-networking">).</para>
+      </listitem>
+      <listitem><para>Properly setup the DNS information for your mail
+      host (<xref linkend="advanced-networking">).</para>
+      </listitem>
+      <listitem><para>Know how to install additional third-party
+        software (<xref linkend="ports">).</para></listitem>
+    </itemizedlist>
   </sect1>
 
   <sect1 id="mail-using">
     <title>Using Electronic Mail</title>
     <indexterm><primary>POP</primary></indexterm>
     <indexterm><primary>IMAP</primary></indexterm>
+    <indexterm><primary>DNS</primary></indexterm>
 
     <para>There are five major parts involved in an email exchange.  They
       are: <link linkend="mail-mua">the user program</link>, <link