From: Ingo Ruhnke Date: Sat, 16 Aug 2014 19:47:14 +0000 (+0200) Subject: Improved markdown syntax so it's more readable on command line, fixes #1057 X-Git-Url: https://git.verplant.org/?a=commitdiff_plain;h=b641d017d8b587658cc1fee1274025e87424da3a;p=supertux.git Improved markdown syntax so it's more readable on command line, fixes #1057 --- diff --git a/INSTALL.md b/INSTALL.md index 816925469..8c61be11b 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -1,52 +1,124 @@ -#Install instructions for SuperTux - +Install instructions for SuperTux - +==================================================================== Last update: December 20, 2007 by Christoph Sommer -##Binaries -We try to provide precompiled binaries of SuperTux for a number of platforms. You should check for the packages and instructions on how to install them. If there are no prebuilt binaries for your platform, then you might still be able to compile the source code yourself. In this case read the next sections. +Binaries +-------- -##Requirements -To build SuperTux from source, you need to have a number of tools and libraries installed. Note that most of these things should already be available prepackaged and optimized for your distribution, it is recommended that you check your distribution first before downloading from the websites. You can also check for up-to-date build instructions for a variety of different platforms and distributions. +We try to provide precompiled binaries of SuperTux for a number of +platforms. You should check +for the packages and instructions on how to install them. If there are +no prebuilt binaries for your platform, then you might still be able +to compile the source code yourself. In this case read the next +sections. + + +Requirements +------------ + +To build SuperTux from source, you need to have a number of tools and +libraries installed. Note that most of these things should already be +available prepackaged and optimized for your distribution, it is +recommended that you check your distribution first before downloading +from the websites. You can also check + for up-to-date +build instructions for a variety of different platforms and +distributions. * Linux development tools (your distribution should come with these): - - gcc compiler suite version 3.2 or newer (you need the c++ compiler g++) + - gcc compiler suite version 3.2 or newer (you need the c++ compiler + g++) - gnu binutils - a shell and POSIX commandline tools -* CMake 2.6 or later: [Download](http://www.cmake.org/HTML/Download.html); [Homepage](http://www.cmake.org/) - * OpenGL headers and libraries: OpenGL libraries and headers are specific to your graphics card. Make sure that you have hardware accelerated OpenGL drivers installed. Software renderers like Mesa will make SuperTux unplayable slow. -* SDL 1.2.5 or later (1.2.8 is recommended on Mac OS X) -* SDL_image (any version that includes PNG and JPEG support) +* CMake 2.6 or later: + [Download](http://www.cmake.org/HTML/Download.html); + [Homepage](http://www.cmake.org/) +* OpenGL headers and libraries: OpenGL libraries and headers are + specific to your graphics card. Make sure that you have hardware + accelerated OpenGL drivers installed. Software renderers like Mesa + will make SuperTux unplayable slow. +* SDL 1.2.5 or later (1.2.8 is recommended on Mac OS X) + +* SDL_image (any version that includes PNG and JPEG support) + * PhysicsFS (1.0.x or 2.0.x) -* OpenAL: There are no official Linux releases of OpenAL yet, you should grab the latest CVS snapshot (any snapshot from 2005 should work, earlier snapshots tend to have bugs). OpenAL 1.0 or later implementations on other systems like Mac OS X or windows should work. +* OpenAL: There are no official Linux releases of OpenAL yet, you + should grab the latest CVS snapshot (any snapshot from 2005 should + work, earlier snapshots tend to have bugs). OpenAL 1.0 or later + implementations on other systems like Mac OS X or windows should + work. * GLEW * Boost's smart_ptr and format headers -Note: We tried to write our code clean, portable and platform neutral, so it should be possible to compile it on a wide range of platforms and also with other compilers than gcc. However we have no resources to test other setups and it is likely that you hit small problems. Reports and binary compiled packages are of course always welcome. Send them to supertux-devel@lists.lethargik.org +Note: We tried to write our code clean, portable and platform neutral, +so it should be possible to compile it on a wide range of platforms +and also with other compilers than gcc. However we have no resources +to test other setups and it is likely that you hit small problems. +Reports and binary compiled packages are of course always welcome. +Send them to supertux-devel@lists.lethargik.org + + +Installing under Linux/UNIX using CMake +--------------------------------------- + +SuperTux uses CMake to generate a set of Makefiles for the build +process. To generate these Makefiles and build SuperTux, perform the +following steps: + +1. `cd' to the directory where you unpacked the SuperTux source + archive, i.e. to the directory containing `src' and `data'. -##Installing under Linux/UNIX using CMake -SuperTux uses CMake to generate a set of Makefiles for the build process. To generate these Makefiles and build SuperTux, perform the following steps: +2. Create and change to a new, empty build directory by running `mkdir + build', `cd build'. + +3. Run `cmake ..' to create the Makefiles needed to build SuperTux + with standard options. If you are missing any libraries needed to + build SuperTux, install those first, then try running CMake again. + See below for instructions on how to change to standard options. -1. `cd' to the directory where you unpacked the SuperTux source archive, i.e. to the directory containing `src' and `data'. -2. Create and change to a new, empty build directory by running `mkdir build', `cd build'. -3. Run `cmake ..' to create the Makefiles needed to build SuperTux with standard options. If you are missing any libraries needed to build SuperTux, install those first, then try running CMake again. See below for instructions on how to change to standard options. 4. Type `make' to start the build process. -5. Type `make install' to install the programs and any data files and documentation. (You should be a root user on Linux systems. You can become a root user with the `su' command or by using `sudo make install') Note that there is no uninstall target, so you might wish to create a package or other system-specific installation instead. + +5. Type `make install' to install the programs and any data files and + documentation. (You should be a root user on Linux systems. You can + become a root user with the `su' command or by using `sudo make + install') Note that there is no uninstall target, so you might wish + to create a package or other system-specific installation instead. + 6. The game should work now and you can remove the source directory. -You can customize the build process by setting additional options for CMake. The easiest way to do this is to use run `ccmake ..' instead of `cmake ..' to bring up the curses-based user interface of CMake. Select an option using the arrow keys, change the selected option by pressing the Enter key, then hit the `c' (repeatedly, if necessary) to apply your changes and bring up new options resulting from your newly set ones. When you are done, press the `g' key to generate a new set of Makefiles and exit. +You can customize the build process by setting additional options for +CMake. The easiest way to do this is to use run `ccmake ..` instead of +`cmake ..` to bring up the curses-based user interface of CMake. +Select an option using the arrow keys, change the selected option by +pressing the Enter key, then hit the `c` (repeatedly, if necessary) to +apply your changes and bring up new options resulting from your newly +set ones. When you are done, press the `g` key to generate a new set +of Makefiles and exit. + +Alternatively, you can pass options to `cmake ..' via the command +line. Some common command line switches are: + +`-DCMAKE_VERBOSE_MAKEFILE=ON` +: Generates Makefiles that print all commands prior to executing them. + +`-Dxxx_LIBRARY=/path/to/library.so -Dxxx_INCLUDE_DIR=/path/to/headerfiles` +: Manually specify the installation directory of a library. + +`-DCMAKE_BUILD_TYPE=DEBUG` +: Enables debug mode and compiles extra debug symbols into the SuperTux +executable. This is useful when sending in bug reports to the +developers. + +`-DCMAKE_BUILD_TYPE=RELEASE` +: Enables release mode and compiles some sanity checks out of the build. -Alternatively, you can pass options to `cmake ..' via the command line. -Some common command line switches are: +Note for GIT users: SuperTux does not need to be installed on the +system, you can run it from its own directory. -Switch | Fuction --------|-------- --DCMAKE_VERBOSE_MAKEFILE=ON | Generates Makefiles that print all commands prior to executing them. --Dxxx_LIBRARY=/path/to/library.so -Dxxx_INCLUDE_DIR=/path/to/headerfiles | Manually specify the installation directory of a library. --DCMAKE_BUILD_TYPE=DEBUG | Enables debug mode and compiles extra debug symbols into the SuperTux executable. This is useful when sending in bug reports to the developers. --DCMAKE_BUILD_TYPE=RELEASE | Enables release mode and compiles some sanity checks out of the build. -Note for GIT users: - SuperTux does not need to be installed on the system, you can run it from - its own directory. +Support +------- -##Support -You can contact us at [supertux-devel@lists.lethargik.org](mailto:supertux-devel@lists.lethargik.org) and in the [#supertux](irc://chat.freenode.net/supertux) channel on the chat.freenode.net IRC server. +You can contact us at [supertux-devel@lists.lethargik.org](mailto:supertux-devel@lists.lethargik.org) +and in the [#supertux](irc://chat.freenode.net/supertux) channel on +the chat.freenode.net IRC server. diff --git a/README.md b/README.md index 88418404a..e4b08f1f9 100644 --- a/README.md +++ b/README.md @@ -1,104 +1,133 @@ -#SuperTux - +SuperTux - +=========================================== Last update: February 26, 2010 -##Description - SuperTux is a jump'n'run game with strong inspiration from the - Super Mario Bros. games for the various Nintendo platforms. +Description +----------- - Run and jump through multiple worlds, fighting off enemies by jumping - on them, bumping them from below or tossing objects at them, grabbing - power-ups and other stuff on the way. +SuperTux is a jump'n'run game with strong inspiration from the +Super Mario Bros. games for the various Nintendo platforms. +Run and jump through multiple worlds, fighting off enemies by jumping +on them, bumping them from below or tossing objects at them, grabbing +power-ups and other stuff on the way. -##Story -####Penny gets captured! +Story: Penny gets captured! +--------------------------- -Tux and Penny were out having a nice picnic on the ice fields of Antarctica. -Suddenly, a creature jumped from behind an ice bush, there was a flash, and -Tux fell asleep! -When Tux wakes up, he finds that Penny is missing. Where she lay before now -lies a letter. "Tux, my arch enemy!" says the letter. "I have captured your -beautiful Penny and have taken her to my fortress. The path to my fortress -is littered with my minions. Give up on the thought of trying to reclaim -her, you haven't a chance! -Nolok" -Tux looks and sees Nolok's fortress in the distance. Determined to save his -beloved Penny, he begins his journey. +Tux and Penny were out having a nice picnic on the ice fields of +Antarctica. Suddenly, a creature jumped from behind an ice bush, there +was a flash, and Tux fell asleep! +When Tux wakes up, he finds that Penny is missing. Where she lay +before now lies a letter. "Tux, my arch enemy!" says the letter. "I +have captured your beautiful Penny and have taken her to my fortress. +The path to my fortress is littered with my minions. Give up on the +thought of trying to reclaim her, you haven't a chance! -Nolok" -##Documentation +Tux looks and sees Nolok's fortress in the distance. Determined to +save his beloved Penny, he begins his journey. + + +Documentation +------------- Important documentation for SuperTux is contained in multiple files. Please see them: -File Name | Content -------------- | ------------- -`INSTALL.md` | Requirements, compiling and installing. -`README.md` | This file -`WHATSNEW.txt` | Changes since the previous versions of SuperTux. -`COPYING` | The GNU General Public License, under whose terms SuperTux is licensed. (Most of the data subdirectory is also licensed under CC-by-SA) -`docs/levelguidelines.txt` | Very useful information for those that want to design levels for SuperTux. -`data/credits.txt` | Credits for people that contributed to the creationof SuperTux. (You can view these in the game menuas well.) -`data/README` | Licensing information about the data. +`INSTALL.md` +: Requirements, compiling and installing. + +`README.md` +: This file + +`WHATSNEW.txt` +: Changes since the previous versions of SuperTux. + +`COPYING` +: The GNU General Public License, under whose terms SuperTux is +licensed. (Most of the data subdirectory is also licensed under +CC-by-SA) + +`docs/levelguidelines.txt` +: Very useful information for those that want to design levels for +SuperTux. + +`data/credits.txt` +: Credits for people that contributed to the creationof SuperTux. (You +can view these in the game menuas well.) + +`data/README` +: Licensing information about the data. + + +Running the game +---------------- + +SuperTux makes use of proc to see where it is. In other words, it does +not have any need to be installed and can be run from anywhere. This +makes it possible to click in the executable in your filemanager (i.e. +Konqueror or Nautilus) as opposed to many other Linux games. +Options can be reached from the menu, so you don't need to specify +arguments, but if you want, type 'supertux2 --help' to check the ones +that are available. Also, notice that SuperTux saves the options, so +it's often enough to specify them once. For example, fullscreen mode +causes problems on some setups, so just run 'supertux2 --window' and +you should be set. +The game uses OpenGL to render the graphics. You will either need a +CPU with about 10 GHz or an accelerated video card with the vendor's +drivers. (On Linux, the team recommends using cards from NVidia with +the proprietary drivers, but ATI or another vendor should do.) -##Running the game - SuperTux makes use of proc to see where it is. In other words, it does not - have any need to be installed and can be run from anywhere. This makes - it possible to click in the executable in your filemanager (i.e. Konqueror or - Nautilus) as opposed to many other Linux games. - Options can be reached from the menu, so you don't need to specify arguments, - but if you want, type 'supertux2 --help' to check the ones that are available. - Also, notice that SuperTux saves the options, so it's often enough to - specify them once. For example, fullscreen mode causes problems on some setups, - so just run 'supertux2 --window' and you should be set. +Playing the game +---------------- - The game uses OpenGL to render the graphics. You will either need a CPU - with about 10 GHz or an accelerated video card with the vendor's drivers. - (On Linux, the team recommends using cards from NVidia with the proprietary - drivers, but ATI or another vendor should do.) +Both keyboards and joysticks/gamepads are supported. You can change +the controls via the Options menu. Basically, the only keys you will +need to use in-game are to do the following actions: jump, duck, +right, left, power and 'P' to pause/unpause the game. There isn't much +to tell about the first few, but the "action" key allows you to pick +up objects and use any powerup you got. For instance, with the fire +flower, you can shoot bullets (note that this is the only power +currently implemented). +Other useful keys include the Esc key, which is used to go to the menu +or to go up a level in the menu. The menu can be navigated using the +arrow keys or the mouse. -##Playing the game -###Controls - Both keyboards and joysticks/gamepads are supported. You can change the - controls via the Options menu. Basically, the only keys you will need to - use in-game are to do the following actions: jump, duck, right, left, power - and 'P' to pause/unpause the game. There isn't much to tell about the first - few, but the "action" key allows you to pick up objects and use any powerup - you got. For instance, with the fire flower, you can shoot bullets (note - that this is the only power currently implemented). +In the worldmap, the arrow keys are used to navigate and Enter to +enter the current level. - Other useful keys include the Esc key, which is used to go to the menu or - to go up a level in the menu. The menu can be navigated using the arrow - keys or the mouse. - In the worldmap, the arrow keys are used to navigate and Enter to enter - the current level. +Development status +------------------ +This version of SuperTux is still under development, even though the +0.3 line of versions is somewhat aged. This means that badguys, +features, levels, graphics or anything else may be removed in the +future. -##Development status - This version of SuperTux is still under development, even though the - 0.3 line of versions is somewhat aged. This means that badguys, features, - levels, graphics or anything else may be removed in the future. +Especially the Forest world included in this package may be subject to +drastic changes. These changes may go as far as removing the world +altogether. Currently (February 2010) there is no consensus within the +SuperTux development community regarding the fate of the Forest. Don't +get too attached to it ;) - Especially the Forest world included in this package may be subject to - drastic changes. These changes may go as far as removing the world - altogether. Currently (February 2010) there is no consensus within the - SuperTux development community regarding the fate of the Forest. Don't get - too attached to it ;) +The End +------- -##The End - Thanks for trying out SuperTux. +Thanks for trying out SuperTux. - If you like SuperTux, please rate and review it at the Linux Game Tome: +If you like SuperTux, please rate and review it at the Linux Game Tome: - + - Search for "SuperTux"! +Search for "SuperTux"! - Thanks! +Thanks! - The SuperTux development team +The SuperTux development team