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

_______________________________________________
Pkg-grass-devel mailing list
Pkg-grass-devel@lists.alioth.debian.org
http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-grass-devel

Reply via email to