Wiki source code of Release Notes for XWiki 11.5
Version 10.1 by Thomas Mortagne on 2019/06/25
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 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 | {{/jira}} | ||
| 15 | |||
| 16 | If one or several of these bugs impact you, then you should wait for the next version of XWiki that will be released soon! | ||
| 17 | {{/error}} | ||
| 18 | |||
| 19 | = New and Noteworthy (since XWiki 11.4) = | ||
| 20 | |||
| 21 | [[Full list of issues fixed and Dashboard for 11.5>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14422]]. | ||
| 22 | |||
| 23 | {{releasenotechanges/}} | ||
| 24 | |||
| 25 | === Upgrades === | ||
| 26 | |||
| 27 | 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]]): | ||
| 28 | |||
| 29 | * [[Hibernate 5.4.3>>https://jira.xwiki.org/browse/XWIKI-8286]] | ||
| 30 | * [[Commons DBCP2 2.6.0>>https://jira.xwiki.org/browse/XCOMMONS-1487]] | ||
| 31 | * [[liquibase 3.6.3>>https://jira.xwiki.org/browse/XWIKI-16123]] | ||
| 32 | * [[JNR POSIX 3.0.50>>https://jira.xwiki.org/browse/XWIKI-16472]] | ||
| 33 | * [[JNR FFI 2.1.10>>https://jira.xwiki.org/browse/XWIKI-16472]] | ||
| 34 | * [[JFFI 1.2.19>>https://jira.xwiki.org/browse/XWIKI-16471]] | ||
| 35 | * [[Solr 7.7.2>>https://jira.xwiki.org/browse/XWIKI-16454]] | ||
| 36 | * [[HSQLDB 2.5.0>>https://jira.xwiki.org/browse/XWIKI-16451]] | ||
| 37 | * [[Pygments 2.4.2>>https://jira.xwiki.org/browse/XWIKI-16429]] | ||
| 38 | * [[Doxia 1.9>>https://jira.xwiki.org/browse/XRENDERING-567]] | ||
| 39 | * [[httpclient 4.5.9>>https://jira.xwiki.org/browse/XCOMMONS-1655]] | ||
| 40 | * [[Bouncy Castle 1.62>>https://jira.xwiki.org/browse/XCOMMONS-1653]] | ||
| 41 | * [[Commons Configuration 2.5>>https://jira.xwiki.org/browse/XCOMMONS-1650]] | ||
| 42 | * [[Infinispan 9.4.14.Final>>https://jira.xwiki.org/browse/XCOMMONS-1649]] | ||
| 43 | * [[Jackson 2.9.9>>https://jira.xwiki.org/browse/XCOMMONS-1640]] | ||
| 44 | * [[Dom4j 2.1.1>>https://jira.xwiki.org/browse/XCOMMONS-1585]] | ||
| 45 | * [[CKEditor Integration 1.35>>https://jira.xwiki.org/browse/XWIKI-16437]] | ||
| 46 | * [[Tour Application 1.3.1>>https://jira.xwiki.org/browse/XWIKI-16482]] | ||
| 47 | |||
| 48 | = Translations = | ||
| 49 | |||
| 50 | The following translations have been updated: | ||
| 51 | |||
| 52 | {{language codes="da, de, es, fr, hr, it, ko, lv, nl, no, pt_BR, ru, sk, sv, tr, zh, zh_TW"/}} | ||
| 53 | |||
| 54 | {{comment}} | ||
| 55 | TODO: uncomment and update with proper link when the report is ready. | ||
| 56 | |||
| 57 | = Tested Browsers & Databases = | ||
| 58 | |||
| 59 | {{include reference="TestReports.<test report page>"/}} | ||
| 60 | {{/comment}} | ||
| 61 | |||
| 62 | {{comment}} | ||
| 63 | TODO: uncomment and update with proper links when the report is ready. | ||
| 64 | |||
| 65 | = Performances tests compared to <last super stable version> = | ||
| 66 | |||
| 67 | <a summary of the comparison with latest super stable version> | ||
| 68 | |||
| 69 | More details on <link to the test report>. | ||
| 70 | {{/comment}} | ||
| 71 | |||
| 72 | = Known issues = | ||
| 73 | |||
| 74 | * [[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]] | ||
| 75 | |||
| 76 | = Backward Compatibility and Migration Notes = | ||
| 77 | |||
| 78 | == General Notes == | ||
| 79 | |||
| 80 | * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added: | ||
| 81 | ** ##xwiki.cfg## | ||
| 82 | ** ##xwiki.properties## | ||
| 83 | ** ##web.xml## | ||
| 84 | ** ##hibernate.cfg.xml## | ||
| 85 | * 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. | ||
| 86 | |||
| 87 | == Issues specific to XWiki 11.5 == | ||
| 88 | |||
| 89 | === Renaming of WikiMacro field === | ||
| 90 | |||
| 91 | The field {{code}}Macro content type{{/code}} has been renamed {{code}}Macro content availability{{/code}} in WikiMacroClass UI. | ||
| 92 | |||
| 93 | === XWiki now requires JDBC 4.2 === | ||
| 94 | |||
| 95 | 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). | ||
| 96 | |||
| 97 | === Hibernate 5.4.3 upgrade === | ||
| 98 | |||
| 99 | 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: | ||
| 100 | |||
| 101 | * 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 | ||
| 102 | * You might need to update your ##hibernate.cfg.xml## file | ||
| 103 | * Various Hibernate classes have been removed or moved to different Java packages | ||
| 104 | * Various Hibernate methods have been removed from the APIs or not having any effect anymore even if still here and deprecated | ||
| 105 | |||
| 106 | === HTML head extension point identifier update === | ||
| 107 | |||
| 108 | 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. | ||
| 109 | |||
| 110 | == API Breakages == | ||
| 111 | |||
| 112 | The following APIs were modified since XWiki 11.4: | ||
| 113 | |||
| 114 | {{backwardCompatiblityReport version="11.5"/}} | ||
| 115 | |||
| 116 | = Credits = | ||
| 117 | |||
| 118 | The following people have contributed code and translations to this release (sorted alphabetically): | ||
| 119 | |||
| 120 | * Adel Atallah | ||
| 121 | * Alex Cotiugă | ||
| 122 | * Anca Luca | ||
| 123 | * carlosame | ||
| 124 | * Clément Aubin | ||
| 125 | * Ecaterina Moraru (Valica) | ||
| 126 | * Guillaume Delhumeau | ||
| 127 | * Jarle Sandmo | ||
| 128 | * JSDennebouy | ||
| 129 | * Marius Dumitru Florea | ||
| 130 | * Pyungkyu Moon | ||
| 131 | * Simon Urli | ||
| 132 | * slauriere | ||
| 133 | * Thomas Mortagne | ||
| 134 | * ttzn | ||
| 135 | * Vincent Massol |
