            Welcome to Borland Pascal with Objects 7.0
            ------------------------------------------

This README file contains important, last minute information
about Borland Pascal with Objects 7.0. In addition to this file,
there are several files in the \BP\DOC directory that you should
browse. See FILELIST.DOC in the \BP directory for a complete list
of all files distributed with this package.


TABLE OF CONTENTS
-----------------
 1. How to get help
 2. Minimum system requirements
 3. Installation
 4. Run-time library source code installation
 5. New features
 6. Release notes
    - Changes to the documentation
    - Demonstration and utility program notes
    - Compatibility and known problems
 7. Redistributable files
 8. Important note for Borland C++ and Paradox 4.0 users
 9. Borland Pascal with Objects and the OS/2 Workplace Shell


1. HOW TO GET HELP
------------------
If you have any problems with this product, please read this
file, the online documentation files in \BP\DOC, the online help
files, and the Borland Pascal with Objects manuals first. If you
still have a question and need assistance, help is available from
the following sources:

1. You can use your modem to easily obtain assistance online.
   Borland maintains support forums on CompuServe, BIX, and
   GEnie. There, you'll have contact with Borland technical
   support engineers and thousands of programmers using Borland
   products. They will answer your questions and share
   information and ideas with you.

   You can also download the latest technical information, sample
   code, utilities, patches, etc. from these online services as
   well as from Borland's Download Bulletin Board Service
   (DLBBS).

   Access Borland's online services in the following manner:

   CompuServe
     GO BORLAND

   BIX
     JOIN BORLAND

   GEnie
     BORLAND

   Borland DLBBS
     You can reach the Borland DLBBS by dialing (408) 439-9096
     (up to 9600 Baud, 8 data bits, No Parity, 1 Stop bit). No
     special setup is required.

2. TechFax is a toll-free, 24-hour automated service that sends
   free technical information to your fax machine. More than
   1,000 documents discussing Borland software are available
   through TechFax. These documents provide valuable technical
   information that can be used as reference now and in the
   future.

   You can call TechFax at 1-800-822-4269 from any touch tone
   telephone and obtain any bulletins or documents that you need.

3. The Technical Support Hot Lines are there to help you with
   questions about installation, system configuration,
   compatibility, and or usability. Lines are open from 6:00 A.M.
   to 5:00 P.M. Pacific Time at (408) 461-9177.

4. If an advanced level of support is required, Borland offers
   a new Advisor Lines service. Advice concerning program design,
   debugging and performance tuning is available. Advisor Lines
   operate from 8:00 A.M. to 5:00 P.M. Pacific Time at
   1-900-786-6080. Each call is $2.00/minute with the first
   minute free (available in U.S. only).

When calling Borland's Technical Support, please keep your
manuals handy and have the program running. To simplify trouble-
shooting, please be prepared with the following information:

  o Product name, serial number, and version number.

  o Computer name and model and the name and model of any
    additional hardware (video adapters, modems, etc.).

  o Operating system and version number (to find the version
    number, type VER at any DOS prompt). If you are using
    Microsoft Windows, you can find the version number by
    selecting Help|About from Program Manager.

  o The contents of your AUTOEXEC.BAT and CONFIG.SYS files
    (located in the root directory (\) of your computer's boot
    disk).

  o The contents of your WIN.INI and SYSTEM.INI files located in
    your Windows directory (if you are running Windows).

  o A daytime phone number where you can be reached.

  o The specific steps necessary to reproduce the problem.


2. MINIMUM SYSTEM REQUIREMENTS
------------------------------
The Windows applications in this package (Borland Pascal for
Windows, Resource Workshop, etc.) run only in Standard or
Enhanced mode under Microsoft Windows 3.0 or later.

The DOS protected-mode applications in this package (BPC.EXE,
BP.EXE, TDX.EXE, etc.) require MS-DOS 3.0 or later, 2 Mb of
available extended memory, and an 80286 or later processor.

When running a DOS protected-mode application under Windows, make
sure to create a Windows .PIF file and specify a value of 0 in
the XMS Memory KB Required setting and at least a value of 1024
in the XMS Memory KB Limit setting. Turbo Debugger (TD.EXE only)
requires at least 1024 Kb of expanded memory (EMS).

Note that DOS protected-mode applications produced with Borland
Pascal with Objects 7.0 will have similar system requirements.

The real-mode integrated development environment, TURBO.EXE,
requires MS-DOS 3.0 or later and at least 512 Kb of memory.


3. INSTALLATION
---------------
IMPORTANT: Borland Pascal with Objects 7.0 is not intended to be
installed over any previous version of Turbo Pascal.

Use the INSTALL program to install Borland Pascal with Objects.
The files on the distribution disks are all archived and INSTALL
will de-archive them for you. INSTALL places them into
subdirectories and automatically creates configuration files for
the command-line compilers and the Integrated Development
Environments (IDEs).

Installation of the full product requires approximately 33 Mb of
available disk space. (The installed product occupies about 28
Mb. However, about 5 Mb of temporary workspace is required to
de-archive very large ZIP files.) The actual disk space occupied
by this product and the amount of temporary work space required
will vary depending on your disk's cluster size. If you are using
a disk compression utility (e.g. Stacker), you'll need
substantially more temporary workspace to avoid a disk full error
(the amount you'll need will vary and some systems might require
up to 45 Mb available disk space before running INSTALL).

All further references to directory paths in this README file
assume you've used INSTALL's default directory structure.

To start the installation, place the disk labeled INSTALL in
Drive A:, and type A:INSTALL.

Borland Pascal with Objects allows you to create applications for
these target platforms:

  o DOS real mode
  o 16-bit DOS protected mode (DPMI)
  o Windows

In addition, you can use either DOS or Windows as your host
development environment. Both the DOS-hosted IDE (BP.EXE) and the
Windows-hosted IDE (BPW.EXE) can produce applications for all
three platforms.

You can disable target support for a particular platform by
selecting the "Target Platforms" menu item (from the main install
dialog box) and setting the target option to "Don't Install."

When you toggle any of the three target platforms (to either
"Install" or "Don't Install"), the Install program automatically
modifies the settings for the product components that relate to
that platform.

Windows Installation Notes
--------------------------

The following is a list of Windows .INI files and DLLs in your
Windows directory that Install might modify:

  o WIN.INI - Temporarily modified if you install a Program
    Manager group. The original WIN.INI is saved as WININI.OLD.
    The next time you start Windows, the group creation program
    runs and then restores WIN.INI to its original state.

  o SYSTEM.INI - Modified if you install TDDEBUG.386. The
    original file is saved as SYSINI.OLD. The line
    "device=tddebug.386" is placed in the [386ENH] section, and
    if the line "device=windebug.386" is present, it is removed.

  o TDW.INI - Modified if you install Turbo Debugger for Windows.
    The original file, if present, is saved as TDWINI.OLD.

  o BPW.INI - Created if you install the Windows IDE (BPW.EXE).

  o SYSTEM\BWCC.DLL - Overwritten with the BWCC version 1.3. You
    can tell INSTALL where to place this file by selecting
    "Directory Options", and changing the path for "BWCC.DLL".


4. RUN-TIME LIBRARY SOURCE CODE INSTALLATION
--------------------------------------------
This product includes the run-time library (RTL) source code,
including the Turbo Vision and ObjectWindows application
frameworks. To install the RTL on your system, run the
installation program on the RTL source code disk and read its
accompanying README file.


5. NEW FEATURES
---------------
Borland Pascal with Objects 7.0 offers many new features,
including:

  o DOS protected-mode applications - Create DOS applications
    that run in protected mode and gain access to all available
    extended memory (up to 16 MB).

  o DOS DLLs - Produce DLLs (Dynamic-Link Libraries) for DOS
    protected-mode applications. Using the WINAPI unit, you can
    generate one Pascal DLL and use it in both DOS and Windows
    programs. See \BP\EXAMPLES\CHESS for an extensive example of
    sharing a Pascal DLL between DOS and Windows chess programs.
    See \BP\EXAMPLES\GREP for an extensive example of sharing a
    DLL written in C between DOS and Windows programs.

  o Multi-target IDEs - Produce DOS, Windows, and protected-mode
    DOS applications from inside the same IDE (your choice of
    Windows-hosted BPW.EXE or DOS protected-mode hosted BP.EXE).

  o ObjectBrowser - Browse units, objects, and symbols while you
    edit your source code in either DOS or Windows. Includes full
    cross-reference information for every identifier in your
    program.

  o Syntax highlighting - Assign unique text colors (and font
    attributes under Windows) for symbols, reserved words,
    identifiers, strings, etc. You can also print your syntax-
    highlighted source code (bold, italics, etc.) from inside the
    IDEs.

  o Tools menu in the IDEs that enable you to transfer control to
    external programs, such as GREP or Turbo Assembler. You can
    add your own tools to the Tools menu in the DOS IDEs.

  o Persistent symbols - BP and BPW save your program's symbol
    information across sessions so you can instantly browse or
    debug your program after exiting and then reloading the IDE.

  o User-installable Help files in the DOS IDEs. Indexes from
    multiple Help files are automatically merged so you can
    perform keyword or incremental searches.

  o Local Menus - A click of the right mouse button (or Alt+F10)
    brings up a context-sensitive menu in all our new IDEs.

  o Optimizations, run-time library and debugging enhancements

    o Now automatically recognizes 386 (or later) processors
      and uses fast 32-bit instructions for longint arithmetic
    o Redundant pointer load suppression
    o Faster text file I/O
    o Faster string Pos routine
    o Optimized sets
    o PChar support - Allows null terminated strings
    o Integer overflow checking {$Q+/-} - Integer, Word, etc
    o OBJ file line number information pass-through - Allows
      stepping through C or ASM code using the integrated
      debugger

  o Language extensions

    o Open array parameters - Allows safer, more flexible
      variable-length array parameters.
    o New OpenString type - Allows a procedure or function
      to accept any type of string parameter, even in the
      {$V+} state.
    o Constant parameters - Efficient, read-only value
      parameters.
    o Public/private sections - Allows public and private
      sections of objects to be declared in any order.
    o Typed @ operator {$T+/-} - Enforces type-checking when
      using the address (@) operator.
    o Inherited reserved word - Allows references to an inherited
      method without knowing the ancestor's name.

  o New standard procedures/functions

    o Assigned - Returns True if a pointer is not equal to nil
      (especially useful for procedure and function pointers).
    o Include - Adds an item to a set.
    o Exclude - Removes an item from a set.
    o Break & Continue - FOR, WHILE, REPEAT loop control.
    o Low & High - Return the low or high bounds of open array
      parameters or of any scalar type.

  o ObjectWindows enhancements

    o New printer objects to simplify printing in Windows.
    o Data-validation objects.

  o WinPrn unit - Enables easy printing of text files from
    within your Windows programs.

  o Turbo Vision enhancements

    o Data-validation objects.
    o New outliner object.
    o New methods for inserting/executing windows and dialog
      boxes.
    o Multi-state check boxes.
    o Cluster items that can be disabled.

  o Turbo Debugger for DOS protected-mode (TDX.EXE) - Special
    version of Turbo Debugger used for debugging DOS
    protected-mode applications.

  o Turbo Debugger for Windows now includes XGA/SVGA support for
    several popular chip sets, including Tseng, Ultra, ATI, 8514,
    and others.

  o Completely reorganized printed documentation with new
    tutorial programs.

  o Expanded online Help system covering all new features.

See the "What's new" section of the User's Guide for more
information regarding the new features of Borland Pascal with
Objects 7.0.


6. RELEASE NOTES
----------------

CHANGES TO THE DOCUMENTATION

  Changes and corrections to the printed documentation are in the
  \BP\DOC directory (MANUAL.TV, MANUAL.RW, etc.).


DEMONSTRATION AND UTILITY PROGRAM NOTES

  o DOC DEMOS - Source code to all of the examples in the
    documentation can be found in the \BP\EXAMPLES\DOCDEMOS
    subdirectory.

  o BGIDEMO SHOWS VESA SUPPORT - See BGIDEMO.PAS in the
    \BP\EXAMPLES\DOS\BGI directory for information on how to
    autodetect and use the new VESA16.BGI driver. It supports all
    standard 16-color VESA high resolution modes (800x600,
    1024x768, 1280x1024).

  o COMPILING DEMOS - There are several major new demonstration
    programs that consist of multiple units each. Make sure
    you're in the directory that contains the demo source code
    before compiling. For example, to build TVCHESS.PAS, the
    Turbo Vision chess demo, change to the \BP\EXAMPLES\CHESS
    directory before doing a compile with either the integrated
    development environment or the command-line compiler.

  o SOURCE CODE TO UTILITY PROGRAMS - The DOS integrated
    development environments' new syntax-highlighted printing
    relies on a print filter utility that you can modify.
    PRNFLTR.PAS can be found in the \BP\EXAMPLES\UTILS directory.

    For an example of how to write a tool filter for the DOS IDE,
    see GREP2MSG.PAS (the Tool menu's GREP message filter) in the
    same directory.


COMPATIBILITY & KNOWN PROBLEMS

  DOS
  ---
  o TURBO VISION 1.0 SOURCE - The virtual method table (VMT)
    format was modified to support dynamic methods (DMTs). You
    must update any code which relies on fixed offsets into VMTs.

    The Turbo Vision source code accompanying this package has
    already been modified. If, for some reason, you want to
    recompile the Turbo Vision source code provided in the Turbo
    Pascal 6.0 Run-time Library Source Code product, change the
    following constant declarations to the values specified
    below:

      OBJECTS.PAS:
        TStream_Error = $0C;
        TStream_Flush = $10;
        TStream_Read  = $1C;
        TStream_Write = $28;
        ...
        TCollection_Error    = $0C;
        TCollection_SetLimit = $24;

      VIEWS.PAS:
        TView_GetPalette = $30;

  Windows
  -------
  o USE NEW BWCC, TDW, RW, ETC. - Make sure you replace previous
    versions of Borland development tools for Windows with the
    versions provided in this package. These include:

      o Borland Custom Controls (BWCC.DLL)
      o Turbo Debugger for Windows (TDW.EXE)
      o Resource Workshop (WORKSHOP.EXE)
      o WinSpector (WINSPCTR.EXE)
      o WinSight (WINSIGHT.EXE)

    By using the programs and libraries accompanying this
    product, you'll ensure that all versions of Borland
    development tools for Windows are synchronized.

  o WINDOWS 3.1 DEBUG KERNEL RECOMMENDED - Due to incompatibilities
    between the Microsoft Windows 3.0 and 3.1 debug kernels, we
    strongly recommend that you upgrade to Windows 3.1.

  o NEW WINHELP - If you are using Windows 3.0, update your
    Windows Help system (WINHELP.EXE and WINHELP.HLP) to the
    Windows 3.1 versions which are in the \BP\BIN directory. You
    can safely overwrite the 3.0 versions of these files with the
    3.1 versions.

  o WOBJECTS REORGANIZED - In ObjectWindows, the WObjects unit
    has been reorganized into several smaller, more logical
    units. To recompile any ObjectWindows program which
    previously used only WObjects, modify the uses clause to
    read:

      uses Objects, OMemory, OWindows, ODialogs;

    Streams and collections are now found in the Objects unit,
    which is shared between DOS and Windows programs. Finally,
    the StdDlgs and StdWnds units have been renamed to OStdDlgs
    and OStdWnds, respectively.

    Note that this change should be made to the example programs
    included with the "World of ObjectWindows Video Training"
    product. No other modifications to examples are required.

  o BWCC.DLL - The version of BWCC.DLL in this product can cause
    minor display problems in applications using BWCC. If a
    non-BWCC static text control is disabled, the foreground
    color will be the same as the background color and the text
    will not be visible. You can easily work around this problem
    by using the Windows Control Panel Color application to
    change the color of Disabled Text from light gray to dark
    gray.


  DOS Protected Mode
  ------------------
  o OLDER SYSTEM UTILITIES - Some older system utilities and
    application programs (memory managers, disk caches, RAM
    disks, etc.) do not observe current industry standards for
    DOS protected-mode operation. We recommend that you upgrade
    such utilities to more recent versions.

  o WINDOWS AND PROTECTED-MODE APPLICATIONS - Starting Windows in
    enhanced mode from a DOS shell created by a DOS
    protected-mode program (such as RTMRES.EXE or BP.EXE) is
    unsafe. Normally Windows refuses to load in enhanced mode
    under such conditions, but in certain situations it can hang
    the system. Therefore, a DOS protected-mode program that
    invokes Windows should always start Windows in Standard mode.

  o 386^MAX DPMI SERVER - There are known problems with pre-6.02
    versions of the 386^Max DPMI server. We recommend that you
    obtain and use their latest version (or use the Borland DPMI
    server instead).

  o CTRL-C UNDER 386^MAX - If you are using 386^MAX 6.01-6.02
    with DPMI support, the BP critical-error handlers and
    Control-C handlers will not be effective. You can work around
    this problem by putting the NODPMI switch into your
    386MAX.PRO file.

  o COMPAQ VDISK - If you are running on a Compaq 386 with Compaq
    DOS v3.31, you should not use the Compaq VDISK. This version
    of VDISK is not compatible with DOS protected-mode
    applications.

  o GLOBALNOTIFY - If you have a notification procedure set with
    GlobalNotify in a DOS protected-mode application, the system
    will ignore a return value of FALSE. In other words,
    returning FALSE from a notification procedure to prevent a
    block from being discarded will not work; the block will
    always be discarded.

  o GLOBALALLOC - The GMEM_NODISCARD flag is ignored by
    GlobalAlloc.

  o CTRL-C IN OS/2 DOS BOX - If you are running under an OS/2 DOS
    box, you will not be able to use Control-C in your DOS
    protected-mode applications. Control-C will cause the DOS
    session to crash. This is a bug in OS/2's DOS protected-mode
    support that will be fixed in a future release.

  o OS/2 AND DOS PROTECTED-MODE APPLICATIONS - If you run a DOS
    protected-mode application under OS/2 that starts another DOS
    protected-mode application, both applications MUST use the
    same protected-mode loader.

    There is a known problem in OS/2 which will cause the DOS
    session to crash after the second application terminates if
    it uses a different loader. This will be fixed in a future
    release of OS/2's DOS protected-mode support.

    It is OK to start other DOS protected-mode applications that
    have been built with Borland Pascal with Objects (or BP.EXE
    itself) since they will be loaded by the Borland DOS
    protected-mode loader (RTM.EXE).

    Note that it is not safe to start Paradox 4.0 from a DOS
    protected-mode application written in Borland Pascal with
    Objects.


  Turbo Debugger and Profiler
  ---------------------------
  o TDW VIDEO DLLS - If your display is corrupted when debugging
    with Turbo Debugger for Windows (TDW.EXE), you might not be
    using the correct video DLL. For further information on video
    DLLs, refer to README.TD in the \BP\DOC directory.

  o TDX DLL DEBUGGING - TDX.EXE does not always release the memory
    used for DLL symbol tables when debugging DOS protected-mode
    DLLs. Repeated stepping in and out of a DLL can eventually
    create a low memory condition. Exit TDX and reload it if you
    run out of memory during a debugging session.

  o TPROFW LOW MEMORY - If you experience problems when profiling
    large Windows applications, reduce the amount of debug
    information generated by placing a {$D-} directive in some of
    the units not being profiled and then recompile your
    application.


7. REDISTRIBUTABLE FILES
------------------------

BORLAND PASCAL WITH OBJECTS REDISTRIBUTABLE FILES

  The following files are intended for redistribution (along with
  your applications) under the terms of the license statement
  accompanying this product:

    RTM.EXE, RTMRES.EXE, DPMI16BI.OVL, DPMIINST.EXE,
    DPMILOAD.EXE, BWCC.DLL

  In addition, see the DPMIUSER.DOC in the \BP\DOC directory for
  DOS protected-mode documentation that you may modify and
  provide to users of your DOS protected-mode applications.

MICROSOFT WINDOWS 3.1 REDISTRIBUTABLE FILES

  This Borland language product contains everything you need to
  develop applications to run on the most recent version of
  Microsoft Windows, version 3.1. In some cases, you might need
  to copy and include in your application one or more Microsoft
  "redistributable" files from a copy of version 3.1 so that your
  application will also run on version 3.0. Microsoft informs us
  that you may copy the redistributable files from Microsoft
  Windows 3.1 for this purpose. If you do so, you must comply
  with the conditions stated in the Borland No-Nonsense License
  Statement included in this package as if the redistributable
  files you copy were a part of this Borland language product.
  Microsoft's redistributable files in Windows 3.1 are:

    COMMDLG.DLL, DDEML.DLL, LZEXPAND.DLL, OLECLI.DLL, OLESVR.DLL,
    SHELL.DLL, STRESS.DLL, TOOLHELP.DLL, VER.DLL, WINHELP.EXE,
    WINHELP.HLP, and WINMEM32.DLL.

  Other Microsoft redistributable files not included in this
  release can be found in the latest version of Microsoft
  Windows.


8. IMPORTANT NOTE FOR BORLAND C++ AND PARADOX 4.0 USERS
-------------------------------------------------------
The DPMILOAD.EXE and DPMI16BI.OVL files provided with this
release replace the older ones that came with Paradox 4.0 and
BC++ 3.0 or later. Delete or rename the older versions and put
\BP\BIN on your DOS path (so Paradox and BC can use the newer
ones).

If you want to be able to run BC++ or Paradox from within BP.EXE,
you will need to use the EXTLEAVE option for the RTM environment
variable in order to leave enough memory available. For example,
you can set aside 2 MB for other programs by using:

  SET RTM=EXTLEAVE 2048

See the printed documentation for more information regarding the
RTM environment variable.

If you plan to shell out from Paradox or BC++ to run BP.EXE,
limit the amount of extended memory used by those programs. For
Paradox, use its /extk command-line parameter; for BC++, use its
/x command-line parameter. Refer to their documentation for more
information on the use of command-line options.

Here's a summary for troubleshooting purposes:

  1.  Are there any copies of DPMILOAD.EXE or DPMI16BI.OVL on the
      path prior to those provided in \BP\BIN or in the same
      directories as BC.EXE or PARADOX.EXE? If so, replace them
      with Borland Pascal with Objects 7.0's newer versions, or
      remove them and set your DOS path correctly.

  2.  Have you set the RTM environment variable? For example:

        SET RTM=EXTLEAVE 2048

  3.  If starting Paradox or BC first, have you used the required
      command-line options?


9. BORLAND PASCAL WITH OBJECTS AND THE OS/2 WORKPLACE SHELL
-----------------------------------------------------------
These are the steps for creating a program icon for BP.EXE under
the OS/2 2.0 Workplace Shell:

  1.  From the OS/2 desktop, double-click the Templates folder
      to open it, grab the Program icon and drop it onto the
      desktop or another folder.

  2.  When the Program Settings dialog box appears, enter the
      following:

        Path and file Name: *
                Parameters: /C C:\BP\BIN\BP.EXE
         Working directory: C:\BP\BIN

      Substitute the appropriate drive/path as needed.

  3.  Click the Session thumb tab and select DOS full screen
      or DOS window as desired.

  4.  Click on the General thumb tab and enter Borland Pascal
      with Objects for the program title.

  5.  Double-click the Close button.

                      *    *    *    *    *
