shp2img command line documentation (usage message)

MapServer / MapServer-import

3 stars 2 forks source link

shp2img command line documentation (usage message) #2066

Open tbonfort opened 12 years ago

tbonfort commented 12 years ago

Reporter: jidanni@jidanni.org Date: 2007/04/09 - 11:34

Below, my comments have ">", and Warmerdam's reply doesn't.
I'm not sure if he implemented all my ideas.

> $ shp2img
> Say:
> Syntax: shp2img -m mapfile [-o image] [-e minx miny maxx maxy]
>                 [-l "layer1[ layer2]..."] [-i format]
> [Note I have changed all both lines]
> Else also no one will ever know how to add more than one layer and
> will try commas. Also -l NON_EXISTENT doesn't raise an error.
> Also besides just syntax, it should say Purpose: ... as there is no
> man page. Same for its sibling programs.
> Also add options to turn off layers.

I have updated the docs for -l.  I never would have guessed it works as it
does.  There is some sort of documentation for the utilities on the MapServer
plone site.

tbonfort commented 12 years ago

Author: tomkralidis Date: 2008/01/23 - 18:59 I'll take this one (have a working fix).

tbonfort commented 12 years ago

Author: tomkralidis Date: 2008/01/23 - 20:39 Committed to trunk in 912b8ef7b9980d0698f54ae4122ff12d92f1bec4 (r7301).

cleaned up usage text to align with flags, added those that were missing
added "Purpose" to usage text
checked for -l NON_EXISTENT, exit if layer not found
similarly cleaned up and check for layer not found for shp2pdf.c as well.
updated http://mapserver.gis.umn.edu/docs/reference/utilityreference/shp2img
updated HISTORY.TXT
no changes to msautotest in this regard

Steve: what is the -d flag for exactly? It's in the code but not documented. If you provide me an explanation on that I will update the usage text.

tbonfort commented 12 years ago

Author: tomkralidis Date: 2008/01/29 - 00:39 Steve confirmed on irc that -d is to change the DATA value for a layername on the fly.

Now updated in 004fc6ee61d050da36bd4241d401b3258e6f8322 (r7322). Closing.

tbonfort commented 12 years ago

Author: hobu Date: 2009/02/03 - 20:48 The layer test doesn't work for layers that are STATUS DEFAULT. The layer_found logic in the patch then gets broken when encountering a DEFAULT layer.

tbonfort commented 12 years ago

Author: tomkralidis Date: 2009/02/03 - 21:37 Fixed in c7f58a546034274ef25ca25927cd788cb0f4b78e (r8489). Does an initial check against all incoming layers passed, regardless of their LAYER.STATUS.

tbonfort commented 12 years ago

Author: tomkralidis Date: 2009/02/04 - 13:19 Backported to branch-5-2 in 2cd912cbff8fc095f947c3cd25a8286203c20df7 (r8494). Closing.