From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp-3.sys.kth.se (smtp-3.sys.kth.se [130.237.48.192]); by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id 552425ab; for ; Thu, 30 Apr 2015 10:43:05 -0500 (EST) Received: from smtp-3.sys.kth.se (localhost.localdomain [127.0.0.1]) by smtp-3.sys.kth.se (Postfix) with ESMTP id 74FB32A23 for ; Thu, 30 Apr 2015 17:43:04 +0200 (CEST) X-Virus-Scanned: by amavisd-new at kth.se Received: from smtp-3.sys.kth.se ([127.0.0.1]) by smtp-3.sys.kth.se (smtp-3.sys.kth.se [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 4xCQC1Gx4GLg for ; Thu, 30 Apr 2015 17:43:03 +0200 (CEST) X-KTH-Auth: kristaps [86.206.144.69] X-KTH-mail-from: kristaps@bsd.lv X-KTH-rcpt-to: discuss@mdocml.bsd.lv Received: from skins.home (AToulouse-658-1-121-69.w86-206.abo.wanadoo.fr [86.206.144.69]) by smtp-3.sys.kth.se (Postfix) with ESMTPSA id A98572A25 for ; Thu, 30 Apr 2015 17:42:57 +0200 (CEST) Message-ID: <55424D7F.1010309@bsd.lv> Date: Thu, 30 Apr 2015 17:42:55 +0200 From: Kristaps Dzonsons User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:31.0) Gecko/20100101 Thunderbird/31.6.0 X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 To: discuss@mdocml.bsd.lv Subject: Redux: linking in mdoc(7)? Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Hi, I saw on groff another post about indexing, so I thought to bring this up again. I'm wary of mdocmx because it's unreadably huge. Manpages should be simple. A few months ago, I floated an implementation of an mdoc(7) macro (plus one more, for completion), `Ix', that's an invisible anchor to which `Sx' can point. I implemented an active front-end in -Thtml mode: there's no console mode because I'm not aware of link support in stock less(1). In HTML, obviously, `Ix' is implemented as an empty to which subsequent can link. The concept of `Ix' arises from the desire to link not only to sections and subsections, but also subsubsections and other textual components. The mdoc(7) manual is an excellent example, which abuses `Ss' to allow linking to descriptions of individual macros. The ``pro'' of `Ix' is that it's trivially easy to support in mandoc(1) (patch was included) and can be just as easily ignored in groff(1). (I go for ``ignore'' because that's what groff already does with Sx and Ss and friends, which are the proto-Ix.) The patch is dead easy to read. The ``con'' is that it's a new macro. To which I argue that, yes, it is a new macro, but we already have a crippled form of the functionality it provides (via `Sh' and `Ss'): this merely completes it. Is this a reasonable concept to move forward with? Thoughts? The patch I provided is implementation-complete. I leave a PS/PDF bookmark implementation as an exercise to the reader. Best, Kristaps -----BEGIN PGP SIGNATURE----- Comment: GPGTools - https://gpgtools.org iQIcBAEBCgAGBQJVQk1/AAoJEMT2SUY9XBESHC4QALIlN5bruIt9bZ+muHt1+QuI yjsccCwcxsJTk4adxFxYv/I4TAbeY7EAHFIJe+TpVsCeGuYx34ftKbbm2SdTx6Al w4njGy7H0nXfNlBUo4n5z2QgVBIkzmgeGDXTpDdjFnlKD3xeFCMIxmZkQ8YSSY53 ADPnVqtSOAvrMgWkv+xR3lAhLF7si2ZpOC6Pe5EMF9iYnHdhh4R97E2crI+aRUkn aAVddRvt4bwq5p3JH2SYtI+BfzrWLd6hkAJg+2Rzma1ZLtTtctYVSa8Zntiy7WRF mKn7EwIWOHpWUe3nEJPyDbrs+QBrnN3unQmogVPik3YakwhDItabILSi9bH1BMtd CN3MuFKtGLTpYohXEEUOL1lW9WKYDVDiih3YX/5eDz3K7SqTwjNWbS5/AOHw3UkX JJPrJ95TV50mkoOh20tLW4nD9k0h2eyP2BrLT+1B+WHt85POhcmLadYpECfjGicV 23czGrxYiD24ZNXARXZZjbnY47SY+cdrLA5kej6RC5DSEKVwXAKbk6skYkb7xPx6 P+ptEl1rKfkQazcaLf7Ui+t2wwfP8KFSg8P44zb28hv/ekeVdKTfsrCzH3TSu6Gn gJ7mHGA3DOwhQSYgjgMCZqIcQyOI3Bxs4wlK4+QdhztUgAA+g8yImbCK6t+IIIkp QAvPfwQkQYXsnTkV2geP =+/TN -----END PGP SIGNATURE----- -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv