Contents of the FoxPro for Macintosh FoxPro Readme File

• Microsoft FoxPro for Macintosh, version 2.5b

SUMMARY

Below is the complete FoxPro for Macintosh FoxPro Readme file found in the main FoxPro folder (usually FoxPro).

MORE INFORMATION

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

                    Release Notes for

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

                       Version 2.5

     (C)1993 Microsoft Corporation. All rights reserved.

Information in this document is more current than that in the manuals or in online Help.

Contents

Part     Description
----     ----------
  1      Installing FoxPro for Macintosh
  2      Installing FoxPro on to a Network Server
  3      Installing Apple Shared Library Manager
  4      Installing Fonts
  5      Notes About FoxPro for Macintosh
  6      Cross-Platform Considerations
  7      Working with FoxPro Text Files
  8      FoxPro and Other Applications
  9      Other Notes
 10      Other ReadMe Files

The following programs are known to cause problems during the installation of FoxPro for Macintosh:

- Norton Utilities(R) Directory Assistance 2 - OnCue - SuperBoomerang

To avoid problems while installing FoxPro for Macintosh, turn off all extensions (INITs) and virus protection programs before starting. To turn off extensions, restart the computer while holding down the Shift key.

Part 2: Installing FoxPro on to a Network Server

If you choose the second option for installing FoxPro onto a network server (allowing users to run FoxPro from the server), do not install FoxPro onto a share that will be locked. FoxPro needs read/write permission to create the FOXUSER.DBF and FOXUSER.FPT files.

If, for security or other reasons, the FoxPro share must be locked, here are two options to provide FoxPro with the read/write permission it needs:

1. Provide a copy of the FOXUSER.DBF and FOXUSER.FPT files in a read/write location.

   Each workstation user must set the RESOURCE= entry in their CONFIG.FPM file to point to the location of the FOXUSER.DBF file. To start FoxPro, they must double-click on the CONFIG.FPM file.

2. Use the RESOURCE=OFF command before exiting FoxPro, either in the command window or in CONFIG.FPM. Alternatively, use SET RESOURCE OFF in any running program.

The Apple Shared Library Manager (ASLM) is an application developed by Apple to allow applications to share code. ASLM must be installed before you run FoxPro, or some FoxPro features will not work.

If you install new system software, you must also re-install ASLM.

To install the Apple Shared Library Manager:

1. Close all running applications.

2. Insert the disk labeled "Apple Shared Library Manager."

3. Double-click on the Apple Installer icon.

4. Follow the instructions on the screen.

• FoxDoc
• Beautify
• FoxTools
• Spell Checker
• Wizards
• IMPORT.APP
• FoxPro for Macintosh Distribution Kit

• MACIMP.MLB
• RESERVED.MLB
• FOXDOC.MLB
• FOXTOOLS.MLB

Part 4: Installing Fonts

To install the fonts shipped with FoxPro:

1. Close all running applications.

If fonts in the System Folder have the same names as the fonts you are installing, the Macintosh system will not allow you to replace them. To replace these previously installed fonts, drag the old fonts to the trash and empty it, then install the new fonts. If you do not want to replace the fonts, you can rename them before installing the new fonts.

The minimum fonts required to run FoxPro for Macintosh are:

• Geneva 9
• Courier 10
• Monaco 9

Part 5: Notes About FoxPro for Macintosh This section includes information about:

FoxPro Filename Restrictions FoxPro Color Sets Displaying Scroll Bars Displaying Wallpaper Graphic Files Displaying the FoxPro Graphical Help File Addition to the SET PRINTER Command Change to the ON KEY LABEL Command Using Dual Monitors

FoxPro Filename Restrictions

Do not use backslashes (\) or quotation marks (") as embedded characters in folder and filenames. Although the Macintosh accepts backslashes and quotation marks as valid characters, FoxPro uses these characters to make filenames compatible across platforms.

FoxPro Color Sets

In FoxPro for Macintosh, commands that save or call color sets (CREATE COLOR SET and SET COLOR SET) are ignored. Color sets in FoxPro for Macintosh are determined by the Macintosh system settings. If you issue the SET COLOR SET TO command, FoxPro restores the default Macintosh color set.

To change the color settings of FoxPro for Macintosh at startup, include the command COLOR OF SCHEME in CONFIG.FPM, as follows:

    COLOR OF SCHEME <expN> = <ColorPairList>

Displaying Scroll Bars

If you want to display scroll bars along an editing region on a FoxPro screen, the editing region must have a height greater than five lines of text. Because FoxPro uses the Macintosh system to define scroll bars, scroll bars cannot be displayed with smaller editing regions.

Displaying Wallpaper Graphic Files

Graphic files used as wallpaper on a FoxPro screen must have an extension in their filenames, such as MYPICT.PIC. If the filename does not have an extension, FoxPro will ask for the location of the file each time the screen is run.

Displaying the FoxPro Graphical Help File

The FoxPro graphical Help file may not be able to display on a system with 8 megabytes (MB) of memory. If you have trouble displaying the graphical Help file, issue the following in the Command window:

    SET HELP TO foxhelp.dbf

Addition to the SET PRINTER Command

The SET PRINTER command includes the following clause:

[FONT <expC>, [<expN>]]

Include the FONT clause to specify a default printer font for ?, ?? and @ ... SAY output directed to a printer.

Specify the font with the character expression <expC>, and the font size with the numeric expression <expN>.

Change to the ON KEY LABEL Command

FoxPro for Macintosh does not support the RIGHTMOUSE clause in the ON KEY LABEL command.

Using Dual Monitors

If you drag a window from a color monitor to a monochrome monitor, the screen controls may have display problems.

Part 6: Cross-Platform Considerations This section includes information about:

Updating Cross-Platform Files Sorting International Characters Transporting Reports to FoxPro for Windows(TM) and MS-DOS Converting PICT Files to BMP Files Displaying OLE Graphics in FoxPro for Windows Opening Excel OLE Objects in FoxPro for Windows

Updating Cross-Platform Files

To develop applications for other platforms, or to transport applications, you need to update certain files for each of the platforms you work on. If you use FoxPro for Windows (version 2.5a and 2.5b) or FoxPro for MS-DOS (version 2.5a and 2.5b), copy the following files supplied with FoxPro for Macintosh to these platforms. Do not copy these files to earlier versions of FoxPro, or you may get unexpected results.

• GENSCRN.PRG
• GENMENU.PRG
• TRANSPRT.PRG

If you are creating a cross-platform application in FoxPro for Macintosh for an international audience, and you are porting the application to another platform, use the following steps. International character sorting is only available for versions 2.5a and later.

1. Copy the FOXPRO.INT file supplied with FoxPro for Macintosh to FoxPro to the other platform.

2. Include the following line in the FoxPro for MS-DOS or FoxPro for Windows configuration file:

         CODE PAGE = AUTO
   

Transporting Reports to FoxPro for Windows and MS-DOS

Reports developed on the FoxPro for Macintosh platform must be transported before you can run them in FoxPro for Windows or FoxPro for MS-DOS. If you use the REPORT FORM TO command to run an untransported Macintosh report in Windows, FoxPro displays a message instructing you to transport the report before running it. In FoxPro for MS-DOS the message reads, "No records found for this platform."

Converting PICT Files to BMP Files

You can convert Macintosh PICT images to Windows bitmap files with "PICT to BMP," a simple stand-alone application shipped with FoxPro for Macintosh. "PICT to BMP" is located in the GOODIES:MISC folder. For information about using this application, see the topic Converting PICT Files to BMP Files in online Help.

Displaying OLE Graphics in FoxPro for Windows

Macintosh general fields with embedded or linked OLE objects appear blank when opened in FoxPro for Windows. This is because FoxPro for Windows cannot display the PICT files used by FoxPro for Macintosh. To display the OLE graphic, double-click on the general field to edit the OLE object. This updates the OLE graphic with a Windows bitmap.

Opening Excel OLE Objects in FoxPro for Windows

Embedded or linked Excel objects created in FoxPro for Macintosh do not work in FoxPro for Windows. If, in FoxPro for Windows, you try to connect to an Excel object created or modified in FoxPro for Macintosh, you will get the error message "Cannot activate OLE server." To connect to Excel objects you must re-create the link.

Part 7: Working with FoxPro Text Files This section includes information about:

Removing Line Feeds from Text Files Redirecting Printing to a PostScript(R) File Sending a File to a Port Changing Paper Sizes for the ImageWriter(R) Using the COPY TO Command

Removing Line Feeds from Text Files

FoxPro for Macintosh normally saves text files and programs with line feeds as well as carriage returns. This can cause problems when you copy files to other Macintosh editing programs.

To remove line feeds from previously created text files, use FXSTRIPLF, a program included with the FoxTools library. The FoxTools file, called FOXTOOLS.MLB is located in the EXTENSIONS folder. For information about using FoxTools, see the FoxTools Readme file located in the GOODIES:MISC folder.

To edit a text file without adding line feeds, clear the check box labeled "Save Text with Line Feeds" in the Edit Preferences dialog.

Redirecting Printing to a PostScript File

To redirect a printing job from a printer that supports PostScript to a PostScript file, issue the following command:

   LIST FILE <filename> TO PRINT PROMPT

Sending a File to a Port

If you send a text file or a program to a port (COM1 or COM2), you must save your file with the end-of-file character, Ctrl-Z. This ensures that FoxPro can find the end of your document. If you do not include the end-of-file character, FoxPro will not print the last line of your document. To save the file with the end-of-file character, check the box labeled "Save Text With Ctrl-Z" in the Edit Preferences dialog.

You can print only character-based documents directly to a port. To print graphics files, such as a FoxPro report, you must use the printer driver. To reset the printer to use the printer driver selected with the Macintosh Chooser, issue the following command:

   SET PRINTER TO

To change paper sizes for an ImageWriter printer, you need to adjust the FoxPro for Macintosh resource file. Information about paper sizes is stored in the PREC resource of FoxPro and is accessed through the Page Setup dialog.

Custom page sizes are not available with all printer drivers. For instance, you cannot change the paper size used by a LaserWriter(R).

To add a custom paper size option to the Page Setup dialog, follow these steps:

1. Quit FoxPro for Macintosh.

   and width of the new paper size. Each number represents 1/120th of an
   inch. For example, an 8 1/2-by-11-inch paper size has a height of 1320
   and a width of 1020.

   to the button.

To use the custom paper size option:

1. Select an ImageWriter printer with the Macintosh Chooser.

FoxPro adds a 1/2-inch margin at the top of all documents printed with an ImageWriter. To remove the margin, check the box labeled "No Gaps Between Pages" in the Page Setup dialog.

Using the COPY TO Command

If you use the COPY TO command to transfer the records of a table to a text file, the records are separated by single line feeds, chr(10). Records should be separated by a carriage return, chr(13). To replace the line feeds with carriage returns, follow these steps:

1. With the FoxPro editor, open the text file.

2. From the Edit menu, choose Preferences.

3. Clear the check box labeled "Save Text With Line Feeds."

4. Save the text file.

Importing 4th Dimension(R), FileMaker(R) Pro and Microsoft Works Files Changing Color Settings Using the QuickTime(TM) Extension Using the XCMD Header File FoxPro and Gregg's Buttons FoxPro and QuickKeys FoxPro and the Radius(TM) Pivot Monitor FoxPro and Network Systems FoxPro and Accelerator Cards

Importing 4th Dimension, FileMaker Pro and Microsoft Works Files

You can import files created by the following programs to FoxPro for Macintosh using an application called IMPORT.APP. IMPORT.APP is located in the GOODIES:MISC folder.

• 4th Dimension version 3.0
• FileMaker Pro version 2.1
• Microsoft Works

FoxPro for Macintosh supports both black-and-white and color settings. However, FoxPro for Macintosh does not recognize changes to color settings made by third-party utilities while FoxPro is running. To make FoxPro recognize changes in color settings made by third-party utilities, you must exit and re-start FoxPro. This ensures that any objects you create in FoxPro are saved in the correct color setting.

Using the QuickTime Extension

You can use the QuickTime extension of Macintosh System 7.1 to access and control time-based data such as video and audio recordings. FoxPro for Macintosh uses the latest version of the QuickTime extension, version 1.6.1. Earlier versions may cause unexpected results.

For information about using QuickTime with FoxPro, see the topic QuickTime in online Help.

Using the XCMD Header File

To call FoxPro for Macintosh from an XCMD you need to add a reference to the FoxPro header file to the XCMD, as follows:

    #INCLUDE xcmd.h

FoxPro and Gregg's Buttons

Some font and color changes made with Gregg's Buttons cause display problems in FoxPro for Macintosh.

FoxPro and QuickKeys

If you are using QuickKeys, pressing F1 does not bring up FoxPro Help. To bring up the Help file while using QuickKeys, press Command + ? or type HELP in the Command window.

FoxPro and the Radius Pivot Monitor

If you are using a Radius Pivot monitor, you must change the orientation of the monitor before starting FoxPro. The windows and status bar of FoxPro are not updated properly if you change monitor orientation while FoxPro is running.

FoxPro and Network Systems

Some FoxPro users might experience unexpected results when using unsupported network software to share files. For example:

On DEC(R) Pathworks(TM) systems, the file locking mechanism is not synchronized across multiple platforms. If a Windows workstation is accessing a shared file on the Pathworks server, Macintosh workstations might receive a "File in use by another" message. This message will not appear if only Macintosh workstations (or only Windows workstations) are accessing the file.

On Banyan(R) VINES(R) systems, updating a table with SET EXCLUSIVE OFF has unpredictable results. Use EXCLUSIVE access to ensure that updates work.

In addition, Microsoft Windows NT(TM) Advanced Server users might notice that tables set as EXCLUSIVE in FoxPro for Macintosh can still be set as SHARED in FoxPro for Windows. This problem is being addressed with NT Service Pack 2.

FoxPro and Accelerator Cards

We have identified compatibility issues with the following accelerator cards:

Mobius Accelerator on SE/30 machines Daystar Accelerator Turbo 040 on a IIfx machine

Contact your card vendor for additional information.

Part 9: Other Notes This section includes information about:

Indexing in the Report and Screen Wizards Analyzing Large Files with FB+Migrate

Indexing in the Report and Screen Wizards

If you specify a new sort order in either the Report Wizard or the Screen Wizard, the Wizard creates a new index. This new index is given a dynamic index tag name, such as _qkzOpdwwe. If you create an index based on a similar sort order before running a Wizard, the Wizard will use the previously created index tag name.

Analyzing Large Files with FB+Migrate

The Migration Application can take a significant amount of time to analyze large program files. If you are analyzing a large program you may want to split your program into smaller files.

Part 10: Other Readme Files This section includes information about:

The Q&A Readme File The FoxTools Readme File

The Q&A Readme File

You can find answers to commonly asked questions about FoxPro for Macintosh in the Readme file called Q&A ReadMe. The Q&A Readme file is located in the folder containing FoxPro.

The FoxTools Readme File

You can find information about FoxTools, a library that makes Macintosh system functions available for use by FoxPro, in the file called FoxTools ReadMe. The FoxTools Readme file is located in the GOODIES:MISC folder.

********************************************************** Microsoft, FoxPro and MS-DOS are registered trademarks and Windows and Windows NT are trademarks of Microsoft Corporation.

4th Dimension is a registered trademark of ACIUS/ACI. Apple, AppleTalk, ImageWriter, LaserWriter and Macintosh are registered trademarks and Geneva, Monaco and QuickTime are trademarks of Apple Computer, Inc. Banyan and VINES are registered trademarks of Banyan Systems, Inc. DEC is a registered trademark and Pathworks is a trademark of Digital Equipment Corporation. FileMaker is a registered trademark of Claris Corporaton. Norton Utilities is a registered trademark of Symantec Corporation. PostScript is a registered trademark of Adobe Systems, Inc. Radius is a trademark of Radius, Inc.