home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD1.img / d1xx / d179 / launch / launch.doc < prev    next >
Text File  |  1989-02-25  |  2KB  |  63 lines
  1. LAUNCH -- start a workbench application from the CLI.
  2.  
  3. This is an example of how you run a workbench application. As you can see,
  4. it's pretty complex... even with the stuff encapsulated like this. However,
  5. once you get it working it works just fine... unlike the CLI. Just ask anyone
  6. who's tried to run a program under the CLI from, say, runback.
  7.  
  8. Usage:
  9.     run wbcleanup (only once, in your CLI)
  10.     launch [options] program [filename]...
  11.  
  12.     Loads and executes program in a workbench environment, then returns
  13.     to the CLI.
  14.  
  15. Options:
  16.     stack nnnn
  17.         Specifies initial stack for the program.
  18.     priority pppp
  19.         Specifies initial priority for the program.
  20.     window wwww
  21.         Specifies TOOLWINDOW for the program.
  22.     wait
  23.         Wait for reply, rather than passing it off to wbcleanup.
  24.  
  25. wblaunch.c:
  26.     message = Launch(port, program, argv, argc, pri, win, stack);
  27.  
  28.     Launch loads and executes program in a workbench environment. The
  29.     specified port is where the startup message will be returned. The
  30.     arguments will be passed to the program, workbench-style (directory
  31.     lock and filename). The first argument should be the same as the
  32.     program, but it's possible to spawn a program in an illicit way. If
  33.     you don't want to specify a window, use NULL. You need to specify a
  34.     stack.
  35.  
  36.     If you don't want to specify a port, run wbcleanup and use the
  37.     public message port "Workbench.Cleanup".
  38.  
  39.     You really don't need to do anything with the message when it's
  40.     returned from Launch, but it's a convenient non-zero value to
  41.     indicate success.
  42.  
  43. wbfree.c:
  44.     FreeStartup(message);
  45.  
  46.     FreeStartup takes a startup message created by Launch and releases
  47.     all the public memory, removes the lock, and so on. It should be
  48.     called after the startup message is returned.
  49.  
  50. launch.c:
  51.     This contains the mainline for the 'launch' program. Most of it is
  52.     arg parsing.
  53.  
  54. wbcleanup.c:
  55.     This contains the mainline for the 'wbcleanup' program.
  56.  
  57. util.c:
  58.     dictcmp(s1, s2);
  59.  
  60.     An analog to strcmp, but ignores case differences in words. Not a
  61.     full dictionary comparison, since it doesn't sort numbers by their
  62.     spelling.
  63.