[DebianGIS-dev] r1551 - in packages/mkgmap/trunk: . debian debian/scripts
nd-guest at alioth.debian.org
nd-guest at alioth.debian.org
Sun Apr 20 20:46:20 UTC 2008
Author: nd-guest
Date: 2008-04-20 20:46:19 +0000 (Sun, 20 Apr 2008)
New Revision: 1551
Added:
packages/mkgmap/trunk/debian/
packages/mkgmap/trunk/debian/ant.properties
packages/mkgmap/trunk/debian/changelog
packages/mkgmap/trunk/debian/compat
packages/mkgmap/trunk/debian/control
packages/mkgmap/trunk/debian/copyright
packages/mkgmap/trunk/debian/dirs
packages/mkgmap/trunk/debian/docs
packages/mkgmap/trunk/debian/install
packages/mkgmap/trunk/debian/manpages
packages/mkgmap/trunk/debian/mkgmap.1
packages/mkgmap/trunk/debian/rules
packages/mkgmap/trunk/debian/scripts/
packages/mkgmap/trunk/debian/scripts/mkgmap
packages/mkgmap/trunk/debian/watch
Log:
[svn-inject] Applying Debian modifications to trunk
Property changes on: packages/mkgmap/trunk/debian
___________________________________________________________________
Name: mergeWithUpstream
+ 1
Added: packages/mkgmap/trunk/debian/ant.properties
===================================================================
--- packages/mkgmap/trunk/debian/ant.properties (rev 0)
+++ packages/mkgmap/trunk/debian/ant.properties 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1,2 @@
+ant.build.javac.source=1.5
+ant.build.javac.target=1.5
Added: packages/mkgmap/trunk/debian/changelog
===================================================================
--- packages/mkgmap/trunk/debian/changelog (rev 0)
+++ packages/mkgmap/trunk/debian/changelog 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1,5 @@
+mkgmap (0.0.0+svn569-1) unstable; urgency=low
+
+ * Initial release (Closes: #475773)
+
+ -- Andreas Putzo <andreas at putzo.net> Sun, 13 Apr 2008 19:29:58 +0000
Added: packages/mkgmap/trunk/debian/compat
===================================================================
--- packages/mkgmap/trunk/debian/compat (rev 0)
+++ packages/mkgmap/trunk/debian/compat 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1 @@
+5
Added: packages/mkgmap/trunk/debian/control
===================================================================
--- packages/mkgmap/trunk/debian/control (rev 0)
+++ packages/mkgmap/trunk/debian/control 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1,16 @@
+Source: mkgmap
+Section: utils
+Priority: extra
+Maintainer: Debian GIS Project <pkg-grass-devel at lists.alioth.debian.org>
+Uploaders: Andreas Putzo <andreas at putzo.net>
+Build-Depends: ant, cdbs, debhelper (>= 5), java-gcj-compat-dev
+Standards-Version: 3.7.3
+Homepage: http://www.parabola.me.uk/mkgmap
+
+Package: mkgmap
+Architecture: all
+Depends: java-gcj-compat | java2-runtime
+Suggests: josm, qlandkarte
+Description: Generate Garmin maps from OpenStreetMap data
+ This program converts OpenStreetMap data into a map that
+ can be loaded onto a Garmin GPS device.
Added: packages/mkgmap/trunk/debian/copyright
===================================================================
--- packages/mkgmap/trunk/debian/copyright (rev 0)
+++ packages/mkgmap/trunk/debian/copyright 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1,33 @@
+This package was debianized by Andreas Putzo <andreas at putzo.net> on
+Sun, 13 Apr 2008 19:29:58 +0000.
+
+It was downloaded from http://www.parabola.me.uk/mkgmap/snapshots/
+
+Upstream Author:
+
+ Steve Ratcliffe <sr at parabola.me.uk>
+
+Copyright:
+
+ Copyright (C) 2007, 2008 Steve Ratcliffe <sr at parabola.me.uk>
+
+License:
+
+ This package is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License version 2 as
+ published by the Free Software Foundation.
+
+ This package is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this package; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+
+On Debian systems, the complete text of the GNU General
+Public License can be found in `/usr/share/common-licenses/GPL-2'.
+
+The Debian packaging is (C) 2008, Andreas Putzo <andreas at putzo.net> and
+is licensed under the GPL version 2, see above.
Added: packages/mkgmap/trunk/debian/dirs
===================================================================
--- packages/mkgmap/trunk/debian/dirs (rev 0)
+++ packages/mkgmap/trunk/debian/dirs 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1 @@
+usr/bin
Added: packages/mkgmap/trunk/debian/docs
===================================================================
--- packages/mkgmap/trunk/debian/docs (rev 0)
+++ packages/mkgmap/trunk/debian/docs 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1,3 @@
+README
+doc/Credits
+resources/garmin_feature_list.csv
Added: packages/mkgmap/trunk/debian/install
===================================================================
--- packages/mkgmap/trunk/debian/install (rev 0)
+++ packages/mkgmap/trunk/debian/install 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1,2 @@
+dist/mkgmap.jar usr/share/mkgmap/
+debian/scripts/mkgmap usr/bin/
Added: packages/mkgmap/trunk/debian/manpages
===================================================================
--- packages/mkgmap/trunk/debian/manpages (rev 0)
+++ packages/mkgmap/trunk/debian/manpages 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1 @@
+debian/mkgmap.1
Added: packages/mkgmap/trunk/debian/mkgmap.1
===================================================================
--- packages/mkgmap/trunk/debian/mkgmap.1 (rev 0)
+++ packages/mkgmap/trunk/debian/mkgmap.1 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1,138 @@
+.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.
+.br
+The mapping between OSM features and the features in the map can be customized with a file.
+.SH OPTIONS
+.TP
+.B \-c <filename>
+The given file is opened and each line is an option setting of the form
+option=value, just like on the command line except that there is no leading '--'.
+.TP
+.B \-n, \-\-mapname=name
+Change the name of the map. Garmin maps are named by 8 digit numbers.
+The default ist 63240001. It is best to change the name if you are going
+to be making a map for others to use so that it is unique and does not
+clash with others.
+.TP
+.B \-\-description=text
+Sets the descriptive text for the map. This may be displayed in
+QLandkarte, MapSource or on a GPS etc.
+.TP
+.B \-\-map-features=file
+Use your own map features file. You can totally change which features
+are shown and at what levels. See
+.SM
+.B CUSTOMISING THE MAP
+below.
+.TP
+.B \-\-levels=levels code
+Change the way that the levels on the map correspond to the zoom levels
+in the device. See
+.SM
+.B CUSTOMISING THE MAP
+below. The default is the equivalent of: "0=24, 1=22, 2=21, 3=19, 4=18, 5=16" although this may change.
+.TP
+.B \-\-latin1
+This option allows the use of non-ascii characters in street names. It
+is hardware dependant what is actually supported on a particular
+device. Some devices can only do ascii characters for example.
+.br
+Mkgmap goes to some length to convert un-displayable characters however. It
+will convert accented characters that cannot be displayed in the chosen
+character set into unaccented characters.
+.SH CUSTOMISING THE MAP
+You can completely change which features are displayed and at what zoom levels.
+.PP
+There are two concepts 'resolution' and 'level'.
+.PP
+.SS Resolution
+is a number between 1 and 24 with 24 being the most detailed resolution and each number
+less is half as detailed.
+.br
+So for example if a road was 12 units long at resolution 24 it would be only 6 at resolution
+23 and just 3 at resolution 22.
+.br
+On a Garmin Legend Cx the resolution corresponds to these scales on the device:
+.RS
+16 30km-12km
+.br
+18 8km-3km
+.br
+20 2km-800m
+.br
+22 500m-200m
+.br
+23 300m-80m
+.br
+24 120m-50m
+.RE
+.br
+It may be slightly different on different devices.
+.SS Level
+.br
+is a number between 0 and 16 (although perhaps numbers above 10 are not usable), with
+0 corresponding to the most detailed view. The map consists of a number of levels starting
+(usually) with 0. For example 0, 1, 2, 3 and a different amount of detail is added
+at each level.
+.br
+The map also contains a table to link the level to the resolution. So you can say
+that level 0 corresponds to resolution 24.
+.br
+You can specify this mapping on the command line, for example:
+.RS
+\-\-levels=0:24,1:22,2:20
+.RE
+This means that the map will have three levels. Level 0 in the map will
+correspond to resolution 24 (the most detailed), level 1 will show at
+resolution 22 (between scales of 500m and 200m) and so on.
+.SS Map features
+Custom map features can be applied using a delimeted file among with
+the
+.IR --map-features
+command line option.
+.br
+A typical line may look like this:
+.RS
+.PP
+point|amenity|grave_yard|0x64|0x03|23
+.RE
+.PP
+Column 1 is point, polyline or polygon, depending on whether the feature is a point of interest,
+a line feature such as a road or an area such as a park.
+.br
+Column 2 and 3 are taken exactly from the key and value columns from the OSM map features.
+.br
+Column 4 is the garmin code that you want to use.
+.br
+Column 5 only applies to points and also determines the type of the object.
+.br
+Column 6 is the minimum resolution at which this feature will appear.
+.PP
+The file
+.IR /usr/share/doc/mkgmap/garmin_features_list.csv
+has a list of known type values used by Garmin.
+
+.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 written by Steve Ratcliffe <sr at parabola.me.uk>.
+.PP
+This manual page was written by Andreas Putzo <andreas at putzo.net>,
+for the Debian project (but may be used by others).
Added: packages/mkgmap/trunk/debian/rules
===================================================================
--- packages/mkgmap/trunk/debian/rules (rev 0)
+++ packages/mkgmap/trunk/debian/rules 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1,12 @@
+#!/usr/bin/make -f
+# debian/rules file for mkgmap (uses cdbs)
+
+include /usr/share/cdbs/1/rules/debhelper.mk
+include /usr/share/cdbs/1/class/ant.mk
+include /usr/share/cdbs/1/rules/simple-patchsys.mk
+
+JAVA_HOME := /usr/lib/jvm/java-gcj/
+ANT_HOME := /usr/share/ant
+DEB_ANT_BUILD_TARGET := dist
+DEB_ANT_CLEAN_TARGET := clobber
+
Property changes on: packages/mkgmap/trunk/debian/rules
___________________________________________________________________
Name: svn:executable
+ *
Added: packages/mkgmap/trunk/debian/scripts/mkgmap
===================================================================
--- packages/mkgmap/trunk/debian/scripts/mkgmap (rev 0)
+++ packages/mkgmap/trunk/debian/scripts/mkgmap 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1,5 @@
+#! /bin/sh
+# Simple wrapper script to execute mkgmap in Debian
+set -e
+
+exec /usr/bin/java -jar /usr/share/mkgmap/mkgmap.jar "$@"
Added: packages/mkgmap/trunk/debian/watch
===================================================================
--- packages/mkgmap/trunk/debian/watch (rev 0)
+++ packages/mkgmap/trunk/debian/watch 2008-04-20 20:46:19 UTC (rev 1551)
@@ -0,0 +1,3 @@
+version=3
+opts="dversionmangle=s/0.0.0.svn//,uversionmangle=s/^r//" \
+http://www.parabola.me.uk/mkgmap/snapshots/mkgmap-(.*)-src\.tar\.gz
More information about the Pkg-grass-devel
mailing list