From owner-cvs-doc@FreeBSD.ORG Tue Jan 5 17:48:05 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 105A21065676; Tue, 5 Jan 2010 17:48:05 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from mail-ew0-f226.google.com (mail-ew0-f226.google.com [209.85.219.226]) by mx1.freebsd.org (Postfix) with ESMTP id 158138FC14; Tue, 5 Jan 2010 17:48:03 +0000 (UTC) Received: by ewy26 with SMTP id 26so14510564ewy.3 for ; Tue, 05 Jan 2010 09:47:55 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:sender:message-id:date:from :organization:user-agent:mime-version:to:cc:subject:references :in-reply-to:content-type:content-transfer-encoding; bh=QAN1imNbFnpz7WWgJxjimg0jyjKtFtfbyRGGhxhINm0=; b=kuALwutAW2UdFFfiQiDiiLRupLD5+tQG7R78lzCrVL74REmtb5mpRIOGYlJ/FmggNN x45GkGVXqgMIPL2KCzsHv98BAijMDpwcKWYWilHpIOoiKX6jow5lqT3gXZtIj9u8i2yH xMPzSHVSSuNGHP6yo7mmdeLee8WvyYrMeL4L8= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=sender:message-id:date:from:organization:user-agent:mime-version:to :cc:subject:references:in-reply-to:content-type :content-transfer-encoding; b=I+3weWR8VcmIW/kiZzoxYqF+LF6x+LNMdjjqKwZQsDgx827mEucUoxiKRQLCumns/5 TSgoo2Ji7f1hrJT8PBL/PQKBKoV5UMPaLMZiM0GUmw4QH9rzVUxkDfWbnpQ++3Jza5Fg EgUFOkrCXbkMOebr74Pfr03wu3jvZIAD7vDk0= Received: by 10.213.96.195 with SMTP id i3mr1853717ebn.97.1262713674697; Tue, 05 Jan 2010 09:47:54 -0800 (PST) Received: from self.rene-ladan.nl (ip4da3ae31.direct-adsl.nl [77.163.174.49]) by mx.google.com with ESMTPS id 5sm39637096eyh.0.2010.01.05.09.47.50 (version=TLSv1/SSLv3 cipher=RC4-MD5); Tue, 05 Jan 2010 09:47:51 -0800 (PST) Sender: Rene Ladan Message-ID: <4B437B44.9060308@freebsd.org> Date: Tue, 05 Jan 2010 18:47:48 +0100 From: Rene Ladan Organization: The FreeBSD Project User-Agent: Mozilla/5.0 (X11; U; FreeBSD amd64; nl-NL; rv:1.9.1.5) Gecko/20091219 Thunderbird/3.0 MIME-Version: 1.0 To: Doug Barton References: <201001042038.o04KcFo8028508@repoman.freebsd.org> <4B425D7A.7030101@FreeBSD.org> In-Reply-To: <4B425D7A.7030101@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Gabor Kovesdan , Gavin Atkinson , 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: Tue, 05 Jan 2010 17:48:05 -0000 On 04-01-2010 22:28, Doug Barton wrote: > 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: > > . If the service > This feels like working around some bug/shortcoming in the markup engine to me (?) The source text never knows the dimensions and font of the resulting output (computer screen/paper/pda/...). Regards, Rene -- http://www.rene-ladan.nl/ GPG fingerprint = ADBC ECCD EB5F A6B4 549F 600D 8C9E 647A E564 2BFC (subkeys.pgp.net)