Date: Mon, 19 Nov 2001 03:30:02 -0800 (PST) From: setantae <setantae@submonkey.net> To: freebsd-doc@freebsd.org Subject: Re: docs/32082: true.1 totally incorrect Message-ID: <200111191130.fAJBU2549797@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/32082; it has been noted by GNATS. From: setantae <setantae@submonkey.net> To: "Gary W. Swearingen" <swear@blarg.net> Cc: FreeBSD-gnats-submit@FreeBSD.ORG, doc@FreeBSD.org Subject: Re: docs/32082: true.1 totally incorrect Date: Mon, 19 Nov 2001 11:25:58 +0000 On Sun, Nov 18, 2001 at 09:34:29PM -0800, Gary W. Swearingen wrote: > Ceri <setantae@submonkey.net> writes: > > > >Description: > > true.1 states that the appropriate return status from true is "false". > > Which is clearly not the case. > > But it doesn't say that. It says it returns zero, which is correct. Well, it does; it says ``the appropriate status "false"'', which says to me that the appropriate return status from true is "false". But I don't really want to argue about that, as it's not the real point. > > ! It tests for the appropriate status "false" before running > > (or failing to run) a list of commands. > > The "It" here is confusingly referring to a Bourne shell script that > it confusingly brings into the description. Yeah, I didn't really understand that part at all, so I kind of skirted round it. Now that I've got a second opinion which is agreeable, how about this patch instead ? 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 exit code one. .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 return a true status code. .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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200111191130.fAJBU2549797>