From owner-freebsd-doc Tue Apr 2 3: 0:22 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 CB4C537B405 for ; Tue, 2 Apr 2002 03:00:06 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g32B06W53889; Tue, 2 Apr 2002 03:00:06 -0800 (PST) (envelope-from gnats) Date: Tue, 2 Apr 2002 03:00:06 -0800 (PST) Message-Id: <200204021100.g32B06W53889@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: Peter Pentchev Subject: Re: docs/36448: [PATCH] intro(8) Reply-To: Peter Pentchev 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: Peter Pentchev To: Tom Rhodes Cc: bug-followup@FreeBSD.org Subject: Re: docs/36448: [PATCH] intro(8) Date: Tue, 2 Apr 2002 13:57:23 +0300 On Mon, Apr 01, 2002 at 09:37:17PM -0500, Tom Rhodes wrote: > On Mon, 1 Apr 2002 18:20:02 -0800 (PST) > wrote: > > > > 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 > > oooops, I fixed the blank lines in a new diff... If/when committed, > the diff will not have them ;) sorry hehe You may also want to break the second sentence, 'Its value may be..', onto a new line :) Also, 'errors codes' might be better as 'error codes' (singular 'error'), and the final 'manuals' might be replaced with 'manual pages'. But then, this is just MHO :) G'luck, Peter -- Peter Pentchev roam@ringlet.net roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 If there were no counterfactuals, this sentence would not have been paradoxical. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message