updated for Mesa 3.3
authorBrian Paul <brian.paul@tungstengraphics.com>
Fri, 14 Jan 2000 16:24:56 +0000 (16:24 +0000)
committerBrian Paul <brian.paul@tungstengraphics.com>
Fri, 14 Jan 2000 16:24:56 +0000 (16:24 +0000)
docs/README.MINGW32

index 75709ed43d8996c491182d7819346051b37d8627..44c55aa021c790733346a494f1dda99dfe9b6012 100644 (file)
-August 30, 1998 -- Paul Garceau (pgarceau@teleport.com)\r
+August 30, 1998 -- Paul Garceau\r
+Updated January 13, 2000 -- Paul Garceau (pgarceau@teleport.com)\r
 \r
-DISCLAIMER:  I make this extension to the Mesa 3-D Graphics Library as a service\r
+DISCLAIMER:  I make this port of the Mesa 3-D Graphics Library as a service\r
 to the general public.  I can, in no way support or make any guarantee that the\r
-EGCS-Mingw32 build or any Gnu-Win32 build will work for your system. The\r
-associated packages and batch files I have included as part of the EGCS-Mingw32\r
-extension are provided "As-is" with out any guarantee of support or functionality\r
-from the author of this EGCS-Mingw32 native windows port of the Mesa 3-D Graphics\r
-Library.\r
+build will work for your system.\r
+\r
+       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.\r
 \r
        Feel free to modify or change things as you see fit, just remember that\r
 I can't support any modifications you might want to make to the files which I\r
 have included OR the lgpl protected Mesa 3-D Graphics Library.\r
 \r
+       I recommend using GCC-2.95.2/Mingw32 which is available at Mumit Khans' ftp site:\r
 \r
-       EGCS-Mingw32 Beta 3.08 Archive Manifest:\r
-               mingw32.bat\r
-               src/makefile.nt4\r
-               src/wmesa.c\r
-               src-glu/makefile.nt4\r
-\r
-###############\r
-\r
-Greetings,\r
-\r
-       In order to build the Mingw32 set of Mesa 3-D Graphics Library for Beta3.08\r
-it will be necessary for you to use the Dos or Command Prompt that is available\r
-on most of the i86 based MS Windows machines.  Also, I believe that this build\r
-will run on Win95, Win98, WinNT4 and WinNT5.\r
-\r
-       I haven't tested Win95/98 or WinNT5.  This build was generated under\r
-WinNT4 with SP3 installed.\r
+               (ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/mingw32/)\r
 \r
-       This has not been tested under any systems outside of\r
-a WinNT4 Workstation with EGCS-Mingw32 toolchain, v.1.0.2 installed.\r
+       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.\r
 \r
-       EGCS-Mingw32 uses a variation of gcc to handle its build.  The Mesa 3-D\r
-Graphics Library build that I have generated is based, in small part, on the\r
-Cygwin32 build and associated makefiles that Stephane Rehel (rehel@worldnet.fr)\r
-defined back in 1997.  The EGCS-Mingw32 toolchain is capable of generating\r
-native windows code and, as of the date of this readme, can be obtained from:\r
+       I recommend using the GCC-2.95.2/Mingw32.\r
 \r
-       http://www.xraylith.wisc.edu/~khan/software/gnu-win32/egcs-mingw32-102.html\r
+       ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/mingw32/gcc-2.95.2\r
 \r
        Much thanks to the combined efforts of Mumit Khan, Jan-Jaap Vanderhagen\r
-and Colin Peters for making it possible for the EGCS-Mingw32 toolchain to exist.\r
-\r
-Installing EGCS-Mingw32 Build Revisions:\r
-\r
-       To install the makefile and source revisions incorporated with this build\r
-of the Mesa 3-D Graphics Library, you'll have to use a version of winzip.  I am\r
-in the process of finding a suitable Win32 compatible tar executable so that if\r
-you don't have winzip, you can still decompress the files into their respective\r
-folders/directories.\r
-\r
-       a) Move the mingw32.zip file to the top level of the hard drive on your\r
-system.\r
-\r
-       b) Copy all of the Beta 3.08 src/windows files to the src/ directory.\r
-\r
-       b) Open the Winzip file\r
+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.\r
 \r
-       c) Verify that the files will be properly extracted.\r
+Installing GCC-2.95.2/Mingw32 Build:\r
 \r
-       d) Extract the files with the Winzip "Overwrite" and "Use Folder Names"\r
-          options enabled.\r
+       a) Open the file archive (either tar.gz or .zip extensions)\r
 \r
-       The zip file directory structure extraction defaults to the top level of\r
-the hard drive where the mingw32.zip file exists unless otherwise instructed by\r
-you.\r
+       b) Decide the directory you want to move the archived files to.\r
 \r
-       The version of wmesa.c included with the mingw32 archive needs to replace\r
-the current version of the Beta 3.08 wmesa.c file in order for the egcs-mingw32\r
-build to work.  This is because the original Win32 stuff assumes that the glut\r
-utilities are to be installed.  The Glut utilities are not part of the\r
-egcs-mingw32 build for Beta 3.08.\r
+       d) Extract the files from the archive.\r
+       \r
+       e) Edit the mingw32.bat file to accomodate your choice of directory structure.\r
 \r
-\r
-Build Considerations:\r
-\r
-       In order to get the build to work, I needed to create a special makefile\r
-for each library which the Mesa 3-D Graphics Library requires since there is no\r
-comparable make-config/config on a native windows platform.\r
-\r
-       Since I was only creating a few of the possible libraries for \r
-Mesa (gl, glu), I only created the new make files in their respective libraries\r
-src, src-glu).  For libMesaaux.a. you will find a makefile for it in the\r
-src-aux directory.  libMesatk.a and libglut.a were not ported.\r
-\r
-       The build itself is a .bat based build and uses Gnu Make,Version 3.76.1 to\r
-process the makefiles noted above.  The build must be run from the directory\r
-where the mingw32.bat file is.  You can get the binary version of Make 3.76.1\r
-from Jan-Jaap van der Heijden's site in Germany:\r
-\r
-       http://agnes.dida.physik.uni-essen.de/~janjaap/mingw32/download.html\r
-\r
-       It was necessary to modify some source code, specifically the source code\r
-in the src-glu directory.  I needed to modify nurbs.c, quadric.c and tess.c in\r
-order to get them to work using the EGCS-Mingw32 toolchain.\r
-\r
-       The original EGCS-Mingw32 Toolchain, is available from:\r
-\r
-       http://www.xraylith.wisc.edu/~khan/software/gnu-win32/egcs-mingw32-102.html     \r
+               %mesaroot%:     This is your root directory (Mesa-3.3)\r
+               %mesasrc%:      This is the Mesa-3.3 src directory (Mesa-3.3\src)\r
+               %mesalib%:      This is where the build will put libGL.a and libGLU.a\r
 \r
 Running the Build:\r
 \r
-       Ok, now that we've got the basics out of the way, follows is all you need\r
-to do in order to build the EGCS-Mingw32 version of libMesaGL.a and libMesaGLU.a:\r
-\r
-       Open your Command Prompt/Dos prompt.\r
-       Go to your Mesa-3.0 beta 'root' directory.\r
-               This is the same directory that the Mesa mingw32.zip file was\r
-               originally stored in if you've installed the Mesa-3.0 beta 3-D\r
-               Graphics Library source as outlined in the "readme" file included\r
-               with the Mesa-3.0 beta distribution.\r
+       Open your Command Prompt or MS-DOS prompt.\r
+       Go to your Mesa-3.3 'root' directory\r
        At the command line type: mingw32\r
-               mingw32 is the .bat file that actually does the build.\r
+\r
+       That's all there is to it.\r
 \r
        Enjoy!\r
 \r