From owner-cvs-all Sat Apr 13 3:10:57 2002 Delivered-To: cvs-all@freebsd.org Received: from frmug.org (frmug-gw.frmug.org [193.56.58.252]) by hub.freebsd.org (Postfix) with ESMTP id 0B37637B405; Sat, 13 Apr 2002 03:10:50 -0700 (PDT) Received: (from uucp@localhost) by frmug.org (8.11.3/8.11.3/frmug-2.7/nospam) with UUCP id g3DAAhD89843; Sat, 13 Apr 2002 12:10:43 +0200 (CEST) (envelope-from charnier@xp11.frmug.org) Received: from xp11.frmug.org (xp11.frmug.org [127.0.0.1]) by xp11.frmug.org (8.12.2/8.11.1/xp11-uucp-1.1) with ESMTP id g3D9lM6W011594; Sat, 13 Apr 2002 11:47:22 +0200 (CEST) (envelope-from charnier@xp11.frmug.org) Message-Id: <200204130947.g3D9lM6W011594@xp11.frmug.org> To: Brian Somers Cc: Philippe Charnier , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/usr.bin/make job.c main.c make.1 In-Reply-To: Message from Brian Somers of "Fri, 12 Apr 2002 23:18:01 BST." <200204122218.g3CMI1OF096403@hak.lan.Awfulhak.org> Date: Sat, 13 Apr 2002 11:47:22 +0200 From: "Philippe Charnier" Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG Salut, Brian Somers wrote: >> charnier 2002/04/12 06:23:34 PDT >> >> Modified files: >> usr.bin/make job.c main.c make.1 >> Log: [...] >> Uppercase (first letter) programname after dot. >> >I believe that the last time this came up, the consensus what that >program names aren't capitalised, even if they're the first word in a >sentence. I remember exactly the opposite (but I was not able to get the bits after a search in the archives, so I could be wrong) because I do not like myself uppercasing .Nm (I made lot of commits in this area near 1997) and I remember being in the wrong side of the consensus. Someone stated that the most important was to preserve grammar, and I can't have any argument against that. What was proposed in pr docs/31640 is an alternative (start sentences with ``The .Nm utility'') but the provided patch is also inconsistent (utility vs command). I think someone need to clearly << dictate >> the rule (in mdoc.samples(7) ??) before we can turn the man pages into a consistent state. Also note that the same question should be asked concerning section 3 and .Fn. ------ ------ Philippe Charnier charnier@{xp11.frmug.org,free.fr,FreeBSD.org} ``a PC not running FreeBSD is like a venusian with no tentacles'' ------------------------------------------------------------------------ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message