From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from zelgadis.fingolfin.org (zelgadis.fingolfin.org [72.14.186.115]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id a2eb0cd9 for ; Sun, 17 Feb 2019 19:09:42 -0500 (EST) Received: from [10.138.0.5] (c-73-241-82-242.hsd1.ca.comcast.net [73.241.82.242]) by zelgadis.fingolfin.org (Postfix) with ESMTPSA id 546F8C066 for ; Mon, 18 Feb 2019 00:09:39 +0000 (UTC) To: discuss@mandoc.bsd.lv From: Robert Mustacchi Subject: Cross references to specific sections in other manual pages Openpgp: preference=signencrypt Autocrypt: addr=rm@fingolfin.org; keydata= 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 Message-ID: Date: Sun, 17 Feb 2019 16:09:38 -0800 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:60.0) Gecko/20100101 Thunderbird/60.5.0 X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit Hi, While writing manual pages for illumos, I've often wanted to semantically indicate a cross-reference to a specific section of another manual page. One place this comes up for us is in library documentation where we have an introductory page that contains information about errors or required locking. It also sometimes comes up in our device driver manual pages. An example of this is a sentence of the form 'For more information, see the LOCKING section of libproc(3LIB).' I don't believe there's a good way to do this today as the .Sx macro always is supposed to be internal to the page and the .Xr macro doesn't allow one to target a specific section or sub-section header (.Sh / .Ss). Would a new macro (or extension to an existing one) that semantically indicated such a cross-reference to a particular .Sh/.Ss in another page be of interest to others? I'm not sure if this is something that should be elevated into its own macro. If folks think it might be useful, I'm happy to take a look at implementing it. Thanks, Robert -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv