                CREATING NEW COMMANDS FOR THE WINDOWS SHELL

WHAT THIS IS

This directory contains the files neccessary for getting started on
creating new external commands for WINSHELL.  The EXAMPLE subdirectory
contains the code used for an actual shell command used by WINSHELL.

WHAT YOU NEED

To create commands for WINSHELL, you need a Windows Compatible C compiler
(ex MSC 5.1, Borland C), as well as the Software Development Kit (SDK) for
Windows or a compatible kit.  The GENERIC command and the example command
were designed for use with MSC 5.1 and the Windows SDK.

THE GENERIC PROGRAM FILES

The generic command is provided as a template for creating new WINSHELL 
commands.  The files included are:

generic.c               C functions for the commands
generic.h               C header file
generic.def             Module Defination File
generic.lnk             Link information for MSC linker
generic.res             Resource file containing the dialog boxes
wslib.h                 Header file for accessing WSLIB functions 
                        (WSLIB.DLL is provided with WINSHELL.  It provides
                        several functions usefull to shell applications.
wstdio.h                Header file for communicating with WSTDIO window.
                        This window provides the command line interface,
                        and provides functions for reading text, writing text,
                        and many more.

GETTING STARTED

Writing WINSHELL external commands is pretty easy.  First orient yourself
with the available character I/O functions by browsing the WSTDIO.H file.  
The macros are provided for accessing these functions via windows messages.
If you have not already, review Appendix A of WINSHELL.DOC or WINSHELL.WRI.
Finally review the GENERIC program and the example program.

Hopefully, this will be enough to get you started.
