From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from wonkity.com (wonkity.com [67.158.26.137]); by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id 0ded9517; for ; Tue, 16 Dec 2014 11:41:07 -0500 (EST) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.9/8.14.9) with ESMTP id sBGGf4FX072512 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO) for ; Tue, 16 Dec 2014 09:41:04 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.9/8.14.9/Submit) with ESMTP id sBGGf2LP072419 for ; Tue, 16 Dec 2014 09:41:04 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Tue, 16 Dec 2014 09:41:02 -0700 (MST) From: Warren Block To: discuss@mdocml.bsd.lv Subject: Re: Paths with replaceable components In-Reply-To: <20141216013856.GK9092@iris.usta.de> Message-ID: References: <20141216013856.GK9092@iris.usta.de> User-Agent: Alpine 2.11 (BSF 23 2013-08-11) X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Tue, 16 Dec 2014 09:41:05 -0700 (MST) On Tue, 16 Dec 2014, Ingo Schwarze wrote: > 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 / Nice! > 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? I tried it, and it just seemed to make it longer. More interpretation was required by the reader, and it was just unwieldy. One version: Access to files on a remote NFS server is provided through the .Pa /net directory. Inside that directory are subdirectories for each NFS server IP address and the exported directories. For example, files in the .Pa artwork directory on the NFS server at 192.168.1.202 will appear in the .Pa /net/192.168.1.202/artwork directory without any additional configuration. Certainly that can be improved, but I prefer the clarity of having one full path shown with replaceable arguments. Thanks! -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv