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 o846qFQK002155 for ; Sat, 4 Sep 2010 02:52:16 -0400 (EDT) Received: from localhost (1000@localhost [IPv6:::1]) by kerhand.co.uk (OpenSMTPD) with ESMTP id mZW6PdVW for ; Sat, 4 Sep 2010 07:51:50 +0100 (BST) Date: Sat, 4 Sep 2010 07:51:49 +0059 From: Jason McIntyre To: discuss@mdocml.bsd.lv Subject: Re: EXIT STATUS for section 6 Message-ID: <20100904065213.GA31090@bramka.kerhand.co.uk> References: <20100903125743.GG9076@bramka.kerhand.co.uk> <20100903162905.GF6084@danbala.tuwien.ac.at> <20100903192831.GB18815@bramka.kerhand.co.uk> <20100903224208.GA5602@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: <20100903224208.GA5602@iris.usta.de> User-Agent: Mutt/1.4.2.3i On Sat, Sep 04, 2010 at 12:42:08AM +0200, Ingo Schwarze wrote: > Hi Jason, hi Thomas, > > Jason McIntyre wrote on Fri, Sep 03, 2010 at 08:28:07PM +0100: > > On Fri, Sep 03, 2010 at 06:29:05PM +0200, Thomas Klausner wrote: > > > On Fri, Sep 03, 2010 at 01:57:19PM +0100, Jason McIntyre wrote: > > >>> the templates say EXIT STATUS is for sections 1 and 8. the descriptions > >>> of EXIT STATUS say it is for sections 1, 6, and 8. which is it? > > >> Section 6 are games, so they could have an EXIT STATUS. > > > could have, yeah. but don't. > > For some cases, that's a documentation bug. agreed. > Take fortune(6) -m. The EXIT STATUS tells whether there were matches, > which ought to be documented. > Or try /usr/games/banner -w xxx BSD ; echo $? > > >>> openbsd has no exit status info in any of its section 6 pages. ok? > > >> Well, I thought you're only introducing EXIT STATUS in the OpenBSD man > >> pages? :) > > > yeah. but i downcased EXIT STATUS - i meant none of the section 6pages > > have any info about what they return. > > Some should. > > NB: I don't blame you that they don't. But it's a task to read the > program sources and find out whether each one should. > > >> Anyway, i don't see any EXIT STATUS in man6/* on NetBSD either. > >> > >> I think we should allow it for section 6 as well, but I don't care > >> much either way. > > > right, so which way do we fall. section 6 ok or not? i don't care. > > I'm clearly with Thomas here. EXIT STATUS in section 6 is needed. > > Yours, > Ingo fine. so i'll commit the diff below. jmc Index: man/man7/man.7 =================================================================== RCS file: /cvs/src/share/man/man7/man.7,v retrieving revision 1.8 diff -u -r1.8 man.7 --- man/man7/man.7 31 Aug 2010 17:51:31 -0000 1.8 +++ man/man7/man.7 4 Sep 2010 06:51:28 -0000 @@ -234,7 +234,7 @@ \&.\e\*q For sections 1, 6, 7, & 8 only. \&.\e\*q .SH FILES \&.\e\*q .SH EXIT STATUS -\&.\e\*q For sections 1 & 8 only. +\&.\e\*q For sections 1, 6, & 8 only. \&.\e\*q .SH EXAMPLES \&.\e\*q .SH DIAGNOSTICS \&.\e\*q For sections 1, 4, 6, 7, & 8 only. Index: man/man7/mdoc.7 =================================================================== RCS file: /cvs/src/share/man/man7/mdoc.7,v retrieving revision 1.50 diff -u -r1.50 mdoc.7 --- man/man7/mdoc.7 31 Aug 2010 17:51:31 -0000 1.50 +++ man/man7/mdoc.7 4 Sep 2010 06:51:29 -0000 @@ -350,7 +350,7 @@ \&.\e\*q For sections 1, 6, 7, & 8 only. \&.\e\*q .Sh FILES \&.\e\*q .Sh EXIT STATUS -\&.\e\*q For sections 1 & 8 only. +\&.\e\*q For sections 1, 6, & 8 only. \&.\e\*q .Sh EXAMPLES \&.\e\*q .Sh DIAGNOSTICS \&.\e\*q For sections 1, 4, 6, 7, & 8 only. Index: misc/mdoc.template =================================================================== RCS file: /cvs/src/share/misc/mdoc.template,v retrieving revision 1.11 diff -u -r1.11 mdoc.template --- misc/mdoc.template 31 Aug 2010 17:51:31 -0000 1.11 +++ misc/mdoc.template 4 Sep 2010 06:51:29 -0000 @@ -25,7 +25,7 @@ .\" For sections 1, 6, 7 & 8 only. .\" .Sh FILES .\" .Sh EXIT STATUS -.\" For sections 1 & 8 only. +.\" For sections 1, 6, & 8 only. .\" .Sh EXAMPLES .\" .Sh DIAGNOSTICS .\" For sections 1, 4, 6, 7, and 8 only. -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv