README.Unix

   1 *** not much here yet ***
   2
   3 If you are reading this in hopes that you will find the answer to a
   4 specific question, please send the question to curt@me.umn.edu and
   5 suggest that I include the answer here.
   6
   7
   8 Compilers and Portability
   9 =========================
  10
  11 Flight Gear is known to build with egcs-1.1 and higher, as well as
  12 gcc-2.8 and higher.  Your mileage may vary with earlier versions of
  13 these compilers although support for gcc-2.7.x is mostly there.
  14
  15 For other platforms where you may have access to native compilers,
  16 again your mileage may vary.  We would like to support as many
  17 different compilers and platforms as possible.  Please relay any
  18 changes you make (or problems you encounter) back to
  19 curt@flightgear.org, so that in the future we can better support your
  20 platform and your compiler.  I have access to a few different
  21 platforms, but I must depend on others to make sure their favorite
  22 platform and compiler is well supported.
  23
  24
  25 GLUT
  26 ====
  27
  28 Flight Gear requires GLUT version 3.7 or later (aka GameGLUT._ GLUT
  29 needs to be installed on your system before you can build Flight Gear.
  30 GLUT can be found at:
  31
  32     http://reality.sgi.com/opengl/glut3/glut3.html
  33
  34 GLUT (pronounced like the glut in gluttony) is the OpenGL Utility
  35 Toolkit, a window system independent toolkit for writing OpenGL
  36 programs. It implements a simple windowing application programming
  37 interface (API) for OpenGL. GLUT makes it considerably easier to learn
  38 about and explore OpenGL programming.  GLUT provides a portable API so
  39 you can write a single OpenGL program that works on both Win32 PCs and
  40 X11 workstations.
  41
  42
  43 Joystick Support
  44 ================
  45
  46 GLUT only has win32 joystick support but even at that, it is not well
  47 implimented.  So we use Steve Backer's joystick library when possible,
  48 and fall back to GLUT for win32 until Steve's library adds win32
  49 support.
  50
  51 To make sure joystick support is included when building under Linux:
  52
  53   - make sure you have the proper joystick module installed.
  54   - make sure the proper devices are created in /dev.
  55   - /usr/include/linux/joystick.h must exist on your system.
  56
  57
  58 Native SGI Irix Compilers
  59 =========================
  60
  61 If you are building with native SGI compilers try running configure like the
  62 following (assuming sh syntax):
  63
  64   CC=cc CXX=CC CFLAGS=-Xcpluscomm ./configure
  65
  66 Then (and this step is *VERY* important for your success) run the following
  67 command:
  68
  69   find . -name Makefile -exec irix-hack.pl {} \;
  70
  71 This touches up the Makefiles to build libfoo.a with
  72
  73   CC -ar -o libfoo.a file1.o file2.o ...
  74
  75 The traditional method is to run:
  76
  77   ar cru libfoo.a file1.o file2.o
  78
  79 I wonder if this means that the native SGI "ar" is somewhat broke?
  80
  81 Note, you should make sure you have perl installed on your system.  The
  82 "irix-hack.pl" script assumes that perl is located in /usr/bin/perl so
  83 if this isn't the proper location on your system, change it in the first
  84 line of "irix-hack.pl" before running the above command.  One way to see
  85 if perl is on your system (and determine where) is to run:
  86
  87   which perl
  88
  89 Perl can be installed from "eoe.sw.gifts_perl" or can be fetched and
  90 built from the net.
  91
  92 Finally you should run Gnu make.  The native Irix make utility just
  93 can't handle the makefiles generated by the automake program.  Thus
  94 you will need to use Gnu make.  It's called "gmake" on my system so I
  95 just run:
  96
  97   gmake
  98
  99 Don't worry about the make failing in the Tools directory.  That's all
 100 under construction stuff right now (3/9/99) and if you get that far,
 101 rejoice because it means the simulator was successfully built in the
 102 Simulator/Main subdirectory.