From owner-freebsd-doc Sun Aug 8 7: 1:39 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 9D56C14E9E for ; Sun, 8 Aug 1999 07:01:37 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id HAA63051; Sun, 8 Aug 1999 07:00:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Sun, 8 Aug 1999 07:00:03 -0700 (PDT) Message-Id: <199908081400.HAA63051@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Tim Vanderhoek Subject: Re: docs/13020: Manpage capitalization Reply-To: Tim Vanderhoek Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13020; it has been noted by GNATS. From: Tim Vanderhoek To: tomoShige Tashiro Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/13020: Manpage capitalization Date: Sun, 8 Aug 1999 09:51:18 -0400 On Sun, Aug 08, 1999 at 12:46:34PM +0900, tomoShige Tashiro wrote: > > I found Capitalized function call 'Putc' in man 3 putc, > in Feb 1999 (docs/10247) and send-pr and fixed by Mr.hoek. They are illegal only when they bother someone... > About a half of manpages are written in 2. and 4. > and last half of manpages are written in 3. The _New_Hacker_Dictionary_ suggests moving function-names, etc. away from the beginning of sentences. I usually try to do this. In lue of that, I prefer writing "The gack() will return NULL on failure.". I appear to be alone in preferring this to "The gack() function will return NULL on failure.". > But I think, if it's not strange for native English speakers, > then thats O.K. and no need to fix them. I think we should leave the PR open for about a year (until September, 2000). If nobody has dealt with it by that time, then it should be closed ("state: filibustered" :-). -- 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