From owner-cvs-doc@FreeBSD.ORG Mon Jan 4 22:20:14 2010 Return-Path: Delivered-To: cvs-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D2624106568B; Mon, 4 Jan 2010 22:20:14 +0000 (UTC) (envelope-from gavin@FreeBSD.org) Received: from mail-gw2.york.ac.uk (mail-gw2.york.ac.uk [144.32.128.247]) by mx1.freebsd.org (Postfix) with ESMTP id 4AA8B8FC1F; Mon, 4 Jan 2010 22:20:14 +0000 (UTC) Received: from mail-gw7.york.ac.uk (mail-gw7.york.ac.uk [144.32.129.30]) by mail-gw2.york.ac.uk (8.13.6/8.13.6) with ESMTP id o04MKBfH005345; Mon, 4 Jan 2010 22:20:11 GMT Received: from ury.york.ac.uk ([144.32.108.81]) by mail-gw7.york.ac.uk with esmtps (TLSv1:AES256-SHA:256) (Exim 4.68) (envelope-from ) id 1NRvHX-0002Hj-O4; Mon, 04 Jan 2010 22:20:11 +0000 Received: from ury.york.ac.uk (localhost.york.ac.uk [127.0.0.1]) by ury.york.ac.uk (8.14.3/8.14.3) with ESMTP id o04MKBtU080537; Mon, 4 Jan 2010 22:20:11 GMT (envelope-from gavin@FreeBSD.org) Received: from localhost (gavin@localhost) by ury.york.ac.uk (8.14.3/8.14.3/Submit) with ESMTP id o04MKBZ0080534; Mon, 4 Jan 2010 22:20:11 GMT (envelope-from gavin@FreeBSD.org) X-Authentication-Warning: ury.york.ac.uk: gavin owned process doing -bs Date: Mon, 4 Jan 2010 22:20:11 +0000 (GMT) From: Gavin Atkinson X-X-Sender: gavin@ury.york.ac.uk To: Gabor Kovesdan In-Reply-To: <4B42603E.6000503@FreeBSD.org> Message-ID: References: <201001042038.o04KcFo8028508@repoman.freebsd.org> <4B425D7A.7030101@FreeBSD.org> <4B42603E.6000503@FreeBSD.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-York-MailScanner: Found to be clean X-York-MailScanner-From: gavin@freebsd.org Cc: Doug Barton , cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org, doc-committers@FreeBSD.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/porters-handbook book.sgml X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 04 Jan 2010 22:20:14 -0000 On Mon, 4 Jan 2010, Gabor Kovesdan wrote: > El 2010. 01. 04. 22:28, Doug Barton escribi?: > > Gavin Atkinson wrote: > > > > > On Mon, 4 Jan 2010, Doug Barton wrote: > > > > > > > dougb 2010-01-04 20:38:15 UTC > > > > > > > > Modified files: > > > > en_US.ISO8859-1/books/porters-handbook book.sgml > > > > Log: > > > > Actually having the $FreeBSD$ tag expanded in the example rc.d script > > > > did not end up looking as cool as I thought it would, so switch to an > > > > unexpanded example. > > > > > > > > Fix the text in the new paragraph to work better around the markup. > > > > > > > > > > > Unless there is a good reason to start the service > > > > earlier all ports scripts should use > > > > - REQUIRE: LOGIN. If the service > > > > + REQUIRE: LOGIN If the service > > > > runs as a particular user (other than root) this is mandatory. > > > > > > > This is now grammatically incorrect. I actually think the original is > > > better than any rewording I can come up with. > > > > > Take a quick look at the page before it auto-updates. The old way the > > period ends up all by itself in the text after the programlisting box, > > so it looks like this: > > > I would suggest the following: > > Unless there is a good reason to start the service > earlier all ports scripts should use the following: > > REQUIRE: LOGIN > > If the service ... I hadn't looked at the rendered output before now, I think Gabor's suggestion is probably the best answer. Thanks, Gavin