1.3.0 release notes

ReleaseNotes

@@ -1,115 +1,104 @@
 /*****************************************************************
- * Release Notes: SquirrelMail 1.2.6                             *
- * The "Two Journeys" Release                                    *
- * 29 April    2002                                              *
+ * Release Notes: SquirrelMail 1.3.0                             *
+ * The "Pasta" Release                                           *
+ * 17 august 2002                                                *
  *****************************************************************/
 
 In this edition of SquirrelMail Release Notes:
    * All about this Release!!!
-   * Reporting my favorite SquirrelMail 1.2 bug
-   * Important Note about PHP 4.2.0
+   * Reporting my favorite SquirrelMail 1.3 bug
+   * Important Note about PHP 4.2.2
    * About our Release Aliases
 
 All about this Release!!!
 =========================
 
-Squirrelmail.
-It's feature set is that of a desktop client.
-It's ease of use is unheard of.
-It's ..ehem.. bug free.
-There is nowhere else to go...
-Except to the 1.2.6 stable version of Squirrelmail!!
-
-    We are excited to bring you the latest and greatest Squirrelmail release 
-to date. More features you say? You got it. Better performance is what
-you need? Expect it. Looking for a Sqirrelmail with less bugs? It is here.
-Here are some highlights:
-
-  * Greatly improved Cross Site Scripting Protection with a new custom
-    html filter.
-  * Improved search and filter functions, allowing for non-ascii search
-    and filter criteria.
-  * Server side sorting capability to improve performance with large 
-    mailboxes.
-  * Most importantly, Many, many bugfixes. And more bugfixes. did I mention 
-    bugfixes?
-
-See the Changelog file for details.
-
-   Being one of the most popular webmail clients, the developers of
-SquirrelMail feel a huge desire and responsibility to continue push
-the envelope and make SquirrelMail the best it can possibly be. You
-will not be disappointed with this release, as it is by far the most
-feature rich, and yet it is still the same sleek and unbloated and
-cuddly webmail application that we have all grown to love. Here is
-an incomplete list of some of the great features that Squirrelmail
-has to offer:
-
-  * Collapsible Folders - The folder list can be collapsed at any
-          parent folder. This makes folder lists with large
-          hierarchical structures much easier to manage and navigate.
-  * Fix for the "theme passed as cookie" exploit posted to the bug-
-          traq mailing list.
-  * 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
-          face-lift. The HTML has been largely overhauled, and while
-          it still has the same general feel, it has been made more
-          intuitive.
-  * Drafts - It is now possible to compose a message and save it to
-          be sent at a later date with the drafts option.
-  * Ability to mark messages as read and unread from the message listing.
-  * 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.
-  * Ability to forward messages as attachments from the message listing.
-  * 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 (at best)
-          unpredictable: attachment_common, paginator, priority,
-          printer_friendly, sqclock, xmailer.
-  * Improved support for newer versions of PHP. Recommended versions
-          are 4.0.3 -> 4.1.2. 
-  * Server-side sorting support adds speed to the mailbox display, even
-          with large mailboxes. Server-sid thread sorting support allows 
-          users to display mailboxes in thread-sort order.
-
-  
-I am sure there are plenty more features I have missed. You just have
-to try it for yourself!
-
-Having been involved with Squirrelmail for a while I can safely say
-that this stable release has the most bugfixes to date. The invaluable
-contributions of the Squirrelmail community, from developers and users
-alike have helped to make this release of Squirrelmail the best yet.
-
-   Home Page:    http://www.squirrelmail.org/
-   Download:     http://www.squirrelmail.org/download.php
-   ScreenShots:  http://www.squirrelmail.org/screenshots.php
-
-
-Reporting my favorite SquirrelMail 1.2 bug
-==========================================
+This is the first release on our way to a new stable series.
+On our way to, that is, this is a development release, which is not
+intended for production servers. We feel that releasing development
+versions will help us making the to-be stable release more stable, and
+restricting the ability to test no longer to people who use CVS.
+
+So download it! Install it, and try to break it! We are hungry for any
+bug report you send. If stumbling over a bug is a true non-option,
+this release is not for you. In that case, download the stable version
+and enjoy that one.
+
+In general, we are planning to regularly release a 1.3.x version until
+it is stable enough to call her 1.4 or 2.0. While I'm at it, one
+comment on version numbers. Our version numbers take the form of A.B.C
+ A increases with time, but only very seldomly.
+ B if it is even (0, 2, 4 etc), it is a stable release
+   if it is odd (1, 3, 5 etc), it is a development release
+ C indicates small changes.
+Which is to say our version numbering system is the same as that of
+the linux kernel. So 1.2.7 is a stable version, and 1.3.0 (this one)
+is a development release.
+
+We are excited to bring you the first fruits of a very good
+development series. Major rewrites of the back-end and the user
+interface have been happening since the 1.2 series. These rewrites
+have inspired me for the release alias (see down this document).
+
+
+A note on plugins
+=================
+
+There have been very severe 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) may work. Plugins not
+distributed with this plugin most probably WILL NOT WORK.
+
+So if you have ANY problem at all, first try turning off all plugins.
+
+
+A note on PHP 4.2.2
+===================
+
+There are certain issues with PHP 4.2.2 and session handling that have
+not yet been addresses in this release. So this release MAY NOT WORK
+when you use PHP 4.2.2. These issues will be addressed to in
+forthcoming 1.3.x releases.
+
+
+A note on your configuration
+============================
 
-Of course, in the words of Linus Torvalds, this release is officially
-certified to be Bug-Free (tm).
+For a whole bunch of reasons, it is MANDATORY that you run conf.pl
+(and then save your configuration) from the config/ directory before
+using this release.
 
-However, if for some reason some bugs manage to find their way to the
-surface, please report them at once (after all, they ARE uncertified
-bugs!!!) The PROPER place to report these bugs is the SquirrelMail Bug
-Tracker.
+If you have problems with UID support, please do these 2 things:
+
+1) For our comfort and the prosper of SquirrelMail:
+   send a bugreport with this information
+     * IMAP server type + version
+     * Whether you use server-side sorting
+     * Whether you use thread sorting
+     * The value of "sort" (as in conf.pl)
+   bugs can be submitted at: http://www.squirrelmail.org/bugs
+2) For your own pleasure and comfort:
+   turn of UID support in conf.pl, so you can continue to use 1.3.0
+
+
+A note on MIME
+==============
+
+In case you stumble over a message of which something goes wrong with
+MIME (it does not display some of its parts all right, etc. etc.),
+please forward the message AS AN ATTACHMENT to
+squirrelmail-devel@lists.sourceforge.net. However, AVOID
+forwarding emails over 20k of size. Please not as well that messages
+which are NOT forwarded AS AN ATTACHMENT are COMPLETEY USELESS for our
+testing purposes.
+
+
+Reporting my favorite SquirrelMail 1.3 bug
+==========================================
+
+It is not unlikely you will experience some bugs while using this
+development version. Please submit these bugs. Also, please mention
+that the bug is in this 1.3.0 release.
 
    http://www.squirrelmail.org/bugs
 
@@ -122,44 +111,33 @@ 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.
 
+In case you want to join us on coding SquirrelMail, or have other
+things to share with the developers, join the development mailinglist:
 
-Important Note about PHP 4.2.0
-==============================
-
-  A few days before this release, PHP 4.2.0 hit the net. The Squirrelmail
-team has not had a chance to test this new version of PHP with the 1.2.6
-release. The recommended versions of PHP for Squirrelmail 1.2.6 is 4.0.3
-through 4.1.2.
+   squirrelmail-devel@lists.sourceforge.net
 
 
-About our Release Aliases - By Jason Munro 
+About our Release Aliases - By Wouter Teepe
 =========================
 
-Squirrelmail has started on a new journey.
-Two journeys really. 
-  
-In one, our beloved hero delves deep inside its squirrel-self, 
-searching for calmness and peace with its surroundings. 
-Striving to hone its squirrel-skills against any and all obstacles.
-
-This is the stable path.
-
-In the other, our champion has shed the failures of its past and
-started anew on a wild adventure through uncharted territory. The
-dangers are great, but so are the rewards.
-
-This is the development path.
+Pasta is, as we all know, a group of Italian dishes. As most of us
+know, several types of pasta exist, two of which are:
 
+* Spaghetti: Tastes good, but is very hard to untangle. Its structure
+  is unneccecarily complex, but it is relatively easy to cook.
+* Lasagne: Tastes excellent, and its structure is very elegant: it is
+  layered. Cooking it takes quite a bit more patience and design.
 
-  Squirrelmail 1.2.6 is the latest stepping-stone on the stable
-path. It leads to a Squirrelmail of unseen dependablity and
-performance.
-  Squirrelmail 2.0 development has begun. This is the first step
-on the journey down the development path. New worlds of possiblity
-are opening up with each step.
+I will not bore you with Italian cooking more except for this: The
+difference between spaghetti and lasagne applies to SquirrelMail as
+well. Where 1.2 is good, its inside is unneccecarily complex. Opposed
+to this, 1.3 is quite well structured from the inside. Its potential
+is true excellence. Its flavor is already excellent. Expect 1.4/2.0 to
+be, well...
 
-Forget what you thought you knew about Squirrelmail, 
-and get ready for a whole new nut.
+With the slicing up the internals of SquirrelMail, whole new
+possibilities will emerge. Listen on the development mailinglist to
+hear which!
 
 
                   Happy SquirrelMailing!