Category : Science and Education
Archive   : TBRL253.ZIP
Filename : TBRL-REF.LST

Turbo Braille
Version 2.5

Command Reference List

Commands and Switches

The following commands and switches are available
in batch mode and in interactive mode. The leading slash
of each switch may be replaced by a leading dash.
(Please note that all command examples will be
surrounded by quote marks " ". This is done for
clarification purposes and the quotes are not to be typed
when entering the commands.

Add a formatting command: "/A"
(Adds any legal dot command recognized by Turbo
BRaille to the stored setup.)
Delete a dot command: "/D"
(Deletes any stored dot commands from the stored
setup, see "/A".)
Format for specific printer: "/F #"
(formats output for printer specified by #. The default is
#0.)
Help file: "/H"
(Displays help file.)
Jump over pages: "/j #"
(Jump over the number of pages specified by #. Printing
will start on page #" plus 1.)
Make files: "/M #" where "#" is 0, 1, 2, or 3.
(Determines what kinds of files Turbo Braille makes.
Setting 0 makes no files, 1 a BIF file, 2 a BRL file and 3
both BIF and BRL. The default is 2.)
Printer definition: "/P?" "/P#"
(For defining and displaying printer settings. The "/P?"
command displays all printer definitions, and "/P #"
allows you to change or drop the specified printer
definition. Printer 0 is pre-defined and not user
changeable.)
Show and save setup: "/S?" "/SL" "/SG"
(Show and save all settings of switches. The "/S?"
displays all settings and "/SL" saves locally--in the
current subdirectory and "/SG" saves the setup globally-
-in the same subdirectory as Turbo Braille.)
Verbosity level: "/V #"
(Verbosity determines the number and length of
messages spoken during translation/processing with a
range of 0-9. Only 0-3 are currently implemented.)
Write to device: "/W0" "/W1" "/W2" "/W3"
(Send output "write to a device." The devices are: 0--
nothing, 1--printer "PRN," 2--file or 3--both printer and
file. The default is 2.)

Dot Commands

Below is an alphabetical list of valid dot commands
with a definition of each one. Each dot command
occupies a complete line in a BIF file, and consists of a
dot or period in position one, two letters in positions two
and three specifying the command and in many cases
one or more optional arguments providing additional
information. These arguments are usually numbers and
may or may not be separated from the command with a
space. Dot commands can only be used in BIF files
which must be ASCII text files, not WordPerfect or
WordStar files.

Bottom Line: ".BL x,y"
(Define what appears on bottom line of page. The x
equals 0, 1, 2, or 3 and determines how the line will be
used. Setting 0 uses the line for ordinary text, 1 leaves
the line blank, 2 uses the line for a running footer which
is left adjusted and 3 centers the running footer. Setting
3 is not implemented at this time. The y equals 0, 1, 2,
or 3 and controls page numbers which appear in the right
corner. Setting 0 equals no numbering, 1 equals roman
braille page number, 2 equals arabic braille numbering
and 3 equals print page numbers.)
Begin Page: ".BP" ".BP #" ".BP +#" ".BP -#"
(Begin new braille page. May specify a page number or
not.)
Break: ".BR"
(Break line, same as hard carriage return.)
Command Character: ".CC"
(Reserved for future use.)
Center: ".CE" ".CE #"
(Center one or more lines. If number is specified, that
number of lines will be centered.)
Divide Page: ".DV" ".DV #" ".DV #,#"
(Draws line of dots 2-5 across page at specified line
number(s). Useful for folding letters. A ".DV" command
by itself cancels any previous command)
End Writing: ".EW"
(Not Implemented)
Fill Lines:" ".FI"
(Fills all braille lines with as much text as they will hold.
This is the default and is used to restore filling after
".NF" command has been issued.)
Grade of Translation: ".GR0" ".GR1" ".GR2"
(Controls Grade of braille. The default is Grade 2, Grade
1 is uncontracted braille and Grade 0 is computer braille.)
Horizontal Line: ".HL"
(Termination line used in magazine format to separate
articles. It is 12 centered cells of dots 2-5.)
Indent: ".IN #" ".IN +#" ".IN -#"
(Indents line specified number of spaces, or adds to or
subtracts from previous indention with plus and minus
numbers. Restore to default with ".IN 0".)
Interpoint Page Numbering: ".IP"
(Only prints page numbers on odd pages for interpoint or
double-sided braille.)
Italics: ".IT" ".IT #"
(Italicizes line or lines of text in a BIF file. If partial lines
are to be italicized, use the imbedded commands \_ or \!.)
Need Lines: ".NE #"
(Holds specified number of lines together, preventing
page break from occurring in middle. Same as word
processing feature" "conditional end of page" or
"widow/orphan protection.")
No Fill: ".NF"
(Does not fill braille lines, obeys all carriage returns.)
No Interpoint: ".NI"
(Turns off interpoint page numbering.)
Page Length: ".PL #" ".PL +#" ".PL -#"
(Defines number of lines per page. Plus and minus can
be used relative to current page length.)
Page Number: ".PN" ".PN #" ".PN +#" ".PN -#"
(Identifies print page break in the source document in
braille output document. Page numbering must be turned
on with ".TL" or ".BL" commands. A new print page
number can also be specified with a number after
command.)
Page Offset: ".PO #" ".PO +#" ".PO -#"
(Sets aside specified number of spaces at left end of
lines. Spaces may be allowed for use in binding etc.
You can add or delete spaces from present offset with
plus and minus values.)
Paragraph: ".PP"
(Creates braille paragraph, breaks line and indents next
line two spaces.)
Read File: ".RF (filename)"
(Read contents of another BIF file into current file. The
second file can not contain another" ".RF" command
although the first file can have more than one" ".RF"
command)
Running Header: ".RH" ".RH TEXT"
(Used to specify a running header. Can be placed on top
line, bottom line or both. This is controlled with ".TL"
and ".BL" commands. By itself, it can be used to leave
a blank line at top or bottom. If used after previous
".RH" command, will cancel that command.)
Right Margin: ".RM #" ".RM +#" ".RM -#"
(The number specifies the last cell to be used on the right
side of the page. Can be increased or decreased with
plus or minus numbers.)
Substitute String: ".SB x string of text"
(Used in conjunction with imbedded command "\x"
where x is the letter identifying the substitution string.
Define string with ".SB x (string of text)" command and
wherever "\x" appears, the string will be substituted.)
Skip Line Absolutely: ".SK" ".SK #"
(Skips a line in document, even if blank line appears at
top of page.)
Space: ".SP" ".SP #"
(PUts a blank line into text. If blank appears at top of
page, command is ignored.)
Table of Contents: ".TC"
(Reserved for future use.)
Temporary Indent: ".TI #" ".TI +#" ".TI -#"

(Temporarily indents next line only specified number of
spaces. Can be increased or decreased with plus or
minus values. Useful for hanging indents or undents by
establishing a permanent indent with ".IN #" command
and using ".TI -#" command to move next line to left.)
Top Line: ".TL x,y"
(Define what appears on top line of page. The x equals
0, 1, 2, or 3 and stands for use line for ordinary text,
leave the line blank, use for running header left adjusted
or use line for running header centered, respectively.
Setting 3 is not implemented at this time. The y equals
0, 1, 2, or 3 and controls page numbers which appear in
the right corner. Setting 0 equals no numbering, 1
equals roman braille page number, 2 equals arabic braille
numbering and 3 equals print page numbers.)
Write File: ".WF"
(Reserved for future use.)

Imbedded Commands

Imbedded commands may occur on the same line as
text in a BIF file, sandwiched between words, or even
imbedded within a single word to achieve some
immediate effect. Each imbedded command begins with
a single backslash character "\" and includes exactly one
additional character: either a letter, a digit or a
punctuation mark. If the additional character is also a
backslash character, then an ordinary backslash is
recognized.

Grade Change: "\0" "\1" "\2"
(Used to change the grade of translation where 0 equals
computer braille, 1 equals Grade
1 braille and 2 equals Grade 2 braille. Grade changes
may be used within a word to break up letter
combinations you do not want contracted.)
Page Number Reference Characters: "\@" "\#" "\%"
(These characters allow you to reefer to the current
braille page number in roman numerals, arabic numerals
or standard textbook format, respectively.)
Print Enhancement Characters: "\!" "\_"
(Used to indicate boldfacing and underlining respectively
by italicizing braille text. They are toggles and must be
turned on and off.)
Spring Characters: "\:" "\." "\-"
(Insert characters on line to force text to left and right.
They use spaces, guide dots and dashes respectively.
Can be mixed and/or used repeatedly on a single line.
Do not use on centered lines.)

For further information on Turbo Braille commands
see Part One of the manual for information on commands
and switches and Part Two for a tutorial on dot
commands. Consult the Help facility in Turbo Braille for
help with all commands.