SPAWN Version 1.2
----------------------------------------------------------------------------

    Description:

            SPAWN  is  a  DESQview  (tm)  specific utility which executes
        DESQview  tasks from a command  line.  DESQview tasks are defined
        in  Program Information  Files which  normally have the extension
        "DVP".   SPAWN loads the DVP file  into memory and can optionally
        modify  it before passing it to DESQview for execution.  Once the
        modified  DVP data structure  has been passed  to DESQview, SPAWN
        terminates and returns control to the batch file (or shell) which
        called  it.  The spawned  program continues to  run as a new task
        under DESQview's multitasking.


    Usage:

        SPAWN filename[.DVP] [options] [-Ccmnd] [tail...]

                (parameters in brackets not required)

            The  only  required  parameter  is  the  name  of  a  Program
        Information  File.  The default extension is "DVP".  Options must
        be preceded by either `/' or `-' and may be in any order with the
        exception of the -C option.  All options following -C are assumed
        to  be part  of the  command tale  and are  passed to the spawned
        program.   If there  is no  -C switch,  the first blank delimited
        string  after the DVP filename which  is not an option is assumed
        to  be the start  of the command  tale.  Any options following it
        will also be passed to the spawned program as arguments.

            Since  several long  strings may  be required  as part of the
        SPAWN  command line, a temporary file may be used to pass part of
        the command tail.  The DVP filename must be passed as part of the
        command  line.  The command  tail for the  spawned program may be
        passed  as part of the  command line or in  a temporary file, but
        may not be split between both.  Options may be passed in both the
        command  line and a temporary file provided that the -C option is
        not  passed on the command line.   The temporary filename must be
        the  last parameter on  the command line  and be prefaced by `@'.

            SPAWN  recognizes four pseudo-drives for all filename inputs.
        SPAWN will substitute the appropriate string for each pseudo-drive
        and  use it in  modifying the DVP  data structure.  Pseudo-drives
        can also be used in specifying the DVP file.

            @:      current default directory.
            $:      directory specified by %TEMP environment variable.
            *:      directory SPAWN.EXE was found in.
            =:      the DESQview directory.

    Options:

        -A<name>
            Assign the specified name to the default mailbox of the task.
            Note  that since the function to assign a name to the mailbox
            must follow the command to spawn a task, if the task SPAWN is
            run  in doesn't  run in  the background,  and the new task is
            started  in  the  foreground,  the  name will not be assigned
            until the operator switches back to this task.

        -B
            Start task in background.

        -C<command>
            Command to be executed.  Use ~ to separate multiple
            commands.

        -D<wide>,<long>
            set virtual Display size.

        -E<n>
            maximum Expanded memory in KB.

        -H
            Run task hidden.  This task cannot be made visible.

        -K<xx>
            Open menu (and script) key.  This two character code is used
            to find any linked script files.

        -L<n>
            protection Level (0-3).

        -M<n>
            Required memory in kilobytes.  If this amount of memory is
            not available, DESQview will display an error message and
            refuse to spawn the task.

        -O<y or n>
            Use own colors.

        -P<path>
            Startup path.

        -Q
            Quiet mode

        -R<n>
            Requested maximum memory in kilobytes.  DESQview will
            allocate as much memory to this task as it can up to this
            amount.

        -S<y a or n>
            Swappable.

        -T<string>
            Window title.  Spaces may be embedded in the title string by
            replacing them with `\S'.

        -U<y n 1 or 2>
            Uses serial ports.

        -V<y n or t>
            set display Virtualization.

        -W<x,y,wide,long>
            Window starting size and position.

        -X<y a or n>
            Close on exit. 

        -?
            Help!
            

    -----------------------------------------------------------------------