dos_compilers/Borland Turbo Pascal v6/README
2024-07-02 07:11:05 -07:00

407 lines
16 KiB
Plaintext
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

WELCOME TO TURBO PASCAL 6.0
---------------------------
This README file contains important, last minute information about
Turbo Pascal 6.0. In addition to this file, there are several .DOC
files in the \TP\DOC directory that you should browse. The HELPME!.DOC
file answers many common Technical Support questions. The FIXES.DOC
file provides corrections to the printed documentation. And the
TVISION.DOC file gives additional information (reference and tutorial)
about programming in Turbo Vision.
TABLE OF CONTENTS
-----------------
1. How to Get Help
2. Installation
3. Take a Tour
4. Turbo Help
5. New Features
6. Turbo Vision Examples
7. Important Documentation Information
8. Compatibility Notes
9. Testing Expanded Memory
10. Complete List of Files
1. HOW TO GET HELP
-------------------
If you have any problems, please read this file, the *.DOC files in
\TP\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 BPROGA on the CompuServe bulletin board system. If you are
not a member of CompuServe, see the enclosed special offer.
2. Check with your software dealer or user group.
3. Write to us:
Borland International
Turbo Pascal 6.0 Technical Support
1800 Green Hills Road
P.O. Box 660001
Scotts Valley, CA 95067-0001
Please include your serial number or we will be unable to process
your letter.
4. 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) 438-5300. Please have the
following information ready before calling:
a. Product name and serial number from the distribution disks.
b. Product version number. Both the IDE and the command-line
compiler display a version number when they are executed.
c. Computer brand, model, and the brands and model numbers of
any additional hardware.
d. Operating system and version number. (The version number can
be determined by typing VER at the DOS prompt.)
e. Contents of your AUTOEXEC.BAT and CONFIG.SYS files.
2. INSTALLATION
---------------
Use the INSTALL program to install Turbo Pascal. The files on the
distribution disks are all archived and INSTALL will de-archive them
for you. INSTALL will 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 start the installation, place the disk labeled INSTALL in Drive A:,
change to Drive A: and type A:INSTALL.
A:
INSTALL
INSTALL works on both hard disk and dual-floppy systems. If you decide
to de-archive files manually, just run the UNZIP program (found on the
INSTALLATION disk) on any .ZIP file. For example, to de-archive
TPC.EXE and TURBO.TPL from the TURBO.ZIP file on Drive A:, type:
unzip a:turbo turbo.tpl tpc.exe
This places TURBO.TPL and TPC.EXE onto the current drive or directory
(and assumes UNZIP.EXE is already in the current drive or directory).
3. TAKE A TOUR
--------------
Take an online tour of the new Integrated Development Environment. Run
TPTOUR from the \TP directory for a 10-minute introduction to editing,
compiling and running programs in the new IDE.
4. TURBO HELP
-------------
The fastest way to get help on any Turbo Pascal feature is to use the
newly expanded online help system. Pull down the Help menu by typing
Alt-H and then browse topics (via the Contents menu) or lookup
identifiers (by selecting Topic search). If it's in Turbo Pascal, it's
in the help system! And if you use the command-line compiler and your
own editor, you can still get Turbo Help using THELP.COM. THELP is a
TSR that can be found in the \TP\UTILS directory.
5. NEW FEATURES
---------------
Turbo Pascal 6.0 offers many new features, including:
o Borland's new Integrated Developer's Environment (IDE), our new
generation user interface that includes all the features you're used
to, plus:
o Mouse support.
o Multiple overlapping windows.
o Multi-file editor that can edit files up to 1 mbyte in size.
o Cut, copy and paste using the Clipboard.
o Turbo online help system that has been expanded, with
copy-and-paste program examples for practically every function.
Includes full reference to Turbo Vision objects, methods,
variables and constants.
o Conditional breakpoints.
o CPU Register window.
o Makes full use of EMS to enhance performance and increase
capacity.
o Built-in customization for color and startup options.
o Turbo Vision, an object-oriented, high-performance application
framework and library. Programs written in Turbo Vision inherit
everything from mouse support, dialogs, menus, overlapping windows,
and automatic desktop management to the online help system,
calculator, and other tools that you'll find in the \TP\TVDEMOS
directory.
Programming with Turbo Vision is so efficient and powerful, we used
it to build the IDE itself!
o Built-in, inline assembler. Combine the best of both worlds: write
assembly language instructions inside your Turbo Pascal programs.
o Private fields and methods are now supported in an object
declaration. This enables you to "enforce" encapsulation. Object
privacy is implemented consistently with the existing data hiding
capabilities of a unit. See P-87 in the User's Guide and P-35 in the
Programmer's Guide for more information.
o Other enhancements include:
o New Objects unit with better collections and streams.
o New heap manager is faster and safer.
o Extended syntax compiler directive {$X} allows you to
optionally discard function results.
o New procedure directives: far, near and assembler.
o 80286 code generation directive {$G}.
o Minor code generation improvements.
o Address references in typed constant pointers.
o Link in initialized data from .OBJs {$L}.
6. TURBO VISION EXAMPLES
------------------------
There are three different kinds of Turbo Vision example programs
provided. You'll find all the example programs from the Turbo Vision
Guide in the \TP\DOCDEMOS directory. You'll find several Turbo Vision
application support units in the \TP\TVISION directory. And you'll
find several Turbo Vision demonstration programs in the \TP\TVDEMOS
directory.
If you're trying to run one of the Turbo Vision demos from inside the
IDE, we recommend that you set Compile|Destination to disk and the
Link Buffer option to Disk (in the Options|Linker dialog box). Many of
these examples are large programs and require full memory capacity to
compile and run. Depending on your system configuration, you may need
to compile and run them from DOS. Here's how to use the command-line
compiler on TVDEMO.PAS:
cd \tp\tvdemos
tpc /m tvdemos
Then run TVDEMO.PAS from DOS by typing:
tvdemo
In order to facilitate compiling these demos on a wide variety of
system configurations, we've turned off debug information {$D-} in all
Turbo Vision units. If you have a system with lots of memory and EMS,
you might want to enable the {$D} compiler directive in selected units
in \TP\TVDEMOS so you can step through the code.
7. IMPORTANT DOCUMENTATION INFORMATION
--------------------------------------
All source code examples from the Turbo Vision Guide and from the
User's Guide's chapter on object-oriented programming (chapter 4) can
be found in the \TP\DOCDEMOS directory.
8. Compatibility notes
-----------------------
Turbo Debugger and Turbo Pascal 6.0
--------------------------------------
You can use any version of Turbo Debugger with Turbo Pascal 6.0.
However, because of the changes to the heap manager, don't watch,
inspect or evaluate MemAvail or MaxAvail unless you're using Turbo
Debugger 2.01 or later.
Turbo Pascal 6.0 Heap Manager
-----------------------------
The new heap manager is faster and more efficient than in Turbo Pascal
5.x. FreeMin is no longer needed and you can simply delete all
references to it in your programs. FreePtr has been replaced. If
you're relying on implementation-dependent features of the old heap
manager, you'll have to modify your code to eliminate references to
FreePtr. (If you just need to compress the heap, you can call the
SetMemTop procedure from the Turbo Vision Memory unit.) See Chapter 16
in the Programmer's Guide for more information about how the new heap
manager works.
If you are using a HeapError function, make sure it exits quickly when
passed a Size value of 0:
function HeapError(Size: Word): Integer; far;
begin
if Size > 0 then
begin
{ ... perform HeapError processing here ... }
end;
end;
In version 6.0, HeapError is called with a value of 0 whenever an
allocation moves the HeapPtr upwards.
Turbo Pascal 6.0 and the Toolboxes
----------------------------------
The 4.0 toolboxes all work with Turbo Pascal 6.0. (The Turbo Editor
Toolbox needs 2 easy source code modifications to work with 6.0. See
the file HELPME!.DOC in \TP\DOC for more information.)
Turbo Pascal 5.5 Object Unit
----------------------------
All the demo units and programs from Turbo Pascal 5.5 will work with
version 6.0 if you recompile them. However, we recommend that you use
the new Object unit's streams and collections in any new programs you
write. Note that you cannot use the 5.5 Objects unit with Turbo
Vision.
9. Testing Expanded Memory: EMSTEST.COM
---------------------------------------
EMSTEST.COM is in the \TP\UTILS directory and can be used to test your
Expanded Memory (EMS) hardware and software. If you have problems
using Turbo Pascal with your EMS, type EMSTEST at the DOS prompt and
follow the instructions. (To disable the IDE's EMS usage, specify /X-
on the commandline when you load TURBO. To determine how much EMS the
IDE is using, load TURBO and select GET INFO on the FILE menu.)
10. Complete List of Files
--------------------------
The INSTALL program will place all of the following on your hard disk
during the installation process (the floppy installation installs only
TURBO.TPL and TURBO.EXE or TPC.EXE):
Install/Compiler
----------------
INSTALL.EXE - Installs Turbo Pascal on your system
README.COM - Program to display README file
UNZIP.EXE - De-archiving program
TURBO.ZIP - Archived file containing:
TURBO.EXE - Turbo Pascal Integrated Development Environment
TURBO.TPL - Resident units for Turbo Pascal
TURBO.TP - Configuration file for TURBO.EXE
TPC.EXE - Command-line version of Turbo Pascal
README - This file!
Turbo Vision/Tour
-----------------
TVISION.ZIP - Archived file containing Turbo Vision units:
APP.PAS - Application unit source
BUFFERS.PAS - Buffers unit source
COLORSEL.PAS - Color installation unit source
EDITORS.PAS - Editors unit source
MSGBOX.PAS - Message box unit source
STDDLG.PAS - Standard dialogs unit source
APP.TPU - Application unit
BUFFERS.TPU - Buffers unit
COLORSEL.TPU - Color installation unit
DIALOGS.TPU - Dialogs unit
DRIVERS.TPU - Drivers unit
EDITORS.TPU - Editors unit
HISTLIST.TPU - History list unit
MEMORY.TPU - Memory management unit
MENUS.TPU - Menus unit
MSGBOX.TPU - Messagebox unit
OBJECTS.TPU - Objects unit
STDDLG.TPU - Standard dialogs unit
TEXTVIEW.TPU - Simple text window unit
VIEWS.TPU - Views unit
TVDEMOS.ZIP - Archived file containing Turbo Vision demos:
TVDEMO.PAS - Turbo Vision demo application
DEMOHELP.HLP - Compiled help file for TVDEMO
ASCIITAB.PAS - ASCII table viewer
CALC.PAS - Desktop calculator
CALENDAR.PAS - Desktop calendar (monthly viewer)
DEMOHELP.PAS - Context file produced by running HC on DEMOHELP.TXT
FVIEWER.PAS - Text file viewer
GADGETS.PAS - Desktop gadgets (clock, heap viewer)
HELPFILE.PAS - Help system manager
MOUSEDLG.PAS - Mouse options dialog
PUZZLE.PAS - Simple brain teaser puzzle
DEMOCMDS.PAS - Command constants for TVDEMO.PAS
TVHC.PAS - Help text compiler
DEMOHELP.TXT - Help file source for TVDEMO.PAS
TVRDEMO.PAS - Resourced and overlaid version of TVDEMO.PAS
MKRDEMO.BAT - Builds TVRDEMO.EXE
GENRDEMO.PAS - Used by TVRDMAKE.BAT to build resources for TVRDEMO.PAS
TVEDIT.PAS - Application that demonstrates the EDITORS unit
TVFORMS.PAS - Form entry and edit application
FORMCMDS.PAS - Command constants
DATACOLL.PAS - Data record collection
LISTDLG.PAS - List dialog manager
FIELDS.PAS - Edit/entry fields
FORMS.PAS - Form dialog manager
PARTS.TVF - Sample data file
PHONENUM.TVF - Sample data file
GENFORMS.BAT - Generates sample data files for TVFORMS.PAS
GENFORM.PAS - Used by GENFORMS.BAT
GENPARTS.PAS - Used by GENFORMS.BAT
GENPHONE.PAS - Used by GENFORMS.BAT
FILEVIEW.PAS - Simple disk & file browser program
TVTXTDMO.PAS - Demonstrates TEXTVIEW unit
TVBGI.PAS - Demonstrates BGI support unit (GRAPHAPP)
GRAPHAPP.PAS - Support unit for swapping between Turbo Vision and BGI
INTRFACE.ZIP - Archived file containing the interface sections
of Turbo Vision and runtime library units
TURBO3.ZIP - Archived file containing TURBO3 and GRAPH3
compatibility units and interface documentation
TOUR.ZIP - Archived file containing the IDE Tour and its
overlay files.
Online Help
-----------
HELP.ZIP - Archived file containing:
TURBO.HLP - Online help data file
BGI/Utilities
-------------
BGI.ZIP - Archived file containing BGI driver and support
files:
GRAPH.TPU - Borland Graphics Interface (BGI) Graph unit
ATT.BGI - AT&T 6300 driver
CGA.BGI - CGA and MCGA driver
EGAVGA.BGI - EGA and VGA driver
HERC.BGI - Hercules mono driver
PC3270.BGI - 3270 PC driver
IBM8514.BGI - IBM 8514 driver
GOTH.CHR - Gothic font
LITT.CHR - Small font
SANS.CHR - Sans serif font
TRIP.CHR - Triplex font
BGIDEMO.PAS - Graph unit demo
ARTY.PAS - Graph unit demo
BGILINK.PAS - Graph unit demo
BGIDRIV.PAS - BGILINK.PAS demo unit
BGIFONT.PAS - BGILINK.PAS demo unit
BGILINK.MAK - BGILINK.PAS demo makefile
UTILS.ZIP
THELP.COM - TSR online help utility
TPUMOVER.EXE - Unit mover utility
TEMC.EXE - Turbo Editor Macro Compiler
MAKE.EXE - UNIX-style project management utility
GREP.COM - Text file search utility
TOUCH.COM - Changes a file's timestamp to force re-compilation
BINOBJ.EXE - Converts a binary data file to an .OBJ file
EMSTEST.COM - Expanded Memory (EMS) hardware/software diagnostic
utility
DOCDEMOS.ZIP - Archived file containing source code examples
from the User's Guide and Turbo Vision Guide.
TCALC.ZIP - Archived file contain the source code to the Turbo
Calc demo program
DEMOS.ZIP - Archived file contain numerous demo programs
ONLINE.ZIP - Archived file contain online documentation files:
HELPME!.DOC - Answers to commonly asked questions
FIXES.DOC - Corrections to the printed documentation
TVISION.DOC - Enhancements to Turbo Vision
BUFFERS.DOC - Documents the Turbo Vision buffers unit
EDITORS.DOC - Documents the Turbo Vision editors unit
TEMC.DOC - Turbo Editor Macro Compiler documentation
THELP.DOC - Turbo Help (TSR) documentation
UTILS.DOC - TPUMOVER, MAKE, GREP, TOUCH, BINOBJ documentation
----------------------------------------------------------------------