Task #8185: update INSTALL. Piggy back irrel update of installation doc on this task.

INSTALL

@@ -41,7 +41,7 @@ For Ubuntu/Mint (likely incomplete list, but goes a long way):
         apt-get install libpng12-dev                         # or a newer version (for AOFlagger)
 
 	apt-get install libreadline-dev libpqxx-dev doxygen  # optional
-	apt-get install libunittest++-dev                    # optional, to run all regression tests
+	apt-get install libunittest++-dev                    # optional, for tests that use UnitTest++
         apt-get install libgsl0-dev                          # optional, for AOFlagger's RayleighFitter
 	apt-get install libgtkmm-2.4-dev libsigc++-2.0-dev   # optional, for AOFlagger's rficonsole
 
@@ -56,10 +56,10 @@ For CentOS/Fedora (likely incomplete list, but goes a long way):
         yum install gtkmm24-devel libsigc++20-devel          # optional, for AOFlagger's rficonsole
 
 	The blitz and blitz-devel pkgs are available on some distros, but not on e.g. CentOS 7.
-        If indeed required for your build, but not in your repo, take the two RPMs from CentOS 6.
-	Idem for log4cplus (LOFAR log4cxx is dodgy).
-	Similar for unittest++ and unitest++-devel (both optional), but take two RPMs from Fedora 22.
-	If you have LOFAR Redmine access, see: https://support.astron.nl/lofar_issuetracker/issues/8161
+        If required for your build, but not in your repo, take the two RPMs from CentOS 6 (or build from source).
+	Idem for log4cplus (LOFAR log4cxx support is dodgy).
+	Similar for unittest++ and unitest++-devel (both optional), but take two RPMs from Fedora 22 (or build from source).
+	RPMs known to work on CentOS 7 can be found at: https://support.astron.nl/lofar_issuetracker/issues/8161
 
 
 
@@ -74,32 +74,35 @@ NOTE (any OS): The most prominent dependency you likely need to build from sourc
 Instructions for Manual Build from Source
 -----------------------------------------
 
-- SVN checkout a tagged release x.y.z (or the trunk) from https://svn.astron.nl/LOFAR/ into e.g. $HOME/src/LOFAR-x.y.z/
+- SVN checkout build and configuration scripts of a tagged release x.y.z (or the
+  trunk) from https://svn.astron.nl/LOFAR/ into e.g. $HOME/src/LOFAR-x.y.z/
 
-	LOFAR_VERSION=LOFAR-Release-x.y.z  # set to used release version
-	svn checkout https://svn.astron.nl/LOFAR/tags/$LOFAR_VERSION "$HOME/src/$LOFAR_VERSION"
+	LOFAR_RELEASE=LOFAR-Release-x.y.z  # set to used release version
+	svn checkout --depth=files "https://svn.astron.nl/LOFAR/tags/$LOFAR_RELEASE" "$HOME/src/$LOFAR_RELEASE"
+	svn update --depth=infinity "$HOME/src/$LOFAR_RELEASE/CMake"
 
-- Install the usual offline data reduction (imaging) packages into e.g. $HOME/local/$LOFAR_VERSION/
+- Auto-checkout and install the usual offline data reduction (imaging) packages
+  into e.g. $HOME/local/$LOFAR_RELEASE/
   (Only ends succesfully once CMake can find all required dependencies.)
 
-	mkdir -p $HOME/build/$LOFAR_VERSION/gnu_opt  # last directory must be {gnu|clang}_{debug|opt}
-	cd $HOME/build/$LOFAR_VERSION/gnu_opt
-	cmake -DCMAKE_INSTALL_PREFIX="$HOME/local/$LOFAR_VERSION" -DBUILD_PACKAGES="DP3 Calibration Imager PyBDSM" -DUSE_OPENMP=ON "$HOME/src/$LOFAR_VERSION"
+	mkdir -p $HOME/build/$LOFAR_RELEASE/gnu_opt  # last directory must be {gnu|clang}_{debug|opt}
+	cd $HOME/build/$LOFAR_RELEASE/gnu_opt
+	cmake -DCMAKE_INSTALL_PREFIX="$HOME/local/$LOFAR_RELEASE" -DBUILD_PACKAGES="DP3 Calibration Imager PyBDSM" -DUSE_OPENMP=ON "$HOME/src/$LOFAR_RELEASE"
 
 - Build and install:
 
-	make -j4
-	make install  # with sufficient privileges
+	make -j 4
+	make -j 4 install  # with sufficient privileges
 
 - Optionally, run the regression tests:
 
-	ctest -j4
+	ctest -j 4 --timeout 60
 
-  All tests should pass, however, some packages require certain hardware or
-  software (e.g. RTCP needs CUDA GPUs) to pass.
+  All tests should pass, however, a few packages (not selected above) require
+  GPU hardware or a database to pass.
 
 - You may want to add the installation path bin/ to your PATH:
 
-	. "$HOME/local/$LOFAR_VERSION/lofarinit.sh"  # for Bourne-like shells, or
-	. "$HOME/local/$LOFAR_VERSION/lofarinit.csh" # for C-like shells
+	source "$HOME/local/$LOFAR_RELEASE/lofarinit.sh"  # for Bourne-like shells, or
+	source "$HOME/local/$LOFAR_RELEASE/lofarinit.csh" # for C-like shells