From owner-freebsd-doc Tue Apr 2 7:49:42 2002 Delivered-To: freebsd-doc@freebsd.org Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by hub.freebsd.org (Postfix) with ESMTP id D082A37B41F for ; Tue, 2 Apr 2002 07:48:58 -0800 (PST) Received: from localhost (lcl234.zbzoom.net [208.236.36.234]) by pittgoth.com (8.11.6/8.11.6) with SMTP id g32FmVq99992; Tue, 2 Apr 2002 10:48:36 -0500 (EST) (envelope-from darklogik@pittgoth.com) Date: Tue, 2 Apr 2002 10:56:29 -0500 From: Tom Rhodes To: Peter Pentchev Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/36448: [PATCH] intro(8) Message-Id: <20020402105629.429a7cb3.darklogik@pittgoth.com> In-Reply-To: <200204021100.g32B06W53889@freefall.freebsd.org> References: <200204021100.g32B06W53889@freefall.freebsd.org> X-Mailer: Sylpheed version 0.7.4 (GTK+ 1.2.10; i386-portbld-freebsd4.5) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit 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 On Tue, 2 Apr 2002 03:00:06 -0800 (PST) Peter Pentchev wrote: > 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 > Noted Thanks! -- Tom (Darklogik) Rhodes www.FreeBSD.org -The Power To Serve www.Pittgoth.com -Pittgoth Discussion Portal trhodes@{Pittgoth.com, FreeBSD.org} PGP key by www: http://www.pittgoth.com/~darklogik/darklogik.key To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message