Contents of FoxPro 2.6a for Macintosh "LCK ReadMe" File

ID: Q120592

The information in this article applies to:

SUMMARY

Below is the complete FoxPro 2.6a for Macintosh "LCK ReadMe" file found in the "Library Construction Kit" folder in the main FoxPro folder (usually "Microsoft FoxPro 2.6").

MORE INFORMATION

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

                     Release Notes for

                 Library Construction Kit
Microsoft(R) FoxPro(R) for Macintosh(R) and Power Macintosh(TM) 
              Version 2.6a Professional Edition

    (C)1994 Microsoft Corporation. All rights reserved.
**********************************************************

For installation instructions, see the "Readme Before Installation-Pro" file.

Contents

Part 1: Library Construction Kit Information Part 2: Changes to Documentation Since Printing

Part 1: Library Construction Kit Information This section includes information about:

Customizing MPW

Before you create shared libraries, customize MPW to work with your source files. You can use the provided example files to test your changes.

To customize the example files: 1. Open UserStartup.LCK and change any path references to match your 

   volume name.
   **Note** Volume names cannot contain spaces.
2. To enable these changes, exit MPW, then restart MPW. 3. Set your default directory to <your volume>:FoxLCK:Source: 4. In the Source folder, open Makefile. 5. Change the ROOTDIR setting to match your volume name.

Now, MPW is customized to produce a shared library. Verify this by building a sample library.

To create a sample shared library 1. In the MPW Worksheet window, type MAKE and press Command+Return. 2. Highlight the output from MAKE and execute it by pressing 

   Command+Return.
A file called TestLib.MLB will be created in your FOXLCK:SOURCE folder.

To test the sample shared library 1. Drag TestLib.MLB to your SYSTEMS:EXTENSIONS folder. 2. Run FoxPro. 3. In the Command Window, type SET LIBRARY TO TestLib.

Event messages from the library will appear in your main FoxPro window. To stop the output, use the command SET LIBRARY TO with no parameter.

_Alloca() Caution

The following caution is part of the description for _Alloca() in Chapter 10 of the Library Construction Kit Developer's Guide. Though the sample code in EXAMPLES.DBF has been modified to illustrate this, the caution still applies to any code you write.

**Caution** Some C compilers, such as MPW C, do not support memory allocation from the stack; calls to _Alloca() will have unpredictable results. Instead, use local variables, or calls to _AllocHand() and _FreeHand(), in your code to reserve memory.

Including PRO_EXT.H

Definitions in PRO_EXT.H might conflict with definitions in other include files you are using. For better results when you compile, put PRO_EXT.H last in your list of include files.

Installing .MLB Files

Built .MLB files must be placed in the EXTENSIONS folder.

**Important** Do not build directly to the EXTENSIONS folder. Send output to a work directory, then move the file to the EXTENSIONS folder afterward.

Errors While Using _Execute

If an error occurs in the program passed to _Execute, the error appears as a normal program error, with Cancel, Suspend, and Ignore buttons. To prevent this display, make sure the program has its own error handler.

Part 2: Changes to Documentation Since Printing

Any changes to example code in the documentation should also be changed in the EXAMPLES.DBF file.

Page 69

In the example code for _ActivateIdle, change: 
    void FAR IdleHandler(WHandle wh, EventRec *ev)
to: 
    void FAR IdleHandler()
The two parameters are ignored on the Macintosh, and can cause problems on Windows.

Page 99

In the example code for _DeActivateIdle, change: 
    void FAR IdleHandler(WHandle wh, EventRec *ev)
to: 
    void FAR IdleHandler()

Page 321

Add a note to the end of the Description column for the rMouseDown event: 

    N/A for Macintosh.
Microsoft and FoxPro are registered trademarks of Microsoft Corporation.

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

                                           **End of Readme**
Additional reference words: FoxMac LCK 2.60a KBCategory: kbreadme KBSubcategory:

Last Reviewed: May 29, 1996