home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / wp / wpb12.zip / READ.ME < prev    next >
Text File  |  1993-08-01  |  61KB  |  1,083 lines

  1.  
  2.                    The WordPerfect Braille and speech Interface Keyboard     1
  3.                                        Version 1.2
  4.                                     August 1, 1993
  5.  
  6.  
  7.  
  8.           Introduction
  9.  
  10.                My favorite word processor of all time has always been
  11.                WordPerfect.  I started using it with version 4.1 when it
  12.                was really small and fast.  Now version 6.0 is here.  It is
  13.                much bigger and somewhat slower on 286 machines, but what
  14.                power!
  15.  
  16.                When I had heard that WP was working on this product, I
  17.                became concerned about the possible ramifications for blind
  18.                users.  I contacted them and they put me on their beta team.
  19.  
  20.                My first impression of the product was fear.  I had become
  21.                accustomed to the look and feel of WordPerfect.  I loved
  22.                those full screen menus, those menu driven help screens, and
  23.                the nice prompts for deleting blocks of text at the bottom
  24.                of the screen.  Those are no longer here.  The product looks
  25.                and feels much different for a blind user.  The character
  26.                mode they talk about when you call is much different than
  27.                the old 5.0/5.1 interface. 
  28.  
  29.                Even so, I think that WordPerfect 6.00 is much better for    
  30.                speech and braille.  Good going WordPerfect Corporation!
  31.  
  32.                This sent me on a mission to conquer the great WP 6.0!  This
  33.                document along with the keyboard files provided is the
  34.                partial answer to my mission.
  35.  
  36.                This document is intended for those with good experience in
  37.                configuring applications.  It is not meant to be a guided
  38.                tour on how to configure WordPerfect 6.0.  Consult the
  39.                vendor of your access technology to see if they have
  40.                developed a configuration for WordPerfect 6 yet.  If not,
  41.                send this package to them to assist them in developing that
  42.                configuration.  Every little bit helps in this industry.
  43.                 The WordPerfect Braille and speech Interface Keyboard     2
  44.                                        Version 1.2
  45.                                     August 1, 1993
  46.  
  47.  
  48.  
  49.           Legal Stuff
  50.  
  51.                WordPerfect is a trademark of WordPerfect corporation.
  52.  
  53.                Jaws (Job Access with Speech) is a trademark of Henter-
  54.                Joice.
  55.  
  56.                ARTIC business Vision is a trademark of Artic Technologies.
  57.  
  58.                Vocal-Eyes is a trademark of GW Micro.
  59.  
  60.                I have spent a great deal of time developing this keyboard
  61.                definition file. This product will be continually upgraded. 
  62.                It is my intent to provide a new interface than the current
  63.                design that WordPerfect has implemented.  I will be
  64.                tailoring the interface specifically for braille and speech
  65.                users.  I am not saying that the default interface is bad,
  66.                but some minor changes can make it even better for speech
  67.                and braille.  All of this will be done with the power and
  68.                flexibility of the WordPerfect macro language.
  69.  
  70.                If you continue to use this product after 30 days a
  71.                registration fee of 12 dollars is required.  Registrations
  72.                will be used to defray the cost of distributing the product
  73.                on electronic bulletin boards and other means.  Once you
  74.                registration, a diskette with the latest version of WP BASIK
  75.                will be sent to you.  The shareware messages will be removed
  76.                as well.
  77.  
  78.                If you are an access technology vendor, and you would like
  79.                to incorporate this keyboard file into your product, please
  80.                contact me.  I have no problems with this but would
  81.                appreciate it if you would mention how this was obtained in
  82.                your documentation.  You must also mention the fact that
  83.                this is shareware and that if the customer is to continue to
  84.                use it, he/she must register it.  Please contact me as new
  85.                versions will be made quickly.  I would also like to discuss
  86.                how you will implement this in your application.
  87.  
  88.                I will be keeping a list of vendors who have incorporated
  89.                this keyboard file into their product.  Any configurations
  90.                that have been developed for your screen reader would be
  91.                helpful if you would be willing to pass them along.  I will
  92.                maintain a library of these configurations.  I would like to
  93.                include them in this package so users have instant access to
  94.                the configuration files.
  95.                 The WordPerfect Braille and speech Interface Keyboard     3
  96.                                        Version 1.2
  97.                                     August 1, 1993
  98.  
  99.  
  100.  
  101.           What did I Find?
  102.  
  103.                1.   The menus
  104.                     One of the greatest changes in WP 6.0 is its new menus. 
  105.                     Overall, the new menus place the system cursor on the
  106.                     highlighted menu mnemonic letter, making it even easier
  107.                     to use than 5.1 was.  The only problem is that the
  108.                     document stays on the screen surrounding the menu
  109.                     itself.  Now you will hear parts of the document if you
  110.                     read the whole line while on a menu item!
  111.                2.   Deleting of Codes
  112.                     One of the nicest things about 5.1 was that when you
  113.                     deleted a code from a document, you got a prompt at the
  114.                     bottom of the screen asking if you really wanted to do
  115.                     that (assuming reveal codes was not on).  WordPerfect
  116.                     now pops up a dialog window asking you the same
  117.                     question.  This presents a little more of a challenge
  118.                     for configuring this little window to speak
  119.                     automatically.  Most screen readers will make this a
  120.                     piece of cake, but others that are not as advanced will
  121.                     make it difficult to configure.
  122.                3.   The help system
  123.                     I love online help.  I feel that every computer product
  124.                     should have it and it should work really well. 
  125.                     WordPerfect changed their help system to a hypertext
  126.                     help system.  You will now have to point at items with
  127.                     a cursor key and press <ENTER> on them to get them to
  128.                     come up.  This will be the most difficult challenge in
  129.                     configuring WordPerfect 6.0.  If you configure your
  130.                     speech system to track a menu bar while in help, you
  131.                     will make it work.  the only problem in using help is
  132.                     when you use the up/down arrow and scroll the help
  133.                     window.  If your screen reader will allow you to
  134.                     monitor portions of the screen and only speak those
  135.                     areas that change, you are in luck.  Most newer
  136.                     versions of adaptive screen reading technology have
  137.                     this ability.
  138.                4.   Crowding up the Dialog Menu
  139.                     With the release of WordPerfect 6.0, WordPerfect has
  140.                     introduced new text dialog menus.  I love them, BUT! 
  141.                     There are a few that have more than one column of
  142.                     choices.  This means, if you read the current line, you
  143.                     will hear two menu choices.  If you are not careful,
  144.                     you will not know which one you are on.  With some
  145.                     careful learning, this should not be a problem.
  146.                5.   Inconsistent Dialogs
  147.                     I found that one of the Dialogs does not allow the
  148.                     screen to be cleared when it pops up.  The dialog in
  149.                     question is the control-F4 key (the move dialog).  For
  150.                     this reason, this dialog will be a little more
  151.                     difficult to configure.
  152.                6.   Some pick list boxes in WordPerfect do not track (move
  153.                     the system cursor with the highlight bar).  Most of
  154.                     these windows have the ability of performing a "NAME
  155.                     SEARCH" function.  The cursor is placed in a small box
  156.                     where text can be entered for the "NAME SEARCH"
  157.                     function.  A macro can not get around this one.
  158.                 The WordPerfect Braille and speech Interface Keyboard     4
  159.                                        Version 1.2
  160.                                     August 1, 1993
  161.  
  162.  
  163.  
  164.           What Did I Conquer?
  165.  
  166.                Since many of us use different screen reading packages, I
  167.                thought it would be best to attack a great deal of the
  168.                challenge in configuring WordPerfect 6.0 with WordPerfect's
  169.                own macro language.  For this reason, I have developed a
  170.                WordPerfect keyboard file for WP 6.0 that hopefully will
  171.                assist in making WordPerfect 6.0 better for all when setting
  172.                up configurations.  The rest of this document describes this
  173.                keyboard file and the way that it should be used when
  174.                configuring WP 6.0.
  175.  
  176.           What files are included in this package?
  177.  
  178.                The following files are included in this package:
  179.  
  180.                File Name      Description
  181.  
  182.                DESC.SDI       and
  183.                FILE_ID.DIZ    These two files are short descriptions of
  184.                               this product.  These files are used by
  185.                               electronic bulletin board services to
  186.                               automatically provide a file description of
  187.                               this product.
  188.                WPB.WP         This documentation in WordPerfect 6.0 format.
  189.                READ.ME        This documentation in ASCII text.
  190.                WPBSTART.WPM   This is the startup macro that is used to
  191.                               setup specific options necessary for optimum
  192.                               use with the new keyboard file.  This macro
  193.                               turns off the pull-down menus from displaying
  194.                               by default and sets the measurements to
  195.                               inches (using the letter I).
  196.                WPBASIK.WPK    this is the main keyboard macro file that
  197.                               contains the special macros for WordPerfect
  198.                               6.0.
  199.                 The WordPerfect Braille and speech Interface Keyboard     5
  200.                                        Version 1.2
  201.                                     August 1, 1993
  202.  
  203.  
  204.  
  205.           Preparing for the Installation of the Keyboard File
  206.  
  207.                It is time to install the keyboard file.  Before you can do
  208.                this some things need to be setup first.
  209.  
  210.           Copying the files
  211.  
  212.                Included in this distribution archive is a WordPerfect macro
  213.                file called WPBSTART.WPM.  This macro should be placed in
  214.                the directory that you specified during the installation of
  215.                WordPerfect for macro files.  This is normally
  216.                C:\WP60\MACROS.
  217.  
  218.                The distribution archive also contains the actual keyboard
  219.                file.  The name of this file is "WPBASIK.WPK".  This file
  220.                should also be copied to the same directory the macro was.
  221.  
  222.           Setting the WP Environment Variable
  223.  
  224.                The first thing you need to do is to set an environment
  225.                variable in your AUTOEXEC.BAT file.  Put a line in your
  226.                AUTOEXEC.BAT file that reads:
  227.  
  228.                     SET WP=/m-wpbstart /ND
  229.  
  230.                The /m switch tells WordPerfect to invoke the WPBSTART macro
  231.                upon entering WordPerfect.  This macro MUST be run.  The
  232.                keyboard file will not work without it.
  233.  
  234.                The /nd switch will prevent WordPerfect from locking your
  235.                system when you are using access technology.
  236.  
  237.                Make sure you re-run your AUTOEXEC.BAT file, or reboot your
  238.                system before invoking WordPerfect.  This is necessary to
  239.                make the changes apply that you just implemented in your
  240.                AUTOEXEC.BAT file.
  241.                 The WordPerfect Braille and speech Interface Keyboard     6
  242.                                        Version 1.2
  243.                                     August 1, 1993
  244.  
  245.  
  246.  
  247.           What Does the Startup Macro Do?
  248.  
  249.                When you enter WordPerfect, the macro file called WPBSTART
  250.                will execute (assuming you set up your AUTOEXEC.BAT file as
  251.                described above).  This is what the macro will do:
  252.  
  253.                1.   the macro defines a special variable called WAIT_TIME
  254.                     that is used to set the length of time that the macro
  255.                     waits when displaying a prompt before it is removed. 
  256.                     The variable is assigned a value of 10.  This means 1
  257.                     second.  Depending on your system, you can change this
  258.                     value to a lower number.  Experimentation is required
  259.                     to determine the best parameter to use for speech
  260.                     responsiveness.
  261.  
  262.                2.   The new WordPerfect Braille and Speech Interface
  263.                     Keyboard file is made the default keyboard for this
  264.                     session of WordPerfect only.
  265.  
  266.                3.   The entry and display of measurements have been set to
  267.                     inches (I was used in this case).  This, I have found,
  268.                     is the best setup for speech users as measurements are
  269.                     spoken better.  The old style of WordPerfect 4.2 unit
  270.                     measurements is no longer available.
  271.  
  272.                4.   The pull-down menus are no longer visible on the main
  273.                     document screen.  This was done for easier reading of
  274.                     the document.
  275.  
  276.                5.   Beeps are turned on for all conditions available in
  277.                     setup for the current session only.
  278.  
  279.                6.   A message informing you that WordPerfect is ready for
  280.                     use is displayed on the status line.
  281.                 The WordPerfect Braille and speech Interface Keyboard     7
  282.                                        Version 1.2
  283.                                     August 1, 1993
  284.  
  285.  
  286.  
  287.           Configuring the Status Line
  288.  
  289.                For this keyboard file to work correctly, you will need to
  290.                configure two windows for the status line.  Follow these
  291.                guidelines:
  292.  
  293.                1.   For the first window, the area of the screen should be
  294.                     line 25, columns 1 through 48.  DO NOT go beyond column
  295.                     48.
  296.  
  297.                2.   Configure the screen reader to trigger on a caret
  298.                     symbol (^) in column 1.  When this is seen, this window
  299.                     should speak.  Many messages presented in this keyboard
  300.                     file begin with a caret symbol (^).  I have found that
  301.                     information, other than that provided in the keyboard
  302.                     that is shown on the status line, is really not that
  303.                     useful (with the exception of the positioning
  304.                     information on the right side of the status line) and
  305.                     the filename/font name on the left side of the status
  306.                     line.
  307.  
  308.                3.   Configure a second window for the full length of the
  309.                     25th line of the screen.
  310.  
  311.                4.   This window should only speak when the string "**"
  312.                     appears.  This string will start in column 1.  The full
  313.                     line should then speak.  This is the string that is
  314.                     used to signify that a menu is appearing on the bottom
  315.                     line of the screen.
  316.  
  317.                5.   A third window should be setup to monitor the status
  318.                     line.  Search for the string "Selection:" starting in
  319.                     column 1 of line 25.  If this is seen, read the whole
  320.                     screen.  this represents a vertical menu like the old
  321.                     WordPerfect 5.0/5.1 menus.
  322.  
  323.                Other tips and techniques will be added to this section as I
  324.                receive feedback from you, the user.
  325.                 The WordPerfect Braille and speech Interface Keyboard     8
  326.                                        Version 1.2
  327.                                     August 1, 1993
  328.  
  329.  
  330.  
  331.           What does this keyboard file provide?
  332.  
  333.                This special keyboard file provides prompts on the status
  334.                line for all Dialogs that can be invoked by the use of
  335.                function keys and other keyboard commands.  
  336.  
  337.                When configuring your screen reader for this keyboard file,
  338.                look for a caret (^) followed by any text.  Each special
  339.                prompt will begin with the caret (^).  This distinguishes
  340.                other WordPerfect prompts that might appear.  In my
  341.                experience, no other prompts or information shown on the
  342.                left side of the status line is of any value (with the
  343.                exception of the filename and the current font of the
  344.                document).  All special prompts/messages will remain in
  345.                columns 1 through 49 of the status line.  Keep this in mind
  346.                when configuring your access technology.
  347.  
  348.                When a dialog comes up, you will be told by a message on the
  349.                status line.  When you have completed your activity in that
  350.                dialog, you will be told when you have returned to the main
  351.                editing screen.  I added this simply because it can be
  352.                difficult to tell when WordPerfect reacts to a key.  The new
  353.                version 6.0 can be sluggish on some systems.  Be patient, it
  354.                will communicate with you eventually.  I say this only to
  355.                make sure that if you are running on a 286 system, that
  356.                responsiveness might be redefined from your experience with
  357.                WordPerfect 5.1 or earlier.
  358.  
  359.                Other techniques have been implemented in this keyboard file
  360.                to assist in screen reading technology configuration.  Refer
  361.                to the chart on the following pages for further information
  362.                on what techniques have been made to assist you.  Each
  363.                redefined key is described in detail.  The keys are listed
  364.                in groupings.  In some instances multiple keys are listed
  365.                together when the same function applies to a set of keys
  366.                that has been redefined.
  367.  
  368.                The following charts show each key that is defined in the
  369.                keyboard file and how it has changed from the WP default. 
  370.                If you do not like the way this key functions with the use
  371.                of this keyboard file, delete that keyboard definition from
  372.                the keyboard layout in setup (shift-F1, keyboard, edit).
  373.                 The WordPerfect Braille and speech Interface Keyboard     9
  374.                                        Version 1.2
  375.                                     August 1, 1993
  376.  
  377.  
  378.  
  379.           CHART 1   Normal function Key Layout
  380.  
  381.                This chart shows the basic normal function key layout.  Some
  382.                additional keys are also shown that apply with the key being
  383.                explained.  For example, the CONTROL-B key is described
  384.                along with the F6 key since they perform the same function.
  385.  
  386.           Key  Meaning   Description
  387.  
  388.           F1   HELP      This key clears the current document from the
  389.                          screen and brings up the help screen for the
  390.                          current area.  A message is also displayed
  391.                          beginning with a caret symbol (^) informing you
  392.                          that the help screen has been invoked.
  393.           F2   Search    This key clears the current document from the
  394.                          screen and pops up the search dialog (the normal
  395.                          function for this key).  You are notified of this
  396.                          with a message on the status line.  Once the
  397.                          search completes, you will be notified that you
  398.                          have returned to the editing screen.  The prompt
  399.                          will tell you to "enter a string to search for".
  400.           F3   Switch    This key allows you to switch to any document you
  401.                          wish.  WordPerfect supports up to 9 documents open
  402.                          at any given time.  When you hit this key, a
  403.                          prompt will be shown on the screen asking you
  404.                          which document you would like to switch to.  This
  405.                          is different from the standard function of
  406.                          WordPerfect.  In WordPerfect, a dialog window is
  407.                          opened displaying a list of all 9 documents
  408.                          (whether or not 9 are open).  The number of the
  409.                          document along with its filename is displayed in
  410.                          the dialog.  I felt that this information was fine
  411.                          if you really need it, but for speech users I
  412.                          thought a simple prompt would be better and
  413.                          faster.  For this reason I re-defined the key to
  414.                          show a simple prompt instead of the dialog window. 
  415.                          When you enter a number, WordPerfect will let you
  416.                          know on the status line which document is being
  417.                          opened.  This makes it nice if you accidentally
  418.                          hit the wrong document number.
  419.                 The WordPerfect Braille and speech Interface Keyboard    10
  420.                                        Version 1.2
  421.                                     August 1, 1993
  422.  
  423.  
  424.  
  425.           CHART 1 (CONTINUED)
  426.  
  427.           Key  Meaning   Description
  428.  
  429.           F4   Indent
  430.           SHIFT-
  431.           F4   LR INDENT
  432.           TAB  TAB
  433.           Shift-
  434.           TAB  BackTAB
  435.           CONTROL-
  436.           F6   Decimal
  437.                Tab
  438.           ALT-
  439.           F6   Flush Right
  440.           SHIFT-
  441.           F6   Center    These seven keys move the cursor through the
  442.                          document by their respective functions.  When
  443.                          these keys are hit, the new position will be shown
  444.                          on the status line (surrounded by caret symbols). 
  445.                          This allows for easier editing in multi-columns
  446.                          and when aligning up text in paragraphs.
  447.           F5   List
  448.                Files     This key will clear the screen and invoke the list
  449.                          files screen.  A message on the status line will
  450.                          inform you of your entrance into and out of this
  451.                          function.
  452.           F6   Bold      and
  453.           F8   Underline These two keys will inform you of the state of the
  454.                          bold and underline functions.  You will know when
  455.                          bold is on, when bold is off, and when a blocked
  456.                          area is bolded.  This also holds true with the
  457.                          underline key.  These messages are displayed on
  458.                          the status line and are surrounded by caret
  459.                          symbols (^).  The control-B (bold) and control-U
  460.                          (underline) keys provide the same functionality as
  461.                          F6 and F8 do.
  462.           F7   Exit      This key will perform the same function as its
  463.                          default key in WordPerfect 6.00 While in the
  464.                          editing screen if you press F7 you will be told
  465.                          what to do next.  The prompt will inform you that
  466.                          you can "Save As, Yes, No, Cancel (S, Y, N, or
  467.                          C)".  These are the choices that are shown in the
  468.                          default dialog that is invoked.  The dialog is
  469.                          invoked and is ready for your response.
  470.           F10  Save      This key will clear the screen and invoke the
  471.                          "Save Document" dialog.  A message on the status
  472.                          line will inform you of your entrance into and out
  473.                          of this function.
  474.           F11  Reveal
  475.                Codes     This key toggles reveal codes on and off.  this
  476.                          key is the same as ALT-F3.  You are told when
  477.                          Reveal Codes is on and when it is off.
  478.           F12  Block     This key toggles the block feature on and off. 
  479.                          You are told when block is on and when it is off.
  480.                 The WordPerfect Braille and speech Interface Keyboard    11
  481.                                        Version 1.2
  482.                                     August 1, 1993
  483.  
  484.  
  485.  
  486.           CHART 2   Shifted function Key Layout
  487.  
  488.                The keys in the chart below are those function keys accessed
  489.                by pressing the SHIFT key (SHIFT-F1 through SHIFT-F12).  For
  490.                this reason, the shift key will not be shown in the KEY
  491.                column when the keys are listed.
  492.  
  493.           Key  Meaning   Description
  494.  
  495.           F1   Setup     This key will invoke an old WordPerfect 5.1 look-
  496.                          a-like setup menu.  You are presented with the
  497.                          setup menu in a full screen with the word
  498.                          "Selection:" on the status line.  You can select
  499.                          the options either by pressing the number on the
  500.                          left of each option, or the first letter of each
  501.                          menu choice.  When the letter/number is pressed,
  502.                          you are taken to that dialog.  When you complete
  503.                          this dialog you are returned to the main editing
  504.                          window.  Unlike the standard setup key, I had to
  505.                          take you back to the editing window due to a
  506.                          "CHAR" macro command problem I have not been able
  507.                          to code around.  This will hopefully change in the
  508.                          next release.
  509.           F2   Reverse
  510.                Search    This key invokes the search function (in reverse). 
  511.                          The screen is cleared and a message is placed on
  512.                          the status line.  When Search is completed, a
  513.                          message letting you know that you are in the
  514.                          document screen is displayed.
  515.           F3   Switch    This key invokes the Switch document function. 
  516.                          This key switches between the last two windows
  517.                          opened.  When you switch to a different document,
  518.                          that document number is displayed in a message on
  519.                          the status line.  This is done so that you always
  520.                          know which document is currently being edited.
  521.           F4   LR Indent Refer to chart 1 for a description of the indent
  522.                          and LR Indent functions.  This key is grouped
  523.                          along with others that perform the same function. 
  524.                          Look for the "F4" key in this chart for the five
  525.                          key grouping.
  526.           F5   Date      This key invokes the "DATE DIALOG".  This key
  527.                          varies from the WordPerfect default.  A simple
  528.                          horizontal menu is shown on the status line
  529.                          beginning with the character sequence "**".  All
  530.                          functionality is maintained, but it is easier to
  531.                          deal with than the dialog default.  Once you have
  532.                          used this menu, you will be told when you return
  533.                          to the document after exiting this function.  To
  534.                          exit this menu press either F7 or the <ESCAPE>
  535.                          key.
  536.           F6   Center    Refer to CHART 1. for details on this key.
  537.                 The WordPerfect Braille and speech Interface Keyboard    12
  538.                                        Version 1.2
  539.                                     August 1, 1993
  540.  
  541.  
  542.  
  543.           CHART 2 (CONTINUED)
  544.  
  545.           Key  Meaning   Description
  546.  
  547.           F7   Print     This key invokes the "PRINT DIALOG".  The screen
  548.                          is cleared and a message is displayed on the
  549.                          status line telling you that the dialog is being
  550.                          invoked.  A message after the dialog is closed is
  551.                          also displayed.
  552.           F8   Format    This key will invoke an old WordPerfect 5.1 look-
  553.                          a-like format menu.  You are presented with the
  554.                          format menu in a full screen with the word
  555.                          "Selection:" on the status line.  You can select
  556.                          the options either by pressing the number on the
  557.                          left of each option, or the mnemonic letter of
  558.                          each menu choice.  When the letter/number is
  559.                          pressed, you are taken to that dialog.  When you
  560.                          complete this dialog you are returned to the main
  561.                          editing window.  Unlike the standard setup key, I
  562.                          had to take you back to the editing window due to
  563.                          a "CHAR" macro command problem I have not been
  564.                          able to code around.  This will hopefully change
  565.                          in the next release.
  566.           F9   Merge
  567.                Codes     This key invokes the "MERGE CODES DIALOG".  The
  568.                          screen is cleared and a message is displayed on
  569.                          the status line telling you that the dialog is
  570.                          being invoked.  A message after the dialog is
  571.                          closed is also displayed.
  572.           F10  Retrieve  This key differs from the standard WordPerfect
  573.                          function.  This key will invoke the "RETRIEVE
  574.                          DIALOG" instead of the "OPEN FILE DIALOG".  This
  575.                          key now acts similar to the way that 5.1 did in
  576.                          that you can retrieve a document into the current
  577.                          one being edited.  The standard 6.0 key opens a
  578.                          new document when the file is loaded.  The screen
  579.                          is cleared and the dialog is presented.  A message
  580.                          is placed on the status line informing you of the
  581.                          dialog being invoked.  You are also notified when
  582.                          the dialog is closed.
  583.           F11  Redline   This key has been written to assist in redlining
  584.                          documents.  This key acts very similar to the bold
  585.                          key.  You are notified when redlining is on, off,
  586.                          and when text that is blocked is redlined.
  587.  
  588.           F12  Strikeout This key has been written to assist in striking
  589.                          out document text.  This key acts very similar to
  590.                          the bold key.  You are notified when strike out is
  591.                          on, off, and when text that is blocked is striked
  592.                          out.
  593.                 The WordPerfect Braille and speech Interface Keyboard    13
  594.                                        Version 1.2
  595.                                     August 1, 1993
  596.  
  597.  
  598.  
  599.           CHART 3   Control Function Key Layout
  600.  
  601.                The keys in the chart below are those function keys accessed
  602.                by pressing the CONTROL key (CONTROL-F1 through CONTROL-
  603.                F12).  For this reason, the control key will not be shown in
  604.                the KEY column when the keys are listed.
  605.  
  606.           Key  Meaning   Description
  607.  
  608.           F1   Shell     I have re-defined this key to show the shell menu
  609.                          in a vertical style menu.  The only draw back to
  610.                          this key is that if you are running WordPerfect 6
  611.                          from the SHELL 4.00 program that comes with
  612.                          WordPerfect 6, you will not have two of the
  613.                          options.  You basically will not be able to list
  614.                          the current running programs and switch to them. 
  615.                          Sorry about that.  When I can figure out how to
  616.                          find out that the shell is running under
  617.                          WordPerfect, this will change.  Select each option
  618.                          either by its number or the first letter of the
  619.                          menu item itself.
  620.           F2   Speller   This key has been re-defined somewhat from the
  621.                          standard WordPerfect 6 default.  This key invokes
  622.                          a new menu that looks very similar to the
  623.                          WordPerfect 5.1 menu structure.  A full screen
  624.                          menu is displayed showing each option that is
  625.                          available.  No options have been eliminated from
  626.                          the feature of this key.  If you wish to exit this
  627.                          menu, press the <ESCAPE> key.  the F7 key will 
  628.                          exit from the menu.  The standard speller dialog
  629.                          allows you to invoke Speller Setup by pressing the
  630.                          SHIFT-F1 key.  This is possible in this new menu
  631.                          as well.  Simply press "S" or the "SHIFT-F1" key
  632.                          to invoke Speller Setup.
  633.           F3   Screen    This key invokes the "SCREEN DIALOG".  The screen
  634.                          is cleared and a message is displayed on the
  635.                          status line telling you that the dialog is being
  636.                          invoked.  A message after the dialog is closed is
  637.                          also displayed.
  638.           F4   Move      This key invokes the "MOVE DIALOG".  The screen is
  639.                          NOT cleared when this key is used.  I am not sure
  640.                          why this does not work, and neither is
  641.                          WordPerfect.  Both WordPerfect and I guess that it
  642.                          does not clear it so that you can see what has
  643.                          been blocked (that is a wild guess).  A message is
  644.                          displayed on the status line telling you that the
  645.                          dialog is being invoked.  A message after the
  646.                          dialog is closed is displayed.
  647.           F5   Outline   This key invokes the "OUTLINE DIALOG".  The screen
  648.                          is cleared and a message is displayed on the
  649.                          status line telling you that the dialog is being
  650.                          invoked.  A message after the dialog is closed is
  651.                          also displayed.
  652.           F6   DEC TAB   Refer to CHART 1 for information on this key.
  653.                 The WordPerfect Braille and speech Interface Keyboard    14
  654.                                        Version 1.2
  655.                                     August 1, 1993
  656.  
  657.  
  658.  
  659.           CHART 3 (CONTINUED)
  660.  
  661.           Key  Meaning   Description
  662.  
  663.           F7   Notes     This key invokes the "NOTES DIALOG".  The screen
  664.                          is cleared and a message is displayed on the
  665.                          status line telling you that the dialog is being
  666.                          invoked.  A message after the dialog is closed is
  667.                          also displayed.
  668.           F8   Font      This key invokes the "FONT DIALOG".  The screen is
  669.                          cleared and a message is displayed on the status
  670.                          line telling you that the dialog is being invoked. 
  671.                          A message after the dialog is closed is also
  672.                          displayed.
  673.           F9   Merge
  674.                /Sort     This key invokes the Merge/Sort menu.  Instead of
  675.                          WordPerfect invoking a dialog with two options in
  676.                          it, I re-wrote the key to simply show a small menu
  677.                          on the bottom of the screen.  this will allow for
  678.                          easy triggering and makes life easier for speech
  679.                          users.  After selecting a choice, that dialog is
  680.                          invoked.  After completing this function, you will
  681.                          be informed when you have returned to the main
  682.                          document screen.  If you want to exit the menu,
  683.                          press either F7 or the <ESCAPE> key.
  684.           F10  Record    This key invokes the "MACRO RECORD DIALOG".  The
  685.                          screen is cleared and a message is displayed on
  686.                          the status line telling you that the dialog is
  687.                          being invoked.  A message after the dialog is
  688.                          closed is also displayed.
  689.           F11  Very
  690.                Large     This key sets the VERY LARGE attribute on text. 
  691.                          You will be told when VERY LARGE is on, off, or
  692.                          when a blocked area of text is enlarged.  This key
  693.                          acts like the BOLD key.
  694.           F12  Italics   Refer to CHART 6 key I for more information.
  695.                 The WordPerfect Braille and speech Interface Keyboard    15
  696.                                        Version 1.2
  697.                                     August 1, 1993
  698.  
  699.  
  700.  
  701.           CHART 4   Alt Function Key Layout
  702.  
  703.                The keys in the chart below are those function keys accessed
  704.                by pressing the ALT key (ALT-F1 through ALT-F12).  For this
  705.                reason, the ALT key will not be shown in the KEY column when
  706.                the keys are listed.
  707.  
  708.           Key  Meaning   Description
  709.  
  710.           F1   Writing
  711.                Tools     This key invokes the "WRITING TOOLS menu".  This
  712.                          key has been re-defined to show a menu on the
  713.                          bottom of the screen.  This menu provides all
  714.                          functionality that the dialog provides.  Make your
  715.                          choice and that function is performed.  This menu,
  716.                          like all others, begins with the character
  717.                          sequence "**: signifying that it is a menu.
  718.           F2   Search and
  719.                Replace   This key invokes the "SEARCH AND REPLACE DIALOG". 
  720.                          The screen is cleared and a message is displayed
  721.                          on the status line telling you that the dialog is
  722.                          being invoked.  A message after the dialog is
  723.                          closed is also displayed.
  724.           F3   Reveal
  725.                Codes     This key turns REVEAL CODES ON and OFF.  A message
  726.                          on the status line will inform you of the current
  727.                          state of REVEAL CODES when the key is pressed.
  728.           F4   Block
  729.                ON/OFF    This key turns BLOCK ON and OFF.  A message on the
  730.                          status line will inform you of the current state
  731.                          of BLOCK when the key is pressed. ON/OFF
  732.           F5   Mark      This key invokes the "MARK DIALOG".  The screen is
  733.                          cleared and a message is displayed on the status
  734.                          line telling you that the dialog is being invoked. 
  735.                          A message after the dialog is closed is also
  736.                          displayed.
  737.           F6   Flush
  738.                Right     Refer to CHART 1 for more information on this key.
  739.           F7   Columns/
  740.                Tables    This key invokes the "COLUMNS/TABLES DIALOG".  The
  741.                          screen is cleared and a message is displayed on
  742.                          the status line telling you that the dialog is
  743.                          being invoked.  A message after the dialog is
  744.                          closed is also displayed.
  745.           F8   Styles    This key invokes the "STYLES DIALOG".  The screen
  746.                          is cleared and a message is displayed on the
  747.                          status line telling you that the dialog is being
  748.                          invoked.  A message after the dialog is closed is
  749.                          also displayed.
  750.                 The WordPerfect Braille and speech Interface Keyboard    16
  751.                                        Version 1.2
  752.                                     August 1, 1993
  753.  
  754.  
  755.  
  756.           CHART 4 (CONTINUED)
  757.  
  758.           Key  Meaning   Description
  759.  
  760.           F9   Graphics  This key invokes the "GRAPHICS DIALOG".  The
  761.                          screen is cleared and a message is displayed on
  762.                          the status line telling you that the dialog is
  763.                          being invoked.  A message after the dialog is
  764.                          closed is also displayed.
  765.           F10  Run Macro This key invokes the "EXECUTE MACRO DIALOG".  The
  766.                          screen is cleared and a message is displayed on
  767.                          the status line telling you that the dialog is
  768.                          being invoked.  A message after the dialog is
  769.                          closed is also displayed.
  770.           F11  Large     This key sets the LARGE attribute on text.  You
  771.                          will be told when LARGE is on, off, or when a
  772.                          blocked area of text is enlarged.  This key acts
  773.                          very much like the BOLD key.
  774.           F12  Justify   This key is a very nicely written version of the
  775.                          old "JUSTIFICATION" prompt that WP 5.1 had.  You
  776.                          are presented with a small menu on the bottom of
  777.                          the screen with choices from which to select. The
  778.                          title of the menu begins with the characters "**",
  779.                          signifying that it is a status line menu.  You can
  780.                          exit this menu by either pressing the F7 key or
  781.                          the <ESCAPE> key.
  782.                 The WordPerfect Braille and speech Interface Keyboard    17
  783.                                        Version 1.2
  784.                                     August 1, 1993
  785.  
  786.  
  787.  
  788.           CHART 5   Pull-Down Key Layout
  789.  
  790.           Key  Meaning        Description
  791.  
  792.           ALT-=     Pull-down
  793.                Menus          The ALT-= (alt equals) key sequence brings up
  794.                               the WordPerfect pull-down menu system.  The
  795.                               screen is cleared and the menus are invoked. 
  796.                               A message is displayed informing you of the
  797.                               menus being invoked.
  798.           ALT-F     File      This key sequence invokes the file pull-down
  799.                               menu.  The screen is cleared and a message
  800.                               informing you of your entrance into this menu
  801.                               is given on the status line.  When you leave
  802.                               the menu, a message informing you that you
  803.                               have entered the editing screen once again
  804.                               (if this is true).
  805.           ALT-E     Edit      This key sequence invokes the Edit pull-down
  806.                               menu.  The screen is cleared and a message
  807.                               informing you of your entrance into this menu
  808.                               is given on the status line.  When you leave
  809.                               the menu, a message informing you that you
  810.                               have entered the editing screen once again.
  811.           ALT-V     View      This key sequence invokes the View pull-down
  812.                               menu.  The screen is cleared and a message
  813.                               informing you of your entrance into this menu
  814.                               is given on the status line.  When you leave
  815.                               the menu, a message informing you that you
  816.                               have entered the editing screen once again.
  817.           ALT-L     Layout    This key sequence invokes the Layout pull-
  818.                               down menu.  The screen is cleared and a
  819.                               message informing you of your entrance into
  820.                               this menu is given on the status line.  When
  821.                               you leave the menu, a message informing you
  822.                               that you have entered the editing screen once
  823.                               again.
  824.           ALT-T     Tools     This key sequence invokes the Tools pull-down
  825.                               menu.  The screen is cleared and a message
  826.                               informing you of your entrance into this menu
  827.                               is given on the status line.  When you leave
  828.                               the menu, a message informing you that you
  829.                               have entered the editing screen once again.
  830.           ALT-O     Font      This key sequence invokes the Font pull-down
  831.                               menu.  The screen is cleared and a message
  832.                               informing you of your entrance into this menu
  833.                               is given on the status line.  When you leave
  834.                               the menu, a message informing you that you
  835.                               have entered the editing screen once again.
  836.                 The WordPerfect Braille and speech Interface Keyboard    18
  837.                                        Version 1.2
  838.                                     August 1, 1993
  839.  
  840.  
  841.  
  842.           CHART 5 (CONTINUED)
  843.  
  844.           Key  Meaning        Description
  845.  
  846.           ALT-G     Graphics  This key sequence invokes the Graphics pull-
  847.                               down menu.  The screen is cleared and a
  848.                               message informing you of your entrance into
  849.                               this menu is given on the status line.  When
  850.                               you leave the menu, a message informing you
  851.                               that you have entered the editing screen once
  852.                               again.
  853.           ALT-W     Window    This key sequence invokes the Window pull-
  854.                               down menu.  The screen is cleared and a
  855.                               message informing you of your entrance into
  856.                               this menu is given on the status line.  When
  857.                               you leave the menu, a message informing you
  858.                               that you have entered the editing screen once
  859.                               again.
  860.           ALT-H     Help      This key sequence invokes the Help pull-down
  861.                               menu.  The screen is cleared and a message
  862.                               informing you of your entrance into this menu
  863.                               is given on the status line.  When you leave
  864.                               the menu, a message informing you that you
  865.                               have entered the editing screen once again.
  866.                 The WordPerfect Braille and speech Interface Keyboard    19
  867.                                        Version 1.2
  868.                                     August 1, 1993
  869.  
  870.  
  871.  
  872.           CHART 6   Shortcut Keys
  873.  
  874.                The following keys are those keys to which WordPerfect
  875.                refers to as the "Shortcut Keys".  All of these keys are
  876.                accessed by the use of the control key (CONTROL-A through
  877.                CONTROL-Z).  For this reason, the control key is not listed
  878.                in the KEY column.
  879.  
  880.           Key  Meaning   Description
  881.  
  882.           A    Compose   This key invokes WordPerfect's "Compose" feature. 
  883.                          The screen is cleared and the dialog is invoked. 
  884.                          A message on the status line is shown telling you
  885.                          that you have entered the dialog.  When you leave,
  886.                          you will be told when you have returned to the
  887.                          editing screen.
  888.           B    Bold      This key is the equivalent of pressing the F6 key. 
  889.                          Refer to chart 1 for more information.
  890.           C    Copy      This key copies the current block to the buffer. 
  891.                          When the copy is complete you will be told that
  892.                          the text has been moved into the buffer.
  893.           D    Record    This key invokes WordPerfect's "Record a Sound
  894.                          Clip" feature.  You are told when you have entered
  895.                          the dialog and when you have exited to the
  896.                          document screen.  The screen is cleared for easy
  897.                          reading.
  898.           F    Find Mark This key will jump to the "quick mark" that is set
  899.                          using control-Q.  When the jump is made, a message
  900.                          will be displayed on the status line informing you
  901.                          that the mark was found.
  902.           I    Italics   This key performs the same function that the F6
  903.                          (bold key) did, except that this key invokes
  904.                          italics appearance instead of bold.  You will know
  905.                          when Italics is on, when it is off, and when
  906.                          blocked text is put into Italics.
  907.           N    Normal    This key resets the document into a normal
  908.                          attribute.  When this key is pressed, you will be
  909.                          told when the normal attribute has been set.
  910.           Q    Mark Set  This key sets a quickmark.  You will be told when
  911.                          the mark is set.  Use the control-F key sequence
  912.                          to jump to the mark.
  913.           R    Repeat    It took me a while to figure out where this
  914.                          function went in 6.0.  I used the ESCAPE key
  915.                          repeatedly (no pun intended) in 5.1 and was not
  916.                          sure where it went.   When this key is invoked,
  917.                          the screen is cleared and the "Repeat" dialog is
  918.                          invoked.  A message on the status line shows when
  919.                          the dialog is being opened or closed.
  920.                 The WordPerfect Braille and speech Interface Keyboard    20
  921.                                        Version 1.2
  922.                                     August 1, 1993
  923.  
  924.  
  925.  
  926.           CHART 6 (CONTINUED)
  927.  
  928.           Key  Meaning   Description
  929.  
  930.           S    Play
  931.                Sound     This key invokes the "Play Sound Clip" dialog. 
  932.                          The screen is cleared and a message informing you
  933.                          that the dialog is being invoked is presented. 
  934.                          Once the dialog is dismissed a message is
  935.                          displayed informing you that you have returned to
  936.                          the main document screen.
  937.           U    Underline This key is the equivalent of pressing the F8 key. 
  938.                          Refer to chart 1 for more information.
  939.           V    Paste     This key pastes what you have cut using the
  940.                          control-X key sequence.  You will be notified when
  941.                          the text is pasted into the document.  The message
  942.                          is surrounded by caret symbols.
  943.  
  944.           W    WP CHARS  This key invokes the WordPerfect characters
  945.                          dialog. The screen is cleared and a message is
  946.                          placed on the status line informing you that the
  947.                          dialog is being invoked.  When you exit this
  948.                          dialog, a message will tell you when you have
  949.                          reached the editing screen.
  950.  
  951.           X    Cut       This key cuts the blocked text from the document.  
  952.                          A message is placed on the status line that lets
  953.                          you know that the cut has taken place.
  954.  
  955.           INS  TYPEOVER  This key toggles the TYPEOVER feature on and off. 
  956.                          A message on the status line will be shown
  957.                          informing you of the status of TYPEOVER.  This
  958.                          message is surrounded by caret symbols (^).
  959.                 The WordPerfect Braille and speech Interface Keyboard    21
  960.                                        Version 1.2
  961.                                     August 1, 1993
  962.  
  963.  
  964.  
  965.           Contacting the Author
  966.  
  967.                I can be contacted via the following methods:
  968.  
  969.                1.   You can call me at (602) 888-1456.  Keep in mind that I
  970.                     normally get home after 6 MST.  DO NOT call after
  971.                     10:00PM.  You will experience the wrath of Keri (my
  972.                     wife <GRIN>) if you do.  DO NOT call during the day
  973.                     (8AM to 6 PM - Monday through Friday).  I can not
  974.                     return calls then and would appreciate it if you could
  975.                     call during evening hours.  The weekend is just fine to
  976.                     call.
  977.  
  978.                2.   You can contact me via snail mail (the US post office). 
  979.                     My address is:
  980.  
  981.                     Jeff Bishop
  982.                     420 E Yavapai RD.
  983.                     Apartment Number H
  984.                     Tucson, AZ 85705
  985.  
  986.                3.   I monitor Blink Talk on FIDONET.  You can ask questions
  987.                     there if you would like.  Make sure that you address
  988.                     the message to "Jeff Bishop".
  989.  
  990.                4.   For those of you with NETMAIL capability, you can send
  991.                     mail to FIDONET node number 1:300/205 during ZMH only.  
  992.                5.   You can always FREQ the latest version of this software
  993.                     from FIDONET node number 1:300/204.  This system is
  994.                     available 24 hours and has a 16.8 v32BIS dual standard
  995.                     on-line.  Use the magic name WPBASIK to FREQ the file.
  996.                 The WordPerfect Braille and speech Interface Keyboard    22
  997.                                        Version 1.2
  998.                                     August 1, 1993
  999.  
  1000.  
  1001.  
  1002.               Acknowledgements
  1003.  
  1004.                I would like to acknowledge the following people for their
  1005.                help:
  1006.  
  1007.           Name                Why?
  1008.  
  1009.           My Wife             My beautiful wife Keri who has been so
  1010.                               patient during the long hours of frustration
  1011.                               in trying to get the keyboard finished.  To
  1012.                               her I owe my gratitude and love.
  1013.  
  1014.           WordPerfect
  1015.           Beta Group     I would like to publicly thank WordPerfect
  1016.                          Corporation for the help they have been.  I
  1017.                          especially would like to thank them for allowing
  1018.                          me to beta test 6.0.  It has been an invaluable
  1019.                          experience.  Great thanks goes to those in the
  1020.                          beta group at WordPerfect who provided help with
  1021.                          the new macro language; without it, this could
  1022.                          have never happened.  Thank you for assisting me
  1023.                          with developing a solution to make WordPerfect 6
  1024.                          better for blind users.  To all the other people
  1025.                          at WordPerfect who helped, THANK
  1026.                          YOU!!!!!!!!!!!!!!!!  As far as I am concerned,
  1027.                          WordPerfect is the best software company in the
  1028.                          industry.  Keep it up!
  1029.  
  1030.           Fred Brucker   I would like to thank Fred Brucker for his
  1031.                          outstanding contributions with {COMMO} (the
  1032.                          greatest telecommunications package ever) for
  1033.                          encouraging me to keep going forward with
  1034.                          shareware products.  Thanks Fred and may {COMMO}
  1035.                          be even more successful than it already is.
  1036.  
  1037.           Randy Knapp    For his insight on configuring smart zones with
  1038.                          Artic Business Vision. I would also like to thank
  1039.                          him for continuing to give encouragement during
  1040.                          those tough moments when things were not going
  1041.                          right.  I also would like to thank him for his
  1042.                          hints about the help screen(s).
  1043.  
  1044.           Ted Henter     For his insights on Jaws Macros.  I also
  1045.                          appreciate his feedback of ideas mentioned to him.
  1046.  
  1047.           Ray Bronk      For always keeping the user's perspective on the
  1048.                          front line.  It's always good to communicate with
  1049.                          non-technical programmer types when you have gone
  1050.                          absolutely nuts.  Great thanks also goes to Ray
  1051.                          for his idea about renaming the product to WP
  1052.                          BASIK.  Keep those ideas coming Ray.
  1053.  
  1054.           Dane Beko      and
  1055.           Chuck Knowlton I would like to thank them for their help with
  1056.                          making the documentation more understandable and
  1057.                          readable. I hate writing.  It is true that the
  1058.                          last stage of development is the documentation.
  1059.                 The WordPerfect Braille and speech Interface Keyboard    23
  1060.                                        Version 1.2
  1061.                                     August 1, 1993
  1062.  
  1063.  
  1064.  
  1065.           Conclusion
  1066.  
  1067.                That is it!  You are now ready to run with WordPerfect 6.0. 
  1068.                Additional refinements will be needed for complex screens in
  1069.                WordPerfect (such as spell check).  I will be providing
  1070.                additional feedback on what should be done to configure
  1071.                these screens when firm details are available.
  1072.  
  1073.                Expect a newer version of the keyboard file soon.  The next
  1074.                release will have menus specifically developed for blind
  1075.                users.  All functionality will be maintained, but they will
  1076.                be in an even easier structure than you see now.
  1077.  
  1078.                Any suggestions, improvements, corrections, or any other
  1079.                comments you would like to pass on, please do.  I love
  1080.                feedback.
  1081.  
  1082.                Happy computing, and remember to be patient with WordPerfect
  1083.                6.0.  Any new product will cause some frustrations.