* EXIT STATUS for section 6
@ 2010-09-03 12:57 ` Jason McIntyre
2010-09-03 16:29 ` Thomas Klausner
0 siblings, 1 reply; 6+ messages in thread
From: Jason McIntyre @ 2010-09-03 12:57 UTC (permalink / raw)
To: discuss
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?
openbsd has no exit status info in any of its section 6 pages. ok?
jmc
Index: man.7
===================================================================
RCS file: /cvs/src/share/man/man7/man.7,v
retrieving revision 1.8
diff -u -r1.8 man.7
--- man.7 31 Aug 2010 17:51:31 -0000 1.8
+++ man.7 3 Sep 2010 12:56:15 -0000
@@ -306,7 +306,7 @@
the file is used (created, modified, etc.).
.It Em EXIT STATUS
This section documents the command exit status for
-section 1, 6, and 8 utilities.
+section 1 and 8 utilities.
Historically, this information was described in
.Em DIAGNOSTICS ,
a practise that is now discouraged.
Index: mdoc.7
===================================================================
RCS file: /cvs/src/share/man/man7/mdoc.7,v
retrieving revision 1.50
diff -u -r1.50 mdoc.7
--- mdoc.7 31 Aug 2010 17:51:31 -0000 1.50
+++ mdoc.7 3 Sep 2010 12:56:18 -0000
@@ -518,7 +518,7 @@
.Sx \&Pa .
.It Em EXIT STATUS
This section documents the
-command exit status for section 1, 6, and 8 utilities.
+command exit status for section 1 and 8 utilities.
Historically, this information was described in
.Em DIAGNOSTICS ,
a practise that is now discouraged.
--
To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: EXIT STATUS for section 6
2010-09-03 12:57 ` EXIT STATUS for section 6 Jason McIntyre
@ 2010-09-03 16:29 ` Thomas Klausner
2010-09-03 19:28 ` Jason McIntyre
0 siblings, 1 reply; 6+ messages in thread
From: Thomas Klausner @ 2010-09-03 16:29 UTC (permalink / raw)
To: discuss
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.
> 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? :)
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.
Thomas
--
To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: EXIT STATUS for section 6
2010-09-03 16:29 ` Thomas Klausner
@ 2010-09-03 19:28 ` Jason McIntyre
2010-09-03 22:42 ` Ingo Schwarze
0 siblings, 1 reply; 6+ messages in thread
From: Jason McIntyre @ 2010-09-03 19:28 UTC (permalink / raw)
To: discuss
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.
> > 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.
> 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.
jmc
--
To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: EXIT STATUS for section 6
2010-09-03 19:28 ` Jason McIntyre
@ 2010-09-03 22:42 ` Ingo Schwarze
2010-09-04 6:52 ` Jason McIntyre
0 siblings, 1 reply; 6+ messages in thread
From: Ingo Schwarze @ 2010-09-03 22:42 UTC (permalink / raw)
To: discuss
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
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: EXIT STATUS for section 6
2010-09-03 22:42 ` Ingo Schwarze
@ 2010-09-04 6:52 ` Jason McIntyre
2010-09-04 17:22 ` Kristaps Dzonsons
0 siblings, 1 reply; 6+ messages in thread
From: Jason McIntyre @ 2010-09-04 6:52 UTC (permalink / raw)
To: discuss
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
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: EXIT STATUS for section 6
2010-09-04 6:52 ` Jason McIntyre
@ 2010-09-04 17:22 ` Kristaps Dzonsons
0 siblings, 0 replies; 6+ messages in thread
From: Kristaps Dzonsons @ 2010-09-04 17:22 UTC (permalink / raw)
To: discuss
> fine. so i'll commit the diff below.
> jmc
I've merged this in BSD.lv, too. Thanks!
Kristaps
--
To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2010-09-04 17:23 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
[not found] <sfid-H20100903-145809-+038.18-1@spamfilter.osbf.lua>
2010-09-03 12:57 ` EXIT STATUS for section 6 Jason McIntyre
2010-09-03 16:29 ` Thomas Klausner
2010-09-03 19:28 ` Jason McIntyre
2010-09-03 22:42 ` Ingo Schwarze
2010-09-04 6:52 ` Jason McIntyre
2010-09-04 17:22 ` Kristaps Dzonsons
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).