README.TXT
**********************************************************
Release Notes for
Microsoft(R) FoxPro(R) for MS-DOS (R) Version 2.5b
(C)1993 Microsoft Corporation. All Rights Reserved.
Information in the FoxPro online Help is more current than
information in the printed documentation. This README
provides information not contained in the FoxPro online
help or documentation, and provides corrections to both.
**********************************************************
========
CONTENTS
========
Part Description
---- -----------
1 Installation
2 WAIT...WINDOW Enhancements
3 New Commands and Functions
4 New Transporter and Screen Directives
5 International and Cross-Platform Recommendations
----------------------------------------------------------
====================
Part 1: Installation
====================
There are three types of installation for FoxPro for
MS-DOS: Normal Installation, Administrative Installation
and Workstation Installation. Instructions for Normal
Installation are in the FoxPro Installation and
Configuration manual. For information about Administrative
and Workstation Installation, see INSTALL.TXT on FoxPro
for MS-DOS Disk 1.
----------------------------------------------------------
================================
Part 2: WAIT WINDOW Enhancements
================================
WAIT WINDOW now supports multiple line messages. Use a
carriage return (CHR(13)) to move portions of your message
to additional lines. The message window is automatically
expanded to accommodate additional lines. For example, this
command creates a message window that contains two lines:
WAIT WINDOW "This is the 1st line" + CHR(13) + ;
"This is the 2nd line"
The width of the message window is adjusted to fit the
longest line in the message. All lines in the message are
left justified in the message window. Line feeds (CHR(10))
following CHR(13) are ignored.
----------------------------------------------------------
==================================
Part 3: New Commands and Functions
==================================
Several new commands and functions are added to
FoxPro 2.5b. For additional information about these
commands and functions, see the "International and Cross
Platform Recommendations" section below and the
corresponding topics in Help.
New Commands
------------
SET NOCPTRANS
SET COLLATE
New Functions
-------------
CPCURRENT( )
CPDBF( )
CPCONVERT( )
IDXCOLLATE( )
----------------------------------------------------------
=============================================
Part 4: New Transporter and Screen Directives
=============================================
Several new Transporter and screen directives have been
added.
The #DOSOBJ, #MACOBJ, #UNIXOBJ and #WINOBJ
Transporter directives allow you to transport objects
created in the Screen Builder and Report Writer to
specific FoxPro platforms. For additional information
about these Transporter directives, see the Transporting
Files topic in Help.
#TRAN SNIPPET ONLY, a new screen directive, is available
in FoxPro 2.5b. This screen directive affects how screen
objects are transported, and is not discussed in Help.
#TRAN SNIPPET ONLY is designed to limit the Transporter's
changes to just screen snippets, and is placed in
a screen's Setup snippet.
When screen objects are transported to a different FoxPro
platform, only the screen snippets for updated screen
objects are transported if #TRAN SNIPPET ONLY is included.
All other screen object attributes are not transported to
the different platform.
Note that #TRAN SNIPPET ONLY only affects updated screen
objects; it does not affect new or unchanged screen
objects or screen objects being transported for the first
time.
----------------------------------------------------------
=========================================================
Part 5: International and Cross Platform Recommendations
=========================================================
*** IMPORTANT ***
*******************************************************
* Be sure to read this section completely before you *
* change code pages or collation sequences! *
*******************************************************
Overview of topics
1 FoxPro Collation Sequences
2 Case-Insensitive Collation Sequences
3 Case-Sensitive Collation Sequences
4 How do the SEEK and SKIP commands work?
5 Alternatives to SEEK and SKIP
6 Additional Recommendations
7 New Code Pages
8 CPZERO Program
9 Corrections to the Help File
FoxPro 2.5b gives international developers and users
powerful new features for handling accented characters
across different FoxPro platforms, and provides
accurate sorting in many languages.
For international FoxPro users, this section describes
how code pages and collation sequences affect sorting,
seeking and comparisons using the SORT and SEEK commands,
and also provides recommendations for taking advantage
of these features.
U.S. FoxPro users whose applications don't contain
accented characters may not need any of the new
international 2.5b features. In this case, you can
disregard this section of the README and the
International/X-Platform topic in Help. FoxPro 2.5b is
100% percent compatible with FoxPro 2.5.
1 FoxPro Collation Sequences
----------------------------
With a MACHINE collation sequence, which earlier FoxPro
versions use (and to which FoxPro 2.5b still defaults),
each character in the code page, whether it's a Roman
character, an accented character, or a line-drawing
character, has a unique "sort weight" determined by its
position in the code page. In a majority of code
pages, all accented characters appear after the unaccented
characters. In this situation an � sorts after z, which
isn't correct in most languages (although it is true in
Swedish, for instance).
Furthermore, in most languages accented characters sort
after their unaccented counterparts, but only if the
unaccented versions of all characters being compared are
the same. For example, in German, � sorts after the
unaccented a, but the string �a sorts before the string ab
because the second character a is less than the second
character b. In this way, characters are interleaved in
many cultures.
FoxPro 2.5b supports a number of new collation sequences
to correctly sort in many languages. These sequences take
into account all the complex rules of the language
(including two-to-one, three-to-one and one-to-two
mappings). The following collation sequences were
available when this README was created. The code pages
for which these collation sequences are defined are also
included.
Collation Sequence Friendly Name Code Pages
------------------ ------------- ----------
CZECH Czech 852, 895, 1250
DUTCH Dutch 437, 850, 1252
GREEK Greek 737, 1253
GENERAL General 437, 620, 850,
852, 861, 865,
895, 1250, 1252,
10000
HUNGARY Hungarian 852, 1250
ICELAND Icelandic 437, 850, 861,
1252
MACHINE Machine All
NORDAN Norwegian/Danish 437, 850, 865,
1252
POLISH Polish 620, 852, 1250
RUSSIAN Russian 866, 1251
SLOVAK Slovak 852, 895, 1250
SPANISH Spanish 437, 850, 1252
SWEFIN Swedish/Finnish 437, 850, 1252
UNIQWT Unique Weight 437, 850, 1252,