home *** CD-ROM | disk | FTP | other *** search
/ Programming Win32 Under the API / ProgrammingWin32UnderTheApiPatVillani.iso / INSTALL < prev    next >
Text File  |  2000-01-26  |  5KB  |  114 lines
  1. GCC-2.95.2 for Mingw -- Installation instructions
  2. =================================================
  3.  
  4. 1. Choose what packages to download:
  5.  
  6.   MANDATORY: Must choose one of the following:
  7.  
  8.   a. gcc-2.95.2-crtdll.exe ........  C/C++/F77/ObjC compilers (CRTDLL)
  9.   b. gcc-2.95.2-msvcrt.exe ........  C/C++/F77/ObjC compilers (MSVCRT)
  10.  
  11.   You must download either (a) or (b); (a) uses CRTDLL runtime, whereas
  12.   (b) uses MSVCRT runtime. All Win9x/NT systems come with CRTDLL, and 
  13.   all Win9x/NT systems except perhaps the first edition of Win9x systems 
  14.   come with MSVCRT as well. Until now, CRTDLL runtime version was the one
  15.   commonly known as Mingw32, and the MSCVCRT was provided as an add-on.
  16.  
  17.   You can install both of course, but do so in different directories. Also
  18.   contains GDB 4.18 and MAKE 3.77.
  19.  
  20.   OPTIONAL: Documentation packages are optional, but I highly recommend
  21.   it.
  22.  
  23.   c. mingw32-docs-html.exe ........  Docs in HTML format.  Contains GCC
  24.                                      2.95.2, Binutils 2.9.4, GDB 4.18 and
  25.                      Make 3.77 docs.
  26.  
  27. 1. Get the mandatory package first.
  28.  
  29.   (1) If you're on a fast link, just get the following files:
  30.  
  31.       - gcc-2.95.2-crtdll.exe or gcc-2.95.2-msvcrt.exe 
  32.  
  33.   (2) For slower links, get the split files from "split" directory.
  34.  
  35.       - gcc-2.95.2-crtdll.exe.* or gcc-2.95.2-msvcrt.exe.*
  36.   
  37.   once you have all the gcc-2.95.2.* files, you can combine them
  38.   using the crtdll-combine.bat or msvcrt-combine.bat file provided 
  39.   in the "split" directory, which will create a gcc-2.95.2-crtdll.exe 
  40.   or gcc-2.95.2-msvcrt.exe file.
  41.  
  42.   I recommend you get the HTML documentation package as well.
  43.   
  44. 2. Pre-installation:
  45.  
  46.   a. Decide where to install it. I usually install in "C:\GCC-2.95.2", but
  47.      you can install *anywhere* you want, including on a ZIP/JAZ drive.
  48.      All you have to do is to set PATH and optionally GCC_EXEC_PREFIX 
  49.      accordingly (see later). From here on, I'll use "C:\GCC-2.95.2" as 
  50.      the installation root directory. Please replace with whatever you've 
  51.      chosen. You can use the sample "MINGW32.BAT" I've provided in the 
  52.      distribution to setup the variables. This version should be OK
  53.      if you install to a directory with spaces in it, but I don't
  54.      recommend it.
  55.  
  56.      If you choose to install both CRTDLL and MSVCRT versions, please pick
  57.      different directories (eg., C:\GCC-2.95.2-CRTDLL for the CRTDLL version
  58.      and C:\GCC-2.95.2-MSVCRT for the MSVCRT version).
  59.   
  60.   b. Make sure you DO NOT install on top of an existing installation.
  61.      Either install elsewhere, or delete the old directory structure first.
  62.   
  63. 3. INSTALL:
  64.    
  65.    To avoid the issue of having the "correct" unzip program, I have 
  66.    decided to use self-extracting executables instead of ZIP files.
  67.  
  68.    Run the gcc-2.95.2-crtdll.exe or gcc-2.95.2-msvcrt.exe file, and
  69.    type in where you want it to be installed (Step 2a.).
  70.  
  71.    Note that if you retrieved the "split" files, then you will have to
  72.    recombine them before you try to run. You can use the DOS COPY trick
  73.    to recombine, or use the CRTDLL-COMBINE.BAT (or MSVCRT-COMBINE.BAT) in 
  74.    the "split" dirctory.
  75.  
  76. 4. Setting up environment variables and such:
  77.    
  78.    This version of GCC does not require *any* environment variable to run 
  79.    properly. You can still set GCC_EXEC_PREFIX if you wish (useful for 
  80.    example to switch between multiple GCC distributions), but it's 
  81.    completely optional. GCC now looks for the system includes, libraries, 
  82.    programs, etc relative to its installation directory. 
  83.  
  84.    You'll still need to add the GCC-2.95.2 bin directory, eg.
  85.    C:\GCC-2.95.2\bin, to your PATH for GCC to be able to find various 
  86.    other tools such the linker, assembler, etc.
  87.  
  88.    The following is all you need for this release:
  89.      
  90.      C:\> PATH=C:\GCC-2.95.2\BIN;%PATH%
  91.     
  92.    Again, see the supplied MINGW32.BAT file. Those of you who use a Unix
  93.    like SHELL such as bash, use "mingw32.sh" instead. 
  94.  
  95.    Make sure you do not have any other variables set from previous version
  96.    or else GCC will search incorrect places for libraries and headers. The
  97.    ones that you DO NOT need anymore are: LIBRARY_PATH, C_INCLUDE_PATH,
  98.    CPLUS_INCLUDE_PATH, and OBJC_INCLUDE_PATH. If you *DO* have the variable
  99.    GCC_EXEC_PREFIX in your environment, just make sure it's set correctly.
  100.  
  101. 5. INSTALL GCC-2.95.2 OPTIONAL packages following exactly the same steps.
  102.  
  103. Good luck.
  104.  
  105. Links:
  106.  
  107. GNU Compilers    : http://gcc.gnu.org/
  108. Cygwin site      : http://sourceware.cygnus.com/cygwin/
  109. My stuff         : http://www.xraylith.wisc.edu/~khan/software/gnu-win32/
  110.  
  111. Mumit Khan -- khan@xraylith.wisc.edu
  112. http://www.xraylith.wisc.edu/~khan/
  113.  
  114.