updated mercury settings in order to remove INBOX. prefix in 4.0 version.
[squirrelmail.git] / doc / presets.txt
index 6b6e7f054b24be83e092987cc4c6a80ebe966edb..9d2f1ac730a0aa18db0ef489ecf9fd27efea06ff 100644 (file)
@@ -1,24 +1,26 @@
 $Date$
 
-This file lists squirrelmail options set by D option in conf.pl
+This file lists SquirrelMail options set by D option in conf.pl
 
 It can be used if user can't run conf.pl and changes options manually.
 Settings can be different if IMAP server uses shared folders.
 
 Possible server values are:
- cyrus      = Cyrus IMAP server
- uw         = University of Washington's IMAP server
- exchange   = Microsoft Exchange IMAP server
- courier    = Courier IMAP server
- macosx     = Mac OS X Mailserver
- mercury32  = Mercury/32
+ cyrus       = Cyrus IMAP server
+ uw          = University of Washington's IMAP server
+ exchange    = Microsoft Exchange IMAP server
+ courier     = Courier IMAP server
+ macosx      = Mac OS X Mailserver
+ hmailserver = hMailServer
+ mercury32   = Mercury/32
+ dovecot     = Dovecot Secure IMAP server
 
 -----------------
 default settings:
 -----------------
 
               imap_server_type = other
-         default_folder_prefix =
+         default_folder_prefix = <none> (is set to empty string)
                   trash_folder = INBOX.Trash
                    sent_folder = INBOX.Sent
                   draft_folder = INBOX.Drafts
@@ -33,7 +35,7 @@ show_contain_subfolders_option = false
 'cyrus' settings:
 -----------------
               imap_server_type = cyrus
-         default_folder_prefix = <none> (is not set)
+         default_folder_prefix = <none> (is set to empty string)
                   trash_folder = INBOX.Trash
                    sent_folder = INBOX.Sent
                   draft_folder = INBOX.Drafts
@@ -63,7 +65,7 @@ show_contain_subfolders_option = true
 'exchange' settings:
 --------------------
               imap_server_type = exchange
-         default_folder_prefix = <none>  (is not set)
+         default_folder_prefix = <none> (is set to empty string)
                   trash_folder = INBOX/Deleted Items
                    sent_folder = INBOX/Sent Items
                   draft_folder = Drafts
@@ -104,18 +106,83 @@ show_contain_subfolders_option = false
                  delete_folder = true
       force_username_lowercase = false
 
--------------------
-'mercury' settings:
--------------------
-              imap_server_type = mercury32
-         default_folder_prefix = INBOX/
+-----------------------
+'hmailserver' settings:
+-----------------------
+              imap_server_type = hmailserver   (used in imap_search.php)
+         default_folder_prefix = <none> (is set to empty string)
                   trash_folder = INBOX.Trash
                    sent_folder = INBOX.Sent
                   draft_folder = INBOX.Drafts
             show_prefix_option = false
           default_sub_of_inbox = true
+show_contain_subfolders_option = false
+            optional_delimiter = detect
+                 delete_folder = false
+      force_username_lowercase = false
+
+---------------------
+'mercury32' settings:
+---------------------
+Preset is used for Mercury Mail Transport System. Available since 1.5.0
+Free email server for Win32 and Netware.
+Tested Win32 v.4.01b
+CAPABILITY IMAP4rev1 X-MERCURY
+PERMANENTFLAGS (\Deleted \Draft \Seen \Answered)
+
+Comments:
+* Server side sorting and threading are not supported.
+* Message flags are not supported.
+* IMAP folders can store messages _or_ other folders.
+* Supports STARTTLS, if configured.
+* May have issues with 8bit IMAP folder names.
+
+$imap_server_type variable is used to handle imap folder subscription
+differences.
+
+Site URL: http://www.pmail.com
+
+              imap_server_type = mercury32
+         default_folder_prefix = <none> (is set to empty string)
+                  trash_folder = Trash
+                   sent_folder = Sent
+                  draft_folder = Drafts
+            show_prefix_option = false
+          default_sub_of_inbox = true
 show_contain_subfolders_option = true
             optional_delimiter = detect
                  delete_folder = true
       force_username_lowercase = true
 
+-------------------
+'dovecot' settings:
+-------------------
+Preset used for Dovecot Secure IMAP server. Available since 1.5.1.
+
+There is no code specific to Dovecot IMAP server. Preset provides only a quick
+way to set correct folder settings.
+
+Tested v.0.99.14
+
+CAPABILITY IMAP4rev1 SORT THREAD=REFERENCES MULTIAPPEND UNSELECT LITERAL+ IDLE 
+  CHILDREN LISTEXT LIST-SUBSCRIBED NAMESPACE
+
+PERMANENTFLAGS (\Answered \Flagged \Deleted \Seen \Draft \*)
+
+IMAP server supports server side sorting and threading.
+
+Site URL: http://www.dovecot.org
+
+              imap_server_type = dovecot
+         default_folder_prefix = <none> (is set to empty string)
+                  trash_folder = Trash
+                   sent_folder = Sent
+                  draft_folder = Drafts
+            show_prefix_option = false
+          default_sub_of_inbox = false
+show_contain_subfolders_option = false
+            optional_delimiter = detect
+                 delete_folder = false
+      force_username_lowercase = true
+
+