Programming Languages Suite

home *** CD-ROM | disk | FTP | other *** search

/ Programming Languages Suite / ProgLangD.iso / TURBOPASCAL WIN / README < prev next >

Wrap

Text File | 1992-06-07 | 16.2 KB | 416 lines

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. * * *