home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / cliva-2.3.lha / CliVa / WBRun.doc < prev    next >
Encoding:
Text File  |  1986-12-01  |  4.0 KB  |  87 lines
  1. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  2. /* |_o_o|\\ Copyright (c) 1986 The Software Distillery.  All Rights Reserved */
  3. /* |. o.| || This program may not be distributed without the permission of   */
  4. /* | .  | || the authors.                                                    */
  5. /* | o  | ||    Dave Baker    Ed Burnette        Stan Chow         BBS:      */
  6. /* |  . |//     Jay Denebeim  Gordon Keener      Jack Rouse   (919)-471-6436 */
  7. /* ======       John Toebes   Mary Ellen Toebes  Doug Walker                 */
  8. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  9.  
  10. WBRun by John Toebes © 1986 The Software Distillery.  All Rights Reserved
  11.  235 Trillingham Ln, Cary, NC 27511
  12.  
  13. Contributions to continue development of this and other fine products for the
  14. Amiga should be sent to the Software Distillery at the above address.
  15.  
  16. Other Products produced by the Software Distillery are:
  17.    BLINK     - the Turbo-charged Alink replacement
  18.    POPCLI II - Screen saver and Pop up CLI hotkey
  19.    HACK      - The Amiga port of the famous UNIX game
  20.    MAKE      - A software development tool one shouldn't be without
  21.    KERMIT    - The World renown file transfer protocol brought to the Amiga
  22.    ICONEXEC, SETALTERNATE, SETWINDOW - Icon manipulation tools
  23.    TSIZE     - A short utility for determining directory sizes.
  24. All of these are available on our BBS.
  25.  
  26. Permission is hereby granted to distribute this program provided both this
  27. documentation accompanies the executable and that no charge is made for its
  28. distribution.  Contributions to the distillery are encouraged.  If you wish
  29. to include this program in a comercial product, contact us first.
  30.  
  31. WBRun is a program designed to allow any program to be invoked from CLI yet
  32. behave as if it were invoked from Workbench.  Note that workbench need not
  33. be loaded!  This is a boon for people who are short on memory and do not
  34. wish the extra overhead of workbench.
  35.  
  36. This permits running programs created with AmigaBasic and TrueBasic (or
  37. any other application that creates a workbench project icon) from CLI
  38. as either a turnkey application or even in a startup-sequence.
  39.  
  40. To invoke a program with WBRun you need to execute the command:
  41.   WBRun <icon1> <icon2> ...
  42.  
  43. Where <icon1> is the primary program to be run.  The name must correspond
  44. to a workbench Icon.  <icon2> and subsequent parameters are taken as 
  45. workbench arguments to be passed to the primary program.
  46.  
  47. For example:
  48.    To run Initialize:
  49.       WBRun SYS:System/Initialize
  50.  
  51.    To run a program (call it Printit) that takes arguments (normally shift
  52.    clicked on) you would type
  53.       WBRin Printit Arg1 Arg2
  54.  
  55. To run an AmigaBasic Program:
  56.   WBRun myprogram
  57.  
  58. Note that the arguments must be qualified if they are not in the current
  59. directory.
  60.  
  61. Supressing the Copyright message:
  62.   If you are building a turnkey application that you do not wish to have
  63. display the WBRun copyright message, you may supress it with the CLI
  64. redirection features:
  65.    WBRun >NIL: MyApplication
  66.  
  67. If you do this, you must give credit to the Software Distillery in your
  68. application.
  69.  
  70. Known Bugs:
  71.   None so far...
  72.  
  73. How it works:
  74.   WBRun simulates a phoney workbench by building an argument list of the
  75. locks and names corresponding to the command line arguments.  It then opens
  76. up the disk object for the first argument to determine the tool type.  For
  77. a TOOL it simply invokes that program, for a Project it determines the
  78. default tool to be invoked.  Once the program to be invoked is determined,
  79. it does a LoadSeg on it, CreateProc and sends the startup message to the
  80. newly created task.  Finally it waits for the response message from the
  81. task before terminating.  All resources allocated are freed upon completion
  82. or any error.
  83.  
  84. The code is written completely in Lattice C under 3.10 taking advantage
  85. of Blink.  Without messages to make it user friendly it is a shade over
  86. 3K, the messages and minimal IO support raise it to 3700 bytes.  Note that
  87. all this is done without making any serious attempts at optimization.