version 1.125, 2010/06/12 10:09:19 |
version 1.127, 2010/06/27 13:30:51 |
Line 1094 As a scaling unit following the syntax described in |
|
Line 1094 As a scaling unit following the syntax described in |
|
As the calculated string length of the opaque string. |
As the calculated string length of the opaque string. |
.El |
.El |
.Pp |
.Pp |
If unset, it will revert to the value of |
If not provided an argument, it will be ignored. |
.Ar 8n |
|
as described in |
|
.Sx Scaling Widths . |
|
.It Fl compact |
.It Fl compact |
Do not assert a vertical space before the block. |
Do not assert a vertical space before the block. |
.It Fl file Ar file |
.It Fl file Ar file |
|
|
.Sx \&Dl . |
.Sx \&Dl . |
.Ss \&Bf |
.Ss \&Bf |
.Ss \&Bk |
.Ss \&Bk |
|
Begins a keep block, containing a collection of macros or text |
|
to be kept together in the output. |
|
One argument is required; additional arguments are ignored. |
|
Currently, the only argument implemented is |
|
.Fl words , |
|
requesting to keep together all words of the contained text |
|
on the same output line. |
|
A |
|
.Fl lines |
|
argument to keep together all lines of the contained text |
|
on the same page has been desired for a long time, |
|
but has never been implemented. |
|
.Pp |
|
Examples: |
|
.Bd -literal -offset indent |
|
\&.Bk \-words |
|
\&.Op o Ar output_file |
|
\&.Ek |
|
.Ed |
.Ss \&Bl |
.Ss \&Bl |
Begins a list composed of one or more list entries. |
Begins a list composed of one or more list entries. |
A list is associated with a type, which is a required argument. |
A list is associated with a type, which is a required argument. |
|
|
.Ss \&Ed |
.Ss \&Ed |
.Ss \&Ef |
.Ss \&Ef |
.Ss \&Ek |
.Ss \&Ek |
|
Ends a keep context started by |
|
.Sx \&Bk . |
.Ss \&El |
.Ss \&El |
Ends a list context started by |
Ends a list context started by |
.Sx \&Bl . |
.Sx \&Bl . |
Line 2169 Heirloom troff, the other significant troff implementa |
|
Line 2187 Heirloom troff, the other significant troff implementa |
|
.Pp |
.Pp |
.Bl -dash -compact |
.Bl -dash -compact |
.It |
.It |
groff supports a |
Old groff fails to assert a newline before |
.Fl file Ar filename |
.Sx \&Bd Fl ragged compact . |
argument to |
|
.Sx \&Bd . |
|
mandoc does not. |
|
.It |
.It |
groff behaves inconsistently when encountering |
groff behaves inconsistently when encountering |
.Pf non- Sx \&Fa |
.Pf non- Sx \&Fa |
Line 2249 In quoted literals, groff allowed pair-wise double-quo |
|
Line 2264 In quoted literals, groff allowed pair-wise double-quo |
|
standalone double-quote in formatted output. |
standalone double-quote in formatted output. |
This idiosyncratic behaviour is not applicable in mandoc. |
This idiosyncratic behaviour is not applicable in mandoc. |
.It |
.It |
Display types |
Display offsets |
.Sx \&Bd |
.Sx \&Bd |
.Fl center |
.Fl offset Ar center |
and |
and |
.Fl right |
.Fl offset Ar right |
are aliases for |
are disregarded in mandoc. |
.Fl left |
Furthermore, the |
in mandoc. Furthermore, the |
|
.Fl file Ar file |
.Fl file Ar file |
argument is ignored. |
argument is not supported in mandoc. |
Lastly, since text is not right-justified in mandoc (or even groff), |
Lastly, since text is not right-justified in mandoc (or even groff), |
.Fl ragged |
.Fl ragged |
and |
and |