From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailout.scc.kit.edu (mailout.scc.kit.edu [129.13.185.202]) by krisdoz.my.domain (8.14.5/8.14.5) with ESMTP id q1QJtMRv019849 for ; Sun, 26 Feb 2012 14:55:23 -0500 (EST) Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82]) by scc-mailout-02.scc.kit.edu with esmtp (Exim 4.72 #1) id 1S1kBk-000088-Hj; Sun, 26 Feb 2012 20:55:20 +0100 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.77) (envelope-from ) id 1S1kBk-0001T2-HR for tech@mdocml.bsd.lv; Sun, 26 Feb 2012 20:55:20 +0100 Received: from iris.usta.de ([172.24.96.5] helo=usta.de) by donnerwolke.usta.de with esmtp (Exim 4.72) (envelope-from ) id 1S1kBk-0001zj-Gg for tech@mdocml.bsd.lv; Sun, 26 Feb 2012 20:55:20 +0100 Received: from schwarze by usta.de with local (Exim 4.77) (envelope-from ) id 1S1kBk-00081A-Fv for tech@mdocml.bsd.lv; Sun, 26 Feb 2012 20:55:20 +0100 Date: Sun, 26 Feb 2012 20:55:20 +0100 From: Ingo Schwarze To: tech@mdocml.bsd.lv Subject: Re: Add support for `OP', one of the extended man macros. Message-ID: <20120226195520.GK5977@iris.usta.de> References: <201201031516.q03FGP2k006780@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: <201201031516.q03FGP2k006780@krisdoz.my.domain> User-Agent: Mutt/1.5.21 (2010-09-15) Hi Kristaps, kristaps@mdocml.bsd.lv wrote on Tue, Jan 03, 2012 at 10:16:25AM -0500: > Log Message: > ----------- > Add support for `OP', one of the extended man macros. This also requires > some man(7) changes to accomodate for the an-ext compatibility. > > Modified Files: > -------------- > mdocml: > man.7 > man.c > man.h > man_html.c > man_macro.c > man_term.c > man_validate.c I have just merged this to OpenBSD, with one small tweak (see below). I agree that we should support GNU extensions for compatibilty if they occur in practice and unless they cause too much bloat; but i insist in discouraging their use more strongly. Obviously, esr was very misguided in proposing these extensions. He combines the worst parts of both worlds: The clunkyness of the ancient man(7) macros, which cannot be repaired by adding a few more macros, and the portability problems still haunting mdoc(7). If man(7) has any excuse to still exist, it's portability, and man-ext clearly gives that last asset away. So, we should handle these macros as deprecated, not list them in the MACRO OVERVIEW, and prominently discourage their use up front, not only below COMPATIBILITY where the warning can easily be missed. OK to commit this tweak to bsd.lv as well? Yours, Ingo --- /co/mdocml/man.7 Wed Jan 4 03:24:13 2012 +++ ./man.7 Sun Feb 26 20:41:27 2012 @@ -272,10 +272,6 @@ .It Sx RB Ta alternate between roman and boldface fonts .It Sx RI Ta alternate between roman and italic fonts .El -.Ss Semantic markup -.Bl -column "PP, LP, P" description -.It Sx OP Ta optional arguments -.El .Sh MACRO REFERENCE This section is a canonical reference to all macros, arranged alphabetically. @@ -443,7 +439,8 @@ .Sx \&TP . .Ss \&OP Optional command-line argument. -This has the following syntax: +This is a non-standard GNU extension, included only for compatibility. +It has the following syntax: .Bd -filled -offset indent .Pf \. Sx \&OP .Cm key Op Cm value -- To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv