From owner-freebsd-doc Mon Aug 9 17:15:13 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp11.bellglobal.com (smtp11.bellglobal.com [204.101.251.53]) by hub.freebsd.org (Postfix) with ESMTP id 7C4AE1519C; Mon, 9 Aug 1999 17:15:09 -0700 (PDT) (envelope-from vanderh@ecf.toronto.edu) Received: from localhost.nowhere (ppp18330.on.bellglobal.com [206.172.130.10]) by smtp11.bellglobal.com (8.8.5/8.8.5) with ESMTP id UAA27625; Mon, 9 Aug 1999 20:14:50 -0400 (EDT) Received: (from tim@localhost) by localhost.nowhere (8.9.3/8.9.1) id UAA00609; Mon, 9 Aug 1999 20:13:02 -0400 (EDT) (envelope-from tim) Date: Mon, 9 Aug 1999 20:13:01 -0400 From: Tim Vanderhoek To: Nik Clayton Cc: freebsd-doc@freebsd.org Subject: Re: docs/13020: Manpage capitalization Message-ID: <19990809201301.C433@mad> References: <199908081400.HAA63051@freefall.freebsd.org> <19990809232741.A77237@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <19990809232741.A77237@catkin.nothing-going-on.org>; from Nik Clayton on Mon, Aug 09, 1999 at 11:27:41PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Aug 09, 1999 at 11:27:41PM +0100, Nik Clayton wrote: > > For example; > > Edit the /etc/fstab file when you add a new disk. > > vs. > > Edit /etc/fstab when you add a new disk. > > (The second approach, is, IMHO, better). Absolutely. But I'm always a little cautious just to make sure it's clear to the end reader that /etc/fstab is a file (particularly when I only know it's a file because I'm reading the marked-up source). > I have no problem with lower case function names at the beginning of > sentances. To use an analogy, if you were writing about the company I have a pretty big problem with lower-case first letters, especially given that mdoc will sometimes single-space after a period. -- This is done by setting .Ev BOO_ENV . .Xr function 5 will know what you mean. -- Would be rendered as -- This is done by setting BOO_ENV. function(5) will know what you mean. -- Which makes me want to kill someone. Usually the person who forced me into writing it that way. :) > "eTrade", you wouldn't capitalise the first "e" if the company name was > the first word in a sentance. If I was forced to put ``eTrade'' at the beginning of a sentence, I would write "Company eTrade has sold 10 shares to Nik". I wouldn't try to force this particular quirk of mine on anyone else, though. :-) -- This is my .signature which gets appended to the end of my messages. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message