From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from acme.spoerlein.net (acme.spoerlein.net [188.72.220.29])
	by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o7TI6EaX027601
	for <discuss@mdocml.bsd.lv>; Sun, 29 Aug 2010 14:06:15 -0400 (EDT)
Received: from acme.spoerlein.net (localhost.spoerlein.net [IPv6:::1])
	by acme.spoerlein.net (8.14.4/8.14.4) with ESMTP id o7TI6DXk025152
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Sun, 29 Aug 2010 20:06:14 +0200 (CEST)
	(envelope-from uqs@spoerlein.net)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=spoerlein.net;
	s=dkim200908; t=1283105174;
	bh=Bf1e/jjoAiCAuWUTkEHmJLYK+a25JUXXZA8/wY7J3bI=;
	h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version:
	 Content-Type:Content-Transfer-Encoding:In-Reply-To;
	b=bZCvE9qPl3XhSOgofXQtJfaSd4J+2LEn4tEGQpF8GbHQ/U1u5uWqM6gl1dKZT+5iN
	 i7oiSwy+XgtXHEaKzQUcMFWy5LE1ybgwHTknd2tA6CZ9fENhQJhSuUbrnH+Zz8qqbw
	 Fd80f3NHOF8+uFedmkSmLDJyQqU7NQe0ui3bulCc=
Received: (from uqs@localhost)
	by acme.spoerlein.net (8.14.4/8.14.4/Submit) id o7TI6D9m025151;
	Sun, 29 Aug 2010 20:06:13 +0200 (CEST)
	(envelope-from uqs@spoerlein.net)
Date: Sun, 29 Aug 2010 20:06:13 +0200
From: Ulrich =?utf-8?B?U3DDtnJsZWlu?= <uqs@spoerlein.net>
To: discuss@mdocml.bsd.lv
Cc: Thomas Klausner <wiz@NetBSD.org>
Subject: Re: mdoc.7: tweak skeleton file
Message-ID: <20100829180613.GI3523@acme.spoerlein.net>
References: <4C7988EC.2050603@bsd.lv>
 <20100828223857.GH25626@bramka.kerhand.co.uk>
 <4C79986D.6050801@bsd.lv>
 <20100829091037.GA10462@bramka.kerhand.co.uk>
 <20100829105032.GD12803@danbala.tuwien.ac.at>
 <sfid-H20100829-133323-+036.26-1@spamfilter.osbf.lua>
 <20100829113310.GB10462@bramka.kerhand.co.uk>
 <20100829120937.GF12803@danbala.tuwien.ac.at>
 <20100829161701.GC10462@bramka.kerhand.co.uk>
 <4C7A983C.3000900@bsd.lv>
X-Mailinglist: mdocml-discuss
Reply-To: discuss@mdocml.bsd.lv
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <4C7A983C.3000900@bsd.lv>
User-Agent: Mutt/1.5.20 (2009-06-14)

On Sun, 29.08.2010 at 19:26:20 +0200, Kristaps Džonsons wrote:
> > well, there is nothing to say we have to move it at all. it can stay in the
> > place it always was.
> > 
> > however for openbsd, the choice is not so important - we currently don;t
> > have EXIT STATUS, so as far as workload goes, it's irrelevant where we add
> > it.
> > 
> > i personally think it is best placed immediately after DESCRIPTION,
> > where it always was. please let us not just think about what posix does
> > when making this decision. i'd welcome feedback from any freebsd people
> > at this point - maybe there was a good reason for the change.
> > 
> > anyway, my diff below should make us match (almost) for mdoclint. note
> > that you need to make "IMPLEMENTATION NOTES" defined for netbsd only,
> > and "EXIT STATUS" now not os-specific.
> > 
> > let me know what you want to do about section placement.
> 
> Note that Ruslan, whom I understand does a lot of FreeBSD manual stuff, 
> isn't part of this list.  So if you want to involve him, you'll have to 
> CC him...

I can't speak with any authority on this topic, as it far predates my
mdoc involvement.

But this is the blessed ordering for the FreeBSD manpages, where EXIT
STATUS was taken (and ordered) from the POSIX manpages.

sections = [
    '00',
    'NAME',
    'LIBRARY',
    'SYNOPSIS',
    'DESCRIPTION',
    'IMPLEMENTATION NOTES',
    'RETURN VALUES',
    'ENVIRONMENT',
    'FILES',
    'EXIT STATUS',
    'EXAMPLES',
    'DIAGNOSTICS',
    'COMPATIBILITY',
    'ERRORS',
    'SEE ALSO',
    'STANDARDS',
    'HISTORY',
    'AUTHORS',
    'CAVEATS',
    'BUGS',
    'SECURITY CONSIDERATIONS',
]
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv