update for 8.4.0-beta2 release (MapServer#986)

jmckenna · Dec 14, 2024 · 894108c · 894108c
1 parent 767c4bc
commit 894108c
Show file tree

Hide file tree

Showing 23 changed files with 509 additions and 110 deletions.
diff --git a/en/MIGRATION_GUIDE.txt b/en/MIGRATION_GUIDE.txt
@@ -6,12 +6,28 @@
 MapServer Migration Guide
 *****************************************************************************
 
-:Last Updated: 2024-08-26
+:Last Updated: 2024-12-13
 
 .. contents:: Table of Contents
     :depth: 2
     :backlinks: top
 
+.. _migration-8-4:
+
+MapServer 8.2 to 8.4 Migration
+==============================
+
+- 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 
+  been replaced with `PROJ_DATA`
+
+  .. seealso:: `Setting the location of PROJ files` in :ref:`projection`.
+
+  .. TIP::
+     For Windows users, MS4W >=5 leverages the `PROJ_DATA` environment variable, 
+     which points to `/ms4w/share/proj/`     
+
 .. _migration-8-2:
 
 MapServer 8.0 to 8.2 Migration
@@ -74,8 +90,6 @@ MapServer 7.6 to 8.0 Migration
         ...
       END #map
 
-
-
 - Several deprecated mapfile parameters have been removed, and will throw an
   error if you still specify them now.  The following are specific examples 
   to be aware of (but be sure to review the :ref:`full list <rfc133>`), taken from the 
@@ -135,8 +149,47 @@ MapServer 7.6 to 8.0 Migration
 
   ::
 
-    ...&map.layer[county].class[0].label[0]=SIZE+24&...  
+    ...&map.layer[county].class[0].label[0]=SIZE+24&...
+
+- Using the :ref:`LABEL` WRAP parameter with *MAXLENGTH 0* to always wrap at the wrap character 
+  is no longer supported (as there are more strict checks in MapServer >= 8 for negative or
+  zero values), so instead you can remove (or comment) that *MAXLENGTH 0* line, and MapServer 
+  will wrap at the character, such as:
+
+  .. code-block:: mapfile
+
+      LAYER
+        NAME "wrap-no-maxlength"
+        CLASS
+            LABEL
+                TYPE truetype
+                ANGLE follow
+                FONT "dejavu"
+                SIZE 8
+                COLOR 0 0 0
+                #MAXLENGTH 0 #would cause error in MapServer >=8
+                WRAP "|"
+            END #label
+            ...
+        END #class
+        ...
+
+        FEATURE
+          POINTS
+            50 -450 150 -450
+          END #points
+          TEXT "W: WrapSpace|With Pipe"
+        END #feature
 
+      END #layer 
+
+  so the label will appear in the map image as:
+
+  .. image:: ./images/label-wrap-with-pipe.png
+      :height: 59
+      :width: 187
+      :class: no-scaled-link 
+
 - Reminder: every mapfile :ref:`LAYER` should include a **NAME** parameter. 
   The NAME should **not contain** special characters, or spaces, or begin with 
   a number.  This simple name is important for your downstream users (such as 

diff --git a/en/announcements/announcements_archive.txt b/en/announcements/announcements_archive.txt
@@ -4,6 +4,13 @@
  MapServer Announcement Archives
 *****************************************************************************
 
+**2024-12-14 - MapServer 8.4.0-beta2 is released**
+
+The second beta for 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-0-beta2>`
+for the full list of changes and head to :ref:`download` to obtain a copy.
+
 **2024-09-02 - MapServer 8.2.2 is released**
 
 The maintenance release of MapServer 8.2.2 is now available.

diff --git a/en/development/announce/8-4.txt b/en/development/announce/8-4.txt
@@ -0,0 +1,90 @@
+.. _announce-8-4:
+
+*****************************************************************************
+Version 8.4.0-beta1 Announcement
+*****************************************************************************
+
+:Authors: Project Steering Committee
+:Drafted: 2024-12-14
+
+The MapServer Team is pleased to announce the first beta of the major release of 
+MapServer 8.4.0
+
+This 8.4 release will bring 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.
+
+Major New Features in MapServer 8.4
+-----------------------------------
+
+- add option to build against the PCRE2 library (`#7073 <https://github.com/MapServer/MapServer/pull/7073>`__)
+
+- add CONNECTIONTYPE RASTERLABEL (`#7135 <https://github.com/MapServer/MapServer/pull/7135>`__)
+
+- set MS_LEGEND_KEYSIZE_MAX to 1000 (`#7154 <https://github.com/MapServer/MapServer/pull/7154>`__)
+
+- add 4 new COMPOSITE.COMPOP blending operations (`#7065 <https://github.com/MapServer/MapServer/pull/7065>`__)
+
+- allow encryption key files to use paths relative to a mapfile (`#7181 <https://github.com/MapServer/MapServer/pull/7181>`__)
+
+- allow use_default_extent_for_getfeature to be used for OGC Features API and PostGIS (`#7197 <https://github.com/MapServer/MapServer/pull/7197>`__)
+
+Other Related Updates
+---------------------
+
+- the demo server hosting many live OGC endpoints has been updated & 
+  constantly maintained, as it is so important for the community: 
+  https://demo.mapserver.org
+
+Migration Guide
+---------------
+
+Head to the :ref:`Migration Guide <migration-8-4>` for mapfile examples of the major 8.4.0 changes.
+
+Source Code Download
+--------------------
+
+The source for this release can be downloaded at:
+
+    https://mapserver.org/download.html
+
+Binary Distributions
+--------------------
+
+Binary distributions will be available in the coming days:
+
+- Debian binaries of 8.4.0 are already available: https://tracker.debian.org/pkg/mapserver
+- `OSGeoLive <https://live.osgeo.org>`__ 17.0 release process is happening now, but
+  it will soon include MapServer 8.4.0
+- `UbuntuGIS <https://wiki.ubuntu.com/UbuntuGIS>`__ will follow the OSGeoLive
+  release and will then include MapServer 8.4.0
+- MS4W users have already been using branch-8-4 code, but watch for 
+  a new release shortly containing the 8.4.0 changes at: https://ms4w.com
+
+.. TBD    
+    - `RHEL and CentOS` TODO
+    - `OpenSUSE` TODO
+
+Other binary distributions listed on the download page should also be updated
+with binaries for the new release shortly.
+
+Documentation
+-------------
+
+The entire 8.4.0 documentation is also available as a `PDF document <https://download.osgeo.org/mapserver/docs/MapServer.pdf>`__ |image| 
+(1143 pages, with clickable table of contents as well).
+
+.. |image| image:: ../../../_static/pdf.png
+   :height: 15
+   :width: 15
+   :alt: PDF icon
+   :target: https://download.osgeo.org/mapserver/docs/MapServer.pdf
+
+Thanks
+------
+
+Thank you to all of the users, developers, and supporters of MapServer. Enjoy!
+
+*The MapServer Team*
+
diff --git a/en/development/announce/index.txt b/en/development/announce/index.txt
@@ -8,6 +8,7 @@
 .. toctree::
    :maxdepth: 2
 
+   8-4
    8-2
    8-0
    7-6
-Original file line number
+Diff line change
@@ Expand Up / @@ -8,6 +8,7 @@ @@
     .. toctree::
        :maxdepth: 2
+-4
 -2
 -0
 -6
@@ Expand Down @@