Contents of the FoxPro for Macintosh DK Readme File

• Microsoft FoxPro for Macintosh, version 2.5b

SUMMARY

Below is the complete FoxPro for Macintosh "DK Readme" file found in the main FoxPro folder (usually FoxPro) and on the disk labeled "Disk 1 - Setup" of the Distribution Kit.

MORE INFORMATION

**********************************************************

                    Release Notes for

  Microsoft(R) FoxPro(R) for Apple(R) Macintosh(R) Distribution Kit

     (C)1994 Microsoft Corporation. All Rights Reserved.

For the most up-to-date information about Microsoft FoxPro for Macintosh and other Microsoft products, see the Microsoft Knowledge Base. The Microsoft Knowledge Base contains more than 40,000 detailed articles with technical information about Microsoft products, bug lists, fix lists, documentation errors, and answers to commonly asked technical questions--all available through the Internet.

Contents

Part 1: SetupWizard Additional Information Part 2: Other Additional Information Part 3: Changes to Documentation Since Printing Part 4: Internet Access Instructions

Part 1: SetupWizard Additional Information

Contents

1. Distributing the .ESL File

Just before SetupWizard starts compressing your files, you may see a prompt asking you whether you want to distribute an additional .ESL file with your application. If your application is a stand-alone executable, distributing this file is not necessary, or recommended.

This file is an optional 2.5 MB runtime library, which has extended support for users to run FoxPro applications, even if they don't have FoxPro. You can choose to distribute the .ESL file if your users don't have their own copies of FoxPro, but it will occupy two extra disks, and take extra time to compress.

2. File Compression Progress

As files are compressed, a thermometer displays the percent-done progress. This information updates only after each file is compressed. Since compression of large files can take 15 minutes or more per megabyte, there will be no apparent progress displayed for quite some time, but this is normal.

3. SetupWizard Prerequisites

To use the SetupWizard application, you must have the Apple Shared Library Manager (ASLM) files installed. If you did not install ASLM when you installed FoxPro for Macintosh, use the FoxPro disk labeled "Apple Shared Library Manager" to install ASLM before running SetupWizard.

4. Memory and Disk Space Requirements

Before running SetupWizard, make sure you have at least 600K available memory, and free disk space totaling at least twice the size of your application folder. Unexpected errors can occur if these conditions are not met.

5. Changing SetupWizard Options

SetupWizard options must be changed by running SetupWizard itself. Do not hand-edit any files that SetupWizard writes to; unexpected results may occur.

6. Title and Copyright Maximum Length

The limits for the Title and Copyright strings are 37 and 72 characters, respectively. To avoid truncation during installation, restrict your string lengths to these limits.

Part 2: Other Additional Information

Contents

1. Installing the Distribution Kit on a Network

If you install the Distribution Kit, using Network Install #2, to a network location that contains FoxPro, you will be prompted to replace some files. These files are common to both FoxPro and the Distribution Kit, and differ only in their timestamps. Since the files are otherwise identical, you can choose to replace the files, or continue to use your existing copies.

2. Additional Distribution Kit Files

The Distribution Kit includes an additional file, FOXMAC.LIB, that is not listed in the documentation. It is required to create executable files, but does not need to be redistributed. Make sure this file is located in your main FoxPro folder.

3. Customizing the Apple About Menu

In your distributed application, you can include your own text on the Apple About... menu, and display your own About screen when that menu item is chosen.

To customize the Apple About... menu text:

• Include the command SET APLABOUT PROMPT <expC> in your application code.

• Include the command ON APLABOUT <command> in your application code.

4. Names of Application Folders and Files

The names for your application folder and files must have:

• No more than 27 characters
• no special characters such as commas (,) or ellipsis ( )

5. Building a Stand-alone Executable File

If you use the BUILD EXE command to create a stand-alone executable file, you must include the keyword STANDALONE. Omitting this keyword, or using the COMPACT or EXTENDED keywords, results in the "Feature not available" error message. For complete instructions on creating stand- alone executable files, see Chapter 4, "Building an Application for Distribution," in the User's Guide for the Distribution Kit.

6. Distributing Shared Library Files

If your application includes shared library files (files with the extension .MLB), the Installer provided with the SetupWizard automatically installs the .MLB files into the System file, and prompts the user to install Apple Shared Library Manager (ASLM), after installation of your application is complete.

Since the user needs to have the ASLM extension installed to use your application's shared libraries, you might want to provide ASLM with your application. You can obtain a distribution license for ASLM from Apple Corporation.

7. Distributable Files

If your application includes a graphical Help file, you can also distribute the Microsoft Help engine. Add the following files to your application folder:

   Microsoft Help
   FoxPro Help

8. Labeling Distribution Disks

The distribution disks must have the following names:

   Disk - 1 Setup
   Disk - 2
   Disk - 3

9. Customizing Installer PICT Files

The Installer displays a default logo on its initial screen. To change the logo used by the Installer, replace the Installer PICT files with your own files.

To replace the Installer PICT files:

1. Using a resource editor such as ResEdit(TM), edit the Installer.

   numbers of 256 and 257. 256 is the monochrome version of the
   graphic, and 257 is the color version.

10. Using Installation Billboards

The Installer does not include any billboards, but you might want to include one or more billboards describing the features and highlights of your product. Billboards are displayed while your application installs.

Creating Billboards

When deciding how many billboards to include, consider the size of your application. The installer uses the total size of your application as a measure for displaying billboards. For example, if your application files take up 5 MB, and you include five billboards, each billboard will display for one-fifth of the installation, or the time it takes to install 1 MB.

Displaying Billboards

1. Using a resource editor such as ResEdit, edit the Installer.

   color billboards, and BBBW will contain the monochrome billboards.

   numbers for the items must begin at 128 and be numbered
   sequentially.

   paste it into the resource item.

If the Distribution Kit libraries, FOXMAC25.ESL and FOXMAC.LIB, or any applications created with the Distribution Kit, are accessible on any mounted drive, double-clicking a FoxPro file to open it will use the Distribution Kit libraries or launch the Distribution Kit application instead. This is due to the later timestamp on the Distribution Kit libraries. To use FoxPro and the Distribution Kit together, you must do one of the following:

• Launch FoxPro directly, then use Open from the File menu to open FoxPro files.
• Unmount the drive that contains the Distribution Kit, while working with FoxPro.
• Modify the FoxPro timestamp to be later than the Distribution Kit file timestamp.
• Modify the timestamp on the DK libraries or application to be earlier than FoxPro's timestamp.

When two machines try to run the same distributed application over a network, the second machine receives a message, "Application in use." To prevent this message, you must do one of the following:

• Lock the distributed application.
• Checked the Shared bit on the application.
• Place the application on a read-only share.

13. Creator Type Conflicts

The Macintosh operating system expects that each application and its associated files have a unique creator and file type. However, executable files created with FoxPro share the same creator and file type as FoxPro itself. If you run your FoxPro executable file, then try to launch a FoxPro file, the executable will run instead.

As an application developer, you can choose one of the following:

1. Don't keep executable versions of your applications after you've made disks.

When users have more than one FoxPro executable file, they will encounter similar problems. To work around this situation, they must launch the executable file first.

Part 3: Changes to Documentation Since Printing

Page 4

Page 26

Add the following section to "Creating an Application Folder":

The names for your application folder and files must have:

• No more than 27 characters
• no special characters such as commas (,) or ellipsis ( )

Page 29

Part 4: Internet Access Instructions

To access the Knowledge Base through the Internet, use anonymous logon. The name of the server is ftp.microsoft.com, and the IP address is 198.105.232.1. Connect through the FTP server on your network, and, at the FTP prompt, type:

   open ftp.microsoft.com

   anonymous

To access the Fox portion of the Knowledge Base, type the following commands:

   cd deskapps
   cd fox
   cd kb

Microsoft and FoxPro are registered trademarks of Microsoft Corporation.

Apple and Macintosh are registered trademarks, and ResEdit is a trademark of Apple Computer, Inc.