version 1.91, 2010/12/06 15:31:19 |
version 1.96, 2011/01/24 23:17:19 |
Line 59 line termination. |
|
Line 59 line termination. |
|
.Pp |
.Pp |
Blank lines are acceptable; where found, the output will assert a |
Blank lines are acceptable; where found, the output will assert a |
vertical space. |
vertical space. |
|
.Pp |
|
If the first character of a line is a space, that line is printed |
|
with a leading newline. |
.Ss Comments |
.Ss Comments |
Text following a |
Text following a |
.Sq \e\*q , |
.Sq \e\*q , |
Line 370 Thus, the following are equivalent: |
|
Line 373 Thus, the following are equivalent: |
|
\&.\ \ \ PP |
\&.\ \ \ PP |
.Ed |
.Ed |
.Pp |
.Pp |
|
To include space characters in macro arguments, arguments may be quoted; |
|
see the |
|
.Sq MACRO SYNTAX |
|
section in the |
|
.Xr roff 7 |
|
manual for details. |
|
.Pp |
The |
The |
.Nm |
.Nm |
macros are classified by scope: line scope or block scope. |
macros are classified by scope: line scope or block scope. |
Line 424 The syntax is as follows: |
|
Line 434 The syntax is as follows: |
|
.It Sx \&br Ta 0 Ta current Ta compat |
.It Sx \&br Ta 0 Ta current Ta compat |
.It Sx \&fi Ta 0 Ta current Ta compat |
.It Sx \&fi Ta 0 Ta current Ta compat |
.It Sx \&ft Ta 1 Ta current Ta compat |
.It Sx \&ft Ta 1 Ta current Ta compat |
.It Sx \&i Ta n Ta current Ta compat |
|
.It Sx \&in Ta 1 Ta current Ta compat |
.It Sx \&in Ta 1 Ta current Ta compat |
.It Sx \&na Ta 0 Ta current Ta compat |
.It Sx \&na Ta 0 Ta current Ta compat |
.It Sx \&nf Ta 0 Ta current Ta compat |
.It Sx \&nf Ta 0 Ta current Ta compat |
.It Sx \&r Ta 0 Ta current Ta compat |
|
.It Sx \&sp Ta 1 Ta current Ta compat |
.It Sx \&sp Ta 1 Ta current Ta compat |
.El |
.El |
.Pp |
.Pp |
Line 509 The optional arguments specify which release it is fro |
|
Line 517 The optional arguments specify which release it is fro |
|
Text is rendered in bold face. |
Text is rendered in bold face. |
.Pp |
.Pp |
See also |
See also |
.Sx \&I , |
.Sx \&I |
.Sx \&R , |
|
.Sx \&b , |
|
.Sx \&i , |
|
and |
and |
.Sx \&r . |
.Sx \&R . |
.Ss \&BI |
.Ss \&BI |
Text is rendered alternately in bold face and italic. |
Text is rendered alternately in bold face and italic. |
Thus, |
Thus, |
Line 532 Whitespace between arguments is omitted in output. |
|
Line 537 Whitespace between arguments is omitted in output. |
|
.Pp |
.Pp |
Examples: |
Examples: |
.Pp |
.Pp |
.D1 \&.BI bold italic bold italic |
.Dl \&.BI bold italic bold italic |
.Pp |
.Pp |
The output of this example will be emboldened |
The output of this example will be emboldened |
.Dq bold |
.Dq bold |
|
|
Text is rendered in italics. |
Text is rendered in italics. |
.Pp |
.Pp |
See also |
See also |
.Sx \&B , |
.Sx \&B |
.Sx \&R , |
|
.Sx \&b , |
|
.Sx \&i , |
|
and |
and |
.Sx \&r . |
.Sx \&R . |
.Ss \&IB |
.Ss \&IB |
Text is rendered alternately in italics and bold face. |
Text is rendered alternately in italics and bold face. |
Whitespace between arguments is omitted in output. |
Whitespace between arguments is omitted in output. |
|
|
Text is rendered in roman (the default font). |
Text is rendered in roman (the default font). |
.Pp |
.Pp |
See also |
See also |
.Sx \&I , |
.Sx \&I |
.Sx \&B , |
|
.Sx \&b , |
|
.Sx \&i , |
|
and |
and |
.Sx \&r . |
.Sx \&B . |
.Ss \&RB |
.Ss \&RB |
Text is rendered alternately in roman (the default font) and bold face. |
Text is rendered alternately in roman (the default font) and bold face. |
Whitespace between arguments is omitted in output. |
Whitespace between arguments is omitted in output. |
|
|
.Pp |
.Pp |
Examples: |
Examples: |
.Pp |
.Pp |
.D1 \&.TH CVS 5 "1992-02-12" GNU |
.Dl \&.TH CVS 5 "1992-02-12" GNU |
.Ss \&TP |
.Ss \&TP |
Begin a paragraph where the head, if exceeding the indentation width, is |
Begin a paragraph where the head, if exceeding the indentation width, is |
followed by a newline; if not, the body follows on the same line after a |
followed by a newline; if not, the body follows on the same line after a |
Line 836 Change the current font mode. |
|
Line 835 Change the current font mode. |
|
See |
See |
.Sx Text Decoration |
.Sx Text Decoration |
for a listing of available font modes. |
for a listing of available font modes. |
.Ss \&i |
|
Italicise arguments. |
|
Synonym for |
|
.Sx \&I . |
|
.Pp |
|
See also |
|
.Sx \&B , |
|
.Sx \&I , |
|
.Sx \&R . |
|
.Sx \&b , |
|
and |
|
.Sx \&r . |
|
.Ss \&in |
.Ss \&in |
Indent relative to the current indentation: |
Indent relative to the current indentation: |
.Pp |
.Pp |
Line 865 Begin literal mode: all subsequent free-form lines hav |
|
Line 852 Begin literal mode: all subsequent free-form lines hav |
|
line boundaries preserved. |
line boundaries preserved. |
May be ended by |
May be ended by |
.Sx \&fi . |
.Sx \&fi . |
.Ss \&r |
|
Fonts and styles (bold face, italics) reset to roman (default font). |
|
.Pp |
|
See also |
|
.Sx \&B , |
|
.Sx \&I , |
|
.Sx \&R , |
|
.Sx \&b , |
|
and |
|
.Sx \&i . |
|
.Ss \&sp |
.Ss \&sp |
Insert vertical spaces into output with the following syntax: |
Insert vertical spaces into output with the following syntax: |
.Bd -filled -offset indent |
.Bd -filled -offset indent |
Line 946 In GNU troff, this would result in strange behaviour. |
|
Line 923 In GNU troff, this would result in strange behaviour. |
|
.Xr man 1 , |
.Xr man 1 , |
.Xr mandoc 1 , |
.Xr mandoc 1 , |
.Xr mandoc_char 7 , |
.Xr mandoc_char 7 , |
.Xr mdoc 7 |
.Xr mdoc 7 , |
|
.Xr roff 7 , |
|
.Xr tbl 7 |
.Sh HISTORY |
.Sh HISTORY |
The |
The |
.Nm |
.Nm |