[tilestache] 19/22: Add manpage for tilestache-compose & tilestache-list.

[Bas Couwenberg]

This is an automated email from the git hooks/post-receive script.

sebastic pushed a commit to branch master
in repository tilestache.

commit b6159eb03a1b4704202b2c48a0091c3455e168b2
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Thu Oct 27 23:17:28 2016 +0200

    Add manpage for tilestache-compose & tilestache-list.
---
 debian/changelog              |   1 +
 debian/patches/manpages.patch | 107 ++++++++++++++++++++++++++++++++++++++++++
 debian/patches/series         |   1 +
 3 files changed, 109 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index e5b8002..e41aae6 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -9,6 +9,7 @@ tilestache (1.51.2-1) UNRELEASED; urgency=medium
   * Enable tests with nose.
   * Drop tilestache-clean manpage, included upstream.
   * Bump Standards-Version to 3.9.8, no changes.
+  * Add manpage for tilestache-compose & tilestache-list.
 
  -- Bas Couwenberg <sebastic at debian.org>  Thu, 27 Oct 2016 17:15:15 +0200
 
diff --git a/debian/patches/manpages.patch b/debian/patches/manpages.patch
new file mode 100644
index 0000000..9749276
--- /dev/null
+++ b/debian/patches/manpages.patch
@@ -0,0 +1,107 @@
+Description: Add missing manpages.
+Author: Bas Couwenberg <sebastic at debian.org>
+
+--- /dev/null
++++ b/man/tilestache-compose.1
+@@ -0,0 +1,58 @@
++.TH TILESTACHE-COMPOSE 1 "Nov 10, 2010"
++.SH NAME
++tilestache-compose \- set a map coverage area
++.SH SYNOPSIS
++.B tilestache-compose
++.RI [ options ] " file" ...
++.SH DESCRIPTION
++This manual page documents briefly the \fBtilestache-compose\fR command.
++.PP
++There are three ways to set a map coverage area.
++.PP
++1) Center, zoom, and dimensions: create a map of the specified size,
++centered on a given geographical point at a given zoom level:
++.PP
++   tilestache-compose.py \-c config.json \-l layer-name \-d 800 800 \-n 37.8 \-122.3 \-z 11 out.jpg
++.PP
++2) Extent and dimensions: create a map of the specified size that
++adequately covers the given geographical extent:
++.PP
++   tilestache-compose.py \-c config.json \-l layer-name \-d 800 800 \-e 36.9 \-123.5 38.9 \-121.2 out.png
++.PP
++3) Extent and zoom: create a map at the given zoom level that covers
++the precise geographical extent, at whatever pixel size is necessary:
++.PP
++   tilestache-compose.py \-c config.json \-l layer-name \-e 36.9 \-123.5 38.9 \-121.2 \-z 9 out.jpg
++.SH OPTIONS
++.TP
++\fB-c\fR, \fB\-\-config\fR \fIfile\fR
++Path to configuration file.
++.TP
++\fB-l\fR, \fB\-\-layer\fR \fIlayer\fR
++Layer name from configuration.
++.TP
++\fB-n\fR, \fB\-\-center\fR \fIlat lon\fR
++Geographic center of map.
++.TP
++\fB-e\fR, \fB\-\-extent\fR \fIlat lon lat lon\fR
++Geographic extent of map.
++.TP
++\fB-z\fR, \fB\-\-zoom\fR \fIlevel\fR
++Zoom level.
++.TP
++\fB-d\fR, \fB\-\-dimensions\fR \fIwidth height\fR
++Pixel width, height of output image.
++.TP
++\fB-v\fR, \fB\-\-verbose\fR
++Make a bunch of noise.
++.TP
++\fB-i\fR, \fB\-\-include-paths\fR \fIpaths\fR
++Add the following colon-separated list of paths to Python's include path (aka sys.path)
++.TP
++\fB-x\fR, \fB\-\-ignore-cached\fR
++Re-render every tile, whether it is in the cache already or not.
++.TP
++\fB-h\fR, \fB\-\-help\fR
++Show summary of options.
++.SH AUTHOR
++\fBTileStache\fR was written by Michal Migurski <mike at stamen.com>.
+--- /dev/null
++++ b/man/tilestache-list.1
+@@ -0,0 +1,40 @@
++.TH TILESTACHE-LIST 1 "Nov 10, 2010"
++.SH NAME
++tilestache-list \- generates list of tiles based on geographic or other criteria
++.SH SYNOPSIS
++.B tilestache-list
++.RI [ options ]
++.RI [ zoom... ]
++.SH DESCRIPTION
++This manual page documents briefly the \fBtilestache-list\fR command.
++.PP
++\fBtilestache\-list\fP generates a list of tiles based on geographic or
++other criteria.
++.PP
++No images are created and no Tilestache configuration is read, but a list
++of tile coordinates in Z/X/Y form compatible with
++\fBtilestache-seed \-\-tile-list\fP output.
++.PP
++Example:
++.PP
++    tilestache\-list.py \-b 52.55 13.28 52.46 13.51 11 12 13
++.PP
++Protip: seed a cache in parallel on 8 CPUs with split and xargs like this:
++.PP
++    tilestache\-list.py 12 13 14 15 | split \-l 20 \- tiles/list\-
++    ls \-1 tiles/list\-* | xargs \-n1 \-P8 tilestache\-seed.py \-c tilestache.cfg \-l osm \-\-tile\-list
++.SH OPTIONS
++.TP
++\fB-b\fR, \fB\-\-bbox\fR \fIlat lon lat lon\fR
++Bounding box in floating point geographic coordinates:
++south west north east.
++.TP
++\fB-p\fR, \fB\-\-padding\fR \fInumber\fR
++Extra margin of tiles to add around bounded area.
++.TP
++\fB\-\-from\-mbtiles\fR \fIfile\fR
++Optional input file for tiles, will be read as an MBTiles 1.1 tileset.
++See http://mbtiles.org for more information.
++Overrides \-\-bbox and \-\-padding.
++.SH AUTHOR
++\fBTileStache\fR was written by Michal Migurski <mike at stamen.com>.
diff --git a/debian/patches/series b/debian/patches/series
index 8fbd8ed..8e9f747 100644
--- a/debian/patches/series
+++ b/debian/patches/series
@@ -4,3 +4,4 @@
 04-fix_for_newer_modestmaps.patch
 pillow-3.0.0.patch
 skip-tests.patch
+manpages.patch

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/tilestache.git