home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / screen / highlite.arj / HIGHLITE.DOC < prev    next >
Encoding:
Text File  |  1992-01-12  |  15.0 KB  |  318 lines
  1.  
  2.  
  3.  
  4.         
  5.         
  6.                                         
  7.         
  8.         
  9.         
  10.         
  11.         
  12.         
  13.                                     HIGHLITE
  14.         
  15.         
  16.                             Another Sound Alternative
  17.         
  18.         
  19.         
  20.         
  21.         
  22.                                    USERS GUIDE
  23.         
  24.                                   January, 1992
  25.         
  26.         
  27.         
  28.         
  29.         
  30.         
  31.         
  32.         
  33.         
  34.         
  35.                                Copyright (c) 1992
  36.         
  37.                               All rights reserved.
  38.         
  39.                                        by
  40.         
  41.                                   KANSYS, Inc.
  42.         
  43.                                   1016 Ohio St.
  44.         
  45.                                Lawrence, KS 66044
  46.         
  47.         
  48.         
  49.         
  50.         
  51.                      Telephone: 913-843-0351 or 800-279-4880
  52.         
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.         
  60.                                    USERS GUIDE
  61.         
  62.                                   January, 1992
  63.         
  64.         
  65.                                   Introduction
  66.         
  67.              A blind student whom I know was convinced that she was 
  68.         inferior to other students because she was unable to "highlight" 
  69.         important passages in a textbook the way her friends did. To 
  70.         "highlight" a book is to disfigure it by discoloring interestingt 
  71.         passages slightly with a felt tipped pen or "magic marker" so 
  72.         that they will later catch your eye when reviewing the material. 
  73.         How does one "highlight" audio tapes or braille books? The answer 
  74.         is not obvious.
  75.         
  76.              As more and more blind students and other persons turn to 
  77.         the personal computer for their reading, writing, and information 
  78.         needs, a marking facility similar to highlighting would be 
  79.         useful. How can one "highlight" an interesting phrase, an 
  80.         important sentence, a relevant passage, or a puzzling column of 
  81.         numbers displayed on a computer screen for later reference? The 
  82.         KANSYS, Inc. HighLite utility is designed to perform that task.
  83.         
  84.              HighLite is a small program for IBM compatible Personal 
  85.         Computers that is run once when your computer starts up, and 
  86.         remains available in the background thereafter. As you proceed 
  87.         with your work and notice something memorable on the screen, you 
  88.         "bring up" HighLite with the press of a hotkey combination, move 
  89.         the cursor to one end of the desired passage and mark it, then 
  90.         move it to the other end, press the enter key, and the passage is 
  91.         copied to a clipping file in your current directory. Each 
  92.         repetition of this process adds additional clippings to the file. 
  93.         If you change directories, a new clipping file will be created 
  94.         there also, when you first bring up HighLite to mark and preserve 
  95.         information.
  96.         
  97.                                    Description
  98.         
  99.              The HighLite program requires only 6k of your computer's 
  100.         memory, and in fact if your computer has expanded memory, only 1k 
  101.         of conventional memory is used. It does not modify the display 
  102.         screen or any of your files in any way. All its messages are 
  103.         "beeps" produced in the PC speaker. It is "brought up" and "put 
  104.         down" with a hotkey which may not be changed by the user. The key 
  105.         is the control-underscore combination (^_). It is easy to 
  106.         remember that control-underscore is used to highlight passages on 
  107.         the screen, saving them in a clipping file. The file is called 
  108.         CLIPPING.BOX, and again the user may not modify that name. Of 
  109.         course it may be copied to another file or renamed later if 
  110.         desired, but HighLite will always look for a file called 
  111.         CLIPPING.BOX to put its clippings in, and create one if it cannot 
  112.         find one in the current directory. HighLite will never delete a 
  113.         clipping file; you must do that yourself.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.         
  121.              The sounds made by HighLite to guide user input are of three 
  122.         different tones: high, medium, and low; in this manual we shall 
  123.         call them beep, bop, and boop, respectively. When you press the 
  124.         hotkey to bring up HighLite, you will hear a rising sequence of 
  125.         tones: boop bop beep; when you press it again to put it down, you 
  126.         will hear a falling series: beep bop boop. While the program is 
  127.         activated, the following commands are available:
  128.         
  129.              (1). Arrow keys (Left, Right, Up, Down). These keys move the 
  130.         HighLite cursor in the expected direction. When in column one and 
  131.         you press left arrow, you hear bop beep and the cursor moves to 
  132.         column 80 of the line above. When you are in column 80 and you 
  133.         press right arrow, you hear bop boop and you are in column one of 
  134.         the line below. You may use either the arrow keys on the numeric 
  135.         keypad or the separate cursor keys if available on your keyboard.
  136.         
  137.              (2). Control-Left, Control-Right. These keys move the cursor 
  138.         to the start of the previous or the next word, just as they would 
  139.         in a word processor. A "word" is defined as any continuous 
  140.         sequence of non-blank characters. If the HighLite cursor moves to 
  141.         another line while searching for a previous word or a next word, 
  142.         you will hear bop beep or bop boop. You may use control-left or 
  143.         control-right either on the numeric keypad or on the separate 
  144.         cursor keys.
  145.         
  146.              (3). Home, End. These keys move the cursor to the left end 
  147.         or to the right end of the current line, respectively, and say 
  148.         bop. If already located there, they move the cursor to the top 
  149.         left corner or the bottom right corner of the screen, 
  150.         respectively, and say bop beep, or bop boop. You may use home or 
  151.         end either on the numeric keypad or on the separate special 
  152.         keypad if available.
  153.         
  154.              (4). Page-Up, Page-Down. These keys move the cursor to the 
  155.         top of the screen or to the bottom of the screen without changing 
  156.         the horizontal location of the HighLite cursor. You may enter 
  157.         these keys either on the numeric keypad or on the separate 
  158.         special keypad if available.
  159.         
  160.              (5). Function keys F1, F2, F3. These keys mark one end of 
  161.         the desired selection. Function key F1 is used to mark one end of 
  162.         a string of characters, F2 is used to mark one end of a set of 
  163.         whole lines, and F3 is used to mark one corner of a rectangular 
  164.         area of the screen. The other end of the string of characters or 
  165.         the set of lines, or the diagonally opposite corner of the 
  166.         rectangular area, are marked either with the enter key or with 
  167.         the shifted versions of F1, F2, or F3, as explained later. You 
  168.         may mark either end of the passage or any corner of the rectangle 
  169.         with the appropriate function key. You may change the location of 
  170.         the marked end of the selection simply by moving the cursor and 
  171.         retyping the same key. These keys will say beep when pressed.
  172.         
  173.              (6). Enter. This is the action key, which saves a marked 
  174.         selection to the clipping file. If you have marked one end of the 
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.         selection with function key F1, F2, or F3, then moved the 
  182.         HighLite cursor to the other end, you may complete the marking 
  183.         and save the selection by simply pressing the enter key. You will 
  184.         hear beep beep beep and existing marks will be removed. If you 
  185.         have not yet marked one end of a selection, the enter key does 
  186.         nothing. You may use the enter key either on the numeric keypad 
  187.         or on the main keyboard.
  188.         
  189.              (7). Escape. This key cancels a marking which you have begun 
  190.         but do not wish to complete. For example, if you select the start 
  191.         of a string of characters with F1 but then decide you should be 
  192.         marking a set of whole lines instead of a string of characters, 
  193.         you must first press escape before you can press F2. Selecting 
  194.         one of the three function keys makes the other two unavailable 
  195.         until you either complete the process you have begun by pressing 
  196.         the enter key, or cancel it with the escape key.
  197.         
  198.              (8). Function keys Shift-F1, Shift-F2, Shift-F3. These keys 
  199.         allow you to mark the other end of a string of characters, the 
  200.         other end of a set of lines, or the diagonally opposite corner of 
  201.         a rectangular screen area, without simultaneously saving it to 
  202.         the clipping file. You may want to do this in order to double 
  203.         check the boundaries of your selection before proceeding with the 
  204.         save. The shifted function keys are therefore optional. The enter 
  205.         key will eventually have to be pressed in order to complete the 
  206.         saving of the selection marked with the plain and the shifted 
  207.         function keys. These keys also say beep when pressed. 
  208.         
  209.              (9). Equals. This key says bop and must be followed by a 
  210.         second keystroke to reposition the HighLite cursor to a 
  211.         previously marked position. The very next keystroke must be a 
  212.         plain or a shifted F1, F2, or F3, or a second press of the equals 
  213.         key. For example, if you have marked the beginning of a string of 
  214.         characters with F1 and later want to return your cursor to that 
  215.         same position, you do so by pressing equals followed by F1. If 
  216.         you have not already pressed a function key, the function keys 
  217.         will not respond. If you follow a press of the equals key with a 
  218.         second press of the equals key, the HighLite cursor will be moved 
  219.         to the position of the true system cursor. The second keystroke 
  220.         says beep if the cursor is repositioned, or boop boop boop if you 
  221.         make an error.
  222.         
  223.              (10). The Digits (0, 1, 2, 3, 4, 5, 6, 7, 8, 9. These keys 
  224.         may be entered either on the main keyboard or on the numeric 
  225.         keypad, in a two key sequence, to move the HighLite cursor to the 
  226.         left end of the desired screen line. You would enter 01 for the 
  227.         top line and 25 for the bottom line. The two digit sequence says 
  228.         bop beep. An error says boop boop boop.
  229.         
  230.              (11). Control Underscore (^_). This combination of keys 
  231.         makes the HighLite program dormant or inactive. It does not 
  232.         "terminate" the program in the usual meaning of that term; there 
  233.         is no way to do that. Please note that you must press CTRL and 
  234.         hold it down while you press underscore. You do not need to 
  235.         include the shift key to obtain this combination. The underscore 
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.         and the minus share the same key on the top row of the main 
  243.         keyboard, but the minus is usually also available on the numeric 
  244.         keypad, in which location it is not combined with underscore. The 
  245.         key you must use is the one in the top row of keys on the main 
  246.         keyboard.
  247.         
  248.              (12). All other keystrokes are errors, and if you press one 
  249.         you will hear boop boop boop.
  250.         
  251.                               Command Line Options
  252.         
  253.              When the HighLite program is run with no options given on 
  254.         the command line, two actions take place which you may wish to 
  255.         suppress. One action is to search for the presence of expanded 
  256.         memory on your computer, and to use one block of it (16k) if it 
  257.         is available. The size 16k is the minimum amount of memory that 
  258.         can be assigned by DOS to a requesting program. HighLite will 
  259.         require only 1k of conventional memory if expanded memory is 
  260.         available. If it is not available, or if you prefer not to use it 
  261.         for HighLite, it will require only 6k of conventional memory. To 
  262.         suppress the use of expanded memory, include the switch /C (or 
  263.         /c) on the command line.
  264.         
  265.              The other action you may wish to suppress is the activity of 
  266.         the now famous KANSYS, Inc. "WatchDog" buzzing speaker. By 
  267.         default, the HighLite WatchDog begins buzzing (or growling) in 
  268.         the PC speaker when a selection is first marked. The buzzing 
  269.         stops when you have pressed enter, escape, or exited HighLite 
  270.         with the hotkey, control-underscore (^_). It is recommended that 
  271.         you use the WatchDog for a while until you become accustomed to 
  272.         the operation of the program. If you wish to suppress (or muzzle) 
  273.         the WatchDog, include the switch /Q (or /q) on the command line 
  274.         when HighLite is run.
  275.         
  276.                                    Limitations
  277.         
  278.              HighLite will not work in a graphics environment such as 
  279.         Windows 3.0 or the OS/2 Presentation Manager. It requires 80 by 
  280.         25 character text mode displays. Screens of different dimensions 
  281.         are not presently supported by HighLite.
  282.         
  283.              The HighLite program is available in a demonstration version 
  284.         which is fully functional to a limit of saving 25 clippings. In 
  285.         order to obtain another set of 25 saves, your PC must be 
  286.         restarted and the program executed again. The permanant version 
  287.         of HighLite offers an unlimited number of saves.
  288.         
  289.              The KANSYS, Inc. software installation program, KINSTALL 
  290.         V2.1 or later, is used to install the software on your computer. 
  291.         If you have a demo version you can also simply copy the file 
  292.         HIGHLITE.COM to your computer. The KINSTALL program must be used 
  293.         if your version is a permanent copy, since only your copy of 
  294.         KINSTALL can convert a demo copy to a permanent copy with your 
  295.         user identification included.
  296.         
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.              KINSTALL will not modify your AUTOEXEC.BAT file to provide 
  304.         for automatic program loading upon startup. You must do that 
  305.         manually. If you use other TSR programs and have difficulty 
  306.         making HighLite work properly, experiment with the relative 
  307.         position of the HighLite program command line within your 
  308.         AUTOEXEC.BAT file. HighLite daisy chains on three interrupts: INT 
  309.         8 (IRQ0, the system clock), INT 16H (keyboard service requests), 
  310.         and INT 2FH (the DOS multiplex service). While every effort has 
  311.         been made to provide a "well behaved" TSR program, it has not 
  312.         been possible to test HighLite in all system configurations, and 
  313.         yours may be unique.
  314.         
  315.  
  316.  
  317.  
  318.