aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/regress/mdoc/Bk/break.in
blob: c0fcf3722eae5818a79511bb9253c56b7484cd44 (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
54
.\" $OpenBSD: break.in,v 1.7 2017/07/04 14:53:24 schwarze Exp $
.Dd $Mdocdate: July 4 2017 $
.Dt BK-BREAK 1
.Os
.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