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 03221688; for ; Mon, 9 Mar 2015 10:36:47 -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 65B372884 for ; Mon, 9 Mar 2015 16:36:46 +0100 (CET) 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 bgjv4TN0YgNn for ; Mon, 9 Mar 2015 16:36:44 +0100 (CET) X-KTH-Auth: kristaps [92.136.205.40] X-KTH-mail-from: kristaps@bsd.lv X-KTH-rcpt-to: discuss@mdocml.bsd.lv Received: from pc3.home (AToulouse-651-1-38-40.w92-136.abo.wanadoo.fr [92.136.205.40]) by smtp-3.sys.kth.se (Postfix) with ESMTPSA id 78E6626FA for ; Mon, 9 Mar 2015 16:36:34 +0100 (CET) Message-ID: <54FDBE04.9030108@bsd.lv> Date: Mon, 09 Mar 2015 16:36:36 +0100 From: Kristaps Dzonsons Reply-To: discuss@mdocml.bsd.lv User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:31.0) Gecko/20100101 Thunderbird/31.5.0 X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 To: discuss@mdocml.bsd.lv Subject: Re: Linking in mdoc(7) References: <54FC74F4.9090200@bsd.lv> <20150309110908.gN5E-QPE%sdaoden@yandex.com> <20150309114648.GA18431@athene.usta.de> <54FD9156.2010201@bsd.lv> In-Reply-To: <54FD9156.2010201@bsd.lv> Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 8bit -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Replying to myself with an example... Here's an example of `Ix' and `Lkx' at work: http://kristaps.bsd.lv/gsl-test.7.html It's a rendering of the following: % texi2mdoc ~/src/gsl-1.16/doc/gsl-ref.texi | \ mandoc -Thtml >gsl-test.7.html In this you can see the menu items (`Lkx') pointing to arbitrary nodes (`Ix': chapters, sections, subsections, etc.). I use `Lkx' instead of `Sx' because I give the nodes a unique namespace to separate them from the `Sh' heading, which may share the same name. For example, the (x)_n symbol is as follows: http://kristaps.bsd.lv/gsl-test.7.html#index-NodePochhammer_Symbol This is a sub-sub-sub-section. Earlier, I was trying to do this with `Sx', but it would only nest to `Ss' while texinfo goes much deeper. Moreover, the menu item name is sometimes different from the node identifier, which wouldn't work with `Sx'. Something that you don't see in this manual which would be (and now is) possible is topical indexing. I would basically build up a set of `Ix' entries for each index entry (e.g., @cindex), with a unique namespace prefix, e.g., the concept index for "foo bar" would be "CPIndexfoo bar" or something. When Texinfo asks that I print the concept index list, I simply sort the entries and output a list of `Lkx' entries to the respective locations in the page, e.g., `Lkx "CPIndexfoobar" "foo bar"'. These will jump back smartly to the indices. P.S., be gentle on the GSL page. It's one of the heavier users of texinfo semantics, so there are still glitches, e.g., the function declarations are un-pretty. -----BEGIN PGP SIGNATURE----- Comment: GPGTools - https://gpgtools.org iQIcBAEBCgAGBQJU/b4EAAoJEMT2SUY9XBESeOEP/0BTo/De+p13B4kpjGLI4PG+ n8ulB0qlvAvbdFDKUFcPEt1yKU8jCLorKS7R9X0rTHlBfdEDMZ+P+Krp15SHea0n NgbI+nvje4x6r0RRmswwM3pqajiPsNWSMTOQ24TNVMwmNHgIqtuYkSZWIfleGnws bmeN/32qlM22YjTld7qO2B893gPd/rXv9LrGlqFezJ14co6nmeVRJxsV0dtP5pBY xPC8PKw6E+LZhYpykhMN7fPoSDbjA+OPj0mrUugUZVDzPJYNG0s1GEFqQniATqRU Dtnw7MSoz4gqi5LvJNe5I3JNskKCKMm8FOwHySRV+CYLQ+WjfytTptF0w5DnRKSw d5JKhxM4+eCxAOKKxrFQcXNdkHLBrMg+ZMdlSTbzqAPzmqh+bnt1DYqhjNezAqva ne1PqdlV70I4E8kScX/EG3otbaKFZH4fxjkyoi3l6GdxnX+0CN2rk0FBlJT4Hxzz wHery7gqsPY6yww/X1E0ba8hEfcUVQA/1YW2VzwNeG1EyTLmwJi6j0GIPjsO1NTl 1UzviYALFCmndhoQcJWLqDsFz5hBbCSgm7slyVRLAMUZIpYboZMqXXpt8H9d+qLc TTtv2kJCCrqgXNt3gh6xJuo5yo/0Gbsapkg41/O5ZOPa+PnrL7dm+g+gMTqjduOR iQIeqzolgQOjXtGoDoiX =NAB2 -----END PGP SIGNATURE----- -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv