Date: Sat, 13 Apr 2002 11:47:22 +0200 From: "Philippe Charnier" <charnier@xp11.frmug.org> To: Brian Somers <brian@freebsd-services.com> Cc: Philippe Charnier <charnier@FreeBSD.org>, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/usr.bin/make job.c main.c make.1 Message-ID: <200204130947.g3D9lM6W011594@xp11.frmug.org> In-Reply-To: Message from Brian Somers <brian@freebsd-services.com> of "Fri, 12 Apr 2002 23:18:01 BST." <200204122218.g3CMI1OF096403@hak.lan.Awfulhak.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Salut, Brian Somers <brian@freebsd-services.com> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200204130947.g3D9lM6W011594>