Ignore custom folder icon under Mac OS X. (Attempt #?... Apparently a carriage return...

[neverball] / INSTALL

diff --git a/INSTALL b/INSTALL
index fa22ff2..b6412f6 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -2,50 +2,84 @@
                             * Neverball *
 
 
-Requirements:
+* REQUIREMENTS
 
     SDL               http://www.libsdl.org/download-1.2.php
-    SDL_image         http://www.libsdl.org/projects/SDL_image/
-    SDL_mixer         http://www.libsdl.org/projects/SDL_mixer/
     SDL_ttf           http://www.libsdl.org/projects/SDL_ttf/
+    libvorbis         http://xiph.org/vorbis/
+    libpng            http://www.libpng.org/pub/png/libpng.html
+    libjpeg
 
+To build Neverball  with native language support on  systems not using
+the GNU C library, two additonal libraries may have to be installed:
 
-Under Unix, Linux, and OSX, simply run
+    libintl           http://www.gnu.org/software/gettext/
+    libiconv          http://www.gnu.org/software/libiconv/
+
+To  build Neverball  with Nintendo  Wii Remote  support on  Linux, the
+"official Linux Bluetooth protocol stack"  or BlueZ and the libwiimote
+library must be installed and configured:
+
+    BlueZ             http://www.bluez.org/
+    libwiimote        http://libwiimote.sourceforge.net/
+
+
+* COMPILATION
+
+Under Unix and Linux, simply run
 
     make
 
-Under Windows, build using the provided Visual Studio solution.
+Certain features  can be enabled/disabled  at compile time  by passing
+additional arguments to  Make in the form "NAME=VALUE",  where NAME is
+one of those listed below and VALUE is typically 0 for disabled, 1 for
+enabled.
+
+    ENABLE_NLS=1
 
-The executables will be copied to the base directory.  By default,  an
-uninstalled build may be executed in place.
+        Enable  native  language   support.   May  require  additional
+        libraries.
+
+    ENABLE_WII=0
+
+        Enable Wii Remote support.   Requires additional libraries and
+        system configuration.
+
+Under Mac OS X, build using the provided Xcode project files.
+
+For  Windows  builds,  the   MinGW  cross-compilation  environment  is
+supported. (Native builds  are theoretically possible using  MinGW and
+MSYS.  Although care is taken  to preserve compatibility with MSYS, no
+support exists and no actual testing is done.)
+
+By default, an uninstalled build may be executed in place.
 
 
 * INSTALLATION
 
-The game  searches for game assets  in the following  three places, in
-this order.  If the game is  to be installed globally, at least one of
+The game  searches for game assets  in the following three  places, in
+this order.  If the game is to  be installed globally, at least one of
 them must be set.
 
-1) The directory specified on the command line.
+ 1. The directory  specified as argument to '--data'  (or '-d') option
+    on the command line.
 
-2) The directory given by the NEVERBALL_DATA environment variable.
+ 2. The directory given by the NEVERBALL_DATA environment variable.
 
-3) The directory given by the CONFIG_DATA variable defined in config.h
+ 3. The   directory   given  by  the  CONFIG_DATA   macro  defined  in
+    share/base_config.h
 
 A normal Linux installation would  probably copy the data directory to
-"/usr/local/games/neverball/" and  change the CONFIG_DATA  variable to
-match.
+"/usr/local/share/games/neverball/" and  change the  CONFIG_DATA macro
+to match.
+
 
-A  normal  Windows installation  would  simply  copy  the entire  game
-directory  to "C:\Program Files\Neverball"  and leave  the CONFIG_DATA
-variable to its default value "./data".
+* DISTRIBUTION
 
+The dist subdirectory contains some miscellaneous files:
 
-* DISTRIPUTION STUFF
+  * "Desktop entry" or .desktop files.
+  * Icons in PNG, SVG and ICO formats.
 
-The dist directory contains some miscelanous files:
- * manpages
- * desktop files
- * icons
 
-Contact: <robert.kooima@gmail.com>
+Web: <http://neverball.org/>