Skip to content

Commit 894108c

Browse files
jmckennajmckenna
authored
update for 8.4.0-beta2 release (#986)
1 parent 767c4bc commit 894108c

23 files changed

+509
-110
lines changed

‎en/MIGRATION_GUIDE.txt‎

Lines changed: 57 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,28 @@
66
MapServer Migration Guide
77
*****************************************************************************
88

9-
:Last Updated: 2024-08-26
9+
:Last Updated: 2024-12-13
1010

1111
.. contents:: Table of Contents
1212
:depth: 2
1313
:backlinks: top
1414

15+
.. _migration-8-4:
16+
17+
MapServer 8.2 to 8.4 Migration
18+
==============================
19+
20+
- you can now build against the PCRE2 library (WITH_PCRE2=ON)
21+
22+
- reminder that since the PROJ 9.1 release, the former `PROJ_LIB` variable has
23+
been replaced with `PROJ_DATA`
24+
25+
.. seealso:: `Setting the location of PROJ files` in :ref:`projection`.
26+
27+
.. TIP::
28+
For Windows users, MS4W >=5 leverages the `PROJ_DATA` environment variable,
29+
which points to `/ms4w/share/proj/`
30+
1531
.. _migration-8-2:
1632

1733
MapServer 8.0 to 8.2 Migration
@@ -74,8 +90,6 @@ MapServer 7.6 to 8.0 Migration
7490
...
7591
END #map
7692

77-
78-
7993
- Several deprecated mapfile parameters have been removed, and will throw an
8094
error if you still specify them now. The following are specific examples
8195
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
135149

136150
::
137151

138-
...&map.layer[county].class[0].label[0]=SIZE+24&...
152+
...&map.layer[county].class[0].label[0]=SIZE+24&...
153+
154+
- Using the :ref:`LABEL` WRAP parameter with *MAXLENGTH 0* to always wrap at the wrap character
155+
is no longer supported (as there are more strict checks in MapServer >= 8 for negative or
156+
zero values), so instead you can remove (or comment) that *MAXLENGTH 0* line, and MapServer
157+
will wrap at the character, such as:
158+
159+
.. code-block:: mapfile
160+
161+
LAYER
162+
NAME "wrap-no-maxlength"
163+
CLASS
164+
LABEL
165+
TYPE truetype
166+
ANGLE follow
167+
FONT "dejavu"
168+
SIZE 8
169+
COLOR 0 0 0
170+
#MAXLENGTH 0 #would cause error in MapServer >=8
171+
WRAP "|"
172+
END #label
173+
...
174+
END #class
175+
...
176+
177+
FEATURE
178+
POINTS
179+
50 -450 150 -450
180+
END #points
181+
TEXT "W: WrapSpace|With Pipe"
182+
END #feature
139183

184+
END #layer
185+
186+
so the label will appear in the map image as:
187+
188+
.. image:: ./images/label-wrap-with-pipe.png
189+
:height: 59
190+
:width: 187
191+
:class: no-scaled-link
192+
140193
- Reminder: every mapfile :ref:`LAYER` should include a **NAME** parameter.
141194
The NAME should **not contain** special characters, or spaces, or begin with
142195
a number. This simple name is important for your downstream users (such as

‎en/announcements/announcements_archive.txt‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,13 @@
44
MapServer Announcement Archives
55
*****************************************************************************
66

7+
**2024-12-14 - MapServer 8.4.0-beta2 is released**
8+
9+
The second beta for MapServer 8.4 has been released. The list of
10+
major changes for this release can be found in the :ref:`8.4 announcement <announce-8-4>`.
11+
See the :ref:`changelog <changelog-8-4-0-beta2>`
12+
for the full list of changes and head to :ref:`download` to obtain a copy.
13+
714
**2024-09-02 - MapServer 8.2.2 is released**
815

916
The maintenance release of MapServer 8.2.2 is now available.

‎en/development/announce/8-4.txt‎

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
.. _announce-8-4:
2+
3+
*****************************************************************************
4+
Version 8.4.0-beta1 Announcement
5+
*****************************************************************************
6+
7+
:Authors: Project Steering Committee
8+
:Drafted: 2024-12-14
9+
10+
The MapServer Team is pleased to announce the first beta of the major release of
11+
MapServer 8.4.0
12+
13+
This 8.4 release will bring a number of major new features that are briefly
14+
summarized in this document. The full list of changes can be found in :ref:`changelog-8-4`.
15+
The :ref:`Migration Guide <migration-8-4>` also contains more detailed examples of
16+
the major changes.
17+
18+
Major New Features in MapServer 8.4
19+
-----------------------------------
20+
21+
- add option to build against the PCRE2 library (`#7073 <https://github.com/MapServer/MapServer/pull/7073>`__)
22+
23+
- add CONNECTIONTYPE RASTERLABEL (`#7135 <https://github.com/MapServer/MapServer/pull/7135>`__)
24+
25+
- set MS_LEGEND_KEYSIZE_MAX to 1000 (`#7154 <https://github.com/MapServer/MapServer/pull/7154>`__)
26+
27+
- add 4 new COMPOSITE.COMPOP blending operations (`#7065 <https://github.com/MapServer/MapServer/pull/7065>`__)
28+
29+
- allow encryption key files to use paths relative to a mapfile (`#7181 <https://github.com/MapServer/MapServer/pull/7181>`__)
30+
31+
- allow use_default_extent_for_getfeature to be used for OGC Features API and PostGIS (`#7197 <https://github.com/MapServer/MapServer/pull/7197>`__)
32+
33+
Other Related Updates
34+
---------------------
35+
36+
- the demo server hosting many live OGC endpoints has been updated &
37+
constantly maintained, as it is so important for the community:
38+
https://demo.mapserver.org
39+
40+
Migration Guide
41+
---------------
42+
43+
Head to the :ref:`Migration Guide <migration-8-4>` for mapfile examples of the major 8.4.0 changes.
44+
45+
Source Code Download
46+
--------------------
47+
48+
The source for this release can be downloaded at:
49+
50+
https://mapserver.org/download.html
51+
52+
Binary Distributions
53+
--------------------
54+
55+
Binary distributions will be available in the coming days:
56+
57+
- Debian binaries of 8.4.0 are already available: https://tracker.debian.org/pkg/mapserver
58+
- `OSGeoLive <https://live.osgeo.org>`__ 17.0 release process is happening now, but
59+
it will soon include MapServer 8.4.0
60+
- `UbuntuGIS <https://wiki.ubuntu.com/UbuntuGIS>`__ will follow the OSGeoLive
61+
release and will then include MapServer 8.4.0
62+
- MS4W users have already been using branch-8-4 code, but watch for
63+
a new release shortly containing the 8.4.0 changes at: https://ms4w.com
64+
65+
.. TBD
66+
- `RHEL and CentOS` TODO
67+
- `OpenSUSE` TODO
68+
69+
Other binary distributions listed on the download page should also be updated
70+
with binaries for the new release shortly.
71+
72+
Documentation
73+
-------------
74+
75+
The entire 8.4.0 documentation is also available as a `PDF document <https://download.osgeo.org/mapserver/docs/MapServer.pdf>`__ |image|
76+
(1143 pages, with clickable table of contents as well).
77+
78+
.. |image| image:: ../../../_static/pdf.png
79+
:height: 15
80+
:width: 15
81+
:alt: PDF icon
82+
:target: https://download.osgeo.org/mapserver/docs/MapServer.pdf
83+
84+
Thanks
85+
------
86+
87+
Thank you to all of the users, developers, and supporters of MapServer. Enjoy!
88+
89+
*The MapServer Team*
90+

‎en/development/announce/index.txt‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88
.. toctree::
99
:maxdepth: 2
1010

11+
8-4
1112
8-2
1213
8-0
1314
7-6

0 commit comments

Comments
 (0)