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 oBQEZ0aL024309 for ; Sun, 26 Dec 2010 09:35:01 -0500 (EST) Received: from smtp-1.sys.kth.se (localhost [127.0.0.1]) by smtp-1.sys.kth.se (Postfix) with ESMTP id 63D011568CB; Sun, 26 Dec 2010 15:34:54 +0100 (CET) X-Virus-Scanned: by amavisd-new at kth.se Received: from smtp-1.sys.kth.se ([127.0.0.1]) by smtp-1.sys.kth.se (smtp-1.sys.kth.se [127.0.0.1]) (amavisd-new, port 10024) with LMTP id XTCIheQdrfWv; Sun, 26 Dec 2010 15:34:53 +0100 (CET) X-KTH-Auth: kristaps [195.13.162.34] X-KTH-mail-from: kristaps@bsd.lv Received: from macky.local (unknown [195.13.162.34]) by smtp-1.sys.kth.se (Postfix) with ESMTP id A30B9155876; Sun, 26 Dec 2010 15:34:50 +0100 (CET) Message-ID: <4D175286.40708@bsd.lv> Date: Sun, 26 Dec 2010 16:34:46 +0200 From: Kristaps Dzonsons User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.12) Gecko/20101027 Thunderbird/3.1.6 X-Mailinglist: mdocml-tech Reply-To: tech@mdocml.bsd.lv MIME-Version: 1.0 To: tech@mdocml.bsd.lv, =?ISO-8859-15?Q?Andreas_V=F6gele?= Subject: Fwd: Re: mandoc rendering of \*(-- Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 7bit Forgot to forward this, sorry... > Dear Kristaps, > > when rendering the following example with "pod2man example.pm | mandoc" > the character sequence "--" is rendered as "O-". > > --------8<--------8<--------8<--------8<-------- > =head1 Principle of Least Surprise > > Perl does the parsing -- no surprises. > --------8<--------8<--------8<--------8<-------- > > Tested with mandoc 1.10.8 from OpenBSD's source tree. > > Kind regards, > Andreas Andreas, Note that this is being CC'd to tech@mdocml, so that this issue is documented. I'm pretty sure it's been reported before. So yeah... pod2man... this is a well-known "issue" wherein \*(-- is assigned by a `ds' to \(*W- If you look in mandoc_char.7, you'll see that *W is the special character capital Greek omega (O). So mandoc outputs "O-". Makes sense, right? However, pod2man runs `tr \(*W-', which makes all instances of \(*W be turned into -. mandoc doesn't (yet) support `tr'. So basically, pod2man overwrites the default character behaviour of the Greek omega. Since pod2man masks special characters in its input (it re-writes "\*(W" as "\e*(W"), apparently they think this is ok. I think it's a dumb hack, but whatever. Anyway, I'll add a note to the TODO that `tr' should be implemented. It doesn't look too hard and will fix the problem. Thanks, Kristaps -- To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv