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 o7QIO9JI023104 for ; Thu, 26 Aug 2010 14:24:09 -0400 (EDT) Received: from localhost (1000@localhost [IPv6:::1]) by kerhand.co.uk (OpenSMTPD) with ESMTP id oobaBfdB for ; Thu, 26 Aug 2010 19:23:43 +0100 (BST) Date: Thu, 26 Aug 2010 19:23:43 +0059 From: Jason McIntyre To: discuss@mdocml.bsd.lv Subject: mdoc.7: tweak skeleton file Message-ID: <20100826182407.GD31244@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 User-Agent: Mutt/1.4.2.3i 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. jmc Index: mdoc.7 =================================================================== RCS file: /cvs/src/share/man/man7/mdoc.7,v retrieving revision 1.49 diff -u -r1.49 mdoc.7 --- mdoc.7 22 Aug 2010 11:39:18 -0000 1.49 +++ mdoc.7 26 Aug 2010 18:16:22 -0000 @@ -331,8 +331,9 @@ \&.Sh NAME \&.Nm foo \&.Nd a description goes here -\&.\e\*q The next is for sections 2, 3, & 9 only. \&.\e\*q .Sh LIBRARY +\&.\e\*q For sections 2, 3, & 9 only. +\&.\e\*q NetBSD/FreeBSD only. \&.Sh SYNOPSIS \&.Nm foo \&.Op Fl options @@ -342,18 +343,18 @@ \&.Nm utility processes files ... \&.\e\*q .Sh IMPLEMENTATION NOTES -\&.\e\*q The next is for sections 2, 3, & 9 only. \&.\e\*q .Sh RETURN VALUES -\&.\e\*q The next is for sections 1, 6, 7, & 8 only. +\&.\e\*q For sections 2, 3, & 9 only. \&.\e\*q .Sh ENVIRONMENT +\&.\e\*q For sections 1, 6, 7, & 8 only. \&.\e\*q .Sh FILES -\&.\e\*q The next is for sections 1, 6 & 8 only. \&.\e\*q .Sh EXIT STATUS +\&.\e\*q For sections 1, 6 & 8 only. \&.\e\*q .Sh EXAMPLES -\&.\e\*q The next is for sections 1, 4, 6, 7, & 8 only. \&.\e\*q .Sh DIAGNOSTICS -\&.\e\*q The next is for sections 2, 3, & 9 only. +\&.\e\*q For sections 1, 4, 6, 7, & 8 only. \&.\e\*q .Sh ERRORS +\&.\e\*q For sections 2, 3, & 9 only. \&.\e\*q .Sh SEE ALSO \&.\e\*q .Xr foobar 1 \&.\e\*q .Sh STANDARDS @@ -362,6 +363,7 @@ \&.\e\*q .Sh CAVEATS \&.\e\*q .Sh BUGS \&.\e\*q .Sh SECURITY CONSIDERATIONS +\&.\e\*q NetBSD/FreeBSD only. .Ed .Pp The sections in an -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv