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

Diff for /mandoc/mdoc.7 between version 1.286 and 1.287

version 1.286, 2021/07/29 16:25:20 version 1.287, 2021/07/29 17:32:01
Line 632  Close an
Line 632  Close an
 .Ic \&Ao  .Ic \&Ao
 block.  block.
 Does not have any tail arguments.  Does not have any tail arguments.
   .Tg Ad
 .It Ic \&Ad Ar address  .It Ic \&Ad Ar address
 Memory address.  Memory address.
 Do not use this for postal addresses.  Do not use this for postal addresses.
Line 639  Do not use this for postal addresses.
Line 640  Do not use this for postal addresses.
 Examples:  Examples:
 .Dl \&.Ad [0,$]  .Dl \&.Ad [0,$]
 .Dl \&.Ad 0x00000000  .Dl \&.Ad 0x00000000
   .Tg An
 .It Ic \&An Fl split | nosplit | Ar first_name ... last_name  .It Ic \&An Fl split | nosplit | Ar first_name ... last_name
 Author name.  Author name.
 Can be used both for the authors of the program, function, or driver  Can be used both for the authors of the program, function, or driver
Line 679  This macro is almost never useful.
Line 681  This macro is almost never useful.
 See  See
 .Ic \&Aq  .Ic \&Aq
 for more details.  for more details.
   .Tg Ap
 .It Ic \&Ap  .It Ic \&Ap
 Inserts an apostrophe without any surrounding whitespace.  Inserts an apostrophe without any surrounding whitespace.
 This is generally used as a grammatical device when referring to the verb  This is generally used as a grammatical device when referring to the verb
Line 686  form of a function.
Line 689  form of a function.
 .Pp  .Pp
 Examples:  Examples:
 .Dl \&.Fn execve \&Ap d  .Dl \&.Fn execve \&Ap d
   .Tg Aq
 .It Ic \&Aq Ar line  .It Ic \&Aq Ar line
 Enclose the rest of the input line in angle brackets.  Enclose the rest of the input line in angle brackets.
 The only important use case is for email addresses.  The only important use case is for email addresses.
Line 730  as needed.
Line 734  as needed.
 .Pp  .Pp
 See also  See also
 .Ic \&Ao .  .Ic \&Ao .
   .Tg Ar
 .It Ic \&Ar Op Ar placeholder ...  .It Ic \&Ar Op Ar placeholder ...
 Command arguments.  Command arguments.
 If an argument is not provided, the string  If an argument is not provided, the string
Line 748  for fixed strings to be passed verbatim as arguments, 
Line 753  for fixed strings to be passed verbatim as arguments, 
 .Ic \&Fl  .Ic \&Fl
 or  or
 .Ic \&Cm .  .Ic \&Cm .
   .Tg At
 .It Ic \&At Op Ar version  .It Ic \&At Op Ar version
 Formats an  Formats an
 .At  .At
Line 785  Close a
Line 791  Close a
 .Ic \&Bo  .Ic \&Bo
 block.  block.
 Does not have any tail arguments.  Does not have any tail arguments.
   .Tg Bd
 .It Ic \&Bd Fl Ns Ar type Oo Fl offset Ar width Oc Op Fl compact  .It Ic \&Bd Fl Ns Ar type Oo Fl offset Ar width Oc Op Fl compact
 Begin a display block.  Begin a display block.
 Display blocks are used to select a different indentation and  Display blocks are used to select a different indentation and
Line 875  See also
Line 882  See also
 .Ic \&D1  .Ic \&D1
 and  and
 .Ic \&Dl .  .Ic \&Dl .
   .Tg Bf
 .It Ic \&Bf Fl emphasis | literal | symbolic | Cm \&Em | \&Li | \&Sy  .It Ic \&Bf Fl emphasis | literal | symbolic | Cm \&Em | \&Li | \&Sy
 Change the font mode for a scoped block of text.  Change the font mode for a scoped block of text.
 The  The
Line 901  See also
Line 909  See also
 .Ic \&Em ,  .Ic \&Em ,
 and  and
 .Ic \&Sy .  .Ic \&Sy .
   .Tg Bk
 .It Ic \&Bk Fl words  .It Ic \&Bk Fl words
 For each macro, keep its output together on the same output line,  For each macro, keep its output together on the same output line,
 until the end of the macro or the end of the input line is reached,  until the end of the macro or the end of the input line is reached,
Line 923  macro line:
Line 932  macro line:
 .Pp  .Pp
 Be careful in using over-long lines within a keep block!  Be careful in using over-long lines within a keep block!
 Doing so will clobber the right margin.  Doing so will clobber the right margin.
   .Tg Bl
 .It Xo  .It Xo
 .Ic \&Bl  .Ic \&Bl
 .Fl Ns Ar type  .Fl Ns Ar type
Line 1065  Examples:
Line 1075  Examples:
 .Pp  .Pp
 See also  See also
 .Ic \&Bq .  .Ic \&Bq .
   .Tg Bq
 .It Ic \&Bq Ar line  .It Ic \&Bq Ar line
 Encloses its arguments in square brackets.  Encloses its arguments in square brackets.
 .Pp  .Pp
Line 1098  Examples:
Line 1109  Examples:
 .Pp  .Pp
 See also  See also
 .Ic \&Brq .  .Ic \&Brq .
   .Tg Brq
 .It Ic \&Brq Ar line  .It Ic \&Brq Ar line
 Encloses its arguments in curly braces.  Encloses its arguments in curly braces.
 .Pp  .Pp
Line 1106  Examples:
Line 1118  Examples:
 .Pp  .Pp
 See also  See also
 .Ic \&Bro .  .Ic \&Bro .
   .Tg Bsx
 .It Ic \&Bsx Op Ar version  .It Ic \&Bsx Op Ar version
 Format the  Format the
 .Bsx  .Bsx
Line 1128  and
Line 1141  and
 Supported only for compatibility, do not use this in new manuals.  Supported only for compatibility, do not use this in new manuals.
 Prints  Prints
 .Dq is currently in beta test.  .Dq is currently in beta test.
   .Tg Bx
 .It Ic \&Bx Op Ar version Op Ar variant  .It Ic \&Bx Op Ar version Op Ar variant
 Format the  Format the
 .Bx  .Bx
Line 1147  See also
Line 1161  See also
 .Ic \&Nx ,  .Ic \&Nx ,
 and  and
 .Ic \&Ox .  .Ic \&Ox .
   .Tg Cd
 .It Ic \&Cd Ar line  .It Ic \&Cd Ar line
 Kernel configuration declaration.  Kernel configuration declaration.
 This denotes strings accepted by  This denotes strings accepted by
Line 1162  whitespace and align consecutive
Line 1177  whitespace and align consecutive
 .Ic \&Cd  .Ic \&Cd
 declarations.  declarations.
 This practise is discouraged.  This practise is discouraged.
   .Tg Cm
 .It Ic \&Cm Ar keyword ...  .It Ic \&Cm Ar keyword ...
 Command modifiers.  Command modifiers.
 Typically used for fixed strings passed as arguments to interactive  Typically used for fixed strings passed as arguments to interactive
Line 1177  Examples:
Line 1193  Examples:
 .Dl ".Ic set Fl o Cm vi"  .Dl ".Ic set Fl o Cm vi"
 .Dl ".Ic lookup Cm file bind"  .Dl ".Ic lookup Cm file bind"
 .Dl ".Ic permit Ar identity Op Cm as Ar target"  .Dl ".Ic permit Ar identity Op Cm as Ar target"
   .Tg D1
 .It Ic \&D1 Ar line  .It Ic \&D1 Ar line
 One-line indented display.  One-line indented display.
 This is formatted by the default rules and is useful for simple indented  This is formatted by the default rules and is useful for simple indented
Line 1202  Close a
Line 1219  Close a
 .Ic \&Do  .Ic \&Do
 block.  block.
 Does not have any tail arguments.  Does not have any tail arguments.
   .Tg Dd
 .It Ic \&Dd Cm $\&Mdocdate$ | Ar month day , year  .It Ic \&Dd Cm $\&Mdocdate$ | Ar month day , year
 Document date for display in the page footer,  Document date for display in the page footer,
 by convention the date of the last change.  by convention the date of the last change.
Line 1250  See also
Line 1268  See also
 .Ic \&Dt  .Ic \&Dt
 and  and
 .Ic \&Os .  .Ic \&Os .
   .Tg Dl
 .It Ic \&Dl Ar line  .It Ic \&Dl Ar line
 One-line indented display.  One-line indented display.
 This is formatted as literal text and is useful for commands and  This is formatted as literal text and is useful for commands and
Line 1278  April is the cruellest month
Line 1297  April is the cruellest month
 .Pp  .Pp
 See also  See also
 .Ic \&Dq .  .Ic \&Dq .
   .Tg Dq
 .It Ic \&Dq Ar line  .It Ic \&Dq Ar line
 Encloses its arguments in  Encloses its arguments in
 .Dq typographic  .Dq typographic
Line 1294  See also
Line 1314  See also
 .Ic \&Sq ,  .Ic \&Sq ,
 and  and
 .Ic \&Do .  .Ic \&Do .
   .Tg Dt
 .It Ic \&Dt Ar TITLE section Op Ar arch  .It Ic \&Dt Ar TITLE section Op Ar arch
 Document title for display in the page header.  Document title for display in the page header.
 This is the mandatory second macro of any  This is the mandatory second macro of any
Line 1353  See also
Line 1374  See also
 .Ic \&Dd  .Ic \&Dd
 and  and
 .Ic \&Os .  .Ic \&Os .
   .Tg Dv
 .It Ic \&Dv Ar identifier ...  .It Ic \&Dv Ar identifier ...
 Defined variables such as preprocessor constants, constant symbols,  Defined variables such as preprocessor constants, constant symbols,
 enumeration values, and so on.  enumeration values, and so on.
Line 1372  for variable symbols, and
Line 1394  for variable symbols, and
 .Ic \&Fd  .Ic \&Fd
 for listing preprocessor variable definitions in the  for listing preprocessor variable definitions in the
 .Em SYNOPSIS .  .Em SYNOPSIS .
   .Tg Dx
 .It Ic \&Dx Op Ar version  .It Ic \&Dx Op Ar version
 Format the  Format the
 .Dx  .Dx
Line 1413  End a list context started by
Line 1436  End a list context started by
 .Ic \&Bl .  .Ic \&Bl .
 See also  See also
 .Ic \&It .  .Ic \&It .
   .Tg Em
 .It Ic \&Em Ar word ...  .It Ic \&Em Ar word ...
 Request an italic font.  Request an italic font.
 If the output device does not provide that, underline.  If the output device does not provide that, underline.
Line 1452  or any of the other enclosure macros.
Line 1476  or any of the other enclosure macros.
 It encloses its argument in the delimiters specified by the last  It encloses its argument in the delimiters specified by the last
 .Ic \&Es  .Ic \&Es
 macro.  macro.
   .Tg Eo
 .It Ic \&Eo Op Ar opening_delimiter  .It Ic \&Eo Op Ar opening_delimiter
 An arbitrary enclosure.  An arbitrary enclosure.
 The  The
Line 1459  The
Line 1484  The
 argument is used as the enclosure head, for example, specifying \e(lq  argument is used as the enclosure head, for example, specifying \e(lq
 will emulate  will emulate
 .Ic \&Do .  .Ic \&Do .
   .Tg Er
 .It Ic \&Er Ar identifier ...  .It Ic \&Er Ar identifier ...
 Error constants for definitions of the  Error constants for definitions of the
 .Va errno  .Va errno
Line 1481  or any of the other enclosure macros.
Line 1507  or any of the other enclosure macros.
 It takes two arguments, defining the delimiters to be used by subsequent  It takes two arguments, defining the delimiters to be used by subsequent
 .Ic \&En  .Ic \&En
 macros.  macros.
   .Tg Ev
 .It Ic \&Ev Ar identifier ...  .It Ic \&Ev Ar identifier ...
 Environmental variables such as those specified in  Environmental variables such as those specified in
 .Xr environ 7 .  .Xr environ 7 .
Line 1492  Examples:
Line 1519  Examples:
 See also  See also
 .Ic \&Dv  .Ic \&Dv
 for general constants.  for general constants.
   .Tg Ex
 .It Ic \&Ex Fl std Op Ar utility ...  .It Ic \&Ex Fl std Op Ar utility ...
 Insert a standard sentence regarding command exit values of 0 on success  Insert a standard sentence regarding command exit values of 0 on success
 and >0 on failure.  and >0 on failure.
Line 1508  arguments are treated as separate utilities.
Line 1536  arguments are treated as separate utilities.
 .Pp  .Pp
 See also  See also
 .Ic \&Rv .  .Ic \&Rv .
   .Tg Fa
 .It Ic \&Fa Ar argument ...  .It Ic \&Fa Ar argument ...
 Function argument or parameter.  Function argument or parameter.
 Each argument may be a name and a type (recommended for the  Each argument may be a name and a type (recommended for the
Line 1545  See also
Line 1574  See also
 .It Ic \&Fc  .It Ic \&Fc
 End a function context started by  End a function context started by
 .Ic \&Fo .  .Ic \&Fo .
   .Tg Fd
 .It Ic \&Fd Pf # Ar directive Op Ar argument ...  .It Ic \&Fd Pf # Ar directive Op Ar argument ...
 Preprocessor directive, in particular for listing it in the  Preprocessor directive, in particular for listing it in the
 .Em SYNOPSIS .  .Em SYNOPSIS .
Line 1565  See also
Line 1595  See also
 .Ic \&In ,  .Ic \&In ,
 and  and
 .Ic \&Dv .  .Ic \&Dv .
   .Tg Fl
 .It Ic \&Fl Op Ar word ...  .It Ic \&Fl Op Ar word ...
 Command-line flag or option.  Command-line flag or option.
 Used when listing arguments to command-line utilities.  Used when listing arguments to command-line utilities.
Line 1590  for details.
Line 1621  for details.
 .Pp  .Pp
 See also  See also
 .Ic \&Cm .  .Ic \&Cm .
   .Tg Fn
 .It Ic \&Fn Ar funcname Op Ar argument ...  .It Ic \&Fn Ar funcname Op Ar argument ...
 A function name.  A function name.
 .Pp  .Pp
Line 1618  See also
Line 1650  See also
 .Ic \&Fo ,  .Ic \&Fo ,
 and  and
 .Ic \&Ft .  .Ic \&Ft .
   .Tg Fo
 .It Ic \&Fo Ar funcname  .It Ic \&Fo Ar funcname
 Begin a function block.  Begin a function block.
 This is a multi-line version of  This is a multi-line version of
Line 1652  This macro is obsolete.
Line 1685  This macro is obsolete.
 No replacement markup is needed.  No replacement markup is needed.
 .Pp  .Pp
 It was used to show numerical function return values in an italic font.  It was used to show numerical function return values in an italic font.
   .Tg Ft
 .It Ic \&Ft Ar functype  .It Ic \&Ft Ar functype
 A function type.  A function type.
 .Pp  .Pp
Line 1671  See also
Line 1705  See also
 .Ic \&Fn ,  .Ic \&Fn ,
 and  and
 .Ic \&Fo .  .Ic \&Fo .
   .Tg Fx
 .It Ic \&Fx Op Ar version  .It Ic \&Fx Op Ar version
 Format the  Format the
 .Fx  .Fx
Line 1693  and
Line 1728  and
 This macro is not implemented in  This macro is not implemented in
 .Xr mandoc 1 .  .Xr mandoc 1 .
 It was used to include the contents of a (header) file literally.  It was used to include the contents of a (header) file literally.
   .Tg Ic
 .It Ic \&Ic Ar keyword ...  .It Ic \&Ic Ar keyword ...
 Internal or interactive command, or configuration instruction  Internal or interactive command, or configuration instruction
 in a configuration file.  in a configuration file.
Line 1712  or
Line 1748  or
 is preferred for displaying code samples; the  is preferred for displaying code samples; the
 .Ic \&Ic  .Ic \&Ic
 macro is used when referring to an individual command name.  macro is used when referring to an individual command name.
   .Tg In
 .It Ic \&In Ar filename  .It Ic \&In Ar filename
 The name of an include file.  The name of an include file.
 This macro is most often used in section 2, 3, and 9 manual pages.  This macro is most often used in section 2, 3, and 9 manual pages.
Line 1731  Examples:
Line 1768  Examples:
 .Pp  .Pp
 See also  See also
 .Sx MANUAL STRUCTURE .  .Sx MANUAL STRUCTURE .
   .Tg It
 .It Ic \&It Op Ar head  .It Ic \&It Op Ar head
 A list item.  A list item.
 The syntax of this macro depends on the list type.  The syntax of this macro depends on the list type.
Line 1821  but not the whitespace before the semicolon.
Line 1859  but not the whitespace before the semicolon.
 .Pp  .Pp
 See also  See also
 .Ic \&Bl .  .Ic \&Bl .
   .Tg Lb
 .It Ic \&Lb Cm lib Ns Ar name  .It Ic \&Lb Cm lib Ns Ar name
 Specify a library.  Specify a library.
 .Pp  .Pp
Line 1841  section as described in
Line 1880  section as described in
 Examples:  Examples:
 .Dl \&.Lb libz  .Dl \&.Lb libz
 .Dl \&.Lb libmandoc  .Dl \&.Lb libmandoc
   .Tg Li
 .It Ic \&Li Ar word ...  .It Ic \&Li Ar word ...
 Request a typewriter (literal) font.  Request a typewriter (literal) font.
 Deprecated because on terminal output devices, this is usually  Deprecated because on terminal output devices, this is usually
Line 1851  For literal displays, use
Line 1891  For literal displays, use
 or  or
 .Ic \&Bd Fl literal Pq multi-line  .Ic \&Bd Fl literal Pq multi-line
 instead.  instead.
   .Tg Lk
 .It Ic \&Lk Ar uri Op Ar display_name  .It Ic \&Lk Ar uri Op Ar display_name
 Format a hyperlink.  Format a hyperlink.
 .Pp  .Pp
Line 1863  See also
Line 1904  See also
 .It Ic \&Lp  .It Ic \&Lp
 Deprecated synonym for  Deprecated synonym for
 .Ic \&Pp .  .Ic \&Pp .
   .Tg Ms
 .It Ic \&Ms Ar name  .It Ic \&Ms Ar name
 Display a mathematical symbol.  Display a mathematical symbol.
 .Pp  .Pp
 Examples:  Examples:
 .Dl \&.Ms sigma  .Dl \&.Ms sigma
 .Dl \&.Ms aleph  .Dl \&.Ms aleph
   .Tg Mt
 .It Ic \&Mt Ar localpart Ns @ Ns Ar domain  .It Ic \&Mt Ar localpart Ns @ Ns Ar domain
 Format a  Format a
 .Dq mailto:  .Dq mailto:
Line 1877  hyperlink.
Line 1920  hyperlink.
 Examples:  Examples:
 .Dl \&.Mt discuss@manpages.bsd.lv  .Dl \&.Mt discuss@manpages.bsd.lv
 .Dl \&.An Kristaps Dzonsons \&Aq \&Mt kristaps@bsd.lv  .Dl \&.An Kristaps Dzonsons \&Aq \&Mt kristaps@bsd.lv
   .Tg Nd
 .It Ic \&Nd Ar line  .It Ic \&Nd Ar line
 A one line description of the manual's content.  A one line description of the manual's content.
 This is the mandatory last macro of the  This is the mandatory last macro of the
Line 1899  arguments and will display macros verbatim.
Line 1943  arguments and will display macros verbatim.
 .Pp  .Pp
 See also  See also
 .Ic \&Nm .  .Ic \&Nm .
   .Tg Nm
 .It Ic \&Nm Op Ar name  .It Ic \&Nm Op Ar name
 The name of the manual page, or \(em in particular in section 1, 6,  The name of the manual page, or \(em in particular in section 1, 6,
 and 8 pages \(em of an additional command or feature documented in  and 8 pages \(em of an additional command or feature documented in
Line 1936  of section 2, 3 and 9 manual pages, use the
Line 1981  of section 2, 3 and 9 manual pages, use the
 macro rather than  macro rather than
 .Ic \&Nm  .Ic \&Nm
 to mark up the name of the manual page.  to mark up the name of the manual page.
   .Tg No
 .It Ic \&No Ar word ...  .It Ic \&No Ar word ...
 Normal text.  Normal text.
 Closes the scope of any preceding in-line macro.  Closes the scope of any preceding in-line macro.
Line 1960  See also
Line 2006  See also
 .Ic \&Ql ,  .Ic \&Ql ,
 and  and
 .Ic \&Sy .  .Ic \&Sy .
   .Tg Ns
 .It Ic \&Ns  .It Ic \&Ns
 Suppress a space between the output of the preceding macro  Suppress a space between the output of the preceding macro
 and the following text or macro.  and the following text or macro.
Line 1979  See also
Line 2026  See also
 .Ic \&No  .Ic \&No
 and  and
 .Ic \&Sm .  .Ic \&Sm .
   .Tg Nx
 .It Ic \&Nx Op Ar version  .It Ic \&Nx Op Ar version
 Format the  Format the
 .Nx  .Nx
Line 2011  Examples:
Line 2059  Examples:
 \&.Op Fl flag Ns Ar value  \&.Op Fl flag Ns Ar value
 \&.Oc  \&.Oc
 .Ed  .Ed
   .Tg Op
 .It Ic \&Op Ar line  .It Ic \&Op Ar line
 Optional part of a command line.  Optional part of a command line.
 Prints the argument(s) in brackets.  Prints the argument(s) in brackets.
Line 2024  Examples:
Line 2073  Examples:
 .Pp  .Pp
 See also  See also
 .Ic \&Oo .  .Ic \&Oo .
   .Tg Os
 .It Ic \&Os Op Ar system Op Ar version  .It Ic \&Os Op Ar system Op Ar version
 Operating system version for display in the page footer.  Operating system version for display in the page footer.
 This is the mandatory third macro of  This is the mandatory third macro of
Line 2066  Historical
Line 2116  Historical
 .Nm  .Nm
 packages described it as  packages described it as
 .Dq "old function type (FORTRAN)" .  .Dq "old function type (FORTRAN)" .
   .Tg Ox
 .It Ic \&Ox Op Ar version  .It Ic \&Ox Op Ar version
 Format the  Format the
 .Ox  .Ox
Line 2084  See also
Line 2135  See also
 .Ic \&Fx ,  .Ic \&Fx ,
 and  and
 .Ic \&Nx .  .Ic \&Nx .
   .Tg Pa
 .It Ic \&Pa Ar name ...  .It Ic \&Pa Ar name ...
 An absolute or relative file system path, or a file or directory name.  An absolute or relative file system path, or a file or directory name.
 If an argument is not provided, the character  If an argument is not provided, the character
Line 2099  See also
Line 2151  See also
 .It Ic \&Pc  .It Ic \&Pc
 Close parenthesised context opened by  Close parenthesised context opened by
 .Ic \&Po .  .Ic \&Po .
   .Tg Pf
 .It Ic \&Pf Ar prefix macro Op Ar argument ...  .It Ic \&Pf Ar prefix macro Op Ar argument ...
 Removes the space between its argument and the following macro.  Removes the space between its argument and the following macro.
 It is equivalent to:  It is equivalent to:
Line 2122  and
Line 2175  and
 .It Ic \&Po Ar block  .It Ic \&Po Ar block
 Multi-line version of  Multi-line version of
 .Ic \&Pq .  .Ic \&Pq .
   .Tg Pp
 .It Ic \&Pp  .It Ic \&Pp
 Break a paragraph.  Break a paragraph.
 This will assert vertical space between prior and subsequent macros  This will assert vertical space between prior and subsequent macros
Line 2138  or lists
Line 2192  or lists
 unless the  unless the
 .Fl compact  .Fl compact
 flag is given.  flag is given.
   .Tg Pq
 .It Ic \&Pq Ar line  .It Ic \&Pq Ar line
 Parenthesised enclosure.  Parenthesised enclosure.
 .Pp  .Pp
Line 2146  See also
Line 2201  See also
 .It Ic \&Qc  .It Ic \&Qc
 Close quoted context opened by  Close quoted context opened by
 .Ic \&Qo .  .Ic \&Qo .
   .Tg Ql
 .It Ic \&Ql Ar line  .It Ic \&Ql Ar line
 In-line literal display.  In-line literal display.
 This can be used for complete command invocations and for multi-word  This can be used for complete command invocations and for multi-word
Line 2159  and
Line 2215  and
 .It Ic \&Qo Ar block  .It Ic \&Qo Ar block
 Multi-line version of  Multi-line version of
 .Ic \&Qq .  .Ic \&Qq .
   .Tg Qq
 .It Ic \&Qq Ar line  .It Ic \&Qq Ar line
 Encloses its arguments in  Encloses its arguments in
 .Qq typewriter  .Qq typewriter
Line 2176  Close an
Line 2233  Close an
 .Ic \&Rs  .Ic \&Rs
 block.  block.
 Does not have any tail arguments.  Does not have any tail arguments.
   .Tg Rs
 .It Ic \&Rs  .It Ic \&Rs
 Begin a bibliographic  Begin a bibliographic
 .Pq Dq reference  .Pq Dq reference
Line 2216  If an
Line 2274  If an
 block is used within a SEE ALSO section, a vertical space is asserted  block is used within a SEE ALSO section, a vertical space is asserted
 before the rendered output, else the block continues on the current  before the rendered output, else the block continues on the current
 line.  line.
   .Tg Rv
 .It Ic \&Rv Fl std Op Ar function ...  .It Ic \&Rv Fl std Op Ar function ...
 Insert a standard sentence regarding a function call's return value of 0  Insert a standard sentence regarding a function call's return value of 0
 on success and \-1 on error, with the  on success and \-1 on error, with the
Line 2236  See also
Line 2295  See also
 .It Ic \&Sc  .It Ic \&Sc
 Close single-quoted context opened by  Close single-quoted context opened by
 .Ic \&So .  .Ic \&So .
   .Tg Sh
 .It Ic \&Sh Ar TITLE LINE  .It Ic \&Sh Ar TITLE LINE
 Begin a new section.  Begin a new section.
 For a list of conventional manual sections, see  For a list of conventional manual sections, see
Line 2254  See also
Line 2314  See also
 .Ic \&Ss ,  .Ic \&Ss ,
 and  and
 .Ic \&Sx .  .Ic \&Sx .
   .Tg Sm
 .It Ic \&Sm Op Cm on | off  .It Ic \&Sm Op Cm on | off
 Switches the spacing mode for output generated from macros.  Switches the spacing mode for output generated from macros.
 .Pp  .Pp
Line 2272  Using this is not recommended because it makes the cod
Line 2333  Using this is not recommended because it makes the cod
 .It Ic \&So Ar block  .It Ic \&So Ar block
 Multi-line version of  Multi-line version of
 .Ic \&Sq .  .Ic \&Sq .
   .Tg Sq
 .It Ic \&Sq Ar line  .It Ic \&Sq Ar line
 Encloses its arguments in  Encloses its arguments in
 .Sq typewriter  .Sq typewriter
Line 2282  See also
Line 2344  See also
 .Ic \&Qq ,  .Ic \&Qq ,
 and  and
 .Ic \&So .  .Ic \&So .
   .Tg Ss
 .It Ic \&Ss Ar Title line  .It Ic \&Ss Ar Title line
 Begin a new subsection.  Begin a new subsection.
 Unlike with  Unlike with
Line 2304  See also
Line 2367  See also
 .Ic \&Sh ,  .Ic \&Sh ,
 and  and
 .Ic \&Sx .  .Ic \&Sx .
   .Tg St
 .It Ic \&St Fl Ns Ar abbreviation  .It Ic \&St Fl Ns Ar abbreviation
 Replace an abbreviation for a standard with the full form.  Replace an abbreviation for a standard with the full form.
 The following standards are recognised.  The following standards are recognised.
Line 2514  Ethernet local area networks.
Line 2578  Ethernet local area networks.
 .St -ieee1275-94  .St -ieee1275-94
 .El  .El
 .El  .El
   .Tg Sx
 .It Ic \&Sx Ar Title line  .It Ic \&Sx Ar Title line
 Reference a section or subsection in the same manual page.  Reference a section or subsection in the same manual page.
 The referenced section or subsection name must be identical to the  The referenced section or subsection name must be identical to the
Line 2526  See also
Line 2591  See also
 .Ic \&Sh  .Ic \&Sh
 and  and
 .Ic \&Ss .  .Ic \&Ss .
   .Tg Sy
 .It Ic \&Sy Ar word ...  .It Ic \&Sy Ar word ...
 Request a boldface font.  Request a boldface font.
 .Pp  .Pp
Line 2551  See also
Line 2617  See also
 .Ic \&No ,  .Ic \&No ,
 and  and
 .Ic \&Ql .  .Ic \&Ql .
   .Tg Ta
 .It Ic \&Ta  .It Ic \&Ta
 Table cell separator in  Table cell separator in
 .Ic \&Bl Fl column  .Ic \&Bl Fl column
 lists; can only be used below  lists; can only be used below
 .Ic \&It .  .Ic \&It .
   .Tg Tg
 .It Ic \&Tg Op Ar term  .It Ic \&Tg Op Ar term
 Announce that the next input line starts a definition of the  Announce that the next input line starts a definition of the
 .Ar term .  .Ar term .
Line 2613  Prints out
Line 2681  Prints out
 Supported only for compatibility, do not use this in new manuals.  Supported only for compatibility, do not use this in new manuals.
 Prints out  Prints out
 .Dq Ux .  .Dq Ux .
   .Tg Va
 .It Ic \&Va Oo Ar type Oc Ar identifier ...  .It Ic \&Va Oo Ar type Oc Ar identifier ...
 A variable name.  A variable name.
 .Pp  .Pp
Line 2627  For declarations of global variables in the
Line 2696  For declarations of global variables in the
 .Em SYNOPSIS  .Em SYNOPSIS
 section, use  section, use
 .Ic \&Vt .  .Ic \&Vt .
   .Tg Vt
 .It Ic \&Vt Ar type Op Ar identifier  .It Ic \&Vt Ar type Op Ar identifier
 A variable type.  A variable type.
 .Pp  .Pp
Line 2670  beyond the end of the input line.
Line 2740  beyond the end of the input line.
 This macro originally existed to work around the 9-argument limit  This macro originally existed to work around the 9-argument limit
 of historic  of historic
 .Xr roff 7 .  .Xr roff 7 .
   .Tg Xr
 .It Ic \&Xr Ar name section  .It Ic \&Xr Ar name section
 Link to another manual  Link to another manual
 .Pq Qq cross-reference .  .Pq Qq cross-reference .

Legend:
Removed from v.1.286  
changed lines
  Added in v.1.287

CVSweb