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

   1 .\" Man page generated from reStructuredText by manpage writer
   2 .\" from docutils 0.22b.dev.
   3 .
   4 .
   5 .nr rst2man-indent-level 0
   6 .
   7 .de1 rstReportMargin
   8 \\$1 \\n[an-margin]
   9 level \\n[rst2man-indent-level]
  10 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
  11 -
  12 \\n[rst2man-indent0]
  13 \\n[rst2man-indent1]
  14 \\n[rst2man-indent2]
  15 ..
  16 .de1 INDENT
  17 .\" .rstReportMargin pre:
  18 . RS \\$1
  19 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
  20 . nr rst2man-indent-level +1
  21 .\" .rstReportMargin post:
  22 ..
  23 .de UNINDENT
  24 . RE
  25 .\" indent \\n[an-margin]
  26 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
  27 .nr rst2man-indent-level -1
  28 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
  29 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
  30 ..
  31 .TH "reference tests" "" "" ""
  32 .SH Name
  33 reference tests \-
  34 .SH how to markup
  35 .sp
  36 link adr in .UR .UE or simply in parantheses
  37 .INDENT 0.0
  38 .IP \(bu 2
  39 man and mandoc convert UR/UE to \fB<\fP and \fB>\fP\&.
  40 .IP \(bu 2
  41 pandoc transforms
  42 .INDENT 2.0
  43 .INDENT 3.5
  44 .sp
  45 .EX
  46 See the \(gaPython home page <https://www.python.org>\(ga_ for info.
  47 .EE
  48 .UNINDENT
  49 .UNINDENT
  50 .sp
  51 to
  52 .INDENT 2.0
  53 .INDENT 3.5
  54 .sp
  55 .EX
  56 see See the Python home page (https://www.python.org) for info.
  57 .EE
  58 .UNINDENT
  59 .UNINDENT
  60 .UNINDENT
  61 .SH test for references in man pages
  62 .sp
  63 embedded in a paragraph
  64 .INDENT 0.0
  65 .IP \(bu 2
  66 at line start
  67 .IP \(bu 2
  68 in line
  69 .IP \(bu 2
  70 at eol
  71 .UNINDENT
  72 .sp
  73 at start of paragraph
  74 .INDENT 0.0
  75 .IP \(bu 2
  76 followed by text
  77 .IP \(bu 2
  78 at eol
  79 .UNINDENT
  80 .sp
  81 at end of paragraph
  82 .SH tests
  83 .sp
  84 See  <https://docutils.sourceforge.io/docs/user/rst/quickref.html#explicit\-markup>
  85 for more
  86 .sp
  87 See the Python home page <https://www.python.org>
  88  for info.
  89 .sp
  90 External hyperlinks, like Python <https://www.python.org>
  91 \&.
  92 .sp
  93 Want to learn about my favorite programming language <https://www.python.org>
  94 ?
  95 .sp
  96 Clicking on this internal hyperlink will take us to the target
  97 below.
  98 .sp
  99 The hyperlink target above points to this paragraph.
 100 .INDENT 0.0
 101 .IP \(bu 2
 102 bullet list
 103 .IP \(bu 2
 104 second item, with hyperlink target.
 105 .UNINDENT
 106 .sp
 107 See the Python <https://www.python.org>
 108  home page for info.
 109 .sp
 110 Write to me <mailto:jdoe@example.com>
 111  with your questions.
 112 .sp
 113 The one\-liner <https://docutils.sourceforge.io/rst.html>
 114  and starts\-on\-this\-line <https://docutils.sourceforge.net/rst.html>
 115  or entirely\-below <https://docutils.sourceforge.net/rst.html>
 116  point to   <https://docutils.sourceforge.io/rst.html>  and in man are ... ?
 117 .sp
 118 Escaped whitespace is preserved as intentional spaces, e.g.:
 119 .sp
 120 some reference <../local path with spaces.html>
 121  to a local path.
 122 .sp
 123 Anonymous hyperlink references are specified with two underscores instead of one:
 124 .sp
 125 See the web site of my favorite programming language <https://www.python.org>
 126 \&.
 127 .sp
 128 Anonymous targets begin with \(dq.. __:\(dq; no reference name is required or allowed:
 129 .\" End of generated man page.