Update README.compiling-linux.txt

Edited format, wiki website link, and part of troubleshooting,
This commit is contained in:
hkl123 2016-10-01 00:08:42 -04:00 committed by GitHub
parent 82b263e336
commit 8ee60a7e00
1 changed files with 38 additions and 48 deletions

View File

@ -5,20 +5,16 @@
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Build instructions for Linux Build instructions for Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Architecture ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. Architecture
Developed on Linux with glibc, little endian CPU. While MacIntel builds exist Developed on Linux with glibc, little endian CPU. While MacIntel builds exist
(for some versions of the game), MegaGlest does not currently work on big (for some versions of the game), MegaGlest does not currently work on big
endian CPUs like PPC (though some unfinished patches for vanilla Glest float endian CPUs like PPC (though some unfinished patches for vanilla Glest float
around on the forums, e.g. http://forum.megaglest.org/?topic=1426#). around on the forums, e.g. http://forum.megaglest.org/?topic=1426#).
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~ 2. Building and Installation ~~~~~~~~~~~~~~~~~~~~~~~~~~~
2. Building and Installation --- 2.1 Prerequesites ---
2.1 Prerequesites
The game depends on some tools and libraries to be present, before you can The game depends on some tools and libraries to be present, before you can
start compiling it: start compiling it:
@ -87,8 +83,7 @@ also have the ...-dev(el) packages installed that some distributions provide.
At this point we would like to thank all the authors of these helpful libraries At this point we would like to thank all the authors of these helpful libraries
who made our development easy and straight forward. who made our development easy and straight forward.
--- 2.2 Building ---
2.2 Building
To build the game simply invoke the build script: To build the game simply invoke the build script:
@ -97,7 +92,7 @@ To build the game simply invoke the build script:
This script manually calls cmake with some optional parameters. Feel free to This script manually calls cmake with some optional parameters. Feel free to
examine it and build manually using cmake. examine it and build manually using cmake.
2.3 Installation --- 2.3 Installation --
We provide MojoSetup based installers for Linux and NSIS based installers for We provide MojoSetup based installers for Linux and NSIS based installers for
Windows. By default, the Linux installers install to your home directory. The Windows. By default, the Linux installers install to your home directory. The
@ -107,30 +102,30 @@ There are also community maintained packages available for several Linux and
BSD distributions. Please see the website, forums and wiki for details. BSD distributions. Please see the website, forums and wiki for details.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~ 3. Troubleshooting ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3. Troubleshooting --- In General ---
Some hints for troubleshooting.
In General:
* Make sure both hard- and software of your system match the requirements * Make sure both hard- and software of your system match the requirements
* Sound is played through OpenAL - you might need to take a look at your * If you cannot find what you are looking for on here please check the FAQs
configuration: http://supertux.lethargik.org/wiki/OpenAL_Configuration (https://docs.megaglest.org/MG/FAQ) before contacting.
Compiling: --- Compiling ---
* If CMake fails make sure you have read all of section 2.1 above. * If CMake fails make sure you have read all of section 2.1 above.
Sound/Audio errors when starting: --- Sound/Audio errors when starting ---
* If the game doesn't start because of audio/sound errors: * If the game doesn't start because of audio/sound errors:
Make sure no other application is using your soundcard. Typical problems are Make sure no other application is using your soundcard. Typical problems are
the Gnome/KDE sound dameons esd and artsd. You can kill these daemons with the Gnome/KDE sound dameons esd and artsd. You can kill these daemons with
killall esd ; killall artsd killall esd ; killall artsd
* If this doesn't solve your sound problems try to get an updated OpenAL from * If this doesn't solve your sound problems try to get an updated OpenAL from
http://openal.org or a newer repository provided by your distribution. http://openal.org or a newer repository provided by your distribution.
The game complains about OpenGL 1.3 not available, is missing OpenGL extensions * Sound is played through OpenAL - you might need to take a look at your
or works very slowly: configuration: http://supertux.lethargik.org/wiki/OpenAL_Configuration
--- The game complains about OpenGL 1.3 not available, is missing OpenGL extensions
or works very slowly ---
* Look at glxinfo and make sure the system is using the drivers you want to * Look at glxinfo and make sure the system is using the drivers you want to
use. If you have a NVIDIA or AMD/ATI graphics card then consider using the use. If you have a NVIDIA or AMD/ATI graphics card then consider using the
proprietary drivers (where available), which usually provide much better proprietary drivers (where available), which usually provide much better
@ -140,50 +135,45 @@ or works very slowly:
graphics cards produced during the past few years. The same holds true for graphics cards produced during the past few years. The same holds true for
AMD APUs, the graphics chips embedded into AMD processors. AMD APUs, the graphics chips embedded into AMD processors.
The game crashes: --- The game crashes ---
* Check the forums at http://forums.megaglest.org/ * Check the forums at http://forums.megaglest.org/
* It would be nice if you could report any crashes and freezes that are not yet * It would be nice if you could report any crashes and freezes that are not yet
described on the forums, preferably with a gdb backtrace from a debugging described on the forums, preferably with a gdb backtrace from a debugging
enabled build (cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo) enabled build (cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~ 4. More information ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
4. More information
* Website * Website
http://megaglest.org/ http://megaglest.org/
* Wiki * Wiki
http://wiki.megaglest.org/ https://docs.megaglest.org/Main_Page
* Forums * Forums
http://forum.megaglest.org/ http://forums.megaglest.org/
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 5. Contact + Credits ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* MegaGlest is developed by:
Titus Tscharntke (info@titusgames.de)
Mark Vejvoda (www.soft-haus.com - mark_vejvoda@hotmail.com)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * General contact:
contact@megaglest.org
5. Contact + Credits * MegaGlest is a fork of Glest:
http://glest.org/
MegaGlest is developed by: * Linux port by:
Titus Tscharntke (info@titusgames.de) Matthias Braun
Mark Vejvoda (www.soft-haus.com - mark_vejvoda@hotmail.com) <matze@braunis.de>
General contact: with help from
contact@megaglest.org
Karl Robillard
Website: <krobbillard@san.rr.com>
http://megaglest.org
MegaGlest is a fork of Glest:
http://glest.org/
Linux port by:
Matthias Braun <matze@braunis.de> with help from Karl Robillard
<krobbillard@san.rr.com>
Please also refer to the copyright file.
*** Please also refer to the copyright file. ***
On Debian GNU/Linux systems please find license information in: On Debian GNU/Linux systems please find license information in:
/usr/share/common-licenses /usr/share/common-licenses