From owner-freebsd-chat@FreeBSD.ORG  Wed Jul 29 14:15:32 2009
Return-Path: <owner-freebsd-chat@FreeBSD.ORG>
Delivered-To: freebsd-chat@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 193811065690
	for <freebsd-chat@freebsd.org>; Wed, 29 Jul 2009 14:15:32 +0000 (UTC)
	(envelope-from freebsd-chat-local@be-well.ilk.org)
Received: from mail7.sea5.speakeasy.net (mail7.sea5.speakeasy.net
	[69.17.117.9]) by mx1.freebsd.org (Postfix) with ESMTP id E5B5F8FC20
	for <freebsd-chat@freebsd.org>; Wed, 29 Jul 2009 14:15:31 +0000 (UTC)
	(envelope-from freebsd-chat-local@be-well.ilk.org)
Received: (qmail 9279 invoked from network); 29 Jul 2009 13:48:51 -0000
Received: from dsl092-078-145.bos1.dsl.speakeasy.net (HELO be-well.ilk.org)
	([66.92.78.145])
	(envelope-sender <freebsd-chat-local@be-well.ilk.org>)
	by mail7.sea5.speakeasy.net (qmail-ldap-1.03) with SMTP
	for <emailrob@emailrob.com>; 29 Jul 2009 13:48:51 -0000
Received: by be-well.ilk.org (Postfix, from userid 1147)
	id 5D67E5083C; Wed, 29 Jul 2009 09:48:50 -0400 (EDT)
To: spellberg_robert <emailrob@emailrob.com>
References: <200907281352.n6SDqXur017295@lurza.secnetix.de>
	<4A6F5C31.2000502@emailrob.com>
From: Lowell Gilbert <freebsd-chat-local@be-well.ilk.org>
Date: Wed, 29 Jul 2009 09:48:50 -0400
In-Reply-To: <4A6F5C31.2000502@emailrob.com> (spellberg robert's message of
	"Tue\, 28 Jul 2009 21\:14\:41 +0100")
Message-ID: <444osvbnwd.fsf@be-well.ilk.org>
User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.3 (berkeley-unix)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Cc: fbsd_chat <freebsd-chat@freebsd.org>
Subject: Re: [ fbsd_chat ]  Re:  sh(1) documentation_set
X-BeenThere: freebsd-chat@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: fbsd_chat <freebsd-chat@freebsd.org>
List-Id: Non technical items related to the community
	<freebsd-chat.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-chat>,
	<mailto:freebsd-chat-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-chat>
List-Post: <mailto:freebsd-chat@freebsd.org>
List-Help: <mailto:freebsd-chat-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-chat>,
	<mailto:freebsd-chat-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 29 Jul 2009 14:15:32 -0000

spellberg_robert <emailrob@emailrob.com> writes:

> dear mr. fromme ---

>>  > man_pages need to be, at least, "substantially_complete".
>>
>> I agree that the sh(1) manual page should be complete,
>> and I think it is indeed complete.  Do you think some
>> piece of reference information is missing?
>
> ah_ha, you have arrived at my thesis.
>
> the man_page author states that it is not complete, in the first paragraph.

Not really.  What it says is that the man page is not a complete
*specification*.  That is not the same thing as being incomplete as a
user manual.  When appropriate information is noticed to be missing, it
does get added (as you can confirm from looking at the checkin log for
sh.1).