From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from scc-mailout.scc.kit.edu (scc-mailout.scc.kit.edu [129.13.185.202]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id p5BFk4aL009327 for ; Sat, 11 Jun 2011 11:46:04 -0400 (EDT) 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 1QVQNv-0002MO-5v; Sat, 11 Jun 2011 17:46:03 +0200 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.72) (envelope-from ) id 1QVQNv-000276-5I for discuss@mdocml.bsd.lv; Sat, 11 Jun 2011 17:46:03 +0200 Received: from iris.usta.de ([172.24.96.5] helo=usta.de) by donnerwolke.usta.de with esmtp (Exim 4.69) (envelope-from ) id 1QVQNv-0000Pi-3j for discuss@mdocml.bsd.lv; Sat, 11 Jun 2011 17:46:03 +0200 Received: from schwarze by usta.de with local (Exim 4.72) (envelope-from ) id 1QVQNv-0005wB-2q for discuss@mdocml.bsd.lv; Sat, 11 Jun 2011 17:46:03 +0200 Date: Sat, 11 Jun 2011 17:46:03 +0200 From: Ingo Schwarze To: discuss@mdocml.bsd.lv Subject: Re: Wrong treatment of ".Nm ." Message-ID: <20110611154603.GH4597@iris.usta.de> References: <20110602090351.GN1002@acme.spoerlein.net> <20110602093335.GP1002@acme.spoerlein.net> X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20110602093335.GP1002@acme.spoerlein.net> User-Agent: Mutt/1.5.21 (2010-09-15) Hi Ulrich, Ulrich Spörlein wrote on Thu, Jun 02, 2011 at 11:33:35AM +0200: >> .Sh SYNOPSIS [...] >> .Pp >> .Nm rdump >> is an alternate name for >> .Nm . [...] > Usage of the > .Ns Nm > utility: You are right, these are subtle mandoc bugs, i have added a TODO entry: - When there is free text in the SYNOPSIS and that free text contains the .Nm macro, groff somehow understands to treat the .Nm as an in-line macro, while mandoc treats it as a block macro and breaks the line. No idea how the logic for distinguishing in-line and block instances should be, needs investigation. uqs@ Thu, 2 Jun 2011 11:03:51 +0200 uqs@ Thu, 2 Jun 2011 11:33:35 +0200 Free text in the SYNOPSIS is perhaps not very good style, but that's no reason for mandoc to behave differently. Yours, Ingo -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv