Bug 36727

Summary: Mail chapter of Handbook is incomplete
Product: Documentation Reporter: Murray Stokely <murray>
Component: Books & ArticlesAssignee: Tom Rhodes <trhodes>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
chapter.sgml-patch
none
handbook_Makefile-patch none

Description Murray Stokely freebsd_committer freebsd_triage 2002-04-04 07:30:01 UTC 
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..

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.
How-To-Repeat: 
Point a new user at FreeBSD.
Comment 1 Tom Rhodes freebsd_committer freebsd_triage 2002-04-15 07:14:36 UTC 
Responsible Changed
From-To: freebsd-doc->trhodes

I'll close this sometime this week.
Comment 2 setantae 2002-06-09 15:10:38 UTC 
Tom, while you're working on this, could you please see that the
daily_status_include_submit_mailq periodic.conf knob gets mentioned somewhere ?

Thanks,

Ceri

-- 
you can't see when light's so strong
you can't see when light is gone
Comment 3 darklogik 2002-06-10 05:01:53 UTC 
Ceri Davies wrote:

>The following reply was made to PR docs/36727; it has been noted by GNATS.
>
>From: Ceri Davies <setantae@submonkey.net>
>To: throdes@FreeBSD.org
>Cc: FreeBSD-gnats-submit@freebsd.org
>Subject: Re: docs/36727: Mail chapter of Handbook is incomplete
>Date: Sun, 9 Jun 2002 15:10:38 +0100
>
> Tom, while you're working on this, could you please see that the
> daily_status_include_submit_mailq periodic.conf knob gets mentioned somewhere ?
> 
> Thanks,
> 
> Ceri
> 
> -- 
> you can't see when light's so strong
> you can't see when light is gone
>
>
Sure!  Let me get another laptop first, I'm kinda 
computer/workstation-less at the
moment.  But I'll get to this ;)


Thanks for the content idea!

--
Tom Rhodes
Comment 4 Marc Silver 2004-03-11 09:04:56 UTC 
Hi guys,

I've done some work on adding MUA information to the handbook, as well
as some minor additions regarding local and remote mailboxes, and
information on procmail and fetchmail.

This patch consists of three parts:

 1) chapter.sgnml-patch
    This file contains the patch to the mail chapter itself.

 2) handbook_Makefile-patch
    This file contains patches that are required to the handbook
    Makefile in order to change the .scr files to .png files.

 3) scr_files.tar.bz2 
    This file contains the .scr files (which may need to change)
    required to build the .png images.  Since I'm not sure if binary
    files can be submitted to GNATS, I'm going to leave this up at
    http://draenor.org/marcs/FreeBSD/scr_files.tar.bz2 instead.

The rendered document may also be viewed online at
http://draenor.org/marcs/FreeBSD/html/mail.html

The only technical problem with this document seems to be that <keycap>
is not displaying properly, but Tom Rhodes is helping me solve this
problem.

- Marc

-- 
Success is never final. Failure is never fatal. It is courage that
counts.  
  -- Winston Churchill
Comment 5 Tom Rhodes freebsd_committer freebsd_triage 2004-03-16 07:30:18 UTC 
State Changed
From-To: open->closed

Committed with minor alterations, thanks for the submission Marc!