home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 24b / keyboard.zip / TUTOR.DOC < prev    next >
Text File  |  1986-08-13  |  13KB  |  277 lines
  1. F1
  2. (C)Copyright Martin D. Flynn, 1986 - All Rights Reserved
  3.  
  4. Welcome to Soft-Touch!
  5.  
  6. This is a mini-tutorial which will lead you through some the the features of
  7. Soft-Touch.  It is assumed that you have already printed and read the
  8. Soft-Touch manual.  To follow this tutorial you need only to press the
  9. specified keys as they are requested.  To restart this tutorial just re-enter
  10. the command TUTOR.
  11.  
  12. This tutorial is using Soft-Touch macros and is run under DOS with echo off.
  13. The text information for this tutorial is printed to the screen with a command
  14. called 'LIST' which prints out text information from the file 'TUTOR.DOC'.
  15. You will find the macros which run this tutorial in the file 'MCRO.KEY'.  To
  16. cancel this tutorial press alt-F10.  This will turn echo back on and will clear
  17. the Soft-Touch key definitions.
  18.  
  19. For a directory of the topics covered and their corresponding assigned
  20. function key, press alt-F1.
  21.  
  22.  
  23.  
  24.  
  25. Press F2 to continue ...
  26. F2
  27. Accessing Soft-Touch functions (entering escape mode):
  28.  
  29. To allow full freedom to define all possible extended keys without having
  30. to reserve certain keys for Soft-Touch use, a special "hot key" sequence is
  31. used to access the Soft-Touch functions.
  32.  
  33. To enter the "hot key" escape mode sequence press and hold the left-shift,
  34. then press the escape key.  The speaker will respond with two short high
  35. pitched beeps and the cursor will appear as a large block.  The function
  36. keys are now temporarily assigned with special Soft-Touch functions which
  37. will be performed when pressed.
  38.  
  39. If the left-shift-escape key sequence is pressed again, then the speaker
  40. will respond with one short high pitched beep, and the cursor will return
  41. to normal indicating that you are no longer in escape mode.
  42.  
  43. Try it now: ("hot key" sequence)
  44.   - Press the "hot key" sequence once: listen for two high pitched beeps
  45.     and see the cursor change to a large block.
  46.   - Press the "hot key" sequence again: listen for one high pitched beep
  47.     and see the cursor return to normal size.
  48.  
  49.  
  50. Make sure you are out of escape mode, then press F3 to continue ...
  51. F3
  52. Accessing Soft-Touch functions (selecting a function):
  53.  
  54. While in escape mode, pressing a valid function key will cause the speaker to
  55. respond with one short high pitched beep and the cursor size will return to
  56. normal to indicate that the function was accepted.  A list of the valid
  57. function keys and their descriptions may be found in the operations guide.  A
  58. few of the functions will be discussed in this tutorial.
  59.  
  60. If an invalid function key is pressed, then a low pitched beep will be heard
  61. and the keyboard will remain in escape mode.  To exit the Soft-Touch escape
  62. mode, press a valid function, or press the "hot key" sequence again.
  63.  
  64. While in escape mode, any active playback operation is suspended.  It may be
  65. resumed by pressing the "hot key" sequence again, or by pressing certain
  66. functions which do not directly affect the playback operation of Soft-Touch.
  67. Pressing F3 (STOP function) will cancel any active playback operation.
  68.  
  69. Try it now:
  70.   - Press left-shift-escape "hot key" sequence: listen for the speaker
  71.     response and see the cursor change size.
  72.   - Press F6 (work buffer playback): see a message played back from the work
  73.     buffer.
  74.  
  75. Press F4 to continue ...
  76. F4
  77. Accessing Soft-Touch functions (immediate vs. playback execution):
  78.  
  79. The playback function F6 executed immediately when selected because it was an
  80. unshifted function key.  All shifted escape mode functions (ie. control-shift,
  81. caps-shift, and alternate-shift) will not be executed immediatly, but will be
  82. executed if they are encountered in a playback.  Selecting a shifted escape
  83. mode function while the keystroke record mode is not on (not defining a macro)
  84. has no effect.  Selecting a shifted escape mode function while in the process
  85. of defining a macro will cause the function to be recorded with the keystrokes
  86. to be executed when the macro is played back.
  87.  
  88. If you wish to have one of the unshifted functions executed only when
  89. encountered in a playback operation, then select the function with the
  90. alternate shift key pressed.  For instance, if you wish to execute the OFF
  91. function within a playback operation, then select the escape mode function OFF
  92. with the alternate shift key pressed (ie. alt-F2) when defining a macro.
  93.  
  94. Try it now: (immediate vs. playback execution)
  95.   - Press the "hot key" sequence followed by the immediate playback operation
  96.     function F6: notice that the message was displayed immediatly.
  97.   - Press the "hot key" sequence followed by the playback operation function
  98.     with the alt-shift pressed: notice that the message was not displayed.
  99.  
  100. Press F5 to see how to define a macro ...
  101. F5
  102. Defining a keystroke macro:
  103.  
  104. Later you will be shown a short-cut to defining a macro, but first let's try
  105. it using the escape mode functions.  To define a macro, perform the following
  106. steps (this uses method #1 as described in the operations guide):
  107.     1 - Press the escape mode "hot key" sequence left-shift-escape
  108.     2 - Press F9 to start a macro definition
  109.     3 - Press the key you wish to define
  110.     4 - Enter your keystroke to include in the macro
  111.     5 - Press the escape mode "hot key" sequence left-shift-escape
  112.     6 - Press F10 to terminate the keystroke macro definition
  113.  
  114. You may define a macro at any time, within any program.  If you select an
  115. invalid key to define in step 3, then the speaker will respond with one low
  116. pitched beep and the macro definition sequence is cancelled.  You will then
  117. need to restart at step 1.  A list of the valid definable keys may be found
  118. in the operations guide.
  119.  
  120. Try it now: (define a macro)
  121.   - Follow the above steps to create a macro using the alt-N key for step 3,
  122.     and your name (no carriage return) for the keystrokes entered in step 4.
  123.   - Test your macro definition by pressing alt-N.
  124.  
  125. When you are done, press F6 to continue.
  126. F6
  127. Nesting keystroke playback operations:
  128.  
  129. Since you defined your name to the alt-N key, I was able to playback your
  130. name in the previous statement by referencing the alt-N key in this tutorial.
  131. This is an example of a nested playback operation.  You may nest playback
  132. operations up to 5 levels deep (25 levels for the enhanced version).
  133.  
  134. With this feature you can define macros which contain a name or phrase which
  135. you use often and play them back within other macros by referencing the
  136. keystroke to which they were defined.
  137.  
  138. The short-cut to defining macros which was spoken of in the last section is
  139. accomplished by assigning the start and end macro definition functions to a
  140. key of your choice.  Thus eliminating having to select the "hot key" sequence
  141. to execute these functions.  All of the Soft-Touch functions may be assigned
  142. in this manner.  For instance you could define the 'alt =' key with the start-
  143. macro-definition function and the 'alt -' key with the end-macro-definition
  144. function.  This has already been done for you in this tutorial.  For the macro
  145. definition steps described in the previous section, steps 1 and 2 may be
  146. replaced with the 'alt =' key, and steps 5 and 6 may be replaced with the 'alt
  147. -' key.  You may view the file 'MCRO.KEY' to see how these two keys have been
  148. defined.
  149.  
  150. Press F7 to continue ...
  151. F7
  152. Using Date and Time functions:
  153.  
  154. A series of functions are available in Soft-Touch to allow returning the
  155. current date and time within a playback operation.  The escape mode functions
  156. shift-F1 through shift-F8 support the date and time capability of Soft-Touch.
  157.  
  158. A Date and Time function has been set up for you in the Soft-Touch tutorial
  159. macro.  The keystroke alt-T will get the current date and time and display
  160. them in a playback operation.
  161.  
  162. For more information on the date and time functions see the example in the
  163. Soft-Touch tutorial macro (file 'MCRO.KEY') and see the appropriate section
  164. in the operations guide.
  165.  
  166. Try it now: (date and time functions)
  167.   - Press alt-T: see the current date and time displayed.
  168.   - You may repeat pressing alt-T to see the time change.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175. When you have finished, press F8 to continue ...
  176. F8
  177. Using Variable fields:
  178.  
  179. One very powerful feature of Soft-Touch is the use of playback variables.
  180. Playback operations can be automatically suspended to allow keystrokes to be
  181. entered from the keyboard.  These entered keystrokes can then be replayed at
  182. a different location in the playback.
  183.  
  184. One example of how this might be used is with the DOS RENAME command.  If you
  185. wish to exchange the names of two files the normal sequence of commands would
  186. be as follows:
  187.  
  188.               RENAME fileA.xxx TEMP.$$$
  189.               RENAME fileB.zzz fileA.xxx
  190.               RENAME TEMP.$$$  fileB.zzz
  191.  
  192. Notice that the files 'fileA.xxx' and 'fileB.zzz' have each been entered
  193. twice.  Using Soft-Touch keystroke variables you could create a macro which
  194. would only require entering each file name once.  This file name exchange
  195. macro has already been prepared for you and has been assigned to the alt-X
  196. key.  You may wish to experiment with this macro on some of your test files.
  197. For more information see the appropriate section in the manual and view the
  198. tutorial macro file to see how the alt-X key has been defined.
  199.  
  200. Press F9 to continue ...
  201. F9
  202. Soft-Touch features:
  203.  
  204. Some Soft-Touch features include:
  205.  
  206.     * The ability to define macros for over 90 different keystrokes.
  207.  
  208.     * The ability to set a screen blanking time delay which will turn off the
  209.       video portion of the monitor to avoid burning the display.
  210.  
  211.     * The ability to use the current system date and time within playback
  212.       operations.
  213.  
  214.     * The ability to suspend and resume playback operations at any time.
  215.  
  216.     * The ability to call up you spread sheet or word processor and enter your
  217.       often-used parameters with only a simple keystroke.
  218.  
  219.     * The ability to change the escape mode "hot key" sequence to another key
  220.       sequence to avoid conflicting sequences with other memory resident
  221.       programs.
  222.  
  223.     * And More!
  224.  
  225. Press F10 to continue ...
  226. F10
  227. Registration information:
  228.  
  229. This concludes the mini-tutorial.  This version of Soft-Touch is distributed in
  230. the public domain.  You may review this product at your leasure to determine if
  231. you would like to continue using it.  If you find it useful, and you decide to
  232. use it, I encourage you to become a registered user of this product.  You may
  233. receive a registered copy of Soft-Touch for $23 for one copy, or $20 for two or
  234. more.  See the operations guide for more information and the registration form.
  235.  
  236. Registration provides the following benefits:
  237.   1.  Receive an upgraded version of Soft-Touch including enhancements.
  238.   2.  Limited phone support.
  239.   3.  A $5.00 commission for each new registered user who provides your
  240.       registration number as a reference.
  241.  
  242. You may request additional public domain copies of Soft-Touch for $7.00 each
  243. which includes shipping and handling.
  244.  
  245.                              Martin D. Flynn
  246.                                 FlynnSoft
  247.                               P.O. Box 5034
  248.                        Redwood City, Calif.  94063
  249.  
  250. Press alt-F10 to terminate the tutorial ...
  251. HELP
  252. Tutorial directory:
  253.  
  254. Select one of the following:
  255.    F1  - Introduction
  256.    F2  - Accessing Soft-Touch functions (entering escape mode)
  257.    F3  - Accessing Soft-Touch functions (selecting a function)
  258.    F4  - Accessing Soft-Touch functions (immediate vs. playback execution)
  259.    F5  - Defining a keystroke macro
  260.    F6  - Nesting keystoke playback operations
  261.    F7  - Using date and time functions
  262.    F8  - Using variable fields
  263.    F9  - Soft-Touch features
  264.    F10 - Registration information.
  265.  
  266.    alt F1  - Tutorial directory (this screen)
  267.    alt F10 - Terminate this tutorial
  268.    alt N   - Your name defined in section F5 above
  269.    alt S   - Playback operation nesting example (see file MCRO.KEY)
  270.    alt T   - Date / Time function example
  271.    alt X   - Variable field example (exchange file names)
  272.    alt =   - Start-macro-definition macro
  273.    alt -   - End-macro-definition macro
  274.  
  275. To restart this tutorial, enter 'TUTOR' followed by a carriage return.
  276. end
  277.