sandbox/manpage-writer/expected-mandoc/references.utf8

   1 REFERENCE TESTS()                                            REFERENCE TESTS()
   2
   3 N\bNA\bAM\bME\bE
   4        reference tests -
   5
   6 H\bHO\bOW\bW T\bTO\bO M\bMA\bAR\bRK\bKU\bUP\bP
   7        link adr in .UR .UE or simply in parantheses
   8
   9        • man and mandoc convert UR/UE to <\b< and >\b>.
  10
  11        • pandoc transforms
  12
  13             See the `Python home page <https://www.python.org>`_ for info.
  14
  15          to
  16
  17             see See the Python home page (https://www.python.org) for info.
  18
  19 T\bTE\bES\bST\bT F\bFO\bOR\bR R\bRE\bEF\bFE\bER\bRE\bEN\bNC\bCE\bES\bS I\bIN\bN M\bMA\bAN\bN P\bPA\bAG\bGE\bES\bS
  20        embedded in a paragraph
  21
  22        • at line start
  23
  24        • in line
  25
  26        • at eol
  27
  28        at start of paragraph
  29
  30        • followed by text
  31
  32        • at eol
  33
  34        at end of paragraph
  35
  36 T\bTE\bES\bST\bTS\bS
  37        See
  38        <https://docutils.sourceforge.io/docs/user/rst/quickref.html#explicit-markup>
  39
  40        for more
  41
  42        See the Python home page <https://www.python.org>
  43         for info.
  44
  45        External hyperlinks, like Python <https://www.python.org> .
  46
  47        Want to learn about my favorite programming language
  48        <https://www.python.org> ?
  49
  50        Clicking on this internal hyperlink will take us to the <target>
  51
  52        below.
  53
  54        The hyperlink target above points to this paragraph.
  55
  56        • bullet list
  57
  58        • second item, with hyperlink target.
  59
  60        See the Python <https://www.python.org>
  61         home page for info.
  62
  63        Write to me <mailto:jdoe@example.com>
  64         with your questions.
  65
  66        The one-liner <https://docutils.sourceforge.io/rst.html>
  67         and starts-on-this-line <https://docutils.sourceforge.net/rst.html>
  68         or entirely-below <https://docutils.sourceforge.net/rst.html>
  69         point to <https://docutils.sourceforge.io/rst.html>
  70         and in man are ... ?
  71
  72        Escaped whitespace is preserved as intentional spaces, e.g.:
  73
  74        some reference <../local>
  75         to a local path.
  76
  77        Anonymous hyperlink references are specified with two underscores
  78        instead of one:
  79
  80        See the web site of my favorite programming language
  81        <https://www.python.org> .
  82
  83        Anonymous targets begin with ".. __:"; no reference name is required or
  84        allowed:
  85
  86                                                              REFERENCE TESTS()