[Gdal-dev] GDAL Utilities Documentation

[Matt Wilkie]

http://www.remotesensing.org/gdal/gdal_utilities.html

A few docco correcttions/enhancements. Additions or changes are 
[[demarked like this]].


Typos and Clarifications
------------------------

#  gdal-config - Get options required to build software using GDAL[[,]] 
against GDAL.

#Creating New Files > -a_srs: the EPSG bullet paragraph is repeated


#General Command Line Switchces

  --optfile file:

Not sure where in the document this should go, but it would nice if 
there were an example showing it's use, e.g.:

[[
gdal_translate -optfile tiff-opt.txt utm.tif utm_comp_tiled.tif

contents of tiff-opt.txt:
	-of gtiff
	-co TILED=YES
	-co COMPRESS=PACKBITS
	-co TFW=YES
	-a_srs '+proj=UTM +zone=11 datum=nad83'

is the same as:

gdal_translate -of gtiff -co TILED=YES -co COMPRESS=PACKBITS \
-co TFW=YES utm.tif -a_srs '+proj=UTM +zone=11 datum=nad83' \
utm_comp_tiled.tif
]]


gdal_info:
   o. Raster size (in pixel[[s]] and lines).

gdal_translate:
  -srcwin xoff yoff xsize ysize:
     Selects a subwindow from the source image for copying. [[Corners 
given in pixel coordinates.]]

gdal_warp:
  -wo "NAME=VALUE":
     Set a [[lot]] of warp options....




Suggested Changes
-----------------

--help-general:

Why be so specific? Better to use '--help' for general help. This is how 
most linux utilities seem to work.


--format format-name

Might make more sense to use '--help format-name' instead.


gdal_warp:
  -rn, -rb, -rc, -rcs:

Better to harmonize with with gdaladdo -r {nearest,average,...}




matt wilkie
--------------------------------------------
Geographic Information,
Information Management and Technology,
Yukon Department of Environment
10 Burns Road * Whitehorse, Yukon * Y1A 4Y9
867-667-8133 Tel * 867-393-7003 Fax
--------------------------------------------