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.