Date: Thu, 20 Mar 2014 21:13:01 +0100 From: =?utf-8?Q?Dag-Erling_Sm=C3=B8rgrav?= <des@des.no> To: Warren Block <wblock@wonkity.com> Cc: jilles@freebsd.org, freebsd-arch@freebsd.org, freebsd-current@freebsd.org, Mariusz Zaborski <oshogbo@freebsd.org> Subject: Re: Hello fdclose Message-ID: <86zjkkr5ma.fsf@nine.des.no> 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)") 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>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?86zjkkr5ma.fsf>