From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from acme.spoerlein.net (acme.spoerlein.net [88.198.49.12])
	by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id p529XaTC027894
	for <discuss@mdocml.bsd.lv>; Thu, 2 Jun 2011 05:33:36 -0400 (EDT)
Received: from localhost (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1])
	by acme.spoerlein.net (8.14.4/8.14.4) with ESMTP id p529XZj5008590
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO)
	for <discuss@mdocml.bsd.lv>; Thu, 2 Jun 2011 11:33:35 +0200 (CEST)
	(envelope-from uqs@spoerlein.net)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=spoerlein.net;
	s=dkim200908; t=1307007215;
	bh=gYnRIKexIy/cj3rKY2E2AFsS8nhMWz4DQ/HIgpakVbc=;
	h=Date:From:To:Subject:Message-ID:References:MIME-Version:
	 Content-Type:Content-Transfer-Encoding:In-Reply-To;
	b=M9Eq4u3MPFtZmzzJIdOiFNh1Xh0uaOikZGpwuFUOLPIeiOkKlfxCt4cB7uUF1N8dq
	 aJ6xuvMJhVQb7d3jjR1zszrpLlMlQSj+78pH1lcsA1UpDpMmUEZH2gIbcGHrn1aVep
	 hvQQCo4pPzIBQqdH1PyFrKcENGswuJNnsUiZtsTo=
Date: Thu, 2 Jun 2011 11:33:35 +0200
From: Ulrich =?utf-8?B?U3DDtnJsZWlu?= <uqs@spoerlein.net>
To: discuss@mdocml.bsd.lv
Subject: Re: Wrong treatment of ".Nm ."
Message-ID: <20110602093335.GP1002@acme.spoerlein.net>
References: <20110602090351.GN1002@acme.spoerlein.net>
X-Mailinglist: mdocml-discuss
Reply-To: discuss@mdocml.bsd.lv
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <20110602090351.GN1002@acme.spoerlein.net>
User-Agent: Mutt/1.5.21 (2010-09-15)

On Thu, 02.06.2011 at 11:03:51 +0200, Ulrich Spörlein wrote:
> Hi,
> 
> dump.8 on FreeBSD starts roughly like this:
> 
> .Dd February 24, 2006
> .Dt DUMP 8
> .Os
> .Sh NAME
> .Nm dump ,
> .Nm rdump
> .Nd file system backup
> .Sh SYNOPSIS
> .Nm
> .Op Fl T Ar date
> .Ar filesystem
> .Nm
> .Fl W | Fl w
> .Pp
> .Nm rdump
> is an alternate name for
> .Nm .
> .Pp
> .in \" XXX
> (The
> .Bx 4.3
> option syntax is implemented for backward compatibility, but
> is not documented here.)
> .Sh DESCRIPTION
> The
> .Nm
> utility examines files
> 
> 
> 
> And mandoc will misrender the .Nm . like this:
> 
>      rdump is an alternate name for
>      .
> 
> when it should do this:
> 
>      rdump is an alternate name for dump.
> 
> 
> Also, groff will indent the sentence in parenthesis unless the ".in"
> suppresses that. mandoc doesn't know ".in" but behaves like it is set.
> Not sure if you want to follow what groff is doing here ...

Found one more difference:

Usage of the
.Ns Nm
utility:

in groff will *not* add a newline while in the Synopsis section. Mandoc
will ignore .Ns and break the sentence.

Uli
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv