From owner-freebsd-doc@FreeBSD.ORG Mon Jan 5 19:46:14 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 A361B106564A; Mon, 5 Jan 2009 19:46:14 +0000 (UTC) (envelope-from chris@hitnet.RWTH-Aachen.DE) Received: from mta-1.ms.rz.rwth-aachen.de (mta-1.ms.rz.RWTH-Aachen.DE [134.130.7.72]) by mx1.freebsd.org (Postfix) with ESMTP id 4BFE68FC0C; Mon, 5 Jan 2009 19:46:14 +0000 (UTC) (envelope-from chris@hitnet.RWTH-Aachen.DE) MIME-version: 1.0 Received: from ironport-out-1.rz.rwth-aachen.de ([134.130.5.40]) by mta-1.ms.rz.RWTH-Aachen.de (Sun Java(tm) System Messaging Server 6.3-7.04 (built Sep 26 2008)) with ESMTP id <0KD000I8PK91SF70@mta-1.ms.rz.RWTH-Aachen.de>; Mon, 05 Jan 2009 20:46:13 +0100 (CET) X-IronPort-AV: E=Sophos;i="4.36,333,1228086000"; d="scan'208";a="95512400" Received: from smarthost-2.ms.rz.rwth-aachen.de (HELO smarthost.rwth-aachen.de) ([134.130.7.90]) by ironport-in-1.rz.rwth-aachen.de with ESMTP; Mon, 05 Jan 2009 20:46:14 +0100 Received: from bigboss.hitnet.rwth-aachen.de (bigspace.hitnet.RWTH-Aachen.DE [137.226.181.2]) by smarthost.rwth-aachen.de (8.13.8+Sun/8.13.8/1) with ESMTP id n05JkDpp002064; Mon, 05 Jan 2009 20:46:13 +0100 (CET) Received: from haakonia.hitnet.rwth-aachen.de ([137.226.181.92]) by bigboss.hitnet.rwth-aachen.de with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.63) (envelope-from ) id 1LJvOv-0005Vs-1n; Mon, 05 Jan 2009 20:46:13 +0100 Received: by haakonia.hitnet.rwth-aachen.de (Postfix, from userid 1001) id EEDBF3F433; Mon, 05 Jan 2009 20:46:12 +0100 (CET) Date: Mon, 05 Jan 2009 20:46:12 +0100 From: Christian Brueffer To: "Simon L. Nielsen" Message-id: <20090105194612.GB1266@haakonia.hitnet.RWTH-Aachen.DE> References: <200901041541.n04Ff1Oh060753@svn.freebsd.org> <20090104155832.GA1257@haakonia.hitnet.RWTH-Aachen.DE> <287359450.20090104174842@rulez.sk> <20090104171455.GC1208@arthur.nitro.dk> Content-type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="4bRzO86E/ozDv8r1" Content-disposition: inline In-reply-to: <20090104171455.GC1208@arthur.nitro.dk> X-Operating-System: FreeBSD 6.4-STABLE X-PGP-Key: http://people.FreeBSD.org/~brueffer/brueffer.key.asc X-PGP-Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D User-Agent: Mutt/1.5.11 Cc: Daniel Gerzo , 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: Mon, 05 Jan 2009 19:46:15 -0000 --4bRzO86E/ozDv8r1 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, Jan 04, 2009 at 06:14:56PM +0100, Simon L. Nielsen wrote: > On 2009.01.04 17:48:42 +0100, Daniel Gerzo wrote: > > Hello Christian, > >=20 > > Sunday, January 4, 2009, 4:58:32 PM, you wrote: > >=20 > > > While using .Ex is good, collapsing EXIT STATUS into DIAGNOSTICS is n= ot. > > > EXIT STATUS is a standard section in our manpages and it's orthogonal= to > > > DIAGNOSTICS. > >=20 > > I am fine to revert this part, however I have trimmed this section > > just because I didn't see it listed in the PAGE STRUCTURE DOMAIN > > section of the mdoc(7) manual page. > >=20 > > Interestingly, it lists the DIAGNOSTICS section and explicitly > > says that .Ex macro should be used there. > >=20 > > If is it still preferred to revert this change, I would like to see > > this section added to the mdoc(7). Thoughts? >=20 > I really like having EXIT STATUS as a seperate section so I can > quickly find out what a program can return with. >=20 > The example(1) (/usr/share/examples/mdoc/example.1) does have EXIT > STATUS. >=20 > I think mentioning it in mdoc(7) seems like a good idea, but you > should probably get ru@'s input on that. >=20 Right, I think ru simply forgot to document it or didn't document it because mdoc(7) is a vendor manpage and EXIT STATUS is a "non-standard mdoc" FreeBSD-specific section. > PS. ping(1) uses RETURN VALUES section instead which should probably > be changed. >=20 Yes, also a nice example of a utility that uses more than just 0 and 1 as exit status. - Christian --=20 Christian Brueffer chris@unixpages.org brueffer@FreeBSD.org GPG Key: http://people.freebsd.org/~brueffer/brueffer.key.asc GPG Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D --4bRzO86E/ozDv8r1 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (FreeBSD) iD8DBQFJYmOEbHYXjKDtmC0RApV0AJ9MAnTZijgiZLCOo0yo+GMNDSzIgQCg1W2x xly2EySLJmok0qv1+SFGI+g= =qNeT -----END PGP SIGNATURE----- --4bRzO86E/ozDv8r1--