1. Introduction
   1.1. Project/Component Working Name:
        Lightning 1.0 

   1.2. Name of Document Author/Supplier:
        Author:  Brian Lu 
        Sponsor: Brian Cameron 

2. Project Summary
   2.1. Project Description:
        Lightning is an extension to tightly integrate calendar functionality
        into Thunderbird, a popular OpenSolaris mail client.

        It provides similar functionality as Evolution calendar, including
        scheduling, tasks, etc.
   
   2.2. Risks and Assumptions:
        Risks may includes:
        - Product quality/stability. Since Lightning is still in the
          development stage (currently it is in 1.0b2 stage) and no official
          release is available yet, some new features may be added in the
          future.

4. Technical Description:
   4.1. Details:
        The project will involve making sure that the Lightning builds and runs
        on Solaris, helping users manage their schedulings and tasks.

        Lightning 1.0 provides the following new features:
	- Seamless integration into the new Thunderbird 3.0 user interface
	- The different modes (calendar view, task view) are now displayed in
          tabs
	- You can now define multiple alarms for a single event
	- CalDAV support and interoperability with various CalDAV servers have
          been improved
        - WCAP 3.0 support has been improved
        
	Stability, performance and memory consumption have been improved.

        User's local calendars are stored at:
        $HOME/.thunderbird/user-profile-dir/calendar-data/local.sqlite 

        Lightning 0.x settings can be migrated to Lightning 1.0 settings
        smoothly. After upgrading, Lightning 1.0 marks the old
        $HOME/.thunderbird/user-profile-dir/storage.sdb obsolete to prevent 
        the user from using Lightning 0.x. 

        If the user tries to use Lightning 0.x, following error message will 
        be shown in a popup window and Lightning add-on is disabled in the 
        thunderbird:

           The calendar data in your profile was updated by a newer version
           of Lightning, and continuing will probably cause the information
           to be lost or corrupted. Lightning will now be disabled and 
           Thunderbird restarted

        That is to say, the user cannot use Lightning 0.x anymore after 
        upgrading.

        If the user deletes $HOME/.thunderbird/user-profile-dir/storage.sdb
        manually, then Lightning 0.x will work again, but previous settings are 
        unavailable. 

   4.5 Interfaces: 
   
       Exported Interfaces 
       Interface              Stability            Comments 
       ---------------------  -------------------  ----------------------
       $HOME/.thunderbird/user-profile-dir/calendar-data/local.sqlite 
                              Project Private      local calendar settings 

       $HOME/.thunderbird/user-profile-dir/storage.sdb 
                              Obsolete Project    local calendar settings 
                              Private              used in Lightning 0.x

       $HOME/.thunderbird/user-profile-dir/storage.sdb was not listed in the
       "Exported Interfaces" table of Lightning 0.3 ARC case (LSARC 2007/043)
       due to error.

       Imported Interfaces 
       Interface              Stability            Comments 
       --------------------   -------------------  ------------------------ 
       database/sqlite-3      Uncommitted          sqlite3 db
                                                   LSARC 2008/059
                                                   LSARC 2008/120
       mail/thunderbird       Contracted Project   Lightning is a 
                              Private              thunderbird add-on  

   4.10. Packaging & Delivery 
         The project will be delivering the following packages to OpenSolaris: 
 
         mail/thunderbird/plugin/thunderbird-lightning 

   4.11. Security Impact:
         None.

   4.12. Dependencies:
         Lightning 1.0 depends upon following packages:
         mail/thunderbird 
         library/nspr 
         database/sqlite-3 
 
5. Reference Documents:
   Lightning home page - http://wiki.mozilla.org/Lightning
   LSARC 2007/043  Lightning 0.3 ARC case
   LSARC 2008/085  Thunderbird 3.0 ARC case