Date: Fri, 21 Mar 2014 10:40:16 -0600 (MDT) From: Warren Block <wblock@wonkity.com> To: =?ISO-8859-15?Q?Dag-Erling_Sm=F8rgrav?= <des@des.no> Cc: jilles@freebsd.org, freebsd-current@freebsd.org, Mariusz Zaborski <oshogbo@freebsd.org>, freebsd-arch@freebsd.org Subject: Re: Hello fdclose Message-ID: <alpine.BSF.2.00.1403211030450.14887@wonkity.com> In-Reply-To: <86fvmbzlbn.fsf@nine.des.no> References: <CAGOYWV80vTTQbvSjvNa6XBzBiKy%2BjnGantkUH_RO=8prxoHmyQ@mail.gmail.com> <201403181404.52197.jhb@freebsd.org> <alpine.BSF.2.00.1403182230140.45496@wonkity.com> <201403191523.33275.jhb@freebsd.org> <alpine.BSF.2.00.1403191407240.52822@wonkity.com> <86zjkkr5ma.fsf@nine.des.no> <alpine.BSF.2.00.1403210740240.13682@wonkity.com> <86fvmbzlbn.fsf@nine.des.no>
next in thread | previous in thread | raw e-mail | index | archive | help
On Fri, 21 Mar 2014, Dag-Erling Smørgrav wrote: > Warren Block <wblock@wonkity.com> writes: >> Dag-Erling Smørgrav <des@des.no> writes: >>> We always use [The .Nm foo utility or The .Fn foo function] instead >>> of just .Nm or .Fn at the start of a sentence, but never (or rarely) >>> within a sentence. >> By "we", do you mean the FreeBSD project or your local organization? >> Is there a specific reason the redundant wording, or is it just >> customary? > > I mean the FreeBSD project, and the reason is as John stated: all > sentences must start with a capital letter. I've gotten so used to this > over the past 15 years that I even do it in email and other non-FreeBSD > written material. > > DES "Because it's been that way for 15 years" is not always a justification (consider BIND in base, for example :). I'll let this drop for now, but still find it interesting that it is not mentioned in the FDP Primer, and those style guide rules date back at least 15 years. It may be that the original doc project members felt that capitalizing the first word of a sentence was so obvious that it did not need to be stated. Or possibly, that it was a rule that could be usefully broken at times. From owner-freebsd-arch@FreeBSD.ORG Fri Mar 21 16:54:22 2014 Return-Path: <owner-freebsd-arch@FreeBSD.ORG> Delivered-To: freebsd-arch@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id C31E73D9; Fri, 21 Mar 2014 16:54:22 +0000 (UTC) Received: from smtp.des.no (smtp.des.no [194.63.250.102]) by mx1.freebsd.org (Postfix) with ESMTP id 7DDD7370; Fri, 21 Mar 2014 16:54:22 +0000 (UTC) Received: from nine.des.no (smtp.des.no [194.63.250.102]) by smtp-int.des.no (Postfix) with ESMTP id 626E48D67; Fri, 21 Mar 2014 16:54:21 +0000 (UTC) Received: by nine.des.no (Postfix, from userid 1001) id 6B157960; Fri, 21 Mar 2014 17:54:13 +0100 (CET) From: =?utf-8?Q?Dag-Erling_Sm=C3=B8rgrav?= <des@des.no> To: Warren Block <wblock@wonkity.com> Subject: Re: Hello fdclose References: <CAGOYWV80vTTQbvSjvNa6XBzBiKy+jnGantkUH_RO=8prxoHmyQ@mail.gmail.com> <201403181404.52197.jhb@freebsd.org> <alpine.BSF.2.00.1403182230140.45496@wonkity.com> <201403191523.33275.jhb@freebsd.org> <alpine.BSF.2.00.1403191407240.52822@wonkity.com> <86zjkkr5ma.fsf@nine.des.no> <alpine.BSF.2.00.1403210740240.13682@wonkity.com> <86fvmbzlbn.fsf@nine.des.no> <alpine.BSF.2.00.1403211030450.14887@wonkity.com> Date: Fri, 21 Mar 2014 17:54:13 +0100 In-Reply-To: <alpine.BSF.2.00.1403211030450.14887@wonkity.com> (Warren Block's message of "Fri, 21 Mar 2014 10:40:16 -0600 (MDT)") Message-ID: <86mwgj7aru.fsf@nine.des.no> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Cc: jilles@freebsd.org, freebsd-current@freebsd.org, Mariusz Zaborski <oshogbo@freebsd.org>, freebsd-arch@freebsd.org X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Discussion related to FreeBSD architecture <freebsd-arch.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-arch>, <mailto:freebsd-arch-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-arch/> List-Post: <mailto:freebsd-arch@freebsd.org> List-Help: <mailto:freebsd-arch-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-arch>, <mailto:freebsd-arch-request@freebsd.org?subject=subscribe> X-List-Received-Date: Fri, 21 Mar 2014 16:54:22 -0000 Warren Block <wblock@wonkity.com> writes: > Dag-Erling Sm=C3=B8rgrav <des@des.no> writes: > > I mean the FreeBSD project, and the reason is as John stated: all > > sentences must start with a capital letter. I've gotten so used to > > this over the past 15 years that I even do it in email and other > > non-FreeBSD written material. > "Because it's been that way for 15 years" is not always a > justification (consider BIND in base, for example :). "I don't like your answer, so I will ignore it" is not a justification either. It's kindergarden behavior and beneath the dignity of a FreeBSD committer. We have a rule that sentences must always start with a capital letter. The fact that this rule was instituted 15 years ago does not automatically invalidate it, and neither does the fact that Joe Random Committer disagrees with it. DES --=20 Dag-Erling Sm=C3=B8rgrav - des@des.no
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.00.1403211030450.14887>