                     WExecLib (Windows Execute Library)
                (c) copyright 1997 Santronics Software Inc.
                         Version 1.0 May 30 1997

WEXECLIB is a non-visual component library (VCL) for processing external
commands with wait and redirection options.

Files:

    - wexeclib.pas               vcl component
    - testrun.pas                console example
    - testwrun.pas/mainwrun.*    gui example

Features:

    - Spawning and Shelling of 32 bit and 16 bit applications.

      Spawning means, a child process is executed and your application does
      not wait for the child process to complete.  Your application simply
      forgets about the process.  Essentially, it is the same as simply
      using Win32 API WinExec().

      Shelling means, a child process is executed and your application does
      wait for the child process to complete.   Your application will use
      Win32 API events to watch for the completion.  While it is waiting,
      it will cooperately keep your application active to do other things.
      When it is complete, an OnComplete method is called.

    - Redirection of child process output to your application.

      Using Win32 piping methods, this library offers the option to pipe
      application output to your application.

    - Optional Error and Debug logging to watch various steps.

Special notes:

    - One of the more important ideas in this library (besides piping or
      waiting for a process to complete), is the idea of using the
      environment string COMSPEC to find the current Command Line Processor
      (command.com under Win95, cmd.exe under NT).

      When calling 16 bit applications under Win95, Win95 has a strange
      behavior of never returning back to the application.  By using the
      comspec to find the current processor and calling the command line
      processor instead passing the 16 bit application as parameters, the
      process will return.  Under NT, you don't have this problem.

      It is also useful to use the COMSPEC when calling DOS level commands,
      such as DIR, ERASE, COPY, MOVE, etc.

      Technically, it is ok to always use the COMSPEC, even with 32 bit
      applications.   But it is unnecessary when calling 32 bit
      applications and its not necessary under NT except when calling DOS
      level commands.

Installation:

    - You can use this unit without installing it as a component on your
      delphi component palette!  Isn't that a blessing!   You can simply
      a simple inherited object to run in console mode or in a gui mode.
      See examples.

    - If you want to put the component on your palette, use your normal
      Delphi method of installing components, in this case WEXECLIB.PAS

Legal:

    WExecLib is copyrighted 1997 by Santronics Software Inc.

    You may use this unit as you please for your own work, except
    mis-represent this unit as your own, i.e.,  you can't say you wrote
    this unit and distribute it to others even if you make changes to it.

    You may make (and it is encouraged) changes to this library and
    distribute it to others, but you must keep the original copyright as
    shown above in the source file.

Contact/Support:

    Hector Santos/President of Santronics Software Inc

    email: hector@santronics.com
    fido:  1:135/382

    There will be support only on a "normal basis" on the Borland Newsgroup
    or by direct email.   By normal, I mean, send your message, and if I
    happen to read it and I feel I can answer your question, I will reply.

    Of course, if you find any bugs, please submit them to me at the above
    address.  We have many products to support so please indicate WEXECLIB,
    and where did you download it from (has it been modified).

    If you need any customization or special programming needs, I will
    consider the work on a per fee basis.

