--------------------------------------------------
INSTALLATION INSTRUCTIONS FOR 386|DOS-EXTENDER SDK
--------------------------------------------------

This product is distributed on three floppy disks.

To copy the product to your hard disk, run the INSTALL program on disk 1.
By default, this will install the tools in  \PHAR386 directory on
your hard disk, with the subdirectories listed below.

* \PHAR386\BIN
  The .EXE files for the 386|DOS-Extender SDK, and MS-DOS batch files for
  building the sample programs included with the SDK.

* \PHAR386\INCLUDES
  C and assembly language header files defining constants and data structures
  for MS-DOS and 386|DOS-Extender system calls.  The PHARLAP.H and PLDOS32.H
  files contain function prototypes for the libraries in \PHAR386\LIB,
  documented in the Libraries and System Calls Reference.

* \PHAR386\LIB
  Libraries of C-callable functions, documented in the Libraries and System
  Calls Reference.

* \PHAR386\DOCS
  Text files describing new program features not documented in the manuals.

* \PHAR386\EXAMPLES
  Example 386|DOS-Extender programs.  See Appendix A in the 386|DOS-Extender
  Reference Manual, and EXAMPLES.DOC in \PHAR386\DOCS, for a description of 
  the sample programs and how to build them.

* \PHAR386\WATCOM
  Replacement startup modules for WATCOM C/386 and FORTRAN 77/386 run-time
  libraries;  see description below.

To run the programs, add the BIN directory to the MS-DOS PATH environment
variable.  For example, if you installed the tools in C:\PHAR386, add
C:\PHAR386\BIN to the "SET PATH=" command in your AUTOEXEC.BAT file.

----------------------------------------------------
INSTALLATION INSTRUCTIONS FOR MICROSOFT 32-BIT C/C++
----------------------------------------------------
If you wish, INSTALL can automatically install the Microsoft 32-bit C/C++
compiler after it completes installing the 386|DOS-Extender SDK.
INSTALL asks whether you want to install the Microsoft 32-bit C/C++
compiler from the Windows NT October 1992 CD-ROM after the 386|DOS-Extender
SDK installation is complete.  By default, the Microsoft compiler is
installed in a \MSTOOLS directory on your hard disk, with the subdirectories
listed below.

* \MSTOOLS\BIN
  The .EXE files for Microsoft 32-bit C/C++.

* \MSTOOLS\H
  The C header files.

* \MSTOOLS\LIB
  The C run-time library files.

* \MSTOOLS\INIT
  Configuration files for some Microsoft tools programs.

* \MSTOOLS\SAMPLES
  The example programs included with the Microsoft compiler.

* \MSTOOLS\HELP
  On-line help files for the Microsoft tools.

* \MSTOOLS\MFC
  The Microsoft Foundation Classes.

* \MSTOOLS\MFC\INCLUDE
  The C++ header files for the Microsoft Foundation Classes.

* \MSTOOLS\MFC\LIB
  The C++ run-time library files for the Microsoft Foundation Classes.

If you prefer to install the Microsoft 32-bit C/C++ compiler later, you
can install it manually using the GETMSC.BAT batch file in \PHAR386\BIN.

GETMSC.BAT uses the following command line:

	GETMSC cd_drive_letter MSC_install_path PL_path [min, sample, max]

	cd_drive_letter		The DOS disk drive letter for your CD-ROM.

	MSC_install_path	The disk and directory in which to install
				Microsoft 32-bit C/C++.  You must create
				this directory before running GETMSC.BAT.

	PL_path			The disk and directory in which you have
				already installed the 386|DOS-Extender SDK.

	min    			Install MSC compiler only (this is the default
				if the last parameter is ommitted).  This
				uses about 13 MB of disk space.

	sample 			Install MSC compiler and Microsoft sample code.
				This uses about 18 MB of disk space.

	max    			Install MSC compiler, Microsoft sample code,
				help files, and Microsoft Foundation Classes.
				This uses about 42 MB of disk space.

For example, if your CD-ROM drive is disk K:, you have already installed
the 386|DOS-Extender SDK in C:\PHARLAP, and you want to install the
Microsoft C/C++ compiler and sample code in C:\MSTOOLS, type the command:

	mkdir c:\mstools
	getmsc k: c:\mstools c:\pharlap sample

To run the compiler, add the BIN directory to the MS-DOS PATH environment
variable.  For example, if you installed the tools in C:\MSTOOLS, add
C:\MSTOOLS\BIN to the "SET PATH=" command in your AUTOEXEC.BAT file.

-------------------------------------------------------
UPDATE INSTRUCTIONS FOR WATCOM C/386 AND FORTRAN 77/386
-------------------------------------------------------
The run-time libraries distributed with WATCOM C/386 and 
WATCOM FORTRAN 77/386 versions 9.01 and earlier are incompatible
with 386|DOS-Extender version 5.0 or later.

The files in \PHAR386\WATCOM are replacement startup modules for WATCOM
C/386 and WATCOM FORTRAN 77/386 version 9.0 or 9.01 libraries, to make them
work with version 5.0 or later of the Phar Lap 386|DOS-Extender.  
The WATCOM libraries can be updated with the following commands:

    wlib c:\watcom\lib386\dos\clib3r +-c:\phar386\watcom\cstart3r.obj
    wlib c:\watcom\lib386\dos\clib3s +-c:\phar386\watcom\cstart3s.obj
    wlib c:\watcom\lib386\dos\flib   +-c:\phar386\watcom\cstart3r.obj
    wlib c:\watcom\lib386\dos\flib7  +-c:\phar386\watcom\cstart3r.obj
    wlib c:\watcom\lib386\dos\flibs  +-c:\phar386\watcom\cstart3s.obj
    wlib c:\watcom\lib386\dos\flib7s +-c:\phar386\watcom\cstart3s.obj

If you have a version of WATCOM C/386 or WATCOM FORTRAN 77/386 earlier
than 9.0, you must update the compiler to obtain compatibility with
version 5.0 of 386|DOS-Extender.

If you have a version of WATCOM C/386 or WATCOM FORTRAN 77/386 later
than 9.01, you don't need to do anything;  the libraries are already
compatible with 386|DOS-Extender version 5.0.
