1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.1.2//EN"
"docbook/docbookx.dtd">
<refentry id='xgps.1'>
<refmeta>
<refentrytitle>gpsd</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class='date'>9 Aug 2004</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>xgps</refname>
<refname>xgpsspeed</refname>
<refpurpose>test clients for gpsd</refpurpose>
</refnamediv>
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
<command>xgps</command>
<arg choice='opt'><replaceable>X-options</replaceable></arg>
<arg choice='opt'>-h </arg>
<arg choice='opt'>-v </arg>
<arg choice='opt'>-speedunits <group choice='req'><arg>mph</arg><arg>kph</arg><arg>knots</arg></group></arg>
<arg choice='opt'>-altunits <group choice='req'><arg>feet</arg><arg>meters</arg></group></arg>
<group>
<replaceable>server</replaceable>
<group>
<replaceable>:port</replaceable>
<group><replaceable>:device</replaceable></group>
</group>
</group>
</cmdsynopsis>
<cmdsynopsis>
<command>xgpsspeed</command> <arg choice='opt'>-rv</arg>
<arg choice='opt'><replaceable>X-options</replaceable></arg>
<arg choice='opt'>-h </arg>
<arg choice='opt'>-v </arg> <arg
choice='opt'>-nc <replaceable>X-color</replaceable></arg> <arg
choice='opt'>-speedunits <group
choice='req'><arg>mph</arg><arg>kph</arg><arg>knots</arg></group></arg>
<group>
<replaceable>server</replaceable>
<group>
<replaceable>:port</replaceable>
<group><replaceable>:device</replaceable></group>
</group>
</group>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id='description'><title>DESCRIPTION</title>
<refsect2><title>xgps</title>
<para><application>xgps</application> is a simple test client for
<application>gpsd</application> with an X interface. It displays
current GPS position/time/velocity information and (for GPSes that
support the feature) the locations of accessible satellites.</para>
<para><application>xgps</application> accepts an -h option as for
<application>gpsd</application>, or a -v option to dump the package
version and exit.</para>
<para>An optional argument may specify a server to get data from; a
colon-separated suffix is taken as a port number. If there is a second
colon-separated suffix, that is taken as a device name to be handed
to the daemon in an F= command.</para>
<para>The <option>-speedunits</option> option can be used to set the
speed units for display; follow the keyword with knots for nautical
miles per hour, kph for kilometres per hour, or mph for miles per
hour. The default is miles per hour. This option can also be set as
the X resource 'speedunits'.</para>
<para>The <option>-altunits</option> option can be used to set the
altitude units for display; follow the keyword with 'meters' or
'feet'. The default is feet. This option can also be set as the X
resource 'altunits'.</para>
<para>There is a known bug in <application>xgps</application>; it
assumes the default font size is no more than 18 pixels. If this
is not the case, the satellite data display will show fewer than
12 satellites.</para>
</refsect2>
<refsect2><title>xgpsspeed</title>
<para><application>xgpsspeed</application> is a speedometer that uses
position information from the GPS. It accepts an -h option and
optional argument as for <application>gps</application>, or a -v
option to dump the package version and exit. Additionally, it accepts
-rv (reverse video) and -nc (needle color) options.</para>
<para>The -speedunits option can be used to set the speed units for
display; follow the keyword with knots for nautical miles per hour,
kph for kilometres per hour, or mph for miles per hour. The default
is miles per hour. This option can also be set as the X resource
'speedunits'.</para>
</refsect2>
</refsect1>
<refsect1 id='see_also'><title>SEE ALSO</title>
<para>
<citerefentry><refentrytitle>gpsd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libgps</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libgpsd</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gpsprof</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gpsfake</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
</para>
</refsect1>
<refsect1 id='maintainer'><title>AUTHORS</title>
<para>Remco Treffcorn, Derrick Brashear, Russ Nelson, Eric S. Raymond.
This manual page by Eric S. Raymond <email>esr@thyrsus.com</email>.
There is a project page, with <application>xgps</application>
screenshots, <ulink
url="http://gpsd.berlios.de/">here</ulink>.</para>
</refsect1>
</refentry>
|
