version 1.132, 2010/07/06 10:55:50 |
version 1.133, 2010/07/06 11:07:21 |
|
|
and |
and |
.Sx \&Sy . |
.Sx \&Sy . |
.Ss \&Bk |
.Ss \&Bk |
Begins a keep block, containing a collection of macros or text |
Begins a collection of macros or text not breaking the line. |
to be kept together in the output. |
|
Its syntax is as follows: |
Its syntax is as follows: |
.Pp |
.Pp |
.D1 Pf \. Sx \&Bk Fl words |
.D1 Pf \. Sx \&Bk Fl words |
.Pp |
.Pp |
Currently, the only argument implemented is |
|
.Fl words , |
|
requesting to keep together all words of the contained text |
|
on the same output line. |
|
Subsequent arguments are ignored. |
Subsequent arguments are ignored. |
|
The |
|
.Fl words |
|
argument is required. |
.Pp |
.Pp |
Examples: |
Each line within a keep block is kept intact, so the following example |
|
will not break within each |
|
.Sx \&Op |
|
macro line: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
\&.Bk \-words |
\&.Bk \-words |
\&.Op o Ar output_file |
\&.Op Fl f Ar flags |
|
\&.Op Fl o Ar output |
\&.Ek |
\&.Ek |
.Ed |
.Ed |
.Pp |
.Pp |
See also |
Be careful in using over-long lines within a keep block! |
.Sx \&Ek . |
Doing so will clobber the right margin. |
.Ss \&Bl |
.Ss \&Bl |
Begins a list composed of one or more list entries. |
Begins a list composed of one or more list entries. |
Its syntax is as follows: |
Its syntax is as follows: |