FIXME: http://bugzilla.ximian.com/show_bug.cgi?id=31896 WARNING Evolution 1.1.1 is a BETA quality release. This means that it has bugs, including possibly destructive bugs that can cause valuable data to be lost. For this reason, please make sure you back up your mail and your calendar/addressbook information before using Evolution 1.1.1 on them. In particular, you are strongly advised to backup the `evolution' directory in your home directory if you are upgrading from a 1.0.x version of Evolution to Evolution 1.1.1. UPGRADING FROM 1.0.x The format of certain configuration files has changed in this version of Evolution. When you start Evolution 1.1.1 for the first time, it will automatically migrate your configuration so that it will work as expected with this version. RETURNING TO 1.0.x If you want to return to a 1.0.x version after trying 1.1.1, you have to restore the original configuration files. From the command-line, you can do the following, after having quit Evolution: killev cd ~/evolution mv filters.xml.bak-1.0 filters.xml mv vfolders.xml.bak-1.0 vfolders.xml mv shortcuts.xml.bak-1.0 shortcuts.xml mv mail/imap.bak-1.0 mail/imap Note that any changes to filters, vfolders or shortcuts made with 1.1.1 will be lost after this operation. Also note that the upgrade mechanism runs automatically only the first time you run 1.1.1. For this reason, if you run Evolution 1.1.1, then go back to 1.0 using the aforementioned procedure, and then go back to using 1.1.1 again, the settings will not be upgraded. To force the upgrade to happen again in this case, use the following command to start Evolution 1.1.1: evolution --force-upgrade SEARCH CRITERIA CHANGES When you specify multiple words in search "contains" criterion, Evolution will now search the mail messages that contain all the words specified, in any order. (The 1.0.x behavior was to look for the whole string in "subject contains" matches, and matched no messages in the case of body searches.) This applies to the search bar, the filter rules and the vfolder rules. Filter rules and vfolder rules might need to be re-adjusted after you upgrade to version 1.1.1. IMAP FOLDER NAME CHANGES (I18N) If you created any folder names using non-ASCII characters using prior versions of Evolution, you will find they may not be displayed properly anymore. This is because previous versions did not implement IMAP I18N folder names correctly as specified in RFC 2060. The upgrade script will try to rectify any filters or vfolders using any such names. However, as it does not know the character set used by the server, non ISO-8859-1 (latin-1) characters will not be properly converted. You may need to reverify the filter and vFolder rules in this case. Also note that if such folder names do not display properly that it is purely cosmetic and may be fixed by renaming the folder(s) in question. KNOWN BUGS If you have any unnamed contact lists in any of your addressbook folders, you might experience hangs and/or crashes when specifying destination addresses, for example when composing meeting requests. Giving a name to all the contact lists will fix the problem. This problem will be fixed in the next Evolution release. NOTE FOR SOLARIS/CDE USERS This release of Evolution doesn't install icons in the CDE "Application" group as Evolution 1.0.x used to do. While this doesn't affect users who are running Ximian Desktop, users who wish to run Evolution under the CDE environment will also have to set the PATH, GNOME_PATH and LD_LIBRARY_PATH environment variables to point to the Evolution installation before launching the `evolution' executable. This can be done, for example, with a shell script like the following: PATH=/opt/gnome/bin:/usr/bin:${PATH} GNOME_PATH=/opt/gnome:/usr LD_LIBRARY_PATH=/opt/gnome/lib:/usr/lib:${LD_LIBRARY_PATH} export LD_LIBRARY_PATH GNOME_PATH PATH exec evolution This problem will be fixed in the next release of Evolution.