Hide last authors
Vincent Massol 16.3 1 {{velocity}}
2 #set ($version = $doc.getObject('ReleaseNotes.Code.ReleaseNoteClass').version)
3 #set ($versionPrefix = $stringtool.substringBefore($version, '-'))
4 #set ($versionParts = $stringtool.split($versionPrefix, '.'))
5 #set ($isRC = $version.contains('rc'))
6 #set ($isFinal = !$isRC)
7 #set ($isFirstFinal = $versionParts.size() == 2 && $isFinal)
8 {{/velocity}}
9
Simon Urli 1.1 10 {{box cssClass="floatinginfobox" title="**Contents**"}}
11 {{toc/}}
12 {{/box}}
13
14 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.
15
Simon Urli 10.1 16 Mostly a stabilization release with bugs fixes and some improvement such as a better experience when translating pages, adding the possibility to set wiki macro priorities, new URLs for resetting passwords and retrieving usernames, and ability to disable the Like feature.
Simon Urli 1.1 17
Vincent Massol 16.1 18 {{error}}
19 The following regressions were introduced in this release (and found after it was released). Please check them out and if they impact you we recommend waiting to upgrade to a version where they are fixed.
20
Vincent Massol 16.3 21 {{velocity}}
22 #if ($isFirstFinal)
23 #set ($affectedVersions = "${version}-rc-1, ${version}")
24 #set ($fixVersionJQL = " and fixVersion != ${version}-rc-1 ")
25 #else
26 #set ($affectedVersions = "${version}")
27 #set ($fixVersionJQL = "")
28 #end
Vincent Massol 16.1 29 {{jira id="xwikiorg" source="jql"}}
Vincent Massol 16.3 30 category = 10000 and affectedVersion in ($affectedVersions)${fixVersionJQL}and priority = Blocker and resolution in (Fixed, Unresolved)
Vincent Massol 16.1 31 {{/jira}}
Vincent Massol 16.3 32 {{/velocity}}
Vincent Massol 16.1 33 {{/error}}
34
Simon Urli 3.1 35 = New and Noteworthy (since XWiki 13.0) =
Simon Urli 1.1 36
Simon Urli 4.1 37 [[Full list of issues fixed and Dashboard for XWiki 13.1>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14692]].
Simon Urli 1.1 38
39 {{releasenotechanges/}}
40
41 === Upgrades ===
42
43 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]]):
44
Simon Urli 2.1 45 * [[Syntax Highlighting 4.6>>https://jira.xwiki.org/browse/XWIKI-18359]]
Simon Urli 3.1 46 * [[Jodconverter 4.4.2>>https://jira.xwiki.org/browse/XWIKI-18241]]
47 * [[TrueVFS 0.14.0>>https://jira.xwiki.org/browse/XWIKI-18284]]
48 * [[Solr 8.8.0>>https://jira.xwiki.org/browse/XWIKI-17377]]
49 * [[MySQL connector 8.0.23>>https://jira.xwiki.org/browse/XWIKI-18287]]
50 * [[MariaDB connector 2.7.2>>https://jira.xwiki.org/browse/XWIKI-18308]]
51 * [[Joda-Time 2.10.10>>https://jira.xwiki.org/browse/XWIKI-18316]]
52 * [[Infinispan 11.0.9.Final>>https://jira.xwiki.org/browse/XCOMMONS-2117]]
53 * [[Checker Qual 3.10.0>>https://jira.xwiki.org/browse/XCOMMONS-2132]]
54 * [[Byte Buddy 1.10.20>>https://jira.xwiki.org/browse/XCOMMONS-2131]]
55 * [[Batik 1.14>>https://jira.xwiki.org/browse/XWIKI-18285]]
56 * [[Apache XML Graphics Commons 2.6>>https://jira.xwiki.org/browse/XWIKI-18286]]
57 * [[ASM 9.1>>https://jira.xwiki.org/browse/XCOMMONS-2128]]
Marius Dumitru Florea 8.1 58 * [[CKEditor Integration 1.53.1>>https://jira.xwiki.org/browse/XWIKI-18367]]
Simon Urli 1.1 59
60 = Translations =
61
62 The following translations have been updated:
63
Simon Urli 5.1 64 {{language codes="de,es,fr,no"/}}
Simon Urli 1.1 65
66 = Tested Browsers & Databases =
67
Ilie Andriuta 15.1 68 {{include reference="TestReports.ManualTestReportSummaryXWiki131.WebHome"/}}
Simon Urli 1.1 69
70 {{comment}}
71 TODO: uncomment and update with proper links when the report is ready.
72
73 = Performances tests compared to <last super stable version> =
74
75 {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}}
76
77 More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]].
78 {{/comment}}
79
80 = Known issues =
81
82 * [[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]]
83
84 = Backward Compatibility and Migration Notes =
85
86 == General Notes ==
87
88 * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
89 ** ##xwiki.cfg##
90 ** ##xwiki.properties##
91 ** ##web.xml##
92 ** ##hibernate.cfg.xml##
93 * 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.
94
Simon Urli 3.1 95 == Issues specific to XWiki 13.1 ==
Simon Urli 1.1 96
Simon Urli 3.1 97 === Breaking OfficeConverter API ===
Simon Urli 1.1 98
Simon Urli 3.1 99 The interface ##org.xwiki.officeimporter.converter.OfficeConverter## has been broken on purpose after [[an accepted proposal on the forum>>https://forum.xwiki.org/t/refactor-officeconverter-api-to-remove-getformatregistry/8152]]. This API was going to be broken because of the Jodconverter upgrade since the maintainer of the project moved their APIs to another package, so we took the opportunity to stop exposing in OfficeConverter classes coming from Jodconverter. Note that we introduced some new APIs to cover the usages we've seen for this API. Don't hesitate to open a feature request on Jira if some usages are not covered.
100
101 === New Reset Password and Retrieve Username URLs ===
102
103 See above for more details. The old ##XWiki.ResetPassword## and ##XWiki.ForgotUsername## wiki pages must not be used anymore, and any custom change perform in those pages won't be taken into account (you'll need to port your changes to Java since the new feature is coded in Java). However, the pages have been kept to ensure that using the old URLs will keep working for the time being: the pages now redirect to the new URLs.
104
Vincent Massol 12.1 105 === Downgrade of Pygments from 2.5.1 to 2.4.2 ===
106
107 We've identified some issues with the [[code macro>>doc:extensions:Extension.Code Macro]] when the language property is left undefined. The language can be miss-identified, leading to a bad syntax highlighting.
108
109 For example:
110
111 {{gallery}}
112 image:xwiki-13.1.png
113 image:xwiki11.10.11.png
114 {{/gallery}}
115
116 This issue has been introduced in Pygments 2.5.1 and fixed in Pygments 2.8.0 (see the [[Pygments changes>>https://github.com/pygments/pygments/blob/master/CHANGES]] for me details). We cannot upgrade to Pygments 2.8.0 for now since it requires Python 3, which we do not support currently. If you wish to keep using Pygments 2.5.1, you can do so by replacing the Pygments jar located in ##webapps/xwiki/WEB-INF/lib/pygments-2.4.2.jar## with the the jar of [[Pygments 2.5.1>>https://nexus.xwiki.org/nexus/service/local/repositories/central/content/org/pygments/pygments/2.5.1/pygments-2.5.1.jar]].
117
Simon Urli 1.1 118 == API Breakages ==
119
Simon Urli 3.1 120 The following APIs were modified since XWiki 13.0:
Simon Urli 1.1 121
Simon Urli 7.1 122 {{backwardCompatiblityReportXml version="13.1"/}}
Simon Urli 1.1 123
124 = Credits =
125
126 The following people have contributed code and translations to this release (sorted alphabetically):
127
Simon Urli 6.1 128 Björn Ludwig
129 Christian Böhnke
130 ClemDee
131 Clément
132 Eduard Moraru
133 Francisco García Moreno
134 Jarle Sandmo
135 Manuel Leduc
136 Marius Dumitru Florea
137 Simon Urli
138 Thomas Mortagne
139 Vincent Massol
140 xrichard
141 XWiki

Get Connected