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

Website: www.gpsdrive.de

Copyright: (c) 2001-2004 Fritz Ganter <ganter@ganter.at>
with improvements (c) through 2007 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!


A collaborative wiki help system can be found here:
  http://www.livingresource.net/gpsdrive/index.php/Main_Page

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

For help regarding MySQL support please read README.SQL.

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



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
  ./configure 
  make

If you don't need the support of the GARMIN protocol (you are using
only NMEA protocol) you should configure GpsDrive with:
  ./configure --disable-garmin

You can also add --enable-auto-optimization for optimized compiler flags.
See "./configure --help" for all options.


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
  ./configure
  make
  make install
 
  # create database
  geoinfo.pl  --create-db --fill-defaults --openstreetmap \
               --db-user=root --db-password=<our mysql root password>
 
  # make directory
  mkdir ~/.gpsdrive
 
  # fetch additional maps
  gpsfetchmap.pl -w gpsd -a 1
 
  # start gpsdrive
  gpsdrive


If errors occur in ./configure, try running ./autogen.sh first.

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



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


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: 2007-08-20 08:56:25 +0200 (Mon, 20 Aug 2007) $
