Fixed bug #818

 Daniele Forghieri      2009-10-12 02:52:02 PDT

Updated makefile & Doc for Open Watcom 1.8

--HG--
extra : convert_revision : svn%3Ac70aab31-4412-0410-b14c-859654838e24/trunk%404317

README.Watcom

 
-Using SDL under Windows with the OpenWatcom compiler
+Using SDL 1.3 under Windows with the OpenWatcom compiler
+
 ====================================================
 
 Prerequisites
 -------------
 
-I have done the port under Windows XP Home with SP2 installed. Windows
-2000 should also be working. I'm not so sure about ancient Windows NT,
+I have done the port under Windows XP Professional with SP2 installed.
+Windows 2000 should also be working. I'm not so sure about ancient Windows NT,
 since only DirectX 3 is available there. Building should be possible,
 but running the compiled applications will probalbly fail with
 SDL_VIDEODRIVER=directx. The windib driver should work, though.
 
 To compile and use the SDL with Open Watcom you will need the following:
-- Open Watcom compiler. I used version 1.5. The environment variables
+- Open Watcom compiler. I used version 1.8. The environment variables
   PATH, WATCOM and INCLUDE need to be set appropriately - please consult
   the OpenWatcom documentation and instructions given during the
   installation of the compiler.
   My setup looks like this in owvars.bat:
-    set WATCOM=C:\watcom
+    set WATCOM=C:\dev\ow18
     set INCLUDE=%WATCOM%\h;%WATCOM%\h\nt
     set PATH=%PATH%;%WATCOM%\binnt;%WATCOM%\binw
-- A fairly recent DirectX SDK. The original unmodified DX8 SDK works, as
-  well as the minimal DirectX 7 SDK from the Allegro download site
-  (<http://alleg.sourceforge.net/files/dx70_min.zip>).
-- The SDL sources from Subversion
+- A recent DirectX SDK. The library needs D3d9.h so at leat the
+  directx 9 sdk is to be used. I used DirectX 10 SDK from August 2009
+  taken directly from the microsoft site.
+- The SDL 1.3 sources from Subversion
 - The file Watcom-Win32.zip (now available in Subversion)
 
 
@@ -33,13 +34,12 @@ Building the Library
 1) In the SDL base directory extract the archive Watcom-Win32.zip. This
    creates a subdirectory named 'watcom'.
 2) The makefile expects the environment variable DXDIR to be set to the
-   base directory of a DirectX SDK. I have tried a stock DX8 SDK from
-   Microsoft as well as the minimal DirectX 7 SDK from the Allegro
-   download site.
+   base directory of a DirectX SDK. I have tried the August 2009
+   DirectX SDK from Microsoft
    You can also edit the makefile directly and hard code your path to
    the SDK on your system.
    I have this in my setup:
-     set DXDIR=D:\devel\DX8_SDK
+     set DXDIR=..\dx10
 3) Enter the watcom directory and run
      wmake sdl
 4) All tests from the test directory are working and can be built by
@@ -71,9 +71,9 @@ Notes:
  The library can also be built with the stack calling convention of the
  compiler (-6s instead of -6r).
 
-
 Test applications
 -----------------
+$FixME: which test works ? which one compiles ?
 
 I've tried to make all tests work. The following table gives an overview
 of the current status.
@@ -126,8 +126,14 @@ There is room for further improvement:
 Questions and Comments
 ----------------------
 
-Please direct any questions or comments to me:  <mailto:macpete@gmx.de>
+Please direct any questions or comments to me:
+
+        ow_sdl [at] digitalfantasy [dot] it
+
+The original porting to the open watcom compiler was made by
+Marc Peter <mailto:macpete@gmx.de>
 
    Happy Coding!
 
-   Marc Peter
+   Daniele Forghieri
+