\n| <\/td>\n | \n groff \u2212man<\/b><\/p>\n<\/td>\n | <\/td>\n | \n [option<\/i> …] [input-file<\/i> …]<\/p>\n\n\ngroff \u2212m<\/b><\/p>\n<\/table>\n man<\/b> [option<\/i> …] [input-file<\/i> …]<\/p>\n\n\n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n<\/table>\n ![\"Image](\"grohtml-912451.png\") <\/p>\n
Macros whose use we discourage (.AT<\/b>, .BT<\/b>, .DT<\/b>, .HP<\/b>, .PD<\/b>, .PT<\/b>, and .UC<\/b>) are described in subsection \u201cDeprecated features\u201d, below.<\/p>\n Macro reference preliminaries<\/b>
Each macro is described in a tagged paragraph. Closely related macros, such as .EX<\/b> and .EE<\/b>, are grouped together.<\/p>\n Optional macro arguments are indicated by surrounding them with square brackets. If a macro accepts multiple arguments, arguments containing whitespace must be double-quoted (“one two”), to be interpreted correctly. Most macro arguments are strings that will be output as text; exceptions are noted.<\/p>\n Bear in mind that groff<\/i> is fundamentally a programming system for typesetting. Consequently, the verb \u201cto set\u201d is frequently used below in the sense \u201cto typeset\u201d.<\/p>\n Document structure macros<\/b>
The highest level of organization of a man page is determined by this group of macros. .TH<\/b> (title heading) identifies the document as a man page and defines information enabling its indexing by mandb<\/i>(8) or a similar tool. Sections (.SH<\/b>), one of which is mandatory and many of which are standardized, facilitate quick location of relevant material by the reader and aid the man page writer to discuss all essential aspects of the topic. Subsections (.SS<\/b>) are optional and permit sections that grow long to develop in a controlled way. Many technical discussions require examples; lengthy ones, especially those reflecting multiple lines of input to or output from the system, are usefully bracketed by .EX<\/b> and .EE<\/b>. When none of the foregoing meets a structural demand, a section of the discussion can be manually indented within .RS<\/b> and .RE<\/b> macros.
.TH<\/b> title section<\/i> [footer-middle<\/i>] [footer-outside<\/i>] [header-middle<\/i>]<\/p>\n Define the title of the man page as title<\/i> and the section as section<\/i>. See man<\/i>(1) for details on the section numbers and suffixes applicable to your system. title<\/i> and section<\/i> are positioned together at the left and right in the header line (with section<\/i> in parentheses immediately appended to title<\/i>). footer-middle<\/i> is centered in the footer line. footer-outside<\/i> is positioned at the left in the footer line (or at the left on even pages and at the right on odd pages if double-sided printing is active). header-middle<\/i> is centered in the header line. If section<\/i> is a simple integer between 1 and\u00a09 (inclusive), or is exactly \u201c3p\u201d, there is no need to specify header-middle<\/i>; the macro package will supply text for it.<\/p>\n For HTML output, headers and footers are completely suppressed.<\/p>\n Additionally, this macro starts a new page; the page number is reset to\u00a01 (unless the \u2212rC1<\/b> option is given on the command line). This feature is intended only for formatting multiple man pages.<\/p>\n A man page should contain exactly one .TH<\/b> call at or near the beginning of the file, prior to any other macro calls.<\/p>\n By convention, footer-middle<\/i> is the most recent modification date of the man page source document, and footer-outside<\/i> is the name and version or release of the project providing it.<\/p>\n .SH<\/b> [heading-text<\/i>]<\/p>\n Set heading-text<\/i> as a section heading flush left. The text following .SH<\/b> up to the end of the line, or the text on the next input line if .SH<\/b> is given no arguments, is set in bold (or the font specified by the string register HF<\/b>) slightly larger than the base font size. Additionally, the left margin and indentation affecting subsequent text are reset to their default values. Text on input lines after heading-text<\/i> is set as a normal paragraph (.PP<\/b>).<\/p>\n The content of heading-text<\/i> and ordering of sections has been standardized by common practice, as has much of the layout of material within sections. For example, a section called \u201cName\u201d or \u201cNAME\u201d must exist, must be the first section after the .TH<\/b> call, and must contain only a line of the form<\/p>\n page-topic<\/i>[,<\/b> …] \u2212\u00a0<\/b>summary-description<\/i><\/p>\n for a man page to be properly indexed. See man<\/i>(7) for the conventions prevailing on your system.<\/p>\n .SS<\/b> [subheading-text<\/i>]<\/p>\n Set subheading-text<\/i> as a subsection heading indented (by default) partway between a section heading and a normally-indented paragraph (.PP<\/b>). The text following .SS<\/b> up to the end of the line, or the text on the next input line if .SS<\/b> is given no arguments, is set in bold (or the font specified by the string register HF<\/b>) at the base font size. Additionally, the left margin and indentation affecting subsequent text are reset to their default values. Text on input lines after subheading-text<\/i> is set as a normal paragraph (.PP<\/b>).<\/p>\n\n\n| <\/td>\n | \n .EX<\/b><\/p>\n<\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | \n .EE<\/b><\/p>\n<\/td>\n | <\/td>\n | \n Begin and end example. After .EX<\/b>, filling and hyphenation are disabled and a constant-width (monospaced) font is selected. Calling .EE<\/b> enables filling and restores the previous hyphenation setting and font.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n Example regions are useful for formatting code, shell sessions, and text file contents.<\/p>\n These macros are defined on many (but not all) legacy Unix systems running classic troff<\/i>. To be certain your page will be portable to those systems, copy their definitions from the an\u2212ext.tmac<\/i> file of a groff<\/i> installation.<\/p>\n .RS<\/b> [indent<\/i>]<\/p>\n Move the left margin to the right by the value indent<\/i>, if specified, and by a default amount otherwise; see subsection \u201cHorizontal and vertical spacing\u201d below. Calls to .RS<\/b> can be nested; each call increments by\u00a01 the indentation level used by .RE<\/b>. The indentation level prior to any .RS<\/b> calls is\u00a01.<\/p>\n .RE<\/b> [level<\/i>]<\/p>\n Move the left margin back to that corresponding to indentation level level<\/i>. If no argument is given, move the left margin one level back.<\/p>\n Paragraph macros<\/b>
A typical paragraph (.PP<\/b>) is set at the current left margin, which by default is indented from the left margin of the output device. In man pages and other technical literature, definition lists are frequently encountered; these can be set as \u201ctagged paragraphs\u201d (.TP<\/b> and .TQ<\/b>), which have one or more leading tags followed by a paragraph that has an additional left indent. The indented paragraph (.IP<\/b>) macro is useful to continue the indented content of a narrative started with .TP<\/b>, or to present an itemized or ordered list.<\/p>\n\n\n| <\/td>\n | \n .LP<\/b><\/p>\n<\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | \n .PP<\/b><\/p>\n<\/td>\n | <\/td>\n | <\/td>\n<\/tr>\n | \n| <\/td>\n | \n .P<\/b><\/p>\n<\/td>\n | <\/td>\n | \n Begin a new paragraph; these macros are synonymous. They break the output line at the current position, followed by a vertical space downward by a default amount (which can be changed by the deprecated .PD<\/b> macro). The font size and style are reset to defaults; see subsection \u201cFont style macros\u201d below. Finally, the left margin and indentation are reset to default values.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n .TP<\/b> [indent<\/i>]<\/p>\n Set a tagged, indented paragraph. The input line following this macro, known as the tag<\/i>, is printed at the current left margin. Subsequent text is indented by indent<\/i>, if specified, and by a default amount otherwise; see subsection \u201cHorizontal and vertical spacing\u201d below.<\/p>\n If the tag is not as wide as the indentation, the paragraph starts on the same line as the tag, at the applicable indentation, and continues on the following lines. Otherwise, the descriptive part of the paragraph begins on the line following the tag, entirely indented. The line containing the tag can include a macro call, for instance to set the tag in bold with .B<\/b>.<\/p>\n .TP<\/b> was used to write the first paragraph of this description of .TP<\/b>, and .IP<\/b> the subsequent ones.<\/p>\n\n\n| <\/td>\n | \n .TQ<\/b><\/p>\n<\/td>\n | <\/td>\n | \n Set an additional tag for a paragraph tagged with .TP<\/b>. The pending output line is broken. The tag on the input line following this macro and subsequent lines are handled as with .TP<\/b>.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n This macro is not defined on legacy Unix systems running classic troff<\/i>. To be certain your page will be portable to those systems, copy its definition from the an\u2212ext.tmac<\/i> file of a groff<\/i> installation.<\/p>\n The descriptions of .LP<\/b>, .PP<\/b>, and .P<\/b> above were written using .TP<\/b> and .TQ<\/b>.<\/p>\n .IP<\/b> [tag<\/i>] [indent<\/i>]<\/p>\n Set an indented paragraph with an optional tag. The tag<\/i> and indent<\/i> arguments, if present, are handled as with .TP<\/b>, with the exception that the tag<\/i> argument to .IP<\/b> cannot include a macro call.<\/p>\n Two convenient use cases for .IP<\/b> are<\/p>\n\n\n| <\/td>\n | \n (1)<\/p>\n<\/td>\n | <\/td>\n | \n to start a new paragraph with the same indentation as the previous .IP<\/b> or .TP<\/b> paragraph, if no indent<\/i> argument is given; and<\/p>\n<\/td>\n<\/tr>\n\n| <\/td>\n | \n (2)<\/p>\n<\/td>\n | <\/td>\n | \n to set a paragraph with a short tag<\/i> that is not semantically important, such as a bullet (\u2022)\u2014obtained with the \u2018(bu\u2019 character escape\u2014or list enumerator, as seen in this very paragraph.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n Command synopsis macros<\/b>
Command synopses are a staple of section\u00a01 and\u00a08 man pages. These macros aid you to construct one that has the classical Unix appearance. Furthermore, some tools are able to interpret these macros semantically and treat them appropriately for localization and\/or presentation. A command synopsis is wrapped in .SY<\/b>\/.YS<\/b> calls, with command-line options of some formats indicated by .OP<\/b>.<\/p>\n These macros are not defined on legacy Unix systems running classic troff<\/i>. To be certain your page will be portable to those systems, copy their definitions from the an\u2212ext.tmac<\/i> file of a groff<\/i> installation.
.SY<\/b> command<\/i><\/p>\n Begin synopsis. Hyphenation is turned off. The command<\/i> argument is set in bold. The output line is filled as normal, but if a break is required, subsequent output lines are indented by the width of command<\/i> plus a space.<\/p>\n .OP<\/b> option-name<\/i> [option-argument<\/i>]<\/p>\n Indicate an optional command parameter called option-name<\/i>, which is set in bold. If the option takes an argument, specify option-argument<\/i> using a noun, abbreviation, or hyphenated noun phrase. If present, option-argument<\/i> is preceded by a space and set in italics. Square brackets (in roman) surround both arguments.<\/p>\n\n\n| <\/td>\n | \n .YS<\/b><\/p>\n<\/td>\n | <\/td>\n | \n End synopsis. Restore indentation and hyphenation to previous values.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n Multiple .SY\/.YS<\/b> blocks can be specified, for instance to distinguish differing modes of operation of a complex command like tar<\/i>(1); each will be separated by a paragraph space.<\/p>\n .SY<\/b> can also be repeated multiple times before a closing .YS<\/b>, which is useful to indicate synonymous ways of invoking a particular mode of operation.<\/p>\n For example,<\/p>\n .SY groff
.OP \u2212abcegiklpstzCEGNRSUVXZ
.OP \u2212d cs
.OP \u2212f fam
.OP \u2212F dir
.OP \u2212I dir
.OP \u2212K arg
.OP \u2212L arg
.OP \u2212m name
.OP \u2212M dir
.OP \u2212n num
.OP \u2212o list
.OP \u2212P arg
.OP \u2212r cn
.OP \u2212T dev
.OP \u2212w name
.OP \u2212W name
.RI [ file
&.|.|.&]
.YS
.
.SY groff
.B \u2212h
.SY groff
.B \u2212\u2212help
.YS<\/p>\n produces the following output.<\/p>\n \n\n| <\/td>\n | \n groff<\/b><\/p>\n<\/td>\n | <\/td>\n | \n [\u2212abcegiklpstzCEGNRSUVXZ<\/b>] [\u2212d\u00a0<\/b>cs<\/i>] [\u2212f\u00a0<\/b>fam<\/i>] [\u2212F\u00a0<\/b>dir<\/i>] [\u2212I\u00a0<\/b>dir<\/i>] [\u2212K\u00a0<\/b>arg<\/i>] [\u2212L\u00a0<\/b>arg<\/i>] [\u2212m\u00a0<\/b>name<\/i>] [\u2212M\u00a0<\/b>dir<\/i>] [\u2212n\u00a0<\/b>num<\/i>] [\u2212o\u00a0<\/b>list<\/i>] [\u2212P\u00a0<\/b>arg<\/i>] [\u2212r\u00a0<\/b>cn<\/i>] [\u2212T\u00a0<\/b>dev<\/i>] [\u2212w\u00a0<\/b>name<\/i>] [\u2212W\u00a0<\/b>name<\/i>] [file<\/i> …]<\/p>\n<\/td>\n<\/tr>\n\n| <\/td>\n | \n groff<\/b><\/p>\n<\/td>\n | <\/td>\n | \n \u2212h<\/b><\/p>\n<\/td>\n<\/tr>\n\n| <\/td>\n | \n groff<\/b><\/p>\n<\/td>\n | <\/td>\n | \n \u2212\u2212help<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n Several features of the above example are of note.<\/p>\n \n\n| <\/td>\n | \n \u2022<\/p>\n<\/td>\n | <\/td>\n | \n The empty request (.), which does nothing, is used for vertical spacing in the input file for readability by the document maintainer. Do not put empty lines in a roff<\/i> source document.<\/p>\n<\/td>\n<\/tr>\n\n| <\/td>\n | \n \u2022<\/p>\n<\/td>\n | <\/td>\n | \n The command and option names are presented in bold<\/b> to cue the user that they should be input literally.<\/p>\n<\/td>\n<\/tr>\n\n| <\/td>\n | \n \u2022<\/p>\n<\/td>\n | <\/td>\n | \n Option dashes are specified with the \u2018\u2212\u2019 escape sequence; this is an important practice to make them clearly visible and to facilitate cut-and-paste from the rendered man page to a shell prompt or text file.<\/p>\n<\/td>\n<\/tr>\n | \n| <\/td>\n | \n \u2022<\/p>\n<\/td>\n | <\/td>\n | \n Option arguments and command operands are presented in italics<\/i> (underlined on some output devices, such as terminals and emulators), to cue the user that they must be replaced with appropriate text.<\/p>\n<\/td>\n<\/tr>\n\n| <\/td>\n | \n \u2022<\/p>\n<\/td>\n | <\/td>\n | \n Symbols that are neither to be typed literally nor simply replaced appear in the roman style; brackets surround optional arguments, and an ellipsis indicates that the previous syntactical element may be repeated arbitrarily.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n Some man pages use a brace-and-pipe notation such as \u201c{\u2212\u2212diff<\/b>|\u2212\u2212compare<\/b>}\u201d to indicate that one and only one of the \u2018|\u2019-separated items within the braces must be input. If this braced construct is furthermore surrounded by square brackets, it means that at most one of the items is accepted.<\/p>\n Authors of man pages should note the use of the zero-width space escape sequence \u2018&\u2019 on both sides of the ellipsis; this is a good practice to avoid surprises in the event the ellipsis gets refilled in your text editor. See \u201cPortability\u201d, below. The morbidly curious may consult groff<\/i>(7) regarding the narrow-space escape sequence \u2018|\u2019.<\/p>\n Hyperlink and email macros<\/b>
Email addresses are bracketed with .MT<\/b>\/.ME<\/b> and URL hyperlinks with .UR<\/b>\/.UE<\/b>.<\/p>\n These macros are not defined on legacy Unix systems running classic troff<\/i>. To be certain your page will be portable to those systems, copy their definitions from the an\u2212ext.tmac<\/i> file of a groff<\/i> installation.
.MT<\/b> address<\/i>
.ME<\/b> [punctuation<\/i>]<\/p>\n Identify address<\/i> as an RFC 6068 addr-spec<\/i> for a \u201cmailto:\u201d URI with the text between the two macro calls as the link text. A punctuation<\/i> argument to .ME<\/b> is placed at the end of the link text without intervening space. Note that address<\/i> may not be visible in the output text, particularly if the man page is being viewed as HTML. On a device that is not a browser, address<\/i> is set in angle brackets after the link text and before punctuation<\/i>.<\/p>\n When rendered by groff<\/i> to a TTY or PostScript output device,<\/p>\n Contact
.MT fred.foonly@:fubar.net
Fred Foonly
.ME
for more information.<\/p>\n displays as: \u201cContact Fred Foonly \u2329 fred.foonly@fubar.net\u232a for more information.\u201d.<\/p>\n The use of \u2018:\u2019 to insert hyphenless discretionary breaks is a groff<\/i> extension and can be omitted.<\/p>\n .UR<\/b> URL<\/i>
.UE<\/b> [punctuation<\/i>]<\/p>\n Identify URL<\/i> as an RFC 3986 URI hyperlink with the text between the two macro calls as the link text. A punctuation<\/i> argument to .UE<\/b> is placed at the end of the link text without intervening space. Note that URL<\/i> may not be visible in the output text, particularly if the man page is being viewed as HTML. On a device that is not a browser, URL<\/i> is set in angle brackets after the link text and before punctuation<\/i>.<\/p>\n When rendered by groff<\/i> to a TTY or PostScript output device,<\/p>\n The GNU Project of the Free Software Foundation hosts the
.UR https:\/\/:www.gnu.org\/:software\/:groff\/
Groff home page
.UE .<\/p>\n displays as: \u201cThe GNU Project of the Free Software Foundation hosts the Groff home page \u2329 https:\/\/www.gnu.org\/software\/ groff\/\u232a .\u201d.<\/p>\n The use of \u2018:\u2019 to insert hyphenless discretionary breaks is a groff<\/i> extension and can be omitted.<\/p>\n Font style macros<\/b>
The man<\/i> macro package is limited in its font styling options, offering only bold\u00a0<\/b>(.B<\/b>), italic\u00a0<\/i>(.I<\/b>), and roman (the default). Italic text is usually set underscored instead on terminals and other classical nroff<\/i>-style output devices. The .SM<\/b> and .SB<\/b> macros set text in roman or bold, respectively, at a smaller point size; these differ visually from regular-sized roman or bold text only on troff<\/i>-style output devices. The foregoing macros cause word breaks before and after their arguments, but it is often necessary to set text in different styles without intervening whitespace. The macros .BI<\/b>, .BR<\/b>, .IB<\/b>, .IR<\/b>, .RB<\/b>, and .RI<\/b>, where \u2018B\u2019, \u2018I\u2019, and \u2018R\u2019 indicate bold, italic, and roman, respectively, set their odd- and even-numbered arguments in alternating styles, with no whitespace separating them.<\/p>\n Because font styles are presentational rather than semantic, conflicting traditions have arisen regarding which font styles should be used to mark file or path names, environment variables, in-line literals, and even man page cross-references.<\/p>\n The default font size and family (for troff<\/i> output devices) is 10-point Times. The default style is roman.
.B\u00a0<\/b>[text<\/i>]<\/p>\n Set text<\/i> in bold. If the macro is given no arguments, the text of the next input line is set in bold.<\/p>\n Use bold for literal portions of syntax synopses, for command-line options in running text, and for literals that are major topics of the subject under discussion; for example, this page uses bold for macro and register names. In .EX<\/b>\/.EE<\/b> examples of interactive I\/O (such as a shell session), set only the user-typed input in bold.<\/p>\n .I\u00a0<\/b>[text<\/i>]<\/p>\n Set text<\/i> in italics. If the macro is given no arguments, the text of the next input line is set in italics.<\/p>\n Use italics for file and path names, for environment variables, for enumeration or preprocessor constants in C, for variable (user-determined) portions of syntax synopses, for the first occurrence only of a technical concept being introduced, for names of works of software (including commands and functions, but excluding names of operating systems or their kernels), and anywhere a parameter requiring replacement by the user is encountered. An exception involves variable text in a context that is already marked up in italics, such as file or path names with variable components; in such cases, follow the convention of mathematical typography: set the file or path name in italics as usual (see .IR<\/b> below), but use roman for the variable part, and italics again in running roman text when referring to the variable material.<\/p>\n .SM\u00a0<\/b>[text<\/i>]<\/p>\n Set text<\/i> one point size smaller than the default size. If the macro is given no arguments, the text of the next input line is set smaller.<\/p>\n Note<\/i>: nroff<\/i>-style output devices, such as terminals, will render text<\/i> at the normal font size instead. Do not rely upon .SM<\/b> to communicate semantic information distinct from using roman style at the normal size; it will be hidden from readers using such devices.<\/p>\n .SB\u00a0<\/b>[text<\/i>]<\/p>\n Set text<\/i> in bold, one point size smaller than the default size. If the macro is given no arguments, the text of the next input line is set smaller and in bold.<\/p>\n Note<\/i>: nroff<\/i>-style output devices, such as terminals, will render text<\/i> in bold at the normal font size instead. Do not rely upon .SB<\/b> to communicate semantic information distinct from using bold style at the normal size; it will be hidden from readers using such devices.<\/p>\n Note what is not<\/i> prescribed for setting in bold or italics above: elements of \u201csynopsis language\u201d such as ellipses and brackets around options; proper names and adjectives; titles of anything other than works of literature or software; identifiers for standards documents or technical reports such as CSTR\u00a0#54, RFC\u00a01918, Unicode\u00a011.0, or POSIX.1-2017; acronyms; and occurrences after the first of a technical term or piece of jargon. Again, the names of operating systems and their kernels are, by practically universal convention, set in roman.<\/p>\n Be frugal with the use of italics for emphasis, and particularly with the use of bold. Brief runs of literal text, such as references to individual characters or short strings, including section and subsection headings of man pages, are suitable objects for quotation; see the \u2018(lq\u2019, \u2018(rq\u2019, \u2018(oq\u2019, and \u2018(cq\u2019 escapes in subsection \u201cPortability\u201d below.<\/p>\n Unlike the above font style macros, the font alternation macros below accept only arguments on the same line as the macro call. If whitespace is required within one of the arguments, first consider whether the same result could be achieved with as much clarity by using the single-style macros on separate input lines. When it cannot, double-quote an argument with one or more embedded space characters. Setting all three different styles within one whitespace-delimited word presents challenges; it is possible with the \u2018c\u2019 and\/or \u2018f\u2019 escapes, but see subsection \u201cPortability\u201d below for caveats.
.BI<\/b> bold-text italic-text\u00a0<\/i>…<\/p>\n Set each argument in bold and italics, alternately.<\/p>\n .BI \u2212r name = n<\/p>\n .BR<\/b> bold-text roman-text\u00a0<\/i>…<\/p>\n Set each argument in bold and roman, alternately.<\/p>\n Any such change becomes effective with the first use of
.BR .NH ,
.I after
the new alias is defined.<\/p>\n .IB<\/b> italic-text bold-text\u00a0<\/i>…<\/p>\n Set each argument in italics and bold, alternately.<\/p>\n All macro package files must be named
.IB name .tmac
to fully use the
.I tmac
mechanism.<\/p>\n .IR<\/b> italic-text roman-text\u00a0<\/i>…<\/p>\n Set each argument in italics and roman, alternately.<\/p>\n This is the first command of the
.IR prologue .<\/p>\n .RB<\/b> roman-text bold-text\u00a0<\/i>…<\/p>\n Set each argument in roman and bold, alternately.<\/p>\n Also, the statement
.RB (oq “delim on” (cq
is not handled specially.<\/p>\n .RI<\/b> roman-text italic-text\u00a0<\/i>…<\/p>\n Set each argument in roman and italics, alternately.<\/p>\n .RI [ file
&.|.|.&]<\/p>\n Horizontal and vertical spacing<\/b>
The indent<\/i> argument accepted by .RS<\/b>, .IP<\/b>, .TP<\/b>, and the deprecated .HP<\/b> is a number plus an optional scaling indicator. If no scaling indicator is given, the man<\/i> package assumes \u2018n\u2019; that is, the width of a letter \u201cn\u201d in the font current when the macro is called. See section \u201cNumerical Expressions\u201d in groff<\/i>(7) for further details. An indent specified in a call to .IP<\/b>, .TP<\/b>, or the deprecated .HP<\/b> persists until (1) another of these macros is called with an explicit indent argument, or (2) .SH<\/b>, .SS<\/b>, or .PP<\/b> or its synonyms is called; these clear the indent entirely.<\/p>\n Indents set by .RS<\/b> move the left margin and persist until .RS<\/b>, .RE<\/b>, .SH<\/b>, or .SS<\/b> is called. The default indentation, exhibited by ordinary .PP<\/b> paragraphs not within an .RS<\/b>\/.RE<\/b> relative indent, is 7.2n in troff<\/i> mode and 7n in nroff<\/i> mode. The HTML output device is an exception; it ignores indentation completely. This same indentation is used again (additively) for the defaults of .IP<\/b>, .TP<\/b>, .RS<\/b>, and the deprecated .HP<\/b>. Section headings (.SH<\/b>) are set flush with the left margin of the output device, and subsection headings (.SS<\/b>) are indented 3n.<\/p>\n Resist the temptation to mock up tabular or multi-column output with ASCII tab characters or the indentation arguments to .IP<\/b>, .TP<\/b>, .RS<\/b>, or the deprecated .HP<\/b>; the result may not render comprehensibly on an output device you fail to check, or which is developed in the future. The table preprocessor tbl<\/i>(1) can likely meet your needs.<\/p>\n The following macros cause a line break with the insertion of vertical space: .SH<\/b>, .SS<\/b>, .TP<\/b>, .TQ<\/b>, .PP<\/b> (and its synonyms), .IP<\/b>, and the deprecated .HP<\/b>. The default inter-section and inter-paragraph spacing is 1\u00a0line in nroff<\/i> mode, and 0.4v in troff<\/i> mode. (The deprecated macro .PD<\/b> can change this vertical spacing, but its use is discouraged.) The macros .RS<\/b>, .RE<\/b>, .EX<\/b>, and .EE<\/b> also cause a break but no insertion of vertical space.<\/p>\n Number registers<\/b>
Number registers are described in section \u201cOptions\u201d below.<\/p>\n String registers<\/b>
The following strings are defined.<\/p>\n | | | | | | | | | | | | | | |