I'm a longtime user of Zoe as an email client, but I've found out a couple of new things today after I recently broke it with an upgrade.

Normally an upgrade is trivial, as the Zoe wiki says: "Copy the new binaries over your old installation. That's all". Well nearly...

I did that and I was getting a Java error on trying to start Zoe up; being a Java-dunce I didn't know what I'd cocked up, so I got the latest JDK from Sun on the suspicion that my Java install was elderly and possibly crufty anyway. That didn't fix it, so I had a harder look at the error - java.lang.NoSuchMethodError: org.apache.lucene.search.BooleanQuery.setMaxClauseCount(I)V

Seeing as Lucene was something that had changed in the upgrade I had a good look at where I'd installed the new binaries and sure enough there were also 3 or 4 old Lucene related jar files. I deleted all the jar files from this directory, copied the new binaries in again, and all was well!

For some reason I also had to reset the authentication too, but that was nicely described on the Zoe general list.

All in it's a nice app, and the docs - distributed as they may be - help you fix 99% of the problems easily.