From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from scc-mailout-kit-02.scc.kit.edu (scc-mailout-kit-02.scc.kit.edu [129.13.231.82]); by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id 78be362f; for ; Mon, 15 Dec 2014 20:39:00 -0500 (EST) Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82] helo=hekate.usta.de) by scc-mailout-kit-02.scc.kit.edu with esmtps (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256) (envelope-from ) id 1Y0h6H-00008X-FS; Tue, 16 Dec 2014 02:38:58 +0100 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.77) (envelope-from ) id 1Y0h6H-00029E-9y; Tue, 16 Dec 2014 02:38:57 +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 1Y0h6H-0005rs-8G; Tue, 16 Dec 2014 02:38:57 +0100 Received: from schwarze by usta.de with local (Exim 4.77) (envelope-from ) id 1Y0h6G-000215-UT; Tue, 16 Dec 2014 02:38:56 +0100 Date: Tue, 16 Dec 2014 02:38:56 +0100 From: Ingo Schwarze To: Warren Block Cc: discuss@mdocml.bsd.lv Subject: Re: Paths with replaceable components Message-ID: <20141216013856.GK9092@iris.usta.de> References: X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) Hi Warren, Warren Block wrote on Mon, Dec 15, 2014 at 05:19:44PM -0700: > We have another man page for the new autofs. > One of the associated pages refers to this path: > > .Pa /net/nfs-server-ip/share-name/ > > "net" is a literal there, but "nfs-server-ip" and "share-name" are not. > > In DocBook, I'd mark them up as , to indicate to the > reader that they are not literal. Is there a preferred mdoc way to > do that in a path without splitting up the path components? I would mark up the path like this: .Pf /net/ Ar nfs-server-ip Ns / Ns Ar share-name Ns / Making it clear which parts need replacements is probably more important than marking up the whole thing as a path, and you can't do both at the same time since mdoc(7) inline macros don't nest. Why do you want to avoid splitting up the path components? Yours, Ingo -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv