March 15, 1998
=============

Here is a quick outline of *one* way you can build FG for Win32 using
a completely free development environment.

1.  Install and configure the Cygnus Gnu-Win32 development
    environment. The latest version is Beta 19. The main 
    Cygnus Gnu-Win32 page is at: 

        http://www.cygnus.com/misc/gnu-win32/

    You can download the Cygnus Gnu-Win32 compiler from:

        ftp://ftp.cygnus.com/pub/gnu-win32/latest/cdk.exe

    To install, just run the file: "cdk.exe" by double-clicking on it
    from windows explorer.  Be sure to read this package's README:

        http://www.cygnus.com/misc/gnu-win32/readme_toc.html

    and install them as well. After installing the cygnus compiler
    and the usertools you should find a program group "Gygnus" 
    in your start menu.


2.  Fetch the Flight Gear source code and win32 libs.  They can be
    found at:

        http://www.menet.umn.edu/~curt/fgfs/Downloads/

    Grab the latest source-X.XX.zip file.

    In addition, you need the win32 libraries from win32-libs-X.XX.zip

    Also, don't forget to download scenery and textures.  These aren't
    needed to built the code, but you'll need them before you can run
    the executable.

3.  Unpack the FG prototype code and the libraries.  Run:

        pkunzip -d <file>.zip

    Be sure to use the -d option.  This will create all the needed
    subdirectories.  Otherwise you will have one big mess!

    This should create a directory called ``FlightGear'' with several
    subdirectories. Do the same with the libraries.


4.  The win32-libs zip file provides the necessary OpenGL/GLUT headers
    and libraries for the build process.

    Before trying to run the executable, you should copy glut.dll from

        ...\FlightGear\Win32\glut.dll

    into someplace in your path such as:
   
        ...\FlightGear\Src\Main\glut.dll


5.  Install the Silicon Graphics OpenGL dynamic link libraries. For
    this purpose, get the file sgi-opengl2.exe from the flight gear
    project site.  This is a win95/winnt self extracting installation 
    program.  Install it by double-clicking in windows explorer.


6.  Edit the ``commondefs'' file, if necessary.  Go to the main
    FlightGear source directory.  From where ever you extracted the FG
    code, cd to ``FlightGear\Src''.  Edit the file called
    ``commondefs''.  Find the part of the file that says: ``Uncomment
    one of the following sections depending on your system''

    Uncomment all the makefile defines in the ``Cygnus Win32 beta19''
    section.  Also, you should comment out any of the defines in the
    other platform dependent sections. Depending on the version,
    you may find, that the appropriate settings are already done
    and you can skip this step.


7.  Prepare the shell.  Call the Cygnus shell from the start menu.
    At first, you have to mount your flight gear drive (assuming it is g:) 
    with 

    mount g:/ /mnt

    (Be careful writing slashes; you are working within a strange mixture 
    of DOS/WIN95/UNIX here.)

    If anything went wrong with mounting you can unmount the drive with
    mount --reset.

    Now change to the flight gear source directory with

    cd /mnt/FlightGear/Src    

    (make sure you're correct with the "pwd" command)


    Next, you have to set the environment variables as:

    SET FG_ROOT=/mnt/FlightGear
    SET FG_ROOT_SRC=${FG_ROOT}/Src
    SET FG_ROOT_LIB=${FG_ROOT}/Lib


8.  Build the executable. Type first

    make depend

    and after that's done type

    make

    You will see a few warning messages from the compiler, but none of
    these are serious.  

    Be prepared flight gear to need 10 minutes or more for compilation
    (depending of your system).


9.  Try it out!  When make is done close the Cygnus shell. There are several
    possibilities running flight gear. The one which should always work
    is as follows:

    Open an ordinary DOS shell. Within this one reset the flight gear root 
    environment variable to  

    SET FG_ROOT=g:\flightgear

    (or whatever your drive is.) This is absolutely necessary as win95
    does not recover your "mounted" drive.

    Goto the directory where your freshly build executable sits, i.e.

    cd g:\flightgear\src\main
  
    and type fg0.exe.


10. Tell me that it works! If it doesn't, tell me what goes wrong.  My
    email is curt@me.umn.edu.  Please send me email and let me know
    what changes need to be made to this document and these procedures
    to make them easier to understand and follow.