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>