Version 29.1 by Thomas Mortagne on 2013/11/13

Hide last authors
Marius Dumitru Florea 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
7 <insert description of release here>
8
9 = New and Noteworthy (since XWiki 5.3 Milestone 1) =
10
11 [[Full list of issues fixed and Dashboard for 5.3>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=11698]].
12
Marius Dumitru Florea 5.1 13 == Solr Search Improvements ==
14
15 === Search Facets ===
16
Marius Dumitru Florea 5.2 17 The display of some of the search facets has been improved. The Author and Creator facets now show the user full name, alias and avatar.
Marius Dumitru Florea 5.1 18
Thomas Mortagne 8.1 19 {{image reference="search-userFacet.png"/}}
Marius Dumitru Florea 5.1 20
Marius Dumitru Florea 12.1 21 The wiki facet displays the wiki pretty name instead of the wiki identifier.
22
23 {{image reference="search-wikiFacet.png"/}}
24
Marius Dumitru Florea 21.1 25 The language facet displays the full language name and country (when applicable) in the current locale.
Marius Dumitru Florea 17.1 26
27 {{image reference="search-languageFacet.png" /}}
28
Marius Dumitru Florea 21.1 29 The number of displayed facet values is limited to 5 by default but you can see the rest of the values by clicking on the link following the facet values (each click will show 5 more values).
30
Marius Dumitru Florea 25.1 31 The date facets (last modification date and creation date) have been improved to display a list of predefined date intervals, with the possibility to specify a custom date interval.
32
33 {{image reference="search-dateFacet.png" /}}
34
Marius Dumitru Florea 25.2 35 When selected, the date facet displays the end points of the date interval. If you specify only the start/end date then the interval will include all dates after/before the specified date.
Marius Dumitru Florea 25.1 36
37 {{image reference="search-dateFacet-selected.png" /}}
38
Marius Dumitru Florea 26.1 39 === RSS Feed ===
40
41 We added a RSS feed for Solr search results. You can find the link on the default search page after the list of results. The feed provides the most recent results that match the current search query and filters. It contains the same type of information that was included in the Lucene search RSS feed.
42
Marius Dumitru Florea 6.3 43 See the [[Solr Search Application documentation>>extensions:Extension.Solr Search Application]] for details.
Marius Dumitru Florea 6.1 44
Thomas Mortagne 13.1 45 == WikiStream improvements ==
Marius Dumitru Florea 1.1 46
Thomas Mortagne 13.1 47 === Script service improvements ===
Thomas Mortagne 10.1 48
Thomas Mortagne 15.1 49 * added a properties converter for ##WikiStreamType## to make easier to manipulate it from Velocity
Thomas Mortagne 14.1 50 * made APIs asynchronous
Thomas Mortagne 13.1 51
52 === Confluence XML input module for WikiStream ===
53
Thomas Mortagne 10.1 54 A new WikiStream input module has been added to parse [[Confluence backup packages>>https://confluence.atlassian.com/display/DOC/Exporting+Confluence+Pages+and+Spaces+to+XML]].
55
Thomas Mortagne 2.1 56 === New XHTML based Confluence syntax ===
Marius Dumitru Florea 1.1 57
Thomas Mortagne 10.1 58 Since 4.0 Confluence moved to a XHTML based syntax for pages content. So in order to import recent version of Confluences a parser for this syntax had to be written first.
Thomas Mortagne 2.1 59
Thomas Mortagne 29.1 60 == New Syntax Guide ==
61
62 The Syntax Guide has been completely rewritten to better support growing number of syntaxes and make easier to add documentation for more syntaxes. For now it includes ##xwiki/1.0##, ##xwiki/2.0## and ##xwiki/2.1##.
63
64 {{image reference="helpui221.png" /}}
65
66 {{image reference="helpui222.png" /}}
67
Marius Dumitru Florea 1.1 68 == Miscellaneous ==
69
Vincent Massol 7.1 70 * The URL Legacy JAR is now correctly bundled in the XE WAR. This is important since otherwise you'd need to set the URL configuration properties in your ##xwiki.properties## file in addition to setting them in ##xwiki.cfg##. For example ##url.standard.multiwiki.isPathBased## in ##xwiki.properties## **and** ##xwiki.virtual.usepath## in ##xwiki.cfg##).
Marius Dumitru Florea 1.1 71
72 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.
73
74 = For Developers =
75
76 == <developer feature N> ==
77
78 <description of developer feature N>
79
80 == Deprecated and Retired projects ==
81
82 <description of deprecated and retired projects>
83
84 == Upgrades ==
85
86 The following dependencies have been upgraded:
87
Vincent Massol 3.1 88 * [[Groovy 2.1.9>>http://jira.xwiki.org/browse/XWIKI-9603]]
Denis Gervalle 22.1 89 * [[Bouncy Castle Crypto package 1.49>>http://jira.xwiki.org/browse/XWIKI-9631]] (Warning: Not fully binary compatible)
Marius Dumitru Florea 1.1 90
91 == Miscellaneous ==
92
Thomas Mortagne 9.1 93 * new {{code language="none"}}com.xpn.xwiki.doc.XWikiDocument#getDocumentReferenceWithLocale(){{/code}} method to get the real reference of the document to use in {{code language="none"}}com.xpn.xwiki.XWiki#getDocument(DocumentReference, XWikiContext){{/code}} for example
Marius Dumitru Florea 1.1 94
95 = Translations =
96
97 The following translations have been updated:
98
99 {{language codes="none, none"/}}
100
101 = Tested Browsers & Databases =
102
Manuel Smeria 15.2 103 {{include reference="TestReports.ManualTestReportXWiki53M2Summary"/}}
Marius Dumitru Florea 1.1 104
105 = Known issues =
106
107 * [[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]]
108
109 = Backward Compatibility and Migration Notes =
110
111 == General Notes ==
112
Vincent Massol 25.3 113 == General Notes ==
Marius Dumitru Florea 1.1 114
Vincent Massol 25.3 115 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.
Marius Dumitru Florea 1.1 116
117 == Issues specific to XWiki <version> ==
118
119 <issues specific to the project>
120
121 == API Breakages ==
122
123 The following APIs were modified since XWiki 5.2:
124
125 * Very young API. Never fully worked.
126
127 {{code language="none"}}
128 org.xwiki.xml.stax.SAXEventConsumer: Class org.xwiki.xml.stax.SAXEventConsumer removed
129 org.xwiki.xml.stax.SAXEventWriter: Removed org.xwiki.xml.stax.SAXEventConsumer from the list of superclasses
130 {{/code}}
131
132 * Requesting a dependency without indicating the namespace does not really make sense. This interface is not really supposed to be implemented anyway.
133
134 {{code language="none"}}
135 org.xwiki.extension.ExtensionManager: Method 'public org.xwiki.extension.Extension resolveExtension(org.xwiki.extension.ExtensionDependency, java.lang.String)' has been added to an interface
136 {{/code}}
137
138 * Needed to filter search by namespace. This interface is not really supposed to be implemented anyway.
139
140 {{code language="none"}}
141 org.xwiki.extension.repository.InstalledExtensionRepository: Method 'public org.xwiki.extension.repository.result.IterableResult searchInstalledExtensions(java.lang.String, java.lang.String, int, int)' has been added to an interface
142 {{/code}}
143
144 * Young API.
145
146 {{code language="none"}}
147 org.xwiki.filter.xml.serializer.XMLSerializerFactory: Method 'public java.lang.Object createSerializer(java.lang.Class[], javax.xml.transform.Result, org.xwiki.filter.xml.XMLConfiguration)' has been added to an interface
148 {{/code}}
149
150 * Young API that has been refactored to introduce the new Resource module.
151
152 {{code language="none"}}
153 org.xwiki.url.AbstractXWikiURL: Class org.xwiki.url.AbstractXWikiURL removed
154 org.xwiki.url.URLCreationException: Class org.xwiki.url.URLCreationException removed
155 org.xwiki.url.UnsupportedURLException: Class org.xwiki.url.UnsupportedURLException removed
156 org.xwiki.url.XWikiEntityURL: Class org.xwiki.url.XWikiEntityURL removed
157 org.xwiki.url.XWikiURL: Class org.xwiki.url.XWikiURL removed
158 org.xwiki.url.XWikiURLFactory: Class org.xwiki.url.XWikiURLFactory removed
159 org.xwiki.url.XWikiURLManager: Class org.xwiki.url.XWikiURLManager removed
160 org.xwiki.url.XWikiURLSerializer: Class org.xwiki.url.XWikiURLSerializer removed
161 org.xwiki.url.XWikiURLType: Class org.xwiki.url.XWikiURLType removed
162 {{/code}}
163
164 * XWikiURL (now Resource) should only be in the Execution Context and not in the Request.
165
166 {{code language="none"}}
167 org.xwiki.container.servlet.ServletRequest: Method 'public org.xwiki.url.XWikiURL getURL()' has been removed
168 org.xwiki.container.servlet.ServletRequest: Method 'public void setXWikiURL(org.xwiki.url.XWikiURL)' has been removed
169 org.xwiki.container.portlet.PortletRequest: Method 'public org.xwiki.url.XWikiURL getURL()' has been removed
170 org.xwiki.container.portlet.PortletRequest: Method 'public void setXWikiURL(org.xwiki.url.XWikiURL)' has been removed
171 org.xwiki.container.Request: Field XWIKI_URL has been removed, but it was previously a constant
172 {{/code}}

Get Connected