version 1.132, 2010/07/06 10:55:50 |
version 1.134, 2010/07/15 23:50:15 |
|
|
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: |
|
|
.Ss \&Sc |
.Ss \&Sc |
.Ss \&Sh |
.Ss \&Sh |
.Ss \&Sm |
.Ss \&Sm |
|
Switches the spacing mode for output generated from macros. |
|
Its syntax is as follows: |
|
.Pp |
|
.D1 Pf \. Sx \&Sm Cm on | off |
|
.Pp |
|
By default, spacing is |
|
.Cm on . |
|
When switched |
|
.Cm off , |
|
no white space is inserted between macro arguments and between the |
|
output generated from adjacent macros, but free-form text lines |
|
still get normal spacing between words and sentences. |
.Ss \&So |
.Ss \&So |
.Ss \&Sq |
.Ss \&Sq |
.Ss \&Ss |
.Ss \&Ss |