Package: tilecache
Version: 2.11-2
Severity: normal
Tags: patch

Dear Maintainer,

The man page for tilecache documenting the usage of the binary tilecache_seed
is outdated. I've attached a git format-patch against the git repo from The patch updates the existing man page to be consistent with
the new usage of the program.

I was unable to commit this patch directly to because my
request to join the team hasn't been approved as of yet.

From 5f6bbb8f1a13d2874dc5db11902b904c107daf73 Mon Sep 17 00:00:00 2001
From: Andrew Harvey <>
Date: Sun, 6 Nov 2011 12:04:05 +1100
Subject: [PATCH] Update man page for tilecache_seed

 debian/changelog   |    6 ++++
 debian/tilecache.8 |   70 +++++++++++++++++++++++++++++++++++----------------
 2 files changed, 54 insertions(+), 22 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 4937f63..c332696 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+tilecache (2.11-3) UNRELEASED; urgency=low
+  * Update tilecache man page
+ -- Andrew Harvey <>  Sat, 05 Nov 2011 10:42:38 +1100
 tilecache (2.11-2) unstable; urgency=low
   * Upload to unstable.
diff --git a/debian/tilecache.8 b/debian/tilecache.8
index 7a1a686..4b4fda5 100644
--- a/debian/tilecache.8
+++ b/debian/tilecache.8
@@ -150,7 +150,7 @@ Configuring FastCGI is beyond the scope of this documentation.
 .\" depart_block_quote
-TileCache is configured by a config file, defaulting to tilecache.cfg.
+TileCache is configured by a config file, defaulting to /etc/tilecache.cfg.
 There are several parameters to control TileCache layers that are applicable
 to all layers:
@@ -251,7 +251,7 @@ String describing the SRS value. Default is "EPSG:4326"
 .B type
 The type of layer. Options are: WMSLayer, MapnikLayer, MapServerLayer,
+ImageLayer, GDAL, ArcXML
@@ -329,20 +329,53 @@ need to have TileCache set up in one of the previously described configurations.
 .SS Usage
 .\" visit_block_quote
-/usr/sbin/tilecache_seed <url> <layer> [<zoom start> <zoom stop> [<bbox>]]
+/usr/sbin/tilecache_seed [options] <layer> [<zoom start> <zoom stop>]
 .\" depart_block_quote
-.SS Arguments
+.SS Options
-.\" visit_block_quote
+.B --version
+show the program's version number and exit
-.B url
- or
+.B -h, --help
+show the program's help message and exit
+.B -f, --force
+force recreation of tiles even if they are already in cache
+.B -b BBOX, --bbox=BBOX
+restrict to specified bounding box where BBOX is in the format
+"left, bottom, right, top"
+path to configuration file
+.B -d DELAY, --delay=DELAY
+delay time between requests (default: 0)
+.B -p PADDING, --padding=PADDING
+extra margin tiles to seed around target area.
+Defaults to 0 (some edge tiles might be missing).
+A value of 1 ensures all tiles will be created, but
+some tiles may be wholly outside your bbox
+.B -r, --reverse
+reverse order of seeding tiles
+.SS Arguments
+.\" visit_block_quote
 .B layer
@@ -355,20 +388,14 @@ Zoom level to start the process
-.B zoom end
+.B zoom stop
 Zoom level to end the process
-.B bbox
-The bounding box to seed
 .SS Seeding by center point and radius
-If called without zoom level arguments, will assume
-that it needs to read a list of points and radii from standard input,
-in the form:
+If called without zoom level arguments, will seed
+zoom levels 5 to 17 and assume that it needs to read a list of points
+and radii from standard input, in the form:
@@ -399,14 +426,13 @@ the position(s) to seed latitude
 the radius around the lon/lat to seed in degrees
 .SS Examples
 An example with zoom levels 5 through 12 would be like;
-$ /usr/sbin/tilecache_seed ""; Zip_Codes 5 12 "\-118.12500,31.952162238,\-116.015625,34.3071438563"
+$ /usr/sbin/tilecache_seed -c /etc/tilecache.cfg -b "\-118.12500,31.952162238,\-116.015625,34.3071438563" Zip_Codes 5 12 
 The bbox can be dropped and defaults to world lonlat(\-180,\-90,180,90):
@@ -414,7 +440,7 @@ The bbox can be dropped and defaults to world lonlat(\-180,\-90,180,90):
-$ /usr/sbin/ ""; Zip_Codes 0 9
+$ /usr/sbin/ -c /etc/tilecache.cfg Zip_Codes 0 9
 In center point/radius mode, the zoom level range is not specifiable from the
@@ -423,7 +449,7 @@ command\-line. An example usage might look like:
-$ /usr/sbin/ ""; Zip_Codes
+$ /usr/sbin/ -c /etc/tilecache.cfg Zip_Codes

Pkg-grass-devel mailing list

Reply via email to