> i wanted to address the very annoying ordering that has always existed
> in mdoc/mdoc.samples:
> 
> 	.\" This comment applies to the section below.
> 	.\" .Sh BLAH
> 	.\" .Sh SEE ALSO
> 	.\" .Xr foobar 1
> 
> we should put everything relevant to a section underneath the section,
> not before it (like the order you read it). thus my diff changes things:
> 
> 	.\" .Sh SECTION
> 	.\" This comment applies to the BLAH section.
> 	.\" .Sh SEE ALSO
> 	.\" .Xr foobar 1
> 
> ...and since i am in here, let's talk about os-specific things. i have
> noted under LIBRARY and SECURITY CONSIDERATIONS that they are net/free
> only. i still have no solution to Dd and $Mdocdate$. we can
> alternatively look at having os-specific pages if preferred.

Jason,

I like the idea of moving the "next section..." stuff.  I always 
hiccuped on that.

But it makes more sense to say "not OpenBSD" than "for x, y, and z only" 
because the latter covers an open interval.

Enclosed is a patch that uses "not OpenBSD".

Thoughts?

If it's good, I'll put it in man.7 also.

Kristaps