From owner-freebsd-doc@FreeBSD.ORG Tue Jan 6 23:43:13 2009 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8BAF4106564A; Tue, 6 Jan 2009 23:43:13 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from mx-out.forthnet.gr (mx-out.forthnet.gr [193.92.150.104]) by mx1.freebsd.org (Postfix) with ESMTP id EC0438FC13; Tue, 6 Jan 2009 23:43:12 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from mx-av-03.forthnet.gr (mx-av.forthnet.gr [193.92.150.27]) by mx-out-04.forthnet.gr (8.14.3/8.14.3) with ESMTP id n06NEf4P027445; Wed, 7 Jan 2009 01:14:41 +0200 Received: from MX-IN-01.forthnet.gr (mx-in-01.forthnet.gr [193.92.150.23]) by mx-av-03.forthnet.gr (8.14.3/8.14.3) with ESMTP id n06NEf0d009889; Wed, 7 Jan 2009 01:14:41 +0200 Received: from kobe.laptop (ppp160-148.adsl.forthnet.gr [194.219.40.148]) by MX-IN-01.forthnet.gr (8.14.3/8.14.3) with ESMTP id n06NEXht016163; Wed, 7 Jan 2009 01:14:34 +0200 Authentication-Results: MX-IN-01.forthnet.gr smtp.mail=keramida@ceid.upatras.gr; spf=neutral Authentication-Results: MX-IN-01.forthnet.gr header.from=keramida@ceid.upatras.gr; sender-id=neutral Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id n06NEXts091089; Wed, 7 Jan 2009 01:14:33 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id n06NEWNZ091088; Wed, 7 Jan 2009 01:14:32 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) From: Giorgos Keramidas To: Hiroki Sato In-Reply-To: <20090105.054435.125149473.hrs@allbsd.org> (Hiroki Sato's message of "Mon, 05 Jan 2009 05:44:35 +0900 (JST)") Date: Wed, 07 Jan 2009 01:13:54 +0200 Message-ID: <87vdssqb7x.fsf@kobe.laptop> References: <1289663263.20090104185721@rulez.sk> <20090105.032211.33865530.hrs@allbsd.org> <20090104194844.GB1257@haakonia.hitnet.RWTH-Aachen.DE> <20090105.054435.125149473.hrs@allbsd.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: danger@FreeBSD.org, doc@FreeBSD.org Subject: Re: svn commit: r186737 - head/sbin/geom/class/virstor X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 06 Jan 2009 23:43:13 -0000 On Mon, 05 Jan 2009 05:44:35 +0900 (JST), Hiroki Sato wrote: > 2. Otherwise, EXIT STATUS section should match the reality as > possible. This means if a command returns 0 on success, 1 on > error, and the other values are not returned, the description in > the manual page should be "it exits 0 on success, and 1 if an > error occurs". Agreed. There are tools that assign special meanings to separate >0 error codes, i.e. diff3(1) which exits with: 0 when successful 1 when there are conflicts in the three files being merged 2 when something unexpected but bad nonetheless happens Being precise about the error codes is critical in this case. It may be equally important in other places too.