Re: EXIT STATUS for section 6

[Ingo Schwarze <schwarze@usta.de>]

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.
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
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv