/****************************************************************/
                            INSTALL.TXT
       Borland C++ 5.0 and the Borland C++ 5.0 Development Suite
       ----------------------------------------------------------

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. Windows NT New Shell
D. CD Installation
E. Files Changed During Installation
F. Files Added at First Startup
G. Removing Registration Reminder

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.0, you must meet the 
following minimum system requirements:

* 16 MB RAM (24 recommended)
* 80486 processor or better
* Windows 95 or Windows NT 3.51
  (The new Microsoft shell for Windows NT, still under 
  development, is not supported.)
* 25 to 175 MB of free hard disk space (195 MB for the 
  Developer's Suite), subject to the options you choose 
  (installation options follow)

B. Minimum Installation
-----------------------
A minimum installation of Borland C++ 5.0 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.0 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 195 MB of hard disk space.

D. Other Installations
----------------------
The following information is provided to allow estimation.

Installation by parts:

	16-bit DOS: 
		 Command line tools:    10 MB
		 Visual tools:          24 MB
		 Libraries:             14 MB
		 Examples:               4 MB
		 Help:                   5 MB

	16-bit Windows:
		 Command line tools:    11 MB
		 Visual tools:          36 MB
		 Libraries:             37 MB
		 Examples:              40 MB
		 Help:                  46 MB

	32-bit Windows:
		 Command line tools:    12 MB
		 Visual tools:          35 MB
		 BDE:                   14 MB
		 Libraries:             38 MB
		 Examples:              40 MB
		 Help:                  45 MB

E. Installation Procedure
-------------------------
IMPORTANT!
Do not install Borland C++ 5.0 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.

To avoid potential conflicts when Setup installs system files, we recommend 
that you close down all other running applications before installing Borland C++.

If you previously installed Borland 4.5x, you may have
WinRun in your startup group.  If so, unload it before 
installing Borland C++ 5.0.

To install Borland C++ Release 5.0 from the CD:

Run \SETUP\BC5\SETUP.EXE.

To install the Borland C++ Development Suite from the CD:

Run \SETUP.EXE.

Following are the locations of all the SETUP programs provided:
PRODUCT                       LOCATION OF SETUP PROGRAM

Borland C++ 5.0
· Borland C++ 5.0              \SETUP\BC5
· 16-bit BDE SDK               \SETUP\BDE16
· 16-bit BDE Engine            \SETUP\IDAPI16  (redistributable install)
· 32-bit BDE Engine            \SETUP\IDAPI32  (redistributable install)
· 32-bit Database Desktop      \SETUP\DBD32
· 3rd party OCX controls       \SETUP\OCX      (for testing OCX support)
· MFC 3.2 Support              \SETUP\MFC32
· MFC 4.0 Support              \SETUP\MFC40
· Patch for Borland C++ 4.52   \PATCHES\BC452
· Patch for CodeGuard 4.5      \PATCHES\CG45

Borland C++ 5.0 Development Suite
· Master Setup Program         \SETUP.EXE
· CodeGuard                    \SETUP\CG5
· InstallShield Express        \SETUP\ISHIELD
· PVCS Version Control         \SETUP\PVCS
· Borland C++ Java Add-On      \SETUP\BCWJAVA


-----------------------------
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. Windows NT New Shell
-----------------------
The new shell under development for Windows NT is NOT 
supported by this release of the Borland C++ compiler for DOS, 
16-bit Windows, and 32-bit Windows.

D. 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). 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.

E. 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 loaded 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 loaded 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

F. Files Added at First Startup
-------------------------------
Borland C++ creates SPX, SPP, and various configuration 
files in the SCRIPT and BIN directories upon first startup:

debug.spx 
default.spp
default.spx 
edit.spx
ed_dflt.spx 
*.CFG, *.BCW, *.DSW, *.MBT, *.MRT

SPX files are compiled versions of cScript files.  
The other runtime files store project and desktop settings 
and other configuration information.  


G. 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\Windows NT\CurrentVersion\Windows.  Edit the value 
named "load." 


---------------------------------------------
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 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. 
 
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 3.51 [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.

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.

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

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 reason to do this manually.) The 
following is a list of changes made to the registry when 
Borland C++ 5.0 is installed.

A. Key Names and Values
-----------------------
Key Name: SOFTWARE\Borland\Borland C++\5.00
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 Configuration Path
	Data:	c:\BC5\BIN

Value 7
	Name:	OCF Source Path
	Data:	c:\BC5\SOURCE\OCF

Value 8
	Name:	OWL Source Path
	Data:	c:\BC5\SOURCE\OWL

Value 9
	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.)

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
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/minute, first minute free)
DOS: 
	1-800-368-3366 (charged to a credit card)
	1-900-555-1004 (charged to phone bill)

Windows:
	1-800-782-5558 (charged to a credit card)
	1-900-555-1002 (charged to phone bill)
		
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/TechInfo/
		
	C++ Information Page
	http://www.borland.com/TechInfo/cpp
		
	Bug Submission/Publication Page
	http://loki.borland.com/bugs/

	Patches Available Page
	http://loki.borland.com/cpp/patchs.htm

	CompuServe: 
	GO BORLAND to reach all Borland pages
	GO BCPP for Language and Tools issues
	GO BCPPLIB for library-specific issues


/**************************END OF FILE****************************/
