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

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

@@ -0,0 +1,241 @@
+.\" 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-CREATE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-vector-create \- Create a vector dataset
+.sp
+Added in version 3.13.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal vector create [OPTIONS] <OUTPUT>
+
+Create a vector dataset.
+
+Positional arguments:
+  \-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]
+
+Options:
+  \-i, \-\-like, \-\-input <TEMPLATE\-DATASET>               Input vector datasets [not available in pipelines]
+                                                       Mutually exclusive with \-\-schema, \-\-field
+  \-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]
+  \-\-output\-layer <OUTPUT\-LAYER>                        Output layer name [not available in pipelines]
+  \-\-geometry\-type <GEOMETRY\-TYPE>                      Layer geometry type
+  \-\-geometry\-field <GEOMETRY\-FIELD>                    Name of the geometry field to create (if supported by the output format) (default: geom)
+  \-\-crs <CRS>                                          Set CRS
+  \-\-fid <FID>                                          FID column name
+  \-\-schema <SCHEMA_JSON>                               Read OGR_SCHEMA and populate field definitions from it
+                                                       Mutually exclusive with \-\-input, \-\-field
+  \-\-field <NAME>:<TYPE>[(,<WIDTH>[,<PRECISION>])]>     Add a field definition to the output layer [may be repeated]
+                                                       Mutually exclusive with \-\-input, \-\-schema
+
+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]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal vector create\fP creates one or more vector layers, creating the
+dataset if it doesn\(aqt exist or adding layers to an existing dataset if the
+underlying format supports it.
+.sp
+The layer fields, geometry type and coordinate reference system can be defined either by
+providing an existing dataset or an OGR_SCHEMA file/JSON as a template, or by explicitly
+specifying the various components.
+.sp
+\fBgdal vector create\fP can be used as the first
+step of a pipeline.
+.sp
+The following options are available:
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-output\-layer <OUTPUT\-LAYER>
+Output layer name.
+.sp
+Only meaningful when creating a single layer dataset. It allows defining or overriding
+the name of the created layer.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-i, \-\-like, \-\-input <TEMPLATE\-DATASET>
+Vector dataset to use as a template for the created dataset.
+.sp
+If the template dataset contains multiple layers and the destination format does
+not support multiple layers the program will exit with an error unless
+\fI\%\-\-input\-layer\fP is used to specify which single layer from the
+input dataset should be used as a template.
+.sp
+Mutually exclusive with \fI\%\-\-schema\fP and with \fI\%\-\-field\fP, \fI\%\-\-geometry\-type\fP,
+\fI\%\-\-geometry\-field\fP and \fI\%\-\-crs\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-layer, \-\-input\-layer <INPUT\-LAYER>
+Layer(s) of the input dataset to use as a template for the created layer.
+.sp
+This option can be repeated multiple times to specify multiple layers.
+.sp
+This option is only meaningful when \fI\%\-\-like\fP or \fI\%\-\-schema\fP are used with an
+input dataset containing multiple layers.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-schema <OGR_SCHEMA>
+File or JSON string containing the OGR_SCHEMA of the layer to create.
+.sp
+This can be a filename, a URL or JSON string conformant with the
+\X'tty: link https://raw.githubusercontent.com/OSGeo/gdal/refs/heads/master/ogr/data/ogr_fields_override.schema.json'\fI\%ogr_fields_override.schema.json schema\fP\X'tty: link'
+.sp
+If the OGR_SCHEMA contains multiple layers and the destination format does
+not support multiple layers the program will exit with an error unless
+\fI\%\-\-input\-layer\fP is used to specify which single layer from the OGR_SCHEMA
+should be selected.
+.sp
+Mutually exclusive with \fI\%\-\-like\fP and with \fI\%\-\-field\fP, \fI\%\-\-geometry\-type\fP, \fI\%\-\-geometry\-field\fP and \fI\%\-\-crs\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-crs <CRS>
+Defines the coordinate reference system of the created layer.
+.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
+Mutually exclusive with \fI\%\-\-schema\fP and with \fI\%\-\-like\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-geometry\-field <GEOMETRY\-FIELD>
+Name of the geometry field to create (if supported by the output format) (default: geom).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-geometry\-type <GEOMETRY\-TYPE>
+Defines the geometry type of the created layer.
+.sp
+Layer 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.
+.sp
+Mutually exclusive with \fI\%\-\-schema\fP and with \fI\%\-\-like\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-field <NAME>:<TYPE>[(,<WIDTH>[,<PRECISION>])]
+Defines a field to be created in the layer.
+.sp
+This option can be repeated multiple times to create multiple fields.
+.sp
+The field type can be one of \fBINTEGER\fP, \fBINTEGER64\fP, \fBREAL\fP, \fBSTRING\fP, \fBDATE\fP, \fBTIME\fP,
+\fBDATETIME\fP, \fBBINARY\fP, \fBINTEGERLIST\fP, \fBREALLIST\fP, \fBSTRINGLIST\fP, \fBINTEGER64LIST\fP\&.
+.sp
+The width and precision can be specified for \fBINTEGER\fP, \fBINTEGER64\fP, \fBREAL\fP and \fBSTRING\fP field types.
+For example, \fB\-\-field population:INTEGER(10,5)\fP or \fB\-\-field name:STRING(255)\fP
+.sp
+Mutually exclusive with \fI\%\-\-schema\fP and with \fI\%\-\-like\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-fid <FID>
+Defines the name of the Feature Identifier (FID) column, for drivers that
+support setting it (those which declare a \fBFID\fP layer creation option)
+.sp
+Mutually exclusive with \fI\%\-\-schema\fP and with \fI\%\-\-like\fP\&.
+.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: Create a POINT layer named names with a string field named name in a new vector dataset
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector create \-\-geometry\-type point  \-\-crs EPSG:4326 \-\-field name:string \-\-output\-layer names points.gpkg
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Add a POINT layer named names2 with a string field named name to an existing vector dataset
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector create \-\-update \-\-geometry\-type point \-\-crs EPSG:4326 \-\-field name:string \-\-output\-layer names2 points.gpkg
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Create a new vector dataset with a layer named countries_new based on the layer countries of an existing dataset
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector create \-\-like ../data/poly.gpkg \-\-input\-layer poly \-\-output\-layer areas_new areas.gpkg
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Alessandro Pasotti <elpaso@itopen.it>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.

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

@@ -0,0 +1,274 @@
+.\" 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-DISSOLVE" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-vector-dissolve \- Unions the elements of each feature's geometry.
+.sp
+Added in version 3.13.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal vector dissolve [OPTIONS] <INPUT> <OUTPUT>
+
+Dissolves multipart features
+
+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]
+  \-\-active\-layer <ACTIVE\-LAYER>                        Set active layer (if not specified, all)
+  \-\-active\-geometry <ACTIVE\-GEOMETRY>                  Geometry field name to which to restrict the processing (if not specified, all)
+
+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 dissolve\fP performs a union operation on the elements of each feature\(aqs geometry. This has the following effects:
+.INDENT 0.0
+.IP \(bu 2
+Duplicate vertices are eliminated.
+.IP \(bu 2
+Nodes are added where input linework intersects.
+.IP \(bu 2
+Polygons that overlap are \(dqdissolved\(dq into a single feature.
+.UNINDENT
+.sp
+For linear geometries, the union step is followed by a line\-merging step, where lines are merged at points that form an endpoint of exactly two lines.
+.sp
+To dissolve the geometries of multiple features together, first combine them into single features with \fI\%gdal vector combine\fP\&.
+.sp
+\fBdissolve\fP can be used as a step of \fI\%gdal vector pipeline\fP\&.
+.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 \-\-active\-layer <ACTIVE\-LAYER>
+Set the active layer. When it is specified, only the layer specified by
+its name will be subject to the processing. Other layers will be not
+modified.
+If this option is not specified, all layers will be subject to the
+processing.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-active\-geometry <ACTIVE\-GEOMETRY>
+Set the active geometry field from its name. When it is specified, only the
+specified geometry field will be subject to the processing. Other geometry
+fields will be not modified.
+If this option is not specified, all geometry fields will be subject to the
+processing.
+This option can be combined together with \fI\%\-\-active\-layer\fP\&.
+.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\-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 EXAMPLES
+.SS Example 1: Dissolve country boundaries into continent boundaries
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector pipeline read countries.shp !
+    combine \-\-group\-by CONTINENT ! \e
+    dissolve ! \e
+    write continents.shp
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Dan Baston <dbaston@gmail.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.