summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorGary E. Miller <gem@rellim.com>2015-04-09 14:35:09 -0700
committerGary E. Miller <gem@rellim.com>2015-04-09 14:35:09 -0700
commitc486a0eb3e2c76d177ab870618a17de169bb409c (patch)
tree9ddc670cedf10b37410b78f5beb3ee6c5df8d5b0 /INSTALL
parentd2739ef9d4baf464149938f03413c0abead54741 (diff)
downloadgpsd-c486a0eb3e2c76d177ab870618a17de169bb409c.tar.gz
Add some SEO love, remove trailing whitespace.
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL26
1 files changed, 16 insertions, 10 deletions
diff --git a/INSTALL b/INSTALL
index ee2c1dcb..0ef1cda1 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,12 +1,18 @@
= GPSD Installation Instructions =
+:title: GPSD Installation Instructions
+:description: Here are the steps for installing GPSD and verifying its performance.
+:keywords: GPSD, GPS, installation
+:author: Eric S. Raymond <esr@thyrsus.com>
+:robots:index,follow
+:revised:April 2015
Here are the steps for installing GPSD and verifying its performance.
-They assume you have GPSD available as an installable binary package,
+They assume you have GPSD available as an installable binary package,
Instructions for building GPSD from source (including cross-building)
are in the file "build.txt" in the source distribution.
-Most of these installation instructions are generic to Linux (inc
+Most of these installation instructions are generic to Linux (inc
There are some special notes on installation for OS X and the Raspberry Pi
near the end of this file.
@@ -63,7 +69,7 @@ devices given to it on the command line by forcing their group read
and write permissions on.
On a Linux with udev, check the files in /etc/udev/permissions.d to
-ensure that /dev/tty* devices are all created with the same group
+ensure that /dev/tty* devices are all created with the same group
and with 0660 permissions.
When gpsd drops privileges, its default is to set uid to 'nobody' and
@@ -84,7 +90,7 @@ various additional features have additional prerequisites:
|==========================================================================
|pthreads library | support for PPS timekeeping on serial GPSes
-|DBUS | gpsd will issue DBUS notifications
+|DBUS | gpsd will issue DBUS notifications
|ncurses | a test client and the GPS monitor depend on this
|libtinfo5 | shared low-level terminfo library (see below)
|libusb-1.0.x or later | better USB device discovery
@@ -125,7 +131,7 @@ in the source distribution.
== How to test the software ==
-1. Start gpsd. You'll need to give it as an argument a path to
+1. Start gpsd. You'll need to give it as an argument a path to
a serial or USB port with a GPS attached to it. Your test command
should look something like this:
@@ -150,12 +156,12 @@ lock.
15-20 minutes after it gets a skyview for it to download an ephemeris
and begin delivering fixes.
-6. A FAQ and troubleshooting instructions can be found at the GPSD
+6. A FAQ and troubleshooting instructions can be found at the GPSD
project site.
== Once you have verified correct operation ==
-1. If you installed from a .deb under Debian or a Debian-derived
+1. If you installed from a .deb under Debian or a Debian-derived
system, you may need to `dpkg-reconfigure -plow gpsd' to enable the
hotplug magic ("Start gpsd automatically").
@@ -167,10 +173,10 @@ number known to work with hardware already supported.
3. GPSD includes a PHP script that you can use to generate a PHP
status page for your GPS if you wish. (It may not be in the core
-package.) It should be manually copied to your HTTP document directory.
+package.) It should be manually copied to your HTTP document directory.
The first time it's invoked, it will generate a file called
'gpsd_config.inc' in that directory containing configuration
-information; edit to taste.
+information; edit to taste.
4. There are other non-essential scripts that may be useful; these
are in the contrib/ directory of the source. They may not be available
@@ -185,7 +191,7 @@ gpsd will build, install and run on OS X. The easiest way to do so is
to first install the MacPorts package. Follow their install procedure
at: http://www.macports.org/install.php
-Then use their port command to install scons, and optionally git if you
+Then use their port command to install scons, and optionally git if you
want to access the develpment source.
--------------------------------------------------------------