Skip to content

Commit 1d6158f

Browse files
jmckennajmckenna
committed
update for 8.4.0-beta2 release
1 parent 767c4bc commit 1d6158f

File tree

20 files changed

+466
-110
lines changed

20 files changed

+466
-110
lines changed

‎en/MIGRATION_GUIDE.txt‎

Lines changed: 55 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,26 @@
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+
.. TIP::
26+
For Windows users, MS4W >=5 leverages the `PROJ_DATA` environment variable,
27+
which points to `/ms4w/share/proj/`
28+
1529
.. _migration-8-2:
1630

1731
MapServer 8.0 to 8.2 Migration
@@ -74,8 +88,6 @@ MapServer 7.6 to 8.0 Migration
7488
...
7589
END #map
7690

77-
78-
7991
- Several deprecated mapfile parameters have been removed, and will throw an
8092
error if you still specify them now. The following are specific examples
8193
to be aware of (but be sure to review the :ref:`full list <rfc133>`), taken from the
@@ -135,8 +147,47 @@ MapServer 7.6 to 8.0 Migration
135147

136148
::
137149

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

182+
END #layer
183+
184+
so the label will appear in the map image as:
185+
186+
.. image:: ./images/label-wrap-with-pipe.png
187+
:height: 59
188+
:width: 187
189+
:class: no-scaled-link
190+
140191
- Reminder: every mapfile :ref:`LAYER` should include a **NAME** parameter.
141192
The NAME should **not contain** special characters, or spaces, or begin with
142193
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-13 - MapServer 8.4.0-beta1 is released**
8+
9+
The first 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-beta1>`
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-13
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)