[BACK]Return to mdoc.7 CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Annotation of mandoc/mdoc.7, Revision 1.2

1.2     ! kristaps    1: .\" $Id: mdoc.7,v 1.1 2009/03/13 07:46:10 kristaps Exp $
1.1       kristaps    2: .\"
                      3: .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
                      4: .\"
                      5: .\" Permission to use, copy, modify, and distribute this software for any
                      6: .\" purpose with or without fee is hereby granted, provided that the
                      7: .\" above copyright notice and this permission notice appear in all
                      8: .\" copies.
                      9: .\"
                     10: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
                     11: .\" WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
                     12: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
                     13: .\" AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
                     14: .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
                     15: .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
                     16: .\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
                     17: .\" PERFORMANCE OF THIS SOFTWARE.
                     18: .\"
                     19: .Dd $Mdocdate$
                     20: .Dt mdoc 7
                     21: .Os
                     22: .\" SECTION
                     23: .Sh NAME
                     24: .Nm mdoc
                     25: .Nd mdoc macro reference
                     26: .\" SECTION
                     27: .Sh DESCRIPTION
                     28: The
                     29: .Nm mdoc
                     30: language is used to format
                     31: .Bx
                     32: .Ux
                     33: manuals.  An
                     34: .Nm
                     35: document follows simple rules:  lines beginning with the control
                     36: character
                     37: .Sq \.
                     38: are parsed for macros.  Other lines are interpreted within the scope of
                     39: prior macros.  Macros are either two or three characters in length.
                     40: .\" SECTION
                     41: .Sh CHARACTER ENCODING
                     42: .Nm
                     43: documents may contain only printable alphanumeric characters, the space
                     44: character
                     45: .Sq \  ,
                     46: and, in certain circumstances, the tab character
                     47: .Sq \et .
                     48: All manuals must have
                     49: .Sq \en
                     50: line termination.
                     51: .\" SUB-SECTION
1.2     ! kristaps   52: .Ss Reserved Characters
        !            53: Within a macro line, the following characters are reserved:
        !            54: .Bl -tag -width 12n -offset XXXX -compact
1.1       kristaps   55: .It \&.
1.2     ! kristaps   56: .Pq period
1.1       kristaps   57: .It \&,
1.2     ! kristaps   58: .Pq comma
1.1       kristaps   59: .It \&:
1.2     ! kristaps   60: .Pq colon
1.1       kristaps   61: .It \&;
1.2     ! kristaps   62: .Pq semicolon
1.1       kristaps   63: .It \&(
1.2     ! kristaps   64: .Pq left-parenthesis
1.1       kristaps   65: .It \&)
1.2     ! kristaps   66: .Pq right-parenthesis
1.1       kristaps   67: .It \&[
1.2     ! kristaps   68: .Pq left-bracket
1.1       kristaps   69: .It \&]
1.2     ! kristaps   70: .Pq right-bracket
1.1       kristaps   71: .It \&?
1.2     ! kristaps   72: .Pq question
1.1       kristaps   73: .It \&!
1.2     ! kristaps   74: .Pq exclmamation
1.1       kristaps   75: .El
                     76: .Pp
                     77: Use of these characters must either be escaped with a non-breaking space
                     78: .Pq Sq \e&
1.2     ! kristaps   79: or, if applicable, an appropriate escape-sequence used.  Use of reserved
        !            80: characters is described later in this document.
1.1       kristaps   81: .\" SUB-SECTION
                     82: .Ss Special Characters
                     83: Special character sequences begin with the escape character
                     84: .Sq \\
                     85: and followed by either an open-parenthesis
                     86: .Sq \&(
                     87: for two-character sequences; an open-bracket
                     88: .Sq \&[
                     89: for n-character sequences (terminated at a close-bracket
                     90: .Sq \&] ) ;
                     91: or a single one-character sequence.
                     92: .Pp
                     93: Characters may alternatively be escaped by a slash-asterisk,
                     94: .Sq \\* ,
                     95: with the same combinations as described above.  This form, however, is
                     96: deprecated.  The following is a table of all available escapes, arranged
                     97: by classification.
                     98: .Pp
                     99: Grammatic:
                    100: .Bl -tag -width 12n -offset "XXXX" -compact
                    101: .It \\(em
                    102: .Pq em-dash
                    103: .It \\(en
                    104: .Pq en-dash
                    105: .It \e-
                    106: .Pq hyphen
                    107: .It \\\\
                    108: .Pq back-slash
                    109: .It \e'
                    110: .Pq apostrophe
                    111: .It \e`
                    112: .Pq back-tick
                    113: .It \\
                    114: .Pq space
                    115: .It \\.
                    116: .Pq period
                    117: .El
                    118: .\" PARAGRAPH
                    119: .Pp
                    120: Enclosures:
                    121: .Bl -tag -width 12n -offset "XXXX" -compact
                    122: .It \\(rC
                    123: .Pq right brace
                    124: .It \\(lC
                    125: .Pq left brace
                    126: .It \\(ra
                    127: .Pq right angle
                    128: .It \\(la
                    129: .Pq left angle
                    130: .It \\(rB
                    131: .Pq right bracket
                    132: .It \\(lB
                    133: .Pq left bracket
                    134: .It \\q
                    135: .Pq double-quote
                    136: .It \\(lq
                    137: .Pq left double-quote
                    138: .It \\(Lq
                    139: .Pq left double-quote, deprecated
                    140: .It \\(rq
                    141: .Pq right double-quote
                    142: .It \\(Rq
                    143: .Pq right double-quote, deprecated
                    144: .It \\(oq
                    145: .Pq left single-quote
                    146: .It \\(aq
                    147: .Pq right single-quote
                    148: .El
                    149: .\" PARAGRAPH
                    150: .Pp
                    151: Indicatives:
                    152: .Bl -tag -width 12n -offset "XXXX" -compact
                    153: .It \\(<-
                    154: .Pq left arrow
                    155: .It \\(->
                    156: .Pq right arrow
                    157: .It \\(ua
                    158: .Pq up arrow
                    159: .It \\(da
                    160: .Pq down arrow
                    161: .El
                    162: .\" PARAGRAPH
                    163: .Pp
                    164: Mathematical:
                    165: .Bl -tag -width 12n -offset "XXXX" -compact
                    166: .It \\(Gt
                    167: .Pq greater-than, deprecated
                    168: .It \\(Lt
                    169: .Pq less-than, deprecated
                    170: .It \\(<=
                    171: .Pq less-than-equal
                    172: .It \\(Le
                    173: .Pq less-than-equal, deprecated
                    174: .It \\(>=
                    175: .Pq greater-than-equal
                    176: .It \\(Ge
                    177: .Pq greater-than-equal
                    178: .It \\(==
                    179: .Pq equal
                    180: .It \\(!=
                    181: .Pq not equal
                    182: .It \\(Ne
                    183: .Pq not equal, deprecated
                    184: .It \\(if
                    185: .Pq infinity
                    186: .It \\(If
                    187: .Pq infinity, deprecated
                    188: .It \\(na
                    189: .Pq NaN , an extension
                    190: .It \\(Na
                    191: .Pq NaN, deprecated
                    192: .It \\(+-
                    193: .Pq plus-minus
                    194: .It \\(Pm
                    195: .Pq plus-minus, deprecated
                    196: .It \\(**
                    197: .Pq asterisk
                    198: .El
                    199: .\" PARAGRAPH
                    200: .Pp
                    201: Diacritics:
                    202: .Bl -tag -width 12n -offset "XXXX" -compact
                    203: .It \\(ga
                    204: .Pq accent grave
                    205: .It \\(aa
                    206: .Pq accent accute
                    207: .El
                    208: .\" PARAGRAPH
                    209: .Pp
                    210: Special symbols:
                    211: .Bl -tag -width 12n -offset "XXXX" -compact
                    212: .It \\(bu
                    213: .Pq bullet
                    214: .It \\(ba
                    215: .Pq bar
                    216: .It \\(Ba
                    217: .Pq bar, deprecated
                    218: .It \\(co
                    219: .Pq copyright
                    220: .It \\&
                    221: .Pq non-breaking space
                    222: .It \\e
                    223: .Pq escape
                    224: .It \\(Am
                    225: .Pq ampersand, deprecated
                    226: .El
                    227: .\" SECTION
1.2     ! kristaps  228: .Sh ONTOLOGY
1.1       kristaps  229: Macros are classified in an ontology described by scope rules.
1.2     ! kristaps  230: .Bl -inset
1.1       kristaps  231: .\" LIST-ITEM
                    232: .It Em Block
1.2     ! kristaps  233: macros enclose other block macros, in-line macros or text, and
1.1       kristaps  234: may span multiple lines.
                    235: .Qq Implicit
                    236: block scope is closed by a subsequent invocation of the same macro,
                    237: one of a set of corresponding closure macros or end-of-file.
                    238: .Qq Explicit
                    239: block scope is closed by a corresponding closure macro.
1.2     ! kristaps  240: .Bl -inset -offset XXXX
1.1       kristaps  241: .\" LIST-ITEM
                    242: .It Em Full-block
1.2     ! kristaps  243: macros always span multiple lines.  They consist optionally of one or
        !           244: more
1.1       kristaps  245: .Qq heads ,
                    246: subsequent macros or text on the same line following invocation; a
                    247: .Qq body ,
                    248: which spans subsequent lines of text or macros; and an optional
                    249: .Qq tail ,
                    250: macros or text on the same line following closure.
                    251: .\" LIST-ITEM
                    252: .It Em Partial-block
1.2     ! kristaps  253: macros may span multiple lines.  They consists optionally of a
1.1       kristaps  254: .Qq head ,
                    255: text immediately following invocation; always a
                    256: .Qq body ,
                    257: text or macros following the head on the same and subsequent lines; and
                    258: optionally a
                    259: .Qq tail ,
                    260: text immediately following closure.
                    261: .El
                    262: .\" LIST-ITEM
                    263: .It Em In-line
1.2     ! kristaps  264: macros may only enclose text and span at most a single line.  If
1.1       kristaps  265: a macro is parsable, its scope may be closed by subsequent macros or
                    266: delimiting punctuation.  In-line macros follow different conventions for
                    267: closure; see
                    268: .Sx MACROS
                    269: for per-macro details.
                    270: .El
                    271: .\" .\" SUB-SECTION
                    272: .\" .Ss Examples
                    273: .\" The following examples illustrate each macro classification.
                    274: .\" .\" PARAGRAPH
                    275: .\" .Pp
                    276: .\" Implicit full-block.  Has head, body and no tail.  Scope closed by
                    277: .\" second
                    278: .\" .Sq \&Sh
                    279: .\" invocation.
                    280: .\" .Bd -literal -offset XXXX
                    281: .\" \&.Sh SECTION 1
                    282: .\" body...
                    283: .\" \&.Sh SECTION 2
                    284: .\" .Ed
                    285: .\" .\" PARAGRAPH
                    286: .\" .Pp
                    287: .\" Nested implicit full-block, where the subsection
                    288: .\" .Sq \&Ss
                    289: .\" is within the scope of the parent section
                    290: .\" .Sq \&Sh
                    291: .\" and closed along with its parent by the subsequent
                    292: .\" .Sq \&Sh .
                    293: .\" .Bd -literal -offset XXXX
                    294: .\" \&.Sh SECTION 1
                    295: .\" \&.Ss Subsection 1
                    296: .\" body...
                    297: .\" \&.Sh SECTION 2
                    298: .\" .Ed
                    299: .\" .\" PARAGRAPH
                    300: .\" .Pp
                    301: .\" Explicit full-block.  Has a head, a body and no tail.  Scope closed by
                    302: .\" .Sq \&Ef
                    303: .\" invocation.
                    304: .\" .Bd -literal -offset XXXX
                    305: .\" \&.Bf symbolic
                    306: .\" body...
                    307: .\" \&.Ef
                    308: .\" .Ed
                    309: .\" .\" PARAGRAPH
                    310: .\" .Pp
                    311: .\" Nested explicit/implicit scope.
                    312: .\" .Sq \&It
                    313: .\" macro is an implicit block whose scope is closed by the explicit
                    314: .\" .Sq \&El
                    315: .\" closure.
                    316: .\" .Bd -literal -offset XXXX
                    317: .\" \&.Bl \-bullet
                    318: .\" \&.It head
                    319: .\" body...
                    320: .\" \&.El
                    321: .\" .Ed
                    322: .\" .\" PARAGRAPH
                    323: .\" .Pp
                    324: .\" Explicit partial-block.  Has head, body and tail.  Scope closed by
                    325: .\" .Sq \&Ec
                    326: .\" invocation.
                    327: .\" .Bd -literal -offset XXX
                    328: .\" \&.Eo head body... \&Ec tail
                    329: .\" .Ed
                    330: .\" .\" PARAGRAPH
                    331: .\" .Pp
                    332: .\" Implicit partial-block.  Has only body.  Scope is closed by end-of-line.
                    333: .\" .Bd -literal -offset XXX
                    334: .\" \&.Sq body...
                    335: .\" .Ed
                    336: .\" .\" PARAGRAPH
                    337: .\" .Pp
                    338: .\" Explicit partial-block with only body and scope closed by
                    339: .\" .Sq \&Ac
                    340: .\" invocation.
                    341: .\" .Bd -literal -offset XXXX
                    342: .\" \&.Ao body... \&Ac
                    343: .\" .Ed
                    344: .\" .\" PARAGRAPH
                    345: .\" .Pp
                    346: .\" Implicit partial-block enclosing explicit partial-block.
                    347: .\" .Bd -literal -offset XXX
                    348: .\" \&.Sq body... \&Ao body... \&Ac
                    349: .\" .Ed
                    350: .\" .\" PARAGRAPH
                    351: .\" .Pp
                    352: .\" Inline macros, several in sequence.  Scope is closed for
                    353: .\" .Sq \&Fl
                    354: .\" by the punctuation delimiter and
                    355: .\" .Sq \&Ar
                    356: .\" by the end-of-line.
                    357: .\" .Bd -literal -offset XXXX
                    358: .\" \&.Fl text0 text1 ; Ar text0 text1
                    359: .\" .Ed
                    360: .\" SECTION
1.2     ! kristaps  361: .Sh SYNTAX
        !           362: The syntax of macro invocation depends on classification.
        !           363: .Qq \-arg
        !           364: refers to the macro arguments (which may contain zero or more values).
        !           365: In these illustrations,
        !           366: .Sq \&.Yo
        !           367: opens the scope of a macro, and if specified,
        !           368: .Sq \&.Yc
        !           369: closes it out (closure may be implicit at end-of-line or end-of-file).
        !           370: .Pp
        !           371: Block full-explicit (may contain head, body, tail):
        !           372: .Bd -literal -offset XXXX
        !           373: \&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBhead...\(rB
        !           374: \(lBbody...\(rB
        !           375: \&.Yc \(lBtail...\(rB
        !           376: .Ed
        !           377: .Pp
        !           378: Block full-implicit (may contain zero or more heads, body, no tail):
        !           379: .Bd -literal -offset XXXX
        !           380: \&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBhead... \(lBTa head...\(rB\(rB
        !           381: \(lBbody...\(rB
        !           382: \&.Yc
        !           383: .Ed
        !           384: .Pp
        !           385: Block partial-explicit (may contain head, multi-line body, tail):
        !           386: .Bd -literal -offset XXXX
        !           387: \&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBhead...\(rB
        !           388: \(lBbody...\(rB
        !           389: \&.Yc \(lBtail...\(rB
        !           390:
        !           391: \&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBhead...\(rB \
        !           392: \(lBbody...\(rB \&Yc \(lBtail...\(rB
        !           393: .Ed
        !           394: .Pp
        !           395: Block partial-implicit (no head, body, no tail):
        !           396: .Bd -literal -offset XXXX
        !           397: \&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBbody...\(rB
        !           398: .Ed
        !           399: .Pp
        !           400: In-line (may be closed by end-of-line, reserved character, subsequent
        !           401: macro invocation or finite number of arguments):
        !           402: .Bd -literal -offset XXX
        !           403: \&.Yy \(lB\-arg \(lBval...\(rB\(rB args...
        !           404:
        !           405: \&.Yy \(lB\-arg \(lBval...\(rB\(rB args... ;
        !           406:
        !           407: \&.Yy \(lB\-arg \(lBval...\(rB\(rB args... Xx
        !           408:
        !           409: \&.Yy \(lB\-arg \(lBval...\(rB\(rB arg0 arg1 argN
        !           410: .Ed
        !           411: .\"
1.1       kristaps  412: .Sh MACROS
                    413: This section contains a complete list of all
                    414: .Nm
1.2     ! kristaps  415: macros, arranged ontologically.  A
1.1       kristaps  416: .Qq callable
                    417: macro is may be invoked subsequent to the initial macro-line macro.  A
                    418: .Qq parsable
1.2     ! kristaps  419: macro may be followed by further (ostensibly callable) macros.
1.1       kristaps  420: .\" SUB-SECTION
                    421: .Ss Block full-implicit
                    422: The head of these macros follows invocation; the body is the content of
                    423: subsequent lines prior to closure.  None of these macros have tails;
                    424: some
                    425: .Po
                    426: .Sq \&It \-bullet ,
                    427: .Sq \-hyphen ,
                    428: .Sq \-dash ,
1.2     ! kristaps  429: .Sq \-enum ,
        !           430: .Sq \-item
1.1       kristaps  431: .Pc
                    432: don't have heads.
                    433: .Pp
                    434: .Bl -column "MacroX" "CallableX" "ParsableX" "Closing" -compact -offset XXXX
                    435: .It Em Macro Ta Em Callable Ta Em Parsable Ta Em Closing
                    436: .It \&.Sh    Ta    \&No    Ta    \&No    Ta    \&.Sh
                    437: .It \&.Ss    Ta    \&No    Ta    \&No    Ta    \&.Sh, \&.Ss
                    438: .It \&.It    Ta    \&No    Ta    Yes     Ta    \&.It, \&.El
                    439: .El
                    440: .\" SUB-SECTION
                    441: .Ss Block full-explicit
                    442: None of these macros are callable or parsed.  The last column indicates
                    443: the explicit scope rules.  All contains bodies, some may contain heads
                    444: .Pq So \&Bf Sc .
                    445: .Pp
                    446: .Bl -column "MacroX" "CallableX" "ParsableX" "closed by XXX" -compact -offset XXXX
                    447: .It Em Macro Ta Em Callable Ta Em Parsable Ta Em Scope
                    448: .It \&.Bd    Ta    \&No    Ta    \&No    Ta    closed by \&.Ed
                    449: .It \&.Ed    Ta    \&No    Ta    \&No    Ta    opened by \&.Bd
                    450: .It \&.Bl    Ta    \&No    Ta    \&No    Ta    closed by \&.El
                    451: .It \&.El    Ta    \&No    Ta    \&No    Ta    opened by \&.Bl
                    452: .It \&.Bf    Ta    \&No    Ta    \&No    Ta    closed by \&.Ef
                    453: .It \&.Ef    Ta    \&No    Ta    \&No    Ta    opened by \&.Bf
1.2     ! kristaps  454: .It \&.Bk    Ta    \&No    Ta    \&No    Ta    closed by \&.Ek
        !           455: .It \&.Ek    Ta    \&No    Ta    \&No    Ta    opened by \&.Bk
1.1       kristaps  456: .El
                    457: .\" SUB-SECTION
                    458: .Ss Block partial-implicit
                    459: All of these are callable and parsed for further macros.  Their scopes
                    460: close at the invocation's end-of-line.
                    461: .Pp
                    462: .Bl -column "MacroX" "CallableX" "ParsableX" -compact -offset XXXX
                    463: .It Em Macro Ta Em Callable Ta Em Parsable
                    464: .It \&.Aq    Ta    Yes   Ta    Yes
                    465: .It \&.Op    Ta    Yes   Ta    Yes
                    466: .It \&.Bq    Ta    Yes   Ta    Yes
                    467: .It \&.Dq    Ta    Yes   Ta    Yes
                    468: .It \&.Pq    Ta    Yes   Ta    Yes
                    469: .It \&.Qq    Ta    Yes   Ta    Yes
                    470: .It \&.Sq    Ta    Yes   Ta    Yes
                    471: .It \&.Brq   Ta    Yes   Ta    Yes
1.2     ! kristaps  472: .It \&.D1    Ta    \&No  Ta    \&Yes
        !           473: .It \&.Dl    Ta    \&No  Ta    Yes
        !           474: .It \&.Ql    Ta    Yes   Ta    Yes
1.1       kristaps  475: .El
                    476: .\" SUB-SECTION
                    477: .Ss Block partial-explicit
                    478: Each of these contains at least a body and, in limited circumstances, a
                    479: head
                    480: .Pq So \&Fo Sc , So \&Eo Sc
                    481: and/or tail
                    482: .Pq So \&Ec Sc .
                    483: .Pp
                    484: .Bl -column "MacroX" "CallableX" "ParsableX" "closed by XXXX" -compact -offset XXXX
                    485: .It Em Macro Ta Em Callable Ta Em Parsable Ta Em Scope
                    486: .It \&.Ao    Ta    Yes   Ta    Yes    Ta    closed by \&.Ac
                    487: .It \&.Ac    Ta    Yes   Ta    Yes    Ta    opened by \&.Ao
                    488: .It \&.Bc    Ta    Yes   Ta    Yes    Ta    closed by \&.Bo
                    489: .It \&.Bo    Ta    Yes   Ta    Yes    Ta    opened by \&.Bc
                    490: .It \&.Pc    Ta    Yes   Ta    Yes    Ta    closed by \&.Po
                    491: .It \&.Po    Ta    Yes   Ta    Yes    Ta    opened by \&.Pc
                    492: .It \&.Do    Ta    Yes   Ta    Yes    Ta    closed by \&.Dc
                    493: .It \&.Dc    Ta    Yes   Ta    Yes    Ta    opened by \&.Do
                    494: .It \&.Xo    Ta    Yes   Ta    Yes    Ta    closed by \&.Xc
                    495: .It \&.Xc    Ta    Yes   Ta    Yes    Ta    opened by \&.Xo
                    496: .It \&.Bro   Ta    Yes   Ta    Yes    Ta    closed by \&.Brc
                    497: .It \&.Brc   Ta    Yes   Ta    Yes    Ta    opened by \&.Bro
                    498: .It \&.Oc    Ta    Yes   Ta    Yes    Ta    closed by \&.Oo
                    499: .It \&.Oo    Ta    Yes   Ta    Yes    Ta    opened by \&.Oc
                    500: .It \&.So    Ta    Yes   Ta    Yes    Ta    closed by \&.Sc
                    501: .It \&.Sc    Ta    Yes   Ta    Yes    Ta    opened by \&.So
                    502: .It \&.Fc    Ta    Yes   Ta    Yes    Ta    opened by \&.Fo
                    503: .It \&.Fo    Ta    \&No  Ta    \&No   Ta    closed by \&.Fc
                    504: .It \&.Ec    Ta    Yes   Ta    Yes    Ta    opened by \&.Eo
                    505: .It \&.Eo    Ta    Yes   Ta    Yes    Ta    closed by \&.Ec
                    506: .It \&.Qc    Ta    Yes   Ta    Yes    Ta    opened by \&.Oo
                    507: .It \&.Qo    Ta    Yes   Ta    Yes    Ta    closed by \&.Oc
1.2     ! kristaps  508: .It \&.Re    Ta    \&No  Ta    \&No   Ta    opened by \&.Rs
        !           509: .It \&.Rs    Ta    \&No  Ta    \&No   Ta    closed by \&.Re
1.1       kristaps  510: .El
                    511: .\" SUB-SECTION
1.2     ! kristaps  512: .Ss In-line
        !           513: In-line macros have only text children.
        !           514: .Pp
        !           515: .Bl -column "MacroX" "CallableX" "ParsableX" "Arguments" -compact -offset XXXX
        !           516: .It Em Macro Ta Em Callable Ta Em Parsable Ta Em Arguments
        !           517: .It \&.Dd    Ta    \&No  Ta    \&No    Ta    \&
        !           518: .It \&.Dt    Ta    \&No  Ta    \&No    Ta    \&
        !           519: .It \&.Os    Ta    \&No  Ta    \&No    Ta    \&
        !           520: .It \&.Pp    Ta    \&No  Ta    \&No    Ta    0
        !           521: .It \&.Ad    Ta    Yes   Ta    Yes     Ta    \&
        !           522: .It \&.An    Ta    \&No  Ta    Yes     Ta    \&
        !           523: .It \&.Ar    Ta    Yes   Ta    Yes     Ta    \&
        !           524: .It \&.Cd    Ta    Yes   Ta    \&No    Ta    \&
        !           525: .It \&.Cm    Ta    Yes   Ta    Yes     Ta    \&
        !           526: .It \&.Dv    Ta    Yes   Ta    Yes     Ta    \&
        !           527: .It \&.Er    Ta    Yes   Ta    Yes     Ta    \&
        !           528: .It \&.Ev    Ta    Yes   Ta    Yes     Ta    \&
        !           529: .It \&.Ex    Ta    \&No  Ta    \&No    Ta    \&
        !           530: .It \&.Fa    Ta    Yes   Ta    Yes     Ta    \&
        !           531: .It \&.Fd    Ta    \&No  Ta    \&No    Ta    \&
        !           532: .It \&.Fl    Ta    Yes   Ta    Yes     Ta    \&
        !           533: .It \&.Fn    Ta    Yes   Ta    Yes     Ta    \&
        !           534: .It \&.Ft    Ta    \&No  Ta    Yes     Ta    \&
        !           535: .It \&.Ic    Ta    Yes   Ta    Yes     Ta    \&
        !           536: .It \&.In    Ta    \&No  Ta    \&No    Ta    \&
        !           537: .It \&.Li    Ta    Yes   Ta    Yes     Ta    \&
        !           538: .It \&.Nd    Ta    \&No  Ta    \&No    Ta    \&
        !           539: .It \&.Nm    Ta    Yes   Ta    Yes     Ta    \&
        !           540: .It \&.Ot    Ta    \&No  Ta    \&No    Ta    \&
        !           541: .It \&.Pa    Ta    Yes   Ta    Yes     Ta    \&
        !           542: .It \&.Rv    Ta    \&No  Ta    \&No    Ta    \&
        !           543: .It \&.St    Ta    \&No  Ta    Yes     Ta    \&
        !           544: .It \&.Va    Ta    Yes   Ta    Yes     Ta    \&
        !           545: .It \&.Vt    Ta    Yes   Ta    Yes     Ta    \&
        !           546: .It \&.Xr    Ta    Yes   Ta    Yes     Ta    \&
        !           547: .It \&.%A    Ta    \&No  Ta    \&No    Ta    \&
        !           548: .It \&.%B    Ta    \&No  Ta    \&No    Ta    \&
        !           549: .It \&.%C    Ta    \&No  Ta    \&No    Ta    \&
        !           550: .It \&.%D    Ta    \&No  Ta    \&No    Ta    \&
        !           551: .It \&.%I    Ta    \&No  Ta    \&No    Ta    \&
        !           552: .It \&.%J    Ta    \&No  Ta    \&No    Ta    \&
        !           553: .It \&.%N    Ta    \&No  Ta    \&No    Ta    \&
        !           554: .It \&.%O    Ta    \&No  Ta    \&No    Ta    \&
        !           555: .It \&.%P    Ta    \&No  Ta    \&No    Ta    \&
        !           556: .It \&.%R    Ta    \&No  Ta    \&No    Ta    \&
        !           557: .It \&.%T    Ta    \&No  Ta    \&No    Ta    \&
        !           558: .It \&.%V    Ta    \&No  Ta    \&No    Ta    \&
        !           559: .It \&.At    Ta    Yes   Ta    Yes     Ta    \&
        !           560: .It \&.Bsx   Ta    Yes   Ta    Yes     Ta    \&
        !           561: .It \&.Bx    Ta    Yes   Ta    Yes     Ta    \&
        !           562: .It \&.Db    Ta    \&No  Ta    \&No    Ta    \&
        !           563: .It \&.Em    Ta    Yes   Ta    Yes     Ta    \&
        !           564: .It \&.Fx    Ta    Yes   Ta    Yes     Ta    \&
        !           565: .It \&.Ms    Ta    \&No  Ta    Yes     Ta    \&
        !           566: .It \&.No    Ta    Yes   Ta    Yes     Ta    \&
        !           567: .It \&.Ns    Ta    Yes   Ta    Yes     Ta    \&
        !           568: .It \&.Nx    Ta    Yes   Ta    Yes     Ta    \&
        !           569: .It \&.Ox    Ta    Yes   Ta    Yes     Ta    \&
        !           570: .It \&.Pf    Ta    \&No  Ta    Yes     Ta    \&
        !           571: .It \&.Sm    Ta    \&No  Ta    \&No    Ta    \&
        !           572: .It \&.Sx    Ta    Yes   Ta    Yes     Ta    \&
        !           573: .It \&.Sy    Ta    Yes   Ta    Yes     Ta    \&
        !           574: .It \&.Tn    Ta    Yes   Ta    Yes     Ta    \&
        !           575: .It \&.Ux    Ta    Yes   Ta    Yes     Ta    \&
        !           576: .It \&.Bt    Ta    \&No  Ta    \&No    Ta    \&
        !           577: .It \&.Hf    Ta    \&No  Ta    \&No    Ta    \&
        !           578: .It \&.Fr    Ta    \&No  Ta    \&No    Ta    \&
        !           579: .It \&.Ud    Ta    \&No  Ta    \&No    Ta    \&
        !           580: .It \&.Lb    Ta    \&No  Ta    \&No    Ta    \&
        !           581: .It \&.Ap    Ta    Yes   Ta    Yes     Ta    \&
        !           582: .It \&.Lp    Ta    \&No  Ta    \&No    Ta    \&
        !           583: .It \&.Lk    Ta    \&No  Ta    Yes     Ta    \&
        !           584: .It \&.Mt    Ta    \&No  Ta    Yes     Ta    \&
1.1       kristaps  585: .El
1.2     ! kristaps  586: .\" SECTION
        !           587: .Sh SEE ALSO
        !           588: .Xr mdoctree 1 ,
        !           589: .Xr mdoclint 1 ,
        !           590: .Xr mdocterm 1 ,
        !           591: .Xr mdoc 3
        !           592: .\" SECTION
        !           593: .Sh AUTHORS
        !           594: The
        !           595: .Nm
        !           596: utility was written by
        !           597: .An Kristaps Dzonsons Aq kristaps@kth.se .

CVSweb