[prev in list] [next in list] [prev in thread] [next in thread] 

List:       mandoc-discuss
Subject:    Re: Redux: linking in mdoc(7)?
From:       Steffen Nurpmeso <sdaoden () yandex ! com>
Date:       2015-05-05 13:47:14
Message-ID: 20150505134714.yhPAIfZcwj8BIIoZwMCiZQ== () yandex ! com
[Download RAW message or body]

FYI,

i've completed the mdocmx(7) side of the road.
Ciao.

 Freely definable anchors and references[15]
   Via the ‘.Mx -ix category key' and ‘.Mx -ix key' usage forms anchors can

(Btw., does anone knows how to do that as
  .Mx -ix [category] key
i.e., using .Op for category --- while still having the entire
thing inside of, and quoted by, .Ql?  mdoc(7) no-go i guess?)

   be defined almost anywhere, e.g., ‘.Mx -ix subsubsection "An interesting
   topic"' defines the anchor ‘An interesting topic' for the "key"
   ‘subsubsection'.  The form without a specified category will use the
   builtin name ‘ixsx' instead.

   References to anchors that have been created via -ix can be made by acti-
   vating the .Sx search extension via ‘.Mx -sx category' (or ‘.Mx -sx' for
   the builtin ‘ixsx[58]' category) followed by a normal local reference
   lookup:

         .Mx -sx subsubsection
         .Sx "An interesting topic"

   It should be noted that these usage forms are mostly ment for automated
   conversion tools rather than for human manual creators: their use is non-
   trivial (which is owed to the implementation of mdoc(7)[59]) and the
   resulting visual output should always be verified!  As a rule of thumb
   anchors should always be created inside some "normal" text so that they
   can be attached to something "physical".

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

[prev in list] [next in list] [prev in thread] [next in thread]