home *** CD-ROM | disk | FTP | other *** search
- INSTALL.TXT
- ===========
-
- To jump to a specific section, search for "SECTION -#-",
- replacing the # with the appropriate section number.
-
- CONTENTS
-
- SECTION 0. System Requirements
- A. Minimum Install
- B. Full Install
- C. Hard Drive Requirements
-
- SECTION 1. Installation note
- A. Installing under Windows NT
- B. Installing under Windows 95
- C. Installing under OS/2
- D. Installing under Windows 3.1
- or Windows for Workgroups
- E. Files changed between 4.51 and 4.52
-
- SECTION 2. Common issues
- A. Installing over previous versions
- B. Installing onto a network
- C. Installing from a CD
- D. Hard Drive install
- E. Problems installing Win32S
-
- SECTION 3. Troubleshooting installation problems
- A. Internal error, unable to start install
- B. Data integrity or bad sector on disk errors
- C. Install program terminates prematurely
- D. "Unable to write to destination file"
- E. "386 or Greater Required"
-
- SECTION 4. Common error messages
- A. "General Protection Fault in COMPOBJ"
- B. "BWCC 2.0 or Greater Required"
-
- SECTION 5. Changes to system configuration
-
- SECTION 6. How to get help
-
-
- SECTION -0- SYSTEM REQUIREMENTS
- ===============================
-
- Prior to installing Borland C++ 4.52, please review the
- minimum requirements listed below.
-
- A) Minimum requirements
-
- A minimum installation of Borland C++ would include
- command line tools (no IDE) and would provide the ability
- to create DOS and Windows16 applications. To run this
- version of the compiler, you need to meet the following
- hardware and software requirements:
-
- 4 MB Extended Memory (5 MB total RAM)
- 386 or greater microprocessor
- DOS 4.01 or later
- Windows 3.1 or later
-
- While it is possible to *run* the command line tools on
- a machine which does not have Windows installed, it is not
- possible to install onto such a machine, as the installation
- utility requires Windows.
-
- B) Complete Installation
-
- A full installation of Borland C++, including both the
- 16 and 32-bit compilers, requires the following, in addition
- to the requirements listed above:
-
- 8 MB Extended Memory (9 MB total RAM)
- VGA-capable display
- Win32s or 32-bit windows
- (Win32s is included with Borland C++ 4.52)
-
- C) Hard Disk requirements
-
- Below are listed the _minimum_ hard drive space for
- particular configurations of the compiler. The amounts
- required may vary with different cluster sizes. In
- addition, on a compressed hard drive, the installation
- utility may need additional space for temporary
- decompression of files. The amount needed depends on how
- the installation is affected by the overall compression
- ratio.
-
- All of the configurations except the "Full" and "CDROM"
- configurations can only be set up by doing a custom
- installation.
-
- CD-ROM installation (tools run from CD): 25mb
- DOS command-line configuration (DOS only): 25mb
- 16-bit Windows configuration (includes IDE): 75mb
- 32-bit Windows configuration (Win32 only): 75mb
- Full installation: 100mb
-
- SECTION -1- INSTALLATION NOTES
- ==============================
-
- A) Installing under Windows NT
-
- Borland Technical Support is not aware of any major
- problems installing under Windows NT. Nevertheless, there
- are some issues that users of our software should be aware
- of.
-
- 1. To run 16-bit protected mode programs (bcc, tlink)
- under an NT command prompt, you need to add the following
- line to your CONFIG.NT:
-
- ntcmdprompt
-
- Under the default NT command-line prompt, COMMAND.COM is
- run after returning from a TSR. Adding the above will
- cause the original CMD.EXE to be run.
-
- 2. Borland C++ 4.52 does not install OLE2 support under a
- 32-bit version of Windows because OLE support is built in
- to those products. If you are producing and
- redistributing 16-bit OLE applications, you need to
- include the redistributable OLE2 files off of the
- original installation diskettes. These files can be
- created by unpacking the file OLE2RDST.PAK.
-
- 3. If you encounter difficulty when installing under NT, it may
- be for reasons similar to those which require a "clean boot"
- under 16-bit Windows. However, not all steps described in this
- document's section on booting clean will be appropriate for
- Windows NT. Under NT, determination of whether the autoexec.bat
- file is parsed is based on a registration key setting. Run
- regedt32.exe, go to the "Current User" window, and select
- Software|Microsoft|NT|Current Version|Winlogon.
- If the ParseAutoexec key is 1, NT will use your autoexec.bat file;
- if it is set to 0, it will not.
-
- 4. To allow for proper execution of OLE applications that use
- .DLLs in the BC45\BIN directory, you need to update the
- system path. To modify the system path, you must have
- Administrator privileges, or log in as the Administrator.
-
- To update the system path, double click on the Control
- Panel icon, then double-click on the System icon.
- In the "System Environment Variable" box, select the
- "Path=" statement. Then, in the value box, add the
- path to the Borland C++ 4.52 bin directory. By default,
- this directory is "C:\BC45\BIN". Next, choose "Set,"
- and then choose "OK."
-
- 5. The install will fail if you enter any paths which make use
- of long file names (more than 8 letters in the name,
- more than 3 letters in the extension, or a total path name
- which exceeds 128 characters).
-
- B) Installing under Windows 95.
-
- Borland Technical Support is not aware of any difficulties
- with installing Borland C++ under Windows 95. Should
- unforeseen problems arise, the information in the Windows
- NT and Windows 3.1 sections may contain useful information.
- If you are having difficulty installing under Windows 95,
- please contact Macmillan Computer Publishing at (317) 581-3833.
-
- C) Installing under OS2.
-
- Borland C++ 4.52 for Windows is not designed to be run
- under OS2. It is, however, possible to install and run
- under OS2 if your version of OS2 includes WinOS2 support.
- The following are some known issues regarding installing
- and running Borland C++ 4.52 under OS2:
-
- 1. Borland C++ 4.52, its Windows utilities, and the
- installation program should be run in a Full Screen
- WinOS/2 session, and may be unstable in a WinOS/2
- window. WinOS/2 must also be run in enhanced mode.
-
- 2. If you run the installation program from a full screen
- session, focus will switch to the OS2 desktop near the
- end of the installation while a DOS program is run. After
- the DOS program exits, focus will not switch back to
- the WinOS/2 session. You must switch focus manually.
-
- 3. WINRUN.EXE will be installed in your Startup group.
- Because OS/2 does not provide support for Windows VxDs,
- WINRUN.EXE will issue an error message and fail to load.
- Simply remove it from the startup group to prevent
- future error messages.
-
- 4. The protected mode "make" command line tool will not work
- under OS/2 because OS/2 does not provide uncommitted DPMI
- support. You need to use maker (the real mode "make")
- instead.
-
- 5. The Turbo Debugger for DOS will return an "unexpected
- DOS error: 23".
-
- D) Installing Under Windows 3.1 or Windows for Workgroups
-
- Our installation program performs a complicated series
- of actions including large amounts of file copying,
- decompression of files, and joining together pieces of
- split files. As a result of this, it is extremely sensitive
- to device drivers or resident programs which may interfere
- with operation.
-
- In order to guarantee that installation proceeds
- smoothly under 16-bit Windows, we recommend that you
- perform a "clean boot" prior to installing. In order to
- perform a clean boot, do the following:
-
- 1. Backup your win.ini, system.ini, autoexec.bat, and config.sys.
-
- 2. Edit your config.sys so that it consists of only the following
- lines: (insert any "required drivers" that are needed for
- reading a CD-rom or for network connections, at the end of
- the file. Examples of drivers which are _not_ required are
- EMM386.EXE, QDMI.SYS, and SMARTDRV.EXE. If you are unsure
- whether a device driver is required, assume it is not.)
-
- device=c:\windows\himem.sys
- files=40
- buffers=30
- stacks=9,256
- <insert required drivers here>.
-
- 3. Edit your autoexec.bat so that it consists only of the
- following lines:
-
- path=c:\;c:\dos;c:\windows
- prompt $p$g
- <insert required drivers here>
-
- 4. Edit your system.ini so that the line which starts with
- "shell=" says "shell=progman.exe". This will ensure that
- you load program manager and not a program manager
- replacement (such as Dashboard).
-
- 5. Edit your win.ini so that all lines which start with "load="
- or "run=" have a space after the equals sign.
-
- 6. Be sure to restore the original files after installation.
-
-
- If you are running a high resolution video driver on a high
- resolution video card, it is recommended that you switch
- display drivers so that you are using the standard VGA or
- SVGA display drivers.
-
-
- E) Files changed between 4.51 and 4.52
-
- The primary purpose of 4.52 is to provide you with the
- final Win32 API header files for Windows 95 programming.
- In addition, BC 4.52 also provides small enhancements to
- the VBX emulator. The following files have been changed
- or added since 4.51:
-
- Many header files in the \bc45\include tree.
-
- These three import libraries in the bc45\lib:
-
- import.lib
- import32.lib
- msextra.lib
-
- The OWL libraries differ from 2.50 because the new
- Win32 headers have added fields to some structures.
-
- These OWL headers have been updated to work with
- the new Windows 95 headers:
-
- \include\owl\dc.h
- \include\osl\defs.h
- \include\osl\ustring.h
- \include\ocf\oleutil.h
- \source\ocf\bocole\bole.h
-
- These VBX-related files:
-
- \windows\system\bivbx*.*
- \lib\bivbx*.lib
- \include\bivbx.h
- \bin\vbxgen.exe
-
- The compiler, linker, and IDE are marked as version
- 4.52, but they have not changed since version 4.51.
-
-
- SECTION -2- COMMON ISSUES
- =========================
-
- A) Installing over previous versions of Borland C++.
-
- As a general rule, it is not recommended that you install
- Borland C++ 4.52 over any version earlier than 4.51.
- It is recommended that you delete the Borland C++ directory
- tree (BORLANDC if you have Borland C++ 3.1, BC4 if you have
- Borland C++ 4.0, or BC45 if you have Borland C++ 4.5) prior
- to installing. In addition, you will need to delete the
- following files in the Windows directory (WINNT under NT, WIN95
- under Windows 95): owl.ini, bcw.ini, borhelp.ini,
- openhelp.ini, winsight.ini, workshop.ini.
-
- If you are installing over Borland C++ 4.0 or greater,
- you need to backup the RTL BIDS and OWL .DLLs prior to
- deleting the directory tree. Otherwise, any applications which
- need to link these libraries at runtime will need to be rebuilt.
-
- If you are installing over a previous installation of
- Borland C++ 4.51 or 4.52, you need to delete the Group file
- for Borland C++ (Under Windows 3.1, this is
- WINDOWS\BC45.GRP). The installation program cannot
- properly create this file if it already exists on your
- machine.
-
- If you have the DOS Powerpack installed and install Borland C++
- 4.52, you will need to reinstall the Powerpack after installing
- Borland C++ 4.52.
-
- If you have CodeGuard for Borland C++ and install Borland
- C++ 4.52 over it, you will need to reinstall CodeGuard
- afterwards.
-
-
- If you will be using OWL 1.0 or Turbo Vision 1.0, you must
- keep the source code on your machine so that they can be
- rebuilt with Borland C++ 4.52. You can do this by removing
- the previous version of Borland C++ from your PATH
- statement and *not* deleting the directory tree.
-
- For further information with issues relating to upgrading,
- please consult the document BC45\DOC\COMPAT.TXT.
-
- B) Installing onto a Network
-
- Borland C++ 4.52 is not intended to be run over a network, but it
- is possible to do so.
-
- If you are installing Borland C++ onto a network, please be aware of
- the following issues:
-
- 1. Be sure to install Borland C++ with the LAN workplace option
- on. This will insure that the files which are normally placed
- in the windows system directory will be placed in a
- subdirectory of BC45, from which they can be installed to the
- system directory by a network administrator, or copied to
- windows system directories on the local machines.
-
- 2. The compiler _must_ be run once by a system administrator prior
- to its use by users. This will create some configuration files.
- In order to prevent corruption of these files by multiple users,
- they should be copied into directories on the users' hard drives
- and then deleted from the bc45\bin directory. These local
- directories should be placed in the search path before the bc45\bin
- directory, and the bc45\bin directory should be made read-only.
- The files in question are: *.bcw, *.dsk, *.dsw, and bcconfig.*.
-
- 3. The compiler will attempt to save a file before compiling it.
- If the example directories are on the network and are set to be
- read-only, this will result in error messages when compiling
- the examples. Set the example directories to be public-writable, or
- have users copy the examples they wish to use onto their hard
- drives.
-
- C) CD-only installations
-
- The "CD only" install option is not supported in this version
- of Borland C++.
-
- D) Hard Drive installation
-
- If you have 40 megabytes of additional hard drive space,
- you may be interested in installing the product from the
- hard drive. The primary advantage of this would be to
- increase the speed of the installation. In order to install
- from the hard drive, copy the install disks or the install
- directory of the CD into a temporary directory on the hard
- drive, and run INSTALL.EXE from that directory.
-
- E) Win32s Issues
-
- Win32s is for use with Windows 3.1 or 3.11 only.
- Specifically, it is not required for a Win32 operating
- system, and will not work with OS/2.
-
- Most of the time, if the Win32s setup utility fails, it is
- because the setup program had difficulty detecting a
- sufficient amount of virtual memory. Ensure that you have
- virtual memory enabled, and that you are running in
- Enhanced Mode.
-
- SECTION -3- TROUBLESHOOTING INSTALL PROBLEMS
- ============================================
-
- A) Internal Error, Unable to Start Install
-
- 1) Error -2: the install utility was unable to create a
- temporary directory needed for the installation. Please
- check your autoexec.bat to see if there is a TMP or
- TEMP environment variable. If there is one, verify that
- it points to a valid directory on a drive with at least
- ten megabytes of free space (fifteen if you are using
- disk compression). If you do not have a variable set,
- the install program will place its files in the directory
- \WINDOWS\BORLAND.TMP. If there is not enough space on
- the drive which contains Windows, be sure to set this
- variable.
-
- 2) Error -3: there was an error while copying and decompressing
- INSTRUN.EXE, which is used to launch phase two of the
- installation. Check to be sure there is sufficient space
- in your temp directory, boot clean (if you are running
- Windows 3.1), and attempt to install from the hard drive.
- (See section 2D). If the error persists, see section
- 3E for an explanation of corrupted .pak files.
-
- 3) Error -69: INSTRUN.EXE failed to execute. This is probably
- due to either file corruption or memory corruption. If
- you are running Windows 3.1, perform a clean boot (see
- section 1D); otherwise, perform a hard drive install
- (see section 2D), or check section 3E.
-
- B) Data Integrity or Bad Sector on Disk Errors
-
- If you recieve one of these errors, you may need to get a
- replacement disk set. If running a disk checking utility
- reports a bad sector or data integrity problems, contact
- Macmillian Publishing's Disk Replacement Line at
- (317) 581-3833.
-
- C) Install Program Terminates Prematurely
-
- If the install proram stops for no apparent reason without
- error messages, it is possible that certain support files
- are write protected. To check this, switch to your WINDOWS
- directory, type "attrib *.*", and check the resulting
- output for the "r" attribute. If any file has this flag
- set, you need to clear it by typing "attrib -r <filename>".
- Repeat this process for the WINDOWS\SYSTEM directory.
-
- (If attempting this procedure under NT or Windows95,
- remember that the WINDOWS directory is called WINNT and WIN95
- under those two operating systems).
-
- D) "Unable to write to destination file" error.
-
- If the install program stops and returns an "unable to write
- to destination file: filename.pak" error, it means that
- the install program is not able to create certain files
- which are contained in the .pak file. This problem typically
- happens because the files are already in use, but can
- also be a result of incorrect file permissions.
-
- To correct this problem, you need to do two things:
-
- 1. If running 16-bit Windows, perform a "clean boot".
-
- 2. Follow the directions in section 3C for making sure that
- files are not write protected.
-
- If neither of these solves the problem, you can change the
- names of the files which the install program is attempting
- to overwrite, restart windows, and try again.
-
- Here are some of the most common PAK files that cause this error,
- and their associated DLLs:
-
- DLL_CT32 PAK (Disk28)
- CTL3D32 DLL
-
- OCF32SYS PAK (Disk24)
- BOCOF DLL
-
- BWCC32.PAK (Disk25)
- BW32007.DLL, BW32009.DLL, BW3200C.DLL, BWCC32.DLL
-
- BIVBX32.PAK (Disk28)
- BIVBX11.32C, BIVB11.32N, BIVBX11.32S, BIVBX11C.DLL
- BIVBC11N.EXE, BIVBX11S.DLL.
-
- BWCC.PAK (Disk15)
- BWCC.DLL, BWC0007.DLL, BWCC0009.DLL, BWCC000C.DLL
-
- OLE2RDST.PAK (Disk3)
- COMPOBJ.DLL, OLE2.DLL, OLE2.REG, OLE2CONV.DLL, OLE2DISP.DLL
- OLE2NLS.DLL, OLE2PROX.DLL, STDOLE.TLB, STDTYPE.TLB,
- STORAGE.DLL, TYPOELIB.DLL
-
- E) "Error: 386 or Greater required"
-
- Prior to unpacking most of the .pak files, the installation
- program copies them onto the hard drive and then decompresses
- them. Under certain circumstances, these files can become
- corrupted while being copied onto the hard drive. "386 or
- Greater required" is one of several error messages which
- are displayed when this type of problem occurs.
-
- In the event that you recieve an error message like this one,
- or which indicates that you have corrupted .pak files,
- you need to _slow down_ the speed of your microprocessor.
- This will reduce the difference in rates of activity between
- the floppy drive, the processor, and the hard drive, and will
- reduce the likelihood of corruption.
-
-
- SECTION -4- COMMON RUNTIME ERRORS
- =================================
-
- A) General Protection Fault in COMPOBJ
-
- We have received reports that on some systems, Microsoft
- Office and other OLE2 applications will not run after
- installation of Borland C++ 4.5x. While we are not
- certain exactly what is generating this problem, we have
- established that it seems to be related to an incomplete
- installation of Win32s.
-
- Under certain circumstances, the file w32sys.386 does not
- get updated and will remain at version 1.15.xx while the
- rest of Win32s is updated to the current version.
-
- If the problem occurs on your system, you should edit your
- system.ini and comment out the line:
-
- device=c:\windows\system\win32s\w32sys.386
-
- and then restart Windows. You can then reinstall Win32s by
- running SETUP.EXE, which is located in the install
- directory of the CD or on disk 27. This will restore a
- total and consistent copy of Win32s.
-
- B) BWCC 2.0 or Greater Required
-
- There are many programs which make use of the BWCC DLL.
- The current version of this DLL is placed in your windows
- system directory (WINNT/SYSTEM or WIN95/SYSTEM). If
- an older version is in a directory that is in the search
- path, that version may be loaded in error, and this error
- message will be generated.
-
- Make sure that the only copy of the BWCC.DLL is located in
- the WINDOWS\SYSTEM directory, and that it is dated 10-21-93
- or later.
-
-
- SECTION -5- CHANGES TO SYSTEM
- ==============================
-
- The Borland C++ 4.52 install program modifies four of your
- system configuration files (autoexec.bat, win.ini,
- progman.ini, and system.ini), and adds files to your
- windows and windows system directories.
-
- The following lines are added to your win.ini if you are
- running 16-bit or 32-bit Windows:
-
- [Extensions]
- IDE=BCW.EXE ^.IDE
- [BCW4.5 INSTALL]
- Reserved1=C:\BC45
-
- The following lines are added to the [Groups] section of
- progman.ini if you are running 16-bit or 32-bit Windows:
-
- [Groups]
- Group6=C:\WINDOWS\BCW45.GRP
-
- The following lines are added to the [386Enh] section of
- system.ini if you are running 16-bit or 32-bit Windows:
-
- device=c:\bc45\bin\tddebug.386
- device=c:\bc45\bin\winrun.386
-
- The path statement in your autoexec.bat is updated (if you
- are running 16-bit Windows or Windows 95) by adding the
- line:
-
- path c:\bc45\bin; %path%
-
-
- In addition, the install program creates the following .ini
- files in your windows, winnt, or win95 directories:
-
- owl.ini tdw.ini openhelp.ini
- winhelp.ini bcw.ini dosapp.ini winfile.ini
-
- The install also places files related to BIVBX, BWCC, and
- OCF in your windows\system or windows\system32 directory,
- as appropriate. If you are running 16-bit windows, OLE and
- CTL3D dlls will be added to your windows\system directory;
- these dlls are part of 32-bit windows and so will not be
- added on a 32-bit platform.
-
- In addition, a WIN32S directory will be created, and the
- WIN32s files will be installed, if you install win32s.
-
-
- SECTION -6- HOW TO GET HELP
- ===========================
-
- SOURCES OF INFORMATION
- ----------------------
- If you have any problems, please read this file, the
- HELPME!.WRI and other files in your DOC subdirectory, and
- check the on-line help and the Borland C++ manuals first.
- If you still have a question and need assistance, help is
- available from the following sources:
-
- For technical support by phone for Borland C++ 4.52,
- contact Macmillan Publishing. Please do not contact
- Borland International for support. See your Getting
- Started booklet for more information on contacting
- Macmillan Publishing.
-
- Email: support@mcp.com
-
- Telephone: (317) 581-3833
-
- Fax: (317) 581-4773
-
- Mail: Macmillan Computer Publishing
- Attention: Support Department
- 201 West 103rd Street
- Indianapolis, IN 46290
-
-
- Borland offers a range of services to provide comprehensive
- product information, updates, and product services. You can
- get more information on Borland C++ by contacting any of
- these resources:
-
- World Wide Web: http://www.borland.com/
-
- FTP: ftp.borland.com
-
- Newsgroups: forums.borland.com
-
- Listserv: listserv@borland.com
- Send an email message containing this text:
-
- SUBSCRIBE<space>BCPP<space>FIRSTNAME<space>LASTNAME