Varioius changes and updates to the docs-mini files.
This commit is contained in:
curt
parent
f2bb747bf0
commit
18b5d68d45
6 changed files with 39 additions and 199 deletions
|
|
@ -1,3 +1,12 @@
|
|||
June 29, 2001 Update:
|
||||
|
||||
This information is very old and incomplete. If you have interest in
|
||||
building FlightGear for the Mac, I suggest you contact Darrell
|
||||
Walisser <dwaliss1@purdue.edu> for more information, or post to the
|
||||
flightgear-devel@lists.sf.net mailing list.
|
||||
|
||||
|
||||
|
||||
README.MacOS
|
||||
|
||||
Jan 12, 1999.
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
21 February 2000 - CLO
|
||||
21 February 2001 - CLO
|
||||
|
||||
As of version 0.7.2, FlightGear now requires the SimGear supporting
|
||||
libraries to be installed before configuring and building FlightGear.
|
||||
|
|
@ -6,9 +6,9 @@ You must also have SimGear installed if you build the TerraGear
|
|||
scenery creating tools (TerraGear is not required to run the
|
||||
simulator).
|
||||
|
||||
You can get a copy of SimGear from the same place you get FlightGear:
|
||||
You can get a copy of SimGear from the simgear web page:
|
||||
|
||||
ftp://ftp.flightgear.org/pub/fgfs/Source/
|
||||
http://www.simgear.org
|
||||
|
||||
SimGear build notes:
|
||||
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ 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.
|
||||
|
||||
|
|
@ -20,11 +20,18 @@ 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.
|
||||
|
|
|
|||
|
|
@ -1,10 +0,0 @@
|
|||
Flight Gear now has an anonymous CVS repository. Currently, it is read
|
||||
only, but it will allow you to maintain your own absolutely up to date
|
||||
source tree. You will also be able to do diffs, extract older versions
|
||||
of files, and all the other fancy CVS stuff.
|
||||
|
||||
Instructions for accessing the FG cvs repository can be found by
|
||||
following the "CVS Resources" link from the main FG web page:
|
||||
|
||||
http://www.menet.umn.edu/~curt/fgfs/
|
||||
|
||||
|
|
@ -1,26 +1,18 @@
|
|||
Flight Gear uses the Gnu autoconf and automake tools for managing
|
||||
Makefiles. It also uses libtool to manage building shared and static
|
||||
libraries. Key input files for this system are:
|
||||
Makefiles. Key input files for this system are:
|
||||
|
||||
configure.in - Top level directory
|
||||
Makefile.am - One in each subdirectory
|
||||
Include/config.in - input file for building config.h
|
||||
|
||||
If you need to modify any of these files, you will need to build and
|
||||
install the following packages:
|
||||
If you need to modify any of these files, you will need to install the
|
||||
following packages. If you don't have a prebuilt package for your OS,
|
||||
you can fetch them from the locations listed below:
|
||||
|
||||
- GNU autoconf 2.12 (available from ftp://prep.ai.mit.edu/pub/gnu)
|
||||
- GNU automake 1.2h (available from ftp://ftp.cygnus.com/pub/tromey)
|
||||
- GNU autoconf (available from ftp://prep.ai.mit.edu/pub/gnu)
|
||||
- GNU automake (available from ftp://ftp.cygnus.com/pub/tromey)
|
||||
|
||||
Libtool is not currently used:
|
||||
|
||||
- GNU libtool 1.2 (available from ftp://prep.ai.mit.edu/pub/gnu)
|
||||
(or maybe ftp://alpha.gnu.org/gnu)
|
||||
- After upgrading libtool, if we were using it, you would want to run:
|
||||
|
||||
libtoolize --force
|
||||
|
||||
When making a change to any of these files you will need to run:
|
||||
After making a change to configure.in you will need to run:
|
||||
|
||||
aclocal ; automake -a ; autoconf
|
||||
|
||||
|
|
|
|||
|
|
@ -1,15 +1,16 @@
|
|||
You *must* have the plib version 1.1.x or later installed on your
|
||||
system to build the FGFS simulator!" Special note: Flight Gear is no
|
||||
longer compatible with the 1.0.x versions of plib.
|
||||
You *must* have plib version 1.4.x or later installed on your system
|
||||
to build FlightGear!" Flight Gear is no longer compatible with the
|
||||
earlier versions of the library.
|
||||
|
||||
You can get the latest version of plib from:
|
||||
|
||||
http://www.woodsoup.org/projs/plib/
|
||||
http://plib.sourceforge.net
|
||||
|
||||
Build notes:
|
||||
|
||||
You should be able to just run "./configure" to configure the package
|
||||
and use all of plib's defaults. Then run "make" followed by "make
|
||||
install". By default, plib installs itself into /usr so if you don't
|
||||
like this, be sure to specify an alternate prefix such as --prefix=/usr/local
|
||||
like this, be sure to specify an alternate prefix such as
|
||||
--prefix=/usr/local
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue