--- a/BuildingOnLinux.wiki	Tue Jul 01 12:46:28 2014 +0000
+++ b/BuildingOnLinux.wiki	Fri Oct 17 22:19:41 2014 +0000
@@ -3,8 +3,13 @@
 
 = Introduction =
 
-Copy and Paste instructions for a Hedgewars development build. Should work on Debian and the like (Ubuntu, Mint).  Packages for other distros should have similar names.  Remember to copy the *entire* apt-get lines!
-Important.  This builds the latest development sources.  If you want to build the latest stable, run: hg up 0.9.20 before running cmake.  Also, see http://hedgewars.org/download.html if you are just looking to play latest stable - there's a good chance it exists for your distro.
+This page contains Copy and Paste instructions for a Hedgewars development build.
+They should work on Debian and the like (Ubuntu, Mint).
+Required Packages for other distros should have similar names.
+
+Please remember to copy the *entire* apt-get lines!
+
+Also, see http://hedgewars.org/download.html if you are just looking to play latest stable - there's a good chance it exists for your distro.
 
 = Prerequisites =
 
@@ -24,7 +29,12 @@
 sudo apt-get install ghc libghc-binary-dev libghc-bytestring-show-dev libghc-dataenc-dev libghc-deepseq-dev libghc-hslogger-dev libghc-mtl-dev libghc-network-dev libghc-parsec3-dev libghc-utf8-string-dev libghc-vector-dev libghc-random-dev libghc-zlib-dev libghc-sha-dev libghc-entropy-dev
 }}}
 
-= Building process =
+= Fetching the source code =
+
+Below you find instructions for downloading the Hedgewars source code from the development repository.
+
+If you have already downloaded and unpacked the source code version of your choice (e.g. the source tarball from the  [http://hedgewars.org/download.html download page]), just {{{cd}}} to your copy of the Hedgewars source in a terminal and go straight to the building section further below.
+----
 
 {{{
 mkdir -p ~/games ~/hg/hedgewars/
@@ -45,11 +55,23 @@
 }}}
 Note. Do *NOT* run the command above if you want to play the latest development code (currently 0.9.21-dev).
 
+
+= Building process =
+
 Now let's configure and build!
+
+If you want to install Hedgewars *just for your user account* run
 {{{
 cmake -DCMAKE_BUILD_TYPE="DEBUG" -DCMAKE_INSTALL_PREFIX="$HOME/games" -DDATA_INSTALL_DIR="$HOME/games" -DNOSERVER=1
 make install
 }}}
+If you want to install Hedgewars *system-wide* (not recommended for development builds) then run
+
+{{{
+cmake -DCMAKE_BUILD_TYPE="RELEASE" -DNOSERVER=1
+sudo make install
+}}}
+
 IMPORTANT: If you decided against png-screenshots or video-recording support, please append `-DNOPNG=1` and/or `-DNOVIDEOREC=1` to the cmake command line respectively!
 
 if you want to build the server as well, change `-DNOSERVER=1` to `-DNOSERVER=0`
@@ -60,10 +82,13 @@
 {{{
 ~/games/bin/hedgewars
 }}}
+or just {{{hedgewars}}} if you did a system-wide install.
 
 You can also create a launcher for it on your desktop or on applications menu if you wish, using the ~/games/bin/hedgewars path
 
-== Build Updates ===
+== Build latest development code repository updates ===
+
+If you have built from your repository clone before and now you want to download more recent updates and rebuild Hedgewars with them, then run
 
 {{{
 cd ~/hg/hedgewars/trunk