/****************************************************************/ INSTALL.TXT Borland C++ 5.02 --------------------------------------------------------- To jump to a specific section, search for "SECTION #", replacing the # with the appropriate section number. -------- CONTENTS -------- SECTION 0 System Requirements A. Minimum System Requirements B. Minimum Installation C. Full Installation D. Other Installations E. Installation Procedure SECTION 1. Installation Notes A. Hard Drive Installation B. Microsoft PLUS! (tm) Issues C. CD Installation D. Files Changed During Installation E. Files Added at First Startup F. Removing Registration Reminder G. Files Available on the CD H. Installation of Help Files SECTION 2. Changing Your System Configuration A. "Clean Boot" under Windows 95 B. "Clean Boot" under Windows NT SECTION 3. Troubleshooting Installation Error Messages A. Startup Error Messages B. Decompression Error Messages SECTION 4. Registry Changes A. Key Names and Values B. File Extension Associations SECTION 5. Other Ways to Get Help A. How to Get Good Phone Support B. Relevant Telephone Numbers C. Online Services ----------------------------- SECTION 0 System Requirements ----------------------------- A. Minimum System Requirements ------------------------------ To install and run Borland C++ 5.02, you must meet the following minimum system requirements: * 16 MB RAM (24 recommended) * 80486 processor or better * Windows 95, Windows NT 3.51 or 4.0 * 25 to 230 MB of free hard disk space (250 MB for the Developer's Suite and 260 MB for the Design Tools), subject to the options you choose (installation options follow) B. Minimum Installation ----------------------- A minimum installation of Borland C++ 5.02 includes only the command line tools (no IDE), and provides the ability to work within another editor and use the command line compiler. This setup requires approximately 25 MB of hard disk space with 16-bit DOS support. C. Full Installation -------------------- A full installation of Borland C++ 5.02 includes all the tools available, the Windows-hosted IDE, and allows development for 16-bit DOS, 16-bit Windows, and 32-bit Windows. This is called the "Typical" install by the installation program, and requires 230 MB of hard disk space. Note: The exact amount of disk space required for installation may vary due to disk cluster size on your PC. D. Other Installations ---------------------- The following information is provided to allow estimation. Installation by parts: 16-bit DOS: Command line tools: 10 MB Visual tools: 40 MB Libraries: 23 MB Examples: 5 MB Help: 8 MB 16-bit Windows: Command line tools: 10 MB Visual tools: 41 MB Libraries: 64 MB Examples: 65 MB Help: 40 MB 32-bit Windows: Command line tools: 12 MB Visual tools: 41 MB BDE: 7 MB Libraries: 90 MB Examples: 69 MB Help: 47 MB E. Installation Procedure ------------------------- IMPORTANT! Do not install Borland C++ 5.02 over previously installed Borland C++ directories. The files in this distribution will not work with previously shipped tools and libraries. This is particularly true for configuration files from previous shipping releases, like TDCONFIG.TDW and BCCONFIG.BCW. We recommend that you do not install Borland C++ to a path that contains spaces or long filenames because some 16-bit components do not support long filenames. To avoid potential conflicts when Setup installs system files, we recommend that you close down all other running applications before installing Borland C++. To update from Version 4.5 or earlier, you need to delete the old version of Borland C++ from your system before installing Version 5.02. You also need to delete all references to outdated Help files from your WINHELP.INI file in your WINDOWS directory. Also, if you have WinRun in your startup group, unload it before installing Borland C++ Version 5.02. To update from Version 5.0, copy the latest uninstall program, BC5RMV.EXE, from the CD located in the \WINNT or \WIN95 directory to your current WINDOWS directory. Then uninstall Borland C++ 5.0 before installing Borland C++ 5.02. To install Borland C++ 5.02 from the CD, run \SETUP\BC5\SETUP.EXE. ----------------------------- SECTION 1. Installation Notes ----------------------------- A. Hard Drive Installation -------------------------- Installing from a CD-ROM may cause synchronization difficulties between various pieces of hardware or certain hardware drivers. If you suspect that your CD-ROM drive or your CD-ROM driver might be at fault, you can attempt a hard drive installation. To begin, copy the entire setup directory into a temporary directory on your C:\ drive. The setup directory contains all the files needed for the installation. Once these have been successfully copied, remove the CD-ROM driver from your system configuration by clean-booting, and attempt to install the product. When running the install, remember to change the SOURCE directory so that it points to the temporary directory. B. Microsoft PLUS! (tm) Issues ------------------------- Under Windows 95 with the PLUS! Pack (tm) installed, some floating-point errors may occur. This has been traced to a problem in SAGE.DLL, a part of System Agent. If this problem occurs, turn OFF System Agent and download Plusupd1.exe from: * Microsoft Network (under mssupport), * CompuServe (GO MSL), or * Microsoft's anonymous FTP server (ftp.microsoft.com, Softlib/Mslfiles directory). Run Plusupd1.exe and follow the instructions on the screen. C. CD Installation ----------------- If you choose the CD installation option or the Custom CD Installation option, you will not be able to install any of the additional products available (such as CodeGuard, PVCS, InstallShield, or the Java addon). This is because a CD installation leaves the majority of the product in write-protected files on the CD-ROM, rather than on the hard drive. These write-protected files need to be modified to install any of the additional software. D. Files Changed During Installation ------------------------------------ The following files are changed during installation: 1. WIN.INI (under Windows 95) REMIND.EXE is added to the LOAD line of the WIN.INI file: load=C:\BC5\PIPELINE\REMIND.EXE (where C:\BC5 is where you installed BC5) OR Registry key (under Windows NT): \\HKEY_CURRENT_USER\SOFTWARE\MICROSOFT\WINDOWS NT \CurrentVersion\Windows 2. SYSTEM.INI A change is made to the [386Enh] section: [386Enh] device=C:\BC5\BIN\TDDEBUG.386 (where C:\BC5 is where you installed BC5) 3. WINHELP.INI Lists all of the Help files that were installed. 4. OWL.INI is installed. 5. The following files are created if they are not on the system or modify them if they already exist: TD.INI WORKSHOP.INI BCW5.INI TDW.INI E. Files Added at First Startup of the Borland C++ IDE ------------------------------------------------------ Borland C++ creates SPX, SPP, and various configuration files in the SCRIPT and BIN directories upon first startup: default.spp bcwdef.* *.SPX, *.CFG, *.BCW, *.DSW, *.MBT, *.MRT SPX files are compiled versions of cScript files. SPP files are uncompiled cScript source files. The other run-time files store project and desktop settings and other configuration information. Deleting these files does no harm to your system and may help with troubleshooting IDE configuration problems. F. Removing Registration Reminder --------------------------------- If you run the online registration module during Setup and then cancel without completing registration, the module adds an EXE to your system startup files. After 14 days, the EXE reminds you to register. Windows 95 users can remove the reminder by editing WIN.INI to delete REMIND.EXE from the load= line. Windows NT users should edit both WIN.INI and the system registry. Launch REGEDT32.EXE. Choose the HKEY_CURRENT_USER window. Browse to this key: Software\Microsoft\Windows NT\CurrentVersion\Windows. Edit the value named "load." G. Files Available on the CD ---------------------------- Many files are available on your BC5 CD which are not installed on your machine's hard drive to save space. Here is a list of the kinds of files that you can find: Example EXE files, and support files In \bc5\examples subdirectories CodeGuard versions of libraries In \bc5\lib\cg Debug versions of libraries In \bc5\lib (OWLD*, BIDSD*, OCFD*) Runtime library source In \bc5\source\rtl RTL startup code In \bc5\lib\startup MFC library source In \bc5\source\mfc H. Installation of Help Files ----------------------------- If you do install Borland C++ 5.02 over an existing 5.0 installation, you must delete all of the hidden .GID files in the BC5\HELP directory before using the online Help system again. Otherwise, you will see a gray dialog with an OK and Cancel button and no error message when you try to use Help. If you uninstall Borland C++ 5.0, then install 5.02 to a different directory, you must manually delete all entries in the WINHELP.INI file in the WINDOWS directory that refer to the old BC5\HELP directory. Otherwise, the effect is the same as above. --------------------------------------------- SECTION 2. Changing Your System Configuration --------------------------------------------- Although Windows 95 and Windows NT are much more stable than Windows 3.1, it is still recommended that you change the configuration of your system if you encounter problems when installing new software. Each operating system has its own method, as follows. A. "Clean Boot" under Windows 95 -------------------------------- Under Windows 95, the method of obtaining a "clean boot" is through the use of Safe Mode, a boot option provided by Microsoft to aid Windows 95 users. 1. Shut down the machine and reboot it. 2. Before the Windows 95 splash screen appears, press and hold down F8. 3. Select Safe Mode from the menu and press Enter. You are now running under Windows 95 Safe Mode. Windows 95 will inform you that you are running in a special diagnostic mode with a window. Click 'OK' and you will be able to continue your work. Note: Windows 95 will not recognize most CD-ROM drives in Safe Mode. If this is the case for your machine, you'll need to copy the files from the SETUP directory and the Setup.exe on the CD onto your hard drive and install from there. B. "Clean Boot" under Windows NT -------------------------------- To perform a "clean boot" on an NT machine: 1. Shut down the machine and reboot it. 2. When the OS choice menu appears, select number 2, Windows NT Workstation [VGA mode]. Windows NT will then boot itself in a clean mode. ------------------------------------------------------ SECTION 3. Troubleshooting Installation Error Messages ------------------------------------------------------ A. Startup Error Messages ------------------------- 1. "Unable to open install configuration file." Problem: SETUP.CFG is not present in the same directory as SETUP.EXE. Solution: Move SETUP.CFG to the directory that SETUP.EXE is in. 2. "Corrupt install configuration file. Click OK to exit." Problem: SETUP.CFG does not have the correct format. Solution: The configuration file for the setup is corrupt. Contact the disk replacement phone number listed at the end of this document to obtain a new disk. 3. "Unable to load string resource (#)." Problem: A string resource needed by the installation program cannot be found. Solution: If this error occurs, contact the installation support line number listed at the end of this document. 4. "Cannot execute SETUP.EXE (or one of its components). Check to ensure that all required components (INSTXTRA.PAK) are available." Problem: The installation program cannot execute all or part of the SETUP. Solution: Make sure INSTXTRA.PAK is located in the same subdirectory as SETUP.EXE. 5. "Cannot execute SETUP.EXE (or one of its components). Check to ensure that all required components (SETUP.CFG) are available." Problem: The installation program cannot execute all or part of the SETUP. Solution: Make sure SETUP.CFG is located in the same subdirectory as SETUP.EXE and is getting copied to the TEMP directory correctly. 6. "Internal Error: -69. Unable to start installation." Problem: Unable to start main installation component. This occurs when Windows fails to launch instrun.exe. This could be because: * The system is out of memory or resources. * The specified file (instrun.exe, in this case) was not found. * The specified path (usually %TEMP%) was not found. * The .exe file is invalid (non-Win32 .exe or an error in the .exe image). Solution: Ensure that all of the above conditions have been met. 7. "Unable to locate USER.DLL." or "Unable to locate comctl32.dll" Problem: You are trying to install Borland C++ 5.02 under a 16-bit version of Windows (Windows 3.x). Solution: Do NOT install this product under a 16 bit version of Windows. This product will not install or run under 16 bit Windows. You MUST install this product under a 32-bit version of Windows, such as Windows 95 or Windows NT 4.0. B. Decompression Error Messages ------------------------------- 1. "Error during unpacking ." Problem (possibilities): * The .pak file referenced in the error message contains one or more files that already exist on the system. These files are most likely write protected, or the directory they reside in is write protected, or the files are in use by a currently running program. * The .pak file is corrupted on the CD or diskette. * The installation engine is having difficulty with the synchronization of the CD drive and the rest of the machine. Solutions: * Remove the write protection and then try continuing with the installation. * Check the CD or diskette for any bad sectors, and call the disk replacement phone number listed at the end of this document if necessary. * Attempt a hard drive installation as specified in SECTION 1. Installation Notes. * Close applications running in the background. * Move the file(s) contained in that .pak file out of the directory they are currently resident in and into another, temporary directory. 2. "Archive file contains a file that cannot be unpacked." Problem: The installation engine cannot unpack one of the files contained within the .pak file referenced in the error message. Solutions: * Check the disk for bad sectors and call the disk replacement phone number listed at the end of this document. * Call the installation support number listed at the end of this document for information about attempting a manual installation of Borland C++ 5.02. 3. "Archive file is corrupted and cannot be unpacked." Problem: The .pak file is either corrupted on the CD or it is getting corrupted in the copying process. Solutions: * Check the CD to ensure that the .pak file there is not corrupted. If the CD has a bad sector or track, call the disk replacement phone number provided at the end of this document. * If the CD is not damaged, attempt a hard drive installation or attempt to slow the machine down if it is encountering speed synchronization problems with the hardware. 4. "Unable to write to destination file (disk full?) ." Problem: The hard disk already contains a write-protected copy of the file. Solution: Remove the write protection and continue with the install. 5. "386 or better required to expand archive ." Problem: Your microprocessor is running too fast. Solution: Try slowing down your system by taking your machine out of turbo mode and disabling any software that speeds your machine up, such as SmartDrive. If necessary, you can also disable BIOS caching and shadow RAM. --------------------------- SECTION 4. Registry Changes --------------------------- The registry under Windows 95 and Windows NT is the file where information concerning all software added to the system is logged and kept for reference. You can access the registry by using the registry editor (regedit or regedt32 under Windows NT) to view and change the registry if necessary. (There is almost never a reason to do this manually.) The following is a list of changes made to the registry when Borland C++ 5.02 is installed. A. Key Names and Values ----------------------- Key Name: SOFTWARE\Borland\Borland C++\5.0 Class Name: Value 0 Name: BCRoot Path Data: c:\BC5 Value 1 Name: BGI Path Data: c:\BC5\BGI Value 2 Name: Class Library Source Path Data: c:\BC5\SOURCE\CLASSLIB Value 3 Name: Examples Path Data: c:\BC5\EXAMPLES Value 4 Name: Include Path Data: c:\BC5\INCLUDE Value 5 Name: Lib Path Data: c:\BC5\LIB Value 6 Name: Local BCRoot Path Data: c:\BC5\BIN Value 7 Name: Local Configuration Path Data: c:\BC5\BIN Value 8 Name: Local Help Path Data: c:\BC5\HELP Value 9 Name: OCF Source Path Data: c:\BC5\SOURCE\OCF Value 10 Name: OWL Source Path Data: c:\BC5\SOURCE\OWL Value 11 Name: VDBT Source Path Data: c:\BC5\SOURCE\VDBT This assumes that you installed to your c:\ drive. If you installed to a different drive, then change the drive letter accordingly. Values 6 and 8 are only created when a CD Only installation or a Network installation (by an End User as opposed to an Administrator) is performed. B. File Extension Associations ------------------------------ These are the file extension associations kept in the registry under HKEY_CLASSES_ROOT: HKEY_CLASSES_ROOT\.c = "cfile" \.cpp = "cppfile" \.h = "CHeaderFile" \.hpp = "CHeaderFile" \.ide = "idefile" \.rc = "rcfile" \.res = "resfile" \.spp = "sppfile" HKEY_USERS \.Default\.Default\Software\Borland\Borland C++\5.0 HKEY_CURRENT_USER Software\Borland\Borland C++\5.0 Software\Microsoft\Windows\Help .Default\Software\Borland\Borland C++\5.0 HKEY_LOCAL_MACHINE Software\Borland\Borland C++\5.0 Software\Borland\Database Engine Software\Borland\BLW32 Under Windows NT 4.0 Software\Microsoft\Windows\CurrentVersion\App Paths\BCW.EXE Under Windows NT 3.51 Software\Microsoft\Windows NT\CurrentVersion\App Paths\BCW.EXE Under Windows 95 Software\Microsoft\Windows\CurrentVersion\App Paths\BCW.EXE --------------------------------- SECTION 5. Other Ways to Get Help --------------------------------- A. How to Get Good Phone Support -------------------------------- * Be prepared to go through the Borland phone tree. * Have your name, PIN #, product, and version number ready. This will speed the pace of your call. * Be sure to have read all the relevant documentation. Often you can avoid a long-distance or toll call by searching through the documentation. * Be prepared to describe in detail exactly what you have done so far while working on the problem. * If you've already talked to an engineer, be able to describe what you did while working with that engineer. * Please be patient. We try to answer all customer questions as thoroughly as possible. B. Relevant Telephone Numbers ----------------------------- Main Switchboard (408) 431-1000 C++ Installation Support (408) 461-9133 C++ Advisor Lines ($2.95/minute, first minute free) DOS: 1-800-368-3366 (charged to a credit card) Windows: 1-800-782-5558 (charged to a credit card) TECHFAX line for receiving technical information documents: 1-800-822-4269 Product Order Desk 1-800-331-0877 Customer Service and Disk Replacement (510) 354-3828 Telephone Product Registration 1-800-845-0147 C. Online services ------------------ You can find support and information online at the following locations: INTERNET: Download FTP Site ftp.borland.com Download Bulletin Board System (408) 431-5096 World Wide Web: Borland Home Page http://www.borland.com/ Technical Information Page http://www.borland.com/techsupport/borlandcpp C++ Information Page Search Page http://www.borland.com/techsupport/borlandcpp/search.html Bug Submission/Publication Page http://www.borland.com/bugs/ Patches Available Page http://www.borland.com/techsupport/borlandcpp/patchs.html CompuServe: GO BORLAND to reach all Borland pages GO BCPP for Language and Tools issues GO BCPPLIB for library-specific issues /**************************END OF FILE****************************/