This is the release notes for XWiki Commons, XWiki Rendering, XWiki Platform and XWiki Enterprise. They share the same release notes as they are released together and have the same version.

This release is a stabilization version that fix important bugs discovered in the 6.4.1 version.

New and Noteworthy (since XWiki 6.4)

Full list of issues fixed and Dashboard for 6.4.1.

Full Issue List

Translations

The following translations have been updated: 

Tested Browsers & Databases

Known issues

• Bugs we know about

Backward Compatibility and Migration Notes

General Notes

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.

Issues specific to XWiki 6.4.1

• The Mail Sender API has changed slightly when sending emails to a list of users or to a group. For example if you wanted to send a template email to a group, you previously had to write:
  ## Parameters for the 'template' MimeMessageFactory
  #set ($templateParameters = {'language' : $xcontext.language, 'velocityVariables' : { 'var1' : 'value1' }})
  
  ## Parameters for the 'group' MimeMessage Iterator Factory
  #set ($templateReference = $services.model.createDocumentReference('', 'Space', 'MailTemplatePage'))
  #set ($parameters = {'parameters' : $parameters, 'source' : $templateReference })
  
  #set ($groupReference = $services.model.createDocumentReference('', 'XWiki', 'MyGroup'))
  #set ($messages = $services.mailsender.createMessages('group', $groupReference, 'template', $parameters))
                                                                                  ^^^^^^^^^^
  #set ($mailResult = $services.mailsender.send($messages, 'database'))

  And now in 6.4.1 you'll need to write:

  ## Parameters for the 'template' MimeMessageFactory
  #set ($templateParameters = {'language' : $xcontext.language, 'velocityVariables' : { 'var1' : 'value1' }})
  
  ## Parameters for the 'group' MimeMessageFactory
  #set ($templateReference = $services.model.createDocumentReference('', 'Space', 'MailTemplatePage'))
  #set ($groupParameters = {'hint' : 'template', 'parameters' : $templateParameters, 'source' : $templateReference })
                            ^^^^^^^^^^^^^^^^^^^
  #set ($groupReference = $services.model.createDocumentReference('', 'XWiki', 'MyGroup'))
  #set ($messages = $services.mailsender.createMessages('group', $groupReference, $groupParameters))
  #set ($mailResult = $services.mailsender.send($messages, 'database'))

API Breakages

TODO