.TH MKGMAP 1 "April 13, 2008"
.\" Please adjust this date whenever revising the manpage.
.SH NAME
mkgmap \- Generate Garmin maps from OpenStreetMap data
.SH SYNOPSIS
.B mkgmap
.RI [ options ] " files.osm " ...
.SH DESCRIPTION
This manual page documents briefly the
.B mkgmap
command.
.PP
\fBmkgmap\fP is a program that converts OpenStreetMap (OSM) data into a map that can be
loaded onto a Garmin GPS device. 
The mapping between OSM features and the features in the map can be
completely customized by writing what we term a "style".
.SH OPTIONS
.TP
.B \-\-help <filename>
Use this option to get alist of the built in help topics.
In particular calling \-\-help=options will list all the available
options and is always up to date.
.SH ACKNOWLEDGEMENTS
This project is almost entirely based on the file format specification
document written by John Mechalas at the SourceForge project at
http://sourceforge.net/projects/garmin-img.
.SH SEE ALSO
.BR josm (1),
.BR qlandkarte (1).
.SH AUTHOR
mkgmap was originally written by Steve Ratcliffe <sr@parabola.me.uk>
and has been improved by many other people since.
.PP
This manual page was written by Andreas Putzo <andreas@putzo.net>,
for the Debian project (but may be used by others).