From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp-1.sys.kth.se (smtp-1.sys.kth.se [130.237.32.175]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o7SLCdKw018591 for ; Sat, 28 Aug 2010 17:12:40 -0400 (EDT) Received: from mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) by smtp-1.sys.kth.se (Postfix) with ESMTP id 182471557D3 for ; Sat, 28 Aug 2010 23:12:34 +0200 (CEST) X-Virus-Scanned: by amavisd-new at kth.se Received: from smtp-1.sys.kth.se ([130.237.32.175]) by mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) (amavisd-new, port 10024) with LMTP id CW7aS0D0DDaS for ; Sat, 28 Aug 2010 23:12:32 +0200 (CEST) X-KTH-Auth: kristaps [85.8.61.94] X-KTH-mail-from: kristaps@bsd.lv X-KTH-rcpt-to: discuss@mdocml.bsd.lv Received: from lappy.cust.alltele.se (h85-8-61-94.dynamic.se.alltele.net [85.8.61.94]) by smtp-1.sys.kth.se (Postfix) with ESMTP id 5C9F31551FC for ; Sat, 28 Aug 2010 23:12:31 +0200 (CEST) Message-ID: <4C797BBE.7060500@bsd.lv> Date: Sat, 28 Aug 2010 23:12:30 +0200 From: Kristaps Dzonsons User-Agent: Thunderbird 2.0.0.23 (X11/20100318) X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 To: discuss@mdocml.bsd.lv Subject: Re: mdoc.7: tweak skeleton file References: <20100826182407.GD31244@bramka.kerhand.co.uk> In-Reply-To: <20100826182407.GD31244@bramka.kerhand.co.uk> Content-Type: multipart/mixed; boundary="------------000904090203040706050809" This is a multi-part message in MIME format. --------------000904090203040706050809 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit > 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 --------------000904090203040706050809 Content-Type: text/plain; name="patch.txt" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="patch.txt" ? foo.1 ? foo.1.html ? patch.txt Index: mdoc.7 =================================================================== RCS file: /usr/vhosts/mdocml.bsd.lv/cvs/mdocml/mdoc.7,v retrieving revision 1.155 diff -u -r1.155 mdoc.7 --- mdoc.7 24 Aug 2010 14:03:46 -0000 1.155 +++ mdoc.7 28 Aug 2010 21:11:31 -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 Not used in OpenBSD. \&.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 & 8 only. \&.\e\*q .Sh EXIT STATUS +\&.\e\*q For sections 1 & 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 Not used in OpenBSD. .Ed .Pp The sections in an --------------000904090203040706050809-- -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv