Read Me for WATCOM C/C++ 11.0 Run-Time Library Source
-----------------------------------------------------


1.1 General Notes
-----------------

1. The following description assumes you have installed the library source in 
   a directory called "\WCRTL".
2. This library source is extracted from a common set of source used to build 
   the run-time libraries for several different environments, therfore there 
   may be extra files present that do not apply to your system.
3. Source is not provided for the 8087 emulator, the 387 emulator or the 
   graphics library.


1.2 Space Requirements
----------------------

The C/C++ run-time library consists of a lot of small source files.  The 
object files created are also small.  Therefore the amount of disk space 
required will depend largely on the cluster size of the drive on which the 
library is installed.  The numbers presented here are for a FAT file system 
drive with a cluster size of 4096.  You will need more space if the cluster 
size is larger and less space if the cluster size is smaller.  (i.e.  you will 
require approximately half the amount of space listed if you install on a 
drive with a cluster size of 2048.)

1. You will need 20.2 MB of disk space for the run-time library source.
2. You will need the following amount of disk space for the various libraries.

Common header files                           			0.5MB
Math library source code                      			0.7MB
C library source code                         			7.7MB
C++ library source code                       			1.8MB
16 bit Math 		  (wmake CPU=16bit)
16 bit DOS		  (wmake OS=msdos CPU=16bit)
16 bit OS/2 1.x		  (wmake OS=os2 CPU=16bit)
16 bit Windows 3.1 	  (wmake OS=windows CPU=16bit)
32 bit DOS (register)	  (wmake OS=msdos CPU=32bit CONVENTION=register)	
32 bit DOS (stack)	  (wmake OS=msdos CPU=32bit CONVENTION=stack)
32 bit OS/2 2.x (register)(wmake OS=os2 CPU=32bit CONVENTION=register)	
32 bit OS/2 2.x (stack)	  (wmake OS=os2 CPU=32bit CONVENTION=stack)	
32 bit Windows (register) (wmake OS=windows CPU=32bit CONVENTION=register)	
32 bit Windows (stack)	  (wmake OS=windows CPU=32bit CONVENTION=stack)	
32 bit WinNT (register)	  (wmake OS=winnt CPU=32bit CONVENTION=register)	
32 bit WinNT (stack)	  (wmake OS=winnt CPU=32bit CONVENTION=stack)
32 bit Netware (stack)	  (wmake OS=netware CPU=32bit CONVENTION=stack)
C++ Library		  (wmake TARGET=cpplip)


1.3 Tools Required
------------------

* wcc.exe
* wpp.exe
* wcc386.exe
* wpp386.exe
* wasm.exe
* wlib.exe
* wmake.exe


1.4 Setup Required Before Building the Libraries
------------------------------------------------

1. You must add "\WCRTL\BIN" to your path so that wmake.exe can find the 
   "makeinit" file.
2. You must modify the definition of "devdrv" in the "bin\makeinit" file so 
   that it points to where you have chosen to install "\WCRTL".
   

1.5 Building the Libraries
--------------------------

There is a master makefile in the root directory of each component, as well as 
a makefile in the "\WCRTL" directory.  These can be used to create all the 
libraries and copy the created libraries into the "WATCOM" tree.  The 
following commandline parameters are supported:

wmake TARGET={target} OS={os} CPU={cpu} MODEL={model}
where 
	{target} is one of CLIB, CPPLIB, MATHLIB or RTDLL
	{os} is one of MSDOS, WINDOWS, WINNT, OS/2 or NETWARE
	{cpu} is one of 16BIT or 32BIT
	{model} is one of SMALL, MEDIUM, COMPACT, LARGE, HUGE or FLAT
	
"WMAKE" will create all libraries. It uses PMAKE.EXE to do this.  PMAKE.EXE is 
found in the "\WCRTL\BIN" directory.  It is a utility program that searches a 
subdirectory tree for MAKEFILEs and then visits each directory that contains 
a MAKEFILE and executes WMAKE.EXE.

The operation of PMAKE.EXE can be modified through the use of additional 
command line parameters. Each of the MAKEFILEs in the directory tree have a 
comment line of the form:

    #pmake: token1 token2 token3 token4
    
These tokens can be used to select with MAKEFILEs should be included by 
PMAKE.EXE.  For example:

    PMAKE.EXE 16bit windows small
    
Will build all the libraries needed for small memory model 16bit Windows 
programs.  By default,  MAKE.EXE executes WMAKE.EXE for every MAKEFILE it 
finds.  The following list summarizes the tokens that may be used with 
PMAKE.EXE:

16bit   	-> 	16 bit libraries
32bit   	-> 	32 bit libraries
small   	-> 	small memory model
medium  	-> 	medium memory model
compact 	-> 	compact memory model
large   	-> 	large memory model
huge    	-> 	huge memory model
flat    	-> 	flat memory model
register	-> 	register parameter passing conventions
stack   	-> 	stack parameter passing conventions
math    	-> 	math library
msdos   	-> 	msdos hosted libraries
netware 	-> 	Netware hosted libraries
os2     	-> 	OS/2 hosted libraries
windows 	-> 	Windows hosted libraries
winnt   	-> 	Windows NT hosted libraries

"COPYALL.BAT" will copy all created libraries into the "WATCOM" tree.

