                       DKREADME.TXT
**********************************************************
  Release Notes for Microsoft(R) FoxPro(R) for Windows(TM)

                    Distribution Kit

                      Version 2.5

    (C)1993 Microsoft Corporation. All Rights Reserved.

This Distribution Kit corresponds to the FoxPro 2.5
product version. You can confirm that this product and
your FoxPro development product match by typing
? VERS() in the command window of your FoxPro product. 
If "FoxPro 2.5" is returned, then everything matches
and you can start development.  If something else is
returned, e.g. "FoxPro 2.0" or "FoxPro 2.5a", then
contact Microsoft Product Support Services to determine
what you need to update.
**********************************************************

========
CONTENTS
========

Part   Description
----   -----------

1      Knowledge Base Articles

2      Changes to Documentation Since Printing

3      Answers to Commonly Asked Questions

================================
Part 1:  Knowledge Base Articles
================================

If you installed the Knowledge Base articles, you can
view them by running KBVIEW.APP, a FoxPro for Windows
application installed in your FoxPro for Windows
directory.
----------------------------------------------------------

================================================
Part 2:  Changes to Documentation Since Printing
================================================

Chapter 1, page 5: Installation 

This section incorrectly states that FOXW2500.ESL and 
DKREADME.TXT are installed in the Distribution Kit 
directory.  These files are actually installed in your
FoxPro for Windows directory.

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

Chapter 2, page 12: Including FoxPro for MS-DOS 
Printer Drivers

You should also include DRIVER2.FLL as a file if your
application requires FoxPro for MS-DOS printer drivers.

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

Chapter 2, page 13: Modifying the Main FoxPro Window

TITLE, a new FoxPro for Windows configuration file 
(CONFIG.FPW) item, was not documented in this section.

If you select Close from your application's Control Menu
or Exit from the File menu, a message containing the text
in your application's title bar is displayed.

Include the TITLE configuration item to specify the
message displayed when you select either of these two
options.  The title bar text is overridden by the text you
specify with the TITLE configuration item.

For example, the message "Exit MyApp" is displayed when
the following line is place in CONFIG.FPW:

TITLE = MyApp

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

Chapter 3, page 16: BUILD EXE

BUILD EXE does not work in FoxPro for Windows version 2.5.
You must build your .EXE from within the Project Manager.
BUILD EXE will be fixed in the next version of FoxPro for 
Windows.

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

Chapter 3, page 17: Adding an Icon to your .EXE File

The warning states that you cannot use the Program Item
Properties dialog in the Windows Program Manager to add
or change the icon for an .EXE file created with the 
FoxPro for Windows Distribution Kit.  This is not correct.
You can use the Program Item Properties dialog in the 
Windows Program Manager to manipulate the icon for a .EXE
created with the Distribution Kit.

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

============================================
Part 3:  Answers to Commonly Asked Questions
============================================

Overview of Questions
---------------------

1   Where does my application's executable (.EXE) file look
    for FOXW2500.ESL?

2   If my application uses the RUN command to execute
    external MS-DOS programs, where should I put
    FOXRUN.PIF?

3   How do I pass parameters to my application's 
    executable (.EXE) file?

4   My application uses FoxFont. Where do I put the FoxFont
    file FOXFONT.FON?

5   Our organization includes several FoxPro developers.
    Does each developer need an individual copy of the
    Distribution Kit?

6   What type of applications (single-user, multi-user)
    can be built with the Distribution Kit?

7   A two-part question about the sale of an application
    via a reseller. 
-----------------------------------------------------------

Questions and Answers
---------------------

Question 1

Where does my application's executable (.EXE) file look for
FOXW2500.ESL?

Answer 1

The executable file looks for FOXW2500.ESL, the FoxPro for
Windows Support Library, in the following locations in
this order:

1.  In the directory from which the .EXE is run.

2.  In the current working directory.

3.  Along the MS-DOS path.
-----------------------------------------------------------

Question 2

If my application uses the RUN command to execute external
MS-DOS programs, where should I put FOXRUN.PIF?
    
Answer 2

Place FOXRUN.PIF in the same directory as the FOXW2500.ESL
file. This is usually the root directory of the directory
structure containing the files you want on your
distribution diskettes.
-----------------------------------------------------------

Question 3

How do I pass parameters to my application's executable 
file (.EXE)?
    
Answer 3

The first line of your application's main program must be
a PARAMETERS statement to accept the parameters you pass. 
For example, the following PARAMETERS statement can be
used to accept two parameters:

PARAMETERS mparam1, mparam2

You can specify the parameters that are passed to your
application's .EXE file when you use the SetupWizard to
create your setup routine.  Specify the parameters in the
screen where the SetupWizard asks you for the name
of your application.  If you specify more than one
parameter, separate the parameters with a space.  If a
parameter contains an embedded space, place double
quotation marks (" ") around the parameter.

You can also specify parameters to pass to the
application's .EXE file by selecting the application's
icon and choosing Properties... from the Program Manager
File menu.  Enter the parameters to pass to the .EXE file
in the Command Line text box.
-----------------------------------------------------------

Question 4

My application uses FoxFont. Where do I put the FoxFont
file FOXFONT.FON?
    
Answer 4

Place FOXFONT.FON in the same directory as the 
FOXW2500.ESL file. This is usually the root directory of
the directory structure containing the files you want on
your distribution disks.
-----------------------------------------------------------

Question 5

Our organization includes several FoxPro developers.  Does
each developer need an individual copy of the Distribution
Kit?

Answer 5

Your organization must own one licensed copy of the
Distribution Kit per developer, for each developer
creating applications for distribution. If five developers
in your organization create applications for distribution,
you must own five licensed copies of the Distribution Kit.
-----------------------------------------------------------

Question 6

What type of applications (single-user, multi-user) can be
built with the Distribution Kit?    

Answer 6

You can build all types of applications (single-user,
multi-user) with the FoxPro 2.5 for Windows Distribution
Kit.  While the FoxPro 2.0 version required separate
license agreements for single-user, multi-user, and so
forth, the development version of FoxPro 2.5 no longer
makes these distinctions.  However, as mentioned in the
previous answer, in order to be legal, you must own one
licensed copy of the FoxPro 2.5 for Windows Distribution
Kit for each developer creating FoxPro 2.5 for Windows
applications for distribution.  
-----------------------------------------------------------

Question 7

I have a question regarding the legal requirements for
reselling applications developed with FoxPro.  Let's say
that, as a FoxPro developer, I write a program for
Client A.  I compile the program as a compact .EXE file
and give the application to Client A, together with
the FOXW2500.ESL support library file with which to run
the application. Client A owns the application and the
copyright.  Client A then sells the application
commercially to many other people.

A) Does Client A also have to purchase the FoxPro
   Distribution Kit, even though Client A will never use
   the Distribution Kit themselves?

B) Does Client A have to purchase the FoxPro 2.5
   development version?

Answer 7

A) No, Client A does not need to purchase the Distribution
   Kit. Only the developer who uses the Distribution Kit
   to build the original .EXE file must own a licensed
   copy of the Distribution Kit.

B) Client A does not have to purchase FoxPro 2.5, since
   the client is not building their own .EXE file; 
   Client A is just a reseller.  Client A must distribute
   the application in its original form, however, and
   cannot remove the runtime files to include it with
   another application.
-----------------------------------------------------------
                     *******************
                     END OF DKREADME.TXT
                     *******************