From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp1.rz.uni-karlsruhe.de (Debian-exim@smtp1.rz.uni-karlsruhe.de [129.13.185.217]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id oBJ8N4OY005471 for ; Sun, 19 Dec 2010 03:23:06 -0500 (EST) Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82]) by smtp1.rz.uni-karlsruhe.de with esmtp (Exim 4.63 #1) id 1PUEXm-0005pd-Gf; Sun, 19 Dec 2010 09:23:02 +0100 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.72) (envelope-from ) id 1PUEXm-0000TK-Ep; Sun, 19 Dec 2010 09:23:02 +0100 Received: from iris.usta.de ([172.24.96.5] helo=usta.de) by donnerwolke.usta.de with esmtp (Exim 4.69) (envelope-from ) id 1PUEXm-0003EB-EE; Sun, 19 Dec 2010 09:23:02 +0100 Received: from schwarze by usta.de with local (Exim 4.72) (envelope-from ) id 1PUEXm-00042Z-D2; Sun, 19 Dec 2010 09:23:02 +0100 Date: Sun, 19 Dec 2010 09:23:02 +0100 From: Ingo Schwarze To: tech@mdocml.bsd.lv Cc: jmc@openbsd.org Subject: Re: mdocml: Import changes by schwarze@ and Jason McIntyre into manuals. Message-ID: <20101219082302.GB17028@iris.usta.de> References: <201012061637.oB6GbW9j031066@krisdoz.my.domain> X-Mailinglist: mdocml-tech Reply-To: tech@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <201012061637.oB6GbW9j031066@krisdoz.my.domain> User-Agent: Mutt/1.5.21 (2010-09-15) Hi Kristaps, kristaps@mdocml.bsd.lv wrote on Mon, Dec 06, 2010 at 11:37:32AM -0500: > Log Message: > ----------- > Import changes by schwarze@ and Jason McIntyre into manuals. These are > for the new libroff macros, the new libman macros, and for the sake of > general clarity. > > Note that `ft' documentation is NOT included, as I've kept it in -man: > it's highly confusing to have it in roff.7 when it's not implemented for > both -man and -mdoc, as at least in theory, roff.7 should include only > macros recognised by BOTH formats. > > Modified Files: > -------------- > mdocml: > mdoc.7 > roff.7 Our manuals are now back in sync. Note that i left .ft in roff(7) for now because i failed to make up my mind about it. Your reasoning of course makes a lot of sense. On the other hand: It's a bug that mdoc(7) does not recognize .ft, even if using .ft in mdoc(7) should clearly be discouraged - but .ft is a roff(7) request, not a man(7) macro. Adding .ft to mdoc(7) has no priority, it is hardly used there. Besides being unwilling to waste my time adding .ft to mdoc(7), i'm even a bit reluctant to encumber mdoc(7) with it: I'm still dreaming about a common request/macro table that will always include roff(7) macros, including .br, .sp, .ft, .de, .ds and so on, being extended by macros when man(7) or mdoc(7) get loaded, and being overwritten by .de and .ds. It is not urgent at all, but i hope that at some point we can do it. There is no finished design yet, it's just a nebulous idea. Yours, Ingo -- To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv