This document describes ThunderTine, an extension ("Add-On") to Mozilla
Thunderbird, a mailer under the Mozilla Public Licence (MPL) which is 
compatible to General Public Licence (GPL). The goal is synchronisation with
Tine 2.0 groupware, which is also open source (AGPL), using the Microsoft
ActiveSync protocol. 

LEGAL NOTICE

According to Microsoft their protocol "may be covered by patents". If so they
are valid in US only. If you intend to use this extension in USA you should be
aware of the conditions of patent law, especially if you plan to use it for
commercial reasons. 

Due to the patent law issue ThunderTine is licenced under GPL v2 ONLY. I have
no idea how later versions of GPL are affected by patents. All I know is that
later versions try to cover these questions, too. 

FEATURES

By now ThunderTine syncs address books with Tine 2.0 contacts folder inside tine.
Calendar synchronisation supports the following features: 
title, location, date/time, description, attendees, alarm (limited to 1; only before start yet), recurrence (excl. more than one day per month/year). 

There's no tasks synchronisation by the time of writing.

INSTALL

For users: Download ttine.xpi and point your Thunderbird Add-On installer to
the file. Restart Thunderbird and configure ThunderTine through its preferences
dialog. 

For developers: The xpi file is just a regular zip file. It contents the folder
structure as you can see in SVN. To work with the sources the fastest track is
installing the xpi first and then go to your thunderbird profile folder and 
delete all files below extensions/[email protected]. Now put all files
from SVN into that folder. After a restart Thunderbird is working with the
sources, not the xpi anymore. 

DEVELOPER HINTS

ThunderTine is 100% javascript. It makes use of additions that are related to
Mozilla software but for experienced javascript developers it should be
understandable. I myself am not a javascript specialist. 

Look at the folder structure. Inside content the actual program files resident.
In defaults you can find the default values for Thunderbird's registry. Locale
is self-explanatory and skin holds the files for the user interface. 

If you're working with linux (and MacOS X probably) you can use build.sh to create a xpi
file from the sources. It will make the necessary changes to chrome.manifest
and pack the rest into a jar which will find itself in folder chrome. All this
will be inside a (new) ttine.xpi. 

HISTORY

0.1     Initial  Version: Sync contacts between Thunderbird and Tine 2.0
0.2     Problems with ampersand ("&") solved
0.3a	protocol version 12.0 (Kristina - 2013.03)
	support for thunderbird 17.0.4 (various javascript bugfixes)
	delayed access to password manager (on first httpRequest; increases usability if masterpassword is used)
	support for syncing multiple contact folders added (several modifications under the hood; simplified sync code)
0.3b	sync contacts complete (minor runtime errors fixed)
	full support for folder operations (FolderDelete seems to be brocken in tine20)
0.4a	experimental calendar support (set preference extensions.ttine.enableExperimentalCode=true)
	sync contacts (md5 calculation fixed)
0.4b	calendar support complete