Print this page
9718 update mandoc to 1.14.4


 967              the next trap or the bottom of the page.  Currently ignored.
 968 
 969      nf      Switch to no-fill mode.  See man(5).  Ignored by mdoc(5).
 970 
 971      nh      Turn off automatic hyphenation mode.  Currently ignored.
 972 
 973      nhychar char ...
 974              Define hyphenation-inhibiting characters.  This is a Heirloom
 975              extension and currently ignored.
 976 
 977      nm [start [inc [space [indent]]]]
 978              Print line numbers.  Currently unsupported.
 979 
 980      nn [number]
 981              Temporarily turn off line numbering.  Currently unsupported.
 982 
 983      nop body
 984              Execute the rest of the input line as a request or macro line.
 985              Currently unsupported.
 986 
 987      nr register [+|-]expression
 988              Define or change a register.  A register is an arbitrary string
 989              value that defines some sort of state, which influences parsing
 990              and/or formatting.  For the syntax of expression, see Numerical
 991              expressions below.  If it is prefixed by a sign, the register
 992              will be incremented or decremented instead of assigned to.
 993 




 994              The following register is handled specially:
 995 
 996              nS      If set to a positive integer value, certain mdoc(5)
 997                      macros will behave in the same way as in the SYNOPSIS
 998                      section.  If set to 0, these macros will behave in the
 999                      same way as outside the SYNOPSIS section, even when
1000                      called within the SYNOPSIS section itself.  Note that
1001                      starting a new mdoc(5) section with the Sh macro will
1002                      reset this register.
1003 
1004      nrf register [+|-]expression [increment]
1005              Define or change a floating-point register.  This is a Heirloom
1006              extension and currently unsupported.
1007 
1008      nroff   Force nroff mode.  This is a groff extension and currently
1009              ignored.
1010 
1011      ns      Turn on no-space mode.  Currently ignored.
1012 
1013      nx [filename]


1071              Retrieve the bounding box of a PostScript file.  Currently
1072              unsupported.
1073 
1074      pshape indent length ...
1075              Set a special shape for the current paragraph.  This is a
1076              Heirloom extension and currently unsupported.
1077 
1078      pso command
1079              Include output of a shell command.  Ignored because insecure.
1080 
1081      ptr     Print the names and positions of all traps on standard error
1082              output.  This is a groff extension and currently ignored.
1083 
1084      pvs [[+|-]height]
1085              Change post-vertical spacing.  This is a groff extension and
1086              currently ignored.
1087 
1088      rchar glyph ...
1089              Remove glyph definitions.  Currently unsupported.
1090 
1091      rd [prompt [agument ...]]
1092              Read from standard input.  Currently ignored.
1093 
1094      recursionlimit maxrec maxtail
1095              Set the maximum stack depth for recursive macros.  This is a
1096              Heirloom extension and currently ignored.
1097 
1098      return [twice]
1099              Exit a macro and return to the caller.  Currently unsupported.
1100 
1101      rfschar font glyph ...
1102              Remove font-specific fallback glyph definitions.  Currently
1103              unsupported.
1104 
1105      rhang font char ... afmunits
1106              Hang characters at right margin.  This is a Heirloom extension
1107              and currently ignored.
1108 
1109      rj [N]  Justify the next N input lines to the right margin without
1110              filling.  N defaults to 1.  An argument of 0 or less ends right
1111              adjustment.


1500      Mark horizontal input place in register; ignored by mandoc(1).  For short
1501      names, there are variants \kc and \k(cc.
1502 
1503    \L'number[c]'
1504      Vertical line drawing function; ignored by mandoc(1).
1505 
1506    \l'width[c]'
1507      Draw a horizontal line of width using the glyph c.
1508 
1509    \M[name]
1510      Set fill (background) color (groff extension); ignored by mandoc(1).  For
1511      short names, there are variants \Mc and \M(cc.
1512 
1513    \m[name]
1514      Set glyph drawing color (groff extension); ignored by mandoc(1).  For
1515      short names, there are variants \mc and \m(cc.
1516 
1517    \N'number'
1518      Character number on the current font.
1519 
1520    \n[name]
1521      Interpolate the number register name.  For short names, there are
1522      variants \nc and \n(cc.


1523 
1524    \o'string'
1525      Overstrike, writing all the characters contained in the string to the
1526      same output position.  In terminal and HTML output modes, only the last
1527      one of the characters is visible.
1528 
1529    \p
1530      Break the output line at the end of the current word.
1531 
1532    \R'name [+|-]number'
1533      Set number register; ignored by mandoc(1).
1534 
1535    \S'number'
1536      Slant output; ignored by mandoc(1).
1537 
1538    \s'[+|-]number'
1539      Change point size; ignored by mandoc(1).  Alternative forms \s[+|-]n,
1540      \s[+|-]'number', \s[[+|-]number], and \s[+|-][number] are also parsed and
1541      ignored.
1542 


1613      1976 and 1992.
1614 
1615      Joseph F. Ossanna, Brian W. Kernighan, and Gunnar Ritter, Heirloom
1616      Documentation Tools Nroff/Troff User's Manual,
1617      http://heirloom.sourceforge.net/doctools/troff.pdf, September 17, 2007.
1618 
1619 HISTORY
1620      The RUNOFF typesetting system, whose input forms the basis for roff, was
1621      written in MAD and FAP for the CTSS operating system by Jerome E.
1622      Saltzer in 1964.  Doug McIlroy rewrote it in BCPL in 1969, renaming it
1623      roff.  Dennis M. Ritchie rewrote McIlroy's roff in PDP-11 assembly for
1624      Version 1 AT&T UNIX, Joseph F. Ossanna improved roff and renamed it nroff
1625      for Version 2 AT&T     UNIX, then ported nroff to C as troff, which Brian W.
1626      Kernighan released with Version 7 AT&T UNIX.  In 1989, James Clarke re-
1627      implemented troff in C++, naming it groff.
1628 
1629 AUTHORS
1630      This roff reference was written by Kristaps Dzonsons <kristaps@bsd.lv>
1631      and Ingo Schwarze <schwarze@openbsd.org>.
1632 
1633 illumos                          July 5, 2017                          illumos


 967              the next trap or the bottom of the page.  Currently ignored.
 968 
 969      nf      Switch to no-fill mode.  See man(5).  Ignored by mdoc(5).
 970 
 971      nh      Turn off automatic hyphenation mode.  Currently ignored.
 972 
 973      nhychar char ...
 974              Define hyphenation-inhibiting characters.  This is a Heirloom
 975              extension and currently ignored.
 976 
 977      nm [start [inc [space [indent]]]]
 978              Print line numbers.  Currently unsupported.
 979 
 980      nn [number]
 981              Temporarily turn off line numbering.  Currently unsupported.
 982 
 983      nop body
 984              Execute the rest of the input line as a request or macro line.
 985              Currently unsupported.
 986 
 987      nr register [+|-]expression [stepsize]
 988              Define or change a register.  A register is an arbitrary string
 989              value that defines some sort of state, which influences parsing
 990              and/or formatting.  For the syntax of expression, see Numerical
 991              expressions below.  If it is prefixed by a sign, the register
 992              will be incremented or decremented instead of assigned to.
 993 
 994              The stepsize is used by the \n+ auto-increment feature.  It
 995              remains unchanged when omitted while changing an existing
 996              register, and it defaults to 0 when defining a new register.
 997 
 998              The following register is handled specially:
 999 
1000              nS      If set to a positive integer value, certain mdoc(5)
1001                      macros will behave in the same way as in the SYNOPSIS
1002                      section.  If set to 0, these macros will behave in the
1003                      same way as outside the SYNOPSIS section, even when
1004                      called within the SYNOPSIS section itself.  Note that
1005                      starting a new mdoc(5) section with the Sh macro will
1006                      reset this register.
1007 
1008      nrf register [+|-]expression [increment]
1009              Define or change a floating-point register.  This is a Heirloom
1010              extension and currently unsupported.
1011 
1012      nroff   Force nroff mode.  This is a groff extension and currently
1013              ignored.
1014 
1015      ns      Turn on no-space mode.  Currently ignored.
1016 
1017      nx [filename]


1075              Retrieve the bounding box of a PostScript file.  Currently
1076              unsupported.
1077 
1078      pshape indent length ...
1079              Set a special shape for the current paragraph.  This is a
1080              Heirloom extension and currently unsupported.
1081 
1082      pso command
1083              Include output of a shell command.  Ignored because insecure.
1084 
1085      ptr     Print the names and positions of all traps on standard error
1086              output.  This is a groff extension and currently ignored.
1087 
1088      pvs [[+|-]height]
1089              Change post-vertical spacing.  This is a groff extension and
1090              currently ignored.
1091 
1092      rchar glyph ...
1093              Remove glyph definitions.  Currently unsupported.
1094 
1095      rd [prompt [argument ...]]
1096              Read from standard input.  Currently ignored.
1097 
1098      recursionlimit maxrec maxtail
1099              Set the maximum stack depth for recursive macros.  This is a
1100              Heirloom extension and currently ignored.
1101 
1102      return [twice]
1103              Exit a macro and return to the caller.  Currently unsupported.
1104 
1105      rfschar font glyph ...
1106              Remove font-specific fallback glyph definitions.  Currently
1107              unsupported.
1108 
1109      rhang font char ... afmunits
1110              Hang characters at right margin.  This is a Heirloom extension
1111              and currently ignored.
1112 
1113      rj [N]  Justify the next N input lines to the right margin without
1114              filling.  N defaults to 1.  An argument of 0 or less ends right
1115              adjustment.


1504      Mark horizontal input place in register; ignored by mandoc(1).  For short
1505      names, there are variants \kc and \k(cc.
1506 
1507    \L'number[c]'
1508      Vertical line drawing function; ignored by mandoc(1).
1509 
1510    \l'width[c]'
1511      Draw a horizontal line of width using the glyph c.
1512 
1513    \M[name]
1514      Set fill (background) color (groff extension); ignored by mandoc(1).  For
1515      short names, there are variants \Mc and \M(cc.
1516 
1517    \m[name]
1518      Set glyph drawing color (groff extension); ignored by mandoc(1).  For
1519      short names, there are variants \mc and \m(cc.
1520 
1521    \N'number'
1522      Character number on the current font.
1523 
1524    \n[+|-][name]
1525      Interpolate the number register name.  For short names, there are
1526      variants \nc and \n(cc.  If the optional sign is specified, the register
1527      is first incremented or decremented by the stepsize that was specified in
1528      the relevant nr request, and the changed value is interpolated.
1529 
1530    \o'string'
1531      Overstrike, writing all the characters contained in the string to the
1532      same output position.  In terminal and HTML output modes, only the last
1533      one of the characters is visible.
1534 
1535    \p
1536      Break the output line at the end of the current word.
1537 
1538    \R'name [+|-]number'
1539      Set number register; ignored by mandoc(1).
1540 
1541    \S'number'
1542      Slant output; ignored by mandoc(1).
1543 
1544    \s'[+|-]number'
1545      Change point size; ignored by mandoc(1).  Alternative forms \s[+|-]n,
1546      \s[+|-]'number', \s[[+|-]number], and \s[+|-][number] are also parsed and
1547      ignored.
1548 


1619      1976 and 1992.
1620 
1621      Joseph F. Ossanna, Brian W. Kernighan, and Gunnar Ritter, Heirloom
1622      Documentation Tools Nroff/Troff User's Manual,
1623      http://heirloom.sourceforge.net/doctools/troff.pdf, September 17, 2007.
1624 
1625 HISTORY
1626      The RUNOFF typesetting system, whose input forms the basis for roff, was
1627      written in MAD and FAP for the CTSS operating system by Jerome E.
1628      Saltzer in 1964.  Doug McIlroy rewrote it in BCPL in 1969, renaming it
1629      roff.  Dennis M. Ritchie rewrote McIlroy's roff in PDP-11 assembly for
1630      Version 1 AT&T UNIX, Joseph F. Ossanna improved roff and renamed it nroff
1631      for Version 2 AT&T     UNIX, then ported nroff to C as troff, which Brian W.
1632      Kernighan released with Version 7 AT&T UNIX.  In 1989, James Clarke re-
1633      implemented troff in C++, naming it groff.
1634 
1635 AUTHORS
1636      This roff reference was written by Kristaps Dzonsons <kristaps@bsd.lv>
1637      and Ingo Schwarze <schwarze@openbsd.org>.
1638 
1639 illumos                         April 10, 2018                         illumos