home *** CD-ROM | disk | FTP | other *** search
-
- Welcome to Turbo Pascal for Windows
- -----------------------------------
-
- This README file contains important, last minute information
- about Turbo Pascal for Windows. There are three ways to program
- Windows using Turbo Pascal:
-
- 1) By simply using the WinCrt unit, you can write "standard"
- Pascal programs that do Readln, Writeln in a scrollable
- window. For more information about the WinCrt unit, refer to
- Chapter 14 in the Programmer's Guide (and see WELCOME.PAS in
- the \TPW directory).
-
- 2) You can write Windows applications the "traditional" way.
- For examples of this style of Windows programming, see
- GENERIC.PAS and FDLGDEMO.PAS in the \TPW\WINDEMOS directory.
-
- 3) The best way to write full-featured Windows applications is
- by using the ObjectWindows application framework.
- ObjectWindows uses object-oriented techniques to make
- Windows programming much easier and more efficient.
- ObjectWindows is described in detail in both the Windows
- Programmer's Guide and Windows Reference Guide. See
- HELLOAPP.PAS and the many other ObjectWindows demo programs
- in the \TPW\OWLDEMOS directory.
-
- In addition to the release notes in this file, there are several
- text files in the \TPW\DOC directory that you should browse. Make
- sure you look at the MANUAL.TPW and MANUAL.TDW files which
- provide corrections to the printed documentation.
-
- A complete list of all files is provided in the 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
-
-
- 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 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. 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. 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
- ---------------
- 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 for you, 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 and in FILELIST.DOC 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 the 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 also can 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.
-
- After installation, make sure you add the Turbo Pascal for Windows
- directories (e.g. C:\TPW;C:\TPW\UTILS) in your DOS path.
-
-
- 3. SYSTEM REQUIREMENTS
- ----------------------
- Turbo Pascal for Windows requires at least 2 Mbytes of RAM and
- runs on EGA, VGA and Hercules monochrome video adapters. Note
- that dual monitors are required in order to debug your program in
- SVGA mode.
-
-
- 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. If it's in
- Turbo Pascal for Windows, it's in the help system! TDW has its
- own help system and help file as well.
-
- 5. FEATURES
- -----------
- Turbo Pascal for Windows has many features including:
-
- 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 objected-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 WRT - Interactively build and edit Windows' resources with
- the Whitewater Resource Toolkit. Create and edit icons,
- cursors, dialogs, menus, accelerators, bitmaps and strings.
-
- o TDW - A special version of the Turbo Debugger that debugs
- Windows 3.0 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 MANUAL.TDW in the \TPW\DOC directory for information about
- the various utilities that come with TDW.
-
- o Help system compiler - Use the help compiler to create
- Windows' online help for your programs. The help compiler
- (HC.EXE) 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. See
- \TPW\OWLDEMOS\BITBTN.PAS).
-
- 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
- ----------------
-
- 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\OWLDEMO\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.
-
- WRT Release Notes
- -----------------
- o If your system has plenty of memory (3 MBytes or more), you
- can speed up the WRT by inserting the following 3 lines in
- your WIN.INI file:
-
- [WRT]
- Static = 250
- Dynamic = 100
-
- This increases the memory available to the WRT and speeds up
- its editing operations.
-
- o Include file support - The WRT allows you to create include
- files that contain Pascal constant definitions. These files
- can be included in your TPW programs using the {$I Filename}
- directive. Note that these files can contain ONLY a const
- clause and constant declarations. No other language
- constructs, including comments, are allowed. The WRT can read
- and write these files from within the Header editor.
-
- o The WRT can edit resources, even if they're already bound into
- an .EXE file. Note that in this case, however, any TDW debug
- information already bound into the .EXE will be removed.
-
-
- Help Compiler Release Notes
- ---------------------------
- o TPW provides the Windows help compiler, HC.EXE, in the
- \TPW\UTILS directory. A complete help example, HELPEX.PAS is
- located in \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.EXE), 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. See the printed documentation on the
- help compiler for more information about HC.EXE and
- HELPEX.PAS.
-
-
- 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.
-
-
- 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 more information.
-
- * * *