blob: e7124b555bc8d2218d9094ac9d80dca8bcd2fca1 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
.Dd $Mdocdate$
.Dt BK-BREAK 1
.Os OpenBSD
.Sh NAME
.Nm Bk-break
.Nd handling of word keeps
.Sh DESCRIPTION
Even though it is called a word keep,
.Bk -words
it will not keep words together in free-form text.
.Ek
However, even the noop macro
.Bk -words
.No is sufficient to let the keep take effect .
.Ek
Even text generated in pre-handlers must be kept together with
the text following it:
.Bk -words
.Xr one 1 No and Xr two 2
.Ek
should be on the same line.
.Pp
Including the whole output line into the keep is not required,
including just the macros to be kept together is sufficient:
.Pp
.Nm
.Ar x x x x x x x x
.Ar x x x x x x x x
.Ar x x x x x x x x
.Ar x x x x x x
.Bk -words
.Op o Ar a
.Ek
.Pp
.Bk -words
.Nm
.Ar x x x x x x x x
.Ar x x x x x x x x
.Ar x x x x x x x x
.Ar x x x x x x
.Op o Ar a
.Ek
.Pp
Even text printed without spacing must be kept together
with the text following it:
.Pp
.Bk -words
.Fn xxxxxxxxxxxxxxxxxxxx "xxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxx" xxxxxxxxxxxxxxxxxxxx
.Pp
.Fo xxxxxxxxxxxxxxxxxxxx
.Fa "xxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxx" xxxxxxxxxxxxxxxxxxxx
.Fc
.Ek
|