				WinBegin

	WinBegin 3.0 is a development tool for creating very simple "C" 
programs which run under Windows 3.0.  WinBegin is meant to be used by
the "C" programmer who wants to create his or her first Windows program.
The more experienced Window developer may find it useful for making
skeleton programs for new applications.  I still use it to start new
programs

	WinBegin actually generates "C" and Windows code for a small
application.  When the user chooses the "Make Program" menu option,
WinBegin prompts for a program name, a directory name, a program 
description, and the author's name.  When all these items have been
entered, WinBegin creates the source code for a Windows application.
The files created include:

name.c
name.h
name.def
name.rc
name.ico
name

where "name" is the program name selected by the author. The "name.c"
file contains the application's "C" source code.  "name.h" contains
constant definitions.  "name.def" contains information needed by Windows
at link time.  "name" contains a makefile for compiling the application.
"name.ico" contains a dummy (blank) icon for the application.  You can,
and should, make a meaningful icon for your application using the icon
editor in "sdkpaint.exe". 

	After running WinBegin, you should change to the directory 
that you chose to contain the generated code.  Then type "make name"
to create a Windows executable file.  If you have enough memory, you
can do this withing Windows.  Otherwise, you need to exit to DOS first.

	What does this executable file do?  It contains two menu items:
File, and GetText.  File has two choices:  Exit, and About this application.  
The About choice displays an About dialog box with the name of the program
and the author's name.  GetText displays a dialog box which prompts for
a line of text.  When the box is exited, the text is displayed on the
screen.  The executable file also can display an About box which contains
a description of the program and a copyright notice with the author's
name.  
	Thus WinBegin creates source code for an application that has
menu-bar commands, and which uses two dialog boxes.  This is what I 
consider to be the smallest non-trivial Windows program.  The generated
files are meant to be modified!  Here are some things to try:

-  Add another menu item.  Adding, deleting, and changing the names of
   menu items are just about the easiest things to do in Windows.

-  Add another dialog box.  Remember that the names of the dialog box
   functions must be added to the EXPORTS section of the name.def file,
   in order to prevent nasty things from happening.

-  Experiment with some of the more sophisticated dialog box controls,
   such as list boxes and edit boxes.

-  Instead of printing text using TextOut, try out some of the drawing
   functions, such as Rectangle and LineTo.

Files included in the archive are:

readme.txt
winbegin.exe
winbegin.dat
winbegin.ico
target.ico



Copyright 1987,1990 by Susan Crayne.  All Rights Reserved
Written for uploading to Compuserve Forums by

	Susan Crayne
	4 Charlotte Place
	Hartsdale, New York 10530
	
	914-686-9822

WinBegin 3.0 is shareware.

If this program has been useful to you, please register!  You will 
receive bug fixes and enhancements when they occur.  Your input about
future enhancements will be highly valued.  To register, send $35 to 
the above address.

This program may be distributed freely.  If it is distributed, this file
(readme.txt) must be included.  The copyright holder offers no
warranty with this code whatsoever, including its fitness for any particular
purpose.  Neither shall she be liable for damages of any kind that may arise
from its use.

         ----------------end-of-author's-documentation---------------

                         Software Library Information:

                    This disk copy provided as a service of

                           Public (software) Library

         We are not the authors of this program, nor are we associated
         with the author in any way other than as a distributor of the
         program in accordance with the author's terms of distribution.

         Please direct shareware payments and specific questions about
         this program to the author of the program, whose name appears
         elsewhere in  this documentation. If you have trouble getting
         in touch with the author,  we will do whatever we can to help
         you with your questions. All programs have been tested and do
         run.  To report problems,  please use the form that is in the
         file PROBLEM.DOC on many of our disks or in other written for-
         mat with screen printouts, if possible.  PsL cannot debug pro-
         programs over the telephone, though we can answer questions.

         Disks in the PsL are updated  monthly,  so if you did not get
         this disk directly from the PsL, you should be aware that the
         files in this set may no longer be the current versions. Also,
         if you got this disk from another vendor and are having prob-
         lems,  be aware that  some files may have become corrupted or
         lost by that vendor. Get a current, working disk from PsL.

         For a copy of the latest monthly software library newsletter
         and a list of the 2,000+ disks in the library, call or write

                           Public (software) Library
                               P.O.Box 35705 - F
                            Houston, TX 77235-5705

                                 Orders only:
                                1-800-2424-PSL
                              MC/Visa/AmEx/Discover

                          Outside of U.S. or in Texas
                          or for general information,
                              Call 1-713-524-6394

                          PsL also has an outstanding
                          catalog for the Macintosh.


