/****************************************************************/

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 <version #> [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 <name of .pak file>."
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 <name of 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 <name of 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?)
<name of file>."
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
<name of file>."
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: <no class>
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****************************/