Copyright: SETUP.HLP, Version 1.00.3173


Contents

  Welcome Dialog Box

  Installation Options Dialog Box

  Directories Options Dialog Box

  Changes to Your Configuration Files


Welcome Dialog Box

This Setup program allows you to install Win32s; the Microsoft C/C++ Compiler, Linker, include files, and libraries; 16-bit versions of the CodeView debugger and the Profiler; and the Phar Lap TNT DOS-Extender Lite on your computer. WIN32s is an extension to Windows 3.1 that is composed of several DLLs, WIN32S.EXE, and a virtual device driver that allow Windows 3.1 to load and run Win32 binaries. The Microsoft C/C++ Compiler, Linker, CodeView debugger, and Profiler allow you to build, debug, and analyze Win32s applications. You can use Setup to install either a default or a custom version of the product. After the initial installation, you can run Setup again at any time to install additional components.

If you are developing and testing Win32s applications, you need either a dual-boot computer or a separate computer with:

Microsoft Windows or Microsoft Windows for Workgroups version 3.1 running in enhanced mode (command-line utilities can be run outside Windows but you need Windows to run Win32s applications).

MS-DOS version 3.3 or greater.

If you plan on using a second computer for testing and debugging Win32s programs, you must install Win32s and the 16-bit version of CodeView for Windows on the second computer. This requires that the second computer have a CD-ROM drive.

Product Information

The "Installing Microsoft Visual C++" chapter of the Getting Started book contains information on:

System requirements

Product components

CONFIG.SYS and AUTOEXEC.BAT files (neither is changed by Setup)

Presenting Visual C++ contains information on:

Product components

Location of topics in the documentation

Getting Help

For more information on any screen that contains a Help button, either:

Press F1, or

Choose the Help button.

Continue

If you choose Continue, Setup:

Prompts you for information

Confirms your Setup choices

Copies the requested files to your hard disk

Asks you to confirm changes to system files

Exit

If you do not want to install the Win32s components of Visual C++ now:

Press F3, or

Choose the Exit button


Installation Options Dialog Box

Use this dialog box to install Win32s, the 32-bit Microsoft C/C++ Compiler and Linker, 16-bit versions of the CodeView debugger and the Profiler (these are the only 16-bit versions of these two tools that ship with Visual C++), and the Phar Lap TNT DOS-Extender Lite.

Win32s DLLs Control Group

This control group contains check boxes to install either the retail or the debug versions of Win32s. The debug versions contain symbolic information that allows you to use the debugger to view the code in the Win32s DLLs and virtual device driver along with your own code.

If you select the retail version, Setup installs the retail version of Win32s to MSVC32S\WIN32S\RETAIL (the default retail version's installation directory). If you select the debug version, Setup installs the debug DLLs to MSVC32S\WIN32S\DEBUG (the default debug version's installation directory). These DLLs are then copied to your Windows directory (the default working directory for the Win32s DLLs). If you select both the retail and debug versions, Setup creates both the MSVC32S\WIN32S\RETAIL and MSVC32S\WIN32S\DEBUG directories and installs the appropriate DLLs in each. The retail DLLs are then copied to your Windows directory (the default working directory for the Win32s DLLs). You can run MSVC32S\WIN32S\BIN\SWITCH.BAT (after Setup is complete) to change from one version to the other without having to rerun Setup. SWITCH.BAT copies the appropriate version of Win32s to your Windows directory.

Win32s Tools Control Group

This control group contains check boxes to install the Microsoft C/C++ 32-bit compiler and all 32-bit build utilities, a 16-bit version of the CodeView debugger, and a 16-bit version of the Profiler. All of these tools are installed by default in the \MSVC32S\BIN directory. The 16-bit versions of the CodeView debugger and the Profiler allow you to analyze and debug your Win32s applications under Win32s.

Phar Lap TNT DOS-Extender Lite Check Box

This check box installs the Phar Lap TNT DOS-Extender Lite. This DOS extender lets you create one 32-bit application that runs under Windows NT, MS-DOS, and Windows 3.x. For more information, see the READ.ME file that is installed with Phar Lap TNT DOS-Extender Lite. Unless you have used the Directory Options dialog box to change the default drive and directory organization, this file is copied to C:\MSVC32S\PHARLAP\.

Determining Disk-Space Requirements

Installation root drive/directory

This field displays the default installation drive and directory. Choose the Directories button to change to a different drive or directory.

Space available on installation root drive

This field displays the amount of space available on the currently-selected root drive.

Space required on installation root drive

This field displays the amount of space required for the installation options that are specified for installation on the currently-selected root drive. The size of any option you have specified for installation somewhere other than the root drive is not displayed here.

Exit

If you choose Exit, Setup presents a Setup Abort message box that allows stopping the Setup program; no files are copied to your hard disk.

Back

If you choose Back, Setup returns to the Welcome dialog box.

Directories

If you choose Directories, Setup presents a dialog box that allows you to view or change the default directory structure used by Setup.


Changes to Your System Files
Changes to Your Configuration Files

CONFIG.SYS, AUTOEXEC.BAT, and WIN.INI

Setup makes no change to these files.

SYSTEM.INI

Setup makes the following changes to your SYSTEM.INI file:

If you installed the Retail or the Debug Win32s DLLs, Setup adds "DEVICE=C:\MSVC32S\WIN32S\RETAIL\W32S.386" to the [386Enh] section, where C:\MSVC32S\WIN32S\RETAIL refers to the destination of the retail Win32s DLLs selected from the Directories Options dialog box. Setup removes any other references to "W32S.386".

If you installed CodeView, Setup adds "DEVICE=C:\MSVC32S\BIN\CVW1.386" to the [386Enh] section, where "C:\MSVC32S\BIN" refers to the specified Executable directory. Setup removes any other references to "CVW1.386".

TOOLS.INI

Setup makes the following changes to your TOOLS.INI file:

If you installed CodeView, Setup adds "HELPFILES:C:\MSVC32S\HELP\*.HLP" to the [cvw32s] section, where "C:\MSVC32S" is the root directory of the installation.

If you installed the Profiler, Setup adds several EXCLUDE statements to the [profiler] section. These statements prevent the Profiler from profiling routines in the named libraries.

Select option for initialization file handling

This control group provides you with the following two ways to make the necessary changes to your current SYSTEM.INI and TOOLS.INI files:

Make changes now and back up current version

When you select this option, Setup saves the content of your current SYSTEM.INI and TOOLS.INI files to two new files and then writes necessary changes to your SYSTEM.INI and TOOLS.INI files. Setup generates the names of the two new files by using the base name of the original files (SYSTEM and TOOLS) and adding a numeric file extension. The numeric extension is .001 the first time you run Setup and select this option; the extension is incremented by .001 each subsequent time that you run Setup and select this option. Setup tells you where it writes these two backup files.

Write modified version to other location

When you select this option, Setup writes the content of your current SYSTEM.INI and TOOLS.INI files to two new files, SYSTEM.MSV and TOOLS.MSV, and then adds the required changes. It places these two new files in the root directory of the installation (C:\MSVC32S by default). You may examine these two files at your leisure before adding their content to your SYSTEM.INI and TOOLS.INI files.


Directories Options Dialog Box
Directory Options Dialog Box

Use this dialog box to specify both the drive(s) and the directories where Setup installs the product components. Any change to the Install Directory text box is propagated to the other text boxes whenever the focus changes. A change to any text box other than Install Directory is not propagated to other text boxes.

Disk Browser

The Disk Browser group of controls displays disk space information on the drive displayed in the Drive box. This feature allows you to quickly compare the available disk space on any drive to that which is required to install the currently-specified product components. The queried drive does not become part of the path specifications in the edit boxes.

OK

If you choose OK, Setup saves any change to the default installation and returns to the Installation-Options dialog box.

Cancel

If you choose Cancel, Setup discards any changes to the installation configuration and returns to the Installation-Options dialog box.

Exit

If you choose Exit, Setup presents a Setup Abort message box that allows stopping the Setup program; no files are copied to your hard disk.

Note  Setup will create a directory if it does not already exist. It will not create a directory that will not contain files.