Re: Hello fdclose

From: Dag-Erling Smørgrav <des_at_des.no>
Date: Thu, 20 Mar 2014 21:13:01 +0100
Warren Block <wblock_at_wonkity.com> writes:
> John Baldwin <jhb_at_freebsd.org> writes:
> > Warren Block <wblock_at_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#writing-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
-- 
Dag-Erling Smørgrav - des_at_des.no
Received on Thu Mar 20 2014 - 19:13:10 UTC

This archive was generated by hypermail 2.4.0 : Wed May 19 2021 - 11:40:47 UTC