Wiki source code of Release Notes for XWiki 4.5 Milestone 1
Version 29.1 by Marius Dumitru Florea on 2013/01/16
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} |
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
 |
17.1 | 5 | {{warning}} |
| 6 | If you are migrating from an earlier version than 4.0, and your database contains statistics collected using a version earlier than 2.2, you will probably encounter an issue during our automated database migration. To avoid that issue, you will need to clean up your statistics by executing some SQL commands described in issue [[XWIKI-8129>>http://jira.xwiki.org/browse/XWIKI-8129]]. Be sure to apply these before attempting the migration. If your are in doubt, apply it, these could not hurt. If you don't, you will face duplicate IDs errors during the migration process, and it will fail, preventing you to run your wiki. | ||
| 7 | {{/warning}} | ||
| 8 | |||
| |
1.1 | 9 | 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. |
| 10 | |||
| 11 | <insert description of release here> | ||
| 12 | |||
| 13 | = New and Noteworthy (since XWiki 4.4) = | ||
| 14 | |||
 |
16.1 | 15 | == Distribution Wizard improvements == |
| 16 | |||
| 17 | When upgrading from an old version that didn't have the distribution wizard, the wizard doesn't know what user interface (XAR) was previously installed (imported). This information can help the Extension Manager merge automatically the wiki pages from your database with those from the new version of the user interface. | ||
| 18 | |||
| 19 | The distribution wizard will first ask you if you are performing an upgrade. | ||
| 20 | |||
| 21 | {{image reference="DW-previousUiUpgradeQuestion.png"/}} | ||
| 22 | |||
| |
23.1 | 23 | Then you need to select the user interface version that was previously installed. |
| |
16.1 | 24 | |
| |
23.1 | 25 | {{image reference="DW-previousUiForm-01.png"/}} |
| |
16.1 | 26 | |
| |
23.1 | 27 | The distribution wizard determines the id of the previously imported XAR based on the selected version. |
| 28 | |||
| 29 | {{image reference="DW-previousUiForm-02.png"/}} | ||
| 30 | |||
| 31 | You can edit the suggested id if you know you had a different user interface previously installed. | ||
| 32 | |||
| 33 | {{image reference="DW-previousUiForm-03.png"/}} | ||
| 34 | |||
| |
16.1 | 35 | Finally you need to repair the specified user interface extension. This will mark the extension as installed (update the extension index without actually importing the wiki pages from the XAR). |
| 36 | |||
| 37 | {{image reference="DW-previousUiExtension.png"/}} | ||
| 38 | |||
| |
27.1 | 39 | {{image reference="DW-repairPreviousUiExtension.png"/}} |
| 40 | |||
| |
16.1 | 41 | Next you can install the new version of the user interface. |
| 42 | |||
| |
10.1 | 43 | == Translatable AppWithinMinutes apps == |
| |
1.1 | 44 | |
| |
10.2 | 45 | The AppWithinMinutes wizard is now generating a document translation bundle for the application which allows you to translate class field pretty names, list values (for static list fields) and live table columns names. If you have an existing application that was created with AppWithinMinutes you just have to edit and save it to get the new translation bundle. |
| |
1.1 | 46 | |
| |
10.1 | 47 | If your wiki is setup for multilingual support then on the application home page, in the application menu, you now have an entry to translate the application. The link takes you to the document translation bundle. |
| 48 | |||
| 49 | {{image reference="AWM-translateAppMenu.png"/}} | ||
| 50 | |||
| 51 | When editing an application you now have the option to update the translation bundle. Note that for the moment the translation bundle (its default language) is regenerated so you may lose translation keys you added yourself. In the future we want to update the translation bundle preserving the custom keys. | ||
| 52 | |||
| 53 | {{image reference="AWM-updateTranslationsOption.png"/}} | ||
| 54 | |||
| 55 | See the [[AppWithinMinutes documentation>>extensions:Extension.App Within Minutes Application]] for more information. | ||
| 56 | |||
| |
1.1 | 57 | == Miscellaneous == |
| 58 | |||
| |
7.1 | 59 | * The message sender is now using the new user/group picker.((( |
| |
4.1 | 60 | {{image reference="messageSender-userPicker.png"/}} |
| |
7.1 | 61 | ))) |
| 62 | * The create and manage workspace forms are now using the new user picker.((( | ||
| |
6.1 | 63 | {{image reference="createWorkspace-ownerAndMembers.png"/}} |
| |
7.1 | 64 | ))) |
| |
29.1 | 65 | * You can now add or invite multiple users at once to an workspace, and the user name field uses the new user picker.((( |
| 66 | {{image reference="workspace-administration-users-add-invite.png"/}} | ||
| 67 | ))) | ||
| |
12.1 | 68 | * We improved the way changes are displayed by emphasizing the in-line changes.((( |
| 69 | {{image reference="unifiedDiff.png"/}} | ||
| 70 | ))) | ||
| |
2.1 | 71 | * Support for searching content in Java Class file attachments [[has been temporarily dropped>>http://jira.xwiki.org/browse/XWIKI-8656]]. |
| |
7.1 | 72 | * Markdown syntax support has been completely rewritten, fixing several existing bugs. |
 |
24.1 | 73 | * The page Main.WebHome can now safely be edited by any user who has edit permission. (In earlier releases, the AJAX suggest feature for tags would unexpectedly break if non-programmers edited the page.) |
| |
1.1 | 74 | |
| 75 | 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+%224.5-milestone-1%22&tempMax=1000]] fixed in this release. | ||
| 76 | |||
| 77 | = For Developers = | ||
| 78 | |||
| 79 | == <developer feature N> == | ||
| 80 | |||
| 81 | <description of developer feature N> | ||
| 82 | |||
| 83 | == Deprecated and Retired projects == | ||
| 84 | |||
| 85 | <description of deprecated and retired projects> | ||
| 86 | |||
| 87 | == Upgrades == | ||
| 88 | |||
| 89 | The following dependencies have been upgraded: | ||
| 90 | |||
| 91 | * <list libraries that have been upgraded> | ||
| 92 | |||
| 93 | == Miscellaneous == | ||
| 94 | |||
| |
25.1 | 95 | * It is now possible to delegate programming rights directly to a filesystem template to allow it to access the privileged API by adding the template name to the set defined in DefaultPrivilegedTemplateRenderer. Such a template cannot currently access the context document, but this restriction will most likely be removed in 5.0. |
| 96 | |||
| |
1.1 | 97 | <other dev stuff to add and link to JIRA for all issues fixed> |
| 98 | |||
| 99 | = Translations = | ||
| 100 | |||
| 101 | The following translations have been updated: | ||
| 102 | |||
| 103 | {{language codes="none, none"/}} | ||
| 104 | |||
| 105 | = Tested Browsers & Databases = | ||
| 106 | |||
| 107 | Here's the list of browsers tested with this version (i.e. browsers that we've tested as working - Check the list of [[supported browsers>>dev:Community.BrowserSupportStrategy]]): | ||
| 108 | |||
| 109 | {{velocity}} | ||
| 110 | ## name = iexplorer, firefox, chrome, safari, opera | ||
| 111 | {{/velocity}} | ||
| 112 | |||
| 113 | {{browser name="none" version="x.x"/}} | ||
| 114 | |||
| 115 | Here's the list of databases tested with this version (i.e. databases that we've tested as working - Check the list of [[supported databases>>dev:Community.DatabaseSupportStrategy]]): | ||
| 116 | |||
| 117 | {{velocity}} | ||
| 118 | ## name = hsqldb, mysql, postgresql, oracle, opera | ||
| 119 | {{/velocity}} | ||
| 120 | |||
| 121 | {{database name="none" version="x.x"/}} | ||
| 122 | |||
| 123 | = Known issues = | ||
| 124 | |||
| 125 | * [[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]] | ||
| 126 | |||
| 127 | = Test Report = | ||
| 128 | |||
| 129 | You can check the [[manual test report>>TestReports.WebHome#<anchor to test report>]] to learn about what was tested and the results on various browsers. | ||
| 130 | |||
| 131 | = Backward Compatibility and Migration Notes = | ||
| 132 | |||
| 133 | == General Notes == | ||
| 134 | |||
| |
17.1 | 135 | {{warning}} |
| 136 | PLEASE, BACKUP YOUR DATABASE BEFORE STARTING YOUR WIKI. | ||
| 137 | AUTOMATED MIGRATION PROCEDURE TAKE PLACE AT STARTUP AND YOU MAY NEED TO START OVER IF YOU ENCOUNTER AN UNEXPECTED ISSUE. | ||
| 138 | {{/warning}} | ||
| 139 | |||
| |
1.1 | 140 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above. |
| 141 | |||
| 142 | {{warning}} | ||
| 143 | 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. | ||
| 144 | {{/warning}} | ||
| 145 | |||
| |
17.1 | 146 | {{warning}} |
| 147 | If you are migrating from an earlier version than 4.0, and your database contains statistics collected using a version earlier than 2.2, you will probably encounter an issue during our automated database migration. To avoid that issue, you will need to clean up your statistics by executing some SQL commands described in issue [[XWIKI-8129>>http://jira.xwiki.org/browse/XWIKI-8129]]. Be sure to apply these before attempting the migration. If your are in doubt, apply it, these could not hurt. If you don't, you will face duplicate IDs errors during the migration process, and it will fail, preventing you to run your wiki. | ||
| 148 | {{/warning}} | ||
| 149 | |||
| 150 | {{warning}} | ||
| 151 | If you have encountered an issue with the migration, you may need to start over from a backup. Be careful that during the migration, two new tables have been created (in each xwiki database for a farm) and should be dropped when you restore a backup of a database coming from a version earlier than 4.x. These two tables are DATABASECHANGELOG and DATABASECHANGELOGLOCK. These should only be removed if you restore a pre-4.x database schema. Mixing an old database with these two tables will surely cause issue during schema updates (liquibase checksum failure). | ||
| 152 | {{/warning}} | ||
| 153 | |||
| |
1.1 | 154 | == Issues specific to XWiki 4.5M1 == |
| 155 | |||
| 156 | <issues specific to the project> | ||
| 157 | |||
| 158 | == API Breakages == | ||
| 159 | |||
| 160 | The following APIs were modified since XWiki 4.4: | ||
| 161 | |||
| 162 | {{code language="none"}} | ||
| 163 | <clirr output here> | ||
| 164 | {{/code}} |
