From owner-freebsd-arch@FreeBSD.ORG  Thu Mar 20 20:13:10 2014
Return-Path: <owner-freebsd-arch@FreeBSD.ORG>
Delivered-To: freebsd-arch@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 10DF8C35;
 Thu, 20 Mar 2014 20:13:10 +0000 (UTC)
Received: from smtp.des.no (smtp.des.no [194.63.250.102])
 by mx1.freebsd.org (Postfix) with ESMTP id C31A5C29;
 Thu, 20 Mar 2014 20:13:09 +0000 (UTC)
Received: from nine.des.no (smtp.des.no [194.63.250.102])
 by smtp-int.des.no (Postfix) with ESMTP id E73C2644A;
 Thu, 20 Mar 2014 20:13:08 +0000 (UTC)
Received: by nine.des.no (Postfix, from userid 1001)
 id 71B2CF23; Thu, 20 Mar 2014 21:13:01 +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>
Date: Thu, 20 Mar 2014 21:13:01 +0100
In-Reply-To: <alpine.BSF.2.00.1403191407240.52822@wonkity.com> (Warren Block's
 message of "Wed, 19 Mar 2014 14:28:15 -0600 (MDT)")
Message-ID: <86zjkkr5ma.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-arch@freebsd.org, freebsd-current@freebsd.org,
 Mariusz Zaborski <oshogbo@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: Thu, 20 Mar 2014 20:13:10 -0000

Warren Block <wblock@wonkity.com> writes:
> John Baldwin <jhb@freebsd.org> writes:
> > Warren Block <wblock@wonkity.com> writes:
> > > .Fn fdclose
> > > is equivalent to
> > > .Fn fclose ,
> > > but the file descriptor is returned rather than closed.
> > Yes, but this has the 'no capital letter at the start of a sentence'
> > problem.
> I've heard that mentioned before, but have never seen any actual rule
> regarding it.  And we do have actual rules about avoiding redundant
> phrases:
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/book.html#wri=
ting-style-guidelines

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.

DES
--=20
Dag-Erling Sm=C3=B8rgrav - des@des.no