Re: mdoc EXIT STATUS (Was: pending open issues)

[Jason McIntyre <jmc@kerhand.co.uk>]

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