\discretionary

yex.keyword.Discretionary(parser)

Adds a discretionary break.

Source code in yex/keyword/other.py

@yex.decorator.control(
    vertical = False,
    horizontal = True,
    math = False,
    )
def Discretionary(parser):
    "Adds a [discretionary break](yex.box.DiscretionaryBreak.md)."

    symbols = {}

    for name in ['prebreak', 'postbreak', 'nobreak']:
        symbols[name] = list(parser.another(
            level='reading',
            on_eof='exhaust',
            bounded='balanced',
            ))

    return yex.box.DiscretionaryBreak(**symbols)