From a01630d957e3d20f6ebe10b0aa13db8c7ac16b98 Mon Sep 17 00:00:00 2001
From: Michael M Slusarz <slusarz@curecanti.org>
Date: Tue, 4 Aug 2009 21:39:14 -0600
Subject: [PATCH] phpdoc

---
 imp/lib/IMP.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/imp/lib/IMP.php b/imp/lib/IMP.php
index 189d0a33f..aca7bc8b3 100644
--- a/imp/lib/IMP.php
+++ b/imp/lib/IMP.php
@@ -842,8 +842,6 @@ class IMP
     /**
      * Convert a preference value to/from the value stored in the preferences.
      *
-     * Preferences that need to call this function before storing/retrieving:
-     *   trash_folder, spam_folder, drafts_folder, sent_mail_folder
      * To allow folders from the personal namespace to be stored without this
      * prefix for portability, we strip the personal namespace. To tell apart
      * folders from the personal and any empty namespace, we prefix folders
@@ -1086,6 +1084,10 @@ class IMP
      */
     static public function threadSortAvailable($mbox)
     {
+        /* Thread sort is always available for IMAP servers, since
+         * Horde_Imap_Client_Socket has a built-in ORDEREDSUBJECT
+         * implementation. We will always prefer REFERENCES, but will fallback
+         * to ORDEREDSUBJECT if the server doesn't support THREAD sorting. */
         return ($_SESSION['imp']['protocol'] == 'imap') &&
                !$GLOBALS['imp_search']->isSearchMbox($mbox) &&
                (!$GLOBALS['prefs']->getValue('use_trash') ||
-- 
2.11.0