diff --git a/gdal/apps/gdal_utilities.dox b/gdal/apps/gdal_utilities.dox index 0e9b9476c76f..65814c335917 100644 --- a/gdal/apps/gdal_utilities.dox +++ b/gdal/apps/gdal_utilities.dox @@ -34,6 +34,7 @@ The following utility programs are distributed with GDAL.
  • \ref gdalmove - Transform the coordinate system of a file (GDAL >= 1.10)
  • \ref gdal_edit - Edit in place various information of an existing GDAL dataset (projection, geotransform, nodata, metadata)
  • \ref gdal-config - Get options required to build software using GDAL. +
  • \ref gdalmanage - Identify, copy, rename and delete raster. \section gdal_utilities_creating Creating New Files @@ -2311,3 +2312,93 @@ GEOGCS["SAD69", Frank Warmerdam , Etienne Tourigny \endif */ + +******************************************************************************* +/*! \page gdalmanage gdalmanage + +Identify, delete, rename and copy raster data files + +\section gdalmanage_synopsis SYNOPSIS + +\verbatim +Usage: gdalmanage mode [-r] [-u] [-f format] + datasetname [newdatasetname] +\endverbatim + +\section gdalmanage_description DESCRIPTION + +The gdalmanage program can perform various operations on raster data files, depending on the chosen mode. This includes identifying raster data types and deleting, renaming or copying the files. + +
    +
    mode:
    Mode of operation
    +
    +
    identify datasetname:
    List data format of file.
    +
    copy datasetname newdatasetname:
    Create a copy of the raster file with a new name.
    +
    rename datasetname newdatasetname:
    Change the name of the raster file.
    +
    delete datasetname:
    Delete raster file.
    +
    + +
    -r:
    Recursively scan files/folders for raster files.
    +
    -u:
    Report failures if file type is unidentified.
    +
    -f format:
    Specify format of raster file if unknown by the application. Uses short data format name (e.g. GTiff).
    + +
    datasetname:
    Raster file to operate on.
    +
    newdatasetname:
    For copy and rename modes, you provide a source filename and a target filename, just like copy and move commands in an operating system.
    +
    + +\section gdalmanage_exampes EXAMPLES + +\subsection gdalmanage_example_identify Using identify mode + +Report the data format of the raster file by using the identify mode and specifying a data file name: + +\verbatim +$ gdalmanage identify NE1_50M_SR_W.tif + +NE1_50M_SR_W.tif: GTiff +\endverbatim + +Recursive mode will scan subfolders and report the data format: + +\verbatim +$ gdalmanage identify -r 50m_raster/ + +NE1_50M_SR_W/ne1_50m.jpg: JPEG +NE1_50M_SR_W/ne1_50m.png: PNG +NE1_50M_SR_W/ne1_50m_20pct.tif: GTiff +NE1_50M_SR_W/ne1_50m_band1.tif: GTiff +NE1_50M_SR_W/ne1_50m_print.png: PNG +NE1_50M_SR_W/NE1_50M_SR_W.aux: HFA +NE1_50M_SR_W/NE1_50M_SR_W.tif: GTiff +NE1_50M_SR_W/ne1_50m_sub.tif: GTiff +NE1_50M_SR_W/ne1_50m_sub2.tif: GTiff + +\endverbatim +\subsection gdalmanage_example_copy Using copy mode + +Copy the raster data: + +\verbatim +$ gdalmanage copy NE1_50M_SR_W.tif ne1_copy.tif +\endverbatim + +\subsection gdalmanage_example_rename Using rename mode + +Rename raster data: +\verbatim +$ gdalmanage rename NE1_50M_SR_W.tif ne1_rename.tif +\endverbatim + +\subsection gdalmanage_example_delete Using delete mode + +Delete the raster data: + +\verbatim +gdalmanage delete NE1_50M_SR_W.tif +\endverbatim + +\if man +\section gdalmanage_author AUTHORS +Tyler Mitchell +\endif +*/