home *** CD-ROM | disk | FTP | other *** search
/ PC Today 18 / SHADOW12.EXE / UPGRADE.DOC < prev    next >
Encoding:
Text File  |  1991-08-15  |  7.0 KB  |  187 lines
  1.  
  2. 13/8/91  New Version 1.2 - Corrects Configuration Save Bug.
  3.  
  4. ------------------------------------------------------------------------
  5.  
  6. Version 1.0 has been upgraded with an extended set of command line
  7. options. Also a new replay mode ( continuous ) has been introduced which
  8. enables sessions to be constantly repeated. In addition an extra program
  9. has been added to compress SHD files and/or modify the real time replay
  10. speed.
  11.  
  12.             Continuous replay
  13.             -----------------
  14.  
  15. This mode is mainly for demonstration purposes. The shadow replay file is
  16. played back from the beginning and when it reaches the end it restarts.
  17. Please note that all tabs that were set during recording are ignored to
  18. ensure an uninterrpted replay. The other features such as single stepping
  19. or constant timed replays work as usual. This additional choice appears in
  20. the SHADOW window after the replay mode is selected.
  21.  
  22.  
  23.              Command line switches                       
  24.                         ---------------------
  25.  
  26. /C        Set default replay to Constant time ( normally real time ).
  27. /F[filename]    Specify initial SHADOW file.
  28. /K[1 - 2000]    Number of keys held in buffer.
  29. /L        Repeat (Loop) replay continuously.
  30. /S[1 - 36]    Initial replay speed.
  31. /X[A,O,P or W]    Startup mode.
  32. /N        Turn off Indicator lights
  33.  
  34. Constant time
  35. -------------
  36.  
  37. When you first start to replay a SHADOW file it plays back in real time
  38. mode. If you use the /C option it will start to replay at a constant speed
  39. specified either as the default value or a new value given by the /S
  40. switch.
  41.  
  42. Filename
  43. --------
  44.  
  45. The /F[path\filename] switch changes the file that is initially recorded
  46. or replayed. The path\filename can be any acceptable DOS path. This switch
  47. does exactly the same as the F option on the startup screen. (See the
  48. manual for a full explanation of possible DOS paths ). An example /F
  49. option is:
  50.  
  51.     SHADOW /FC:\shadow\records\start
  52.  
  53. This would set the SHADOW file as START.SHD in the C:\SHADOW\RECORDS
  54. subdirectory. Note that when no extension is given SHD is automatically
  55. appended.
  56. The validity of the new path is checked and any bad or incorrect entries
  57. are indicated and SHADOW aborts.  However if you give a valid path but a
  58. non existant file when trying to start in replay mode the opening screen
  59. pops up to allow you to modify the filename.
  60.  
  61. Keystroke buffer
  62. ----------------
  63.  
  64. The /K switch defines the number of key presses that are held in memory
  65. before being written to the disk file. Any number between 1 and 2000 is
  66. valid. An entry of 2001 to 9999 will be ignored whilst any five digit
  67. number will result in an error message.
  68.  
  69. example:    SHADOW /K25
  70.  
  71.  
  72. Repeat
  73. ------
  74.  
  75. The /L option puts SHADOW into its continuous replay cycle. This assumes
  76. that that SHADOW will start in replay mode. If you start in Record or Wait
  77. mode this switch will be ignored.
  78.  
  79. example:    SHADOW /xp /l    ;This will continuously replay the default
  80.                 ;file.
  81.  
  82.         SHADOW /xo /l    ;This will record to the default file and
  83.                 ;ignore the /L switch.
  84.  
  85.  
  86. Speed 
  87. -----
  88.  
  89. The /S switch specifies the initial replay speed. The included number can
  90. be from 1 (fastest) to 36 (slowest). Any two digit number outside this
  91. range will be ignored whilst a 3 or more digit number will result in an
  92. error message.
  93.  
  94. example:    SHADOW /S12
  95.  
  96. MODE
  97. ----
  98.  
  99. The /X mode directs SHADOW to go into one of four modes. Wait mode (W)
  100. does nothing but wait for the SHADOW hotkey to be pressed. Playback (P)
  101. puts shadow straight into replay mode where it will start replaying the
  102. default file. The two record modes , Append (A) and Overwrite (O) start
  103. recording immediately with the file being appended to ( if it already
  104. exists ) or overwritten. So the four possible Mode switches are :-
  105.  
  106.     SHADOW  /Xa
  107.     SHADOW     /XW
  108.     SHADOW    /XP
  109.     SHADOW    /XO
  110.  
  111. Indicator light
  112. ---------------
  113.  
  114. When recording or replaying a 'P' or 'R' is displayed in the top right
  115. hand corner of the screen. This indicator defaults to ON but if you don't
  116. want it displayed ( if you are in a graphics screen for instance )
  117. starting SHADOW with the /N switch turns off the light.
  118.  
  119. Guidelines 
  120. ----------
  121.  
  122. As you have probably already noticed the case of the switches is
  123. unimportant. There is one strict rule and that is that there must not be
  124. any spaces between the switch itself and the following parameters. The
  125. command line :-
  126.  
  127.         SHADOW /f c:\record /xc /s12 /C /k123
  128.  
  129. will produce an error because of the space between the /f and the
  130. c:\record.The corrected line would be :-
  131.  
  132.         SHADOW /fc:\record /xc /s12 /c /k123
  133.  
  134. You can put one or more spaces between each switch if you wish or you can
  135. join them all up as one long line. The following lines are the same :-
  136.  
  137.         SHADOW /fd:\util\grab.shd/xC/M
  138.         SHADOW /fd:util\grab.shd   /xc  /m
  139.  
  140. Obviously the second one is clearer and easier to read but nevertheless
  141. they function exactly the same way.
  142. Finally the original /A (automatic start) switch is still valid but is
  143. mostly unnecassary as /F /K /S and /X all invoke it automatically.
  144. Therefore if you wish to enter the parameters at command level yet still
  145. see the startup screen you should make /M (manual) the last switch. So
  146.  
  147.         SHADOW /frecord.shd /k200 /s10 /c /xp /m
  148.  
  149. will load up shadow with the given parameters yet still display the
  150. opening screen.
  151.  
  152.  
  153.                  SHADTIME.EXE
  154.                  ------------
  155.  
  156. Shadtime compresses and/or changes the real time replay speeds by a factor
  157. of between .01 and 100. The syntax for the command is :-
  158.  
  159. SHADTIME  [ /c] [/tn] sourcefile targetfile
  160.  
  161. The two switches can be used seperately or together but at least one of
  162. them should be used or else an error will be generated. The filenames can
  163. include any valid DOS path and warnings are given should an incorrect path
  164. or filename be entered.
  165. The compress option removes certain keystrokes that DOS ignores when
  166. pressed. For instance if you hold down the shift key whilst in RECORD mode
  167. youy will see your hard-disk light flashing as it records the events.
  168. However you will also notice that nothing is happening on screen. The /C
  169. option removes these surplus keystrokes which will decrease the size of
  170. the file. You should also note that the replay speed will be slightly
  171. quicker as a result.
  172. The /t option multiplies each timed delay by the included factor so the
  173. switch /T0.5 will half real time replay speed by halfing the original time
  174. for each keystroke. Similarly /t3 will increase replay time by a factor of
  175. 3.
  176. if you type SHADTIME with no parameters you get a reminder and example of
  177. the syntax.
  178.  
  179. This disk also contains some extra replay files - one for Sidekick plus
  180. and another for LOTUS 123.
  181. How the Sidekick plus file replays will depend on how you have Sidekick
  182. configured. To replay as intended you should save any existing notepads
  183. and outlines as SHADOW will open new files and it doesn't expect to see
  184. the Sidekick save file warning. The replay should be started from the
  185. Sidekick main menu as it cannot reproduce the Ctrl-Alt combination.
  186. The Lotus replay should be started with the cursor in cell A1.
  187.