home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MISC / HANDICAP / TBRL260.ZIP / TBRL.DOC < prev    next >
Encoding:
Text File  |  1991-09-24  |  40.8 KB  |  849 lines

  1.  
  2.  
  3.  
  4.                                   TURBO BRAILLE 
  5.         
  6.         
  7.                             Another Sound Alternative
  8.         
  9.         
  10.         
  11.         
  12.                       For IBM Compatible Personal Computers
  13.         
  14.         
  15.         
  16.                                   Version 2.59
  17.         
  18.         
  19.         
  20.         
  21.         
  22.         
  23.                              Copyright (C) 1989-1991
  24.         
  25.                                        by
  26.                                   KANSYS, Inc.
  27.                                 1016 Ohio Street
  28.                                Lawrence, KS 66044
  29.         
  30.         
  31.         
  32.                             Telephone: 913-843-0351
  33.                                  or 800-279-4880
  34.         
  35.                                   INTRODUCTION
  36.         
  37.              Turbo Braille is a computer program designed to produce 
  38.         Grade II English Braille. This production includes translation 
  39.         and formatting. In addition to producing Grade II braille, Turbo 
  40.         Braille will produce Grade I and/or computer braille. The 
  41.         program should run on all IBM and compatible personal computers 
  42.         under MS-DOS or PC-DOS version 3.0 or later, as well as a number 
  43.         of non-IBM compatible MS-DOS machines, such as the Zenith Z-100, 
  44.         DEC Rainbow and Texas Instruments TI Professional. Not only is 
  45.         Turbo Braille able to run on many MS-DOS machines, but it also 
  46.         works well with many screen review/speech synthesizer 
  47.         combination. Turbo Braille requires DOS Version 3.0 or higher 
  48.         and 128K of free memory to run. It will work with either a 
  49.         floppy drive or hard disk equipped computer. While a braille 
  50.         printer is necessary to print hard copy braille, it is not 
  51.         necessary to have a braille printer to run Turbo Braille. The 
  52.         program should support any braille printer. You can establish up 
  53.         to ten printer definitions, which are available for use at any 
  54.         time. Instructions for installing Turbo Braille on your system 
  55.         can be found in the file called "READ.ME"
  56.         
  57.              As you learn more about Turbo Braille, you will find that it 
  58.         has two personalities. It can either be a simple and easy-to-use 
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.         program, or it can be a complex and powerful tool, with many 
  66.         formatting commands available for your use. The choice is yours. 
  67.         In its basic mode of operation, Turbo Braille will accept as 
  68.         input any standard ASCII text file, any WordPerfect Version 4.2 
  69.         or 5.0 file, many WordPerfect 5.1 files, or any WordStar 
  70.         Professional Version 4, 5, or 6.x file. Using one of these file 
  71.         types, Turbo Braille will produce well-formatted accurate 
  72.         braille. Our intention is to make Turbo Braille a program which 
  73.         will produce acceptable braille for personal use without a lot of 
  74.         user intervention. To this end, Turbo Braille will handle a 
  75.         number of display/formatting attributes including centering, 
  76.         unusual mixes of capitalization, boldfacing, italics and page 
  77.         numbers--both print and braille, In its basic mode of operation. 
  78.         An upcoming version will also handle running headers and footers 
  79.         automatically. Turbo Braille is unique among braille translators 
  80.         in its ability to use WordPerfect and WordStar files directly as 
  81.         input and in its ability to handle many formatting tasks 
  82.         automatically. Further, Turbo Braille has available a powerful 
  83.         set of "dot commands" which precisely control braille formatting.  
  84.            This manual is divided into two sections. Section One will 
  85.         discuss the basic operation of the program while Section Two will 
  86.         discuss braille formatting and the dot commands in some detail. 
  87.         If you have any questions, problems or suggestions, please feel 
  88.         free to write or call. You can reach us at 913-843-0351 or call 
  89.         our toll-free number, 800-279-4880.
  90.         
  91.                               DEMONSTRATION VERSION
  92.         
  93.              Turbo Braille is available in a demonstration version. 
  94.         Although the program is fully functional, it will only produce 
  95.         one page of output. (Specify the page to be printed by "Jumping 
  96.         Pages" with the "/J" command.) However, this will allow you to 
  97.         see how all the commands work, experiment with the dot commands, 
  98.         and it will also show you how fast Turbo Braille is.   
  99.         
  100.                                    SECTION ONE
  101.                                  BASIC OPERATION
  102.         
  103.                                    QUICK START
  104.         
  105.              You can easily produce well-formatted braille for your day-
  106.         to-day use with Turbo Braille. All you have to do is type 
  107.         "TBRL", a space and the name of any supported file type (that is 
  108.         any ASCII text file, WordPerfect, or WordStar file) at the DOS 
  109.         prompt and hit "Return." Turbo Braille will automatically write a 
  110.         translated file with the same name and a .BRL extension. Use the 
  111.         DOS "PRINT" command to print the file on your braille printer, or 
  112.         use the Slash W 1 (/W1) switch to automatically print to the PRN 
  113.         device. This switch must be placed between the "TBRL" and the 
  114.         name of the file on the command line. The default printer 
  115.         settings are 40 cells per line, 25 lines per page, with 
  116.         formfeeds, no page offset, and continuous paper. That is all 
  117.         there is to using Turbo Braille in its most basic mode. Read on 
  118.         to see how to change these defaults, should you need to. 
  119.         
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                MODES OF OPERATION
  127.         
  128.              Turbo Braille has two modes of operation, an interactive 
  129.         mode and a batch mode. Either mode is entered from the DOS ">" 
  130.         prompt. In batch mode you enter the program name, any applicable 
  131.         switches, the filename(s) to be translated, and hit the "carriage 
  132.         return" or "enter" key. The program executes, performs the 
  133.         translation/formatting tasks as instructed, and exits, leaving 
  134.         you at the DOS prompt once again.  The switches and filenames are 
  135.         processed strictly from left to right just as they are 
  136.         encountered, so that switches affecting a particular file must 
  137.         appear before the name of that file.
  138.         
  139.              To enter Turbo Braille's Interactive Mode, simply type 
  140.         "TBRL" at the DOS ">" prompt. (Do not type the quotation marks; 
  141.         they are included to indicate that the enclosed text is a 
  142.         command.) Further, case is not important when typing a command 
  143.         from the DOS prompt. The program will run, giving you a sign-on 
  144.         message and the Turbo Braille prompt, which is TB->. When you 
  145.         see the TB-> prompt you know that you are in Interactive Mode. 
  146.         From this mode, you can enter filename(s) and/or other commands 
  147.         which will be immediately executed. When each file or command has 
  148.         been processed, you will be returned to the TB-> prompt.  To 
  149.         return to the DOS prompt from the interactive mode, simply press 
  150.         "return" or "enter" at the TB-> prompt.
  151.         
  152.              In the Interactive Mode, filenames and commands are entered 
  153.         one at a time. It is possible to use the DOS wild card characters 
  154.         "?" and "*" when specifying files to be processed. The wild card 
  155.         characters are also available for use in Batch Mode. When using 
  156.         these wild card characters, it is possible to specify more files 
  157.         or different files than you intended to process. For this reason, 
  158.         files with certain extensions have been excluded. These include 
  159.         files with the extensions .COM, .EXE, .LIB, .OBJ AND .SYS. The 
  160.         backup file extensions .BAK and .BK! have also been excluded. 
  161.         Finally, the data compression extensions .ARC and .ZIP and the 
  162.         KANSYS, Inc. extensions .BRL, .CFG and .PV3 have been excluded. 
  163.         You would not normally want to translate one of these files into 
  164.         braille. If you do, you will have to rename it first.
  165.         
  166.         
  167.                                 ENTERING COMMANDS
  168.         
  169.              In the Batch Mode, TBRL commands are called switches. In the 
  170.         Interactive Mode, they will be referred to as commands. Each 
  171.         command or switch is started with a forward slash "/". It is 
  172.         followed by a command letter and possibly by a number or other 
  173.         information. A dash "-" can be used in place of the slash, if you 
  174.         prefer. All filenames and switches should be separated with 
  175.         spaces when entering them on the command line in Batch Mode. In 
  176.         Interactive Mode, filenames and commands are entered one at a 
  177.         time from the TB-> prompt. 
  178.         
  179.                                       HELP
  180.         
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.              Turbo Braille has available an extensive Help facility. To 
  188.         enter Help, type Slash H "/H" from the TB-> prompt or follow the 
  189.         "TBRL" command with a Slash H. You can then read through the 
  190.         Help information a screen at a time learning about the program. 
  191.         To navigate within the Help system you type a letter followed by 
  192.         a press of the "carriage return" or "enter" key. The available 
  193.         letters are "N" for the next screen, "P" for the previous screen, 
  194.         "F" for the first screen and "D" for done. Upon exiting Help, 
  195.         you will be back at the TB-> prompt.
  196.         
  197.                              INPUT AND OUTPUT FILES
  198.         
  199.              As mentioned earlier, Turbo Braille accepts three standard 
  200.         file formats as its input. These file types are ASCII text 
  201.         files, WordPerfect Version 4.2 and 5.0 files, and WordStar 
  202.         Professional Version 4, 5, and 6 files. Those of you who have 
  203.         used earlier versions of Turbo Braille will notice that the 
  204.         ability to handle later versions of WordPerfect and WordStar 
  205.         files is the major difference with Version 2.0 of Turbo Braille. 
  206.         In addition, a number of translation errors have been corrected 
  207.         and the program can now handle long lines of text, such as those 
  208.         produced by spreadsheet programs. 
  209.         
  210.              Actually, Turbo Braille will accept a fourth kind of file as 
  211.         input, a "BIF" or Braille Intermediate File. BIF files are 
  212.         produced by Turbo Braille itself and are ASCII files interspersed 
  213.         with the dot commands which Turbo Braille uses to control 
  214.         formatting. Turbo Braille appends a three-letter extension to 
  215.         file names so their type can be identified. All translated 
  216.         braille files will be followed by ".BRL" and all BIF files will 
  217.         be followed by ".BIF". 
  218.         
  219.              When using Turbo Braille, it is possible to: produce a 
  220.         braille file which can be printed at a later time; produce a BIF 
  221.         file which can be edited and/or printed at a later time; or 
  222.         produce braille and BIF files at the same time. The default for 
  223.         Turbo Braille is to produce Braille files, although this can be 
  224.         easily changed.
  225.         
  226.              There are two switches/commands which control the kind of 
  227.         file produced, Slash M "/M" and Slash W "/W". Each of these is 
  228.         followed by a number in the range of 0 through 3. Further, 
  229.         either can be followed by a Question Mark "?" which will show you 
  230.         the current setting. The choices are as follows: /M0 produces no 
  231.         output, /M1 makes a BIF file, /M2 makes a braille file, and /M3 
  232.         makes both a braille and BIF file. What happens to files is 
  233.         controlled by the "W" switch or command. The choices here are: 
  234.         /W0 discards all braille output, /W1 sends output to a printer, 
  235.         /W2 writes to a file with the .BRL extension, and /W3 sends 
  236.         output to a printer and to a file.  The default setting is 2, 
  237.         which of course means that a braille file is written.  
  238.         
  239.                                      Setups
  240.         
  241.              As you have seen so far, Turbo Braille has a number of 
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.         options which can be easily changed while you are using the 
  249.         program. The values for all the commands and switches plus all 
  250.         printer definitions and Global dot commands are saved in a file 
  251.         called "TBRL.CFG". Two kinds of Setups are available, Local and 
  252.         Global.
  253.         
  254.              As you recall, in the "README.DOC" file you were advised to 
  255.         put Turbo Braille in a subdirectory called "\TB" if you use a 
  256.         hard disk equipped computer. You were then advised to put this 
  257.         subdirectory on your "path." This will allow you to run Turbo 
  258.         Braille from any subdirectory on your computer. 
  259.         
  260.              Another reason for this advice has to do with Setups. Two 
  261.         kinds of Setups are available to you when using Turbo Braille, 
  262.         Global and Local. A Global Setup is located in the same 
  263.         directory as Turbo Braille itself. Any commands found here will 
  264.         be applied to all files processed by the program. A Local Setup 
  265.         can be located in any subdirectory other than the one which 
  266.         contains Turbo Braille. This means that you can establish sub-
  267.         directories for different kinds of data or output files, with 
  268.         appropriate Local Setups for each. 
  269.         
  270.              When you execute the program, Turbo Braille first checks the 
  271.         subdirectory into which you are logged for a TBRL.CFG file and, 
  272.         if one is found, it is used to establish the default settings. 
  273.         If there is none there, Turbo Braille checks in the directory in 
  274.         which the program is located. If one is found here, it is used 
  275.         as the Global Setup.
  276.         
  277.              If you make any changes while using the program, such as 
  278.         defining a printer, and you wish to make these changes permanent, 
  279.         you must save the changes as either a Local or Global Setup. 
  280.         This is done with the Slash SL (/SL) or Slash SG (/SG) commands 
  281.         or switches respectively. To make any setup a Local Setup you 
  282.         must also be logged into a directory other than that in which 
  283.         Turbo Braille is located.  Remember that Global Setups are the 
  284.         default unless a Local Setup has been established. If it has, it 
  285.         becomes the default.
  286.         
  287.              You can also review and save Setups from within Turbo 
  288.         Braille. This is done with the Slash S "/S" command or switch. 
  289.         The "/S" is followed by one of three choices, "?" "G" or "L". 
  290.         The "/S?" command will display information about the Setup 
  291.         currently being used, "/SG" will save a Global Setup and "/SL" 
  292.         will save a Local Setup in the current subdirectory.
  293.         
  294.                                     PRINTING
  295.         
  296.              Turbo Braille has the ability to store information on up to 
  297.         ten printers. They are numbered 0 through 9 with 0 being the 
  298.         default. Thus, Turbo Braille will automatically format for 
  299.         printer 0 unless you tell it otherwise. Printer 0 is not 
  300.         redefinable by the user.
  301.         
  302.              To define a printer, Turbo Braille needs to know the page 
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.         length in lines, the line length in braille cells, whether or not 
  310.         you want a page offset and if so how much, whether your printer 
  311.         uses continuous paper or single sheets, and finally whether or 
  312.         not form feeds are necessary. Page offset is space which is 
  313.         automatically inserted at the beginning or left side of each 
  314.         line. This space may be necessary to allow for the binding of 
  315.         pages. A form feed is a command which advances your printer to 
  316.         the next page. Most printers require a form feed from the 
  317.         software. Try providing a form feed, and if you get a blank 
  318.         sheet between printed pages, change this selection.
  319.         
  320.              Printers are handled with the Slash P "/P" command or 
  321.         switch. The possible modifiers are Question Mark "?" or a digit 
  322.         0 through 9 which allows you to work with a specific printer 
  323.         definition. The command or switch "/p?" will display information 
  324.         on all defined printers while /P# (where # is the number, 0 
  325.         through 9, of a specific printer) will allow you to work with 
  326.         that printer definition. After you press "/P#" you will be 
  327.         prompted to press "C" to change the definition, "D" to delete the 
  328.         definition or "K" to keep the definition. If you change it, you 
  329.         will be prompted to fill in each necessary item of information. 
  330.         For the page offset, you can enter "N" for No or enter a number 
  331.         of cells to use as an offset. Typing "0" will also have the same 
  332.         effect as typing "N". All printer definitions are saved as a 
  333.         part of a Local or Global Setup file. 
  334.         
  335.              As mentioned earlier, printer 0 is the default. If you are 
  336.         using any other definition for printing, you must specify 
  337.         formatting for that printer with the Slash F "/F" command or 
  338.         switch. To use this command or switch, enter "/F" followed 
  339.         immediately by a digit 0 through 9 corresponding to the desired 
  340.         printer. This information, if changed, should also be saved in a 
  341.         Setup file.
  342.         
  343.              In Section Two of this manual you will learn in detail about 
  344.         the many dot commands used to control braille formatting in BIF 
  345.         files. These dot commands can be embedded in a BIF file and/or 
  346.         added to a Setup file so that they will apply to the entire 
  347.         document. Dot commands are added with the Slash A "/A" command 
  348.         or switch and deleted with the Slash D "/D" command or switch. 
  349.         The "A" or "D" are followed immediately by any legal dot command 
  350.         including its leading period. The command Slash D* "/D*" will 
  351.         delete all dot commands from the Setup.
  352.         
  353.              The Slash W (/w) command or switch is used to control 
  354.         printing. It is followed by a number 0 through 3. At setting 0, 
  355.         no printing will take place. Setting 1 will direct output to a 
  356.         printer, setting 2 directs output to a file, and setting 3 
  357.         directs output to both a printer and a file. You will remember 
  358.         that the type of file, .BIF, .BRL or both is controlled by the 
  359.         Slash M "/m" switch or command.
  360.         
  361.              The Slash W "/w" command or switch directs output to the DOS 
  362.         PRN device. This is normally LPT1, but can be redefined with the 
  363.         Mode command. You can also print by producing a .BRL file, 
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.         exiting to DOS and using the "PRINT" command. While the "PRINT" 
  371.         command is slightly different in various versions of DOS, it is 
  372.         easy to use. You normally enter "PRINT filename" on the command 
  373.         line and the file will be printed to the PRN device. For the 
  374.         exact details on using the "Print" command, consult your DOS 
  375.         manual.
  376.         
  377.              As mentioned earlier, you can also jump over a specific 
  378.         number of pages before printing is started. This command could 
  379.         be useful, for example, if your printer malfunctioned in the 
  380.         middle of a printing job. You could re-process the input file 
  381.         telling it to start printing on the first page which was bad. 
  382.         This is done with the Slash J "/J" command or switch. The "J" is 
  383.         followed immediately by the number of the last good page. Turbo 
  384.         Braille would then jump over the number of pages specified by the 
  385.         number following the "/j" command or switch, restarting printing 
  386.         on the next page. This command can also be used to specify a 
  387.         specific page to be printed by the Demonstration Version of Turbo 
  388.         Braille . The default is 0, which means that the program does not 
  389.         jump over any pages. Remember that the command or switch "/J1" 
  390.         would jump over one page, starting printing on page two.
  391.         
  392.                                  VERBOSITY LEVEL
  393.         
  394.              There is one final command/switch in Turbo Braille. This is 
  395.         the Verbosity command which is changed with the Slash V "/v" 
  396.         command or switch. The "V" is followed immediately by a number 
  397.         in the range of 0 through 9. The default is 0. Verbosity 
  398.         controls the number and length of messages which Turbo Braille 
  399.         displays while it is running. At this time, levels 0, 1, 2 and 3 
  400.         have been implemented.
  401.         
  402.              While Turbo Braille is translating, you will hear it report 
  403.         a number regularly. The program uses an 8K buffer to handle data 
  404.         and what you are hearing is a count of buffers full of data being 
  405.         translated. While this count will help you gauge the programs 
  406.         progress, this is not a page count. As you increase the 
  407.         Verbosity level you will be given more information on what is 
  408.         happening. Experiment until you get the level you like -- you 
  409.         can't hurt anything.
  410.         
  411.                                    SECTION TWO
  412.         
  413.                                FORMATTING COMMANDS
  414.         
  415.                              RULES FOR TURBO BRAILLE 
  416.         
  417.         
  418.                        Dot Commands and Imbedded commands
  419.         
  420.              Turbo Braille, from KANSYS, Inc., is a powerful braille 
  421.         translator. It takes files produced in WordStar and WordPerfect, 
  422.         as well as regular text files, and turns them into properly 
  423.         formatted braille files, often with no extra effort from the 
  424.         person entering the data.
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.         
  432.              The formatting is accomplished by use of a number of dot 
  433.         commands--commands made up of two alpha letters preceded by a 
  434.         period. These commands center lines (.ce), skip lines (.sp), 
  435.         determine when to change to a new paragraph and indent it (.pp), 
  436.         just to name a few. The idea for these commands comes from a 
  437.         program called "Text," (by James Gillogly) a text formatting 
  438.         program for PC's. "Text" is a look-alike program for "Roff" a 
  439.         text formatter that could be found on mainframe Computers. 
  440.         
  441.              Another type of commands prominently used by Turbo Braille 
  442.         for formatting braille is the imbedded or backslash command, a 
  443.         two-character command made up of a backslash followed by a 
  444.         character such as 0, 1, 2, :, etc.
  445.         
  446.              When the data entry person has produced a WordStar, 
  447.         WordPerfect or text file, Turbo Braille should be run to create a 
  448.         ".BIF" (Braille Intermediate File)." This file will contain some 
  449.         of the dot commands and imbedded commands. It will be easy to add 
  450.         more by just entering the file and editing it. It will look 
  451.         unusual, for there are to be no added blank spaces. The dot 
  452.         commands will always begin in Column one of the line, as will all 
  453.         of the text. Your finished copy's placement will be determined by 
  454.         what commands you use.
  455.         
  456.                      Centering, Blank Lines, and Paragraphs
  457.         
  458.              CENTERING. (.ce) You are writing a document which has a 
  459.         title at the top of the page. You will, of course, want this 
  460.         title centered. Here is how it is done.
  461.         
  462.              Open the file. We'll call this file "Rules." To enter a 
  463.         ".BIF" file, you may use any ASCII Editor, such as Edlin, or the 
  464.         Nondocument Mode of WordStar. You will then enter the "insert 
  465.         mode" of that editor and type:
  466.         
  467.              .ce
  468.              RULES FOR THE USE OF TURBO BRAILLE
  469.         
  470.              Remember, the command and the title will both begin in 
  471.         Column 1 of the screen. When you have processed the file, the 
  472.         ".ce" will have disappeared, and you will see the following:        
  473.         
  474.                        RULES FOR THE USE OF TURBO BRAILLE
  475.         
  476.              If the title is too long to be centered nicely on the 
  477.         braille page, the program will divide it into two or more equal 
  478.         parts.
  479.         
  480.              Suppose I want more than one line centered? This is no 
  481.         problem. Simply enter a space following the command, then follow 
  482.         the space with a digit which indicates the number of lines to be 
  483.         centered. (This principle is used with some of the other commands 
  484.         you will see later.) It will be done like this:
  485.         
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.              .ce 3 
  493.              RULES FOR THE USE OF TURBO BRAILle
  494.              Produced by KANSYS, Inc.
  495.         
  496.              When processed, the material will be centered. If you don't 
  497.         know how many lines you will be centering, you will place a large 
  498.         number after the command--one so large that there is no way you 
  499.         could possibly be centering that many lines. Upon completion of 
  500.         the entry, the centering is terminated by typing the ".ce" 
  501.         Command followed by a 0.
  502.         
  503.              .ce 99
  504.              RULES FOR THE USE OF TURBO BRAILLE
  505.              Produced by KANSYS, Inc.
  506.              Your Sound Alternative
  507.              ... 
  508.              .ce 0
  509.         
  510.              When the braille output has been produced, all of the lines 
  511.         requiring centering will be centered, and those too long to have 
  512.         balanced centering as they are will be split.
  513.         
  514.              THE LINE SPACE (.SP). While entering data to be processed, 
  515.         it is often necessary to leave one or more blank lines between 
  516.         parts of the text, such as between the title and the body
  517.           The command used for this purpose is ".sp." Remember, when the 
  518.         data is entered and shown on the screen, it should all appear, 
  519.         along with the commands, in column 1. In our file "Rules" we have 
  520.         now entered the title:
  521.         
  522.                        RULES FOR THE USE OF TURBO BRAILLE
  523.                             PRODUCED BY KANSYS, Inc.
  524.         
  525.              Next we want to leave a blank line between the title and the 
  526.         first paragraph.
  527.         
  528.              .sp
  529.              Turbo Braille is a powerful braille translator ... .
  530.         
  531.              The document will have the title centered, a blank line, and 
  532.         the beginning of the paragraph.
  533.         
  534.              .ce 99
  535.              RULES FOR THE USE OF TURBO BRAILLE
  536.              Produced by
  537.              KANSYS, Inc.
  538.              .ce 0
  539.              .sp
  540.              Turbo Braille is a powerful braille translator ... .
  541.         
  542.              If there is to be more than one blank line between parts of 
  543.         the document, follow the command with a digit:
  544.         
  545.              .sp 2
  546.         
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.              INDENTING THE PARAGRAPH (.PP). So far we have centered the 
  554.         title and skipped a blank line between the title of the document 
  555.         and its body. However, we want the paragraph in the braille 
  556.         output file to begin in Column three. This is done by use of the 
  557.         command ".pp." When Turbo Braille is reading a file and sees 
  558.         ".pp", it automatically writes the line of text immediately 
  559.         following the command with its FIRST CHARACTER in Column Three.
  560.         
  561.              .pp
  562.              Turbo Braille is a powerful braille translator ... .
  563.         
  564.              After the ".pp" command, output would look like this.
  565.         
  566.              Turbo Braille is a powerful braille translator ... .
  567.         
  568.              MAKING AN UNFILLED LINE (.nf) or (.br). At times when 
  569.         working on a document, a data entry person doesn't want to fill 
  570.         lines. In letters, for instance, the street address, city and 
  571.         state, and date appear on separate lines; as do the lines of the 
  572.         inside address. In some word processors, such as WordStar, the 
  573.         solution to this problem is simply to enter a "hard" carriage 
  574.         return "<." However, this method does not work in Turbo Braille. 
  575.         This is true partially because there are fewer columns in the 
  576.         braille file. Therefore, there must be another method of dealing 
  577.         with the problem. This problem can be solved by one of two dot 
  578.         commands ".br" and ".nf." 
  579.         
  580.              The ".br" is entered before each line of text that you 
  581.         desire to stand alone. Therefore, it would look something like 
  582.         this:
  583.         
  584.              .br
  585.              1016 Ohio
  586.              .br
  587.              Lawrence, KS 66044
  588.              .br
  589.              August 10, 1989.
  590.         
  591.              The final copy would take out the ".br"'s in print but show 
  592.         the document correctly. This command is used when one wishes to 
  593.         respect line breaks in a short passage. If, however, there is a 
  594.         lot of material which requires that the lines not be filled, a 
  595.         ".nf" should be entered on the line before the text. Turbo 
  596.         Braille will place on the lines only as much material as is 
  597.         entered in that line of text. This will, of course, often spill 
  598.         over into more than one braille line. The ".br" and ".nf" 
  599.         commands have the affect of executing all carriage returns in the 
  600.         source document. They are used for short and long passages 
  601.         respectively. Normally, Turbo Braille ignores carriage returns 
  602.         and puts as much braille as will fit on each line. The exception 
  603.         to this rule is two carriage returns, which it turns into one .sp 
  604.         command.
  605.         
  606.              THE FILLING COMMAND (.FI) You must be wondering: If I use 
  607.         the .nf command and I then want to start filling lines again, 
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.         what do I do? There is a command to achieve this function called 
  615.         the ".fi" command. It is placed on a line by itself immediately 
  616.         before the text with which the line filling will begin.
  617.         
  618.                             Dot Commands for Margins
  619.         
  620.              We have seen how dot commands make it possible to center 
  621.         lines, skip blank lines, indent for paragraphs, cease the filling 
  622.         of lines, and resume the filling of lines. We will now consider 
  623.         the dot commands used to provide varied right margins, varied 
  624.         left margins, hanging indents, and regular indents.
  625.         
  626.              THE RIGHT MARGIN (.RM). Most of the braille printers that 
  627.         are available have a maximum line width of 40 columns on 11.5 
  628.         inch paper. Forty Columns, therefore, is the default for Turbo 
  629.         Braille. However, the time may come when you will need a narrower 
  630.         line, such as when 8.5 by 11 inch paper is being used. This is 
  631.         easily accomplished with the right margin command ".rm." The 
  632.         command is entered beginning in column 1 and is the only item 
  633.         typed on the line. It is followed by the number of the last 
  634.         column to be found on the longest possible line. It will appear 
  635.         like this:
  636.         
  637.              .rm 28
  638.         
  639.              remember, always start the dot commands in column 1 of the 
  640.         line on which they are found.
  641.         
  642.              THE LEFT MARGIN COMMANDS (.PO) (.IN). Perhaps a wider left 
  643.         margin is required. Although the Library of Congress is now 
  644.         allowing a 40 space line for transcribed materials, YOU MAY FIND 
  645.         binding more easily accomplished if two spaces are left at the 
  646.         beginning of the lines, producing a wider left margin. This is 
  647.         done with the ".in" command. This command, like the others is 
  648.         typed on a line by itself, and it will be followed by a digit. 
  649.         The command would appear as follows:
  650.         
  651.              .in 2
  652.         
  653.              Making a wider left margin can also be accomplished by 
  654.         adjusting the paper a little in the printer, or by using the page 
  655.         offset command ".po" followed by a digit.
  656.         
  657.              .po 2
  658.         
  659.              TEMPORARY INDENT (.TI) From time to time in the preparation 
  660.         of a document, it becomes necessary to temporarily change a 
  661.         margin for one line. Such instances occur in the formatting of 
  662.         documents such as outlines, in which the first braille line of 
  663.         each subdivision must be indented two spaces. Doing this is easy 
  664.         with the ".ti" command. In column 1 of a new line enter ".ti" 
  665.         followed by a space and either a digit to indicate how many 
  666.         spaces to indent, or the plus sign "+" and a digit to say the 
  667.         left margin plus a certain number of spaces.
  668.         
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.              I. Planning my trip
  676.              .ti +2
  677.             A. Making Reservations
  678.              .ti +4
  679.              1. Choose a travel agent
  680.              .ti +4
  681.              2. Determining the best time for me
  682.              .ti +4
  683.              3. Determining best rates
  684.              .ti +4
  685.              4. Flight availability
  686.              .ti +2
  687.              B. Hotel Reservations
  688.              II Making arrangements ... 
  689.         
  690.              The ".ti" command can also be used in documents in which 
  691.         material is set in several spaces but the first line of each 
  692.         segment of data is found to the left of the rest of the material. 
  693.         Using the ".in" command, the data entry person will enter the 
  694.         number of spaces the material is to be set in, then with the 
  695.         ".ti" command will set the line back the same number of spaces by 
  696.         typing .ti 0.
  697.         
  698.              .in 3
  699.              .ti 0
  700.              Truck Driver's Delight--a half pound of ground round on a
  701.         toasted sesame seed bun with mounds of fries and 
  702.         plenty of delectable garnishes on the side. $3.95.
  703.         
  704.              The command can also be formed in this way:
  705.         
  706.              .in +3
  707.              .ti -3
  708.         
  709.                         Dot Commands for Page Variations
  710.         
  711.              The standard length for a page of braille is twenty-five 
  712.         (25) lines, so Turbo Braille uses the twenty-five line page 
  713.         length as the default. However, from time to time it may be 
  714.         desirable to have a shorter page length or to force the end of a 
  715.         given page. Several dot commands are available to help in this 
  716.         kind of formatting. While discussing the manipulation of pages, 
  717.         we will also see how a dot command can be used to create a 
  718.         running head, as well as a command which will automatically 
  719.         insert print page numbers.
  720.         
  721.              CREATING A RUNNING HEAD (.RH). Often in preparing documents 
  722.         (print or braille) a running head must be provided so that each 
  723.         page will contain the document's title or something to identify 
  724.         it as part of the document. This is accomplished in Turbo Braille 
  725.         with the use of the dot command ".rh." The format for this 
  726.         command is slightly different from that which we have seen for 
  727.         the other dot commands in that it does not appear on a line by 
  728.         itself. While it is, like the others, found in column 1 of the 
  729.         line, it is followed by the material to be used as the running 
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.         head.
  737.         
  738.              .rh RULES FOR TURBO BRAILLE
  739.         
  740.              If the running head is to appear on all pages of the 
  741.         document beginning with the first page, it should appear at the 
  742.         top of the data file before any other commands. If the running 
  743.         head is not to appear on the first page, it should be entered 
  744.         after the beginning material, so long as it is not entered so far 
  745.         into the file that it affects the running head's appearance on 
  746.         subsequent pages. 
  747.         
  748.              THE INCLUSION OF PRINT PAGE NUMBERS (.PN). Often, 
  749.         particularly in the production of braille books, it is necessary 
  750.         to include not only braille page numbers, but also the 
  751.         corresponding print page numbers. This is done at the beginning 
  752.         of the file. Once the ".pn" command has been issued, the document 
  753.         will contain the first print page NUMBER, and on each page 
  754.         FOLLOWING it will contain the same page number preceded by an 
  755.         alpha letter "a" "b" "c" etc., until the print page advances one 
  756.         page. Should the print page change in the middle of a braille 
  757.         page, a row of dots 2 and 5 will appear with the new print page 
  758.         NUMBER at the end of it.
  759.         
  760.              If you wish to begin with a print page other than PAGE 1, 
  761.         you should follow the ".pn" command with the number of the print 
  762.         page.
  763.         
  764.              .pn
  765.         
  766.              .pn 30
  767.              
  768.              The program will then begin numbering the print pages with 
  769.         30, or whatever number you have inserted. 
  770.         
  771.              CHANGING THE PAGE LENGTH OF YOUR DOCUMENT (.PL) Although the 
  772.         ".pl" command is rarely used, a data entry person may find at 
  773.         some point the need to change the length of the pages of a 
  774.         document. This command would only be used if the entire document 
  775.         was to have a number of lines in EACH PAGE OTHER THAN 25. Though 
  776.         it can be placed anywhere in the file, the best place logically 
  777.         is to place it before any other data or commands in the file. If 
  778.         this is not done, it could easily be forgotten until so far into 
  779.         the file that the first page or two would have one page length 
  780.         and the rest would have the new length. The command is found 
  781.         beginning in column 1 of a line and followed by one or two digits 
  782.         to indicate the number of lines desired on each page.
  783.         
  784.              .pl 20
  785.         
  786.              .pl 9
  787.         
  788.              PREMATURELY FORCING THE END OF A PAGE (.NE) OR (.BP) Braille 
  789.         rules require that a new centered title be placed on a new page 
  790.         if it cannot be preceded by a blank line and followed by a blank 
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.         line and two lines of text. If this rule is being used in the 
  798.         processing of your braille document, it will not be possible for 
  799.         you to determine on the computer either by looking at the screen 
  800.         or using speech if the final copy will turn out that way. This is 
  801.         when the ".ne" command will come in handy. If you want to 
  802.         guarantee that you will never have the title of an article on the 
  803.         final line of your braille page, enter the ".sp" command, then 
  804.         enter the ".ne" command followed by a digit which includes the 
  805.         number of lines to be found in the title, the next blank line, 
  806.         and two lines of the paragraph following the title.
  807.         
  808.              .sp
  809.              .ne 4
  810.              .ce
  811.              Dot Commands for Margins
  812.              .sp
  813.              .pp
  814.              We have seen how dot commands make it possible to center 
  815.         lines, skip blank lines, indent for paragraphs, ...
  816.         
  817.              If it is desirable to terminate a page early, such as for a 
  818.         new topic, a new section, etc., enter the ".bp" command. This 
  819.         will cause the paper to advance to a new page. It, like most of 
  820.         the other commands we have discussed, will be on a line alone 
  821.         beginning in column 1.
  822.         
  823.                                 MORE DOT COMMANDS
  824.         
  825.              By consulting the Help facility of Turbo Braille, you will 
  826.         see that there are many other dot commands, designed to 
  827.         accomplish a variety of formatting tasks. The Help facility is 
  828.         accessed with the Slash H "/H" command or switch.
  829.         
  830.              This section of the documentation is designed to give you an 
  831.         introduction to dot commands. We will be adding to it in the 
  832.         upcoming months, as Turbo Braille grows and matures. 
  833.         
  834.              You can also learn more about dot commands by examining a 
  835.         "BIF" file produced by Turbo Braille. After all, as you will 
  836.         remember from Section One of this document, BIF files are nothing 
  837.         more than ASCII text interspersed with dot commands. 
  838.         
  839.              If you have any questions, give us a call at: (913) 843-0351 
  840.         or drop us a line at:
  841.         
  842.                                   KANSYS, Inc.
  843.                                 1016 Ohio Street
  844.                                Lawrence, KS 66044
  845.         
  846.  
  847.  
  848.  
  849.