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

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-vector-layer-algebra.1

@@ -0,0 +1,352 @@
+.\" 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-VECTOR-LAYER-ALGEBRA" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-vector-layer-algebra \- Perform algebraic operation between 2 layers
+.sp
+Added in version 3.12.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal vector layer\-algebra [OPTIONS] <OPERATION> <INPUT> <METHOD> <OUTPUT>
+
+Perform algebraic operation between 2 layers.
+
+Positional arguments:
+  \-\-operation <OPERATION>                              Operation to perform. OPERATION=union|intersection|sym\-difference|identity|update|clip|erase [required]
+  \-i, \-\-input <INPUT>                                  Input vector dataset [required]
+  \-\-method <METHOD>                                    Method vector dataset [required]
+  \-o, \-\-output <OUTPUT>                                Output vector dataset [required]
+
+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:
+  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  Output format
+  \-\-co, \-\-creation\-option <KEY>=<VALUE>                Creation option [may be repeated]
+  \-\-lco, \-\-layer\-creation\-option <KEY>=<VALUE>         Layer creation option [may be repeated]
+  \-\-overwrite                                          Whether overwriting existing output dataset is allowed
+  \-\-update                                             Whether to open existing dataset in update mode
+  \-\-overwrite\-layer                                    Whether overwriting existing output layer is allowed
+  \-\-append                                             Whether appending to existing layer is allowed
+  \-\-input\-layer <INPUT\-LAYER>                          Input layer name
+  \-\-method\-layer <METHOD\-LAYER>                        Method layer name
+  \-\-output\-layer <OUTPUT\-LAYER>                        Output layer name
+  \-\-geometry\-type <GEOMETRY\-TYPE>                      Geometry type
+
+Advanced Options:
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>                    Open options [may be repeated]
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>                  Input formats [may be repeated]
+  \-\-input\-prefix <INPUT\-PREFIX>                        Prefix for fields corresponding to input layer
+  \-\-input\-field <INPUT\-FIELD>                          Input field(s) to add to output layer [may be repeated]
+                                                       Mutually exclusive with \-\-no\-input\-field, \-\-all\-input\-field
+  \-\-no\-input\-field                                     Do not add any input field to output layer
+                                                       Mutually exclusive with \-\-input\-field, \-\-all\-input\-field
+  \-\-all\-input\-field                                    Add all input fields to output layer
+                                                       Mutually exclusive with \-\-input\-field, \-\-no\-input\-field
+  \-\-method\-prefix <METHOD\-PREFIX>                      Prefix for fields corresponding to method layer
+  \-\-method\-field <METHOD\-FIELD>                        Method field(s) to add to output layer [may be repeated]
+                                                       Mutually exclusive with \-\-no\-method\-field, \-\-all\-method\-field
+  \-\-no\-method\-field                                    Do not add any method field to output layer
+                                                       Mutually exclusive with \-\-method\-field, \-\-all\-method\-field
+  \-\-all\-method\-field                                   Add all method fields to output layer
+                                                       Mutually exclusive with \-\-method\-field, \-\-no\-method\-field
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal vector layer\-algebra\fP performs various vector layer algebraic operations.
+The  command takes a vector input source and a method source and generates the
+output of the operation in the specified output file.
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-geometry\-type <GEOMETRY\-TYPE>
+Change the geometry type to be one of
+\fBGEOMETRY\fP, \fBPOINT\fP, \fBLINESTRING\fP, \fBPOLYGON\fP, \fBMULTIPOINT\fP, \fBMULTILINESTRING\fP,
+\fBMULTIPOLYGON\fP, \fBGEOMETRYCOLLECTION\fP, \fBCURVE\fP, \fBCIRCULARSTRING\fP, \fBCOMPOUNDCURVE\fP,
+\fBSURFACE\fP, \fBCURVEPOLYGON\fP, \fBMULTICURVE\fP, \fBMULTISURFACE\fP, \fBPOLYHEDRALSURFACE\fP or \fBTIN\fP\&.
+\fBZ\fP, \fBM\fP or \fBZM\fP suffixes can be appended to the above values to
+indicate the dimensionality.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-input\-layer <INPUT\-LAYER>
+Name of the input vector layer.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-operation union|intersection|sym\-difference|identity|update|clip|erase
+Select the operation to perform among:
+.INDENT 7.0
+.IP \(bu 2
+\fBunion\fP
+.INDENT 2.0
+.INDENT 3.5
+A union is a set of features, which represent areas that are in either of the operand layers.
+The operation is symmetric, and input and method layers can be interchanged.
+[image]
+.UNINDENT
+.UNINDENT
+.IP \(bu 2
+\fBintersection\fP
+.INDENT 2.0
+.INDENT 3.5
+An intersection is a set of features, which represent the common areas of two layers.
+The operation is symmetric, and input and method layers can be interchanged.
+[image]
+.UNINDENT
+.UNINDENT
+.IP \(bu 2
+\fBsym\-difference\fP
+.INDENT 2.0
+.INDENT 3.5
+A symmetric difference is a set of features, which represent areas that are in operand layers but which do not intersect.
+The operation is symmetric, and input and method layers can be interchanged.
+[image]
+.UNINDENT
+.UNINDENT
+.IP \(bu 2
+\fBidentity\fP
+.INDENT 2.0
+.INDENT 3.5
+The identity method identifies features in the input layer with features in the method layer possibly splitting features into several features.
+By default the result layer has attributes from both operand layers.
+[image]
+.UNINDENT
+.UNINDENT
+.IP \(bu 2
+\fBupdate\fP
+.INDENT 2.0
+.INDENT 3.5
+The update method creates a layer, which add features into the input layer from the method layer possibly cutting features in the input layer.
+By default the result layer has attributes only from the input layer.
+[image]
+.UNINDENT
+.UNINDENT
+.IP \(bu 2
+\fBclip\fP
+.INDENT 2.0
+.INDENT 3.5
+The clip method creates a layer, which has features from the input layer clipped to the areas of the features in the method layer.
+By default the result layer has attributes of the input layer.
+[image]
+.UNINDENT
+.UNINDENT
+.IP \(bu 2
+\fBerase\fP
+.INDENT 2.0
+.INDENT 3.5
+The erase method creates a layer, which has features from the input layer whose areas are erased by the features in the method layer.
+By default the result layer has attributes of the input layer.
+[image]
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-method\-layer <METHOD\-LAYER>
+Name of the method vector layer.
+.UNINDENT
+.SS Advanced options
+.INDENT 0.0
+.TP
+.B \-\-all\-input\-field
+Add all input fields to output layer.
+Mutually exclusive with \fI\%\-\-input\-field\fP, \fI\%\-\-no\-input\-field\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-all\-method\-field
+Add all method fields to output layer.
+Mutually exclusive with \fI\%\-\-method\-field\fP, \fI\%\-\-no\-method\-field\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-input\-field <INPUT\-FIELD>
+Input field(s) to add to output layer [may be repeated]
+Mutually exclusive with \fI\%\-\-no\-input\-field\fP, \fI\%\-\-all\-input\-field\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-input\-prefix <INPUT\-PREFIX>
+Prefix for fields corresponding to input layer. Defaults to \fBinput_\fP
+if there are both input and method fields, otherwise empty string.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-method\-field <METHOD\-FIELD>
+Input field(s) to add to output layer [may be repeated]
+Mutually exclusive with \fI\%\-\-no\-method\-field\fP, \fI\%\-\-all\-method\-field\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-method\-prefix <METHOD\-PREFIX>
+Prefix for fields corresponding to method layer. Defaults to \fBmethod_\fP
+if there are both input and method fields, otherwise empty string.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-input\-field
+Do not add any input field to output layer.
+Mutually exclusive with \fI\%\-\-input\-field\fP, \fI\%\-\-all\-input\-field\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-method\-field
+Do not add any method field to output layer.
+Mutually exclusive with \fI\%\-\-method\-field\fP, \fI\%\-\-all\-method\-field\fP\&.
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-append
+Whether appending features to existing layer(s) is allowed.
+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 dataset creation options that can be
+used to control particulars about the file created. For instance,
+the GeoPackage driver supports creation options to control the version.
+.sp
+May be repeated.
+.sp
+The dataset 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\%Vector drivers\fP format
+specific documentation for legal creation options for each format.
+.sp
+Note that dataset creation options are different from layer creation options.
+.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 \-\-lco, \-\-layer\-creation\-option <NAME>=<VALUE>
+Many formats have one or more optional layer creation options that can be
+used to control particulars about the layer created. For instance,
+the GeoPackage driver supports layer creation options to control the
+feature identifier or geometry column name, setting the identifier or
+description, etc.
+.sp
+May be repeated.
+.sp
+The layer creation options available vary by format driver, and some
+simple formats have no layer 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\%Vector drivers\fP format
+specific documentation for legal creation options for each format.
+.sp
+Note that layer creation options are different from dataset creation options.
+.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 \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
+Which output vector format to use. Allowed values may be given by
+\fBgdal \-\-formats | grep vector | grep rw | sort\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output\-layer <NAME>
+Specifies the name of the layer to which features will be written. If not
+specified, output layer names will be the same as input layer names.
+.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
+.INDENT 0.0
+.TP
+.B \-\-overwrite\-layer
+Whether overwriting the existing output vector layer is allowed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-update
+Whether to open an existing output dataset in update mode.
+.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: Performs a union between both input and method layers.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal vector layer\-algebra union input.shp method.shp output.shp
+.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-vector-make-point.1

@@ -0,0 +1,272 @@
+.\" 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-VECTOR-MAKE-POINT" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-vector-make-point \- Create point features from attribute fields
+.sp
+Added in version 3.12.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal vector make\-point [OPTIONS] <INPUT> <OUTPUT>
+
+Create point geometries from attribute fields
+
+Positional arguments:
+  \-i, \-\-input <INPUT>                                  Input vector datasets [required] [not available in pipelines]
+  \-o, \-\-output <OUTPUT>                                Output vector 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:
+  \-l, \-\-layer, \-\-input\-layer <INPUT\-LAYER>             Input layer name(s) [may be repeated] [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]
+  \-\-lco, \-\-layer\-creation\-option <KEY>=<VALUE>         Layer creation option [may be repeated] [not available in pipelines]
+  \-\-overwrite                                          Whether overwriting existing output dataset is allowed [not available in pipelines]
+  \-\-update                                             Whether to open existing dataset in update mode [not available in pipelines]
+  \-\-overwrite\-layer                                    Whether overwriting existing output layer is allowed [not available in pipelines]
+  \-\-append                                             Whether appending to existing layer is allowed [not available in pipelines]
+                                                       Mutually exclusive with \-\-upsert
+  \-\-output\-layer <OUTPUT\-LAYER>                        Output layer name [not available in pipelines]
+  \-\-skip\-errors                                        Skip errors when writing features [not available in pipelines]
+  \-\-x <X>                                              Field from which X coordinate should be read [required]
+  \-\-y <Y>                                              Field from which Y coordinate should be read [required]
+  \-\-z <Z>                                              Optional field from which Z coordinate should be read
+  \-\-m <M>                                              Optional field from which M coordinate should be read
+  \-\-output\-crs <OUTPUT\-CRS>                            Output CRS
+
+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]
+  \-\-output\-oo, \-\-output\-open\-option <KEY>=<VALUE>      Output open options [may be repeated] [not available in pipelines]
+  \-\-upsert                                             Upsert features (implies \(aqappend\(aq) [not available in pipelines]
+                                                       Mutually exclusive with \-\-append
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal vector make\-point\fP creates point geometries from attribute fields containing coordinates.
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-output\-crs <CRS>
+Optional coordinate reference system to assign to the created points.
+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.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-m <FIELD_NAME>
+Optional field name containing M coordinate values
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-x <FIELD_NAME>
+Field name containing X coordinate values
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-y <FIELD_NAME>
+Field name containing Y coordinate values
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-z <FIELD_NAME>
+Optional field name containing Z coordinate values
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-append
+Whether appending features to existing layer(s) is allowed.
+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 dataset creation options that can be
+used to control particulars about the file created. For instance,
+the GeoPackage driver supports creation options to control the version.
+.sp
+May be repeated.
+.sp
+The dataset 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\%Vector drivers\fP format
+specific documentation for legal creation options for each format.
+.sp
+Note that dataset creation options are different from layer creation options.
+.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 \-\-input\-layer <INPUT\-LAYER>
+Specifies the name of one or more layers to process. By default, all layers will be processed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-lco, \-\-layer\-creation\-option <NAME>=<VALUE>
+Many formats have one or more optional layer creation options that can be
+used to control particulars about the layer created. For instance,
+the GeoPackage driver supports layer creation options to control the
+feature identifier or geometry column name, setting the identifier or
+description, etc.
+.sp
+May be repeated.
+.sp
+The layer creation options available vary by format driver, and some
+simple formats have no layer 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\%Vector drivers\fP format
+specific documentation for legal creation options for each format.
+.sp
+Note that layer creation options are different from dataset creation options.
+.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 \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
+Which output vector format to use. Allowed values may be given by
+\fBgdal \-\-formats | grep vector | grep rw | sort\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output\-layer <NAME>
+Specifies the name of the layer to which features will be written. If not
+specified, output layer names will be the same as input layer names.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output\-open\-option, \-\-output\-oo <NAME>=<VALUE>
+Added in version 3.12.
+
+.sp
+Dataset open option for output dataset (format specific).
+.sp
+May be repeated.
+.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
+.INDENT 0.0
+.TP
+.B \-\-overwrite\-layer
+Whether overwriting the existing output vector layer is allowed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-errors
+Added in version 3.12.
+
+.sp
+Whether failures to write feature(s) should be ignored. Note that this option
+sets the size of the transaction unit to one feature at a time, which may
+cause severe slowdown when inserting into databases.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-update
+Whether to open an existing output dataset in update mode.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-upsert
+Added in version 3.12.
+
+.sp
+Variant of \fI\%\-\-append\fP where the \fI\%OGRLayer::UpsertFeature()\fP
+operation is used to insert or update features instead of appending with
+\fI\%OGRLayer::CreateFeature()\fP\&.
+.sp
+This is currently implemented only in a few drivers:
+\fI\%GPKG \-\- GeoPackage vector\fP, \fI\%Elasticsearch: Geographically Encoded Objects for Elasticsearch\fP and \fI\%MongoDBv3\fP
+(drivers that implement upsert expose the \fI\%GDAL_DCAP_UPSERT\fP
+capability).
+.sp
+The upsert operation uses the FID of the input feature, when it is set
+(and the FID column name is not the empty string),
+as the key to update existing features. It is crucial to make sure that
+the FID in the source and target layers are consistent.
+.sp
+For the GPKG driver, it is also possible to upsert features whose FID is unset
+or non\-significant (the \fB\-\-unset\-fid\fP option of \fI\%gdal vector edit\fP
+can be used to ignore the FID from the source feature), when there is a
+UNIQUE column that is not the integer primary key.
+.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 AUTHOR
+Dan Baston <dbaston@gmail.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.