Standardize the synopsis.

This commit is contained in:
Murray Stokely 2001-08-22 06:08:03 +00:00
parent c42ea2c2ae
commit bad8c085ff
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=10429

View file

@ -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