Wiki source code of Release Notes for XWiki 8.1
Last modified by Thomas Mortagne on 2017/03/24
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 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]], [[XWiki Platform>>http://platform.xwiki.org]] and [[XWiki Enterprise>>http://enterprise.xwiki.org]]. They share the same release notes as they are released together and have the same version. | ||
| 6 | |||
 |
13.1 | 7 | This release brings an upgrade to the Java 8 runtime, a new Tips panel that replaces the old Quick Links panel, Extension Manager improvements and LDAP avatar synchronization. As usual, a lot of bug fixes (81) and minor improvements (43) are also included. |
| |
1.1 | 8 | |
| |
3.1 | 9 | = New and Noteworthy (since XWiki 8.0) = |
| |
1.1 | 10 | |
 |
18.1 | 11 | [[Full list of issues fixed and Dashboard for 8.1>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13603]]. |
| |
1.1 | 12 | |
| |
8.1 | 13 | {{display reference="ReleaseNotesXWiki81M1" section="HRequiresJava8"/}} |
| |
1.1 | 14 | |
| |
8.1 | 15 | {{display reference="ReleaseNotesXWiki81M1" section="HTipsPanel"/}} |
| |
1.1 | 16 | |
| |
8.1 | 17 | {{display reference="ReleaseNotesXWiki81M1" section="HSandboxRelocation"/}} |
| |
5.1 | 18 | |
| |
9.1 | 19 | {{display reference="ReleaseNotesXWiki81M2" section="HDocumentsMacroImprovement"/}} |
| 20 | |||
| 21 | {{display reference="ReleaseNotesXWiki81M2" section="HRSSMacroImprovements"/}} | ||
| 22 | |||
| |
8.1 | 23 | {{display reference="ReleaseNotesXWiki81M1" section="HExtensionManagerimprovements"/}} |
| |
5.1 | 24 | |
| |
8.1 | 25 | {{display reference="ReleaseNotesXWiki81M1" section="HFlavorsimprovements"/}} |
| |
5.1 | 26 | |
| |
9.1 | 27 | {{display reference="ReleaseNotesXWiki81M2" section="HSynchronizationofuseravatarfromLDAP"/}} |
| 28 | |||
| |
8.1 | 29 | {{display reference="ReleaseNotesXWiki81M1" section="HActiveInstalls"/}} |
| |
5.1 | 30 | |
| |
1.1 | 31 | == Miscellaneous == |
| 32 | |||
| |
5.1 | 33 | * The Annotations Application's Administration section has been updated to present the exception spaces as "locations", using the ##documentTree## macro. The behavior has not been changed.((( |
| |
6.2 | 34 | {{image reference="ReleaseNotesXWiki81M1@annotationsAdminSection.png" width="600px"/}} |
| |
5.1 | 35 | ))) |
| |
9.1 | 36 | * The [[Gadget's title>>extensions:Extension.Dashboard Macro||anchor="HGadget27stitile"]] has now a default value which is internationalized. |
| |
2.1 | 37 | * Put a link to the product home page in the footer by default |
 |
2.2 | 38 | * Template providers that are restricted to certain pages are now also available on the children of those pages. |
| |
9.1 | 39 | * The [[Document Tree Macro>>extensions:Extension.Document Tree Macro||anchor="HParameters"]] has a new parameter to limit the number of child nodes displayed when a parent node is expanded for the first time. |
| |
5.1 | 40 | * The ##xwiki.usedefaultweb## parameter from ##xwiki.cfg## has been removed. See below. |
| 41 | * Job module does not validate stored status at startup. This might improve a lot the startup time when there is a lot of status. Also there seems to still be use cases where XStream get lost in edge case when parsing, this was blocking the whole XWiki startup for a very long time. | ||
| |
1.1 | 42 | |
| |
18.1 | 43 | See the [[full list of JIRA issues>>https://jira.xwiki.org/issues/?filter=14308]] fixed in this release. |
| |
1.1 | 44 | |
| 45 | = For Developers = | ||
| 46 | |||
| |
10.1 | 47 | {{display reference="ReleaseNotesXWiki81M2" section="HStandardjava.lang.Packageproperties"/}} |
| |
1.1 | 48 | |
| |
10.1 | 49 | {{display reference="ReleaseNotesXWiki81M1" section="HDeferredJavaScriptModuleDependencyLoading"/}} |
| |
1.1 | 50 | |
| |
10.1 | 51 | {{display reference="ReleaseNotesXWiki81RC1" section="HContextandcacheinconsistencyhunting"/}} |
| |
1.1 | 52 | |
| |
10.1 | 53 | {{display reference="ReleaseNotesXWiki81RC1" section="HExtensionManagerimprovements"/}} |
| |
1.1 | 54 | |
| 55 | == Upgrades == | ||
| 56 | |||
| 57 | The following dependencies have been upgraded: | ||
| 58 | |||
| |
18.1 | 59 | * [[Bootstrap 3.3.6>>https://jira.xwiki.org/browse/XWIKI-12951]] |
| 60 | * [[commons-compress 1.11>>https://jira.xwiki.org/browse/XCOMMONS-960]] | ||
| 61 | * [[commons-io 2.5>>https://jira.xwiki.org/browse/XCOMMONS-969]] | ||
| 62 | * [[commons-net 3.5>>https://jira.xwiki.org/browse/XCOMMONS-977]] | ||
| 63 | * [[GWT 2.7>>https://jira.xwiki.org/browse/XWIKI-13236]] | ||
| 64 | * [[Infinispan 8.2.1>>https://jira.xwiki.org/browse/XWIKI-13293]] | ||
| 65 | * [[Jackson 2.7.4>>https://jira.xwiki.org/browse/XCOMMONS-972]] | ||
| 66 | * [[JGroups 3.6.9>>https://jira.xwiki.org/browse/XWIKI-13344]] | ||
| 67 | * [[jQuery 2.2.2>>https://jira.xwiki.org/browse/XWIKI-11095]] | ||
| 68 | * [[JSqlParser 0.9.5>>https://jira.xwiki.org/browse/XWIKI-13215]] | ||
| 69 | * [[logback 1.1.7>>https://jira.xwiki.org/browse/XCOMMONS-953]] | ||
| 70 | * [[RequireJS 2.2>>https://jira.xwiki.org/browse/XWIKI-11095]] | ||
| 71 | * [[slf4j 1.7.21>>https://jira.xwiki.org/browse/XCOMMONS-958]] | ||
| 72 | * [[XStream 1.4.9>>https://jira.xwiki.org/browse/XCOMMONS-941]] | ||
| |
1.1 | 73 | |
| 74 | == Miscellaneous == | ||
| 75 | |||
| |
10.1 | 76 | * The default LiveTable results page (##XWiki.LiveTableResults##, the page that generates the JSON displayed by the LiveTable) [[now supports a ##location## extra parameter>>extensions:Extension.Livetable Macro||anchor="HParameter24options"]]. |
| 77 | * [[Modified WebJars URL format>>extensions:Extension.WebJars Integration||anchor="HURLFormat"]] and added some new Script Service methods:((( | ||
| 78 | {{code language="none"}} | ||
| 79 | public String url(String webjarId, String namespace, String path, Map<String, ?> params) | ||
| 80 | public String url(String webjarId, String namespace, String path) | ||
| 81 | {{/code}} | ||
| 82 | ))) | ||
| 83 | * IRC Bot Application has been moved to XWiki Contrib under the new extension id of ##org.xwiki.contrib:application-ircbot-ui## | ||
| 84 | * Selenium Application had been moved to XWiki Contrib under the new extension id of ##org.xwiki.contrib:application-selenium## | ||
| 85 | * FAQ Application has been moved to XWiki Contrib under the new extension id of ##org.xwiki.contrib:application-faq-ui## | ||
| 86 | * Starting With XWiki 8.1M1, the backward-compatibility tool we use is [[Revapi>>http://revapi.org/]]. We had to move away from CLIRR since it didn't support Java 8 constructs. | ||
| 87 | * Introduced JobFinishingEvent to be called at the end of the job execution before starting to close it | ||
| 88 | * Introduced new JobStatus#getError() which return the exception that filled the job main execution (if any) (it's also logged in the log as an error like before) | ||
| 89 | * The XAR plugin now also verifies that Translation pages are using the ##plain/1.0## syntax (it checks pages having a Translation xobject in them). | ||
| 90 | * This Methods Arguments Velocity Uberspector [[now supports calling varargs methods>>extensions:Extension.Velocity Module||anchor="HMethodArgumentsUberspector"]]. | ||
| |
1.1 | 91 | |
| 92 | = Translations = | ||
| 93 | |||
| 94 | The following translations have been updated: | ||
| 95 | |||
| |
11.1 | 96 | {{language codes="ca, de, fr, pt_BR, ru"/}} |
| |
1.1 | 97 | |
| 98 | = Tested Browsers & Databases = | ||
| 99 | |||
 |
14.1 | 100 | {{include reference="TestReports.ManualTestReportSummaryXWiki81"/}} |
| |
1.1 | 101 | |
| 102 | = Performances tests compared to <last super stable version> = | ||
| 103 | |||
| 104 | <a summary of the comparison with latest super stable version> | ||
| 105 | |||
| 106 | More details on <link to the test report>. | ||
| 107 | |||
| 108 | = Known issues = | ||
| 109 | |||
| |
18.1 | 110 | * [[Bugs we know about>>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+%3D+%22Top+Level+Projects%22+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]] |
| |
1.1 | 111 | |
| 112 | = Backward Compatibility and Migration Notes = | ||
| 113 | |||
| 114 | == General Notes == | ||
| 115 | |||
| 116 | When upgrading make sure you compare your ##xwiki.cfg##, ##xwiki.properties## and ##web.xml## files with the newest version since some configuration parameters may have been modified or added. Note that you should add ##xwiki.store.migration=1## so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything. | ||
| 117 | |||
| |
12.1 | 118 | == Issues specific to XWiki 8.1 == |
| |
1.1 | 119 | |
| |
12.1 | 120 | * Since we've modified content of the Quick Links Panel, the Distribution Wizard may detect a merge conflict if this panel was customized. In addition, the Quick Links panel may disappear after an upgrade to 8.1M1+. You can add it back from the administration UI if you want to keep it (e.g. if it has been customized). |
| 121 | * The WebJars URL format has been modified to support relative WebJars URL in subwikis. The new format is {{code language="none"}}/webjars/<namespace>/<path/to/resource>?...{{/code}}. Reminder: you should not use this format directly and instead you should use the Script Service to generate a valid WebJars URL; this isolate you from any URL change. Example from Velocity: {{code language="none"}}$services.webjars.url(...){{/code}}. | ||
| |
16.1 | 122 | * The ##xwiki.usedefaultweb## parameter has been removed from ##xwiki.cfg##. This parameter had not been working since XWiki 7.2-milestone-1; when we introduced Nested Pages we had to make a choice and we decided to support addressing top-level Nested Pages without having to have ##WebHome## in the URL (nor having to finish URLs with a trailing ##/##). For example, ##http:~/~/<server>/xwiki/bin/view/something## points to ##something.WebHome## by default since XWiki 7.2-milestone-1. |
| |
1.1 | 123 | |
| 124 | == API Breakages == | ||
| 125 | |||
| |
3.1 | 126 | The following APIs were modified since XWiki 8.0: |
| |
1.1 | 127 | |
 |
16.5 | 128 | {{backwardCompatiblityReport version="8.1"/}} |
| |
16.3 | 129 |
