From owner-freebsd-doc@FreeBSD.ORG Mon Dec 1 14:17: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 702D316A4CE for ; Mon, 1 Dec 2003 14:17:31 -0800 (PST) Received: from tatiana.utanet.at (tatiana.utanet.at [213.90.36.46]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0F52243FCB for ; Mon, 1 Dec 2003 14:17:26 -0800 (PST) (envelope-from josef@daemon.li) Received: from plenty.utanet.at ([213.90.36.9]) by tatiana.utanet.at with esmtp (Exim 4.12) id 1AQwM9-0002Qz-00; Mon, 01 Dec 2003 23:17:25 +0100 Received: from dsl-245-165.utaonline.at ([212.152.245.165] helo=jenny.daemon.li) by plenty.utanet.at with esmtp (Exim 4.12) id 1AQwM6-0002NL-00; Mon, 01 Dec 2003 23:17:22 +0100 Received: by jenny.daemon.li (Postfix, from userid 1005) id 057656E1; Mon, 1 Dec 2003 23:18:25 +0100 (CET) Date: Mon, 1 Dec 2003 23:18:25 +0100 From: Josef El-Rayes To: Bill Moran Message-ID: <20031201221825.GB10158@jenny.daemon.li> References: <3FCBB04F.7070204@potentialtech.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <3FCBB04F.7070204@potentialtech.com> User-Agent: Mutt/1.4.1i Reply-Path: j.el-rayes@daemon.li X-Operating-System: FreeBSD 4.9-STABLE X-DNSBL-Warning: listed at list.dsbl.org (http://dsbl.org/listing?ip=212.152.245.165) 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 Reply-To: j.el-rayes@daemon.li List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 01 Dec 2003 22:17:31 -0000 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 mail/ssmtp, which is a easy to set up program, that fulfills this task.. dont feel offended, this is just my view. -josef