
               Welcome to Turbo Pascal for Windows 1.5
               ---------------------------------------

This README file contains important, last minute information
about Turbo Pascal for Windows.

In addition to the release notes in this file, browse the
following text files in the \TPW\DOC directory:

  MANUAL.TPW, MANUAL.RW, README.RW, and README.TDW

These contain corrections to the printed documentation and other
useful information.

A complete list of all files is provided in the file FILELIST.DOC
in the \TPW directory.


TABLE OF CONTENTS
-----------------
1.  How to Get Help
2.  Installation
3.  System Requirements
4.  Turbo Help
5.  Features
6.  Release Notes
7.  Windows 3.1 Redistributable license

1. HOW TO GET HELP
-------------------
If you have any problems, please read this file, the *.DOC files
in \TPW\DOC, and the Turbo Pascal manuals first. If you still
have a question and need assistance, help is available from the
following sources:

1. Type GO BORLAND on the CompuServe bulletin board system. If
   you are not a member of CompuServe, see the enclosed brochure.

2. Check with your software dealer or user group.

3. If you have an urgent problem and you have sent in the license
   agreement that accompanied this package, you may call the
   Borland Technical Support Department at (408) 461-9144. Please
   have the following information ready before calling:

   a. Product name and serial number from the distribution disks.

   b. Computer brand, model, and the brands and model numbers of
      any additional hardware.

   c. Operating system and version number. (The version number
      can be determined by typing VER at the DOS prompt. The
      Windows version number is displayed in the Program
      Manager's About Box.)

   d. Contents of your AUTOEXEC.BAT, CONFIG.SYS, TPW.INI and
      WIN.INI files.



2. INSTALLATION
---------------

NOTE: Before running the INSTALL program, you should disable any
Windows screen savers.  The install process will not complete
properly if interrupted by a screen saver.

NOTE: The installation program needs at least 1MB of free memory
to run.

Use the INSTALL program to install Turbo Pascal for Windows. The
files on the distribution disks are all archived and INSTALL will
de-archive them, place them into subdirectories and automatically
create configuration files for both the command-line compiler and
the Integrated Development Environment (IDE). All further
references to directory paths in this README file assume you've
used INSTALL's default directory structure.

To run the installation program from Drive A type

    WIN A:INSTALL

or, if Windows is active, select Program Manager's File|Run
command and type

    A:INSTALL

Install will unpack the compressed archive files (*.PAK) into
subdirectories on your hard disk. These files can also be
unpacked manually using the UNPAK.EXE utility. Your system must
have at least two megabytes of memory available to run Turbo
Pascal for Windows. Neither the Install program nor Turbo Pascal
for Windows will run in real mode.

Path Information
----------------
If you want to use the command line utilities provided with TPW
1.5, you will need to add the \TPW\UTILS directory to your DOS
path.  Other than these utilities, TPW does not require any of
its components to be listed on the DOS path.

Installing over Turbo Pascal for Windows Version 1.0
----------------------------------------------------
You can install Turbo Pascal for Windows Version 1.5 to the same
directory as version 1.0.  You can delete the Whitewater Resource
Toolkit (located in \TPW\UTILS) in favor of using Resource
Workshop, if desired.  The files you can delete are:  WRT.DAT,
WRT.EXE, WRT.FON, WRT.IMA, and WRT.HLP.  In addition, updated
versions of some Resource Workshop demos are located in the
Resource Workshop demo directory (\TPW\RWDEMOS).  You can delete
any duplicates of these newer files (located in \TPW\OWLDEMOS)
also.

Online Help under Windows 3.0
-----------------------------
In order to access online help for Turbo Pascal or Resource
Workshop, you must have the help system from Windows 3.1.  If the
Install program detects that you are running Windows 3.0, it will
attempt to rename your current versions of WINHELP.EXE and
WINHELP.HLP, and replace them with the newer Windows 3.1 versions
of the same files.  If this process fails (the Install program
will alert you if this happens), you will need to manually copy
the WINHELP.EXE and WINHELP.HLP from the \TPW directory to your
Windows directory.

Note: If you installed under Windows 3.1, these files were not
copied to your hard disk, since you already have the correct
versions in your \WINDOWS directory.


3. SYSTEM REQUIREMENTS
----------------------
Turbo Pascal for Windows requires at least 2 MB of RAM and runs
on EGA, VGA (and above) and Hercules monochrome video adapters
under Windows 3.0 and 3.1.


4. TURBO HELP
-------------
The fastest way to get help on any Turbo Pascal or Windows API
feature is to use the online help system. Pull down the Help menu
by typing Alt-H or press F1 for more information. TDW has its own
help system and help file as well.


5. FEATURES
-----------
New features in Turbo Pascal for Windows 1.5 include

  o Syntax Highlighting in the editor - Language elements (e.g.,
    reserved words, identifiers) are highlighted with selectable
    colors and fonts. Refer to the "Syntax Highlighting" help
    topic for complete documentation on this feature.

  o SpeedBar - Click an icon to perform common IDE operations,
    such as File|Open or Compile|Make. Refer to the "SpeedBar"
    help topic (Help|Search) for complete documentation on this
    feature.

  o Resource Workshop - Use Borland's award-winning tool to
    create and modify your menu, dialog, and other Windows 3.0
    and 3.1 resources.

  o Full Access to Windows 3.1 - All the TPUs, DLLs and utilities
    you need to take full advantage of the new Windows 3.1
    features including Object Linking and Embedding (OLE),
    Multimedia, TrueType fonts, PenWindows, etc.  Note: you must
    have Windows 3.1 to take advantage of these features.

  o New demo programs:

    COMMDLGS.PAS  - How to access new Common Dialogs DLL
    DDEMLCLI.PAS  - Example of a DDE client application
    DDEMLSVR.PAS  - Example of a DDE server
    MCISOUND.PAS  - Using MCI sound capabilities
                    (requires special hardware)
    OLECLI.PAS    - OLE client application
    OLESERVR.PAS  - OLE server application
    OWLPEN.PAS    - PenWindows example
                    (requires Pen or MS compatible mouse)
    PAINT.PAS     - Complete paint program
    SHELLDEM.PAS  - Win 3.1 Shell API demo
    TTDEMO.PAS    - Shows how to access new TrueType fonts

    (These programs and their accompanying files are located in
     the \TPW\OWLDEMOS directory.  PAINT.PAS is in
     \TPW\OWLDEMOS\PAINT.)

  o Easy access to Borland Window Custom Controls (BWCC) by using
    the BWCC unit provided. Place this unit in your "uses" clause
    to convert all dialogs and windows from StdDlgs and StdWnds
    to BWCC style. The BWCC unit replaces the WObjectB and
    StdDlgsB units that came with previous versions of Resource
    Workshop.

Other Turbo Pascal for Windows features include

  o Windows IDE - A Windows-hosted environment that is a full MDI
    application. You can edit and compile files in the IDE and
    then call TDW to debug your programs. (The IDE even has
    optional Wordstar compatible keys. Select the alternate
    command set on the Options|Preferences dialog.)

  o The compiler and RTL have many extensions for programming
    under Windows (see below). Refer to the demo programs in the
    \TPW\WINDEMOS directory.

  o ObjectWindows - An application framework and library that
    provides an object-oriented layer to Windows programming. Use
    ObjectWindows' object-oriented techniques to build powerful
    Windows applications quickly. ObjectWindows (OWL) demo
    programs are in the \TPW\OWLDEMOS directory. OWL itself is in
    the \TPW\OWL directory.

  o TDW - A special version of the Turbo Debugger that debugs
    Windows 3.0 and 3.1 applications. TDW runs in text mode and
    can be launched from the IDE via the RUN|DEBUGGER menu.

      o uses display swapping to support single monitor debugging
      o full support for Windows DLLs
      o break on Windows messages

    See README.TDW in the \TPW\DOC directory for the latest
    information about TDW.

  o Help system compiler - Use the help compiler to create
    Windows' online help for your programs. The help compiler
    (HC.BAT) is in the \TPW\UTILS directory. The help examples
    are in the \TPW\DOCDEMOS\HELPEX directory.

  o Other compiler and runtime library features:

    o Windows Crt unit (WinCrt) for writing "standard" programs
      that use Writeln and Readln (see \TPW\WELCOME.PAS).
    o Dynamic Method Tables
    o Full support for Windows-style null-terminated strings
    o Link in Windows resource Files ($R directive)
    o Full support for DLLs (Dynamic Link Libraries).

A full suite of DOS command-line utilities, including a DOS
command-line compiler (TPCW.EXE) that produces Windows programs,
MAKE.EXE, and a Windows resource compiler (RC.EXE) are also
provided.


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

Configuration Files
-------------------
  o TPW 1.5 uses the TPW.CFG to store configuration data.  This
    file is intended to be modified only through the Integrated
    Development Environment's dialog boxes.  Editing this file in
    any other way may result in loss of configuration data.


Runtime Libraries
-----------------
  o This version of the Turbo Pascal compiler is fully backwards
    compatible with version 1.0.  However, WOBJECTS.TPU has been
    updated.  Any third party units which list WOBJECTS in their
    "uses" clause will therefore report a "Unit version mismatch"
    error when compiling.  If you do not have the source code to
    these third party units, you can either: a) continue to use
    the WOBJECTS.TPU from TPW 1.0, or b) contact the author for
    an updated unit.  Units to which you do have source code can
    be recompiled using the Compile|Build option.


Integrated Development Environment
----------------------------------
  o The editor's Block Overwrite option is set to ON by default.
    This is a change from version 1.0.

  o The Tile command's shortcut key is now Shift-F4, and Cascade
    is now Shift-F5.  This is a change from version 1.0.  These
    commands have also exchanged positions on the Window menu.


Paradox Engine Sample Program
-----------------------------
  o Turbo Pascal for Windows can access Paradox data tables using
    the Paradox Engine 2.0 Dynamic Link Library (DLL). An example
    program that shows how this is done is included in the files
    \TPW\OWLDEMOS\PXDEMO.PAS and \TPW\OWLDEMOS\PXACCESS.PAS. Note
    that you will need the PXENGWIN.DLL and the sample Paradox
    data files that are included with the Paradox Engine 2.0 in
    order to run PXDEMO. The Paradox Engine 2.0 is available
    separately from Borland and includes support for DOS and
    Windows programming using Turbo Pascal, Borland C and C++,
    and other languages.


Resource Compiler
-----------------
  o Turbo Pascal for Windows 1.5 produces EXE files that will run
    under Windows 3.0 and later. Here's a sample command line
    that uses the resource compiler to produce an EXE that runs
    only under Windows 3.1

      rc -31 myprog.exe


Help Compiler
-------------

  o The Help Compiler for Windows 3.0 (HC.EXE) has been replaced
    by HC.BAT.  This batch file can run either the Windows 3.0
    Help Compiler (HC30.EXE) or the Windows 3.1 Help Compiler
    (HC31.EXE).

    By default, HC.BAT executes HC30.EXE, to produce a help file
    that works with the versions of WINHELP.EXE in either Windows
    3.0 or Windows 3.1.  To take advantage of the new Help
    features of Windows 3.1, use "-n" as the first parameter to
    HC.BAT, which will then execute HC31.EXE.

    HC.BAT, HC30.EXE, HC31.EXE are located in the utilities
    directory. To use these utilities, you'll need to have the
    \TPW\UTILS directory listed on your DOS PATH.

  o There is a complete help example, HELPEX.PAS, in the
    directory \TPW\DOCDEMOS\HELPEX. There is also a complete
    ObjectWindows version of this example (OWLHELP.PAS). You can
    use the HELPEX.MAK file to make both examples by typing

      make -fhelpex.mak

    Make sure the command-line compiler (TPCW.EXE), the help
    compiler (HC.BAT), the resource compiler (RC.EXE) and
    MAKE.EXE are all on your DOS path. If you did not use the
    installation program's default directory structure, you'll
    need to modify HELPEX.MAK accordingly.


OEM vs. ANSI Character Sets
---------------------------
  o DOS text files use the OEM character set; Windows text files
    generally use the ANSI character set. The demo program,
    FCONVERT.PAS (located in \TPW\OWLDEMOS) converts data back
    and forth between these formats. The only text files that
    will be affected are those containing international
    characters (ASCII values above 128) like the umlaut, etc. Not
    all OEM characters are present in the ANSI character set, and
    vice versa. Therefore, converting between these character
    sets may produce a mapping that is not reversible. Refer to
    your Windows documentation for further information about ANSI
    vs. OEM character sets.


Out of Date Drivers
-------------------
  o If your TPW IDE dialog boxes are unreadable, first delete
    TPW.DSK, TPW.CFG and TPW.INI files and then run the IDE
    again.  If the problem persists, contact your video card
    manufacturer for an update of your video drivers, or use the
    VGA.DRV driver supplied with Windows by Microsoft.

  o If you experience difficulty in printing from the IDE, make
    sure you have the newest Windows 3.1 printer drivers from
    Microsoft or from your printer vendor.


Using the Windows 3.1 Debugging Kernel
--------------------------------------
  o The Turbo Pascal for Windows version 1.5 IDE works under
    either the retail or the debugging kernel of Windows 3.1.
    However, you might experience problems with printing from the
    IDE under the debugging kernel.


Using Adobe Type Manager
------------------------
  o Older versions of Adobe Type Manager can cause some fonts to
    not appear in the Options|Preferences dialog box. Adobe Type
    Manager version 2.0 or later corrects this problem. You can
    contact Adobe about upgrades at 1-800-521-1976.


Turbo Pascal for DOS
--------------------
  o A DOS version of Turbo Pascal that produces DOS programs is
    also available. Contact your dealer or distributor, or call
    Borland for upgrade information at 1-800-331-0877 (U.S.
    customers only).


7. WINDOWS 3.1 REDISTRIBUTABLE LICENSE
--------------------------------------
NOTE CONCERNING USE OF MICROSOFT WINDOWS 3.1 REDISTRIBUTABLES FOR
APPLICATIONS RUNNING ON MICROSOFT WINDOWS 3.0

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 may need to
copy and include with 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:
WINHELP.EXE, WINHELP.HLP, COMMDLG.DLL, DDEML.DLL, TOOLHELP.DLL,
VTD.386, OLECLI.DLL, OLESVR.DLL, VER.DLL, LZEXPAND.DLL,
EXPAND.EXE, REGLOAD.EXE, STRESS.DLL, DIB.DRV, MARKMIDI.EXE,
SHELL.DLL and PENWIN.DLL.

Note that some of these files are distributed with Turbo Pascal
for Windows 1.5 while others are part of the Windows 3.1 retail
product.

* * *
