From ecc88c1e1cad4a5ac933fd085237f54cff62d2d4 Mon Sep 17 00:00:00 2001 From: Brian Paul Date: Tue, 23 Feb 1999 03:41:13 +0000 Subject: initial rev --- docs/README.MINGW32 | 123 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 123 insertions(+) create mode 100644 docs/README.MINGW32 (limited to 'docs/README.MINGW32') diff --git a/docs/README.MINGW32 b/docs/README.MINGW32 new file mode 100644 index 0000000000..75709ed43d --- /dev/null +++ b/docs/README.MINGW32 @@ -0,0 +1,123 @@ +August 30, 1998 -- Paul Garceau (pgarceau@teleport.com) + +DISCLAIMER: I make this extension to 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. + + 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. + + + 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. + + This has not been tested under any systems outside of +a WinNT4 Workstation with EGCS-Mingw32 toolchain, v.1.0.2 installed. + + 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: + + http://www.xraylith.wisc.edu/~khan/software/gnu-win32/egcs-mingw32-102.html + + 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 + + c) Verify that the files will be properly extracted. + + d) Extract the files with the Winzip "Overwrite" and "Use Folder Names" + options enabled. + + 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. + + 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. + + +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 + +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. + At the command line type: mingw32 + mingw32 is the .bat file that actually does the build. + + Enjoy! + + Peace, + + Paul G. (pgarceau@teleport.com) \ No newline at end of file -- cgit v1.2.3