From owner-freebsd-doc  Wed Apr  3 22:30:15 2002
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 5330937B41F
	for <freebsd-doc@hub.freebsd.org>; Wed,  3 Apr 2002 22:30:02 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g346U2r20575;
	Wed, 3 Apr 2002 22:30:02 -0800 (PST)
	(envelope-from gnats)
Received: from mail.freebsdmall.com (www.freebsdmall.com [66.220.2.194])
	by hub.freebsd.org (Postfix) with ESMTP id 8570737B417
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  3 Apr 2002 22:29:54 -0800 (PST)
Received: by mail.freebsdmall.com (Postfix, from userid 2074)
	id 6607E2E827; Wed,  3 Apr 2002 22:29:54 -0800 (PST)
Message-Id: <20020404062954.6607E2E827@mail.freebsdmall.com>
Date: Wed,  3 Apr 2002 22:29:54 -0800 (PST)
From: Murray Stokely <murray@FreeBSD.org>
Reply-To: Murray Stokely <murray@FreeBSD.org>
To: FreeBSD-gnats-submit@FreeBSD.org
X-Send-Pr-Version: 3.113
Subject: docs/36727: Mail chapter of Handbook is incomplete
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         36727
>Category:       docs
>Synopsis:       Mail chapter of Handbook is incomplete
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Apr 03 22:30:01 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:     Murray Stokely
>Release:        FreeBSD 4.5-RC i386
>Organization:
FreeBSD Project
>Environment:
any

>Description:

We only include 1 paragraph on MUAs in the mail chapter of the FreeBSD
Handbook.  This is very valuable information that new users need.  We
should add at least 5 pages talking about installation and usage of
Mutt, Pine, fetchmail, the concepts of local Unix mailboxes vs POP3 /
IMAP.  Available IMAP clients for FreeBSD.  Pointer to the SSH
tunnelling section for these insecure protocols, etc.. 

>How-To-Repeat:

Point a new user at FreeBSD.

>Fix:

Many beginning Unix / Linux books do a good job at documenting this.
We do not.

For now, we should focus on adding more information about MUAs to
section 18.2.1.

Eventually, we may end up with one chapter on reading electronic mail
with FreeBSD. (in Part I of the Handbook), and another chapter on
using various MTAs with FreeBSD (Postfix, sendmail, etc..) in Part II
of the Handbook.

>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message