From 725877b75103c43cf5a62c1f24348363a6d384d2 Mon Sep 17 00:00:00 2001 From: curt Date: Tue, 14 Apr 1998 02:45:23 +0000 Subject: [PATCH] Initial revision. --- README | 32 ++++++++++++++++ README.Win32 | 100 ++++++++++++++++++++++++++++++++++++++++++++++++ README.autoconf | 22 +++++++++++ README.running | 41 ++++++++++++++++++++ 4 files changed, 195 insertions(+) create mode 100644 README create mode 100644 README.Win32 create mode 100644 README.autoconf create mode 100644 README.running diff --git a/README b/README new file mode 100644 index 000000000..80d26a9ae --- /dev/null +++ b/README @@ -0,0 +1,32 @@ +Welcome to the Flight Gear project. +=================================== + +The primary web page for this project is: + + http://www.menet.umn.edu/~curt/fgfs + +We are overhauling the make system and a lot of things are in a state of +change, so let me know if you see incorrect information in the README's, +extraneous files laying around, or any other anomylous things. The +coordinator of this project is Curt Olson . + +=================================== + +Please see .... for more information on .... + +- Authors & Thanks: List of the authors and contributors. + +- COPYING: Copyright and usage terms and limits. + +- INSTALL: Generic install instructions + +- NEWS: The latest news + +- README: This file + +- README.Win32: Specific Win32 compiling information and instructions + +- README.autoconf: Info on updating the make system (adding new source + files, etc.) + +- README.running: Minimalist info for running the simulator diff --git a/README.Win32 b/README.Win32 new file mode 100644 index 000000000..e82480e14 --- /dev/null +++ b/README.Win32 @@ -0,0 +1,100 @@ +April 8, 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 in + windows explorer. Be sure to read this package's README : + + http://www.cygnus.com/misc/gnu-win32/readme_toc.html + + After installing the cygnus compiler and the usertools you should + find a program group "Cygnus" in your start menu. + +2. 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. + +3. Fetch the Flight Gear code and special Win32 libraries. These can + be found at: + + http://www.menet.umn.edu/~curt/fgfs/Downloads/Source/ + + Grab the latest "FlightGear-X.XX.zip" and "win32-libs-X.XX.zip" + files. + +4. Unpack the FG source code. Run: + + pkunzip -d FlightGear-X.XX.zip + + Be sure to use the -d option. This will create all the needed + subdirectories. Otherwise you will have one big mess! Trust me! + +5. Change to the newly created FlightGear-X.XX directory and unpack + the Win32 libraries. Run: + + cd FlightGear-X.XX + pkunzip -d win32-libs-X.XX.zip + +Side Note: we need to make a distinction between the "build tree" and + the "install tree." The "build tree" is what we've been talking + about up until this point. This is where the source code lives + and all the compiling takes place. Once the executables are + built, they need to be installed someplace. We shall call this + install location the "install tree". This is where the + executables, the scenery, the textures, and any other run-time + files will be located. + +6. Configure the make system for your environment and your "install + tree". Tell the configure script where you would like to install + the exectuables and all the scenery and textures by using the + "--prefix" option. In the following example the base of the + "install tree" is "/FlightGear". Run: + + ./configure --prefix=/FlightGear + +7. Build the executable. Run: + + make + +8. Create and populate the install tree. Run: + + make install + + currently this step fails, but I hope to find a solution soon. + You can probably install everything by hand for now ... for example: + + cp Simulator/Main/fg.exe /FlightGear/bin/fg.exe + cp Simulator/Main/runfg.bat /FlightGear/bin/runfg.bat + +Important Note: so far you've built and installed the simulator and + related tools. Before you can actually try it out, you need to + make sure you have the appropriate scenery and texture downloaded + and unzip'ed in your "install tree". + +9. Download and install the scenery and texture files. + +10. Set the runtime environment variable to point to the base of your + "install tree". Run: + + export FG_ROOT=/FlightGear + +11. Try it out! There are several ways to run flight gear once it has + been installed. The simplest is as follows. Run: + + /FlightGear/bin/runfg.bat + +12. I appreciate feedback. Tell me if it works! If it doesn't, tell me + what went wrong. My email is curt@me.umn.edu diff --git a/README.autoconf b/README.autoconf new file mode 100644 index 000000000..40a0fc615 --- /dev/null +++ b/README.autoconf @@ -0,0 +1,22 @@ +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: + + configure.in - Top level directory + Makefile.am - One in each subdirectory + Simulator/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: + + - 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 libtool 1.0c (available from ftp://prep.ai.mit.edu/pub/gnu) + +When making a change to any of these files you will need to run: + + aclocal ; automake -a ; autoconf + +Then follow the regular build procedure: + + ./configure; make; make install diff --git a/README.running b/README.running new file mode 100644 index 000000000..00cb85f04 --- /dev/null +++ b/README.running @@ -0,0 +1,41 @@ +Starting the executable +======================= + +Unix: runfg +Windows: runfg.bat + +"runfg" is a script which sets the FG_ROOT and LD_LIBRARY_PATH +environment variables, then runs the Flight Gear executable. + + +Keyboard controls +================= + +Flying is mainly done via the numeric keypad. There is some +unresolved wierdness with the GLUT libraries and keyboard input, so +for now, the state of the "Num Lock" key is important. + +Num Lock Active +--------------- + + Pg Up/Pg Dn Throttle + Left Arrow/Right Arrow Aileron + Up Arrow/Down Arrow Elevator + Ins/Del Rudder + "5" Center aileron/elevator/rudder + Home/End Elevator Trim + +Num Lock Inactive +----------------- + Shift + Change view + + where key is one of: + + 8 = forward + 7 = left/forward + 4 = left + 1 = left/back + 2 = back + 3 = right/back + 6 = right + 9 = right/forward \ No newline at end of file -- 2.39.5