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 o6OF4BwP004759 for ; Sat, 24 Jul 2010 11:04:11 -0400 (EDT) Received: from localhost (1000@localhost [IPv6:::1]) by kerhand.co.uk (OpenSMTPD) with ESMTP id eJyJyVm4 for ; Sat, 24 Jul 2010 16:03:46 +0100 (BST) Date: Sat, 24 Jul 2010 16:03:46 +0059 From: Jason McIntyre To: discuss@mdocml.bsd.lv Subject: Re: man.7 tweaks Message-ID: <20100724150410.GB23978@bramka.kerhand.co.uk> References: <20100724133216.GA15380@bramka.kerhand.co.uk> <20100724135918.GC26858@iris.usta.de> 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: <20100724135918.GC26858@iris.usta.de> User-Agent: Mutt/1.4.2.3i On Sat, Jul 24, 2010 at 03:59:18PM +0200, Ingo Schwarze wrote: > > > > *) openbsd doesn;t have a LIBRARY section. what is the best way to > > reflect that? ingo? > > Hm, this applies to a couple of sections, and i haven't come to > a conclusion yet, either. > > I think having an identical man(7) manual in all the supported > operating systems is a good thing. At the same time, i think > the manual should not be blantantly wrong on any of them. > Can we, in some way, briefly address the differences, without > bloating the text too much? Like in, e.g., > > This section is used in FreeBSD and NetBSD, but not in OpenBSD. > > A sentence of this kind makes it plain that there are OS-specific > conventions in this respect, without needing another sentence to > make that explicit. If someone is using another system that is > not listed, it's obvious that s/he must look into it and find out. > i guess the choices are either have different pages for different systems (a pain to keep up to date but more accurate, kind of) or note os differences within the page. some more differences (at least between netbsd and open): - man pages sections (as discussed) - supported archs - page suffixes maybe (think .3p) - Dt (openbsd uses $mdocdate$) - \*[Gt vs. \*(Gt - rcsid > > *) (again ingo) how does this diff get committed? > > However you like. If you feel you have enough OKs, just commit > to OpenBSD and Kristaps or myself will pick it up and commit it to > bsd.lv. If you don't like that approach, you can also ask either > of us to commit to both repos in parallel. > so i will leave you guys to commit it, if it gets approved. jmc -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv