home *** CD-ROM | disk | FTP | other *** search
/ Amiga Computing 67 / ac067a.adf / ShortCut.doc / ShortCut.doc
Text File  |  1978-04-05  |  6KB  |  138 lines
  1.     ShortCut.doc      version 1.2                 Michael Bradley 25/9/91
  2.  
  3.  
  4.  
  5.                       ShortCut Operating Instructions
  6.  
  7.  
  8.  
  9.         One thing that always annoys me is having to step through hundreds
  10.     of directories just to get to the program that I want, especially when
  11.     it's a program that I use a lot.
  12.  
  13.         This program, especially useful for hard drive owners, was written
  14.     to ease such problems by giving the user up to four menus of frequently
  15.     used programs to select from; selecting a menu item invokes a command
  16.     sequence which has been described by the user.  Each menu item also
  17.     includes a Right-Amiga key short-cut and up to 26 choices can be
  18.     included.
  19.  
  20.         It operates by reading a text file called ShortCut.setup which
  21.     contains the information required to display the names on the menu as
  22.     well as the commands needed to run them.  The program searches for this
  23.     file first in the current directory and then in the s: directory of the
  24.     boot disk.
  25.  
  26.         ShortCut.setup may be edited using any text editor, such as Ed, but
  27.     must be in plain ASCII format.  First, the title of the first menu is
  28.     specified, followed by a # symbol, followed by the entries linked with
  29.     that menu.  Each entry in this list consists of:
  30.  
  31.         1] the name to be shown on the menu
  32.         2] by the command line(s) to be executed
  33.  
  34.         The # symbol must be put after each name and again at the end of the
  35.     sequence of command lines e.g.
  36.  
  37.         Menu 1#
  38.         PopDir#
  39.         run >nil: <nil: SYS:Utilities/DOS/PopDir#
  40.         AmigaShell#
  41.         run >nil: <nil: AShell WINDOW "NEWCON:0/180/400/76/ARP AmigaShell"#
  42.  
  43.         This will give you two menu items: PopDir and AmigaShell
  44.         The single menu that comes up is called Menu 1
  45.         (Don't leave any blank lines in the text.)
  46.  
  47.         Always put RUN at the beginning of any command that isn't completed
  48.     instantly, so that ShortCut is able to multitask properly.  Unfortunately
  49.     the CBM run command appears to cause a software failure when an error
  50.     occurs, such as when a file can't be found (programmers see note below),
  51.     so to avoid this, always put >nil: <nil: after RUN.  Alternatively use
  52.     RUNBACK etc. or the ARP run command, where the problem doesn't arise.
  53.  
  54.         The purpose of the # sign is to allow for multi-line command
  55.     sequences as in the following:
  56.  
  57.         ZeroVirus#
  58.         cd SYS:Utilities/ZeroVirus
  59.         run >nil: <nil: ZeroVirus#
  60.  
  61.         Changing the directory is sometimes necessary for programs which
  62.     have to read setup files which are in the same directory as the program
  63.     itself.  It is also useful for placing the program being run into a
  64.     particular directory:
  65.  
  66.         DPaint#
  67.         cd dh1:Pictures
  68.         run DPaint:DPaint#
  69.  
  70.         Here, DPaint will always bring you directly to the Pictures
  71.     directory on dh1: when you first try to load a screen.
  72.  
  73.         To instruct ShortCut to take a new menu, the $ symbol must be
  74.     inserted at the end of the last command of the previous menu, in place
  75.     of the # symbol that would normally be stated:
  76.  
  77.         Menu 1#
  78.         PopDir#
  79.         run >nil: <nil: SYS:Utilities/DOS/PopDir$
  80.         Menu 2#
  81.         AmigaShell#
  82.         run >nil: <nil: AShell WINDOW "NEWCON:0/180/400/76/ARP AmigaShell"#
  83.  
  84.         This will give two menus; Menu 1 and Menu 2, the first containing
  85.     PopDir and the second containing AmigaShell.
  86.  
  87.         To run ShortCut from cli, type
  88.  
  89.             run >nil: <nil: ShortCut
  90.  
  91.         From Workbench, simply double-click on the icon.
  92.  
  93.         There is another file, ShortCut.Extra, which allows up to 100 menu
  94.     items, but has no keyboard short cuts.  This was specially written for
  95.     Dave Hartje, I hope he likes it!
  96.  
  97.         ShortCut is a public domain program and may be distributed freely
  98.     by anyone, or for a minimal charge only, by any Public Domain library.
  99.     It must be distributed along with this .doc file and remains the
  100.     copyright of the author.
  101.  
  102.         The author is in no way responsible for any damage that may be
  103.     incurred on the user's system or data, directly or indirectly and offers
  104.     no guarantees or sympathy.  In other words, use at your own risk (be
  105.     comforted in the fact that I have used ShortCut for several months now
  106.     without any mishaps!)
  107.  
  108.         Every effort has been made to keep ShortCut bug-free, and to the best
  109.     of my knowledge, works on any Amiga, but if any problems should arise,
  110.     please contact me at the address below, giving full details of the
  111.     problem and your particular system setup.  Any requests or ideas are
  112.     welcome (as is any extra cash you have lying around), in fact this
  113.     version was written only because of the response I got for the first
  114.     one!
  115.  
  116.  
  117.     Current Bugs:
  118.  
  119.         Crashes when IO streams are not redirected to NIL: in the setup
  120.     file using the standard run command.  I tried setting the processes
  121.     standard IO (pr_COS and pr_CIS) to NIL:, but during development it was
  122.     found that the problem didn't arise when they were set to CON:, for
  123.     example.  Now, I've thought long and hard about this, and can't figure
  124.     out why run would work with a console, but not with NIL:.  Any ideas?
  125.     If it worries you too much, get ARP.
  126.  
  127.  
  128.     ShortCut was assembled using HiSoft's Devpac V2 (and very nice it is,
  129.     too).  Buy Amiga Computing - it is now the best Amiga Mag in town!
  130.  
  131.  
  132.     For bug reports, donations or ideas, contact:
  133.  
  134.                 Michael Bradley
  135.                 303 Belmont Road
  136.                 Belfast
  137.                 Northern Ireland
  138.                 BT4 2NE