Change log for Reed's custom Thunderbird distribution
Software version 1.5.0.2
Sam Tucker
Computer User Services
25 April 2006

Changes from version 1.5:
 * All default changes to mailnews.js introduced in 1.5.0.2 have been retained.
 * Display Quota has been updated to version 0.1.10. Its installation procedure
   has been changed slightly.

To customize Thunderbird, three major changes must be made:
 (1) The file defaults/pref/mailnews.js must be hacked in a number of places to
     provide customized preferences.
 (2) The file imap.rdf must be added to defaults/isp/ to actually provide the
     account settings for a Reed IMAP account.
 (3) As of version 1.5, we're including the Display Quota extension installed
     by default in our distribution. This can be accomplished by the copying of
     files into the extensions/ directory in Thunderbird.

===== (1) MAILNEWS.JS PREFERENCES FILE =====

Make the following edits to the file defaults/pref/mailnews.js:

Line 88:
 * pref("mail.check_all_imap_folders_for_new", false); // REED: change to true
This preference checks all the folders, incl. "spam", for new, as opposed to
just the Inbox. (N.B. This pref got moved in 1.5 to way at the top of the file;
in previous versions it was further down. It's still the same pref, though.)
(from version 0.7)

Line 103:
 * pref("mail.imap.cleanup_inbox_on_exit", false); // REED: change to true
Expunges deleted mail on program exit.
(from version 1.0.2)

Line 116:
 * pref("mail.check_time", 10); // REED: change to 1
Checks for mail every minute rather than every 10, like Blitz.
(from version 0.7)

Line 262:
 * pref("ldap_2.autoComplete.useDirectory", false); // REED: change to true
Requires Thunderbird to look through the LDAP directory while attempting to
auto-complete names or addresses.
(from version 1.0.2)

Line 265:
 * pref("ldap_2.autoComplete.directoryServer", ""); // REED: change the null
   string to "ldap_2.servers.ldapreededu"
This directs Thunderbird to look through Reed's LDAP server, as defined in the
additional section below.
(from version 1.0.2)

Line 277: insert the following section
 * // BEGIN ADDED SECTION PERTAINING TO REED LDAP SERVER
 * pref("ldap_2.servers.ldapreededu.description","Reed Directory");
 * pref("ldap_2.servers.ldapreededu.position",3);
 * pref("ldap_2.servers.ldapreededu.uri","ldap://ldap.reed.edu:389/ou=people,dc=reed,dc=edu??sub");
 * pref("mail.autoComplete.commentColumn",2);
 * pref("ldap_2.servers.ldapreededu.autoComplete.commentFormat","[ou]");
 * pref("ldap_2.servers.ldapreededu.auth.savePassword", true);
 * pref("ldap_2.servers.ldapreededu.filename", "ldapreededu.mab");
 * pref("ldap_2.servers.default.filename", "default.mab");
 * pref("ldap_2.servers.default.replication.lastChangeNumber", 0);
 * pref("ldap_2.servers.default.uri", "moz-abldapdirectory://default.mab");
 * pref("ldap_2.servers.history.filename", "history.mab");
 * pref("ldap_2.servers.pab.filename", "abook.mab");
 * pref("ldap_2.servers.pab.replication.lastChangeNumber", 0);
 * // END ADDED SECTION PERTAINING TO REED LDAP SERVER
(from version 1.0.2)

Line 354 (post-addition of additional LDAP section):
 * pref("ldap_2.prefs_migrated", false); // REED: change to true
Migrates LDAP prefs to Thunderbird 1.5. Necessary to enable LDAP lookup and
auto-completion.
(from version 1.5)

Line 409 (post-addition of additional LDAP section):
 * pref("mail.collect_email_addresses_outgoing", true); // REED: change to false
Disables automatic collection of outgoing e-mail addresses in the Address Book.
(from version 1.0.2)

Line 421 (post-addition of additional LDAP section):
 * pref("mail.server.default.check_time", 10); // REED: change to 10
Checks for mail every 1 minute. Same as above, but a catch-all, since the
effectiveness of the previous setting is unclear.
(from version 1.0.2)

Line 468 (post-addition of additional LDAP section):
 * pref("mail.server.default.spamLevel", 100); // REED: change to 0
A setting of 0 disables Thunderbird's own spam filtering, which is unnecessary
since we have server-side spam filtering.
(from version 0.7)

Line 523 (post-addition of additional LDAP section):
 * pref("mail.forward_message_mode", 0); // REED: change to 1
By default, Thunderbird forwards messages as attachments, rather than as quoted
inline in the body of the e-mail. A setting of 1 is the proper setting to make
it forward inline. Although the config file claims 2 is the proper setting, at
last check (N.B. this is still true as of 1.5) only 1 actually worked properly.
(from version 0.7)

===== (2) IMAP CONFIGURATION FILE =====

Add the following file, imap.rdf, to /defaults/isp/ (of course, not with the begin/end notes):
N.B. This file is the same as in previous incarnations of Reed's custom Thunderbird hack, except in 1.5 you need to declare a number of strings as variables and then refer to them that way later in the document. I also took the liberty of correcting the typo "setup" to "set up" in the 1.0.6 intermediate version, which has been kept around here.

*** BEGIN FILE ***

<?xml version="1.0"?>

<!DOCTYPE RDF
 [
  <!ENTITY reed.accountName       "Reed IMAP">
  <!ENTITY reed.wizardShortName   "Reed IMAP">
  <!ENTITY reed.wizardLongName    "Reed users: Choose this to set up your Reed IMAP account">
 ]
>

<RDF:RDF
    xmlns:NC="http://home.netscape.com/NC-rdf#"
    xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#">

  <RDF:Description about="NC:ispinfo">
    <NC:providers>
      <NC:nsIMsgAccount about="domain:reed.edu">

        <!-- server info -->
        <NC:incomingServer>
          <NC:nsIMsgIncomingServer>
            <NC:hostName>imap.reed.edu</NC:hostName>
            <NC:type>imap</NC:type>
	    <NC:ServerType-imap></NC:ServerType-imap>
	    <NC:isAuthenticated>true</NC:isAuthenticated>
            <NC:rememberPassword>true</NC:rememberPassword>
            <NC:isSecure>true</NC:isSecure>
	    <NC:loginAtStartup>true</NC:loginAtStartup>
	    <NC:downloadMessagesAtStartup>true</NC:downloadMessagesAtStartup>
	    <NC:checkTime>1</NC:checkTime>
          </NC:nsIMsgIncomingServer>
        </NC:incomingServer>

        <!-- identity defaults -->
        <NC:identity>
          <NC:nsIMsgIdentity>
            <NC:composeHtml>false</NC:composeHtml> 
	    <NC:replyOnTop>1</NC:replyOnTop>
          </NC:nsIMsgIdentity>
        </NC:identity>

        <NC:smtp>
          <NC:nsISmtpServer>
            <NC:hostname>smtp.reed.edu</NC:hostname>
	    <NC:port>587</NC:port>
	    <NC:trySSL>1</NC:trySSL>
	    <NC:trySecAuth>true</NC:trySecAuth>
	    <NC:authMethod>1</NC:authMethod>
          </NC:nsISmtpServer>
        </NC:smtp>
        
	
        <!-- other options... see http://www.mozilla.org/mailnews/?? -->

        <NC:smtpRequiresUsername>true</NC:smtpRequiresUsername>
        <NC:smtpCreateNewServer>true</NC:smtpCreateNewServer>

        <NC:wizardSkipPanels>true</NC:wizardSkipPanels>
        <NC:wizardShortName>&reed.wizardShortName;</NC:wizardShortName>
        <NC:wizardLongName>&reed.wizardLongName;</NC:wizardLongName>
        <NC:wizardShow>true</NC:wizardShow>
        <NC:wizardPromote>true</NC:wizardPromote>
        <NC:emailProviderName>Reed</NC:emailProviderName>
        <NC:sampleEmail>smithj@reed.edu</NC:sampleEmail>
        <NC:sampleUserName>smithj</NC:sampleUserName>
        <NC:emailIDDescription>network username</NC:emailIDDescription>
        <NC:emailIDFieldTitle>Network Username:</NC:emailIDFieldTitle>
        <NC:showServerDetailsOnWizardSummary>true</NC:showServerDetailsOnWizardSummary>
        <NC:createNewAccount>true</NC:createNewAccount>
      </NC:nsIMsgAccount>
    </NC:providers>
  </RDF:Description>

 </RDF:RDF>
 
*** END OF FILE ***

===== (3) DISPLAY QUOTA EXTENSION =====

To install the Display Quota extension, follow these easy steps. These steps
are written for Mac OS X but easily adapted to Linux (and, one hopes, Windows).

 (1) Grab the Display Quota archive (.xpi) file from https://addons.mozilla.org/extensions/moreinfo.php?application=thunderbird&id=881
 (2) Install into some user's Thunderbird, preferably one with not too many
     extensions. You can do this by downloading a fresh copy of Thunderbird
     onto a new user's desktop, running it, and installing the .xpi file with
     XPInstaller (i.e. by going to Tools: Extensions and installing it from
     there).
 (3) Open up your terminal and execute the following commands (no comments,
     of course):
    $ cd ~/Desktop/Thunderbird.app/Contents/MacOS/extensions
    $ ls     # this will tell you what directory name the extension has,
             # e.g. {c1ac4523-76c2-9995-adbd-d93bf5141bea}
    $ ls \{c1ac4523-76c2-9995-adbd-d93bf5141bea\}
             # this will verify that is is the proper one. you should see:
             # chrome    chrome.manifest    defaults    install.rdf
    $ tar cf archive.tar \{c1ac4523-76c2-9995-adbd-d93bf5141bea\}
             # this will make an archive of the expanded directory.
    $ cp archive.tar <abcdef>/Contents/MacOS/extensions
             # where <abcdef> is the path to the Tbird app you're modifying
    $ cd <abcdef>/Contents/MacOS/extensions
    $ tar xf archive.tar
    $ rm archive.tar
 (4) For Windows, copy the .tar archive you produced on your Mac into the same
     path and untar it (you'll have to use WinZip or something like that if you
     haven't got Cygwin).
 (5) Enjoy being able to see your quota.

END OF FILE