From owner-freebsd-doc@FreeBSD.ORG Mon Dec 1 18:42:53 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 E0D8516A4CE for ; Mon, 1 Dec 2003 18:42:53 -0800 (PST) Received: from mta9.adelphia.net (mta9.adelphia.net [68.168.78.199]) by mx1.FreeBSD.org (Postfix) with ESMTP id 925C543FBF for ; Mon, 1 Dec 2003 18:42:52 -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 <20031202022854.ZHVN4878.mta13.adelphia.net@potentialtech.com>; Mon, 1 Dec 2003 21:28:54 -0500 Message-ID: <3FCBF8E6.6010208@potentialtech.com> Date: Mon, 01 Dec 2003 21:28:54 -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> In-Reply-To: <20031201221825.GB10158@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 02:42:54 -0000 Josef El-Rayes wrote: > Bill Moran wrote: > >>In all seriousness, I'm not totally confident with docbook >>yet, so suggestions >>on all levels are appreciated. (at least I got make to >>stop complaining ;) > > hy, i had a look at your patch and i have following suggestions: > > line 27: &man.send-pr.1; which creates a link to the > send-pr manualpage. > > line 45: the dot should not be inside the apostrophes. > > line 48: Execute the following commands as root. <- shouldn't > this end with ':' instead of '.'? > > line 47+48: mark ssmtp port up with > mail/ssmtp > > line 51: i think it is common practice in the handbook > to propose "make install clean" for installations. > > line 53: i would markup ssmtp with application tag > > line 26+32: why is there a different identing? as far > as i can see, both lines are on same level. > > line 56-60: what about indenting here? > > line 71: s/ssmpt/ssmtp > > line 72: it is "manpage" not "man page". > > in my opinion your patch is too long. i think the same > effect could be achieved by 30% of the lines. you do not > need to do such intense arguing why to use. > for me 3 lines, a note that there is a port, that allows > users to avoid sendmail, when they want to use send-pr > would suffice. > > i also think that installing & configuring ssmtp is a trivial task, > is there really a need to donate a whole page to this? > > what about something like this: > > If you just want to pass your email to your isp's mail relay, > and want to avoid installing a mail transfer agent, try role="package">mail/ssmtp, which is a easy to set up > program, that fulfills this task.. > > > dont feel offended, this is just my view. 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. I'm not arguing "I'm right, you're wrong." But you have good points that make me wonder what the best way to handle this is, so I'm throwing back more information to see if a consesnsus can be reached. -- Bill Moran Potential Technologies http://www.potentialtech.com