Merge branch 'main' of https://github.com/MapServer/MapServer-documen…

…tation
jmckenna · Jan 15, 2025 · 6dcccd4 · 6dcccd4
2 parents d58ff3c + 50e6acb
commit 6dcccd4
Show file tree

Hide file tree

Showing 11 changed files with 90 additions and 35 deletions.
diff --git a/_static/foss4g2025.png b/_static/foss4g2025.png
diff --git a/_templates/indexsidebar.html b/_templates/indexsidebar.html
@@ -16,8 +16,8 @@ <h3>Navigation</h3>
 <p>MapServer is a project of the <a href="https://www.osgeo.org/" target="_blank">
 Open Source Geospatial Foundation</a>.</p>
 <p>
-<a href="https://2024.foss4g.org/" target="_blank">
-    <img src="{{ pathto("_static/foss4g2024.png", 1) }}" alt="FOSS4G" border="0px; text-decoration:none" />
+<a href="https://2025.foss4g.org/" target="_blank">
+    <img src="{{ pathto("_static/foss4g2025.png", 1) }}" alt="FOSS4G" border="0px; text-decoration:none" />
 </a>
 </p>
 <p>If you find MapServer useful, please consider supporting the team with a donation:</p>

diff --git a/conf.py b/conf.py
@@ -92,9 +92,9 @@ def __getattr__(cls, name):
 # built documents.
 #
 # The short X.Y version.
-version = '8.2'
+version = '8.4'
 # The full version, including alpha/beta/rc tags.
-release = '8.2.2'
+release = '8.4.0'
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 #language = None

diff --git a/en/announcements/announcements_archive.txt b/en/announcements/announcements_archive.txt
@@ -4,6 +4,20 @@
  MapServer Announcement Archives
 *****************************************************************************
 
+**2025-01-15 - MapServer 8.4.0 is released**
+
+The major version MapServer 8.4 has been released. The list of
+major changes for this release can be found in the :ref:`8.4 announcement <announce-8-4>`.
+See the :ref:`changelog <changelog-8-4>`
+for the full list of changes and head to :ref:`download` to obtain a copy.
+
+**2025-01-08 - MapServer 8.4.0-rc1 is released**
+
+The first release candidate for MapServer 8.4.0 has been released. The list of
+major changes for this release can be found in the :ref:`8.4 announcement <announce-8-4>`.
+See the :ref:`changelog <changelog-8-4-0-rc1>`
+for the full list of changes and head to :ref:`download` to obtain a copy.
+
 **2024-12-14 - MapServer 8.4.0-beta2 is released**
 
 The second beta for MapServer 8.4 has been released. The list of

diff --git a/en/development/announce/8-4.txt b/en/development/announce/8-4.txt
@@ -1,16 +1,16 @@
 .. _announce-8-4:
 
 *****************************************************************************
-Version 8.4.0-beta2 Announcement
+Version 8.4.0 Announcement
 *****************************************************************************
 
 :Authors: Project Steering Committee
-:Drafted: 2024-12-14
+:Released: 2025-01-15
 
-The MapServer Team is pleased to announce the second beta of the major release of 
+The MapServer Team is pleased to announce the major release of 
 MapServer 8.4.0
 
-This 8.4 release will bring a number of major new features that are briefly 
+This 8.4 release brings a number of major new features that are briefly 
 summarized in this document. The full list of changes can be found in :ref:`changelog-8-4`.
 The :ref:`Migration Guide <migration-8-4>` also contains more detailed examples of 
 the major changes.

diff --git a/en/development/changelog/changelog-8-4.txt b/en/development/changelog/changelog-8-4.txt
@@ -7,6 +7,21 @@
 The summary of major changes for this release can be found in the `HISTORY.md <https://github.com/MapServer/MapServer/blob/branch-8-4/HISTORY.md>`__
 file from the source directory.
 
+.. _changelog-8-4-0:
+
+Changes from 8.4.0-rc1 to 8.4.0
+===============================
+
+* add CITATION.cff (Jeff McKenna) : `8942e55 <https://github.com/mapserver/mapserver/commit/8942e55eadcb91eb0fb8a8a1fe178fcee97ba801>`__
+
+.. _changelog-8-4-0-rc1:
+
+Changes from 8.4.0-beta2 to 8.4.0-rc1
+=====================================
+
+* update copyright year (Jeff McKenna) : `aac86c8 <https://github.com/mapserver/mapserver/commit/aac86c899ae29923b13ce3d690a2a740c48777c5>`__
+* Add stdbool.h inclusion in mapserver.h (Even Rouault) : `028d99d <https://github.com/mapserver/mapserver/commit/028d99d5ff840c294e17c9af8100bf3a7c5076fb>`__
+
 .. _changelog-8-4-0-beta2:
 
 Changes from 8.4.0-beta1 to 8.4.0-beta2

diff --git a/en/download.txt b/en/download.txt
@@ -18,7 +18,7 @@ Current Release(s)
 
 * MapServer
 
-  * **2024-12-14** MapServer-8.4.0-beta2 `tar.gz <https://download.osgeo.org/mapserver/mapserver-8.4.0-beta2.tar.gz>`__ | `.zip <https://download.osgeo.org/mapserver/mapserver-8.4.0-beta2.zip>`__ | :ref:`Changelog <changelog-8-4>`
+  * **2025-01-15** MapServer-8.4.0 `tar.gz <https://download.osgeo.org/mapserver/mapserver-8.4.0.tar.gz>`__ | `.zip <https://download.osgeo.org/mapserver/mapserver-8.4.0.zip>`__ | :ref:`Changelog <changelog-8-4>`
   * **2024-09-02** MapServer-8.2.2 `tar.gz <https://download.osgeo.org/mapserver/mapserver-8.2.2.tar.gz>`__ | `.zip <https://download.osgeo.org/mapserver/mapserver-8.2.2.zip>`__ | :ref:`Changelog <changelog-8-2>`
   * **2024-06-11** MapServer-8.0.2 `tar.gz <https://download.osgeo.org/mapserver/mapserver-8.0.2.tar.gz>`__ | :ref:`Changelog <changelog-8-0>`
   * **2024-07-21** MapServer-7.6.7 `tar.gz <https://download.osgeo.org/mapserver/mapserver-7.6.7.tar.gz>`__ | `.zip <https://download.osgeo.org/mapserver/mapserver-7.6.7.zip>`__ | :ref:`Changelog <changelog-7-6>`

diff --git a/en/download_archives.txt b/en/download_archives.txt
@@ -15,6 +15,8 @@
 Past Releases
 ..............................................................................
 
+* **2025-01-15** MapServer-8.4.0 `tar.gz <https://download.osgeo.org/mapserver/mapserver-8.4.0.tar.gz>`__ | `.zip <https://download.osgeo.org/mapserver/mapserver-8.4.0.zip>`__ | :ref:`Changelog <changelog-8-4>`
+
 * **2024-09-02** MapServer-8.2.2 `tar.gz <https://download.osgeo.org/mapserver/mapserver-8.2.2.tar.gz>`__ | `.zip <https://download.osgeo.org/mapserver/mapserver-8.2.2.zip>`__ | :ref:`Changelog <changelog-8-2>`
 
 * **2024-08-02** MapCache-1.14.1 `tar.gz <https://download.osgeo.org/mapserver/mapcache-1.14.1.tar.gz>`__ | `.zip <https://download.osgeo.org/mapserver/mapcache-1.14.1.zip>`__ | :ref:`Changelog <changelog-mapcache-1-14>`
@@ -162,6 +164,8 @@ Past Releases
 Development Releases
 ..............................................................................
 
+* **2025-01-08** MapServer-8.4.0-rc1 `tar.gz <https://download.osgeo.org/mapserver/mapserver-8.4.0-rc1.tar.gz>`__ | `.zip <https://download.osgeo.org/mapserver/mapserver-8.4.0-rc1.zip>`__ | :ref:`Changelog <changelog-8-4>`
+
 * **2024-12-14** MapServer-8.4.0-beta2 `tar.gz <https://download.osgeo.org/mapserver/mapserver-8.4.0-beta2.tar.gz>`__ | `.zip <https://download.osgeo.org/mapserver/mapserver-8.4.0-beta2.zip>`__ | :ref:`Changelog <changelog-8-4>`
 
 * **2024-06-28** `mapserver-8.2.0-rc3.tar.gz <https://download.osgeo.org/mapserver/mapserver-8.2.0-rc3.tar.gz>`__ :ref:`Changelog <changelog-8-2-0-rc3>`

diff --git a/en/include/announcements.inc b/en/include/announcements.inc
@@ -1,3 +1,17 @@
+**2025-01-15 - MapServer 8.4.0 is released**
+
+The major version MapServer 8.4 has been released. The list of
+major changes for this release can be found in the :ref:`8.4 announcement <announce-8-4>`.
+See the :ref:`changelog <changelog-8-4>`
+for the full list of changes and head to :ref:`download` to obtain a copy.
+
+**2025-01-08 - MapServer 8.4.0-rc1 is released**
+
+The first release candidate for MapServer 8.4.0 has been released. The list of
+major changes for this release can be found in the :ref:`8.4 announcement <announce-8-4>`.
+See the :ref:`changelog <changelog-8-4-0-rc1>`
+for the full list of changes and head to :ref:`download` to obtain a copy.
+
 **2024-12-14 - MapServer 8.4.0-beta2 is released**
 
 The second beta for MapServer 8.4 has been released. The list of

diff --git a/en/ogc/ogc_api.txt b/en/ogc/ogc_api.txt
@@ -193,29 +193,33 @@ Metadata
 .. table:: 
    :align: left
 
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+
-   | Key                    | Level               | Meaning                                                                                     |
-   +========================+=====================+=============================================================================================+
-   | onlineresource         | Map                 | API root url, can't reuse WxS values                                                        |
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+   
-   | html_template_directory| Map                 | full path or relative (to mapfile) of html template directory                               |
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+   
-   | description            | Map                 | service description, fall back to ows/wfs_abstract                                          |
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+
-   | links                  | Map, Layer          | comma delimited list of link keys - references to other metadata                            |
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+   
-   | link_{key}_title       | Map, Layer          | link title                                                                                  |
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+
-   | link_{key}_href        | Map, Layer          | link href (url)                                                                             |
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+   
-   | html_tags              | Map                 | comma delimited list of tag keys to expose to HTML templates - references to other metadata |
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+
-   | tag_{key}              | Map                 | value associated with the tag, added to JSON data in template.tags object                   |
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+   
-   | keywords               | Layer               | comma delimited list of keywords, fall back to ows/wfs_keywordlist                          |
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+
-   | max_limit              | Map, Layer          | map or layer-level maximum limit value (integer)                                            |
-   +------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | Key                                  | Level               | Meaning                                                                                     |
+   +======================================+=====================+=============================================================================================+
+   | onlineresource                       | Map                 | API root url, can't reuse WxS values                                                        |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | html_template_directory              | Map                 | full path or relative (to mapfile) of html template directory                               |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | description                          | Map                 | service description, fall back to ows/wfs_abstract                                          |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | links                                | Map, Layer          | comma delimited list of link keys - references to other metadata                            |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | link_{key}_title                     | Map, Layer          | link title                                                                                  |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | link_{key}_href                      | Map, Layer          | link href (url)                                                                             |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | html_tags                            | Map                 | comma delimited list of tag keys to expose to HTML templates - references to other metadata |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | tag_{key}                            | Map                 | value associated with the tag, added to JSON data in template.tags object                   |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | keywords                             | Layer               | comma delimited list of keywords, fall back to ows/wfs_keywordlist                          |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | max_limit                            | Map, Layer          | map or layer-level maximum limit value (integer)                                            |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
+   | use_default_extent_for_getfeature    | Layer               | (since 8.4) Use ``MAP`` ``EXTENT`` as a spatial filter if no bbox is in the request.        |
+   | (optional)                           |                     | Setting to ``"false"`` can improve performance.                                             |
+   |                                      |                     | See also :ref:`wfs_use_default_extent_for_getfeature`.                                      |
+   +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+
 
 Example OGC API Server Mapfile
 ******************************
@@ -280,6 +284,7 @@ Example OGC API Server Mapfile
         "ows_abstract" "Oceans, NaturalEarth dataset, 2020"
         "gml_include_items" "all" #REQUIRED
         "gml_featureid"     "ne_id" #REQUIRED
+        "oga_use_default_extent_for_getfeature" # Optional. Can improve performance.
       END
       TYPE POLYGON
       STATUS ON

diff --git a/en/ogc/wfs_server.txt b/en/ogc/wfs_server.txt
@@ -1365,13 +1365,16 @@ Layer Object
 .. index::
    triple: WFS; METADATA; wfs_use_default_extent_for_getfeature
 
+.. _wfs_use_default_extent_for_getfeature:
+
 **wfs_use_default_extent_for_getfeature**
   (Optional, since MapServer 7.0.4) Whether the MAP.EXTENT should be used in
   request to datasources in the absence of other spatial filter. This is the
   default behaviour, but this might affect performance in some use cases. In
-  those cases, setting this item to "false" will avoid he default spatial filter to
-  be appended to the request. This is only implemented for OGR datasources (since 7.0.4)
-  and MSSQL2008 connections (since 7.6)
+  those cases, setting this item to "false" will avoid the default spatial filter to
+  be appended to the request. This is only implemented for OGR datasources (since 7.0.4),
+  MSSQL2008 (since 7.6), and PostGIS connections (since 8.4).
+  Use **ows_use_default_extent_for_getfeature** to set for both WFS and :ref:`ogcapi`.
 
 Layer Metadata API
 ----------------------