TGAL Manual

NEED Command
TGAL Commands
2–40 060865 Tandem Computers Incorporated
Considerations
You can use two dollar signs ($$) to keep five lines together. TGAL sees these
dollar signs as a special symbol equivalent to a NEED 5 command. TGAL does
not print these dollar signs. You must put this symbol as the first two positions on
a line. You can put these dollar signs before a paragraph heading to keep the
heading with the first few lines of the next paragraph.
Although TGAL automatically starts a new page when necessary, you sometimes
have to make additional adjustments, perhaps to avoid a widow (an incomplete
line) from being carried over to the top of the next page. If this occurs, you can put
a NEED command before the paragraph. If the paragraph is long, you can use the
two dollar signs ($$) to keep five lines together.
A NEED command causes a break; the two dollar signs do not.
When the argument to the NEED or TAG command is ON, B, or trigger, TGAL
counts input lines until it sees the corresponding OFF command, blank line, or
command line. If joining is on, and the length of the input lines is substantially
different from the specified line length, the resulting number of output lines might
differ from the number TGAL counts. For this reason, the number of lines kept
together or tagged might be incorrect.
The IF command suppresses the NEED command.
Put the NEED command before a BOX command to prevent having a small, empty
box at the bottom of a page.
If you do not use this command, TGAL assumes:
NEED OFF