Preparing for 1.4.0 release
[squirrelmail.git] / ReleaseNotes
index 8af516d009a1782de2a3c5c1788ad890962ef491..a6de2f0a10d666b7151eb71e1349bf7983647079 100644 (file)
@@ -1,91 +1,98 @@
 /*****************************************************************
- * SquirrelMail 1.2.0                                            *
- * The "And I Still Have Not Wrapped My Wife's Presents" Release *
- * December 25, 2001                                             *
+ * Release Notes: SquirrelMail 1.4.0                             *
+ * The "Long Time Coming" Release                                *
+ * 3 April 2003                                                  *
  *****************************************************************/
 
-The past year has been anything but uneventful for SquirrelMail. 
-This year has seen two leadership changes, the release of the 1.0
-series, the 1.1 development series, and finally the much awaited
-1.2.0 release.
-
-Being one of the most popular webmail clients, the developers of
-SquirrelMail feel a huge desire to continue pusing the envelope and
-making their product better and better.  You won't be disappointed
-with this release, as it is by far the most feature rich, and yet it
-is still the same sleak and unbloated app that we have all grown to
-love.  Here is an uncomplete list of new features since the last
-stable release.
-
-  * The Paginator! - This enables quick access to any page in the
-          message list by simply choosing the page number to view
-          rather than tediously clicking "next" 50 times.
-  * Hundreds of UI tweaks - The user interface has been given a
-          facelift. The HTML has been largely overhauled, and while
-          it still has the same general feel, it has been made more
-          intuative.
-  * Drafts - It is now possible to compose a message and save it to
-          be sent at a later date with the drafts option.
-  * Collapsable Folders - The folder list can be collapsed at any
-          parent folder. This makes folder lists with large
-          heirarchital structures much easier to manage and navigate.
-  * New Options Page - The options page has been completely
-          rewritten for several reasons, the main of which was to
-          allow seamless integration of plugin options and to
-          provide uniformity throughout the entire section.
-  * Multiple Identities - It is now possible to create different
-          identities (home, work, school) that can be chosen upon
-          sending.  Each identity can have its own email address,
-          full name, and signature.
-  * Reply Citations - Different types of citations are now possible
-          when replying to messages.
-  * Better Attachment Handling - The plugin, attachment_common, has
-          been fully integrated into the core of SquirrelMail.  This
-          allows inline viewing of several different types of
-          attachments.
-  * Integration of Several Plugins - The following plugins have been
-          put directly into the core.  As a result, be sure not to
-          install these as plugins, as the result may be
-          unpredictable: attachment_common, paginator,
-          printer_friendly, xmailer, sqclock, priority.
-  * Improved support for newer versions of PHP.  Note that you may
-          have trouble if you are running PHP version 4.0.100
-          (commonly distributed with Debian 3.0).
-  * Ablity to mark messages as read and unread from the message listing.
-  * Alternating Colors - The message list now alternates row colors
-          by default.  This presents a much cleaner and easier to
-          read interface to the user.
-
-Aside from these obvious front end features, there are hundreds of
-bugs that have been fixed, and much of the code has been optomized
-and/or rewritten.  This stable release is far superior in all
-aspects to all previous versions of SquirrelMail.
-
-   Home Page:    http://www.squirrelmail.org/
-   Download:     http://www.squirrelmail.org/download.php
-   ScreenShots:  http://www.squirrelmail.org/screenshots.php
-
-Where are we going from here? Good progress is already being made on
-the Great SquirrelMail Rewrite, also known as the 1.3 branch which
-will eventually be called 2.0. Paul has put a lot of effort into
-reorganizing the development team into different teams that have
-different roles. The purpose in doing this is to keep developers on
-track and have to provide some semblance of order.  This project has
-grown so large in the past two years that an orderly structure is
-necessary if anything is to get done.  The teams are as follows:
-
-   Stable Series Team:      Maintains the stable series
-   Development Series Team: Works on the development series
-   i18n Team:               Handles i18n work
-   Plugin Team:             Manages the mass of plugins
-   User Support Team:       Helps users with their problems
-   Documentation Team:      Manages the documentation
-   Evangelism Team:         Spreads the good news of SquirrelMail
-
-For the next few weeks, the developers will be working on bugfixing
-and making the 1.2 series rock solid.  After that, about mid
-January, they will start focusing solely on the rewrite.
-
-                  Have a Merry Christmas!
+In this edition of SquirrelMail Release Notes:
+   * All about this Release!
+   * A note on PHP 4.3.x
+   * Major updates
+   * A note on plugins
+   * Reporting my favorite SquirrelMail 1.4 bug
+
+All about this Release!
+=======================
+
+This is the first release of our new 1.4.x-series which is officially
+labeled STABLE! We've been through a long development trajectory
+which has resulted in this version. The big plusses of 1.4 over the
+previous 1.2.x series are enhanced stability, better compatibility
+with a wide range of mail/websystems, more features and less bugs.
+See the Major Updates section of this file for more.
+
+
+A note on PHP 4.3.x
+===================
+
+While the developers realize that PHP 4.3.x is the "latest and greatest"
+version of PHP to be available, SquirrelMail has not been extensively
+tested with it. We currently believe that SquirrelMail should work on
+PHP 4.3.x but we lack the experience with this new version to be
+absolutely sure. If you want to be safe, or experience problems, you may
+want to downgrade to PHP 4.2.x.
+
+
+Major updates
+==============
+
+The 1.4.0 series (as a result of 1.3 developent series) brings:
+
+* A complete rewrite of the way we send mail (Deliver-class),
+  and of the way we parse mail (MIME-bodystructure parsing).
+  This makes SquirrelMail more reliable and more efficient
+  at the same time!
+* Support for IMAP UID which makes SquirrelMail more reliable.
+* Optimizations to code and the number of IMAP calls; SquirrelMail
+  is now a very scalable webmail solution.
+* Support for a wider range of authentication mechanisms.
+* Lots of bugfixes, some new features and a couple of UI-tweaks.
+
+
+A note on plugins
+=================
+
+There have been major plugin architecture improvements. Lots of plugins
+have not yet been adapted to this. Plugins which are distributed with
+this release (eg. in the same .tar.gz file) should work. Plugin authors
+will need some time to adapt their plugins, so quite some plugins 
+might not work.
+
+So if you have ANY problem at all, first try turning off all plugins.
+If one plugin seems to be the culprit, contact the author to see if
+a 1.4.x version is underway.
+
+
+Reporting my favorite SquirrelMail 1.4 bug
+==========================================
+
+We constantly aim to make SquirrelMail even better. So we need you to
+submit any bug you come across! Also, please mention that the bug is
+in this 1.4.0 release, and list your IMAP server and webserver details.
+
+   http://www.squirrelmail.org/bugs
+
+Thanks for your cooperation with this. That helps us to make
+sure nothing slips through the cracks. Also, it would help if
+people would check existing tracker items for a bug before reporting
+it again. This would help to eliminate duplicate reports, and
+increase the time we can spend CODING by DECREASING the time we
+spend sorting through bug reports. And remember, check not only OPEN
+bug reports, but also closed ones as a bug that you report MAY have
+been fixed in CVS already.
+
+If you want to join us in coding SquirrelMail, or have other
+things to share with the developers, join the development mailinglist:
+
+   squirrelmail-devel@lists.sourceforge.net
+
+
+About Our Release Alias
+=======================
+
+This release is labeled the "Long Time Coming" Release.
+I think you can figure out the meaning behind this yourself.
+
+
                   Happy SquirrelMailing!
                     - The SquirrelMail Project Team