Merge pull request #13430 from OSGeo/backport-13411-to-release/3.12

[Backport release/3.12] Doc: Update Windows Conda build docs

Author: rouault

doc/source/development/dev_environment.rst

@@ -68,7 +68,10 @@ To avoid built objects being owned by root, it may be desirable to add ``-u $(id
 Building on Windows with Conda dependencies and Visual Studio
 --------------------------------------------------------------------------------
 
-It is less appropriate for Debug builds of GDAL, than other methods, such as using vcpkg.
+This approach is less appropriate for Debug builds of GDAL, than other methods, such as using vcpkg.
+
+A minimal Windows build configuration utilizing Conda is provided within the GitHub Actions workflow
+defined in :source_file:.github/workflows/cmake_builds.yml - see the ``build-windows-conda`` job.
 
 Install git
 +++++++++++
@@ -90,60 +93,63 @@ Only the latest Community Edition (2022) is available.
 Install GDAL dependencies
 +++++++++++++++++++++++++
 
-Start a Conda enabled console and assuming there is a c:\\dev directory
+Start a Conda-enabled PowerShell console and assuming there is a ``c:\\dev`` directory
 
-.. code-block:: console
+.. code-block:: ps1
 
     cd c:\dev
-    conda create --name gdal
+    conda create --yes --name gdal
     conda activate gdal
-    conda install --yes --quiet curl libiconv icu git python swig numpy pytest zlib
-    conda install --yes --quiet -c conda-forge compilers clcache
-    conda install --yes --quiet -c conda-forge \
-        cmake proj geos hdf4 hdf5 \
-        libnetcdf openjpeg poppler libtiff libpng xerces-c expat libxml2 kealib json-c \
-        cfitsio freexl geotiff jpeg libpq libspatialite libwebp-base pcre postgresql \
-        sqlite tiledb zstd charls cryptopp cgal librttopo libkml openssl xz
+    conda install --yes --quiet -c conda-forge compilers cmake curl libiconv icu python swig numpy `
+        pytest pytest-env pytest-benchmark filelock zlib lxml jsonschema setuptools
+    # --only-deps only installs the dependencies of the listed packages, not the packages themselves
+    conda install --yes --quiet -c conda-forge --only-deps `
+        libgdal libgdal-hdf4 libgdal-hdf5 libgdal-netcdf libgdal-pdf libgdal-jp2openjpeg
 
 .. note::
 
-    The ``compilers`` package will install ``vs2019_win-64`` (at time of writing)
-    to set the appropriate environment for cmake to pick up. It also finds and works  
-    with Visual Studio 2022 if that is installed.
+    The ``compilers`` package will install ``vs2022_win-64`` (at time of writing)
+    to set the appropriate environment for CMake to pick up. It also finds and works
+    with Visual Studio 2022 (Professional or Enterprise) if that is installed.
 
 Checkout GDAL sources
 +++++++++++++++++++++
 
-.. code-block:: console
+.. code-block:: ps1
 
     cd c:\dev
     git clone https://github.com/OSGeo/gdal.git
 
 Build GDAL
 ++++++++++
 
-From a Conda enabled console
+From a Conda-enabled PowerShell console:
 
-.. code-block:: console
+.. code-block:: ps1
 
     conda activate gdal
     cd c:\dev\gdal
-    cmake -S . -B build -DCMAKE_PREFIX_PATH:FILEPATH="%CONDA_PREFIX%" \
-                        -DCMAKE_C_COMPILER_LAUNCHER=clcache
-                        -DCMAKE_CXX_COMPILER_LAUNCHER=clcache
+    cmake -S . -B build -DCMAKE_PREFIX_PATH:FILEPATH="$env:CONDA_PREFIX"
     cmake --build build --config Release -j 8
 
-.. only:: FIXME
-
-    Run GDAL tests
-    ++++++++++++++
+Run GDAL tests
+++++++++++++++
 
-    ::
+Check everything has built correctly, and then run the test suite using
+the commands below from a Conda-enabled PowerShell console:
 
-        cd c:\dev\GDAL
-        cd _build.vs2019
-        ctest -V --build-config Release
+.. code-block:: ps1
 
+    cd c:\dev\gdal\build
+    # set environment variables, see section below
+    ..\scripts\setdevenv.ps1
+    # check the version
+    gdal --version
+    # check the Python module and version
+    python -c "import osgeo; import inspect; print(inspect.getfile(osgeo))"
+    python -c "from osgeo import gdal; print(gdal.__version__)"
+    # run the test suite
+    ctest -V --build-config Release
 
 .. _setting_dev_environment_variables:
 
@@ -180,7 +186,7 @@ To verify that environment variables have been set correctly, you can check the
 .. code-block:: bash
 
     gdalinfo --version
-    # GDAL 3.11.0dev-c4a2e0b926-dirty, released 2025/04/10
+    # GDAL 3.13.0dev-8c3cf3de02, released 2025/11/14
 
 and the Python bindings:
 

doc/source/spelling_wordlist.txt

@@ -3756,6 +3756,7 @@ yk
 ym
 ymax
 ymin
+yml
 yoff
 yOff
 YOrigin