GPSDRIVE - GPS navigation software for Linux
--------------------------------------------

Website: www.gpsdrive.de

Copyright: (c) 2001-2004 Fritz Ganter <ganter@ganter.at>
with improvements (c) through 2008 by The GpsDrive Development Team


    *********************************************************************

    Disclaimer: Do not use as a primary means of navigation. 
                Keep your eyes on the road and hands on the wheel.

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    *********************************************************************



********************************************************************

Please read the gpsdrive man page. To do so, install the program and type 
  man gpsdrive

into a terminal window. With KDE Konqueror you can also see it with the URL:
  man:gpsdrive

Most information is now in the man page!

Also have a look at the old revision changelog at 
  http://www.gpsdrive.de/changes.shtml

********************************************************************



How to install the program:
----------------------

To compile gpsdrive you need quite a few development packages.
These requirements are detailed in the DEVPACKAGES text file. 

Most importantly you will need a C compiler (gcc >=3.x) and 'make'.


To compile from the tarball:

Extract it with "tar -xvzf gpsdrive*tar.gz"
  cd gpsdrive
  mkdir build
  cd build
  cmake -DCMAKE_BUILD_TYPE=debug
  make

If you don't need the support of Mapnik and dislike having GDAL ...
  cmake -DCMAKE_BUILD_TYPE=debug -DWITH_GDAL=OFF -DWITH_MAPNIK=OFF

See "cmake -L .." for more variables to treak.

To install the program, the gpsd daemon and the language files you should
(as root) do:
  make install


After compiling and installing* read the manpage of gpsdrive or start the
program if you are to lazy to read manuals. ;-) Or read it online.
[*] install is needed for localized versions of the man page.



Quick Guide to get started:
---------------------------

  # Compile and install
  mkdir build
  cd build
  cmake -DCMAKE_BUILD_TYPE=debug
  make
  make install
 
  # import Mapnik from German Planet File(as root):
  mapnik-osm-updater.sh --all-planet-geofabrik=europe/germany
  ... wait a little time ... wait a little longer ... 
 
  # make directory
  mkdir ~/.gpsdrive
 
  # fetch additional maps
  gpsfetchmap.pl -w gpsd -a 1
 
  # start gpsdrive
  gpsdrive

You can also download the RPM file and install it:
  rpm -Uvh gpsdrive*.rpm


On Debian Systems you can also download the .deb file and install it:
  dpkg --install gpsdrive*.deb
But don't forget to download and install the new icon Files
  dpkg --install openstreetmap-map-icons-classic_*.deb
  dpkg --install openstreetmap-map-icons_*.deb
And the OpenStreetmap Utilities for using Mapnik Maps ...
  dpkg --install openstreetmap-utils*.deb
    



Uninstall:
---------

If you installed using the tarball:

cd into the gpsdrive directory (not the src), then
  make uninstall

If you used the rpm package:
  rpm -e gpsdrive

Debian:
  aptitude remove openstreetmap-utils gpsdrive openstreetmap-map-icons.*

You can find much more information in the manual page, read it with
"man gpsdrive" or online at http://www.gpsdrive.de/man-en.html



enjoy!
--The GpsDrive Development Team

Last modified: $Date: 2008-07-03 23:32:01 +0200 (Thu, 03 Jul 2008) $
