@crossbind/port-gdal-wasi 2.0.0-beta.50

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-raster-create.1

@@ -0,0 +1,290 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "GDAL-RASTER-CREATE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-create \- Create a new raster dataset
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster create [OPTIONS] <OUTPUT>
+
+Create a new raster dataset.
+
+Positional arguments:
+  \-o, \-\-output <OUTPUT>                                    Output raster dataset [required] [not available in pipelines]
+
+Common Options:
+  \-h, \-\-help                                               Display help message and exit
+  \-\-json\-usage                                             Display usage as JSON document and exit
+  \-\-config <KEY>=<VALUE>                                   Configuration option [may be repeated]
+  \-q, \-\-quiet                                              Quiet mode (no progress bar or warning message) [not available in pipelines]
+
+Options:
+  \-i, \-\-like, \-\-input <TEMPLATE\-DATASET>                   Template raster dataset [not available in pipelines]
+  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>      Output format (\(dqGDALG\(dq allowed) [not available in pipelines]
+  \-\-co, \-\-creation\-option <KEY>=<VALUE>                    Creation option [may be repeated] [not available in pipelines]
+  \-\-overwrite                                              Whether overwriting existing output dataset is allowed [not available in pipelines]
+                                                           Mutually exclusive with \-\-append
+  \-\-append                                                 Append as a subdataset to existing output [not available in pipelines]
+                                                           Mutually exclusive with \-\-overwrite
+  \-\-size <width>,<height>                                  Output size in pixels
+  \-\-band\-count <BAND\-COUNT>                                Number of bands (default: 1)
+  \-\-ot, \-\-datatype, \-\-output\-data\-type <OUTPUT\-DATA\-TYPE>  Output data type. OUTPUT\-DATA\-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 (default: Byte)
+  \-\-nodata <NODATA>                                        Assign a specified nodata value to output bands (\(aqnone\(aq, numeric value, \(aqnan\(aq, \(aqinf\(aq, \(aq\-inf\(aq)
+  \-\-burn <BURN>                                            Burn value [may be repeated]
+  \-\-crs <CRS>                                              Set CRS
+  \-\-bbox <BBOX>                                            Bounding box as xmin,ymin,xmax,ymax
+  \-\-metadata <KEY>=<VALUE>                                 Add metadata item [may be repeated]
+  \-\-copy\-metadata                                          Copy metadata from input dataset
+                                                           Depends on \-\-input
+  \-\-copy\-overviews                                         Create same overview levels as input dataset
+                                                           Depends on \-\-input
+
+Advanced Options:
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>                      Input formats [may be repeated] [not available in pipelines]
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>                        Open options [may be repeated] [not available in pipelines]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal raster create\fP can be used to initialize a new raster file,
+from its dimensions, band count, CRS, geotransform, nodata value and metadata.
+.sp
+The new file can also be initialized from a model input file with the optional
+\fI\%\-\-like\fP option, copying its properties but not its pixel values.
+By default, metadata and the overview structure are not copied from the model
+input file, unless \fI\%\-\-copy\-metadata\fP and \fI\%\-\-copy\-overviews\fP
+are specified.
+Options \fI\%\-\-size\fP, \fI\%\-\-band\-count\fP, \fI\%\-\-datatype\fP,
+\fI\%\-\-nodata\fP, \fI\%\-\-crs\fP, \fI\%\-\-bbox\fP, \fI\%\-\-metadata\fP
+can be used to override the values inherited from the model input file.
+.sp
+For GeoTIFF output, setting the \fBSPARSE_OK\fP creation option to \fBYES\fP
+can be useful to create a file of minimum size.\(ga
+.sp
+\fBgdal raster create\fP can be used also in special cases, like creating
+a PDF file from a XML composition file.
+.sp
+Since GDAL 3.13, \fBcreate\fP can also be used as a step of \fI\%gdal raster pipeline\fP\&.
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-band\-count <count>
+Number of bands. Defaults to 1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-bbox <xmin>,<ymin>,<xmax>,ymax>
+Sets the spatial bounding box, in CRS units.
+\(aqx\(aq is longitude values for geographic CRS and easting for projected CRS.
+\(aqy\(aq is latitude values for geographic CRS and northing for projected CRS.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-burn <value>
+A fixed value to burn into a band. A list of \fI\%\-\-burn\fP options
+can be supplied, one per band (the first value will apply to the first band,
+the second one to the second band, etc.). If a single value is specified,
+it will apply to all bands.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-copy\-metadata
+Copy metadata from input dataset and raster bands.
+Requires \fI\%\-\-like\fP to be specified.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-copy\-overviews
+Create same overview levels as input dataset (but with empty content).
+Requires \fI\%\-\-like\fP to be specified.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-crs <CRS>
+Set CRS.
+.sp
+The coordinate reference systems that can be passed are anything supported by the
+\fI\%OGRSpatialReference::SetFromUserInput()\fP call, which includes EPSG Projected,
+Geographic or Compound CRS (i.e. EPSG:4296), a well known text (WKT) CRS definition,
+PROJ.4 declarations, or the name of a .prj file containing a WKT CRS definition.
+.sp
+\fBnull\fP or \fBnone\fP can be specified to unset the existing CRS of the
+\fI\%\-\-like\fP dataset if it is set.
+.sp
+Note that the spatial extent is also left unchanged.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-i, \-\-like, \-\-input <TEMPLATE\-DATASET>
+Name of GDAL input dataset that serves as a template for default values of
+options \fI\%\-\-size\fP, \fI\%\-\-band\-count\fP, \fI\%\-\-datatype\fP,
+\fI\%\-\-crs\fP, \fI\%\-\-bbox\fP and \fI\%\-\-nodata\fP\&.
+Note that the pixel values will \fInot\fP be copied.
+.sp
+Since GDAL 3.13, if the input dataset is tiled, and for output formats
+\fBGTiff\fP, \fBCOG\fP and \fBGPKG\fP, its tile dimensions are replicated to
+the output file, when they are compatible of its capabilities, and if the
+user hasn\(aqt specified any creation option related to tiling.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-metadata <KEY>=<VALUE>
+Adds a metadata item, at the dataset level.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-nodata <value>
+Sets the nodata value.
+.sp
+\fBnull\fP or \fBnone\fP can be specified to unset the existing nodata value of the
+\fI\%\-\-like\fP dataset if it is set.
+\fBnan\fP, \fBinf\fP or \fB\-inf\fP are also accepted for floating point rasters
+to respectively mean the special values not\-a\-number, positive infinity and
+minus infinity.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-size <xsize>,<ysize>
+Set the size of the output file in pixels. First value is width. Second one
+is height.
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-append
+Append input raster as a new subdataset to an existing output file.
+Only works with drivers that support adding subdatasets such as
+\fI\%GTiff \-\- GeoTIFF File Format\fP and \fI\%GPKG \-\- GeoPackage raster\fP
+This also creates the output dataset if it does not exist yet.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
+Many formats have one or more optional creation options that can be
+used to control particulars about the file created. For instance,
+the GeoTIFF driver supports creation options to control compression,
+and whether the file should be tiled.
+.sp
+May be repeated.
+.sp
+The creation options available vary by format driver, and some
+simple formats have no creation options at all. A list of options
+supported for a format can be listed with the
+\fI\%\-\-formats\fP
+command line option but the documentation for the format is the
+definitive source of information on driver creation options.
+See \fI\%Raster drivers\fP format
+specific documentation for legal creation options for each format.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-if, \-\-input\-format <format>
+Format/driver name to be attempted to open the input file(s). It is generally
+not necessary to specify it, but it can be used to skip automatic driver
+detection, when it fails to select the appropriate driver.
+This option can be repeated several times to specify several candidate drivers.
+Note that it does not force those drivers to open the dataset. In particular,
+some drivers have requirements on file extensions.
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
+Dataset open option (format specific).
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-ot, \-\-datatype, \-\-output\-data\-type <OUTPUT\-DATA\-TYPE>
+Output data type among \fBByte\fP, \fBInt8\fP, \fBUInt16\fP, \fBInt16\fP, \fBUInt32\fP,
+\fBInt32\fP, \fBUInt64\fP, \fBInt64\fP, \fBCInt16\fP, \fBCInt32\fP, \fBFloat32\fP,
+\fBFloat64\fP, \fBCFloat32\fP, \fBCFloat64\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
+Which output raster format to use. Allowed values may be given by
+\fBgdal \-\-formats | grep raster | grep + | sort\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-overwrite
+Allow program to overwrite existing target file or dataset.
+Otherwise, by default, \fBgdal\fP errors out if the target file or
+dataset already exists.
+.UNINDENT
+.SH RETURN STATUS CODE
+.sp
+The program returns status code 0 in case of success, and non\-zero in case of
+error (non\-blocking errors emitted as warnings are considered as a successful
+execution).
+.SH EXAMPLES
+.SS Example 1: Initialize a new GeoTIFF file with 3 bands and a uniform value of 10
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster create \-\-size=20,20 \-\-band\-count=3 \-\-crs=EPSG:4326 \-\-bbox=2,49,3,50 \-\-burn 10 out.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Create a PDF file from a XML composition file
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster create \-\-creation\-option COMPOSITION_FILE=composition.xml out.pdf
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Initialize a blank GeoTIFF file from an input one
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal raster create \-\-like prototype.tif output.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-raster-edit.1

@@ -0,0 +1,405 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "GDAL-RASTER-EDIT" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-raster-edit \- Edit in place a raster dataset
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal raster edit [OPTIONS] <DATASET>
+
+Edit a raster dataset.
+
+Positional arguments:
+  \-\-dataset <DATASET>                                         Dataset (to be updated in\-place, unless \-\-auxiliary) [required] [not available in pipelines]
+
+Common Options:
+  \-h, \-\-help                                                  Display help message and exit
+  \-\-json\-usage                                                Display usage as JSON document and exit
+  \-\-config <KEY>=<VALUE>                                      Configuration option [may be repeated]
+  \-q, \-\-quiet                                                 Quiet mode (no progress bar or warning message) [not available in pipelines]
+
+Options:
+  \-\-auxiliary                                                 Ask for an auxiliary .aux.xml file to be edited [not available in pipelines]
+  \-b, \-\-band <BAND>                                           Active band (1\-based index)
+  \-\-crs <CRS>                                                 Override CRS (without reprojection)
+  \-\-bbox <BBOX>                                               Bounding box as xmin,ymin,xmax,ymax
+  \-\-nodata <NODATA>                                           Assign a specified nodata value to output bands (\(aqnone\(aq, numeric value, \(aqnan\(aq, \(aqinf\(aq, \(aq\-inf\(aq)
+  \-\-color\-interpretation <[all|<BAND>=]<COLOR\-INTEPRETATION>  Set band color interpretation [may be repeated]
+  \-\-color\-map <COLOR\-MAP>                                     Color map filename
+                                                              Mutually exclusive with \-\-unset\-color\-table
+  \-\-scale <[<BAND>=]<SCALE>                                   Override band scale factor [may be repeated]
+  \-\-offset <[<BAND>=]<OFFSET>                                 Override band offset constant [may be repeated]
+  \-\-metadata <KEY>=<VALUE>                                    Add/update dataset metadata item [may be repeated]
+  \-\-unset\-color\-table                                         Unset color table on 1st band or the one specified with \-\-band
+                                                              Mutually exclusive with \-\-color\-map
+  \-\-unset\-metadata <KEY>                                      Remove dataset metadata item(s) [may be repeated]
+  \-\-unset\-metadata\-domain <DOMAIN>                            Remove dataset metadata domain(s) [may be repeated]
+  \-\-gcp <GCP>                                                 Add ground control point, formatted as pixel,line,easting,northing[,elevation], or @filename [may be repeated]
+  \-\-stats                                                     Compute statistics, using all pixels
+                                                              Mutually exclusive with \-\-approx\-stats
+  \-\-approx\-stats                                              Compute statistics, using a subset of pixels
+                                                              Mutually exclusive with \-\-stats
+  \-\-hist                                                      Compute histogram
+
+Advanced Options:
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>                           Open options [may be repeated] [not available in pipelines]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal raster edit\fP can be used to edit a raster dataset.
+.sp
+This subcommand is also available as a potential step of \fI\%gdal raster pipeline\fP
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-approx\-stats
+Compute raster band statistics for all bands. They may be computed
+based on overviews or a subset of all tiles. Useful if you are in a
+hurry and don\(aqt need precise stats.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+This option is not available when the command is part of a pipeline.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-auxiliary
+Force opening the dataset in read\-only mode. For drivers that implement the
+Persistent Auxiliary Metadata (PAM) mechanism, changes will be
+saved in an auxiliary side car file of extension \fB\&.aux.xml\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-b, \-\-band <BAND>
+Added in version 3.13.
+
+.sp
+Index (starting at 1) of the band to which the following options apply:
+\fI\%\-\-color\-map\fP, \fI\%\-\-unset\-color\-table\fP\&. Defaults to one if
+not specified.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-bbox <xmin>,<ymin>,<xmax>,ymax>
+Override the spatial bounding box, in CRS units, without reprojecting or subsetting.
+\(aqx\(aq is longitude values for geographic CRS and easting for projected CRS.
+\(aqy\(aq is latitude values for geographic CRS and northing for projected CRS.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-color\-map <COLOR\-MAP>
+Added in version 3.13.
+
+.sp
+Color map filename containing the association between various raster
+values and the corresponding wished color to set on the first band, or the
+one specified by \fI\%\-\-band\fP\&. This can be either a GDAL dataset
+with a color table attached to its first band or a text\-based color configuration
+.sp
+The text\-based color configuration file generally contains 4 columns
+per line: the raster value and the corresponding Red, Green, Blue
+component (between 0 and 255). The raster value mus be an integer value
+between 0 and 65535.
+The raster value can also be expressed as a percentage: 0% being the minimum
+value found in the raster, 100% the maximum value.
+.sp
+An extra column can be optionally added for the alpha component.
+If it is not specified, full opacity (255) is assumed.
+.sp
+Various field separators are accepted: comma, tabulation, spaces, \(aq:\(aq.
+.sp
+Common colors used by GRASS can also be specified by using their name,
+instead of the RGB triplet. The supported list is: white, black, red,
+green, blue, yellow, magenta, cyan, aqua, grey/gray, orange, brown,
+purple/violet and indigo.
+.INDENT 7.0
+.INDENT 3.5
+GMT \fB\&.cpt\fP palette files are also supported (COLOR_MODEL = RGB only).
+.UNINDENT
+.UNINDENT
+.sp
+Note: the syntax of the color configuration file is derived from the one
+supported by GRASS r.colors utility. ESRI HDR color table files (.clr)
+also match that syntax. The alpha component and the support of tab and
+comma as separators are GDAL specific extensions.
+.sp
+For example:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.EX
+3500   white
+2500   235:220:175
+50%   190 185 135
+700    240 250 150
+0      50  180  50
+.EE
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-crs <CRS>
+Override CRS, without reprojecting.
+.sp
+The coordinate reference systems that can be passed are anything supported by the
+\fI\%OGRSpatialReference::SetFromUserInput()\fP call, which includes EPSG Projected,
+Geographic or Compound CRS (i.e. EPSG:4296), a well known text (WKT) CRS definition,
+PROJ.4 declarations, or the name of a .prj file containing a WKT CRS definition.
+.sp
+\fBnull\fP or \fBnone\fP can be specified to unset an existing CRS.
+.sp
+Note that the spatial extent is also left unchanged.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-dataset <DATASET>
+Dataset name, to be updated in\-place, unless \fI\%\-\-auxiliary\fP is set. Required.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-gcp <GCP>
+Added in version 3.12.
+
+.sp
+Set ground control point(s), replacing any existing GCPs. Each GCP must be formatted as a string
+\(dqpixel,line,easting,northing\(dq or \(dqpixel,line,easting,northing,elevation\(dq.
+Each GCP must be specified with a \fB\-\-gcp\fP argument.
+.sp
+It is also possible to provide a single \fB\-\-gcp\fP argument whose value is
+the filename of a vector dataset, prefixed with \fI@\fP\&. This dataset must have
+a single layer with the following required fields \fBcolumn\fP, \fBline\fP, \fBx\fP, \fBy\fP,
+and optionally \fBid\fP, \fBinfo\fP and \fBz\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-hist
+Compute histogram information for all bands.
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+This option is not available when the command is part of a pipeline.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-color\-interpretation [all|<BAND>=]<COLOR\-INTERPRETATION>
+Added in version 3.13.
+
+.sp
+Set band color interpretation. May be repeated.
+.sp
+\fB<COLOR\-INTERPRETATION>\fP is one of \fBred\fP, \fBgreen\fP, \fBblue\fP, \fBalpha\fP,
+\fBgray\fP, \fBundefined\fP, \fBpan\fP, \fBcoastal\fP, \fBrededge\fP, \fBnir\fP, \fBswir\fP, \fBmwir\fP or \fBlwir\fP\&.
+.sp
+Several syntaxes are supported:
+.INDENT 7.0
+.IP \(bu 2
+specifying \fBall=<COLOR\-INTERPRETATION>\fP: set the color interpretation on all bands.
+.IP \(bu 2
+specifying as many \fB<COLOR\-INTERPRETATION>\fP as there are bands, starting from band 1 to the last band.
+.IP \(bu 2
+specifying the color interpretation on a subset of bands with \fB<BAND>=<COLOR\-INTERPRETATION>\fP
+where band is the band number starting at 1.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-scale [<BAND>=]<SCALE>
+Added in version 3.13.
+
+.sp
+Set band scale factor. May be repeated.
+.sp
+Several syntaxes are supported:
+.INDENT 7.0
+.IP \(bu 2
+specifying one single \fB<SCALE>\fP: set the scale on all bands.
+.IP \(bu 2
+specifying as many \fB<SCALE>\fP as there are bands, starting from band 1 to the last band.
+.IP \(bu 2
+specifying the scale on a subset of bands with \fB<BAND>=<SCALE>\fP
+where band is the band number starting at 1.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-offset [<BAND>=]<OFFSET>
+Added in version 3.13.
+
+.sp
+Set band offset constant. May be repeated.
+.sp
+Several syntaxes are supported:
+.INDENT 7.0
+.IP \(bu 2
+specifying one single \fB<OFFSET>\fP: set the offset on all bands.
+.IP \(bu 2
+specifying as many \fB<OFFSET>\fP as there are bands, starting from band 1 to the last band.
+.IP \(bu 2
+specifying the offset on a subset of bands with \fB<BAND>=<OFFSET>\fP
+where band is the band number starting at 1.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-metadata <KEY>=<VALUE>
+Add/update metadata item, at the dataset level. May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-nodata <value>
+Override nodata value.
+.sp
+\fBnull\fP or \fBnone\fP can be specified to unset an existing nodata value.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-stats
+Compute raster band statistics for all bands.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-unset\-color\-table
+Added in version 3.13.
+
+.sp
+Remove the color table associated to the first band, or the one specified
+by \fI\%\-\-band\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-unset\-metadata <KEY>
+Remove metadata item, at the dataset level. May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-unset\-metadata\-domain <DOMAIN>
+Added in version 3.12.
+
+.sp
+Remove metadata domain, at the dataset level. May be repeated.
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
+Dataset open option (format specific).
+.sp
+May be repeated.
+.UNINDENT
+.SH RETURN STATUS CODE
+.sp
+The program returns status code 0 in case of success, and non\-zero in case of
+error (non\-blocking errors emitted as warnings are considered as a successful
+execution).
+.SH EXAMPLES
+.SS Example 1: Override (without reprojecting) the CRS of a dataset
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster edit \-\-crs=EPSG:32632 my.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Override (without reprojecting or subsetting) the bounding box of a dataset
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster edit \-\-bbox=2,49,3,50 my.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Add a metadata item
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster edit \-\-metadata AUTHOR=EvenR my.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 4: Remove a metadata item
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster edit \-\-unset\-metadata AUTHOR my.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 5: Add 2 ground control point (GCP) for (column=0,line=0,X=2,Y=49) and (column=50,line=100,X=3,Y=48)
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster edit \-\-gcp 0,0,2,49 \-\-gcp 50,100,3,48 my.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 6: Add ground control point (GCP) from gcps.csv, that must have fields named column, line, x and  y.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster edit \-\-gcp @gcps.csv my.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 7: Set red, green, blue, NIR color interpretation to a 4\-band dataset
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal raster edit \-\-color\-interpretation red,green,blue,nir 4band.tif
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.