From owner-freebsd-doc@FreeBSD.ORG Tue Dec 2 08:00:31 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7445A16A4D1 for ; Tue, 2 Dec 2003 08:00:31 -0800 (PST) Received: from mta3.adelphia.net (mta3.adelphia.net [68.168.78.181]) by mx1.FreeBSD.org (Postfix) with ESMTP id 41E7D43FBD for ; Tue, 2 Dec 2003 08:00:28 -0800 (PST) (envelope-from wmoran@potentialtech.com) Received: from potentialtech.com ([68.68.113.33]) by mta13.adelphia.net (InterMail vM.5.01.06.05 201-253-122-130-105-20030824) with ESMTP id <20031202155653.RBHJ4878.mta13.adelphia.net@potentialtech.com>; Tue, 2 Dec 2003 10:56:53 -0500 Message-ID: <3FCCB644.500@potentialtech.com> Date: Tue, 02 Dec 2003 10:56:52 -0500 From: Bill Moran User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.4) Gecko/20031005 X-Accept-Language: en-us, en MIME-Version: 1.0 To: j.el-rayes@daemon.li References: <3FCBB04F.7070204@potentialtech.com> <20031201221825.GB10158@jenny.daemon.li> <3FCBF8E6.6010208@potentialtech.com> <20031202091804.GB269@jenny.daemon.li> In-Reply-To: <20031202091804.GB269@jenny.daemon.li> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: FreeBSD-doc@FreeBSD.org Subject: Re: Proposed addition to the mail section of the handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Dec 2003 16:00:31 -0000 Josef El-Rayes wrote: > Bill Moran wrote: > >>Not offended. All good points. >> >>While I can't argue your 4-line patch logic, where would >>it go that it >>would be discoverable information? The advantage of my >>patch is that >>it creates a section that a user will be able to easily >>find. I also >>suspect (although I could be wrong) that the section I >>created may be >>expanded to explain how to achieve the same goal using >>sendmail, which >>(to me) is a good idea, since sendmail comes with >>FreeBSD. > > should this really be covered by the handbook? isn't > the handbook a resource for freebsd specific topics? I belive the handbook should have this section. There are many circumstances where a FreeBSD machine will need to do mail in a "send-only" capacity. Users should be able to find documentation on how to make it work. You're right, technically, this section should explain how to set up sendmail to function in this capacity. However, I believe that sendmail is difficult to properly configure for this use, and overkill anyway. > explaining how to use xyz-MTA for forwarding mails to another ISP > is not the task of the handbook, this is covered by xyz' docs. I worry that this is a case of, "experienced FreeBSD user's can't understand why documentation this simple is necessary." I feel that it is necessary. Perhaps the handbook is not the correct place for this? I'm open to suggestions, but the handbook was the best place I could find. I'm incorporating many of your other suggestions, and I'll post updated files to my site shortly. http://www.potentialtech.com/wmoran/handbook/ -- Bill Moran Potential Technologies http://www.potentialtech.com