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 git.debian.org. 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 git.debian.org because my request to join the team hasn't been approved as of yet. Thanks.
From 5f6bbb8f1a13d2874dc5db11902b904c107daf73 Mon Sep 17 00:00:00 2001 From: Andrew Harvey <andrew.harv...@gmail.com> 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 <andrew.harv...@gmail.com> 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 .SH CONFIGURATION -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" .TP .B type The type of layer. Options are: WMSLayer, MapnikLayer, MapServerLayer, -ImageLayer +ImageLayer, GDAL, ArcXML .TP @@ -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 +.TP +.B --version +show the program's version number and exit .TP -.B url -http://example.com/yourdir/tilecache.cgi? or -http://example.com/yourdir/tilecache.py +.B -h, --help +show the program's help message and exit + +.TP +.B -f, --force +force recreation of tiles even if they are already in cache +.TP +.B -b BBOX, --bbox=BBOX +restrict to specified bounding box where BBOX is in the format +"left, bottom, right, top" + +.TP +.B -c TILECACHECONFIG, --config=TILECACHECONFIG +path to configuration file + +.TP +.B -d DELAY, --delay=DELAY +delay time between requests (default: 0) + +.TP +.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 + +.TP +.B -r, --reverse +reverse order of seeding tiles + + +.SS Arguments + +.\" visit_block_quote .TP .B layer @@ -355,20 +388,14 @@ Zoom level to start the process .TP -.B zoom end +.B zoom stop Zoom level to end the process -.TP -.B bbox -The bounding box to seed - - - .SS Seeding by center point and radius -If called without zoom level arguments, tilecache_seed.py 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, tilecache_seed.py 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; .nf -$ /usr/sbin/tilecache_seed "http://example.com/yourdir/tilecache.cgi?"; 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 .fi 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): .nf -$ /usr/sbin/tilecache_seed.py "http://example.com/yourdir/tilecache.cgi?"; Zip_Codes 0 9 +$ /usr/sbin/tilecache_seed.py -c /etc/tilecache.cfg Zip_Codes 0 9 .fi 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: .nf -$ /usr/sbin/tilecache_seed.py "http://example.com/yourdir/tilecache.cgi?"; Zip_Codes +$ /usr/sbin/tilecache_seed.py -c /etc/tilecache.cfg Zip_Codes \-118.12500,31.952162238,0.05 \-121.46327,32.345345645,0.08 <Ctrl+D> -- 1.7.7.2
