From owner-freebsd-doc Mon Apr 1 18:20:10 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 5160237B417 for ; Mon, 1 Apr 2002 18:20:02 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g322K2s30257; Mon, 1 Apr 2002 18:20:02 -0800 (PST) (envelope-from gnats) Date: Mon, 1 Apr 2002 18:20:02 -0800 (PST) Message-Id: <200204020220.g322K2s30257@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: Subject: Re: docs/36448: [PATCH] intro(8) Reply-To: 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/36448; it has been noted by GNATS. From: To: FreeBSD-gnats-submit@FreeBSD.org Cc: Subject: Re: docs/36448: [PATCH] intro(8) Date: Mon, 1 Apr 2002 18:19:50 -0800 (PST) Gary, what do you think of the following patch to intro(8)? -- Tom (darklogik) Rhodes --- intro.8.old Mon Apr 1 21:05:13 2002 +++ intro.8 Mon Apr 1 21:06:52 2002 @@ -65,6 +65,19 @@ .Ql Xr crash should be consulted to understand how to interpret system crash dumps. + +.Pp +All commands set an exit status. Its value may be tested +to see if the command completed normally. +Unless otherwise noted (rare), the value 0 signifies successful +completion of the command, while a value >0 indicates an error. +Some commands attempt to describe the nature of the failure by using +errors codes defined in +.Xr sysexits 3 , +or set the status to arbitrary values >0 (typically 1), but many +such values are not described in the manuals. + + .Sh HISTORY The .Nm To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message