What's new                 `      
   KEB        @ AAAAAAAAAA                                   2    KEYSOFT Demonstration program version 2.4a "What's new" file   March 1996 version 1.1         All of the material in this file is also available in KeySoft     format. If you already have a version of KeySoft, either exit     this program and use KeySoft to read the files on the floppy     disk, or install and run the demonstration program by putting the     disk in your A: drive and typing A:INSTALL. Then read the "What's    	 new" file. If you don't have a current version of KeySoft, load    
 the demonstration program by putting the disk in your A: drive     and typing A:INSTALL. Then read the "What's new" file.     
    Contents      1. New Features in KeySoft version 2.4a   2. New Features in KeySoft version 2.3   3. Additional Information for KeySoft Version 2.3   4. Additional Information for KeySoft Version 2.4a         1. New Features in KeySoft version 2.4a      As well as still supporting all current models of Keynote GOLD     synthesizers, KeySoft version 2.4a now supports DECtalk     synthesizers. The models supported are the DECtalk Express     external speech synthesizer and the DECtalk PC internal speech     synthesizer (DECtalk is a trademark of Digital Equipment     Corporation).      KeySoft version 2.4a also has some additional script commands not      documented in the users' manual and not listed below in section    ! 3. of this document, "Additional Information for KeySoft Version    " 2.3". These are listed below in section 4. of this document,    # "Additional Information for KeySoft Version 2.4a".  $   % Apart from these changes, KeySoft version 2.4a is identical to    & version 2.3.  '   (   ) 2. New Features in KeySoft version 2.3  *   + This summary will be useful if you are already familiar with    , KeySoft version 1.3, and want an overview of the new features in    - KeySoft version 2.3. In general, all the existing options have    . been preserved, and many significant additions have been made.    / The way in which KeySoft works has not been changed, so many    0 commands in the new functions will be familiar to you. In    1 particular, the use of the keyboard triplets centred on the    2 comma, K, I, and 8 keys has been extended.  3   4 a) Main menu.  5   6 The KeySoft main menu has been altered to accommodate the new     functions. The word-processing options of editing, printing and    file commands were in the main menu, but these have now been    grouped into a sub-menu under the heading of "word-processor".    The Calculator can now be accessed from the main menu, and there    are three new options: Diary, Address List, and Keyboard Learn.    b) Wordprocessor.   	 KeyWord retains all its features, and has a number of   
 enhancements. In particular, the Block Menu now operates on a    cut-and-paste basis. For example, copying a block now involves    two steps, namely copying the marked block to the clipboard, and   
 pasting the clipboard to its destination. This consistent process    is not restricted to KeyWord, so you may copy or move text    between all parts of KeySoft. For example, you may copy a    person's name and address from KeyList and paste it into a    wordprocessor document.    A block may still be marked by placing Top and Bottom markers,    but there are now quick keys for automatically marking the    current word, sentence or line, and paragraph or 10 lines.    c) Diary.    KeyPlan is a page-per-day diary, which allows you to make notes    and reminders for each day of the year. You may enter    appointments for particular times, reschedule them, and include    an audible alarm with any appointment. On a portable computer    which is suitably configured, the alarm can sound even when the    machine is switched off.     d) Address List !  " KeyList is an address list manager. It allows you to enter   # addresses, phone numbers and other data against a person's name.   $ You may review and edit the information, sort it, and copy it to   % the Wordprocessor or Diary. If you have a modem, you may use   & KeyList to automatically dial a phone number from the list. '  ( e) Communications. )  * KeyTerm is the powerful new communications section of KeySoft. It   + allows you to connect your computer, through a telephone line, to   , a wide range of information services, electronic mail networks   - and bulletin boards. Your computer can also act as a terminal   . directly connected to a host computer. As well as accessing   / computer systems, KeyTerm can establish a voice call by   0 automatically dialing a person's telephone number for you. 1  2 The original communications option, which allowed file transfers,   3 has been moved from the main menu to the Utilities sub-menu. It   4 is accompanied by a useful new option called Interlink, which   5 allows disk files and parallel ports to be shared between your   6 computer and another to which it is connected.      f) Keyboard Learn.    KeySoft is not restricted to a particular type of computer, so a    mode is available in which the name of a key is spoken when you    press it. This is available at the Main Menu, and allows you to    explore an unfamiliar keyboard. Key announce mode is still    available to speak the functions of keys at any point within    KeySoft.   	 g) Carousel. 
   You may access the word-processor, calculator, diary, address    list, and communications directly, by pressing F4, F5, F6, F7,   
 and F8, respectively. For example, you may switch from the    Wordprocessor to the Diary, and then return to the same point in    your document. This is called the "Carousel" function, and allows    you to move easily and quickly around KeySoft without having to    re-start the various current functions.    h) Minor changes.    The "Write Defaults to Disk" option has been removed and your    settings are now saved automatically. The spelling dictionary now    allows the language to be selected. Navigation of disk    directories has been made easier, and you can move to a parent    directory with UP ARROW, or with the DOS convention of PERIOD    PERIOD ENTER. You may also review and edit entries at prompts.      3. Additional Information for KeySoft Version 2.3    The following information is about features that were added after     the users' manual was printed so do not appear in the users'   ! manual. "  #  $ a) Inserting the Time %  & The time may be inserted in a document by pressing CTRL with F4. '  (  ) b) Announcement of Disk Name. *  + When the floppy drive is selected at a "Drive?" prompt, KeySoft   , will announce the disk name, if the floppy disk has been named.   - This is a useful aid in verifying that you have the correct disk   . in the drive. If a hard disk is selected, the name is not   / announced. 0  1  2 c) Editing at a Prompt 3  4 In previous versions the only editing commands available at   5 prompts were backspace and the REPEAT key. Now the following   6 commands are available:      Character left, current and right: READ with M, ',', or '.'  Word left, current or right: READ with J, K or L  Read whole entry: READ with I  Delete character under cursor: CTRL with ','  Delete word under cursor: READ with K  Delete character before cursor: CTRL with M      d) Editing the Default entry 	  
 Sometimes the entry you wish to make at a prompt is very similar    to the offered default and instead of retyping the whole entry    you simply want to edit the default setting. You may now do this   
 by typing one of the prompt editing commands as the first entry    at the prompt. The default setting will appear under the cursor    and you can read and edit it using any of the above commands.    When you are happy with your entry, press the Enter key.      e) Checking the Remaining Number of Installs    As explained in the manual, KeySoft has built-in copy protection    which allows it to be installed up to three times. If you want to    check the number of installs remaining, you may do this from the    Utilities Menu by pressing CTRL with R. Follow the spoken    instructions.    You may also check the number of remaining installs from DOS by    inserting your KeySoft System disk in a floppy drive, log onto    the drive and type:    KSCHECK A    ! where A is the drive letter of the KeySoft System disk. The   " number of installs remaining will be displayed on the screen. #  $  % f) Battery Indicator When Running Under Windows &  ' The READ with ESCAPE key combination is used by Windows to switch   ( tasks and is therefore not available for the Battery Indicator   ) function when KeySoft is run under Windows. The Battery Indicator   * can also be accessed by pressing READ with F3. Use this   + combination under Windows. ,  -  . g) KeyPlan Alarm /  0 An option in the KeyPlan Setup list allows you to choose whether   1 KeyPlan's alarm sounds through the speech synthesizer's speaker,   2 the PC's speaker, or both. Initially both speakers are enabled.   3 Choose the option which suits you best.  4  5  6 h) The KeyPlan Directory      An option in the KeyPlan Menu, allows you to change the directory    in which the diary files are kept. Usually you would not want to    change this directory, but if you have both a desktop PC and a    laptop, you may want to keep your diary on the laptop for    portability and access them via InterLink when you are using your    desktop PC. See the relevant sections in the manual for the use    of InterLink.     	 i) Template Files 
   In addition to using the @ sign to control whether blank lines    are included, part of a line can be marked in a similar way by   
 using braces. If a section of text contains no letters or numbers    between braces, it will be suppressed when the template file is    used. If there is at least one letter or number between the    braces, all the text will be included. The braces will not appear    in the copy. For an example of the use of braces, see the    "Letterhead Template" file in the KeyList directory.      j) KeyTerm's Freeze Mode    The READ key is optional in Freeze mode. For example, to move    forward word by word, you may press either READ with L or just l    on its own.      k) KeyTerm's On-line mode    You may read the top line of the screen by pressing READ with T.     You may read the bottom line of the screen by pressing READ with   ! B. "  # A new option in KeyTerm's On-line mode will ring a bell when the   $ cursor passes a nominated column during typing. This option is in   % the Directory of Services. It is useful when working with on-line   & editors which do not have automatic word-wrap. '  (  ) l) Uninstalling KeySoft from DOS *  + The usual and best way to uninstall KeySoft is to use the U   , option of the Utilities Menu and this should be used whenever   - possible. However, if for some reason you cannot run KeySoft you   . can uninstall it from DOS. This must be done before reinstalling   / it so that you do not lose one of your 3 installs. To uninstall   0 KeySoft from DOS, proceed as follows: 1  2 1. Log onto the directory of your hard disk drive where KeySoft   3 resides. This will usually be C:\KEYNOTE. 4  5 2. Insert your KeySoft System disk in a floppy disk drive. Ensure   6 that the write-protect tab is in the unprotected position. If it     is in the protected position or if it is the wrong disk, you will    lose one of your three installs.    3. Type UNINSTALL C A Enter, where C is the drive letter of the    hard disk drive on which KeySoft is installed and A is the floppy    disk drive in which you have inserted the KeySoft System disk.    The uninstall will proceed and you will be returned to DOS.   	  
 m) New Script File commands    Version 2.3 contains a number of script file commands which are   
 not in the manual. These are as follows:    ErrorBeep. - Makes KeySoft emit its error beep.    WaitFor  WaitIf and  WaitEnd - These commands are used to create a "WaitFor" loop.    This is similar to a Wait command except that instead of waiting    for just one string, a WaitFor loop waits for one of any number    of strings to be received. A different action can be taken on    receipt of each string. The time which KeyTerm will wait for    receipt of one of the strings is specified as part of the WaitFor    command. When this time expires, the next command after the    WaitEnd command is executed.    A WaitFor loop starts with a WaitFor command which is followed by    the time, in seconds, which KeyTerm is to wait to receive one of    the strings.     One or more WaitIf commands follow the WaitFor command on   ! separate lines. Each WaitIf command specifies a string and a   " command to be executed if the string is received. The string must   # be enclosed in double quotes. $  % The WaitFor loop is terminated by a WaitEnd command. &  ' Here is an example of a WaitFor loop: (  ) login_loop: * WaitFor 10 + WaitIf "host name" goto host_name_handle , WaitIf "password" goto password_handle - WaitIf "user id" goto user_id_handle . WaitIf "welcome" goto finished_login / WaitEnd 0 crt Could not log in to service 1 exit 2 host_name_handle: send xyz 3 goto login_loop 4 etc. 5  6 End of example.         SetX - Initializes the variable "x" to the specified value.    DecX - Decrements variable "x".    IfXZero - This is followed by a command to execute if variable    "x" is zero.     Here is an example of the use of SetX, DecX and IfXZero:    	 SetX 10 
 logon_loop:  call logon  DecX 
 IfXZero goto logon_fail  goto logon_loop  logon_fail:  crt Tried to logon 10 times but failed.    End of example.      ScreenTimeOut - This command is followed by a number between 1    and 20 which specifies the time KeyTerm will wait after receiving    a character before assuming that the transmission has ended. If    this time expires before another character is received, KeyTerm    will speak the last text received or respond to the last cursor    movement key pressed, etc. The best setting depends on the    responsiveness of the host computer. The shorter the time, the    more responsive KeyTerm will feel, but if the time is too short    for the host computer, KeyTerm may speak before the transmission    has ended.     ArrowKeyResponse - This command is followed by N for ON, or F for   ! OFF. This controls whether or not KeyTerm reads the new character   " or line under the cursor after an arrow key has been pressed. If   # the program you are using uses highlighted bar menus, set the   $ ReadingOption (see below) to Inverse and the ArrowKeyResponse off   % and KeyTerm will read the menus. &  ' ReadingOption - This command is followed by a single letter   ( specifying the type of text KeyTerm is to read. An "A" specifies   ) All text. An "I" specifies Inverse video text only. ReadingOption   * applies only to the VT100 and ANSI terminal types. The   + ReadingRestrictions option must be ON for this command to take   , effect. See below. -  . SilentLine - This command is followed by a screen line number.   / When a line has been silenced, any text entered into that line in   0 On-Line mode is not spoken. Any number of lines may be silenced   1 by using several SilentLine commands, for example: 2  3 SilentLine 1 4 SilentLine 24 5  6 will silence both the top and bottom lines of the screen.       Silent lines are subject to the ReadingRestrictions control. See    below.    SilentLine C, cancels all previous SilentLine commands.    ReadWith5  ReadWith6  ReadWith0 - This commands configures KeyTerm to read a specified    line number when READ with 5, Read with 6, or Read with 0 is   	 pressed. For example: 
   ReadWith5 1   
 configures KeyTerm to read line 1 when Read with 5 is pressed.    ReadingRestrictions - This command is followed with either N for    ON, or F for OFF. It is a master control for the other commands    which impose reading restrictions, namely, ReadingOption and    SilentLine. ReadingRestrictions F disables reading restrictions    and KeyTerm reads all received text. The reading restriction    settings are not reset, however, and may be enabled again at any    time. ReadingRestrictions N enables reading restrictions. Reading    restrictions can be also turned on or off in on-line mode by    pressing READ with R.      4. Additional Information for KeySoft Version 2.4a    The following script file commands were added after the users'    manual was printed so do not appear in the users' manual.    ReadWith8Range - Takes two parameters separated by commas     specifying the top and bottom of the range of lines to read when   ! READ with 8 is pressed in COLUMN access mode (the default). "  # The following commands are designed to be used when the speaking   $ of all received text has been turned OFF by either the READ with   % S command or the OFF script command.  They cause KeyTerm to   & examine the screen after each transmission has ended and read   ' only the information the user is particularly interested in, for   ( example a new prompt or a highlighted bar etc. )  * AutoPrompting - This is followed by either ON or OFF.  With this   + option ON, if a prompt is displayed it will be read. , Basically this option sees if the word before the cursor word or   - cursor highlighted bar ends with a question mark or a colon and   . if so, assumes that the cursor is in a prompt and reads it.  The   / punctuation set used to determine if the cursor is in a prompt   0 can be defined by the user.  See the AutoPromptChars command   1 below. 2  3 AutoPromptChars - This command defines the punctuation characters   4 which are used to determine if the cursor is in a prompt.  The   5 default set contains two characters, the question mark and colon.    6 The character set must be enclosed in double quotes.  Up to 5     characters can be specified.    StatusLine - This is followed by a single line number.  To define    more than one line as Status Lines, use several separate    StatusLine commands.  To clear all existing status lines,  follow    the StatusLine command with a C.  Often a particular line on the    screen is used to display status messages, error messages,    temporary progress messages, etc.  Nominating a line as a status    line will cause the line to be read if it changes.  Status lines   	 have the lowest reading priority and only read if no highlighted   
 bar or autoprompt has been read.    BarTracking - This command switches on or off the option which   
 tracks highlighted bars. Follow the command with either ON or    OFF. There are a number of options involved with this mode. These    all start with Bar... as follows:    BarAttribute - Defines the particular attribute which identifies    the bars which are to be tracked. Parameters are as follows:  Inverse  Underline  Bold    BarTrackingArea - Takes two parameters separated by commas.    Defines the range of lines in which bar tracking is to take    place.  Follow the command with the lowest and highest lines    separated by commas, for example:   BarTrackingArea 1, 23    BarCursorPriority - Follow this command with ON or OFF.  If ON    and the cursor is in a highlighted bar, KeyTerm will read that    particular bar in preference to any other highlighted bars on the     screen.  !  " BarAsCursor - Follow this command with ON or OFF.  Use this   # option in cases where the cursor is parked at, say the bottom   $ corner of the screen, and the user drives a highlighted bar   % around with the arrow keys.  With BarAsCursor ON, review   & commands, for example READ with I, will read relative to the   ' highlighted bar rather than relative to the cursor's useless   ( position.  )  * BarConnectBelow - Follow this command with ON or OFF.  When OFF,   + KeyTerm will not consider the possibility that a highlighted bar   , may extend over more than one line.  When ON KeyTerm will read   - subsequent lines if the highlight appears to extend to these   . lines. /  0 BarConnectLeft - Follow this command with ON or OFF.  When ON,   1 KeyTerm will read any word immediately connected to the left of   2 the bar but not highlighted. For example, Lynx has an option   3 which numbers all HyperLinks for easy reference. The numbers are   4 displayed in square brackets to the left of the highlighted bars.   5 Turning this option on will read such numbers. 6 	   NewTXCutOff - This command takes a line or a range of lines as a  	  parameter.  Because of the delays inherent in communication over  	  networks like the Internet, a statement of progress is often  	  displayed on a particular line of the screen.  If there are no  	  substantial delays the progress report changes very rapidly and  	  the requested information is soon on the screen.  In such cases  	  the user does not want to hear each progress report because it  	  holds up reception of the information she has requested.  If,  	  however, a delay does occur, the user may be left wondering what  	 	 is happening or if she did actually complete the last keyboard  	 
 entry correctly, etc.  The solution to this is to nominate the  	  line where this progress information appears as a Status Line and  	  also to nominate it as a NewTXCutOff line.  This causes the  	 
 status information to be spoken if it remains static briefly, but  	  if a further transmission occurs while speech is taking place,  	  the speech is instantly cut off and the new transmission is  	  processed.  	  	  To reset this option use a C as a parameter.	  	  EndofTXBeep - Parameter is ON or OFF.  Turning this ON causes a  	  short beep to sound after each transmission if nothing else has  	  been spoken.	  	  Two Script files supplied with this demonstration version of  	  KeySoft give examples of the use of the above commands.  They are  	  designed to be used with the Lynx Internet browser in its  	  Advanced and Novice user modes.	  	  End of document	  