Re: mdoc.7: tweak skeleton file

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

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