The Mailbox Selector This window appears in two distinct forms. The first is when you are selecting a mailbox to Open. The second form is used to select a mailbox to copy/move messages from an already open mailbox. Most of the functionality is the same, but there are a few minor differences. For each mode of operation, the "convenience buttons" located below the main menubar change, and in the copy/move mode, this window becomes "modal", i.e. it takes over the keyboard and mouse such that you will not be allowed to continue working in other windows until a mailbox has been selected (or until you apply "Cancel"). The window contains three text fields and a selection list. Configuration: Every mailbox belongs to a "configuration", which determines how to access it. This includes such things as the server name and type of communications protocol used for transactions. You may type in the name of a known configuration here, or use the corresponding button to cycle through the known entries. If you enter an unknwon configuration name, the Network Configuration Window will be invoked to fill in the necessary information. In the copy/move mode of operation, the configuration needs to be one that supports Mail. You cannot copy/move to a newsgroup. Search Pattern: A search pattern to apply to the list of mailboxes to filter the result. By default the selection mode is set to "Subscribed Mailboxes" and the initial pattern set to "*" (ALL entries). If you toggle the selection mode to "All Mailboxes", this pattern is automatically set to "%", which matches all entries in the default directory. It is important to note the difference. The "All Mailboxes" mode, when applied to a "mail" configuration, is a file selector on the mail server. The "*" pattern matches EVERY FILE KNOWN to that server, and may take hours or days to return, depending on the server filesystem. One connected to the Andrew File System will list every file on every machine connected to AFS. On a "news" server, every known newsgroup is returned. This isn't quite as bad as for a mail server, but will still take a lengthy time to process. When using this field, it is therefore important to prefix any wildcard patterns appropriately, expecially when using "All Mailboxes". For newsgroups, "comp.*" lists the entire contents of the "comp" hierarchy. "comp.%" matches only those entries one level down from "comp.", such as "comp.mail", but NOT "comp.mail.misc". When applied to mailboxes, "~/%" lists your home directory on the mail server. "~/mail/*" will list every file in your personal mail directory, including the contents of any subdirectories. "~/mail/%" will restrict the search to the "mail" directory alone, and no subdirectories will be processed. Pressing the associated button will reset the Search Pattern to the default for the current mode. Mailbox Name: This is the name of the mailbox target for the operation you intend to perform. Note that to copy/move to a mailbox, it must first exist. If you just type in a name here, you should also use "Create" from the Subscription menu to create it before selecting Open/Copy/Move etc., or the resulting operation will fail. The button associated with this field will sequentially select each item in the current list. The Mailbox List: This list is filled in when needed by opening a connection to the server in question. You may be asked for a password at that time. OR, you may not, depending on the server policy. INBOX, if it exists, and matches the requested pattern, will always be first in the list, unless your search pattern precludes it. The remaining items are sorted alphabetically. When the program starts up, it doesn't automatically fetch this list, because it may take some time to process on a slow network link. In the case where you know what mailbox name you wish to use, just type it in. Use the "Fetch" button to go out and get the list. When you perform a Subscription operation, the list will be fetched and updated accordingly. Folder Path and Mailbox Names: If you have defined a Mail Folder Path in your personal preferences, you may see mailboxes referred to as "+name". The "+" is shorthand for your folder path. It will be replaced by the program with your folder path whenever needed. You may also refer to files in your mail folder by naming them "+name". Files in other locations need the full path name (or path relative to your home directory on the server), using the server's directory separation character (which is usually "/" on Unix systems). Menu Items: Convenience Buttons: Open Open the named Mailbox, using the selected Configuration. Scan This button is used mostly for newsgroups. It will open the "selected" Mailbox (and implies a selection in the mailbox list has been made). It will also automatically advance the selection to the next mailbox in the list. The next time you select "Scan", the first mailbox will be closed before the next one is opened. When you reach the end of the list, this button will be disabled. You may alter the current selection before using this to jump to another mailbox. In copy/move mode the above buttons are replaced by: Copy Use the selected mailbox as the target to copy the selected messages to. You cannot copy messages to a newsgroup. Move Use the selcted mailbox as the target to move the selected messages to. This is the same as copy except that the messages are then marked DELETED in the original mailbox. Fetch This instructs the program to fetch the desired list from the mailbox server, using the supplied Search Pattern to filter the results. Dismiss/Cancel Close the Mailbox Selector Window. If you are performing a copy/move, the operation will be cancelled. The Subscribe Menu New Mailbox Create a new mailbox, using the name in the Mailbox Name field, and located on the server defined by the Configuration field. If this is a newsgroup, the selected name will be added to your subscription list and no mailbox created (you cannot create new newsgroups). Kill Mailbox This destroys the mailbox name selected in the Mailbox Name field from the server defined by the Configuration field. If this is a newsgroup, it will merely be unsubscribed. For a mailbox, the mailbox AND ITS CONTENTS will be removed. A dialog will allow you confirm this decision. Rename Mailbox Change the name of the selected mailbox. You cannot change the name of a newgroup. You will be prompted for the new name. Subscribe Only This will add the currently selected mailbox to your subscription list. It will not create it, and it is assumed the mailbox already exists. Unsubscribe Only This will remove the selected mailbox from your subscription list, but without destroying the contents. Create Mailbox Create a new mailbox using the name given in the Mailbox Name field, on the server defined by the Configuration field. You cannot create a newsgroup. This will NOT be added to your subcription list. The Option Menu Show All Mailboxes By default, the list contains only those mailboxes you have subscribed to. This will allow you to locate other existing mailboxes on the server which you may then subscribe to. Show Subscribed Mailboxes The default. Show only items to which you have previously subscribed.