макросы для форматирования страниц руководства (macros to format man pages)
Примечание (Note)
By all means include full URLs (or URIs) in the text itself; some
tools such as man2html
(1) can automatically turn them into
hypertext links. You can also use the UR
and UE
macros to
identify links to related information. If you include URLs, use
the full URL (e.g., ⟨http://www.kernel.org⟩) to ensure that tools
can automatically find the URLs.
Tools processing these files should open the file and examine the
first nonwhitespace character. A period (.) or single quote (')
at the beginning of a line indicates a troff-based file (such as
man or mdoc). A left angle bracket (<) indicates an SGML/XML-
based file (such as HTML or Docbook). Anything else suggests
simple ASCII text (e.g., a "catman" result).
Many man pages begin with '\"
followed by a space and a list of
characters, indicating how the page is to be preprocessed. For
portability's sake to non-troff translators we recommend that you
avoid using anything other than tbl(1), and Linux can detect that
automatically. However, you might want to include this
information so your man page can be handled by other (less
capable) systems. Here are the definitions of the preprocessors
invoked by these characters:
e
eqn(1)
g
grap(1)
p
pic(1)
r
refer(1)
t
tbl(1)
v
vgrind(1)