]> git.mxchange.org Git - flightgear.git/blobdiff - docs-mini/README.Unix
Merge branch 'next' of D:\Git_New\flightgear into next
[flightgear.git] / docs-mini / README.Unix
index 9494facf8d13b426b7a397b1e39f52ae78283aac..b3dfd5beb93de947ac12582e928e01c6274a71b8 100644 (file)
@@ -1,12 +1,12 @@
 If you are reading this in hopes that you will find the answer to a
-specific question, please send the question to curt@flightgear.org and
+specific question, please send the question to http://www.flightgear.org/~curt and
 suggest that I include the answer here.
 
 
 I. Compilers and Portability
 ============================
 
-Flight Gear is known to build with egcs-1.1 and higher, as well as
+FlightGear is known to build with egcs-1.1 and higher, as well as
 gcc-2.8 and higher.  Your mileage may vary with earlier versions of
 these compilers although support for gcc-2.7.x is mostly there.
 
@@ -14,17 +14,24 @@ For other platforms where you may have access to native compilers,
 again your mileage may vary.  We would like to support as many
 different compilers and platforms as possible.  Please relay any
 changes you make (or problems you encounter) back to
-curt@flightgear.org, so that in the future we can better support your
+http://www.flightgear.org/~curt, so that in the future we can better support your
 platform and your compiler.  I have access to a few different
 platforms, but I must depend on others to make sure their favorite
 platform and compiler is well supported.
 
 
-II. GLUT
-========
+II. OpenGL
+==========
 
-Flight Gear requires GLUT version 3.7 or later (aka GameGLUT._ GLUT
-needs to be installed on your system before you can build Flight Gear.
+FlightGear requires accelerated OpenGL drivers to be properly
+installed and configured on your system.
+
+
+III. GLUT
+=========
+
+FlightGear requires GLUT version 3.7 or later (aka GameGLUT._ GLUT
+needs to be installed on your system before you can build FlightGear.
 GLUT can be found at:
 
     http://reality.sgi.com/opengl/glut3/glut3.html
@@ -38,172 +45,13 @@ you can write a single OpenGL program that works on both Win32 PCs and
 X11 workstations.
 
 
-III. Joystick Support
+IV. Joystick Support
 =====================
 
-GLUT only has win32 joystick support but even at that, it is not well
-implimented.  So we use Steve Backer's joystick library when possible,
-and fall back to GLUT for win32 until Steve's library adds win32
-support.
+We use the plib joystick library for joystick support.
 
 To make sure joystick support is included when building under Linux:
 
   - make sure you have the proper joystick module installed.
   - make sure the proper devices are created in /dev.
   - /usr/include/linux/joystick.h must exist on your system.
-
-
-IV. Procedure to build FGFS with Native SGI Irix Compilers from CVS Sources
-===========================================================================
-
-(Contributed by Todd Smith <msmith@sikorsky.com> with modifications
-and updates by Curt Olson)
-
-Download the latest version of plib (1.0.18) from:
-
-    http://www.woodsoup.org/~sbaker/plib/
-
-Configure it with the default prefix of /usr/local which places
-everthing in a tree rooted at /usr/local/plib:
-
-    sh$ CC="cc -Xcpluscomm" CXX=CC ./configure
-
-*Before* running make, fix up the plib Makefiles using the script
-provided with the Flight Gear distribution:
-
-    find . -name Makefile -exec .../src/FlightGear-0.7.x/irix-hack.pl {} \;
-
-This applies a fix in all the Makefiles to the lib creation command
-(to use CC -ar rather than ar) as per a tip in the SGI pipeline
-periodical.
-
-Now, make and install plib.
-
-Download the latest fgfs source snapshot from:
-
-    ftp://ftp.flightgear.org/pub/fgfs/Source/Snapshots/
-
-Configure and build fgfs as you did plib:
-
-    sh$ CC="cc -Xcpluscomm" CXX=CC ./configure
-    sh$ find . -name Makefile -exec .../src/FlightGear-0.7.x/irix-hack.pl {} \;
-
-
-V. Additional Notes for Building from CVS Sources
-==================================================
-
-(Contributed by Todd Smith <msmith@sikorsky.com>)
-and updates by Curt Olson)
-
-Download the FlightGear-0.7.x via anonymous cvs as usual, then do:
-
-> aclocal              # normal
-> automake -a -i       # added '-i' flag to avoid dependency calc
-                       # that only sgi cc/CC doesn't support
-> autoconf             # normal
-
-Note the change in automake's command argument.
-
-Now set env variables to use native compilers (csh syntax).
-
-> setenv CC cc
-> setenv CXX CC
-> setenv CFLAGS '-Xcpluscomm -DEBUG:suppress=1001,1012,1014,
-                            1116,1172,1174,1401,1460,1551,1552'
-> setenv CXXFLAGS '-DEBUG:suppress=1001,1012,1014,1116,1172,
-                          1174,1401,1460,1551,1552,3303,3322'
-
-The '-DEBUG:suppress=' stuff just suppresses anonying warnings during
-compile.  The meaning of each one is shown later in this file.
-You can use all or none of these here.
-
-> setenv CPPFLAGS '-woff 1014'
-
-This is required so that configure will really believe that plib
-is installed.  ( Otherwise a compiler warning makes configure
-that plib/pu.h couldn't be found. )
-
-> ./configure
-> find . -name Makefile -exec irix-hack.pl {} \;       # normal irix hack
-> gmake
-
-Runs great.
-
-Todd
-msmith@sikorsky.com
-
--------------------------------------------
-Warnings that I get. Ignore at your lesiure.
-
-C and C++:
-warning(1001): last line of file ends without a newline
-warning(1012): parsing restarts here after previous syntax error
-warning(1014): extra text after expected end of preprocessing directive                (breaks configure)
-warning(1116): non-void function "poly_index_init" should return a value
-warning(1172): subscript out of range
-warning(1174): variable "j" was declared but never referenced
-warning(1401): qualified name is not allowed in member declaration
-warning(1460): function "..." redeclared "inline" after being called
-warning(1551): variable "Altitude" is used before its value is set
-warning(1552): variable "last" was set but never used
-
-C++ only:
-warning(3303): type qualifier on return type is meaningless
-warning(3322): omission of explicit type is nonstandard ("int" assumed)
-
-
-VI. Additional Native SGI Irix Compilers Notes
-==============================================
-
-Fixing all the Makefiles' with irix-hack.pl is *VERY* important for
-your success):
-
-  find . -name Makefile -exec irix-hack.pl {} \;
-
-This touches up the Makefiles to build libfoo.a with 
-
-  CC -ar -o libfoo.a file1.o file2.o ...
-
-The traditional method is to run:
-
-  ar cru libfoo.a file1.o file2.o
-
-I wonder if this means that the native SGI "ar" is somewhat broke?
-
-Note, you should make sure you have perl installed on your system.  The
-"irix-hack.pl" script assumes that perl is located in /usr/bin/perl so
-if this isn't the proper location on your system, change it in the first
-line of "irix-hack.pl" before running the above command.  One way to see
-if perl is on your system (and determine where) is to run:
-
-  which perl
-
-Perl can be installed from "eoe.sw.gifts_perl" or can be fetched and
-built from the net.
-
-Finally you should run Gnu make.  The native Irix make utility just
-can't handle the makefiles generated by the automake program.  Thus 
-you will need to use Gnu make.  It's called "gmake" on my system so I 
-just run:
-
-  gmake
-
-Don't worry about the make failing in the Tools directory.  That's all
-under construction stuff right now (10/7/99) and if you get that far, 
-rejoice because it means the simulator was successfully built in the 
-Simulator/Main subdirectory.
-
-Special note for those Irix users using the native compilers *AND* checking
-out the current source tree via CVS:
-
-You will need to run "aclocal ; automake -a ; autoconf" as per 
-README.autoconf, but you need an additional flag for automake to disable
-automatic dependency building (which breaks the native Irix compilers.)
-You should instead run:
-
-    aclocal ; automake -a --include-deps; autoconf
-
-Then, proceed on to the configure step.  
-
-Questions?  I realize this section is a big heap of random information so
-if something isn't quite working for you, please ask.