From owner-freebsd-doc  Mon Nov 19  9:16:56 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from relay3-gui.server.ntli.net (relay3-gui.server.ntli.net [194.168.4.200])
	by hub.freebsd.org (Postfix) with ESMTP
	id 1879A37B418; Mon, 19 Nov 2001 09:16:52 -0800 (PST)
Received: from pc3-card3-0-cust122.cdf.cable.ntl.com
	([62.254.251.122] helo=rhadamanth.private.submonkey.net ident=exim)
	by relay3-gui.server.ntli.net with esmtp (Exim 3.03 #2)
	id 165s2K-0004S8-00; Mon, 19 Nov 2001 17:16:48 +0000
Received: from setantae by rhadamanth.private.submonkey.net with local (Exim 3.33 #1)
	id 165s26-000HtJ-00; Mon, 19 Nov 2001 17:16:34 +0000
Date: Mon, 19 Nov 2001 17:16:34 +0000
From: setantae <setantae@submonkey.net>
To: charon@labs.gr
Cc: doc@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/32082: true.1 totally incorrect
Message-ID: <20011119171634.GC68651@rhadamanth>
Mail-Followup-To: setantae <setantae@rhadamanth.FreeBSD.ORG>,
	charon@labs.gr, doc@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.ORG
References: <200111191500.fAJF04X09151@freefall.freebsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <200111191500.fAJF04X09151@freefall.freebsd.org>
User-Agent: Mutt/1.3.23.2i
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

On Mon, Nov 19, 2001 at 07:00:04AM -0800, setantae wrote:
>  
>  True. While the version of true(1) that we are shipping will always
>  exit with a status of 1, I'm not sure that's portable.
>  I tried to check to see if POSIX guarantees `one', or just `non-zero',
>  but it would appear that you have to be a member to look at the
>  standard ??

I've been furnished with a copy of the standard for false(1), and
the outcome is that it just needs to be non-zero.
Therefore, I suggest we use this patch :

diff -rc src/usr.bin.old/false/false.1 src/usr.bin/false/false.1
*** src/usr.bin.old/false/false.1	Mon Nov 19 11:08:41 2001
--- src/usr.bin/false/false.1	Mon Nov 19 11:17:21 2001
***************
*** 46,62 ****
  .Sh DESCRIPTION
  The
  .Nm
! command is usually used in a Bourne shell script.
! It tests for the appropriate status "false" before running
! (or failing to run) a list of commands.
! .Pp
! The
! .Nm
! utility always exits with a value other than zero.
  .Sh SEE ALSO
  .Xr csh 1 ,
  .Xr sh 1 ,
  .Xr true 1
  .Sh STANDARDS
  The
  .Nm
--- 46,60 ----
  .Sh DESCRIPTION
  The
  .Nm
! command does nothing but exit with a non-zero status.
  .Sh SEE ALSO
  .Xr csh 1 ,
  .Xr sh 1 ,
  .Xr true 1
+ .Sh DIAGNOSTICS
+ The
+ .Nm
+ utility always returns with a non-zero exit code.
  .Sh STANDARDS
  The
  .Nm
diff -rc src/usr.bin.old/true/true.1 src/usr.bin/true/true.1
*** src/usr.bin.old/true/true.1	Sun Nov 18 20:08:15 2001
--- src/usr.bin/true/true.1	Mon Nov 19 11:18:11 2001
***************
*** 46,54 ****
  .Sh DESCRIPTION
  The
  .Nm
! command is normally used in a Bourne shell script.
! It tests for the appropriate status "false" before running
! (or failing to run) a list of commands.
  .Sh SEE ALSO
  .Xr csh 1 ,
  .Xr false 1 ,
--- 46,52 ----
  .Sh DESCRIPTION
  The
  .Nm
! command does nothing but exit with a status code of zero.
  .Sh SEE ALSO
  .Xr csh 1 ,
  .Xr false 1 ,

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message