Return to break.in CVS log

Up to [cvsweb.bsd.lv] / mandoc / regress / mdoc / Bk

Annotation of mandoc/regress/mdoc/Bk/break.in, Revision 1.3

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