                           Welcome to
                 Borland Pascal with Objects 7.0
                         CD-ROM Edition
                 ===============================

This README file contains configuration and installation
information for the CD-ROM Edition of Borland Pascal with Objects
7.0. For product-specific information about Borland Pascal with
Objects 7.0, refer to the README file in the D:\BP directory.

Table of Contents
-----------------
1. Introduction
2. Using the CD-ROM Edition
   - Installing to a hard drive
   - Running from the CD-ROM
   - Optimal file distribution between a hard drive and the CD-ROM
3. Using the run-time library with debug information
4. Notes for Windows 3.0 users

1. INTRODUCTION
---------------
The CD-ROM Edition of Borland Pascal with Objects 7.0 includes:

  o  A completely installed version of Borland Pascal with Objects
  o  A ready-to-install version of Borland Pascal with Objects
  o  The Borland Pascal with Objects run-time library source code
  o  A version of the run-time library built with debug information
  o  Compiled examples built with debug information

The CD-ROM Edition enables you to run Borland Pascal with Objects
in several different configurations, including:

  o  Running entirely from a hard drive
  o  Running entirely from the CD-ROM
  o  Selectively copying executables and other
     performance-sensitive files to a hard drive

This document and all configuration files assume that the CD-ROM
is in Drive D and the hard drive is Drive C. If your system has a
different configuration, you must modify configuration files
accordingly (see below). We also assume that your hard drive's
Windows directory is C:\WINDOWS and the base directory for
Borland Pascal with Objects is C:\BP.


2. USING THE CD-ROM EDITION
---------------------------

Installing from the CD-ROM
--------------------------
The \INST directory of the CD-ROM contains an installable version
of Borland Pascal with Objects. To install to a hard drive or
network, run the INSTALL.EXE program located in the \INST
directory.


Running from the CD-ROM
-----------------------
Here's how to run Borland Pascal with Objects from the CD-ROM:

  1. Create C:\BP\BIN and copy the contents of D:\CONFIG to
     C:\BP\BIN.

  2. Copy the D:\WINDOWS\BPW.INI and D:\WINDOWS\TDW.INI files
     to C:\WINDOWS.

  3. Copy D:\WINDOWS\SYSTEM\BWCC.DLL to C:\WINDOWS\SYSTEM. See
     the section entitled "Notes for Windows 3.0 Users" if you
     are running Windows 3.0.

  4. Add D:\BP\BIN to your DOS path.

  5. If you want to change the CD-ROM's default IDE configuration
     file for BP.EXE or TURBO.EXE, you can save a modified copy
     on your hard drive and supply its location as a command-line
     parameter:

       BP -cC:\BP\BIN\BP.TP

    Or you can create a BP.BAT file in C:\BP\BIN that contains
    the following:

      set BPCFG=
      if not exist BP.TP set BPCFG=/Cc:\bp\bin\bp.tp
      bp %BPCFG% %1 %2 %3 %4 %5 %6 %7 %8 %9
      set BPCFG=

  Notes
  -----
  You can use the compiled versions of the example programs by
  running them from the command line or from the Windows Program
  Manager. You can also load and debug them using Turbo Debugger
  (TD.EXE, TDW.EXE, or TDX.EXE).

  Some CD-ROM device drivers are not compatible with THELP.COM,
  the memory-resident (TSR) Help viewer. If THELP cannot load
  Help files from your CD-ROM, copy the .TPH files you want from
  D:\BP\BIN to C:\BP\BIN. If you intend to use THELP to read
  multiple help files, refer to the Tools and Utilities Guide for
  information on creating a THELP.CFG file.


  Creating a Windows Program Manager Group
  ----------------------------------------
  Run the GROUPS program (D:\WINDOWS\GROUPS.EXE) to create a
  Windows Program Manager group for Borland Pascal with Objects.
  GROUPS uses a data file (D:\CONFIG\GROUPS.B$$) to determine the
  names and locations of group items.

  D:\CONFIG\GROUPS.B$$ contains all the standard Borland Pascal
  with Objects executables and lists their locations in their
  default directories on Drive D. Select the Program Manager's
  File|Run and enter the following:

    D:\WINDOWS\GROUPS D:\CONFIG\GROUPS.B$$

  GROUPS will execute and allow you to create a program group.

  If you plan to move one or more executables to your hard drive,
  you can modify the copy of GROUPS.B$$ in C:\BP\BIN using any text
  editor (for example, BP or NotePad). You can then run GROUPS.EXE
  using your modified version of GROUPS.B$$.


Optimal File Distribution between a Hard Drive and the CD-ROM
-------------------------------------------------------------
D:\OPTIMAL contains executables and other performance-sensitive
files which can be copied to C:\BP\BIN. Placing these files on
your hard drive will dramatically improve performance while still
using considerably less hard disk space than a full installation
(approximately 3 Mb vs. 30 Mb).

D:\OPTIMAL contains the minimum set of files needed to run Borland
Pascal with Objects under either DOS and Windows. Examples, compiled
libraries, and most Help files remain on Drive D.

Here's how to use this configuration option:

  1. Create C:\BP\BIN and copy the contents of D:\OPTIMAL to
     C:\BP\BIN.

  2. Copy D:\WINDOWS\BPW.INI and D:\WINDOWS\TDW.INI to
     C:\WINDOWS.

  3. Copy D:\WINDOWS\SYSTEM\BWCC.DLL to C:\WINDOWS\SYSTEM. See
     the section entitled "Notes for Windows 3.0 Users" if you
     are running Windows 3.0.

  4. Add C:\BP\BIN;D:\BP\BIN to your DOS path.

You can further improve performance by creating C:\BP\UNITS and
copying the contents of D:\BP\UNITS to C:\BP\UNITS.

Note that TURBO.TPH must be located in the same directory as the
DOS IDE. All other .TPH files can be accessed from Drive D.

Note that a GROUPS.B$$ file is provided in D:\OPTIMAL that can
be used to create a Windows Program Manager group for this
configuration.  See the section "Creating a Windows Program
Manager Group" for more information regarding the use of
GROUPS.B$$.


3. USING THE RUN-TIME LIBRARY WITH DEBUG INFORMATION
----------------------------------------------------
A copy of the run-time library (RTL) source code compiled with
debug information is provided in D:\BP\RTL.

There are two ways to force the compiler to use a .TPL with debug
information:

  o Change to the directory that contains the .TPL file with
    debug information and start the compiler. For example,

      D> CD D:\BP\RTL\BIN
      D> BP

  o Overwrite the .TPL files on your hard drive with those from
    D:\BP\RTL\BIN. Note that this method will work only if you
    are running BP from your hard drive.

To allow the DOS IDE to find RTL assembler source, use the
Options|Directories menu to set the INCLUDE directory path to
D:\BP\RTL and then re-compile your program.

The debug version of the RTL also includes compiled versions of
Turbo Vision (\BP\RTL\BIN\TV), ObjectWindows (\BP\RTL\BIN\OWL),
and the Windows 3.1 interface files (\BP\RTL\BIN\WIN31), each
with debug information enabled.

To create a copy of the RTL on your hard drive, run INSTALL.EXE
located in D:\RTLINST.

See the README file in D:\RTLINST for more information on using
and building the RTL.


4. NOTES FOR WINDOWS 3.0 USERS
------------------------------
If you are using Windows 3.0, the INSTALL program will install
new versions of some Windows system files.

If you choose not to use the INSTALL program, however, you will
need to update these Windows files manually.  Here's how to update
Windows 3.0 for use with Borland Pascal with Objects 7.0:

  1. Copy D:\BP\BIN\WINHELP.* to C:\WINDOWS.

  2. Copy D:\WINDOWS\SYSTEM to C:\WINDOWS\SYSTEM


                      *    *    *    *    *
