Wiki source code of Release Notes for XWiki 11.5

Last modified by Thomas Mortagne on 2019/07/18

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]. They share the same release notes as they are released together and have the same version.
6
7 This release continues the work on improving concurrent editing of pages and introduces new page and attachment pickers for macros. The code macro gets a new layout to display line numbers. Inline editing support for wiki macros has also been greatly improved.
8
9 {{error}}
10 Some important bugs have been found since XWiki 11.5 has been released:
11
12 {{jira url="http://jira.xwiki.org"}}
13 XWIKI-16495
14 XWIKI-16530
15 XWIKI-16593
16 {{/jira}}
17
18 If one or several of these bugs impact you, then you should wait for the next version of XWiki that will be released soon!
19 {{/error}}
20
21 = New and Noteworthy (since XWiki 11.4) =
22
23 [[Full list of issues fixed and Dashboard for 11.5>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14422]].
24
25 {{releasenotechanges/}}
26
27 === Upgrades ===
28
29 The following runtime dependencies have been upgraded (they have a different release cycle than [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]):
30
31 * [[Hibernate 5.4.3>>https://jira.xwiki.org/browse/XWIKI-8286]]
32 * [[Commons DBCP2 2.6.0>>https://jira.xwiki.org/browse/XCOMMONS-1487]]
33 * [[liquibase 3.6.3>>https://jira.xwiki.org/browse/XWIKI-16123]]
34 * [[JNR POSIX 3.0.50>>https://jira.xwiki.org/browse/XWIKI-16472]]
35 * [[JNR FFI 2.1.10>>https://jira.xwiki.org/browse/XWIKI-16472]]
36 * [[JFFI 1.2.19>>https://jira.xwiki.org/browse/XWIKI-16471]]
37 * [[Solr 7.7.2>>https://jira.xwiki.org/browse/XWIKI-16454]]
38 * [[HSQLDB 2.5.0>>https://jira.xwiki.org/browse/XWIKI-16451]]
39 * [[Pygments 2.4.2>>https://jira.xwiki.org/browse/XWIKI-16429]]
40 * [[Doxia 1.9>>https://jira.xwiki.org/browse/XRENDERING-567]]
41 * [[httpclient 4.5.9>>https://jira.xwiki.org/browse/XCOMMONS-1655]]
42 * [[Bouncy Castle 1.62>>https://jira.xwiki.org/browse/XCOMMONS-1653]]
43 * [[Commons Configuration 2.5>>https://jira.xwiki.org/browse/XCOMMONS-1650]]
44 * [[Infinispan 9.4.14.Final>>https://jira.xwiki.org/browse/XCOMMONS-1649]]
45 * [[Jackson 2.9.9>>https://jira.xwiki.org/browse/XCOMMONS-1640]]
46 * [[Dom4j 2.1.1>>https://jira.xwiki.org/browse/XCOMMONS-1585]]
47 * [[CKEditor Integration 1.35>>https://jira.xwiki.org/browse/XWIKI-16437]]
48 * [[Tour Application 1.3.1>>https://jira.xwiki.org/browse/XWIKI-16482]]
49
50 = Translations =
51
52 The following translations have been updated:
53
54 {{language codes="da, de, es, fr, hr, it, ko, lv, nl, no, pt_BR, ru, sk, sv, tr, zh, zh_TW"/}}
55
56 = Tested Browsers & Databases =
57
58 {{include reference="TestReports.ManualTestReportSummaryXWiki115.WebHome"/}}
59
60 {{comment}}
61 TODO: uncomment and update with proper links when the report is ready.
62
63 = Performances tests compared to <last super stable version> =
64
65 <a summary of the comparison with latest super stable version>
66
67 More details on <link to the test report>.
68 {{/comment}}
69
70 = Known issues =
71
72 * [[Bugs we know about>>https://jira.xwiki.org/issues/?jql=category%20%3D%2010000%20AND%20issuetype%20%3D%20Bug%20AND%20resolution%20%3D%20Unresolved%20ORDER%20BY%20updated%20DESC]]
73
74 = Backward Compatibility and Migration Notes =
75
76 == General Notes ==
77
78 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
79 ** ##xwiki.cfg##
80 ** ##xwiki.properties##
81 ** ##web.xml##
82 ** ##hibernate.cfg.xml##
83 * Add ##xwiki.store.migration=1## in ##xwiki.cfg## so that XWiki will attempt to automatically migrate your current database to any new schema. Make sure you backup your Database before doing anything.
84
85 == Issues specific to XWiki 11.5 ==
86
87 === Renaming of WikiMacro field ===
88
89 The field {{code}}Macro content type{{/code}} has been renamed {{code}}Macro content availability{{/code}} in WikiMacroClass UI.
90
91 === XWiki now requires JDBC 4.2 ===
92
93 In practice it just means you need to make sure the database connector you are using is not too old (JDBC 4.2 came with Java 8 so you should be fine if you downloaded the connector in recent years).
94
95 === Hibernate 5.4.3 upgrade ===
96
97 Hibernate has (finally) been upgraded to the very last version. While it means you will benefit from bugfix/improvement/new features it's also a huge jump (previous version was close to 10 years old) and you will probably have issues if you are directly manipulating Hibernate APIs or some library expecting a much older version of Hibernate. You can find the details on https://github.com/hibernate/hibernate-orm/wiki/Migration-Guides but here is an extract from XWiki point of view:
98
99 * HQL '##?##'-based wildcards are not supported anymore at all by Hibernate. We added an automatic converter (to '##?1##' JPQL style) which seems to work well but it might not be perfect and it's producing a deprecating warning log
100 * You might need to update your ##hibernate.cfg.xml## file
101 * Various Hibernate classes have been removed or moved to different Java packages
102 * Various Hibernate methods have been removed from the APIs or not having any effect anymore even if still here and deprecated
103
104 === HTML head extension point identifier update ===
105
106 The identifier of [[the HTML header extension point>>Documentation.DevGuide.ExtensionPoint.HTMLHead]] allowing to inject HTML in the pages ##head## tag has been changed from ##org.xwiki.platform.head## to ##org.xwiki.platform.html.head##. Update your UI Extension Points if you were using the old id. This was done to disambiguate between HTML head and page head.
107
108 == API Breakages ==
109
110 The following APIs were modified since XWiki 11.4:
111
112 {{backwardCompatiblityReport version="11.5"/}}
113
114 = Credits =
115
116 The following people have contributed code and translations to this release (sorted alphabetically):
117
118 * Adel Atallah
119 * Alex Cotiugă
120 * Anca Luca
121 * carlosame
122 * Clément Aubin
123 * Ecaterina Moraru (Valica)
124 * Guillaume Delhumeau
125 * Jarle Sandmo
126 * JSDennebouy
127 * Marius Dumitru Florea
128 * Pyungkyu Moon
129 * Simon Urli
130 * slauriere
131 * Thomas Mortagne
132 * ttzn
133 * Vincent Massol

Get Connected