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.2

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