TGAL Manual

BOX Command
TGAL Commands
060865 Tandem Computers Incorporated 2–9
BOX Command Use the BOX command to create a box to enclose text. You indicate the end of the text
to be boxed with another BOX command. Between these two commands, you can
have zero or more text lines and TGAL commands.
The BOX command prints the left side of the box in column 1, as specified by the POFF
command, and the right side of the box in the last column, as specified with the
OUTLEN command. If the OUTLEN command is set to 70, TGAL prints the sides of
the box in column 1 and column 70. Your text must fit inside the box. Thus, you must
indent the text at least one space on each side of each box line. If you do not indent
your text, the BOX command replaces any characters in columns 1 or 70 with the sides
of the box and prints an error message.
If the material between the BOX commands extends over a page, the BOX command
automatically finishes a box at the bottom of a page, adds a continuation arrow (unless
you specify ARROW OFF), and begins a new box at the top of the next page.
A box always requires four lines—two lines for the top and bottom of the box and a
blank line before and after the text within the box. If the box extends over a page, it
requires an additional line for the continuation arrow, even if you suppress the arrow.
The syntax for the BOX command is:
BOX [ "
c1
" [, "
c2
" ] ]
...
text
...
BOX
"
c1
"
specifies the character TGAL prints as the sides of the box.
"
c2
"
specifies the character TGAL prints as the top and bottom lines of the box.
Considerations
You can use any character for either “c1” or “c2” except a quotation mark (“) or a
blank. If no characters are specified for “c1” and “c2”, then “c1” defaults to “|”
and “c2” defaults to “-”.
If you use the NEED command with a box, be sure to put the NEED command
before the BOX command. Otherwise, you might have a small, empty box at the
bottom of a page.
You suppress the joining and justifying of lines within a box when you use the
BOX command.
If you do not use the OUTLEN command, the box is 70 characters wide. The
OUTLEN command also controls the width of the box.