update CMake notes [build_translation]

jmckenna · jmckenna · commit db3a38390087 · 2026-05-01T11:50:16.000-03:00
diff --git a/en/MIGRATION_GUIDE.txt b/en/MIGRATION_GUIDE.txt
@@ -6,7 +6,7 @@
 MapServer Migration Guide
 *****************************************************************************
 
-:Last Updated: 2026-04-19
+:Last Updated: 2026-05-01
 
 .. contents:: Table of Contents
     :depth: 2
@@ -117,7 +117,7 @@ MapServer 8.4 to 8.6 Migration
   query parameters to all URLs generated through the API, by
   defining the `ows_extra_params` parameter in the mapfile's WEB.METADATA object.
   
-    .. code-block:: mapfile
+  .. code-block:: mapfile
   
       MAP
         ...
@@ -155,6 +155,9 @@ MapServer 8.2 to 8.4 Migration
   an OGR backend connection (see CVE record: `CVE-2025-59431 <https://www.cve.org/CVERecord?id=CVE-2025-59431>`__, 
   or MapServer's `Security Advisory <https://github.com/MapServer/MapServer/security/advisories/GHSA-256m-rx4h-r55w>`__)
 
+- MapServer now requires at least `CMake <https://cmake.org/>`__ version 3.16 
+  for building
+
 - you can now build against the PCRE2 library (WITH_PCRE2=ON)
 
 - reminder that since the PROJ 9.1 release, the former `PROJ_LIB` variable has 
@@ -346,7 +349,8 @@ MapServer 7.6 to 8.0 Migration
 MapServer 7.4 to 7.6 Migration
 ==============================
 
-- MapServer now requires at least CMake version 3.0 for compiling
+- MapServer now requires at least `CMake <https://cmake.org/>`__ version 3.0 
+  for building
 
 - PointZM data support (X,Y,Z,M coordinates) is now enabled by default
 
@@ -364,7 +368,7 @@ MapServer 7.4 to 7.6 Migration
 - CONNECTIONOPTIONS parameter has been added in the mapfile LAYER, to take  
   advantage of GDAL/OGR driver options. (see :ref:`RFC 125 <rfc125>`) such as:
 
-	.. code-block:: mapfile
+  .. code-block:: mapfile
 
 		LAYER
 		  NAME "test"
@@ -380,7 +384,7 @@ MapServer 7.4 to 7.6 Migration
   to enable a 'painters model' where all classes for a layer are drawn at once with a 
   `ALL_MATCHING_CLASSES` setting, such as:
   
-	.. code-block:: mapfile
+  .. code-block:: mapfile
 
 		LAYER
 		  NAME "test"
@@ -417,7 +421,7 @@ MapServer 7.4 to 7.6 Migration
       
   Here is an example of the new `wms_essential` parameter:
   
-    .. code-block:: mapfile
+  .. code-block:: mapfile
   
         LAYER
           NAME "country_bounds"
@@ -437,7 +441,7 @@ MapServer 7.4 to 7.6 Migration
 - Windows users can now use umlauts (special characters such as ä ö ü) in their 
   directory paths and filenames, such as:
   
-    .. code-block:: mapfile
+  .. code-block:: mapfile
     
         LAYER
           ..	
@@ -502,19 +506,19 @@ MapServer 6.4 to 7.0 Migration
   from MapServer syntax to native syntax (e.g. SQL). Native expressions can still be set either
   using: 1) sub-selects in the DATA statement or 2) using the new NATIVE_FILTER processing key.
 
-::
+  .. code-block:: mapfile
 
-  # OGR Layer Before
-  LAYER
-    ...
-    FILTER 'where id=234'
-  END
+    # OGR Layer Before
+    LAYER
+      ...
+      FILTER 'where id=234'
+    END
 
-  # OGR Layer After
-  LAYER
-    ...
-    PROCESSING 'NATIVE_FILTER=id=234'
-  END
+    # OGR Layer After
+    LAYER
+      ...
+      PROCESSING 'NATIVE_FILTER=id=234'
+    END
 
 - MapServer attribute queries (e.g. mode=item[n]query) *must* be specified using MapServer 
   expression syntax (qstring and qitem (opt)). For RDBMS backends you no longer send SQL snippets, 
@@ -526,21 +530,21 @@ MapServer 6.4 to 7.0 Migration
   and MapScript getter/setter functions will continue to function but unpredictable results will 
   occur if used in conjunction with COMPOSITE blocks. For more information see https://mapserver.org/development/rfc/ms-rfc-113.html.
 
-::
-
-  # Before
-  LAYER
-    ...
-    OPACITY 70
-  END
+  .. code-block:: mapfile
 
-  # After
-  LAYER
-    ...
-    COMPOSITE
+    # Before
+    LAYER
+      ...
       OPACITY 70
     END
-  END
+
+    # After
+    LAYER
+      ...
+      COMPOSITE
+        OPACITY 70
+      END
+    END
 
 - Handling of non UTF-8 encoded datasources has changed with RFC103. Mapfiles
   now *must* be saved in UTF-8 encoding, and requests returned by MapServer
@@ -567,38 +571,40 @@ MapServer 6.4 to 7.0 Migration
 - ExternalGraphics added through SLD must now validate against the
   "sld_external_graphic" entry of the MAP->WEB->VALIDATION block
   
-::
+  .. code-block:: mapfile
 
-  MAP
-   WEB
-    VALIDATION
-     "sld_external_graphic" "^/path/to/symbols/.*png"
+    MAP
+     WEB
+      VALIDATION
+       "sld_external_graphic" "^/path/to/symbols/.*png"
+      END
+     END
     END
-   END
-  END
 
 MapServer 6.2 to 6.4 Migration
 ==============================
 
+- MapServer now must be built with the CMake tool. Build instructions 
+  are included in the `INSTALL_CMAKE.md <https://github.com/MapServer/MapServer/blob/main/INSTALL_CMAKE.md>`__ 
+  file in the source directory. You will need to have CMake installed
+  on your system. Users of mapscripts (except PHP) will also need `SWIG <https://www.swig.org/>`__ 
+  to be installed.
+
 - The "ows_extent" layer metadata is not used anymore to obtain georeferencing 
   information for unreferenced raster data. Please use the "extent" layer key 
   instead
   
-::
+  .. code-block:: mapfile
 
-  LAYER
-    ...
-    EXTENT -180 90 180 90
-  END
+    LAYER
+      ...
+      EXTENT -180 90 180 90
+    END
 
 - Validation patterns cannot be specified in metadata blocks (i.e. using
   xxx_validation_pattern and default_xxx metadata entries), use VALIDATION blocks.
   see #4596 #4604 #4608 or :ref:`runsub`
 
-- Build has changed after the switch to cmake. Build instructions are included in
-  the INSTALL.CMAKE file in the source directory. You will need to have cmake installed
-  on your system. Users of mapscripts (except php) will also need swig to be installed.
-
 - WFS paging parameter startIndex changed to base on 0 instead of 1 (0 is the first
   feature). See #4180 for external references.
 
@@ -726,7 +732,7 @@ support it.
 As a result the parameters BACKGROUNDCOLOR, BACKGROUNDSHADOWCOLOR, BACKGROUNDSHADOWSIZE
 are no more. To draw a label "box" in 6.0 you'd do:
 
-::
+.. code-block:: mapfile
 
   LABEL
     ...
@@ -850,7 +856,9 @@ Mapfile Changes - OGC requests - DUMP parameter removed
 The DUMP LAYER parameter has been removed.  To enable output of
 geometries in WMS getfeatureinfo requests - GML
 (INFO_FORMAT=application/vnd.ogc.gml), LAYER METADATA is used
-instead::
+instead.
+
+.. code-block:: mapfile
 
    METADATA
      gml_geometries "geom"
@@ -877,7 +885,7 @@ following character is ", ' or \.
 For Windows users: if you have a path string delimited by single/double
 quotes that ends with \, you will have to escape the last backslash. 
 
-::
+.. code-block:: mapfile
   
   SHAPEPATH "C:\ms4w\shapefiles\"
   # should be modified to...
@@ -965,7 +973,7 @@ the 5.4/5.6 versions. Gone are resultsGetShape and getFeature methods. You shoul
 refactored getShape method to access layer shapes. That method takes a resultObj and returns
 a shapeObj. Typical use would be (in Perl):
 
-::
+.. code-block:: perl
 
   $layer->queryByRect($map, $map->{extent}); # layer is still open                                                                             
 
@@ -981,6 +989,8 @@ A resultObj encapsulates the data used to manage a result set.
 
 To access shapes independently of a query use the new resultObj class:
 
+.. code-block:: perl
+
   $layer->open();
   $shape = $layer->getShape(new mapscript::resultObj(1));  
   $layer->close();
@@ -1142,7 +1152,7 @@ like ANGLEITEM or LABELSIZEITEM were used, now you denote the attribute
 in the context of the property being bound. For example, to bind an 
 attribute to a label size you'd do:
 
-::
+.. code-block:: mapfile
 
   LABEL
     ...
diff --git a/en/installation/unix.txt b/en/installation/unix.txt
@@ -13,7 +13,7 @@
 :Contact: thomas.bonfort at gmail.com
 :Author: Jeff McKenna
 :Contact: jmckenna at gatewaygeomatics.com
-:Last Updated: 2025-04-14
+:Last Updated: 2026-05-01
 
 .. contents:: Table of Contents
     :depth: 2
@@ -24,23 +24,23 @@
  Introduction
 =============================================================================
 
-The University of Minnesota's MapServer is an open-source and freely 
-available map rendering engine for the web. Due to its open-source nature, 
+The University of Minnesota's MapServer is an Open Source and freely 
+available map rendering engine for the web. Due to its Open Source nature, 
 it can be compiled on a wide variety of platforms and operating systems. 
 We will focus on how to obtain, compile and install MapServer on UNIX-like 
 platforms.
 
 .. note:: 
 
-   Detailed configuration options are maintained in the `INSTALL.CMAKE`_
+   Detailed configuration options are maintained in the `INSTALL_CMAKE.md`_
    file packaged at the root of the source directory:
    
 .. tip:: 
 
-   The minimum CMake version required is 3.0 as of the MapServer 7.6.0 release
+   The minimum CMake version required is 3.16 as of the MapServer 8.4.0 release
 
-You might also check the `MapServerCompilation`_ wiki page for
-additional information.
+The old `MapServerCompilation`_ wiki page contains outdated information, but 
+could be useful for early versions of MapServer.
 
 =============================================================================
  Compiler Requirements
@@ -133,8 +133,8 @@ environment variables to secure your server are listed in :ref:`environment_vari
   within the PostgreSQL database.  Ideally, your client library
   matches the database you are querying from.
   
-* `giflib`_: libgif / `libgif`_ is is used for reading GIF files used
-  as PIXMAP symbols.
+* `giflib`_: GIFLIB (or on some platforms "libgif") is used for reading 
+  GIF files used as PIXMAP symbols.
 
 * `FastCGI`_: FastCGI is a popular protocol for interfacing MapServer
   with various web servers.  You will need to install the development
@@ -580,27 +580,26 @@ server configuration isn't right:
 The :ref:`introduction` document provides excellent coverage of getting started 
 with MapServer.  
 
-.. _`INSTALL.CMAKE`: https://github.com/MapServer/MapServer/blob/main/INSTALL.CMAKE
-.. _`MapServerCompilation`: https://trac.osgeo.org/mapserver/wiki/MapServerCompilation
+.. _`INSTALL_CMAKE.md`: https://github.com/MapServer/MapServer/blob/main/INSTALL_CMAKE.md
+.. _`MapServerCompilation`: https://web.archive.org/web/20240625061519/https://trac.osgeo.org/mapserver/wiki/MapServerCompilation
 .. _`libpng`: http://www.libpng.org/pub/png/libpng.html
 .. _`FreeType`: https://freetype.org/
 .. _`libjpeg`: https://www.ijg.org/
 .. _`zlib`: https://zlib.net/
 .. _`PROJ`: https://proj.org
 .. _`libcurl`: https://curl.se/libcurl/
 .. _`GDAL`: https://gdal.org/
-.. _`GEOS`: https://trac.osgeo.org/geos/
-.. _`libxml`: http://xmlsoft.org
-.. _`Oracle Spatial OCI`: https://www.oracle.com/ca-en/database/technologies/instant-client/downloads.html
+.. _`GEOS`: https://libgeos.org/
+.. _`libxml`: https://gitlab.gnome.org/GNOME/libxml2/-/wikis/home
+.. _`Oracle Spatial OCI`: https://www.oracle.com/database/technologies/instant-client/downloads.html
 .. _`libpq`: https://www.postgresql.org/
 .. _`giflib`: https://giflib.sourceforge.net/
 .. _`FastCGI`: https://fastcgi-archives.github.io/
 .. _`Cairo (SVG, PDF) support`: https://www.cairographics.org/
 .. _`Cairo SVG parser support`: https://mapserver.org/development/rfc/ms-rfc-73.html
 .. _`OGC`: https://www.ogc.org
 .. _`PostGIS`: https://postgis.net/
-.. _`setting up cgi-bin`: https://httpd.apache.org/docs/2.2/howto/cgi.html
+.. _`setting up cgi-bin`: https://httpd.apache.org/docs/current/howto/cgi.html
 .. _`PostgreSQL`: https://www.postgresql.org/
-.. _`libgif`: https://launchpad.net/ubuntu/precise/+package/libgif-dev
 .. _`HarfBuzz`: https://github.com/harfbuzz/harfbuzz
 .. _`FriBidi`: https://github.com/fribidi/fribidi
diff --git a/en/installation/win32.txt b/en/installation/win32.txt
@@ -115,7 +115,7 @@ these files.
 
 .. _`7-Zip`: https://www.7-zip.org/
 
-Cygwin is a free, open-source software package which is a port of these tools 
+Cygwin is a free, Open Source software package which is a port of these tools 
 on Windows. You can use the gzip and tar utilities from this tool collection.
 Cygwin is available from 
 https://www.cygwin.com.
diff --git a/en/optimization/raster.txt b/en/optimization/raster.txt
@@ -33,7 +33,7 @@ Here are some other points to consider:
 
 - For GeoTIFFs larger than 1 GB, ECW images tend to render faster than GeoTIFFs, since
   decompressing the data (CPU and RAM) is faster than reading the uncompressed
-  data (disk). The downside is that ECW is not open-source, and the licensing is
+  data (disk). The downside is that ECW is not Open Source, and the licensing is
   often prohibitive.  `MrSID <https://gdal.org/drivers/raster/mrsid.html#raster-mrsid>`__ 
   is another compressed image format that can be used.
 
diff --git a/en/spelling_wordlist.dict b/en/spelling_wordlist.dict
@@ -41,6 +41,7 @@ bugfix
 bugfixes
 cairo
 cartesian
+catchable
 cellsize
 centerline
 centre
@@ -53,6 +54,7 @@ checkboxes
 classindex
 classitem
 classObj
+cloneable
 clusterObj
 cmake
 CMake
@@ -215,6 +217,7 @@ imageCRS
 imagemap
 imagemaps
 imagemode
+imageObj
 imagepath
 imagetype
 imageurl
@@ -353,6 +356,7 @@ nilvalue
 nilvalues
 nmake
 nquery
+nquerymap
 ntlm
 occurances
 oci
