TODO
Always make sure you compare your xwiki.cfg file with the newest version since some configuration parameters were added. Note 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.
There has been a bug that appeared when we released the new XWiki Syntax 2.0 several releases back and which we've finally fixed in this release. Basically if you had a macro followed by a new line and then another macro, both macros were considered as being standalone. This is now fixed and they are correctly considered by the parser as inline. More specifically if you were previously using a standalone macro (such as the TOC macro or the HTML macro) and your macro wasn't separated from a previous macro by at least 2 new lines, it'll now fail to render.
In addition, several pages that are part of the XWiki Enterprise default XAR were not written correctly and didn't have these 2 new lines as mentioned above. We've fixed these pages too but you'll need to make sure you import them in your existing wiki (if you're upgrading) since otherwise these pages will fail to display correctly. These pages are:
