Hello fdclose

Dag-Erling Smørgrav des at des.no
Thu Mar 20 20:13:10 UTC 2014


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


More information about the freebsd-arch mailing list