Win32 for OS/2 Alpha distribution v0.03

NOTE: This is an early alpha and for that reason has no
      fancy install program. So RTFM.

------------>>DO NOT EMAIL US DIRECTLY WITH QUESTIONS/REQUESTS<<----------------
------------>>  Read the 'Problems/Bug reports' section below <<----------------

********************************************************************************
** Fixes/additions in version 0.03
********************************************************************************
- Win32K: win32 executable loader (see win32k.txt for installation details)
- Improved DirectDraw support. Quake 2 now runs full screen. 
- Borland executable fixes for pe2lx
- Many stubs added for non-implemented apis
- Version resources supported
- Loads of bugfixes

********************************************************************************
** Installation
********************************************************************************
Create a directory (say, f:\win32os2) in which you unzip win32os2_003.zip.
(unzip win32os2_003.zip or pkunzip -d win32os2_003.zip)
Add f:\win32os2\bin (in this case!) to the LIBPATH and PATH in your config.sys.
After a reboot, you're ready to go.

********************************************************************************
** Win32K: The win32 executable loader
********************************************************************************
See win32k.txt and read it very carefully!

********************************************************************************
** PE2LX: The executable converter.
********************************************************************************
PE2LX converts (as the name implies) win32 executables or dlls into
OS/2 exe/dlls.
**Command line syntax 1:
	  pe2lx win32file > outputfile
win32file: 	Windows 95/NT exe or dll name
outputfile: 	name of the file which will contain some debug information
		from pe2lx afterwards.

Pe2lx will make a backup copy of the original win32 exe/dll and give the
new OS/2 exe/dll it's name.
i.e. : pe2lx notepad.exe > notepad
generates two files:
	notepad.exe	OS/2 version
	notepad.exf	win32 version
Backup copies of dlls have the extension dlm.

**Command line syntax 2:
	  pe2lx win32file os2file > outputfile
win32file: 	Windows 95/NT exe or dll name
os2file:        OS/2 exe or dll name
outputfile: 	name of the file which will contain some debug information
		from pe2lx afterwards.

********************************************************************************
** How to disable logging
********************************************************************************
Although the output generated in win32os2.log very useful for debugging,
it slows things down quite a bit.
You can disable it by adding the following variable to your environment:
  SET NOWIN32LOG=ANY VALUE
You can do this either in config.sys or in a batch file which is used
to start the converted win32 app.
This environment variable must not exist to enable logging.

********************************************************************************
** Converting other win32 applications
********************************************************************************
This distribution can also be used to convert any win32 program you have.
We don't guarantee this will work (actually, the chance is rather high that
it won't).
A lot of win32 apps need comctl32.dll (dll for the common GUI controls).
We haven't implemented it, so you'll need to convert the one
from your Windows 95 or NT installation with pe2lx.

In order to get a complete win32 app converted, you must convert all the
executables and dlls it uses. (check in the output from pe2lx to look
at the modules from which it imports functions)
This is quite a tedious job, but we'll change this in a future release.

NOTE: Some people convert the win32 versions of dlls we supply (i.e. winmm.dll)
      This won't work!

********************************************************************************
** Problems/Bug reports
********************************************************************************
When something doesn't work, DO NOT EMAIL US DIRECTLY; YOU WILL BE IGNORED!
Use the newsgroup comp.os.os2.bugs instead.
And only when you're not trying to convert large apps like MS Office,
AutoCAD, Corel Draw etc etc. 
We know that those large apps don't work correctly or at all.

When you post an article to comp.os.os2.bugs, always mention your OS/2
version and FP level.

We will monitor this newsgroup for articles about Win32 for OS/2.
To make it easier for us to spot such articles, include 'Win32 for OS/2'
in the subject line.

********************************************************************************
** Updates or News
********************************************************************************
Any changes will be reported on our webpage:
	http://www.os2ss.com/win32-os2/
Don't bother asking us directly; visit the page.


The Win32 for OS/2 project is made possible by the following people:
 Sander van Leeuwen 	Pe2lx, kernel32, user32, gdi32, DirectDraw, DirectSound,
			winmm (wave out + aux), version, advapi32 + others
 Knut St. Osmundsen	Win32K, help with pe2lx, kernel32
 Peter Fitzsimmons	API utilities, development environment and
                        help with pe2lx, user32, kernel32.
 Patrick Haller		Console apis, ntdll, shell32, help with pe2lx, kernel32, 
			user32, advapi32
 Joel Troster		MIDI support + WINMM, help with kernel32
 Vince Vielhaber	Winsock
 Chris McKillop		Build utilities
 Timur Tabi		Maintainer of webpage, Warpstock speaker
 Felix Maschek		ISDN implementation, Serial IO & TAPI stubs

********************************************************************************
** Copyright for XF86SUP.SYS
********************************************************************************
	Copyright (c) 1995, 1996 by Holger Veit (Holger.Veit@gmd.de)

This driver comes with XFree86 for OS/2 and is included to make thing easier.
It's identical to the latest one that comes with XFree86/2.

********************************************************************************
** STANDARD DISCLAIMER
********************************************************************************
The authors makes no representations about the accuracy or suitability of
this material for any purpose.  It is provided "as is", without any
express or implied warranties.  The authors will assume no liability for
damages either from the direct use of this product or as a consequence of
the use of this product. (including software license violations)
