updated for Mesa 3.3

1 files changed, 25 insertions, 95 deletions

diff --git a/docs/README.MINGW32 b/docs/README.MINGW32
index 75709ed43d..44c55aa021 100644
--- a/docs/README.MINGW32
+++ b/docs/README.MINGW32
@@ -1,120 +1,50 @@
-August 30, 1998 -- Paul Garceau (pgarceau@teleport.com)

+August 30, 1998 -- Paul Garceau

+Updated January 13, 2000 -- Paul Garceau (pgarceau@teleport.com)

 

-DISCLAIMER:  I make this extension to the Mesa 3-D Graphics Library as a service

+DISCLAIMER:  I make this port of the Mesa 3-D Graphics Library as a service

 to the general public.  I can, in no way support or make any guarantee that the

-EGCS-Mingw32 build or any Gnu-Win32 build will work for your system. The

-associated packages and batch files I have included as part of the EGCS-Mingw32

-extension are provided "As-is" with out any guarantee of support or functionality

-from the author of this EGCS-Mingw32 native windows port of the Mesa 3-D Graphics

-Library.

+build will work for your system.

+

+	The associated packages and batch files I have included as part of the GCC-2.95.2/Mingw32 extension are provided "As-is" with out any guarantee of support or functionality from this author.

 

 	Feel free to modify or change things as you see fit, just remember that

 I can't support any modifications you might want to make to the files which I

 have included OR the lgpl protected Mesa 3-D Graphics Library.

 

+	I recommend using GCC-2.95.2/Mingw32 which is available at Mumit Khans' ftp site:

 

-	EGCS-Mingw32 Beta 3.08 Archive Manifest:

-		mingw32.bat

-		src/makefile.nt4

-		src/wmesa.c

-		src-glu/makefile.nt4

-

-###############

-

-Greetings,

-

-	In order to build the Mingw32 set of Mesa 3-D Graphics Library for Beta3.08

-it will be necessary for you to use the Dos or Command Prompt that is available

-on most of the i86 based MS Windows machines.  Also, I believe that this build

-will run on Win95, Win98, WinNT4 and WinNT5.

-

-	I haven't tested Win95/98 or WinNT5.  This build was generated under

-WinNT4 with SP3 installed.

+		(ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/mingw32/)

 

-	This has not been tested under any systems outside of

-a WinNT4 Workstation with EGCS-Mingw32 toolchain, v.1.0.2 installed.

+	This build has been tested under WinNT4/SP6.  Win9x and WinNT5 remain untested by me.  I have not tested any of the demos included with Mesa3d.

 

-	EGCS-Mingw32 uses a variation of gcc to handle its build.  The Mesa 3-D

-Graphics Library build that I have generated is based, in small part, on the

-Cygwin32 build and associated makefiles that Stephane Rehel (rehel@worldnet.fr)

-defined back in 1997.  The EGCS-Mingw32 toolchain is capable of generating

-native windows code and, as of the date of this readme, can be obtained from:

+	I recommend using the GCC-2.95.2/Mingw32.

 

-	http://www.xraylith.wisc.edu/~khan/software/gnu-win32/egcs-mingw32-102.html

+	ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/mingw32/gcc-2.95.2

 

 	Much thanks to the combined efforts of Mumit Khan, Jan-Jaap Vanderhagen

-and Colin Peters for making it possible for the EGCS-Mingw32 toolchain to exist.

-

-Installing EGCS-Mingw32 Build Revisions:

-

-	To install the makefile and source revisions incorporated with this build

-of the Mesa 3-D Graphics Library, you'll have to use a version of winzip.  I am

-in the process of finding a suitable Win32 compatible tar executable so that if

-you don't have winzip, you can still decompress the files into their respective

-folders/directories.

-

-	a) Move the mingw32.zip file to the top level of the hard drive on your

-system.

-

-	b) Copy all of the Beta 3.08 src/windows files to the src/ directory.

-

-	b) Open the Winzip file

+and Colin Peters for making it possible for the Mingw32 toolchain to exist.  Also, thanks go out to Stephane Rehel for the work that was completed on the Cygwin build.

 

-	c) Verify that the files will be properly extracted.

+Installing GCC-2.95.2/Mingw32 Build:

 

-	d) Extract the files with the Winzip "Overwrite" and "Use Folder Names"

-	   options enabled.

+	a) Open the file archive (either tar.gz or .zip extensions)

 

-	The zip file directory structure extraction defaults to the top level of

-the hard drive where the mingw32.zip file exists unless otherwise instructed by

-you.

+	b) Decide the directory you want to move the archived files to.

 

-	The version of wmesa.c included with the mingw32 archive needs to replace

-the current version of the Beta 3.08 wmesa.c file in order for the egcs-mingw32

-build to work.  This is because the original Win32 stuff assumes that the glut

-utilities are to be installed.  The Glut utilities are not part of the

-egcs-mingw32 build for Beta 3.08.

+	d) Extract the files from the archive.

+	

+	e) Edit the mingw32.bat file to accomodate your choice of directory structure.

 

-

-Build Considerations:

-

-	In order to get the build to work, I needed to create a special makefile

-for each library which the Mesa 3-D Graphics Library requires since there is no

-comparable make-config/config on a native windows platform.

-

-	Since I was only creating a few of the possible libraries for 

-Mesa (gl, glu), I only created the new make files in their respective libraries

-src, src-glu).  For libMesaaux.a. you will find a makefile for it in the

-src-aux directory.  libMesatk.a and libglut.a were not ported.

-

-	The build itself is a .bat based build and uses Gnu Make,Version 3.76.1 to

-process the makefiles noted above.  The build must be run from the directory

-where the mingw32.bat file is.  You can get the binary version of Make 3.76.1

-from Jan-Jaap van der Heijden's site in Germany:

-

-	http://agnes.dida.physik.uni-essen.de/~janjaap/mingw32/download.html

-

-	It was necessary to modify some source code, specifically the source code

-in the src-glu directory.  I needed to modify nurbs.c, quadric.c and tess.c in

-order to get them to work using the EGCS-Mingw32 toolchain.

-

-	The original EGCS-Mingw32 Toolchain, is available from:

-

-	http://www.xraylith.wisc.edu/~khan/software/gnu-win32/egcs-mingw32-102.html	

+		%mesaroot%:	This is your root directory (Mesa-3.3)

+		%mesasrc%:	This is the Mesa-3.3 src directory (Mesa-3.3\src)

+		%mesalib%:	This is where the build will put libGL.a and libGLU.a

 

 Running the Build:

 

-	Ok, now that we've got the basics out of the way, follows is all you need

-to do in order to build the EGCS-Mingw32 version of libMesaGL.a and libMesaGLU.a:

-

-	Open your Command Prompt/Dos prompt.

-	Go to your Mesa-3.0 beta 'root' directory.

-		This is the same directory that the Mesa mingw32.zip file was

-		originally stored in if you've installed the Mesa-3.0 beta 3-D

-		Graphics Library source as outlined in the "readme" file included

-		with the Mesa-3.0 beta distribution.

+	Open your Command Prompt or MS-DOS prompt.

+	Go to your Mesa-3.3 'root' directory

 	At the command line type: mingw32

-		mingw32 is the .bat file that actually does the build.

+

+	That's all there is to it.

 

 	Enjoy!