Wiki source code of Release Notes for XWiki 5.1 Milestone 1
Version 13.2 by Manuel Smeria on 2013/05/23
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 Platform, XWiki Enterprise and XWiki Enterprise Manager. They share the same release notes as they are released together and have the same version. | ||
6 | |||
7 | This is the first milestone for the 5.1 release. | ||
8 | |||
9 | = New and Noteworthy (since XWiki 5.0) = | ||
10 | |||
11 | [[Full list of issues fixed and Dashboard for <version>>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]]. | ||
12 | |||
13 | == <feature N> == | ||
14 | |||
15 | <description of feature N> | ||
16 | |||
17 | == Miscellaneous == | ||
18 | |||
19 | <insert misc user stuff and important bug fix descriptions here in a list, when they are too small to warrant a section by themselves - Change the version in the URL below!> | ||
20 | |||
21 | See the [[full list of JIRA issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+in+%28XCOMMONS%2C+XRENDERING%2C+XWIKI%2C+XE%2C+XEM%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%225.0-milestone-1%22&tempMax=1000]] fixed in this release. | ||
22 | |||
23 | = For Developers = | ||
24 | |||
25 | == REST API improvements == | ||
26 | |||
27 | All REST responses also specify the version of XWiki running on the server in the ##XWiki-Version## HTTP header, and the current user in the ##XWiki-User## header. | ||
28 | |||
29 | == <developer feature N> == | ||
30 | |||
31 | <description of developer feature N> | ||
32 | |||
33 | == Deprecated and Retired projects == | ||
34 | |||
35 | <description of deprecated and retired projects> | ||
36 | |||
37 | == Upgrades == | ||
38 | |||
39 | The following dependencies have been upgraded: | ||
40 | |||
41 | * logback 1.0.13 | ||
42 | * commons-compress 1.5 | ||
43 | * commons-codec 1.8 | ||
44 | * httpclient 4.2.5 | ||
45 | * diffutils 1.3 | ||
46 | * Doxia 1.4 | ||
47 | * JGroups 3.3 | ||
48 | |||
49 | == Miscellaneous == | ||
50 | |||
51 | * A new URL parameter has been added to reference non aggregated JavaScript files: ##?minify=false##. See the [[Debugging Guide>>dev:Community.Debugging||anchor="HDebuggingJavaScript"]]. | ||
52 | * Added API to easily create a DocumentReference from a LocalDocumentReference | ||
53 | {{code language="java"}}DocumentReference documentReference = new DocumentReference(localReference, wikiReference);{{/code}} | ||
54 | * You can now provide a version summary (comment) when updating a page using REST. You can retrieve the version summary either by getting the page or by getting the page history, in which case you get the summary for each page revision. | ||
55 | |||
56 | = Translations = | ||
57 | |||
58 | The following translations have been updated: | ||
59 | |||
60 | {{language codes="none, none"/}} | ||
61 | |||
62 | = Tested Browsers & Databases = | ||
63 | |||
64 | {{include reference="TestReports.ManualTestReportXWiki51M1Summary"/}} | ||
65 | |||
66 | = Known issues = | ||
67 | |||
68 | * [[Bugs we know about>>http://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]] | ||
69 | |||
70 | = Backward Compatibility and Migration Notes = | ||
71 | |||
72 | == General Notes == | ||
73 | |||
74 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above. | ||
75 | |||
76 | {{warning}} | ||
77 | Always make sure you compare your ##xwiki.cfg## and ##xwiki.properties## files with the newest version since some configuration parameters were 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. | ||
78 | {{/warning}} | ||
79 | |||
80 | == Issues specific to XWiki 5.1 Milestone 1 == | ||
81 | |||
82 | * The data type of the 'email' property from the user profile has changed from ##String## to ##Email##, a specialized type [[introduced in 4.2>>ReleaseNotes.ReleaseNotesXWiki42||anchor="HNewfieldtypesforemailandlistofpages"]]. Unfortunately this change doesn't apply automatically when you upgrade from an older version so you have to do it your self:((( | ||
83 | 1. edit ##XWiki.XWikiUsers## with the class editor | ||
84 | 1. delete the 'email' property | ||
85 | 1. add a new property of type ##Email## named 'email' with 'e-Mail' as pretty name | ||
86 | 1. save | ||
87 | )))The values of both ##String## and ##Email## data types are stored in the same database table so there souldn't be any migration issues for existing users. | ||
88 | |||
89 | == API Breakages == | ||
90 | |||
91 | The following APIs were modified since <project> <version - 1>: | ||
92 | |||
93 | {{code language="none"}} | ||
94 | <clirr output here> | ||
95 | {{/code}} |