#! /bin/sh /usr/share/dpatch/dpatch-run ## 03-manpage.dpatch by Andreas Putzo ## ## DP: Fix typos in gpsdrive.1 (#414240). ## DP: Fixed in upstream svn. @DPATCH@ diff -urNad gpsdrive-2.10~pre4~/man/convert-waypoints.pl.1 gpsdrive-2.10~pre4/man/convert-waypoints.pl.1 --- gpsdrive-2.10~pre4~/man/convert-waypoints.pl.1 2007-09-15 17:13:54.000000000 +0000 +++ gpsdrive-2.10~pre4/man/convert-waypoints.pl.1 2008-01-08 20:47:21.000000000 +0000 @@ -131,7 +131,7 @@ .IX Title "CONVERT-WAYPOINTS 1" .TH CONVERT-WAYPOINTS 1 "2007-09-14" "perl v5.8.8" "User Contributed Perl Documentation" .SH "NAME" -\&\fBconvert\-waypoints\fR +\&\fBconvert\-waypoints\fR \- Convert old gpsdrive waypoints .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBconvert-waypoints\fR is converting old waypoint info from the database table 'waypoints' diff -urNad gpsdrive-2.10~pre4~/man/friendsd2.1 gpsdrive-2.10~pre4/man/friendsd2.1 --- gpsdrive-2.10~pre4~/man/friendsd2.1 2007-09-15 15:12:05.000000000 +0000 +++ gpsdrive-2.10~pre4/man/friendsd2.1 2008-01-08 20:47:21.000000000 +0000 @@ -1,6 +1,6 @@ .TH FRIENDSD2 1 .SH NAME -friendsd2 v2.x - displays GPS position on a map +friendsd2 \- displays GPS position on a map .SH SYNOPSIS .B friendsd2 [options] diff -urNad gpsdrive-2.10~pre4~/man/geo-code.1 gpsdrive-2.10~pre4/man/geo-code.1 --- gpsdrive-2.10~pre4~/man/geo-code.1 2007-09-14 21:47:43.000000000 +0000 +++ gpsdrive-2.10~pre4/man/geo-code.1 2008-01-08 20:47:21.000000000 +0000 @@ -1,7 +1,7 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.33. .TH GEO-CODE "1" "09.10.2003" "geo-code" "User Commands" .SH NAME -geo-code +geo-code \- Convert a street address into geo coordinates .SH DESCRIPTION .SS "Usage:" .IP diff -urNad gpsdrive-2.10~pre4~/man/geoinfo.pl.1 gpsdrive-2.10~pre4/man/geoinfo.pl.1 --- gpsdrive-2.10~pre4~/man/geoinfo.pl.1 2007-09-15 17:13:54.000000000 +0000 +++ gpsdrive-2.10~pre4/man/geoinfo.pl.1 2008-01-08 20:47:21.000000000 +0000 @@ -131,7 +131,7 @@ .IX Title "GEOINFO 1" .TH GEOINFO 1 "2007-09-15" "perl v5.8.8" "User Contributed Perl Documentation" .SH "NAME" -\&\fBgeoinfo.pl\fR Version 0.9 +\&\fBgeoinfo.pl\fR \- Download and convert waypoints for use with gpsdrive .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBgeoinfo.pl\fR is a program to download and convert waypoints diff -urNad gpsdrive-2.10~pre4~/man/gpsdrive.1 gpsdrive-2.10~pre4/man/gpsdrive.1 --- gpsdrive-2.10~pre4~/man/gpsdrive.1 2007-09-14 21:47:43.000000000 +0000 +++ gpsdrive-2.10~pre4/man/gpsdrive.1 2008-01-08 20:54:10.000000000 +0000 @@ -1,12 +1,12 @@ .TH GPSDRIVE 1 .SH NAME -gpsdrive v2.x - displays GPS position on a map +gpsdrive \- displays GPS position on a map .SH SYNOPSIS .B gpsdrive [options] .SH About this manual page -This manual page explain the basic functions of GpsDrive and some +This manual page explains the basic functions of GpsDrive and some additional info. In GpsDrive you find tooltips for nearly all buttons, there is also a @@ -30,7 +30,7 @@ GpsDrive was tested with a GARMIN GPS III, a Crux II GPS PCMCIA card and a Navilock USB receiver. All Garmin GPS reveivers with a serial output should be -usable. Other GPS reveivers that sends NMEA protocol over the +usable. Other GPS receivers that sends NMEA protocol over the serial output should also work with GpsDrive. These GPS receivers are reported to work with gpsdrive: @@ -89,34 +89,32 @@ .B \-d Shows some debugging information. .TP -.B \-D -Shows a lot of debugging information. If you have problems or program -crashes, send this output to the author. You should also combine this -with -d. See also the section -.I BUGS +.B \-D +Shows a lot of debugging information. You should also combine this with -d. +.br +See also the section +.I BUGS. +.TP +.B \-T +Do some internal unit tests (don't start gpsdrive). +.TP +.B \-e +use festival-lite (flite) for speech output. .TP .B \-v -Shows program version together with the CVS version of the mainfile -gpsdrive.c. If you send a bug report, also include this output. +Shows program version. .TP .B \-h Displays a short help message. .TP -.BI \-o "\| outputfile\^" +.B \-o With this option, you can .IR write the NMEA sentences to a PTY master, file or serial device. This is useful if you use GpsDrive in simulation mode to provide other GPS applications with test data. .TP -.BI \-t "\| device\^" -Serial port device (e.g. -.IR /dev/ttyS0 -). You can also set it in the -.IR setup -menu. -.TP -.BI \-l "\| language\^" +.B \-l Sets the language for the speech output. You have to provide the voice files in festival yourself (see below). At the moment .IR german @@ -126,58 +124,66 @@ .IR english are provided. .TP -.B \-x -Creates own window for the menu buttons, status and map. This is -helpful on small displays like the Compaq iPaq or on Head Mounted -Displays, where the menu should be hidden. -.TP -.BI \-s "\| height\^" -Set the height of the screen, if autodetection don't satisfy you, -.IR height -is i.e. 768,600,480,200 -.TP -.BI \-r "\| width\^" -Set the -.IR width -of the screen, if autodetection don't satisfy you. Works -only in combination with -.IR -s +.B \-g +Set the geometry of the screen, if autodetection doesn't satisfy you, +.IR geometry +is i.e. 1024x768, 800x600, 640x480 .TP -.BI \-f "\| friendsserver\^" -Define a friendsserver to exchange position information with other -people. You can also set it in the Settings/Friends menu. You can start your own friendsserver with the program -.B friendsd +.B \-f +Define a friends server to exchange position information with other +people. You can also set it in the Settings/Friends menu. You can start your own friends server with the program +.B friendsd2 , which is included. More details are in section .I FRIENDSD server - +.TP +.B \-X +Use DBUS for communication with gpsd. This disables socket communication. +Try this option if gpsdrive fails to interpret output of the gps receiver correctly. .TP .B \-1 Set special mode if you only have 1 mouse button, i.e. on touchpads. .TP .B \-a -Disable display of battery status. Some implementations of the APM-BIOS -are broken, so use this option if gpsdrive crashes. +Display APM stuff (battery status, temperature) .TP -.BI \-b "\| servername\^" +.B \-b Use a remote NMEA server. You can start gpsd on another .IR host , which has the GPS receiver connected and display the position on your local machine. .TP -.BI \-c "\| waypointname\^" +.B \-c Initial position for simulation mode. Specify a .IR "waypoint name" from your currently used waypoint list. .TP +.B \-M +Set GUI mode. may be 'desktop' (default), 'pda' or 'car'. +.TP +.B \-i +Ignore NMEA checksum (risky, only for broken GPS receivers). +.TP .B \-q -Disables SQL support. Only useful if you have SQL support compiled in. +Disables SQL support. .TP -.B \-z -Don't show zoom and scaling on the map. +.B \-F +Force display of position even if it is invalid. .TP -.BI \-n -Disables the direct serial connection. You have to use Garmin mode -or start gpsd +.B \-S +Don't show splash screen. +.TP +.B \-P +Start in Position Mode +.TP +.B \-W +Set to 1 to switch WAAS/EGNOS on, set to 0 to switch it off. +.TP +.B \-H +Correct altitude. +.TP +.B \-C +Set config file to . + .br @@ -247,7 +253,7 @@ from your shell, if you want another language see section .I LOCALISATION -On some distribution you may find a "GpsDrive" entry in your Gnome or +On some distributions you may find a "GpsDrive" entry in your Gnome or KDE menu. It is important that you have installed GpsDrive as root, so it can @@ -265,13 +271,13 @@ If you have connected a GPS-Receiver, you see in the .I GPS Info -window how much satellites are in view. You can click on this image to switch to the +window how many satellites are in view. You can click on this image to switch to the .I Satellite position view. .br You must have at least 3 satellites in view. If you want to see your altitude, you need at least 4 satellites. The antenna of your GPS receiver must have free sight to the sky, so you cannot use it -indoor. More satellites gives you a better accuracy. +indoors. More satellites gives you a better accuracy. If your receiver has not enough satellites with usable signal, the GPS Info window is red. If your signal is ok and gives a valid @@ -283,7 +289,7 @@ This mode is entered if you have a GPS receiver connected. The cursor is at the position your receiver sends. -The black and a red arrow shows your position on the map. The +Black and a red arrows show your position on the map. The .B black arrow is pointing to your selected target, the .B red arrow @@ -309,7 +315,7 @@ .B not your real position and is marked as an rectangle. -You can set the position by simple left-mouse click on the map. +You can set the position by a simple left-mouse click on the map. You can leave the position mode by by clicking on the "Pos. mode" button or middle-mouse click or right-mouse click (which also sets @@ -323,7 +329,7 @@ .SH MAP DOWNLOAD -You can easily download maps from internet with the +You can easily download maps from the internet with the .B Download button. GpsDrive stores an index of your maps in the file map_koord.txt in your ~/.gpsdrive directory. You can also use any @@ -357,7 +363,7 @@ Vienna. -There is also the programs +There is also the program .IR gpsfetchmap.pl provided to download multiple maps for a bigger area. .br @@ -365,7 +371,7 @@ www.expedia.com if you want to use their maps! .br .B Don't misuse this service by downloading more maps as you need! -You will risk being blocked by thier servers, and possibly cause +You will risk being blocked by these servers, and possibly cause trouble for the gpsdrive project. File formats: @@ -391,12 +397,12 @@ prefix in subdirectories of $HOME/.gpsdrive/ which end in "_map" or "_top". -There is an "import assistant" built in. Use this to import your maps. +There is an "import assistant" built in. Use it to import your maps. .SH Importing waypoints: -The easiest way is to use the script "wpget" which does all for you if +The easiest way is to use the script "wpget" which does everything for you if you use a GARMIN receiver. You can use the program "garble" (included in the package) to read out your waypoints from the Garmin GPS (Transfer mode must be set to @@ -405,7 +411,7 @@ Scripts: "wpget" is a script which calls "garble" in the proper way. Be sure to have "wpget", "wpcvt" and "garble" in your path. This is -fullfilled, if you did install the program as root and /usr/local/bin +fulfilled, if you did install the program as root and /usr/local/bin is in your path. The manual way: @@ -434,7 +440,7 @@ .SH PROXY SERVER If you must access the internet via a proxy server, you have to set the -enviroment variable +enviromental variable .B HTTP_PROXY or .B http_proxy @@ -546,8 +552,8 @@ Gpsdrive supports .IR kismet. Kismet is a 802.11b wireless network (WLAN) sniffer. If you have -kismet running, gpsdrive will detect it and program start and shows -new WLAN accesspoints in realtime on the map. SQL mode is necessary to +kismet running, gpsdrive will detect it and program starts and shows +new WLAN access points in real time on the map. SQL mode is necessary to use Gpsdrive with Kismet. WLAN accesspoints which are already stored in the SQL database from prior wardrivings are ignored. If you have voice output in gpsdrive, you hear information about the newly @@ -594,7 +600,7 @@ When you start GpsDrive it will detect the server on port 1314 and puts out some status information as speech. You also have an -additonal button (Mute) to switch off sound output. +additional button (Mute) to switch off sound output. GpsDrive tries to select the correct language for your locale. The -l option can force the languages for speech @@ -659,12 +665,10 @@ .SH MAILING LIST The address for the mailing list is -.B gpsdrive@warbase.selwerd.nl - -Subscribing can be done by sending a mail containing -.B subscribe gpsdrive - -to majordomo@warbase.selwerd.nl +.B gpsdrive@lists.gpsdrivers.org +.br +You can browse the archive or subscribe at +http://lists.gpsdrivers.org/mailman/listinfo/gpsdrive .SH BUGS Please send bug reports to the author. Report version (gpsdrive -v), @@ -696,9 +700,15 @@ and send me this output. -.SH AUTHOR -Fritz Ganter +.SH AUTHORS +Fritz Ganter, +.br +Joerg Ostertag, +.br +Gpsdrive Development Team .br +and others. +.PP http://www.gpsdrive.de .SH WARRANTY This program is distributed in the hope that it will be useful, @@ -707,11 +717,21 @@ GNU General Public License for more details. .SH COPYRIGHT -Copyright (c) 2001-2004 by Fritz Ganter +Copyright (c) 2001-2006 by Fritz Ganter +.br +Copyright (c) 2006-2007 The GpsDrive Development Team .br 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. - +.SH SEE ALSO +.PP +.B gpsd(8), +.B friendsd(1), +.B gpsfetchmap(1), +.B osm2pgsql(1), +.B kismet(1), +.B festival(1), +.B flite(1) diff -urNad gpsdrive-2.10~pre4~/man/gpsfetchmap.pl.1 gpsdrive-2.10~pre4/man/gpsfetchmap.pl.1 --- gpsdrive-2.10~pre4~/man/gpsfetchmap.pl.1 2007-09-15 17:13:54.000000000 +0000 +++ gpsdrive-2.10~pre4/man/gpsfetchmap.pl.1 2008-01-08 20:47:21.000000000 +0000 @@ -131,7 +131,7 @@ .IX Title "GPSFETCHMAP 1" .TH GPSFETCHMAP 1 "2007-09-15" "perl v5.8.8" "User Contributed Perl Documentation" .SH "NAME" -\&\fBgpsfetchmap\fR Version 1.04 +\&\fBgpsfetchmap\fR \- Download maps from a mapserver .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBgpsfetchmap\fR is a program to download maps from a mapserver for use with gpsdrive. diff -urNad gpsdrive-2.10~pre4~/man/gpspoint2gpsdrive.pl.1 gpsdrive-2.10~pre4/man/gpspoint2gpsdrive.pl.1 --- gpsdrive-2.10~pre4~/man/gpspoint2gpsdrive.pl.1 2007-09-15 17:13:54.000000000 +0000 +++ gpsdrive-2.10~pre4/man/gpspoint2gpsdrive.pl.1 2008-01-08 20:47:21.000000000 +0000 @@ -131,7 +131,7 @@ .IX Title "GPSPOINT2GPSDRIVE 1" .TH GPSPOINT2GPSDRIVE 1 "2007-09-14" "perl v5.8.8" "User Contributed Perl Documentation" .SH "NAME" -\&\fBgpspoint2gpsdrive.pl\fR +\&\fBgpspoint2gpsdrive.pl\fR \- Extract gpsdrive-compatible tracks from a gpspoint file .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBgpspoint2gpsdrive.pl\fR diff -urNad gpsdrive-2.10~pre4~/man/poi-manager.pl.1 gpsdrive-2.10~pre4/man/poi-manager.pl.1 --- gpsdrive-2.10~pre4~/man/poi-manager.pl.1 2007-09-15 17:13:54.000000000 +0000 +++ gpsdrive-2.10~pre4/man/poi-manager.pl.1 2008-01-08 20:47:21.000000000 +0000 @@ -130,6 +130,8 @@ .\" .IX Title "POI-MANAGER 1" .TH POI-MANAGER 1 "2007-09-14" "perl v5.8.8" "User Contributed Perl Documentation" +.SH NAME +poi\-manager \- Manage points of interest .SH "SYNOPSIS" .IX Header "SYNOPSIS" poi\-manager.pl [\-h] [\-v] [\-b] [\-i] [\-e] [\-p] [\-s] [\-f \s-1GPX\-FILE\s0]