"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "gpsdrive-2.10pre6/README" of archive gpsdrive-2.10pre6.tar.gz:


As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
    1 GPSDRIVE - GPS navigation software for Linux
    2 --------------------------------------------
    3 
    4 Website: www.gpsdrive.de
    5 
    6 Copyright: (c) 2001-2004 Fritz Ganter <ganter@ganter.at>
    7 with improvements (c) through 2008 by The GpsDrive Development Team
    8 
    9 
   10     *********************************************************************
   11 
   12     Disclaimer: Do not use as a primary means of navigation. 
   13                 Keep your eyes on the road and hands on the wheel.
   14 
   15     This program is free software; you can redistribute it and/or modify
   16     it under the terms of the GNU General Public License as published by
   17     the Free Software Foundation; either version 2 of the License, or
   18     (at your option) any later version.
   19 
   20     This program is distributed in the hope that it will be useful,
   21     but WITHOUT ANY WARRANTY; without even the implied warranty of
   22     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   23     GNU General Public License for more details.
   24 
   25     You should have received a copy of the GNU General Public License
   26     along with this program; if not, write to the Free Software
   27     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   28 
   29     *********************************************************************
   30 
   31 
   32 
   33 ********************************************************************
   34 
   35 Please read the gpsdrive man page. To do so, install the program and type 
   36   man gpsdrive
   37 
   38 into a terminal window. With KDE Konqueror you can also see it with the URL:
   39   man:gpsdrive
   40 
   41 Most information is now in the man page!
   42 
   43 Also have a look at the old revision changelog at 
   44   http://www.gpsdrive.de/changes.shtml
   45 
   46 ********************************************************************
   47 
   48 
   49 
   50 How to install the program:
   51 ----------------------
   52 
   53 To compile gpsdrive you need quite a few development packages.
   54 These requirements are detailed in the DEVPACKAGES text file. 
   55 
   56 Most importantly you will need a C compiler (gcc >=3.x) and 'make'.
   57 
   58 
   59 To compile from the tarball:
   60 
   61 Extract it with "tar -xvzf gpsdrive*tar.gz"
   62   cd gpsdrive
   63   mkdir build
   64   cd build
   65   cmake -DCMAKE_BUILD_TYPE=debug
   66   make
   67 
   68 If you don't need the support of Mapnik and dislike having GDAL ...
   69   cmake -DCMAKE_BUILD_TYPE=debug -DWITH_GDAL=OFF -DWITH_MAPNIK=OFF
   70 
   71 See "cmake -L .." for more variables to treak.
   72 
   73 To install the program, the gpsd daemon and the language files you should
   74 (as root) do:
   75   make install
   76 
   77 
   78 After compiling and installing* read the manpage of gpsdrive or start the
   79 program if you are to lazy to read manuals. ;-) Or read it online.
   80 [*] install is needed for localized versions of the man page.
   81 
   82 
   83 
   84 Quick Guide to get started:
   85 ---------------------------
   86 
   87   # Compile and install
   88   mkdir build
   89   cd build
   90   cmake -DCMAKE_BUILD_TYPE=debug
   91   make
   92   make install
   93  
   94   # import Mapnik from German Planet File(as root):
   95   mapnik-osm-updater.sh --all-planet-geofabrik=europe/germany
   96   ... wait a little time ... wait a little longer ... 
   97  
   98   # make directory
   99   mkdir ~/.gpsdrive
  100  
  101   # fetch additional maps
  102   gpsfetchmap.pl -w gpsd -a 1
  103  
  104   # start gpsdrive
  105   gpsdrive
  106 
  107 You can also download the RPM file and install it:
  108   rpm -Uvh gpsdrive*.rpm
  109 
  110 
  111 On Debian Systems you can also download the .deb file and install it:
  112   dpkg --install gpsdrive*.deb
  113 But don't forget to download and install the new icon Files
  114   dpkg --install openstreetmap-map-icons-classic_*.deb
  115   dpkg --install openstreetmap-map-icons_*.deb
  116 And the OpenStreetmap Utilities for using Mapnik Maps ...
  117   dpkg --install openstreetmap-utils*.deb
  118     
  119 
  120 
  121 
  122 Uninstall:
  123 ---------
  124 
  125 If you installed using the tarball:
  126 
  127 cd into the gpsdrive directory (not the src), then
  128   make uninstall
  129 
  130 If you used the rpm package:
  131   rpm -e gpsdrive
  132 
  133 Debian:
  134   aptitude remove openstreetmap-utils gpsdrive openstreetmap-map-icons.*
  135 
  136 You can find much more information in the manual page, read it with
  137 "man gpsdrive" or online at http://www.gpsdrive.de/man-en.html
  138 
  139 
  140 
  141 enjoy!
  142 --The GpsDrive Development Team
  143 
  144 Last modified: $Date: 2008-07-03 23:32:01 +0200 (Thu, 03 Jul 2008) $