version 1.116, 2012/06/02 20:16:23 |
version 1.122, 2014/01/06 00:53:33 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2009, 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2009, 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2011 Ingo Schwarze <schwarze@openbsd.org> |
.\" Copyright (c) 2011, 2012, 2013 Ingo Schwarze <schwarze@openbsd.org> |
|
.\" Copyright (c) 2010 Joerg Sonnenberger <joerg@netbsd.org> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" purpose with or without fee is hereby granted, provided that the above |
.\" purpose with or without fee is hereby granted, provided that the above |
Line 253 in the alphabetical reference below. |
|
Line 254 in the alphabetical reference below. |
|
.It Sx IP Ta indented paragraph: Op Ar head Op Ar width |
.It Sx IP Ta indented paragraph: Op Ar head Op Ar width |
.It Sx TP Ta tagged paragraph: Op Ar width |
.It Sx TP Ta tagged paragraph: Op Ar width |
.It Sx HP Ta hanged paragraph: Op Ar width |
.It Sx HP Ta hanged paragraph: Op Ar width |
|
.It Sx PD Ta set vertical paragraph distance: Op Ar height |
.It Sx \&br Ta force output line break in text mode (no arguments) |
.It Sx \&br Ta force output line break in text mode (no arguments) |
.It Sx \&sp Ta force vertical space: Op Ar height |
.It Sx \&sp Ta force vertical space: Op Ar height |
.It Sx fi , nf Ta fill mode and no-fill mode (no arguments) |
.It Sx fi , nf Ta fill mode and no-fill mode (no arguments) |
Line 361 subsequent output lines are indented, with the followi |
|
Line 363 subsequent output lines are indented, with the followi |
|
.Pp |
.Pp |
The |
The |
.Cm width |
.Cm width |
argument must conform to |
argument is a |
.Sx Scaling Widths . |
.Xr roff 7 |
|
scaling width. |
If specified, it's saved for later paragraph left-margins; if unspecified, the |
If specified, it's saved for later paragraph left-margins; if unspecified, the |
saved or default width is used. |
saved or default width is used. |
.Pp |
.Pp |
Line 404 Begin an indented paragraph with the following syntax: |
|
Line 407 Begin an indented paragraph with the following syntax: |
|
.Pp |
.Pp |
The |
The |
.Cm width |
.Cm width |
argument defines the width of the left margin and is defined by |
argument is a |
.Sx Scaling Widths . |
.Xr roff 7 |
|
scaling width defining the left margin. |
It's saved for later paragraph left-margins; if unspecified, the saved or |
It's saved for later paragraph left-margins; if unspecified, the saved or |
default width is used. |
default width is used. |
.Pp |
.Pp |
|
|
.Sx \&PP , |
.Sx \&PP , |
and |
and |
.Sx \&TP . |
.Sx \&TP . |
|
.Ss \&PD |
|
Specify the vertical space to be inserted before each new paragraph. |
|
.br |
|
The syntax is as follows: |
|
.Bd -filled -offset indent |
|
.Pf \. Sx \&PD |
|
.Op Cm height |
|
.Ed |
|
.Pp |
|
The |
|
.Cm height |
|
argument is a |
|
.Xr roff 7 |
|
scaling width. |
|
It defaults to |
|
.Cm 1v . |
|
If the unit is omitted, |
|
.Cm v |
|
is assumed. |
|
.Pp |
|
This macro affects the spacing before any subsequent instances of |
|
.Sx \&HP , |
|
.Sx \&IP , |
|
.Sx \&LP , |
|
.Sx \&P , |
|
.Sx \&PP , |
|
.Sx \&SH , |
|
.Sx \&SS , |
|
and |
|
.Sx \&TP . |
.Ss \&PP |
.Ss \&PP |
Synonym for |
Synonym for |
.Sx \&LP . |
.Sx \&LP . |
Line 538 This has the following syntax: |
|
Line 572 This has the following syntax: |
|
.Pp |
.Pp |
The |
The |
.Cm width |
.Cm width |
argument must conform to |
argument is a |
.Sx Scaling Widths . |
.Xr roff 7 |
|
scaling width. |
If not specified, the saved or default width is used. |
If not specified, the saved or default width is used. |
.Pp |
.Pp |
See also |
See also |
Line 604 The syntax is as follows: |
|
Line 639 The syntax is as follows: |
|
.Pp |
.Pp |
The |
The |
.Cm width |
.Cm width |
argument must conform to |
argument is a |
.Sx Scaling Widths . |
.Xr roff 7 |
|
scaling width. |
If specified, it's saved for later paragraph left-margins; if |
If specified, it's saved for later paragraph left-margins; if |
unspecified, the saved or default width is used. |
unspecified, the saved or default width is used. |
.Pp |
.Pp |
|
|
.Sx \&PP . |
.Sx \&PP . |
.Ss \&UC |
.Ss \&UC |
Sets the volume for the footer for compatibility with man pages from |
Sets the volume for the footer for compatibility with man pages from |
BSD releases. |
.Bx |
|
releases. |
The optional first argument specifies which release it is from. |
The optional first argument specifies which release it is from. |
|
.Ss \&UE |
|
End a uniform resource identifier block. |
|
This is a non-standard GNU extension, included only for compatibility. |
|
See |
|
.Sx \&UE . |
|
.Ss \&UR |
|
Begin a uniform resource identifier block. |
|
This is a non-standard GNU extension, included only for compatibility. |
|
It has the following syntax: |
|
.Bd -literal -offset indent |
|
.Pf \. Sx \&UR Ar uri |
|
link description to be shown |
|
.Pf \. Sx UE |
|
.Ed |
.Ss \&br |
.Ss \&br |
Breaks the current line. |
Breaks the current line. |
Consecutive invocations have no further effect. |
Consecutive invocations have no further effect. |
Line 662 Insert vertical spaces into output with the following |
|
Line 713 Insert vertical spaces into output with the following |
|
.Op Cm height |
.Op Cm height |
.Ed |
.Ed |
.Pp |
.Pp |
Insert |
The |
.Cm height |
.Cm height |
spaces, which must conform to |
argument is a scaling width as described in |
.Sx Scaling Widths . |
.Xr roff 7 . |
If 0, this is equivalent to the |
If 0, this is equivalent to the |
.Sx \&br |
.Sx \&br |
macro. |
macro. |
Line 714 The syntax is as follows: |
|
Line 765 The syntax is as follows: |
|
.It Sx \&BI Ta n Ta current Ta \& |
.It Sx \&BI Ta n Ta current Ta \& |
.It Sx \&BR Ta n Ta current Ta \& |
.It Sx \&BR Ta n Ta current Ta \& |
.It Sx \&DT Ta 0 Ta current Ta \& |
.It Sx \&DT Ta 0 Ta current Ta \& |
|
.It Sx \&EE Ta 0 Ta current Ta compat |
|
.It Sx \&EX Ta 0 Ta current Ta compat |
.It Sx \&I Ta n Ta next-line Ta \& |
.It Sx \&I Ta n Ta next-line Ta \& |
.It Sx \&IB Ta n Ta current Ta \& |
.It Sx \&IB Ta n Ta current Ta \& |
.It Sx \&IR Ta n Ta current Ta \& |
.It Sx \&IR Ta n Ta current Ta \& |
.It Sx \&OP Ta 0, 1 Ta current Ta compat |
.It Sx \&OP Ta 0, 1 Ta current Ta compat |
|
.It Sx \&PD Ta 1 Ta current Ta \& |
.It Sx \&R Ta n Ta next-line Ta \& |
.It Sx \&R Ta n Ta next-line Ta \& |
.It Sx \&RB Ta n Ta current Ta \& |
.It Sx \&RB Ta n Ta current Ta \& |
.It Sx \&RI Ta n Ta current Ta \& |
.It Sx \&RI Ta n Ta current Ta \& |
Line 787 implicitly closed, is syntactically incorrect. |
|
Line 841 implicitly closed, is syntactically incorrect. |
|
.It Sx \&SH Ta >0 Ta next-line Ta section Ta \& |
.It Sx \&SH Ta >0 Ta next-line Ta section Ta \& |
.It Sx \&SS Ta >0 Ta next-line Ta sub-section Ta \& |
.It Sx \&SS Ta >0 Ta next-line Ta sub-section Ta \& |
.It Sx \&TP Ta n Ta next-line Ta paragraph Ta \& |
.It Sx \&TP Ta n Ta next-line Ta paragraph Ta \& |
|
.It Sx \&UE Ta 0 Ta current Ta none Ta compat |
|
.It Sx \&UR Ta 1 Ta current Ta part Ta compat |
.El |
.El |
.Pp |
.Pp |
Macros marked |
Macros marked |
Line 913 utility written by Kristaps Dzonsons appeared in |
|
Line 969 utility written by Kristaps Dzonsons appeared in |
|
This |
This |
.Nm |
.Nm |
reference was written by |
reference was written by |
.An Kristaps Dzonsons , |
.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv . |
.Mt kristaps@bsd.lv . |
|
.Sh CAVEATS |
.Sh CAVEATS |
Do not use this language. |
Do not use this language. |
Use |
Use |