Version 12.1 by Thomas Mortagne on 2014/11/11

Hide last authors
Thomas Mortagne 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 6.3) =
10
11 [[Full list of issues fixed and Dashboard for <version>>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=<fill id here>]].
12
13 == Velocity changes ==
14
Thomas Mortagne 10.1 15 === Remove a Velocity Engine from the cache ===
16
17 ##org.xwiki.velocity.VelocityFactory## now provide an API to remove a cached Velocity Engine.
18
Thomas Mortagne 12.1 19 === macros.vm in wiki based skin ===
Thomas Mortagne 11.1 20
Thomas Mortagne 12.1 21 It's now possible to override macros.vm template in a wiki based skin (object property and attachment). Any modification to this template is also taken into account (the Velocity engine is recreated when the template is modified).
Thomas Mortagne 11.1 22
Thomas Mortagne 10.1 23 === Cleanup unprotected namespaces ===
24
Thomas Mortagne 1.1 25 VelocityEngine automatically get rid of the passed namespace at the end of execution unless it's protected.
26
27 In practice in means that the following:
28
Thomas Mortagne 2.1 29 {{code language="java"}}
Thomas Mortagne 1.1 30 engine.evaluate(new VelocityContext(), new StringWriter(), "namespace", "#macro(mymacro)toto#end")
31
32 Writer out = new StringWriter();
33 engine.evaluate(new VelocityContext(), out, "namespace", "#mymacro()")
34
35 System.out.println(out.toString())
36 {{/code}}
37
38 will now print
39
40 {{code language="none"}}
41 #mymacro()
42 {{/code}}
43
44 To get
45
46 {{code language="none"}}
47 toto
48 {{/code}}
49
50 you need the following
51
Thomas Mortagne 2.1 52 {{code language="java"}}
Thomas Mortagne 1.1 53 engine.startedUsingMacroNamespace("namespace")
54
55 try {
56 engine.evaluate(new VelocityContext(), new StringWriter(), "namespace", "#macro(mymacro)toto#end")
57
58 Writer out = new StringWriter();
59 engine.evaluate(new VelocityContext(), out, "namespace", "#mymacro()")
60
61 System.out.println(out.toString())
62 } finally {
63 engine.stoppedUsingMacroNamespace("namespace")
64 }
65 {{/code}}
66
67 == Miscellaneous ==
68
69 <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!>
70
71 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%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%22<version>%22&tempMax=1000]] fixed in this release.
72
73 = For Developers =
74
75 == <developer feature N> ==
76
77 <description of developer feature N>
78
79 == Deprecated and Retired projects ==
80
81 <description of deprecated and retired projects>
82
83 == Upgrades ==
84
85 The following dependencies have been upgraded:
86
Thomas Mortagne 8.1 87 * [[httpclient 4.3.6>>http://jira.xwiki.org/browse/XCOMMONS-681]]
Thomas Mortagne 9.1 88 * [[commons-codec 1.10>>http://jira.xwiki.org/browse/XCOMMONS-684]]
Thomas Mortagne 1.1 89
90 == Miscellaneous ==
91
Guillaume Delhumeau 7.1 92 * A new parameter has been added to the 'get' action and the 'plain' xpage: ##htmlHeaderAndFooter##, which add the HTML headers (##<html>##,##<head>##,##<body>##, etc...) and footers (##</body>##, ##</html>##, etc...). It could be usefull to create lite popups that displays only the document content without any UI.
Thomas Mortagne 1.1 93
94 = Translations =
95
96 The following translations have been updated:
97
98 {{language codes="none, none"/}}
99
100 = Tested Browsers & Databases =
101
102 {{include reference="TestReports.ManualTestReportTemplateSummary"/}}
103
104 = Performances tests compared to <last super stable version> =
105
106 <a summary of the comparison with latest super stable version>
107
108 More details on <link to the test report>.
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 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.
119
Thomas Mortagne 3.1 120 == Issues specific to XWiki 6.4-milestone-1 ==
Thomas Mortagne 1.1 121
Thomas Mortagne 6.1 122 * VelocityEngine automatically get rid of the passed namespace at the end of execution unless it's protected. See [[Velocity section>>||anchor="HVelocitychanges"]].
Thomas Mortagne 1.1 123
124 == API Breakages ==
125
126 The following APIs were modified since <project> <version - 1>:
127
128 {{code language="none"}}
129 <clirr output here>
130 {{/code}}

Get Connected