1. The Source
~~~~~~~~~~~~~
You can get the source by one of these:

	wget http://lug-owl.de/~jbglaw/gpsdisplay/gpsdisplay-latest.tar.gz
	git clone http://lug-owl.de/~jbglaw/gpsdisplay.git
	git clone jbglaw@lug-owl.de:public_html/gpsdisplay.git

2. Compile
~~~~~~~~~~
As a minimum (besides a working PostGIS database and a created `gis' database
you'd access without passord), you need at least these packages installed on
a Debian box:

	osm2pgsql [1]
	libmapnik-dev
	mapnik-utils
	libgdal1-dev
	libgtk2.0-dev
	openstreetmap-map-icons-classic [2]
	libdbus-1-dev
	libdbus-glib-1-dev

Just `make' the applikation. (Anybody coming up with Autoconf/Automake
patches will get a beer or the like!)
[1] The Debian package (0.52.20080408-2) is too old, please install from
    SVN.
[2] The icons in this package are outdated, too.  The current symbols can
    be found in svn.openstreetmap.org/applications/rendering/mapnik/symbols .

3. Prepare
~~~~~~~~~~
Then download some OSM data, eg.:

wget http://download.geofabrik.de/osm/europe/germany.osm.bz2
wget http://download.geofabrik.de/osm/europe/germany/nordrhein-westfalen.osm.bz2

And import it:
osm2pgsql -c nordrhein-westfalen.osm.bz2

Also get the current osm.xml template from SVN
(svn.openstreetmap.org/applications/rendering/mapnik) and correct the symbol
pathes to match your svn checkout of those as mentioned above. An example
`sed' script to fix pathes and DB access can be found in the scripts/
subdirectory. Please note that there are two osm-template{,-fontset}.xml
files upstream. The "fontset" version is for newer (SVN) Mapnik versions,
while the plain version works with Debian's packaged version of Mapnik
(0.5.1-3 right now.)

4. Use
~~~~~~
You can now start the application. For key bindings, please have a look
at the README file. A man page or other docs would be nice to have, too,
but I didn't yet have the time to bring something up...
