From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from kerhand.co.uk (_smtpd@82-69-137-214.dsl.in-addr.zen.co.uk [82.69.137.214]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o7T9AcBG022706 for ; Sun, 29 Aug 2010 05:10:39 -0400 (EDT) Received: from localhost (1000@localhost [IPv6:::1]) by kerhand.co.uk (OpenSMTPD) with ESMTP id mmdT0rDJ; Sun, 29 Aug 2010 10:10:13 +0100 (BST) Date: Sun, 29 Aug 2010 10:10:13 +0100 From: Jason McIntyre To: discuss@mdocml.bsd.lv Cc: Thomas Klausner Subject: Re: mdoc.7: tweak skeleton file Message-ID: <20100829091037.GA10462@bramka.kerhand.co.uk> 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> 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: <4C79986D.6050801@bsd.lv> User-Agent: Mutt/1.4.2.3i On Sun, Aug 29, 2010 at 01:14:53AM +0200, Kristaps Dzonsons wrote: > > > >oops, except all our section ordering is mad. is this diff correct? > >please note some very suble changes ;( > > Enclosed are the three CVS copies of mdoc.7, man.7, and mdoc.template. > It's probably easiest to just diff these against your fixes to see if > I've mangled anything... > > >on a side note, there is an IMPLEMENTATION NOTES section, which is not > >recognised by us or mdoclint. can we kill it? > > It can get a "Not used in OpenBSD line": it's up to you. Note the > previous discussion about sections: > > http://mdocml.bsd.lv/archives/discuss/0006.html > most worrying is that i actually was part of that discussion ;( apologies to ulrich (and everyone else) that i am revisiting a subject we already debated. man, what a mess! freebsd put EXIT STATUS in a different place, apparently because of posix. do i have this right? then the mandoc project copied this ordering. 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 ); does anyone know of a good reason to move EXIT STATUS, other than because posix says so? is anyone from netbsd going to change their pages? jmc -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv