From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from forward5m.cmail.yandex.net (forward5m.cmail.yandex.net [5.255.216.23]);
	by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id 5d52c722;
	for <discuss@mdocml.bsd.lv>;
	Mon, 9 Mar 2015 06:09:13 -0500 (EST)
Received: from smtp4m.mail.yandex.net (smtp4m.mail.yandex.net [77.88.61.131])
	by forward5m.cmail.yandex.net (Yandex) with ESMTP id 60499803BE
	for <discuss@mdocml.bsd.lv>; Mon,  9 Mar 2015 14:09:10 +0300 (MSK)
Received: from smtp4m.mail.yandex.net (localhost [127.0.0.1])
	by smtp4m.mail.yandex.net (Yandex) with ESMTP id 365ADBE01F9
	for <discuss@mdocml.bsd.lv>; Mon,  9 Mar 2015 14:09:10 +0300 (MSK)
Received: from unknown (unknown [89.204.139.116])
	by smtp4m.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id YxbiQGZSvN-99ICXwQr;
	Mon,  9 Mar 2015 14:09:09 +0300
	(using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits))
	(Client certificate not present)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex.com; s=mail; t=1425899349;
	bh=oFJWDfhvXhsHx/CYOB8xLdqi8oBwN77XDdtVZbs12xc=;
	h=Date:From:To:Subject:Message-ID:References:In-Reply-To:
	 Mail-Followup-To:User-Agent:MIME-Version:Content-Type:
	 Content-Transfer-Encoding;
	b=OqpRP61/GEjyo1h+V8ghZmZPC0RgKnJL1MQzSBJ06Fmb/hDIfccqDS72fgv6mrwne
	 73IcpYrJjUqhcafwJk7HrADHtZDYtbtb0qMsIhxhdXc251bfpxPUurSxAp8M5B4AmI
	 vYiMdMpAQU8sMUs8bZjNT5XvhiRonMH7IwAwCbbE=
Authentication-Results: smtp4m.mail.yandex.net; dkim=pass header.i=@yandex.com
Date: Mon, 09 Mar 2015 12:09:08 +0100
From: Steffen Nurpmeso <sdaoden@yandex.com>
To: discuss@mdocml.bsd.lv
Subject: Re: Linking in mdoc(7)
Message-ID: <20150309110908.gN5E-QPE%sdaoden@yandex.com>
References: <54FC74F4.9090200@bsd.lv>
In-Reply-To: <54FC74F4.9090200@bsd.lv>
Mail-Followup-To: discuss@mdocml.bsd.lv
User-Agent: s-nail v14.7.11-238-ge39f9bb-dirty
X-Mailinglist: mdocml-discuss
Reply-To: discuss@mdocml.bsd.lv
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

Kristaps Dzonsons <kristaps@bsd.lv> wrote:
 |Summary: mdoc(7) has linking, but it's very restrictive.  You can link
 |to `Sh' and `Ss' macros by using the `Sx' macro.  I propose adding
 |another macro, `Ix', that creates an invisible anchor that `Sx' can
 |jump to.  Thus, `Sh' and `Ss' work as they always did and `Sx' works
 |as it always did, but we can also jump to arbitrary locations from
 |`Sx' as defined with `Ix', which is otherwise silent.  Obviously, this
 |is only useful in -Thtml.  On the console, nothing happens at all.  I
 |also propose an `Lkx', which is like `Lk' but for inter-page links.
 |This is when the argument to `Sx' should be different from the index name.

I have proposed something similar back in September 2014 on groff@
and implemented a complete package that can do this and much more
with an interface that follows Ingo's suggestions since then.
The macro is .Mx, the documentation, troff(1) awk(1) preprocessor,
mdoc(1) macro extensions etc., and a patch for less(1) v471 that
allows internal (including .Sh and .Ss, but many more) and
external anchors (for .Xr) to be followed are available.  Use it
or leave it.

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