home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 108.lha / CoPilot / CoPilot.Manual < prev    next >
Text File  |  1986-11-20  |  45KB  |  1,321 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.           
  10.           
  11.           
  12.           
  13.           
  14.           
  15.           
  16.           
  17.           
  18.           
  19.           
  20.           
  21.           
  22.           
  23.           
  24.                                   CoPilot 1.01
  25.                                  --------------
  26.           
  27.                                        by
  28.           
  29.                                   Jack Radigan
  30.           
  31.           
  32.                     Copyright (C) 1988, all rights reserved.
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.           
  75.           
  76.  
  77.                                    DISCLAIMER
  78.                                   ------------
  79.           
  80.              No warranties are expressed or  implied as to the fitness
  81.           or  mechantability  of  this   program  for  any  particular
  82.           purpose.  The user assumes all  risks and the responsibility
  83.           of  any  damages  arising from  the  use or  misuse  of this
  84.           program.  Outright bugs or problems inherent to CoPilot will
  85.           not be ignored and will be corrected when necessary,  and if
  86.           possible, in a timely manner.
  87.           
  88.           
  89.           
  90.                                 USE RESTRICTIONS
  91.                                ------------------
  92.           
  93.              As a  registered  user you  may  use this program  on any
  94.           Amiga  computer  you  personally  own  AND  use.  Yes,  this
  95.           includes having more  than one  machine running at  the same
  96.           time as  long  as YOU  are  the only  person  operating each
  97.           machine.  You are also entitled to  as many backup copies as
  98.           you see fit.
  99.           
  100.              This right  is  not applicable  to corporate  entities or
  101.           commercial establishments.  A site license  must be obtained
  102.           for  the  use  of  multiple  copies of  CoPilot  under these
  103.           circumstances.   Please   write   for  further   information
  104.           concerning site licenses.
  105.           
  106.              Distribution or transmittal  of this  program and or it's
  107.           documentation  by  any  means  to  any person  or electronic
  108.           device other than your own is strictly prohibited.
  109.           
  110.           
  111.           
  112.                                 ACKNOWLEDGMENTS
  113.                                -----------------
  114.           
  115.              CoPilot was developed with:
  116.           
  117.                     Aztec C68k 3.40a (C) 1987 Manx Software.
  118.                     Lint 2.00j (C) 1987 Gimpel Software.
  119.                     MicroEMACS 3.9a (C) 1987 Dan Lawerence.
  120.           
  121.           
  122.           
  123.              Amiga,  AmigaDOS,  Kickstart, Workbench and Intuition are
  124.           trademarks of Commodore-Amiga Inc.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                             TABLE OF CONTENTS
  135.           
  136.           1. - Hardware Requirements. . . . . . . . . . . . . . . .  1
  137.           
  138.           2. - Starting CoPilot . . . . . . . . . . . . . . . . . .  1
  139.             2.1. - From the CLI . . . . . . . . . . . . . . . . . .  1
  140.             2.2. - From Workbench . . . . . . . . . . . . . . . . .  1
  141.             2.3. - From the Startup-Sequence. . . . . . . . . . . .  1
  142.             2.4. - The Default Macro Definition File. . . . . . . .  1
  143.           
  144.           3. - Time-of-day display. . . . . . . . . . . . . . . . .  1
  145.           
  146.           4. - Keyboard Conventions . . . . . . . . . . . . . . . .  2
  147.           
  148.           5. - Gadget Conventions . . . . . . . . . . . . . . . . .  2
  149.           
  150.           6. - Hotkeys. . . . . . . . . . . . . . . . . . . . . . .  3
  151.             6.1. - CoPilot Hotkeys. . . . . . . . . . . . . . . . .  3
  152.               6.1.1. - <L-ALT><R-ALT> open-menu . . . . . . . . . .  3
  153.               6.1.2. - <L-AMIGA><R-AMIGA> display-to-front. . . . .  3
  154.             6.2. - Display Management Hotkeys . . . . . . . . . . .  4
  155.               6.2.1. - <L-ALT><L-AMIGA> screen-to-back. . . . . . .  4
  156.               6.2.2. - <R-ALT><R-AMIGA> window-to-back. . . . . . .  4
  157.               6.2.3. - <R-ALT><R-SHIFT> activate-next-window. . . .  4
  158.               6.2.4. - <R-AMIGA><R-SHIFT> window-to-front . . . . .  4
  159.               6.2.5. - <CTRL><ESC> close-window . . . . . . . . . .  4
  160.               6.2.6. - <L-ALT><ENTER> move-mouse. . . . . . . . . .  4
  161.             6.3. - Hotkey notes . . . . . . . . . . . . . . . . . .  5
  162.           
  163.           7. - Main Menu. . . . . . . . . . . . . . . . . . . . . .  5
  164.             7.1. - Auto Pilot . . . . . . . . . . . . . . . . . . .  5
  165.             7.2. - Date . . . . . . . . . . . . . . . . . . . . . .  5
  166.             7.3. - New CLI. . . . . . . . . . . . . . . . . . . . .  5
  167.             7.4. - Quick Timer. . . . . . . . . . . . . . . . . . .  5
  168.               7.4.1. - Elapsed Timer. . . . . . . . . . . . . . . .  6
  169.               7.4.2. - Alarm Timer. . . . . . . . . . . . . . . . .  6
  170.             7.5. - Keyboard Macros. . . . . . . . . . . . . . . . .  7
  171.               7.5.1. - Defining New Macros. . . . . . . . . . . . .  7
  172.               7.5.2. - Adding Lines To String Macros. . . . . . . .  7
  173.               7.5.4. - Entering Control Characters. . . . . . . . .  8
  174.               7.5.5. - Editing String Macros. . . . . . . . . . . .  8
  175.               7.5.6. - Macro Quick-Find . . . . . . . . . . . . . .  9
  176.               7.5.7. - Using a Screen Editor. . . . . . . . . . . .  9
  177.               7.5.8. - Recording Macros . . . . . . . . . . . . . . 10
  178.               7.5.9. - Deleting Macros. . . . . . . . . . . . . . . 11
  179.               7.5.10. - Loading and Saving Macro Definitions. . . . 11
  180.               7.5.11. - The LoadMacros Program. . . . . . . . . . . 11
  181.             7.6. - Settings . . . . . . . . . . . . . . . . . . . . 12
  182.               7.6.1. - ASCII Bell . . . . . . . . . . . . . . . . . 12
  183.               7.6.2. - Free Memory. . . . . . . . . . . . . . . . . 12
  184.               7.6.3. - Time Mode 24 . . . . . . . . . . . . . . . . 12
  185.               7.6.4. - Screen Saver . . . . . . . . . . . . . . . . 12
  186.  
  187.  
  188.  
  189.           
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           
  196.  
  197.  
  198.  
  199.  
  200.               7.6.5. - Gadget Offset. . . . . . . . . . . . . . . . 12
  201.               7.6.6. - Enable Macros. . . . . . . . . . . . . . . . 13
  202.               7.6.7. - Hotkey Enable. . . . . . . . . . . . . . . . 13
  203.               7.6.8. - Display Pop-Up . . . . . . . . . . . . . . . 13
  204.               7.6.9. - Editor Pathname String Gadget. . . . . . . . 13
  205.           
  206.           8. - Window Posistion Memory. . . . . . . . . . . . . . . 13
  207.           
  208.           9. - Error Handling and Messages. . . . . . . . . . . . . 13
  209.           
  210.           10. - Compatibility Considerations. . . . . . . . . . . . 14
  211.           
  212.           11. - Features not yet included . . . . . . . . . . . . . 14
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.           
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                            CoPilot 1.01 Users Manual
  267.  
  268.  
  269.           
  270.           
  271.           1. - Hardware Requirements
  272.           
  273.              CoPilot may be used on the Amiga 500, 1000 or 2000 series
  274.           of computers.  Kickstart 1.2  or greater,  with a minimum of
  275.           256k   of   memory  is   also  required.   CoPilot  occupies
  276.           approximatly  80k  of  memory  when  loaded.  This does  not
  277.           include any memory for user defined macros.
  278.           
  279.           
  280.           2. - Starting CoPilot
  281.           
  282.              CoPilot may be started from the CLI or from Workbench, or
  283.           it can  be  started from  the Startup-Sequence file  that is
  284.           executed when the Amiga is booted.
  285.           
  286.           
  287.           2.1. - From the CLI
  288.           
  289.              Use the AmigaDOS "Run" command  to start CoPilot from the
  290.           CLI.
  291.           
  292.           
  293.           2.2. - From Workbench
  294.           
  295.              Double-clicking the CoPilot icon  will start CoPilot from
  296.           Workbench.
  297.           
  298.           
  299.           2.3. - From the Startup-Sequence
  300.           
  301.              The method of starting  CoPilot from the Startup-Sequence
  302.           file depends  on  if you  are using  Workbench too.  For CLI
  303.           users it is sufficient to "Run CoPilot", but Workbench users
  304.           who wish to start CoPilot from the Startup-Sequence must use
  305.           the program "RunBack"  in order to  allow the initial CLI to
  306.           terminate.  The program and documentation have been included
  307.           with CoPilot for your convenience.
  308.           
  309.           
  310.           2.4. - The Default Macro Definition File
  311.           
  312.              When  CoPilot  is  first started  it attempts  to  load a
  313.           default macro  file  named "CoPilot.macros".  There are  two
  314.           places it will look  for this file.  The first is  a logical
  315.           directory  named  "COPILOT:"  which   you  assign  with  the
  316.           AmigaDOS Assign command.  If the logical  directory does not
  317.           exist the current directory will be searched.
  318.           
  319.              Otherwise,  a requester  will be  displayed to inform you
  320.           that it had not found the file.
  321.           
  322.           
  323.  
  324.  
  325.  
  326.                                      - 1 -
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                            CoPilot 1.01 Users Manual
  333.  
  334.  
  335.           3. - Time-of-day display
  336.           
  337.              CoPilot provides  a time-of-day  display which resides in
  338.           the upper  right corner  of the Amiga's screen.  The default
  339.           time format is 12 hour with  an am/pm indicator and flashing
  340.           colon.
  341.           
  342.              CoPilot uses the  display to  indicate when certain modes
  343.           are active while using CoPilot. There are also other display
  344.           options available to you for  displaying 24 hour time format
  345.           and for displaying  the amount of  free chip and fast memory
  346.           left in the system.
  347.           
  348.           
  349.           4. - Keyboard Conventions
  350.           
  351.              All  references  to   keys  are   made  with   the  usage
  352.           "<KEYNAME>".  The term "hotkey" refers to a CoPilot function
  353.           that is permanently bound to  a specific key combination.  A
  354.           "keyboard macro" or "macro key"  refers to a key combination
  355.           that is defined by you.  These macros can  either record all
  356.           mouse  and  keyboard  activity or  can contain  text strings
  357.           only.
  358.           
  359.              CoPilot has several hotkeys which  control itself and the
  360.           Amiga  display.  All  hotkeys  are presented  in the  format
  361.           "<KEY1><KEY2>",  both keys must be pressed simultaneously in
  362.           order to  activate  the hotkey's function.  The designations
  363.           "L-" and  "R-"  refer to the  left and right  version of the
  364.           specified key.
  365.           
  366.              The  term  "AMIGA"   refers  to   the  two  keys  located
  367.           immediately to  the  left and  right of the  space bar.  The
  368.           majority of Amiga  keyboards have a  letter 'A' as  the logo
  369.           denoting an "AMIGA" key,  while some of the keyboards on the
  370.           500 and 2000 machines use different logos.
  371.           
  372.           
  373.           5. - Gadget Conventions
  374.           
  375.              All of the gadgets in CoPilot  windows may be selected by
  376.           either using  the  mouse or  pressing  the key of  the first
  377.           letter  for   the  desired   gadget.  CoPilot  gadgets  also
  378.           subscribe  to  a  set of  conventions that  are  detailed as
  379.           follows.
  380.           
  381.              Selection gadgets  are rectangular  with rounded corners,
  382.           there are  two types,  represented by  the  colors white and
  383.           Workbench red. The white gadgets either select a function or
  384.           change windows within CoPilot.
  385.           
  386.              The red ones represent caution  since their function will
  387.           produce permanent results that cannot be recovered from. For
  388.           example,  the "Load" and "Save" gadgets  in the Macro Editor
  389.  
  390.  
  391.  
  392.                                      - 2 -
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                            CoPilot 1.01 Users Manual
  399.  
  400.  
  401.           will change your macro definitions PERMANENTLY.
  402.           
  403.              The next class of gadget is a  circle that may or may not
  404.           have a  dot inside.  These are toggle  buttons that indicate
  405.           the state  of the  feature the  gadget represents.  The dot,
  406.           when present, means that the feature is currently active.
  407.           
  408.              Another  indicating  gadget  is  a rectangle  with square
  409.           corners.  They have  a  red border and  red text on  a black
  410.           background.  These gadgets  show what  the current  mode is,
  411.           selecting it will change modes.
  412.           
  413.              The last special gadget is the cursor gadget, it is bound
  414.           to the cursor  key it represents.  Currently,  these gadgets
  415.           are used in the Macro Editor  to navigate through each macro
  416.           definition.
  417.           
  418.              You can also activate any  of CoPilot's string gadgets by
  419.           pressing <RETURN> instead  of clicking  the gadget  with the
  420.           mouse.
  421.           
  422.           
  423.           6. - Hotkeys
  424.           
  425.              There are several functions that  are assigned to certain
  426.           key combinations.  Some of  these "hotkeys"  will affect the
  427.           Amiga's window and screen display and others control CoPilot
  428.           itself.
  429.           
  430.           
  431.           6.1. - CoPilot Hotkeys
  432.           
  433.              There are two hotkeys that  directly control CoPilot that
  434.           are described below.  One other hotkey is used by CoPilot to
  435.           stop recording a macro or to stop playback of a macro.  That
  436.           hotkey is discussed in the Macros section.
  437.           
  438.           
  439.           6.1.1. - <L-ALT><R-ALT> open-menu
  440.           
  441.              When CoPilot  is idle,  this hotkey  will  open the  main
  442.           menu.  If one  of CoPilot's  windows is  already open,  this
  443.           hotkey will  re-activate it.  If the window  is partially or
  444.           completely covered it  will be  moved to  the front.  If the
  445.           screen  that  the  window was  originally opened  on  is now
  446.           covered by  another  screen the  window will  be  closed and
  447.           re-opened on the front screen.
  448.           
  449.           
  450.           6.1.2. - <L-AMIGA><R-AMIGA> display-to-front
  451.           
  452.              This hotkey  will  bring the  time-of-day display  to the
  453.           front  screen.  I  had  wanted  to  make the  pop-up feature
  454.           described in section 7.6.8 below do this automatically.  But
  455.  
  456.  
  457.  
  458.                                      - 3 -
  459.  
  460.  
  461.  
  462.  
  463.  
  464.                            CoPilot 1.01 Users Manual
  465.  
  466.  
  467.           attempts  at  making  the pop-up  work across  screens would
  468.           occasionally cause the  Amiga to guru.  So,  I have included
  469.           this hotkey instead.  But,  this hotkey gives  you the added
  470.           responsibility of  moving CoPilot  to another  screen BEFORE
  471.           closing the  current screen.  Otherwise you may  get a visit
  472.           from the guru!
  473.           
  474.           
  475.           6.2. - Display Management Hotkeys
  476.           
  477.              CoPilot also  provides  you with  a set  of  hotkeys that
  478.           control the Amiga's display in a very flexible manner.
  479.           
  480.           
  481.           6.2.1. - <L-ALT><L-AMIGA> screen-to-back
  482.           
  483.              Moves the front screen to the back of all screens.
  484.           
  485.           
  486.           6.2.2. - <R-ALT><R-AMIGA> window-to-back
  487.           
  488.              Moves the active  window to  the back and  then activates
  489.           the  next  window  in  the  window  list.  If the  window is
  490.           partially or completely covered by another window it will be
  491.           moved to the front of the screen.  This hotkey will not work
  492.           if the active window has a string gadget active.
  493.           
  494.           
  495.           6.2.3. - <R-ALT><R-SHIFT> activate-next-window
  496.           
  497.              Activate the next window in the window list.  This hotkey
  498.           will not  work  if the  active  window has  a  string gadget
  499.           active.
  500.           
  501.           
  502.           6.2.4. - <R-AMIGA><R-SHIFT> window-to-front
  503.           
  504.              Bring  the  active  window to  the front  of  the screen.
  505.           Again, this hotkey will not work if the window has an active
  506.           string gadget.
  507.           
  508.           
  509.           6.2.5. - <CTRL><ESC> close-window
  510.           
  511.              Close  current  window  if it  has a  close gadget.  This
  512.           feature is implemented by moving  the mouse pointer over the
  513.           close  gadget  and  simulating  a  press of  the  left mouse
  514.           button.
  515.           
  516.           
  517.           6.2.6. - <L-ALT><ENTER> move-mouse
  518.           
  519.              Moves mouse pointer to the  lower right corner of screen.
  520.           This  is  not  the <RETURN>,  it's the  <ENTER>  key on  the
  521.  
  522.  
  523.  
  524.                                      - 4 -
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                            CoPilot 1.01 Users Manual
  531.  
  532.  
  533.           keypad.  This  function  is performed  once when  CoPilot is
  534.           first started up.
  535.           
  536.           
  537.           6.3. - Hotkey notes
  538.           
  539.              Several windows may seem to pop  up and back when you use
  540.           the window-to-back  hotkey after  a new  window(s)  has been
  541.           opened.  This is  because windows,  unlike screens,  are not
  542.           maintained in a true  front to back order.  After using this
  543.           macro a few times CoPilot  will have re-arranged the windows
  544.           so that this  will not happen  again until more  windows are
  545.           opened.
  546.           
  547.              You may also occasionally notice  that all of the windows
  548.           seem  to  be  inactive  after  using the  window-to-back and
  549.           activate-next-window hotkeys.  What actually  happened  is a
  550.           "backdrop" window is now activated.
  551.           
  552.              Backdrop  windows  always  stay   behind  all  the  other
  553.           windows,  so it will never  pop to the front.  Most backdrop
  554.           windows also lack a title so you can't tell that is active.
  555.           
  556.              Two good examples  of backdrop  windows are the Workbench
  557.           screen and the MicroEmacs editor on the Extras disk.
  558.           
  559.           
  560.           7. - Main Menu
  561.           
  562.              The  main  menu  of CoPilot  currently has  six selection
  563.           gadgets, one string gadget and the red "Exit" gadget.
  564.           
  565.           
  566.           7.1. - Auto Pilot
  567.           
  568.              This function will be implemented  in a future release of
  569.           CoPilot.
  570.           
  571.           
  572.           7.2. - Date
  573.           
  574.              The "Date" gadget will display the  day and date for four
  575.           seconds whenever it is selected.
  576.           
  577.           
  578.           7.3. - New CLI
  579.           
  580.              The "New CLI" gadget will  start another CLI for you.  If
  581.           you are using CoPilot from Workbench,  the current directory
  582.           it will  have  will be the  directory that was  current when
  583.           CoPilot was first started.
  584.           
  585.              If  you're  using  CoPilot  from  the  CLI,  the  current
  586.           directory will be the current directory of the AmigaDOS CLI.
  587.  
  588.  
  589.  
  590.                                      - 5 -
  591.  
  592.  
  593.  
  594.  
  595.  
  596.                            CoPilot 1.01 Users Manual
  597.  
  598.  
  599.           7.4. - Quick Timer
  600.           
  601.              The Quick  Timer has  two modes  of operation,  one is an
  602.           elapsed timer and the other is an alarm timer.
  603.           
  604.              The time-of-day  display  is used  to indicate  the state
  605.           that the  Quick  Timer is  in.  When counting,  either up or
  606.           down,  an asterisk '*' will be placed  on either side of the
  607.           time display.  If the  timer  is stopped,  but has  not been
  608.           reset, a dash '-' will be displayed.
  609.           
  610.              The "Timer Display"  gadget is  turned on when  the Quick
  611.           Timer window is first opened.  If you activate the timer and
  612.           do not turn  off this gadget,  the timer will continue to be
  613.           displayed after you close the Quick Timer window.
  614.           
  615.              The "Reset Timer"  gadget will  reset the Quick  Timer to
  616.           zero and can be selected at any time.
  617.           
  618.           
  619.           7.4.1. - Elapsed Timer
  620.           
  621.           
  622.              The elapsed-time mode can be started only while the timer
  623.           is  reset.  Selecting the  "Start/Stop"  gadget toggles  the
  624.           elapsed timer the same as a stop watch.
  625.           
  626.           
  627.           7.4.2. - Alarm Timer
  628.           
  629.              There are two  methods of  setting the  alarm timer.  The
  630.           first is by  using the  gadget labeled "Add  15 min.".  This
  631.           lets you set the alarm timer in increments of 15 minutes.
  632.           
  633.              The string gadget labeled "Set:" enables you to enter any
  634.           time value  you want.  To activate the gadget,  simply press
  635.           <RETURN> then enter the time in the following format:
  636.           
  637.                                     HH:MM:SS
  638.           
  639.              CoPilot requires you  to enter the  colons so that it can
  640.           distinguish  between  hours,  minutes and  seconds,  leading
  641.           zeros are not necessary. The minutes and seconds entries can
  642.           not exceed  59.  The hours entry  has an  upper limit  of 99
  643.           hours. The following are all valid entries as far as CoPilot
  644.           is concerned.
  645.           
  646.                39:37:20    -   39 hours, 37 minutes, 20 seconds.
  647.                :10:        -    0  ""    10   ""      0    ""
  648.                ::20        -    0  ""     0   ""     20    ""
  649.           
  650.              If the  time  entered is  an  illegal format or  the time
  651.           requested is  outside the  range of  99:59:59,  you will  be
  652.           informed by CoPilot with a message requester.
  653.  
  654.  
  655.  
  656.                                      - 6 -
  657.  
  658.  
  659.  
  660.  
  661.  
  662.                            CoPilot 1.01 Users Manual
  663.  
  664.  
  665.              After the  desired  time is set,  select the "Start/Stop"
  666.           gadget to  start the  alarm counting  down.  When the  alarm
  667.           times out,  CoPilot will  open Quick  Timer and  three beeps
  668.           will sound every  second until  you select the "Reset Timer"
  669.           gadget.
  670.           
  671.           
  672.           7.5. - Keyboard Macros
  673.           
  674.              Each of  the  46 alpha-numeric  keys located in  the main
  675.           portion of  the  keyboard can have  up to 6  macros defined.
  676.           This is accomplished by using "qualifiers" which are two key
  677.           combinations of the <CTRL>, <ALT> and <AMIGA> keys.
  678.           
  679.              The three qualifiers are:
  680.           
  681.                 <CTRL><ALT>  or  <CTRL><AMIGA>  or  <ALT><AMIGA>
  682.           
  683.              So, each key can have 3 macros defined for the un-shifted
  684.           key and  3 more  for the  shifted version.  This gives you a
  685.           total of 276 keyboard macros.  You may find it convienent to
  686.           use your left  hand to control  the qualifier and shift keys
  687.           while using your right hand to press the desired macro key.
  688.           
  689.           
  690.           7.5.1. - Defining New Macros
  691.           
  692.              To define  a  new macro,  you first  set  the "Qualifier"
  693.           gadget to the  combination that you  will use for the macro.
  694.           Then select the toggle gadget labeled "New".  Remember,  you
  695.           can select a gadget by pressing  the key of the first letter
  696.           of the gadget you want.
  697.           
  698.              After you actvate  the new-macro  mode the  string gadget
  699.           labeled "Key"  will activate,  the character you  enter here
  700.           determines which keyboard macro you are going to define.
  701.           
  702.              After entering the desired macro key,  the gadget labeled
  703.           "Type:" will change color indicating  that you are to select
  704.           the macro type.  By pressing <RETURN> you  tell CoPilot that
  705.           you want a string macro. If you select the "Type" gadget, by
  706.           mouse  or  by  pressing <T>,  you will  instruct  CoPilot to
  707.           record this macro.
  708.           
  709.              If you press <RETURN> before  entering a character in the
  710.           key string gadget,  you will activate the screen-editor mode
  711.           which allows  you  to create a  string macro using  a screen
  712.           editor.
  713.           
  714.              You can exit the new-macro mode  by turning off the "New"
  715.           gadget or by  pressing <RETURN>  until both "New" and "Edit"
  716.           are off.
  717.           
  718.           
  719.  
  720.  
  721.  
  722.                                      - 7 -
  723.  
  724.  
  725.  
  726.  
  727.  
  728.                            CoPilot 1.01 Users Manual
  729.  
  730.  
  731.           7.5.2. - Adding Lines To String Macros
  732.           
  733.              After  pressing  <RETURN>  in  response  to  the  "Type:"
  734.           gadget,  the gadget labeled "Add line"  will turn on and the
  735.           edit string gadget  will activate.  This indicates  that you
  736.           are in the add-line mode.  This mode is used for both making
  737.           new macros and for adding lines to an existing macro.
  738.           
  739.              The edit string can have a maximum of 132 characters, but
  740.           can display only  35 of  them at any  one time.  In case you
  741.           want to abort any changes you've made while editing, use the
  742.           <R-AMIGA>-Q  sequence.  If  you  want  to  clear the  string
  743.           gadget,  use  the  <R-AMIGA>-X sequence.  Both of  these are
  744.           standard  Intuition  features for  string gadgets  that have
  745.           "undo" buffers attached to them.
  746.           
  747.              When  you  are  finished  with  the line  of text,  press
  748.           <RETURN>.  This adds the  line of  text to the  macro you're
  749.           working on.  The gadget  will clear  and reactivate again so
  750.           that you can add another line of text.
  751.           
  752.              When you've  finished entering  the text you want,  press
  753.           <RETURN> while  the string  gadget is empty.  This will turn
  754.           off the  add-line  mode and,  if you are  in new-macro mode,
  755.           re-activate the  key  string gadget  so that you  can create
  756.           another macro.
  757.           
  758.           
  759.           7.5.4. - Entering Control Characters
  760.           
  761.              Since Intuition string gadgets do  not allow you to enter
  762.           control  characters,  a  method  of entering  them has  been
  763.           provided  for  you.  By preceeding  a character  with a  '^'
  764.           character,  CoPilot will interpet it as a control character.
  765.           For  example,  the  sequence  "^m" will  be interpeted  as a
  766.           <RETURN>.  The sequence "^[" will be  interpeted as an <ESC>
  767.           key.  To include the '^' character itself,  use the sequence
  768.           "^^".
  769.           
  770.              Be aware that  pressing <RETURN>  only enters that string
  771.           into the  macro definition.  It will not become  part of the
  772.           macro,  if you need  a <RETURN>,  you must include  the "^m"
  773.           sequence as described above.
  774.           
  775.           
  776.           7.5.5. - Editing String Macros
  777.           
  778.              Several options are available to you for editing a string
  779.           macro that is  already defined.  First,  set the "Qualifier"
  780.           gadget to the correct combination for  the macro you wish to
  781.           edit.  Then,  use the left  or right  cursor keys  to scroll
  782.           through the macros  until the macro  key you want to edit is
  783.           visible.
  784.           
  785.  
  786.  
  787.  
  788.                                      - 8 -
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                            CoPilot 1.01 Users Manual
  795.  
  796.  
  797.              If the line you wish to  change is already visible in the
  798.           edit  string,  all  you  have  to  do  is press  <RETURN> to
  799.           activate  the  string  gadget.  Edit  the  string  and press
  800.           <RETURN> when finished.
  801.           
  802.              If the macro  contains more than  one line and the string
  803.           you want to edit is not currently displayed,  use the up and
  804.           down cursors to  find the  string you want to change.  Press
  805.           <RETURN> to activate and edit as above.
  806.           
  807.              If you  want to  add a one  or more lines of  text to the
  808.           macro,  turn  the  "Add  line"  gadget button  on.  Pressing
  809.           <RETURN> in an empty line will turn off the add-line mode.
  810.           
  811.              If you  need  to insert a  line of text  somewhere in the
  812.           middle of the  macro definition or  wish to add lines at the
  813.           beginning of the macro,  activate the "Insert  line" gadget.
  814.           Like the add-line mode,  pressing return on  an empty string
  815.           will turn  off  the insert-line  mode.  The inserted line(s)
  816.           will be placed ahead of the line that was displayed when you
  817.           activated the insert line mode.
  818.           
  819.           
  820.           7.5.6. - Macro Quick-Find
  821.           
  822.              The edit string always activates after pressing <RETURN>,
  823.           but by pressing  <RETURN> twice in  a row you  will activate
  824.           the key string gadget. You are now in quick-find mode which,
  825.           by entering  a key,  will search  the  macro definitions and
  826.           display it if found.  A message requester will inform you if
  827.           it is not defined yet.
  828.           
  829.           
  830.           7.5.7. - Using a Screen Editor
  831.           
  832.              The button  gadget  labeled "Edit"  allows you  to  use a
  833.           screen editor for creating  and changing string macros.  The
  834.           screen editor used  is the  AmigaDOS Ed by default,  you can
  835.           request CoPilot to  use a  different editor by  changing the
  836.           default pathname in the Settings window discussed below.
  837.           
  838.              Instead of  the "Type:"  gadget lighting up,  you will be
  839.           placed in the  default editor for  the Amiga which  is "Ed".
  840.           You must follow  the same  conventions for  entering control
  841.           characters as described above.
  842.           
  843.              You can  also  use the screen  editor to modify  a string
  844.           macro by selecting the "Edit" gadget when the macro you wish
  845.           to edit is visible.
  846.           
  847.              When you leave  the screen editor,  the entries  you made
  848.           will be translated by CoPilot and attached to the macro key.
  849.           If you decide to exit the editor with the abort command, the
  850.           macro will be unchanged. If it was a new macro, CoPilot will
  851.  
  852.  
  853.  
  854.                                      - 9 -
  855.  
  856.  
  857.  
  858.  
  859.  
  860.                            CoPilot 1.01 Users Manual
  861.  
  862.  
  863.           remove it from the macro list.
  864.           
  865.              All null lines  will be deleted  when the edited  file is
  866.           converted to a macro.  Include a space if  you want the line
  867.           to remain.
  868.           
  869.           
  870.           7.5.8. - Recording Macros
  871.           
  872.              Selecting the "Type:" gadget while  in the new-macro mode
  873.           will open up a requester in front of the Macro Editor.  This
  874.           requester lets  you  enter an  optional description  of what
  875.           you're about to record  and toggle the mouse-movement-record
  876.           mode.
  877.           
  878.              The button gadget "Record mouse  movement" enables you to
  879.           record actual mouse  movement while  either mouse  button is
  880.           pressed.  Be careful  though,  this feature can  generate an
  881.           awful  lot  of  data  very  quickly!  It  was  included  for
  882.           completeness of the  record function,  but will  probably be
  883.           rarely used.
  884.           
  885.              If you  select  the "OK"  gadget or press  <RETURN> after
  886.           entering the description string,  both the requester and the
  887.           Macro Editor  will close.  You will  now be  in record mode,
  888.           which is signified by the two  question marks that appear in
  889.           the time-of-day display.
  890.           
  891.              From this point on, all key and mouse button presses will
  892.           be recorded  by CoPilot.  It also records the  time that has
  893.           elapsed between  each  event so  that  it can play  back the
  894.           macro accurately.
  895.           
  896.              When you are  finished recording,  you notify  CoPilot by
  897.           pressing  both  <SHIFT>  keys  simultaneously.  The question
  898.           marks will disappear and the  Macro Editor will re-open with
  899.           the key string  gadget active so  that you can add your next
  900.           macro.  Also,  if  you  open the  Macro Editor  window while
  901.           recording CoPilot  will  stop the  recording as  if  you had
  902.           pressed both <SHIFT> keys yourself.
  903.           
  904.              The double shift key sequence can  also be used to cancel
  905.           the playback of a recorded macro at anytime. Two exclamation
  906.           points  will  appear  in  the  time-of-day  display  while a
  907.           recorded macro is being played back.
  908.           
  909.              At the  present time,  there is  no method  of editing or
  910.           appending the recorded data in a macro.  You must remove the
  911.           macro from  the  list and then  re-record it if  you want it
  912.           changed.
  913.           
  914.              One last word on recorded macros before moving on. If the
  915.           operation that you're recording  causes a disk access,  say,
  916.           loading one of the libraries from the system disk, make sure
  917.  
  918.  
  919.  
  920.                                      - 10 -
  921.  
  922.  
  923.  
  924.  
  925.  
  926.                            CoPilot 1.01 Users Manual
  927.  
  928.  
  929.           you record  the  macro prior  to having the  library loaded.
  930.           Otherwise,  the correct  time delays  will not  be recorded.
  931.           This will cause the macro to get out of synch if the library
  932.           has to be loaded during playback.
  933.           
  934.           
  935.           7.5.9. - Deleting Macros
  936.           
  937.              The gadget labeled "Remove" will delete the macro that is
  938.           currently displayed  in  the key string.  The gadget labeled
  939.           "Delete"  will  delete  line  that  is visible  in  the edit
  940.           string.  If you delete the last line of a string macro,  the
  941.           whole macro will be removed too.
  942.           
  943.              The labels "Remove"  and "Delete"  were used so that full
  944.           keyboard usage could be achieved,  hope it doesn't throw you
  945.           off too much at first!
  946.           
  947.           
  948.           7.5.10. - Loading and Saving Macro Definitions
  949.           
  950.              By default, the macro definitions will be loaded or saved
  951.           to  the  "CoPilot.macros"  definition   file.  If  you  have
  952.           assigned "COPILOT:" to  a directory  then the  full pathname
  953.           would be "COPILOT:CoPilot.macros".  Otherwise, the file will
  954.           be saved to  the current  directory that CoPilot was started
  955.           from.
  956.           
  957.              When either  gadget  is selected,  a requester  will open
  958.           with a string gadget activated.  The pathname will be in the
  959.           string gadget,  by pressing  <RETURN> you  will confirm that
  960.           you  wish  to  load  or  save  the  definitions  using  this
  961.           pathname.  Edit  the   pathname  if   you  wish   the  macro
  962.           definitions to  be  loaded or saved  to or from  a different
  963.           macro file.
  964.           
  965.              When saving macro definitions there  must be at least one
  966.           macro defined. Otherwise, a macro defintion file will not be
  967.           created.
  968.           
  969.              You may cancel a load or  save operation by selecting the
  970.           "CANCEL" gadget.
  971.           
  972.           
  973.           7.5.11. - The LoadMacros Program
  974.           
  975.              This program  gives  you the  ability to tell  CoPilot to
  976.           load a macro  definition file  with a CLI command.  The best
  977.           use you  will find  for this program  is to include  it in a
  978.           batch file  for  loading a  macro file that  has definitions
  979.           that are specific to an application.
  980.           
  981.              LoadMacros  has  exactly  one   parameter,  the  complete
  982.           pathname of a macro definition file you wish CoPilot to load
  983.  
  984.  
  985.  
  986.                                      - 11 -
  987.  
  988.  
  989.  
  990.  
  991.  
  992.                            CoPilot 1.01 Users Manual
  993.  
  994.  
  995.           for you. For example, typing the the command
  996.           
  997.                              LoadMacros Comm:macros
  998.           
  999.              will load the  macro defintion  file named  "macros" from
  1000.           the volume labled "Comm".
  1001.           
  1002.              If CoPilot is  not running  LoadMacros will not continue.
  1003.           It also checks that exactly one  pathname was entered on the
  1004.           command line.
  1005.           
  1006.           
  1007.           7.6. - Settings
  1008.           
  1009.              The Settings  window provides  eight toggle  buttons that
  1010.           control certain  features  within CoPilot.  There is  also a
  1011.           string gadget for changing the default screen editor used by
  1012.           the Macro Editor.
  1013.           
  1014.           
  1015.           7.6.1. - ASCII Bell
  1016.           
  1017.              Normally,  the Amiga  rapidly flashes  the display  for a
  1018.           brief instant when either an error occurs or when a <CTRL>-G
  1019.           character is sensed.  With CoPilot,  you now have the option
  1020.           of sounding a bell instead.  This feature is controlled with
  1021.           the "ASCII bell" gadget.
  1022.           
  1023.           
  1024.           7.6.2. - Free Memory
  1025.           
  1026.              The "Free memory"  gadget will  display chip and fast ram
  1027.           that  is  currently available.  The display  will  remain on
  1028.           until this gadget is turned off again.
  1029.           
  1030.           
  1031.           7.6.3. - Time Mode 24
  1032.           
  1033.              The gadget "Time mode 24" will display the time-of-day in
  1034.           24  hour  format.  This format  displays hours,  minutes and
  1035.           seconds.
  1036.           
  1037.           
  1038.           7.6.4. - Screen Saver
  1039.           
  1040.              The  "Screen  saver",  when  active,  will  turn  off the
  1041.           Amiga's display after five minutes without keyboard or mouse
  1042.           button activity.  This feature prevents the phosphor in your
  1043.           monitor from being burned out.  To turn the  display back on
  1044.           press any key or mouse button. This event will be trapped so
  1045.           that the active window does not receive it.
  1046.           
  1047.           
  1048.           7.6.5. - Gadget Offset
  1049.  
  1050.  
  1051.  
  1052.                                      - 12 -
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.                            CoPilot 1.01 Users Manual
  1059.  
  1060.  
  1061.              The "Gadget  offset" deals  with the clock display.  When
  1062.           active,  the display is posistioned to the immediate left of
  1063.           the depth gadgets.  When off,  the display will be placed to
  1064.           the extreme right of the title.
  1065.           
  1066.           
  1067.           7.6.6. - Enable Macros
  1068.           
  1069.              "Enable  macros",  when  active,  allows CoPilot  to send
  1070.           keyboard macros.  This was added in case the macros intefere
  1071.           with another application that you're running.
  1072.           
  1073.           
  1074.           7.6.7. - Hotkey Enable
  1075.           
  1076.              Like  the  "Enable  macros"  gadget  above,  the  "Hotkey
  1077.           enable" gadget will activate the hotkeys used by CoPilot.
  1078.           
  1079.           
  1080.           7.6.8. - Display Pop-Up
  1081.           
  1082.              When the  "Display pop-up"  gadget is  active,  the clock
  1083.           display will pop  to the front  of the current  screen it is
  1084.           attached to whenever  it is  covered by  another window.  As
  1085.           described in section  6.1 above,  this feature will not move
  1086.           the clock  to  another screen  when the screens  are changed
  1087.           because of the possibility of a guru occuring.
  1088.           
  1089.           
  1090.           7.6.9. - Editor Pathname String Gadget
  1091.           
  1092.              The string gadget labeled "Editor" is where you place the
  1093.           full path name of  the text editor  you wish to  use for the
  1094.           macro  editor.  This  pathname  will be  saved in  the macro
  1095.           defintion file for  future use.  The default editor pathname
  1096.           is "C:Ed".
  1097.           
  1098.           
  1099.           8. - Window Posistion Memory
  1100.           
  1101.              When any CoPilot window is opened, it will be centered on
  1102.           the front  screen.  If you  drag the  window to  a different
  1103.           location,  CoPilot will  retain this  posistion so  that the
  1104.           window will re-open at the same place again.
  1105.           
  1106.              If you change to a screen that has a different horizontal
  1107.           or vertical resolution,  the window posistion  will be reset
  1108.           to the center when you open the window again.
  1109.           
  1110.           
  1111.           9. - Error Handling and Messages
  1112.           
  1113.              All soft errors are reported by  a requester with an "OK"
  1114.           gadget and an  optional "CANCEL" gadget.  When just the "OK"
  1115.  
  1116.  
  1117.  
  1118.                                      - 13 -
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.                            CoPilot 1.01 Users Manual
  1125.  
  1126.  
  1127.           is present it  is an informational  error that has no impact
  1128.           on  CoPilot  or  the  Amiga.  When  the  "CANCEL"  gadget is
  1129.           present,  you  are  given  a  choice  to go  ahead  with the
  1130.           function  you  selected,  or you  may  cancel that  function
  1131.           without any further incident.
  1132.           
  1133.           
  1134.              Dead-end errors that prevent  CoPilot from continuing are
  1135.           handled via recoverable alerts.
  1136.           
  1137.           
  1138.              You can  test  this by trying  to run CoPilot  again with
  1139.           another CoPilot already running.
  1140.           
  1141.           
  1142.           10. - Compatibility Considerations
  1143.           
  1144.              CoPilot maintains full compatibility  with the Amiga 500,
  1145.           1000 and 2000 computers by  examining the active keymap when
  1146.           it first  starts up.  This is necessary because  there are a
  1147.           few  minor  differences  between  the  keymaps of  the three
  1148.           machines.  For this reason,  you cannot change  keymaps once
  1149.           CoPilot has loaded.
  1150.           
  1151.              CoPilot is fully  compatible with  all the keymaps on the
  1152.           Workbench 1.2 disk and dead-keys are fully supported too.
  1153.           
  1154.              Be  aware  that  using macros  recorded on  one  style of
  1155.           machine  might  not  work  as  expected on  another machine.
  1156.           String macros will not be affected, only recorded ones.
  1157.           
  1158.           
  1159.           11. - Features not yet included
  1160.           
  1161.              The  following  features  described  below are  currently
  1162.           under development.  Some may not be  included in the version
  1163.           you receive  after registering.  You will  be  notified when
  1164.           future versions including these features will be released.
  1165.           
  1166.              Macros  do  not  yet have  the capability  of  calling or
  1167.           "nesting"  other  macros.  If  you  trigger  a  macro  while
  1168.           recording another macro,  all output from the  macro will be
  1169.           recorded too, instead of just the macro key sequence itself.
  1170.           
  1171.              Provisions for  instant screen  blanking will be provided
  1172.           as well as varing the time before blanking occurs.
  1173.           
  1174.              Keyboard lock-out with password protection,  it will have
  1175.           the ability to engage automatically if the screen blanks, or
  1176.           can be activated immediately.
  1177.           
  1178.              An Auto  Pilot facility  is currently being designed.  It
  1179.           will  enable  you  to  trigger  macros  or  execute AmigaDOS
  1180.           commands and/or batch files at programmed time intervals.
  1181.  
  1182.  
  1183.  
  1184.                                      - 14 -
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.                            CoPilot 1.01 Users Manual
  1191.  
  1192.  
  1193.              Due to the  recent outbreak  of virus-like  programs that
  1194.           "infect" disks,  a provision for running a program everytime
  1195.           a disk is inserted is under consideration.
  1196.           
  1197.              Other possibilities  currently under  evaluation are  not
  1198.           discussed  here  because  it's  uncertain  if  they  will be
  1199.           included in a future version of CoPilot.
  1200.           
  1201.              Feel  free  to  submit any  suggestions you  may  have to
  1202.           enhance CoPilot.  Try to stay away  from features that would
  1203.           be best served  as seperate tasks.  One that comes  to mind,
  1204.           and has been played to death,  is the ever popular directory
  1205.           utility.
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.                                      - 15 -
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.                            CoPilot 1.01 Users Manual
  1257.  
  1258.  
  1259.           I can be reached through the following services.
  1260.           
  1261.                BIX           - jradigan
  1262.                GEnie         - JRADIGAN
  1263.                CompuServe    - 76545,201
  1264.                People Link   - JRADIGAN
  1265.                The W.E.L.L.  - jrad
  1266.           
  1267.           
  1268.           
  1269.              Please leave me  e-mail if you  have any problems or have
  1270.           found any bugs.  I ususally call each system  once a week to
  1271.           check for e-mail. If you see a message from me on a BBS then
  1272.           you can try to reach me there too.
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.                                      - 16 -
  1317.  
  1318.  
  1319.  
  1320.  
  1321.