From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from kerhand.co.uk (_smtpd@82-69-137-214.dsl.in-addr.zen.co.uk [82.69.137.214]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o746v6CL023139 for ; Wed, 4 Aug 2010 02:57:07 -0400 (EDT) Received: from localhost (1000@localhost [IPv6:::1]) by kerhand.co.uk (OpenSMTPD) with ESMTP id o6o27mrr for ; Wed, 4 Aug 2010 07:56:40 +0100 (BST) Date: Wed, 4 Aug 2010 07:56:40 +0059 From: Jason McIntyre To: discuss@mdocml.bsd.lv Subject: Re: mdoc EXIT STATUS (Was: pending open issues) Message-ID: <20100804065704.GA14417@bramka.kerhand.co.uk> References: <20100727094102.GC21455@bramka.kerhand.co.uk> <4C4EAEE9.9000106@bsd.lv> <20100727101815.GD21455@bramka.kerhand.co.uk> <4C4EC13B.1000906@bsd.lv> <20100727131709.GA16499@edoofus.dev.vega.ru> <4C4EE52F.9020601@bsd.lv> <20100727141538.GA8226@bramka.kerhand.co.uk> <20100728123317.GA43609@edoofus.dev.vega.ru> <20100728133842.GB31150@bramka.kerhand.co.uk> <20100803212854.GC31307@iris.usta.de> X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20100803212854.GC31307@iris.usta.de> User-Agent: Mutt/1.4.2.3i On Tue, Aug 03, 2010 at 11:28:54PM +0200, Ingo Schwarze wrote: > > the exchange of information and opinions where to best put exit status > documentation for section 1, 6, and 8 manuals seems unfinished to me; > if i understand correctly, what FreeBSD and DragonFly want and do is > plain enough (EXIT STATUS), but in NetBSD and OpenBSD, i find such > information sometimes in DESCRIPTION, sometimes in DIAGNOSTICS. > > However, i'm not trying to settle that question today, right in the > middle of the OpenBSD release process. Right now, i'm just proposing > a preliminary patch documenting the status quo, which will hopefully > not remain the last word on this matter. > > I think it is a bad idea to tell people without any reservation > they should use EXIT STATUS when actually, two systems do not > use that section - no matter whether that is "at all" or "not yet". > > OK to commit this for now? > yes, release has come at an awkward time... the discussion is unfinished because netbsd people seem to have disappeared. anyway i personally am alright with the diff, though i'm not convinced it's worth it. mdoc.7 is incorrect in numerous places as regards openbsd. but that was another conversation to pick up once kristaps returns... jmc -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv