From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from danbala.tuwien.ac.at (danbala.ifoer.tuwien.ac.at [128.130.168.64])
	by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o7TAoXnn021425
	for <discuss@mdocml.bsd.lv>; Sun, 29 Aug 2010 06:50:34 -0400 (EDT)
Received: by danbala.tuwien.ac.at (Postfix, from userid 116)
	id 2FB0E391C89; Sun, 29 Aug 2010 12:50:32 +0200 (MEST)
Date: Sun, 29 Aug 2010 12:50:32 +0200
From: Thomas Klausner <wiz@NetBSD.org>
To: Jason McIntyre <jmc@kerhand.co.uk>
Cc: discuss@mdocml.bsd.lv
Subject: Re: mdoc.7: tweak skeleton file
Message-ID: <20100829105032.GD12803@danbala.tuwien.ac.at>
References: <20100826182407.GD31244@bramka.kerhand.co.uk>
 <4C797BBE.7060500@bsd.lv>
 <20100828220118.GE25626@bramka.kerhand.co.uk>
 <4C7988EC.2050603@bsd.lv>
 <20100828223857.GH25626@bramka.kerhand.co.uk>
 <4C79986D.6050801@bsd.lv>
 <sfid-H20100829-111054-+034.82-1@spamfilter.osbf.lua>
 <20100829091037.GA10462@bramka.kerhand.co.uk>
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: <20100829091037.GA10462@bramka.kerhand.co.uk>

On Sun, Aug 29, 2010 at 10:10:13AM +0100, Jason McIntyre wrote:
> but i'm willing to bet that no netbsd pages ever changed to follow this
> difference, and EXIT STATUS is still where it always was. netbsd's own
> man page checker, mdoclint, still reflects this. furthermore it is
> oblivious to the concept of a ("wanky", in kristaps' words)
> IMPLEMENTATION NOTES section.
> 
> here is the section and ordering mdoclint follows (correct me if i'm
> wrong, thomas):
> 
> 	my @sections = (
> 		"NAME",
> 		NETBSD ? "LIBRARY" : undef,
> 		"SYNOPSIS",
> 		"DESCRIPTION",
> 		"EXIT STATUS",
> 		"RETURN VALUES",
> 		"ENVIRONMENT",
> 		"FILES",
> 		"EXAMPLES",
> 		"DIAGNOSTICS",
> 		"ERRORS",
> 		"SEE ALSO",
> 		"STANDARDS",
> 		"HISTORY",
> 		"AUTHORS",
> 		"CAVEATS",
> 		"BUGS",
> 		NETBSD ? "SECURITY CONSIDERATIONS" : undef
> 	);

Well, here's the correction. That's the order currently checked by
pkgsrc/textproc/mdoclint/files/mdoclint:
        my @sections = (
                "NAME",
                NETBSD ? "LIBRARY" : undef,
                "SYNOPSIS",
                "DESCRIPTION",
                "IMPLEMENTATION NOTES",
                "RETURN VALUES",
                "ENVIRONMENT",
                "FILES",
                "EXIT STATUS",
                "EXAMPLES",
                "DIAGNOSTICS",
                "COMPATIBILITY",
                "ERRORS",
                "SEE ALSO",
                "STANDARDS",
                "HISTORY",
                "AUTHORS",
                "CAVEATS",
                "BUGS",
                NETBSD ? "SECURITY CONSIDERATIONS" : undef
        );

(Btw, pages actually using IMPLEMENTATION NOTES are e.g. bdes(1),
which compares to Sun's implementation; or stdio(3), which mentions
which functions are macros or support locking.)

Cheers,
 Thomas
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv