Sophie

Sophie

distrib > Mageia > 5 > x86_64 > media > core-release > by-pkgid > 922623ff293c7934ad75d88b17778461 > files > 14

courier-imap-4.9.3-9.mga5.x86_64.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  <title>IMAP Client configuration</title>
  <meta name="MSSmartTagsPreventParsing" content="TRUE" />
</head>

<body text="#000000" bgcolor="#FFFFFF" link="#0000EE" vlink="#551A8B"
alink="#FF0000">
<!-- Copyright 1998 - 2003 Double Precision, Inc.  See COPYING for -->
<!-- distribution information. -->

<h1>IMAP client configuration</h1>

<p>Configuring IMAP clients can be tricky for any server. You have to know a
little bit about how the IMAP server works. Recommended Courier-IMAP
configuration for popular IMAP client software follows.</p>

<h2>Pine (version tested: 4.10)</h2>

<p>Older versions of Pine may require the <code>IMAP_OBSOLETE_CLIENT</code>
flag in the imapd configuration file. This setting disables the CHILDREN IMAP
extension, which breaks older versions of Pine. Current version of Pine do
not appear to have this problem.</p>

<p>To configure Pine to use Courier-IMAP for the main INBOX, go to Pine's
main menu, select S)etup, then C)onfigure. Go down to "inbox-path" setting,
set it as follows:</p>

<p><code>{<em>hostname</em>}INBOX</code></p>

<p>"<em>hostname</em>" is the name of the server that's running Courier-IMAP.
Exit and restart Pine.</p>

<h3>Folder configuration</h3>

<p>Pine can also create and use folders with Courier-IMAP, instead of
creating mailbox files in <code>$HOME/mail</code>. Go to Pine's main menu,
select S)etup, then choose collectionL)ist.</p>

<p>Choose A)ddcollection. Pick a name for this folder collection. Enter the
hostname of the Courier-IMAP server. For "Path", enter INBOX. Do not enter
anything for "View". Press ^X to save and exit.</p>

<p>Now, when you select a folder listing from Pine's main menu, instead of a
folder list, you will see two "folder collections" in a menu. The first one
will be "Mail - Local folders in mail/". Open that folder collection, and you
will see your familiar Pine folders (note, you may also see INBOX there,
that's a bit misleading because your INBOX really comes from Courier-IMAP,
it's just that Pine always sticks INBOX into the first folder collection).
The second menu entry will be your Courier-IMAP folders. If you open it,
you'll see just one folder - "Trash". This folder is not really used by Pine,
so it can be ignored. You can now create your Courier-IMAP folders by
pressing A.</p>

<h3>Shared folder access</h3>

<p>If your Maildir INBOX has been previously linked, by
<code>maildirmake</code>, with one or more sharable maildirs, you can access
shared folders by repeating the previous procedure, but entering "shared"
into the "Path" field, instead of "INBOX" (of course, you'll have to pick
another name for this shared folder collection).</p>

<p>Unfortunately, Pine lists *ALL* of your sharable folders by default. There
is, apparently, no individual subscribe/unsubscribe mechanism, by which you
get to choose which sharable folders you want to be listed.</p>

<p>For the FAQ: <i>In a shared folder, "expunge" does not remove some deleted
messages, why?</i>. ANSWER: You can only delete your own messages in a shared
folder (owners of sharable maildirs can delete anyone's messages, though).
You may be able to mark the message as deleted, but you won't be able to
actually remove it.</p>

<p>Also, when you delete your own messages, others will still see them until
you expunge.</p>

<h3>Creating folders</h3>

<p>The names of Courier-IMAP folders may not contain periods or slashes.
Periods are used as hierarchy delimiters - Courier-IMAP and Pine can create
folders within other folders.</p>

<p>Choose A)dd folder, then enter "Work.Important". Instead of a new folder
being created, Pine will display a new entry "Work.". This is a subdirectory
of folders. Move the cursor and press Enter, and Pine will open the contents
of "Work", which will contain an empty folder "Important". Choose A)dd
folder, and create a folder named "Not Important". You now have two folders
shown, "Important" and "Not Important". You can go back to the root folder
collection by pressing '&lt;'.</p>

<p>When saving messages to folders in Pine, you can manually type in the
complete folder name, "Work.Not Important", or press Ctrl-T, then navigate
your folder hierarchy.</p>

<p>You can only delete folders after you've deleted all messages from the
folder. If you display the folder collection listing, go to the "Work."
subdirectory and then delete both Important and Not Important folders, when
you return to the root folder collection, the Work. subdirectory will
automatically disappear. Subdirectories disappear automatically when all
folders in the subdirectory are deleted.</p>

<h3>Folders containing both messages and subfolders.</h3>

<p>It's possible to have both a folder named "Work", and a subdirectory named
"Work." that contains other folders, however Pine doesn't implement it very
well. You can go to the folder collections list, then add a folder named
"Work", then add a folder named "Work.Slacking Off".</p>

<p>Pine will display one entry: "Work[.]". Pressing the '&gt;' key will
display all subfolders in the Work subdirectory, and pressing Enter will open
the Work folder.</p>

<p>There will be a minor problem navigating the folder collection when you're
saving messages in Pine. When Pine prompts you for a folder to save a
message, you can bring up the folder collection list by pressing Ctrl-T,
however there is no way to select the Work folder from the menu. The '&gt;'
key will not work, and pressing Enter will always display all subfolders in
the Work subdirectory. To save the message in the Work folder you will have
to type in its name manually.</p>

<h3>Removing the local mail folder collection</h3>

<p>You may find it cumbersome to have two folder collections in Pine - the
default folder collection of mailbox files in <code>$HOME/mail</code> and the
Courier-IMAP folder collection.</p>

<p>From Pine's main menu, choose S)etup then collectionL)ist. You can simply
delete your local mail folder collections. Pine will now create its usual
"postponed-msgs" and "sent-mail" folders in Courier-IMAP, instead of creating
mailbox files in <code>$HOME/mail</code>.</p>

<p>Note - you will lose all your messages saved in local mail folders when
you do that, so make sure to back up any messages you want by copying them
into a Courier-IMAP folder. Also, even if you remove the local mail folder
collection, Pine will not remove <code>$HOME/mail</code>, and it will take up
space until you manually delete it.</p>

<p>NOTE - if you use SqWebmail, resist the urge to go into Pine setup and
rename "postponed-msgs" to "Drafts". SqWebmail will have a problem with Pine
creating and deleting the Drafts folder at will.</p>

<h2>Netscape Messenger (version tested: 4.7)</h2>

<p>Go to Edit|Preferences. Click on Mail &amp; Newsgroups, choose "Mail
Servers".</p>

<p>Enter the name of the Courier-IMAP server, for server type choose "IMAP",
and make sure to enter your login name.</p>

<p>Click on the "Advanced" tab, and UNCHECK the option "Show only subscribed
folders". Make sure that "server supports folders that contain subfolders and
messages" is checked.</p>

<p>Under "Personal Namespace", enter "<code>INBOX.</code>", and don't forget
the trailing period. Under "Public (shared)", enter "<code>shared.</code>".
You may not actually need to do this, if you use a recent version of
Messenger (I believe that Messenger 4.5 and later support the
<code>NAMESPACE</code> server extension which automatically configures these
values).</p>

<p>There are several known bugs in Netscape Messenger's IMAP client. See BUGS
for additional information.</p>

<p>For the FAQ: <em>Clicking on "Get new messages" results in an error
message "Error in IMAP command received by server", or nothing happens at all
when I know there are new messages in a shared folder. ANSWER: this is a
known bug in Messenger's IMAP client. Complain to Netscape. You can try
reinstalling Courier-IMAP with the
<code>--enable-workarounds-for-imap-client-bugs</code> option, to see if it
helps.</em></p>

<h2>Microsoft Outlook Express (version tested: 4.72)</h2>

<p>Open the "Tools" menu, choose "Accounts". This is done for you
automatically the first time you run Outlook Express. If you already use
Outlook Express, select this option manually.</p>

<p>Press the "Add" button, select "Mail".</p>

<p>Enter your personal information - name, E-mail address - when prompted.</p>

<p>Choose 'IMAP' server type, of course.</p>

<p>Specify the name of the server that's running Courier-IMAP, in the
"Incoming Mail Server" field.</p>

<p>Specify your usual SMTP server for outgoing mail.</p>

<p>On the next screen, enter your Courier-IMAP logon name and password.</p>

<p>Finish the rest of the set up by giving a name to this mail account.
Specify your appropriate connection settings.</p>

<p>You will receive the following prompt:</p>

<blockquote>
  <p><strong>Would you like to download folder list for the IMAP account
  you've just created?</strong></p>
</blockquote>

<p>Click on "NO".</p>

<p>You will be returned to the "Internet Accounts" dialog. If you are not
returned to this screen, choose "Accounts" from the "Tools" menu account.</p>

<p>There will be an entry there for the new IMAP server account that you just
entered. Click on it, then choose "Properties". Click on "Advanced".</p>

<p>If you don't need to access any shared folders, enter "INBOX" (without the
quotes) in the "Root folder path" field, and make sure that "Only show
subscribed folders" is NOT checked.</p>

<p>If you need to access shared folders, leave the "Root folder path" field
blank. If you don't have a lot of shared folders, then leaving "Only show
subscribed folders" also unchecked would probably be easier. Otherwise, after
you download your folder list "see below", shared folders will not
immediately show up. You will have to right-click on the folder list and
select "Subscribe to all folders". Then, after all shared folders are
downloaded and shown, you can right-click and select "unsubscribe" in order
to remove any folders that you are not interested in.</p>

<p>Save your changes, and go back to the main Outlook Express window. You
will see a new entry in the left navigation tab for the new IMAP server
you've just entered.</p>

<p>Click on the new entry. You will be asked again whether or not you would
like to download the folder list. This time, answer "Yes".</p>

<p>If you did not configure access to shared folders, all your folders on the
Courier-IMAP server will be shown as a single hierarchy. If you enabled
access to shared folders, there will be two separate folder hierarchies
shown: "INBOX" - your private folders, and "shared" - all your shared
folders.</p>

<p>When shared folder access is enabled, you can only create or delete
folders by making them subfolders of INBOX. That's your private personal
folder space. You cannot create any "shared" subfolders, because that has to
be configured on the server side, either by you logging into your shell
account, or by the system administrator.</p>

<p></p>
<hr />

<p>Pine is a trademark of the University Of Washington</p>

<p>Netscape Communicator is a trademark of the Netscape Communications
Corporation</p>

<p>Outlook Express is a trademark of the Microsoft Corporation</p>
<hr />

<p></p>
</body>
</html>