Wiki source code of Release Notes for XWiki 5.3 Milestone 1
Version 15.1 by Thomas Mortagne on 2013/10/16
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]], [[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 | |||
7 | <insert description of release here> | ||
8 | |||
9 | = New and Noteworthy (since XWiki 5.2) = | ||
10 | |||
11 | [[Full list of issues fixed and Dashboard for 5.3>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11698]]. | ||
12 | |||
13 | == <feature N> == | ||
14 | |||
15 | <description of feature N> | ||
16 | |||
17 | == Miscellaneous == | ||
18 | |||
19 | * Some XSS fixes | ||
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+%22<version>%22&tempMax=1000]] fixed in this release. | ||
22 | |||
23 | = For Developers = | ||
24 | |||
25 | == DocumentReference Locale now taken into account in XWiki#exists and XWiki#getDocument == | ||
26 | |||
27 | You can now use ##XWiki#exist## method to check for some translation existence too, before that the only way was to either load the XWikiDocument or write your own XWQL or HQL query. | ||
28 | |||
29 | ##XWiki#getDocument## has been modified accordingly too to be consistent so you don't need to go through ##XWikiDocument#getTranslatedDocument## anymore. | ||
30 | |||
31 | It also mean that you need to be careful of what Locale is in the DocumentReference with those APIs now. | ||
32 | |||
33 | == New Extension Manager APIs | ||
34 | |||
35 | === Extension sub script services | ||
36 | |||
37 | The ##extension## service now expose an extension point for extension related script service so that it's used as entry point for all of them. | ||
38 | |||
39 | By default the following are provided: | ||
40 | * $services.extension.core (for core extensions APIs) | ||
41 | * $services.extension.local (for local extensions APIs) | ||
42 | * $services.extension.installed (for installed extensions APIs) | ||
43 | * $services.extension.xar (for XAR extension APIS) | ||
44 | |||
45 | == XWiki Enterprise Archetype == | ||
46 | |||
47 | A new archetype is now available to easily create your own product based on XWiki Enterprise. To use: | ||
48 | |||
49 | {{code}} | ||
50 | mvn archetype:generate \ | ||
51 | -DarchetypeArtifactId=xwiki-enterprise-archetype \ | ||
52 | -DarchetypeGroupId=org.xwiki.enterprise \ | ||
53 | -DarchetypeVersion=5.3-milestone-1 | ||
54 | {{/code}} | ||
55 | |||
56 | == XAR plugin improvements == | ||
57 | |||
58 | The XAR plugin now provides the ability to change values in the XML pages. For example: | ||
59 | |||
60 | {{code}} | ||
61 | <plugin> | ||
62 | <groupId>org.xwiki.commons</groupId> | ||
63 | <artifactId>xwiki-commons-tool-xar-plugin</artifactId> | ||
64 | <configuration> | ||
65 | <transformations> | ||
66 | <transformation> | ||
67 | <file>Blog/WebHome.xml</file> | ||
68 | <xpath>/xwikidoc/object/property/itemsPerPage</xpath> | ||
69 | <value>100</value> | ||
70 | </transformation> | ||
71 | <transformation> | ||
72 | <artifact>org.xwiki.platform:xwiki-platform-administration-ui</artifact> | ||
73 | <file>XWiki/XWikiPreferences.xml</file> | ||
74 | <xpath>/xwikidoc/object/property/colorTheme</xpath> | ||
75 | <value>ColorThemes.Mint</value> | ||
76 | </transformation> | ||
77 | </transformations> | ||
78 | </configuration> | ||
79 | </plugin> | ||
80 | {{/code}} | ||
81 | |||
82 | == Miscellaneous == | ||
83 | |||
84 | * [[Script Services implementations have been moved outside of the ##internal## package>>dev:Community.JavaCodeStyle||anchor="HPackagenames"]] in order for CLIRR to check them for backward incompatibilities and so that their API are made available in generated Javadoc. | ||
85 | |||
86 | == Deprecated and Retired projects == | ||
87 | |||
88 | <description of deprecated and retired projects> | ||
89 | |||
90 | == Upgrades == | ||
91 | |||
92 | The following dependencies have been upgraded: | ||
93 | |||
94 | * [[commons-fileupload 1.3>>http://jira.xwiki.org/browse/XCOMMONS-458]] | ||
95 | * [[cssparser 0.9.10>>http://jira.xwiki.org/browse/XCOMMONS-459]] | ||
96 | * [[XStream 1.4.5>>http://jira.xwiki.org/browse/XCOMMONS-462]] | ||
97 | * [[HttpClient 4.3>>http://jira.xwiki.org/browse/XCOMMONS-460]] | ||
98 | * [[Bean Validation 1.1>>http://jira.xwiki.org/browse/XCOMMONS-461]] (and [[Hibernate Validator 5.0.1>>http://jira.xwiki.org/browse/XWIKI-9548]]) | ||
99 | |||
100 | = Translations = | ||
101 | |||
102 | The following translations have been updated: | ||
103 | |||
104 | {{language codes="none, none"/}} | ||
105 | |||
106 | = Tested Browsers & Databases = | ||
107 | |||
108 | {{include reference="TestReports.ManualTestReportTemplateSummary"/}} | ||
109 | |||
110 | = Known issues = | ||
111 | |||
112 | * [[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]] | ||
113 | |||
114 | = Backward Compatibility and Migration Notes = | ||
115 | |||
116 | == General Notes == | ||
117 | |||
118 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above. | ||
119 | |||
120 | {{warning}} | ||
121 | 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. | ||
122 | {{/warning}} | ||
123 | |||
124 | == Issues specific to XWiki <version> == | ||
125 | |||
126 | <issues specific to the project> | ||
127 | |||
128 | == API Breakages == | ||
129 | |||
130 | The following APIs were modified since <project> <version - 1>: | ||
131 | |||
132 | {{code language="none"}} | ||
133 | <clirr output here> | ||
134 | {{/code}} |