
 HIPRE 3+ KEYBOARD MACROS
 ========================

   HIPRE 3+ contains a keyboard macro recording/running feature. It
   allows you to record and play back a decision analysis session or
   create self-running HIPRE 3+ shows for instructional and demonstration 
   purposes. 

   The macrofiles can be recorded and replayed by giving arguments to 
   HIPRE when starting it from the MSDOS command line.


 RECORDING
 ---------

   To record a keyboad macro start HIPRE 3+ with the REC-option:

     hp -RECfile.mac

   Here 'file.mac' is the name of the macro file where keyboard 
   commands are written.

   When HIPRE is started with the REC option, all the commands given with
   the keyboard are recorded to the file. Notice that the commands
   given by using the mouse are NOT recorded.

   It is possible to stop the recording by pressing <alt-f4> during the 
   recording. By pressing <alt-f4> again the recording can be restarted. 
   After restarting the new commands will be added to the end of the 
   already existing macro file.


 RUNNING
 -------

   To run a recorded macro start HIPRE 3+ with the RUN-option:

     hp -RUNfile.mac
 
   Here 'file.mac' is the name of the file containing the macro commands.


 EDITING
 -------

   After recording the session you usually need to edit the macro file, 
   for example, to adjust the necessary pauses to make the playback speed 
   meet your needs.  

   Editing can be done by any editor capable of handling DOS text files.
   It is also possible to create an entire macro file by typing in the 
   commands to a file.

 
 MACRO FILE FORMAT
 -----------------

   Macro files may contain normal characters, commands that are separated
   by <>-characters and comments that begin with '@'. The normal characters
   are processed by HIPRE as they are. Commands simulate pressing of the 
   special keys, for example the enter key or function keys.

   Line feed and carriage return characters in the macro file are ignored,
   as well as other characters with an ascii code in the range 0..31.

   Comments are started with '@' character and all the characters from '@' 
   to the end of line are ignored.

   Commands:

   <code> = a special key 

     codes:

     starts with 'a' = alt + key
     starts with 'c' = ctrl + key
     starts with 's' = shift + key
     <	             = '<'
     f1 - f0	 = function key, f0 = F10
     A-Z         = corresponding key
     number      = corresponding number key
     bs          = backspace
     dn	         = down
     de	         = del
     en	         = end
     es          = esc
     ho	         = home
     in	         = ins
     le	         = left
     pd	         = pgdn
     pu	         = pgup
     ri	         = right
     rt          = return (enter)
     tb          = tab
     up	         = up

   <code*number>

     repeat code for number of times, max number is 9999

   <*number>

     repeat last key number of times

   <number>

     hold a pause for number of times one tenth of a second between 
     each key command from here on. the pause can be changed at any 
     point by giving a new number. By giving the command '<0>' macro
     running speed is set to maximum. Default running speed is 2.


 AN EXAMPLE
 ----------

   the sequence

     <10><rt><rt><aL><bs*10>tutor2<rt>
 
   corresponds to the following actions

   One second pause between commands from now on, Enter, Enter,
   Alt-L (Load), 10xBackSpace (delete old name), "tutor2", Enter.

   This sequence loads the tutor2-model after startup.

