update merge from gdal main

_sources/development/rfc/rfc12_filemanagement.rst.txt

@@ -24,7 +24,7 @@ GetFileList()
 -------------
 
 The following new virtual method is added on the GDALDataset class, with
-an analygous C function.
+an analogous C function.
 
 ::
 

_sources/development/rfc/rfc34_license_policy.rst.txt

@@ -1,14 +1,14 @@
 .. _rfc-34:
 
 ================================================================================
-RFC 34: License Policy Enforcement
+RFC 34: License Policy Enforcement (not implemented)
 ================================================================================
 
 Authors: Frank Warmerdam
 
 Contact: [email protected]
 
-Status: Development
+Status: On hold / not implemented
 
 Summary
 -------

_sources/download.rst.txt

@@ -47,6 +47,13 @@ command
 
 Additional information is available about :ref:`build_requirements` and :ref:`building_from_source`.
 
+Maintenance policy
+..................
+
+The GDAL upstream team only maintains the branch on which the latest release has
+been done, with bugfixes releases issued roughly every 2 months.
+So, for example, during the development phase of GDAL 3.10.0, GDAL 3.9.x bugfixes
+releases are done based on the release/3.9 branch, but not older branches (GDAL 3.8.x or older).
 
 .. _binaries:
 

_sources/drivers/raster/driver_summary.rst.txt

@@ -44,6 +44,12 @@
      - No
      - No
      - Built-in by default
+   * - :ref:`AVIF <raster.avif>`
+     - AV1 Image File Format
+     - No
+     - No
+     - No
+     - libavif
    * - :ref:`BAG <raster.bag>`
      - Bathymetry Attributed Grid
      - **Yes**

_sources/drivers/raster/gif.rst.txt

@@ -16,8 +16,9 @@ A GIF image with transparency will have that entry marked as having an
 alpha value of 0.0 (transparent). Also, the transparent value will be
 returned as the NoData value for the band.
 
-If an ESRI world file exists with the .gfw, .gifw or .wld extension, it
-will be read and used to establish the geotransform for the image.
+If an ESRI :ref:`world file <raster.wld>` exists with the .gfw, .gifw
+or .wld extension, it will be read and used to establish the geotransform
+for the image.
 
 XMP metadata can be extracted from the file,
 and will be stored as XML raw content in the xml:XMP metadata domain.
@@ -45,6 +46,7 @@ The following creation options are supported:
      :default: OFF
 
      Force the generation of an associated ESRI world file (.wld).
+     See :ref:`World Files <raster.wld>` section for details.
 
 - .. co:: INTERLACING
      :choices: ON, OFF

_sources/drivers/raster/gti.rst.txt

@@ -73,6 +73,19 @@ The GTI driver accepts different types of connection strings:
 
   For example: ``tileindex.gti``
 
+STAC GeoParquet support
+-----------------------
+
+.. versionadded:: 3.10
+
+The driver can support `STAC GeoParquet catalogs <https://stac-utils.github.io/stac-geoparquet/latest/spec/stac-geoparquet-spec>`_,
+provided GDAL is build with :ref:`vector.parquet` support.
+It can make use of fields ``proj:epsg`` and ``proj:transform`` from the
+`Projection Extension Specification <https://github.com/stac-extensions/projection/>`_,
+to correctly infer the appropriate projection and resolution.
+
+Example of a valid connection string: ``GTI:/vsicurl/https://github.com/stac-utils/stac-geoparquet/raw/main/tests/data/naip.parquet``
+
 Tile index requirements
 -----------------------
 
@@ -163,7 +176,7 @@ PostGIS, ...), the following layer metadata items may be set:
   virtual mosaic (unless SORT_FIELD_ASC=NO is set)
 
 * ``SORT_FIELD_ASC=YES|NO``: whether the values in SORT_FIELD should be sorted
-  in ascendent or descent order. Defaults to YES (ascendent)
+  in ascending or descending order. Defaults to YES (ascending)
 
 * ``BLOCKXSIZE=<int>`` and ``BLOCKYSIZE=<int>``: Block size of bands of the
   virtual mosaic. Defaults to 256x256.
@@ -367,13 +380,13 @@ You can refer to the documentation of the :ref:`VRT <raster.vrt>` driver for
 their syntax and semantics.
 
 
-How to build a GTI comptatible index ?
+How to build a GTI compatible index ?
 ----------------------------------------
 
 The :ref:`gdaltindex` program may be used to generate both a vector tile index,
 and optionally a wrapping .gti XML file.
 
-A GTI comptatible index may also be created by any programmatic means, provided
+A GTI compatible index may also be created by any programmatic means, provided
 the above format specifications are met.
 
 
@@ -413,7 +426,7 @@ also defined as layer metadata items or in the .gti XML file
       :choices: YES, NO
       :default: YES
 
-      Whether the values in SORT_FIELD should be sorted in ascendent or descent order
+      Whether the values in SORT_FIELD should be sorted in ascending or descending order
 
 -  .. oo:: FILTER
       :choices: <string>

_sources/drivers/raster/gtiff.rst.txt

@@ -397,7 +397,7 @@ This driver supports the following creation options:
       :choices: YES, NO
 
       Force the generation of an associated ESRI world file
-      (.tfw).See the :ref:`World Files <raster.wld>` page for details.
+      (.tfw). See the :ref:`World Files <raster.wld>` page for details.
 
 -  .. co:: RPB
       :choices: YES, NO

_sources/drivers/raster/heif.rst.txt

@@ -26,6 +26,16 @@ matches the one of the full resolution image)
 
 If a file contains several top-level images, they will be exposed as GDAL subdatasets.
 
+AVIF support
+------------
+
+Starting with GDAL 3.10, the AVIF_HEIF companion driver to the HEIF driver may
+be used to open images encoding with the AVIF (AV1 Image File) codec if the
+:ref:`raster.avif` driver is not available and if libheif has been compiled with
+support for one of the libraries it support that are able of AV1 decoding
+(libaom or libdav1d).
+
+
 Driver capabilities
 -------------------
 

_sources/drivers/raster/index.rst.txt

@@ -26,6 +26,7 @@ Raster drivers
    adrg
    aig
    airsar
+   avif
    bag
    basisu
    blx

_sources/drivers/raster/jp2kak.rst.txt

@@ -234,19 +234,20 @@ The following creation options are tightly tied to the Kakadu SDK, and are
 considered to be for advanced use only. Consult the Kakadu SDK documentation to
 better understand their meaning.
 
--  **Corder**: Defaults to "PRCL".
--  **Cprecincts**: Defaults to
+-  **Corder**: Progression order. Defaults to "PRCL".
+-  **Cprecincts**: Precincts settings. Defaults to
    "{512,512},{256,512},{128,512},{64,512},{32,512},{16,512},{8,512},{4,512},{2,512}".
--  **ORGgen_plt**: Defaults to "yes".
--  **ORGgen_tlm**: Kakadu SDK defaults used.
+-  **ORGgen_plt**: Whether to generate PLT markers (Paquet Length). Defaults to "yes".
+-  **ORGgen_tlm**: Whether to generate TLM markers (Tile Length). Kakadu SDK defaults used.
 -  **ORGtparts**: Kakadu SDK defaults used.
 -  **Cmodes**: Kakadu SDK defaults used.
--  **Clevels**: Kakadu SDK defaults used.
+-  **Clevels**: Quality levels. Kakadu SDK defaults used.
+-  **Cycc** =YES/NO: Whether to use YCbCr (lossy compression) or YUV (lossless compression) color space when encoding RGB images. Default to YES starting with GDAL 3.10 (was hardcoded to NO in previous versions)
 -  **Rshift**: Kakadu SDK defaults used.
 -  **Rlevels**: Kakadu SDK defaults used.
 -  **Rweight**: Kakadu SDK defaults used.
 -  **Qguard**: Kakadu SDK defaults used.
--  **Creversible**: If not set and QUALITY >= 99.5, set to "yes", otherwise to "false".
+-  **Creversible** = YES/NO: If not set and QUALITY >= 99.5, set to "yes", otherwise to "false".
 -  **Sprofile**: Kakadu SDK defaults used.
 -  **RATE**: Kakadu SDK defaults used.
    One or more bit-rates, expressed in terms of the ratio between the total number of compressed bits

_sources/drivers/raster/jp2mrsid.rst.txt

@@ -27,10 +27,10 @@ Georeferencing
 --------------
 
 Georeferencing information can come from different sources : internal
-(GeoJP2 or GMLJP2 boxes), worldfile .j2w/.wld sidecar files, or PAM
-(Persistent Auxiliary metadata) .aux.xml sidecar files. By default,
-information is fetched in following order (first listed is the highest
-priority): PAM, GeoJP2, GMLJP2, WORLDFILE.
+(GeoJP2 or GMLJP2 boxes), :ref:`worldfile <raster.wld>` .j2w/.wld sidecar
+files, or PAM (Persistent Auxiliary metadata) .aux.xml sidecar files. By
+default, information is fetched in following order (first listed is the
+highest priority): PAM, GeoJP2, GMLJP2, WORLDFILE.
 
 Starting with GDAL 2.2, the allowed sources and their priority order can
 be changed with the :config:`GDAL_GEOREF_SOURCES` configuration option (or
@@ -70,6 +70,7 @@ The following creation options are supported.
       :choices: YES
 
       to write an ESRI world file (with the extension .j2w).
+      See :ref:`World Files <raster.wld>` section for details.
 
 -  .. co:: COMPRESSION
 

_sources/drivers/raster/jpeg.rst.txt

@@ -20,8 +20,8 @@ IMAGE_STRUCTURE domain.
 
 EXIF metadata can be read from JPEG files (but this will not result in a
 georeferenced image even if the EXIF_GPSLatitude and EXIF_GPSLongitude
-tags are set). But if an ESRI world file exists with the .jgw,
-.jpgw/.jpegw or .wld suffixes, it will be read and used to establish the
+tags are set). But if an ESRI :ref:`world file <raster.wld>` exists with the
+.jgw, .jpgw/.jpegw or .wld suffixes, it will be read and used to establish the
 geotransform for the image. If available a MapInfo .tab file will also
 be used for georeferencing. Overviews can be built for JPEG files as an
 external .ovr file.
@@ -169,7 +169,8 @@ The following creation options are supported:
       :choices: YES
 
       Force the generation of an associated ESRI world
-      file (with the extension .wld).
+      file (with the extension .wld). See :ref:`World Files <raster.wld>`
+      section for details.
 
 -  .. co:: QUALITY
       :choices: 1-100

_sources/drivers/raster/nitf.rst.txt

@@ -146,7 +146,7 @@ The following creation options are available:
       :choices: -1, 0, >0
       :default: -1
 
-      Restart interval (in MCUs) for JPEG compressoin.
+      Restart interval (in MCUs) for JPEG compression.
       -1 for auto, 0 for none, > 0 for user specified.
 
 -  .. co:: NUMI

_sources/drivers/raster/pdf.rst.txt

@@ -728,8 +728,14 @@ Only GDAL builds against static builds of PDFium have been tested.
 Building PDFium can be challenging, and particular builds must be used to
 work properly with GDAL.
 
-With GDAL >= 3.9
-++++++++++++++++
+With GDAL >= 3.10
++++++++++++++++++
+
+The scripts in the `<https://github.com/rouault/pdfium_build_gdal_3_10>`__
+repository must be used to build a patched version of PDFium.
+
+With GDAL = 3.9
++++++++++++++++
 
 The scripts in the `<https://github.com/rouault/pdfium_build_gdal_3_9>`__
 repository must be used to build a patched version of PDFium.

_sources/drivers/raster/png.rst.txt

@@ -74,8 +74,8 @@ The following creation options are available:
       :default: NO
 
       Force the generation of an associated ESRI world
-      file (with the extension .wld). See `World File <#WLD>`__ section for
-      details.
+      file (with the extension .wld). See :ref:`World Files <raster.wld>`
+      section for details.
 
 -  .. co:: ZLEVEL=n
       :choices: [1-9]

_sources/drivers/raster/srtmhgt.rst.txt

@@ -21,6 +21,9 @@ The driver does support creating new files, but the input data must be
 exactly formatted as a SRTM-3 or SRTM-1 cell. That is the size, and
 bounds must be appropriate for a cell.
 
+Starting with GDAL 3.10, the driver also supports reading and writing 0.5
+degree resolution SRTM HGT files.
+
 See Also:
 
 -  `SRTM

_sources/drivers/vector/csv.rst.txt

@@ -84,7 +84,7 @@ per line must be present. Lines may be terminated by a DOS (CR/LF) or
 Unix (LF) style line terminators. Each record should have the same
 number of fields. The driver will also accept a semicolon, a tabulation,
 a pipe, or a space character as field separator.
-Starting with GDAL 3.8, the autodection will select the separator with the
+Starting with GDAL 3.8, the autodetection will select the separator with the
 most occurrences if there are several candidates  on the first line of the CSV
 file (and warn about that). The :oo:`SEPARATOR` open option may also be set to
 define the desired separator.

_sources/drivers/vector/dgn.rst.txt

@@ -122,6 +122,25 @@ Creation Issues
 -  DGN files can only have one layer. Attempts to create more than one
    layer in a DGN file will fail.
 
+Open options
+------------
+
+.. versionadded:: 3.10
+
+|about-open-options|
+The following open options are supported:
+
+- .. oo:: ENCODING
+     :since: 3.10
+     :choices: <encoding>
+
+     An encoding name supported by :cpp:func:`CPLRecode` (i.e. an
+     `iconv <https://en.wikipedia.org/wiki/Iconv>`__ name)
+     that indicates the encoding used by Text elements in the DGN file, to
+     recode them to UTF-8. If not specified (or specified to UTF-8), no
+     recoding will be done.
+
+
 Dataset creation options
 ------------------------
 
@@ -180,6 +199,20 @@ The following dataset-creation options are supported:
       Override the origin of the design plane. By
       default the origin from the seed file is used.
 
+-  .. dsco:: ENCODING
+      :since: 3.10
+      :choices: <encoding>
+
+      An encoding name supported by :cpp:func:`CPLRecode` (i.e. an
+      `iconv <https://en.wikipedia.org/wiki/Iconv>`__ name)
+      that indicates the encoding used by Text elements in the DGN file, to
+      recode them from UTF-8. If not specified (or specified to UTF-8), no
+      recoding will be done. "ISO-8859-1" (ISO Latin1) is supported even on
+      builds without iconv support.
+      Note that no fields in the DGN file itself contain the encoding name,
+      hence it is the responsibility of the reader to open the file with the
+      same value for the ENCODING open option.
+
 --------------
 
 -  `Dgnlib Page <http://dgnlib.maptools.org/>`__

_sources/drivers/vector/geojsonseq.rst.txt

@@ -120,6 +120,14 @@ The following layer creation options are supported:
       if they start and end with brackets and braces, even if they do
       not have their subtype set to JSON.
 
+-  .. lco:: WRITE_BBOX
+      :choices: YES, NO
+      :default: NO
+      :since: 3.10
+
+      Set to YES to write a bbox property with the bounding box of the
+      geometry at the feature level.
+
 Geometry coordinate precision
 -----------------------------
 

_sources/drivers/vector/gpkg.rst.txt

@@ -123,6 +123,10 @@ Spatialite, are also available :
 -  ST_Area(geom *Geometry*, use_ellipsoid *boolean*): (GDAL >= 3.9): compute
    the area in square meters, considering the geometry on the ellipsoid
    (use_ellipsoid must be set to true/1).
+-  ST_Length(geom *Geometry*): (GDAL >= 3.10): compute the area in units of the geometry SRS.
+-  ST_Length(geom *Geometry*, use_ellipsoid *boolean*): (GDAL >= 3.10): compute
+   the area in meters, considering the geometry on the ellipsoid
+   (use_ellipsoid must be set to true/1).
 -  SetSRID(geom *Geometry*, srs_id *Integer*): overrides the geometry' SRS ID,
    without reprojection.
 -  ST_Transform(geom *Geometry*, target_srs_id *Integer*): reproject the geometry

_sources/index.rst.txt

@@ -6,6 +6,7 @@ GDAL
 
 .. toctree::
     :maxdepth: 2
+    :includehidden:
 
     download
     programs/index
@@ -27,4 +28,4 @@ Index
 * :ref:`genindex`
 
 .. meta::
-   :google-site-verification: 9rQvEBJEGGlTYi0neT9qNthRNbnxE4LCy_hdZ6WDiK4
+   :google-site-verification: 9rQvEBJEGGlTYi0neT9qNthRNbnxE4LCy_hdZ6WDiK4