Documenting support for Open Watcom

git-svn-id: svn+ssh://svn.code.sf.net/p/freeglut/code/trunk/freeglut/freeglut@682 7f0cb862-5218-0410-a997-914c9d46530a

diff --git a/ChangeLog b/ChangeLog
index 89ddcd4..a3ba2f5 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1130,3 +1130,9 @@ necessary to temporarily use the X11 flags found by AC_PATH_XTRA.
 (294) Fixed the GLUT_CURSOR_INHERIT logic once again...
 
 (295) Synched the DLL definitions with reality.
 (294) Fixed the GLUT_CURSOR_INHERIT logic once again...
 
 (295) Synched the DLL definitions with reality.

+
+**************************************************************************
+* Changes on August 31, 2005.
+**************************************************************************
+
+(296) Added support for Open Watcom

diff --git a/README.win32 b/README.win32
index b02d38f..6f0b96c 100755 (executable)
--- a/README.win32
+++ b/README.win32
@@ -1,31 +1,40 @@
-Windows 32 / MSVC Notes
-=======================
+Windows 32 Notes
+================

 
 The "freeglut" library installation package comes with MSVC 6.0 workspace and
 
 The "freeglut" library installation package comes with MSVC 6.0 workspace and

-project files.  The workspace has two projects:  "freeglut.dsp", which creates
-a DLL file, and "freeglut_static.dsp", which creates a static library.
+project files.  The workspace "freeglut.dsw" has two projects:
+"freeglut.dsp", which creates a DLL file, and "freeglut_static.dsp", which
+creates a static library.

 
 

+The "freeglut" library also comes with an Open Watcom compiler project file
+"freeglut.wpj" and two target files "freeglut.tgt" and "freeglut_static.tgt".
+The two target files build DLL and static libraries.  The Open Watcom also
+includes "freeglut.rc", which is a resource compiler script to add a "Version"
+tab to the DLL property sheet.

 
 

-Building the Libraries
-======================
+
+Building the Libraries with MSVC
+================================

 
 To build the "freeglut" libraries, open MSVC and load the "freeglut" workspace.
 This will load the two projects.  Selecting "Build" - "Batch Build" from the
 menu will build both the debug and the release versions of both libraries.
 
 
 To build the "freeglut" libraries, open MSVC and load the "freeglut" workspace.
 This will load the two projects.  Selecting "Build" - "Batch Build" from the
 menu will build both the debug and the release versions of both libraries.
 

-The libraries will be found in the following places and will have the following
-names:
-- DLL, debug version:  freeglut\freeglut\Debug\freeglut.lib
-- DLL, release version:  freeglut\freeglut\Release\freeglut.lib
-- Static, debug version:  freeglut\freeglut\DebugStatic\freeglut_static.lib
-- Static, release version:  freeglut\freeglut\ReleaseStatic\freeglut_static.lib
+The libraries will be found in the following places and will have the
+following names:
+- DLL, debug version: freeglut\freeglut\Debug\freeglut.lib
+- DLL, release version: freeglut\freeglut\Release\freeglut.lib
+- Static, debug version: freeglut\freeglut\DebugStatic\freeglut_static.lib
+- Static, release version: freeglut\freeglut\ReleaseStatic\freeglut_static.lib

 
 Unlike the *nix release, the library names are NOT automatic replacements for
 
 Unlike the *nix release, the library names are NOT automatic replacements for

-the GLUT library names.  You may rename them manually if you wish.
+the GLUT library names.  You may rename them manually if you wish, but this is
+not necessary as the header file includes a pragma telling the compiler which
+library file to look for.

 
 
 
 

-Installing the Libraries
-========================
+Installing the Libraries with MSVC
+==================================

 
 To install "freeglut" on your system so that your other projects will see it,
 you will need to copy various files to various locations.
 
 To install "freeglut" on your system so that your other projects will see it,
 you will need to copy various files to various locations.

@@ -50,8 +59,31 @@ you will need to copy various files to various locations.
       and will probably already have the files "opengl32.dll" and "glu32.dll".
 
 
       and will probably already have the files "opengl32.dll" and "glu32.dll".
 
 

-If you don't have MSVC
-======================
+Building and Installing the Libraries with Open Watcom
+======================================================
+
+To build the "freeglut" libraries, open Watcom and load the "freeglut.wpj"
+file.  This will load the two target files.  Clicking on the "Make All
+Targets" button will build both the debug and the release versions of both
+libraries.
+
+The "make" script will copy the library files to the Open Watcom library
+folder and will copy "freeglut.dll" to the correct "System32" folder.  The
+library files are named "freeglut.lib" for the DLL version and
+"freeglut_static.lib"for the static library.
+
+You will need to copy the "freeglut" include files from their installed
+location ("freeglut\freeglut\include\GL") to the Open Watcom include directory
+("%WATCOM%\h\nt\GL").
+
+Unlike the *nix release, the library names are NOT automatic replacements for
+the GLUT library names.  You may rename them manually if you wish, but this is
+not necessary as the header file includes a pragma telling the compiler which
+library file to look for.
+
+
+If you don't have MSVC or Open Watcom
+=====================================

 
 The "freeglut" developers' community discussed the possibility of distributing
 binaries and decided against it.  If you need Windows library files, please
 
 The "freeglut" developers' community discussed the possibility of distributing
 binaries and decided against it.  If you need Windows library files, please