Add meager instrucstion on installing from source, and on the RasPi.

1 files changed, 48 insertions, 1 deletions

diff --git a/INSTALL b/INSTALL
index 8a3f8272..5b059a46 100644
--- a/INSTALL
+++ b/INSTALL
@@ -96,7 +96,7 @@ The Python code in GPSD is actually compatible back to Python 2.4 except that
 you need either the json library module from 2.6 or the functionally
 equivalent simplejson backport.
 
-== Install the package(s) ==
+== Install your distributions package(s) ==
 
 Up-to-date gpsd packages are generally available for Linux
 distributions including Debian and derivatives (including Ubuntu and
@@ -112,6 +112,30 @@ However, many distributions break up GPSD into separate installable
 packages for the core daemon and clients; you should search your
 repository index for anything with gpsd as a prefix.
 
+== Install from source code ==
+
+If an up to date gpsd package is not available for your distribution,
+then you can install gpsd from the release tarball.  Tarballs are
+available from: http://download.savannah.gnu.org/releases/gpsd/
+
+Before proceeding to build from source ensure that you have removed your
+distributions old gpsd files.
+
+Download the latest tar file.  Unpack the file, enter the build
+directory, build, test and install gpsd.  A sample procedure would be:
+
+--------------------------------------------------------------
+# cd /usr/local/archive
+# wget http://download.savannah.gnu.org/releases/gpsd/gpsd-3.14.tar.gz
+# cd /usr/local/src
+# tar -xvzf /usr/local/archive/gpsd-3.14.tar.gz
+# cd gpsd-3.14
+# scons --clean && scons --config=force && scons check && scons install 
+--------------------------------------------------------------
+
+You should now have a clean installation of gpsd from source.  The executable
+files have been installed in /usr/local/bin and /usr/local/sbin.
+
 == How to test the software ==
 
 1. Start gpsd.  You'll need to give it as an argument a path to 
@@ -211,6 +235,29 @@ Wheezy.  Other distributions will likely work fine as well.  The gpsd
 package in Debian Wheezy is known to be flakey, be sure to update to a
 new version of gpsd from source.
 
+Before compiling gpsd from source, you will need to update your system
+as root:
+
+--------------------------------------------------------------
+# apt-get update
+# apt-get dist-upgrade
+# rpi-update
+# reboot
+--------------------------------------------------------------
+
+Next, Wheezy requires a few tools for compiling and testing gpsd:
+
+--------------------------------------------------------------
+# apt-get install scons libncurses5-dev python-dev pps-tools
+# apt-get install git-core
+--------------------------------------------------------------
+
+Git-core is only required to build from a git repository.  pps-tools is for
+testing PPS inputs.
+
+The rest of the installation is just as for any other source based
+install, as above.
+
 Any USB connected GPS that is known to work with gpsd will work fine on
 the RasPi.  No special instructions apply.