From owner-freebsd-doc Sun Feb 16 14:50:16 2003 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B36CF37B401 for ; Sun, 16 Feb 2003 14:50:14 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 437A543F3F for ; Sun, 16 Feb 2003 14:50:14 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id h1GMoENS057112 for ; Sun, 16 Feb 2003 14:50:14 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.6/8.12.6/Submit) id h1GMoDCv057111; Sun, 16 Feb 2003 14:50:13 -0800 (PST) Date: Sun, 16 Feb 2003 14:50:13 -0800 (PST) Message-Id: <200302162250.h1GMoDCv057111@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: Tom Rhodes Subject: Re: docs/48125: [PATCH] Incorrect errno strings in intro(2) Reply-To: Tom Rhodes Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/48125; it has been noted by GNATS. From: Tom Rhodes To: Per Hedeland Cc: freebsd-doc@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.org, Greg Lehey , Bruce Evans Subject: Re: docs/48125: [PATCH] Incorrect errno strings in intro(2) Date: Sun, 16 Feb 2003 17:43:34 -0500 On Sun, 16 Feb 2003 13:30:16 -0800 (PST) Per Hedeland wrote: > However, regarding the contractions: I can see where you're coming > from, since I gather that using them in "formal" documents is frowned > upon - True, > but I must really strongly disagree with your suggestion to change > the code! The output of programs should not be changed for such > "frivolous" reasons - e.g. there may well be scripts etc out there > that, however unwisely, rely on the exact format of error messages to > function correctly. Not to mention that using contractions in error > messages is a long-standing Unix tradition, even in cases where the > message doesn't originate in sys_errlist. however to my knowledge when Bell Labs originally started producing UNIX the code was actually changed to match the documentation in many instances. People with more knowledge of UNIX history would be better to ask about that, though. I just remember reading something like that, Bruce Evans (bde) or Greg Lehey (grog) come to mind as the correct people to ask. > > I'd suggest that either you consider these strings to not be part of > the actual "document text" (which would be correct I think), and > thereby exempt from considerations of "good writing style" - or if > that isn't acceptable, leave the "Cannot"s in the man page and the > "Can't"s in the code - this discrepancy shouldn't matter *too* much > to the reader, who is unlikely to be searching the man page for > "Can't" anyway... To the best of my knowledge, use of contractions is frowned upon in FreeBSD. Again, this is an issue to take up with the respected parties. I've taken the liberty to cc: them for input. Ideas? -- Tom Rhodes To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message