Improvements to the install instructions

git-svn-id: https://svn.code.sf.net/p/speed-dreams/code/trunk@5255 30fe4595-0a0c-4342-8851-515496e4dcbd

Former-commit-id: 1c889e759be3775a88b36e87fc4598ade0c304d6
Former-commit-id: 60be7e471040ec0376e8ddca965f7b0e99ffb7fc

INSTALL.txt

@@ -96,13 +96,12 @@ The Speed Dreams Team.
       and that we'll extract them in the "2.0.0-r4687" folder
       (you can do as you like, but we'll use this folder in the explanations below).
 
-  b - uncompress the tarballs :
+  b - extract the tarballs :
-
 
       Whatever the chosen option (1 or 2) :
       
       $ cd $HOME/sd
-      $ mkdir 
+      $ mkdir 2.0.0-r4687
       $ cd 2.0.0-r4687
       $ for file in ../*.xz; do tar xvfa $file; done
       
@@ -127,7 +126,7 @@ The Speed Dreams Team.
 
     2. run CMake :
 
-      - for a Release build using default 3rd party libs
+      - for a Release (optimised) build using default 3rd party libs
 
         Option 1 (full contents) :
         $ cmake -D OPTION_OFFICIAL_ONLY:BOOL=ON ..
@@ -142,8 +141,8 @@ The Speed Dreams Team.
           Example :
 
             $ cmake -D SD_LOCALDIR:STRING=~/dev/.sd-settings \
-                    -D CMAKE_PREFIX_PATH:STRING=/usr/local
+                    -D CMAKE_PREFIX_PATH:STRING=/usr/local \
-                    -D CMAKE_BUILD_TYPE:STRING=Debug
+                    -D CMAKE_BUILD_TYPE:STRING=Debug ..
 
         or else you can use ccmake to change the variables interactively :
 
@@ -267,8 +266,8 @@ The Speed Dreams Team.
 
     $ speed-dreams-2
       
-  If /usr/local/games not already in your PATH variable, you may want to add it ; to do so,
+  If /usr/local/games is not already in your PATH variable, you probably want to add it ;
-  simply add the line "export PATH=$PATH:/usr/local/games" to your  ~/.bashrc file ;
+  to do so, simply add the line "export PATH=$PATH:/usr/local/games" to your  ~/.bashrc file ;
   you can use :
 
     $ echo "export PATH=$PATH:/usr/local/games" >> ~/.bashrc" for that
@@ -310,7 +309,8 @@ The Speed Dreams Team.
 III - Windows installation from sources
 ---------------------------------------
 
-Note that these instructions work under Windows XP 32 SP2/SP3 ; some tweaks wight be needed for newer / wider versions.
+Note that these instructions work under Windows XP 32 SP2/SP3 ; 
+some tweaks might be needed for newer / wider versions.
 
 0) Initial steps, common to all build methods
 
@@ -350,7 +350,7 @@ Note that these instructions work under Windows XP 32 SP2/SP3 ; some tweaks wigh
 
   d.  Install MinGW (and optionaly MSYS)
 
-     Following the instructions of http://www.mingw.org/wiki/Getting_Started
+     Here's a simpler version of the instructions of http://www.mingw.org/wiki/Getting_Started
      (example here for the official release of 2012, April, featuring gcc 4.7.0) :
 
      * Download and run the latest mingw-get-inst version from 
@@ -359,16 +359,14 @@ Note that these instructions work under Windows XP 32 SP2/SP3 ; some tweaks wigh
      * Select the directory where to install MinGW, remembering the advice
        that the path to this directory should not contain any spaces.
        => C:\MinGW
+     * Select the "Download latest repository catalogues" option
+       in order to get the latest Gcc (4.7.0 as of now)
+       (if you choose "Use pre-packaged catalogues", you'll get an old Gcc 4.6.2,
+        which is _not_ compatible with the below mentioned 3rd party binary package.
      * Select the minimal set of components to install :
+       * C compiler (always)
        * C++ compiler (always)
        * MSYS (if you don't plan to use QtCreator).
-     *  When installing MinGW with the setup wizard, it asks you :
-          Use pre-packaged catalogues or download the latest version?
-           1) Use pre-packaged catalogues 20120426
-           2) Download latest repository catalogues
-         => select the 2nd choice (for getting Gcc 4.7.0),
-            not the default 1st one, that'll give you the old Gcc 4.6.2,
-            which is _not_ compatible with the below mentioned 3rd party binary package.
 
      If you installed MSYS, then you might be interested in the following,
      otherwise, skip it and go to e.
@@ -589,18 +587,28 @@ Note that these instructions work under Windows XP 32 SP2/SP3 ; some tweaks wigh
           . click on the "Add the deployment step" button, and select "Make",
           . add the "install" argument to the default "mingw32-make.exe" command.       
 
-  j.  Build and install
+  j.  Build
 
       * If you are using MSYS, in the MSYS shell :
 
         $ make # use -j2 or even -j4 if you own a dual/quad-core CPU
+
+      * If you are using QtCreator :
+
+        - "Build / Compile all" through the menu (or Shift-Ctrl-B)
+      
+  k.  Install
+
+      * If you are using MSYS, in the MSYS shell :
+
         $ make install
 
       * If you are using QtCreator :
 
-        - "Build / Compile all" through the menu
+        you have to "Run" Speed Dreams (no separate Install function :-(,
+        it'll install le software before running it (see i. above)
       
-  k.  Run (and debug) Speed Dreams
+  l.  Run (and debug) Speed Dreams
 
       * Of course you can simply double click on the installed speed-dreams-2.exe executable
         (should be in /speed-dreams-2-build/bin with default CMake settings) ...
@@ -645,8 +653,8 @@ Note: If you use an "Express" version, don't forget to install also the Windows
       * "Where to build the binaries" to c:\gamesources\speed-dreams\src-2.0.0\build
         (if you follow the folder specs above).
   g.  Press "Configure" button, answer "Yes, create the ...\build folder",
-      select the compiler and don't change the "Use native compilers" option.
+      select the right MSVC compiler version and don't change the "Use native compilers" option.
-      Press the "Configure" button again, until the "OK" button is no more greyed.
+      Press the "Configure" button again, until the "Generate" button is no more greyed.
   h.  Press the "Generate" button.  CMake will generate the solution file "speed-dreams-2.sln"
       and associated project files (*.vcproj) in the ...\build folder
       (Note : .sln/.vcproj are OK for MSVC 2005, but you might get other files extensions