From owner-freebsd-doc Tue Nov 20 1:50: 4 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 2664437B419 for ; Tue, 20 Nov 2001 01:50:02 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.4/8.11.4) id fAK9o2c26730; Tue, 20 Nov 2001 01:50:02 -0800 (PST) (envelope-from gnats) Date: Tue, 20 Nov 2001 01:50:02 -0800 (PST) Message-Id: <200111200950.fAK9o2c26730@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: setantae Subject: Re: docs/32082: true.1 totally incorrect Reply-To: setantae 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/32082; it has been noted by GNATS. From: setantae To: Ruslan Ermilov Cc: freebsd-doc@freebsd.org, swear@blarg.net, FreeBSD-gnats-submit@FreeBSD.ORG Subject: Re: docs/32082: true.1 totally incorrect Date: Tue, 20 Nov 2001 09:39:39 +0000 On Tue, Nov 20, 2001 at 01:30:01AM -0800, Ruslan Ermilov wrote: > > > I think "true" and "false" should not bother with DIAGNOSTIC sections, > > but if used they should match the description's terminology and sense. > > > I agree. Me too. I just tried to fit in with stuff like ls(1) and mv(1), but it doesn't seem necessary in these cases. > > It's debatable whether the status of "false" should be given as "one" or > > "non-zero". Should man pages describe the actual program or the presumed > > specification of the program? What specification should be presumed in > > this case? > > > These manpages clain the conformance to POSIX, and POSIX says false(1) > should always return with a non-zero exit code, hence we should use > "non-zero". Seconded (that's why I wanted to see the standard). > Finally, I suggest to commit the following: Suits me. Ceri -- keep a mild groove on To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message