diff --git a/extensions/help/resources/locale/en-US/mail_help.xhtml b/extensions/help/resources/locale/en-US/mail_help.xhtml index 33d17022af2..e69de29bb2d 100644 --- a/extensions/help/resources/locale/en-US/mail_help.xhtml +++ b/extensions/help/resources/locale/en-US/mail_help.xhtml @@ -1,4938 +0,0 @@ - - - - %brandDTD; -]> - - - -Using &brandShortName; Mail & Newsgroups - - - - -
This document is provided for your information only. - It may help you take certain steps to protect the privacy and security of - your personal information on the Internet. This document does not, however, - address all online privacy and security issues, nor does it represent a - recommendation about what constitutes adequate privacy and security - protection on the Internet.
- -

Using &brandShortName; Mail & - Newsgroups

- -

&brandShortName; Mail & Newsgroups lets you conveniently manage all your - Internet communications from one place. You can set up and maintain multiple - business and personal mail accounts and Internet newsgroups, all from one - window — the Mail & Newsgroups window.

- -

To start using &brandShortName; Mail & Newsgroups:

- - - - - - - - - - - -
Mail & Newsgroups icon
- -
In this section: - -
- -

Getting Started with - &brandShortName; Mail & Newsgroups

- -
In this section: - -
- -

Using the Mail Account Setup - Wizard

- -

To set up a mail or newsgroup account, first open the Window menu and choose - Mail & Newsgroups. If you haven't already set up an account, the - Account Wizard appears automatically, enabling you to set up an account.

- -

The Account Wizard guides you through the process of creating a new account. - If you don't know a setting, click Cancel and ask your Internet service - provider (ISP) or help desk.

- -

If an account already exists, the Account Wizard doesn't appear - automatically when the Mail window opens. Instead, after opening the Mail - window, open the File menu and choose New, then Account. For more details, - see Setting Up - Additional Mail & News Accounts.

- -

Setting Up Mail - Accounts with an ISP or Email Provider

- -

Before you set up a mail account, your ISP or email provider should give you - the following information:

- - - -

Before you set up a newsgroup account, your ISP or email provider should - give you the following information:

- - - -

To set up a new mail or newsgroup account, begin from the Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Click Add Account to start the Account Wizard. - -

    The information requested by the Account Wizard depends on the type of - new account you specify in its first window. The boldface headings that - follow correspond to the windows you'll see when you're setting - up an ISP or email provider account.

    -
  4. -
  5. New Account Setup: Choose the type of account you want - to set up, then click the right arrow.
  6. -
  7. Identity: Enter the name and email address appropriate - for this account, then click the right arrow.
  8. -
  9. Server Information: - -
  10. -
  11. User Names: Enter the incoming and outgoing user names - provided by your ISP or email provider, then click the right arrow.
  12. -
  13. Account Name: Enter whatever name you want to use to - refer to this account, then click the right arrow.
  14. -
  15. Congratulations! Verify that the information you entered - is correct. If necessary, verify the information you entered with your ISP - or system administrator. When you are sure that it's correct, click - Finish to set up your account.
  16. -
  17. You see your new account listed in the left side of the Mail & - Newsgroups Account Settings dialog box. Click OK to start using your new - account.
  18. -
- -

You are now ready to get messages from your account. &brandShortName; Mail - & Newsgroups will prompt you for your password when you retrieve mail for - the first time every session. For detailed instructions on how to retrieve - mail, see Getting New Messages.

- -

[Return to - beginning of section]

- -

Setting Up Additional - Mail and News Accounts

- -

You use the Account Settings dialog box to add a new account or to change - information for an existing account, including:

- - - -

To add a new account or change settings for an existing account, begin from - the Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box. You can perform - these tasks: - -
  2. -
  3. Click headings under any account's name and modify the corresponding - settings in the panel on the right.
  4. -
  5. Click OK to save your changes.
  6. -
- -

[Return to - beginning of section]

- -

Changing the Settings for an - Account

- -

To view or change information for an existing mail or newsgroup account, - begin from the Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Click the account name in the left-hand side of the Account Settings - dialog box. You see information about the account, such as your email - address and signature file, in the right side of the dialog box.
  4. -
  5. Click any of these items beneath the name of an account to see the - corresponding settings: - -
  6. -
  7. Click OK to save your changes.
  8. -
- -

[Return to - beginning of section]

- -

Reading Messages

- -
In this section: - -
- -

Getting New Messages

- -

For an IMAP account, you can retrieve new messages automatically and display - them in the Inbox by opening Mail & Newsgroups and selecting the Inbox - for the IMAP account.

- -

For a POP account, you must select the Inbox and click Get Msgs to retrieve - your messages. By default, messages from your POP account are downloaded in - full and deleted from the POP server when you retrieve them. You can - change your POP server settings to - retrieve just the headers and/or store a copy of messages on the server in - addition to downloading them to your computer.

- -

You can also set up Mail & Newsgroups to get new messages at startup and - to check for new messages at timed intervals.

- - - - - - - - - -
Mail & Newsgroups icon
- -

The Mail & Newsgroups icon on the status bar displays a green arrow to - notify you when new messages have arrived.

- - - - - - - - - -
New mail notification
- -

To set up a mail account to automatically check for new messages, begin from - the Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. If you have multiple accounts, select an account and click the Server - Settings category for that account.
  4. -
  5. Select one or both of the following options in the Server Settings - section: - -
  6. -
  7. Click OK. Your settings take effect the next time you start - &brandShortName; Mail & Newsgroups.
  8. -
- -

To set up &brandShortName; Mail & Newsgroups to play a sound or display - an alert when new mail arrives, see Mail & - Newsgroups Preferences - Notifications.

- -

You can always retrieve messages manually at any time. To get new messages - for the selected account or newsgroup, do one of the following:

- - - -

To get new messages for all your mail accounts, begin from the Mail - window:

- -
    -
  1. Click the triangle on the Get Msgs button in the Mail toolbar.
  2. -
  3. Choose Get All New Messages. &brandShortName; Mail & Newsgroups - retrieves new messages for all your mail accounts. - -

    If you are not currently logged into one of your mail accounts, Mail - & Newsgroups first prompts you to enter your user name and password - before retrieving new messages for that account. (If you have already - stored your user name and password using the Password Manager, Mail & - Newsgroups doesn't prompt you for this information.)

    -
  4. -
- -

Note: You can also open the File menu (in the Mail window) - and choose Get New Messages for.

- -

To get new messages for a specific mail account, begin from the Mail - window:

- -
    -
  1. Click the triangle on the Get Msgs button on the Mail toolbar.
  2. -
  3. Choose the account for which you want to retrieve mail.
  4. -
- -

Note: Mail & Newsgroups prompts you for your password - the first time you retrieve messages for an account. You can choose to have - Mail & Newsgroups store your password in the Password Manager at that - time.

- -

Password Manager can save all your user names and passwords on your own - computer and enter them for you automatically. For more information, see - Using the Password - Manager.

- -

[Return to beginning of section]

- -

Choosing How You View the Mail - Window

- -

You can customize the layout of the Mail window (the window you see when you - choose Mail & Newsgroups from the Window menu):

- - - -

[Return to beginning of section]

- -

Sorting and Threading Messages

- -

To sort messages by categories such as subject, sender, date, or priority, - begin from the Mail window:

- - - -

To reorder column headings, begin from the Mail window:

- - - -

To change which columns are displayed, begin from the Mail window:

- - - -

To group messages by threading (subject), so each message is grouped with - all its responses:

- - - - - - - - - - - -
Thread button
- -

Tip: The thread button automatically sorts the threads by - the age of their parent messages. If you want to use another sort criterion - for the threads, open the View menu and select the desired option from the - Sort by submenu.

- -

Tip: Select Preserve threading when sorting messages - in the Mail & Newsgroups Preferences - if you want &brandShortName; to preserve the threaded message grouping when - sorting messages with column header clicks. The thread button just toggles - between threaded and unthreaded message grouping in this mode. If Preserve - threading when sorting messages is not selected, &brandShortName; - automatically displays the messages unthreaded when you sort them by clicking - on a column header.

- -

Tip: To help you identify unread messages in a collapsed - thread where you've read the parent message, &brandShortName; Mail & - Newsgroups underlines the parent message.

- -

[Return to beginning of section]

- -

Saving and Printing Messages

- -

To save a mail message as a plain-text, HTML, or Outlook Express file:

- -
    -
  1. In the Mail window, select the message.
  2. -
  3. Open the File menu and choose Save As, and then choose File.
  4. -
  5. For Save as type, choose a file type (HTML, Text, or Mail file). - Choose Mail file if you want to save the message so it can be opened by - Microsoft Outlook or Outlook Express.
  6. -
  7. Change the filename's extension to end in .html, .txt, or .eml, - depending on the file type you chose in step 3.
  8. -
  9. Choose a destination for the file and click Save.
  10. -
- -

To print a selected message:

- - - -

[Return to beginning of section]

- -

Controlling Images, Scripts, - and Plug-ins

- -

By default, images and other content, that is hosted remotely, will not - display in messages you receive, except from senders in your Personal - Address Book. To change these settings:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, click Message Display. (If - no subcategories are visible, double-click Mail & Newsgroups to - expand the list.)
  4. -
  5. In the General section, do one of the following: - -
  6. -
  7. Click OK to have your change take affect.
  8. -
- -

By default, JavaScript and plug-ins are not enabled for mail messages you - receive. To change these settings:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Advanced category, click Scripts & Plug-ins. (If no - subcategories are visible, double-click Advanced to expand the - list.) - -
  4. -
  5. Click OK to have your changes take affect.
  6. -
- -

[Return to beginning of section]

- -

Sending Messages

- -
In this section: - -
- -

Composing Mail and Newsgroup - Messages

- -

You can address, compose, reply to, or send a new message by doing one of - the following:

- - - -

Tip: Use the Mail & Newsgroups Account Settings - - Composition & Addressing dialog box to specify - the HTML text editor to use for composing messages sent from this account. - (You can specify a different editor for each of your accounts.) See - Changing the Settings for an - Account for more information.

- -

Composing messages in HTML format allows you to use different fonts, text - styles (such as bold or italic) and text colors, tables, numbered or bulleted - lists, and pictures in your messages. However, some recipients may only be - able to read messages composed in plain text format. If you want to use the - plain-text editor occasionally, you can hold down the Shift key while - clicking the Compose or the Reply button to use the plain-text editor on an - as-needed basis.

- -

[Return to beginning of section]

- -

Using the Message Composition - Window

- -

Use the Compose window to address, compose, and send mail and newsgroup - messages. First specify whether you want to compose messages in plain text or - HTML by default in the Composition & Addressing - Preferences panel (open the Edit menu and choose Mail & Newsgroups - Account Settings).

- -

To view the Compose window, click the Compose button on the Mail - toolbar.

- -

The Compose window contains the following:

- - - -

If you've chosen to compose messages using the HTML editor, you see an - additional toolbar with text formatting buttons similar to those in - &brandShortName; Composer.

- -

For help using the HTML editor, see - Formatting Your Web - Pages.

- -

[Return to beginning of section]

- -

Addressing a Message

- -

To address a mail message:

- -
    -
  1. Type the name in the addressing area. - -

    If you have address autocompletion - enabled (it's enabled by default), type the first few letters of - the recipient's name and wait for Mail & Newsgroups to complete - the address. (Or you can type part of the name and immediately press - ReturnEnter to have Mail - & Newsgroups try to complete the address.)

    -
  2. -
  3. If multiple addresses are displayed, select an address and press - ReturnEnter. - -

    Note: Use a comma to separate multiple addresses on the - same line. Do not use a comma to separate first or last names. For - example, multiple entries might be:

    - -

    user1@netscape.net,user2@netscape.net

    -
  4. -
  5. If you want this message to be sent from a different account, click the - From field to select the account you want. See - Changing the - Account From Which a Message is Sent for more information.
  6. -
  7. If necessary, click To to choose a different recipient type: - -
  8. -
- -

Tip: You can quickly address a message by clicking the - email address contained in a message you're reading, and then selecting - Compose Mail To from the pop-up menu.

- -

Changing the - Account From Which a Message is Sent

- -

If you have multiple mail accounts, the account listed in the From field is - based on the account (or server) you selected when you choose to create a new - message. However, &brandShortName; Mail & Newsgroups also allows you to - change the account a message is sent from while you're composing a - message. Click the From field to view a list of your accounts and then select - the account you want. A copy of the message is saved in the Sent folder of - the account where you sent the message from.

- -

About Address Autocompletion

- -

Address autocompletion allows you to address mail easily from the Compose - window without having to search for names or type complete names. Mail & - Newsgroups automatically checks your address books and an - LDAP directory server (if available) and - completes the name if it finds a unique match. It also prevents mistakes by - showing all possible choices with additional information if it finds multiple - matches. Address autocompletion is enabled by default.

- -

If you don't want to use an address that Mail & Newsgroups - provides, press Backspace or Delete to remove characters and then enter an - alternate address.

- -

To disable address autocompletion:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, click Addressing. (If no - subcategories are visible, double-click Mail & Newsgroups to expand - the list).
  4. -
  5. In the Address Autocompletion section, deselect Local Address - Books and Directory Server.
  6. -
  7. Click OK.
  8. -
- -

[Return to beginning of section]

- -

Selecting Message Sending - Options

- -

While you're composing a message, you can select these additional - message sending options from the Options menu:

- - - -

[Return to beginning of section]

- -

Replying to a Message

- -

To reply to a mail message:

- - - -

To include the original message each time you reply to any message, and to - specify how to place the original message in the reply:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. - You see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. If you have multiple accounts, select an account and click the - Composition & Addressing category for that - account.
  4. -
  5. Select Automatically quote the original message when - replying.
  6. -
  7. Specify where in the message to place your reply. Start my reply below - the quote is the default.
  8. -
  9. If you have decided to attach a signature - to every outgoing message and selected to start your reply above the quote - here, you can additionally configure where your signature is placed: - -
  10. -
  11. Click OK.
  12. -
- -

[Return to beginning of section]

- -

Forwarding a Message

- -

When you forward a message, you can specify how to place new text relative - to the original text: inline (in the body of the message; this is - the default), or as an attachment.

- -

To forward a message:

- -
    -
  1. Select the message and click Forward.
  2. -
  3. Type the name or email address of the recipient.
  4. -
  5. Click Send.
  6. -
- -

To set the default for forwarding messages:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, click - Composition. (If no subcategories are visible, - double-click Mail & Newsgroups to expand the list.)
  4. -
  5. For forwarding messages, choose Inline (in the message body) or As - Attachment.
  6. -
  7. Click OK.
  8. -
- -

Tip: To override the default for forwarding a message, - select the message, open the Message menu, and choose Forward As, then - choose Inline or Attachment.

- -

[Return to beginning of section]

- -

Confirming That Your Message - Was Opened

- -

You can use return receipts to notify you when a recipient has displayed - (opened) your message. The recipient must be using a mail program that - supports the Message Disposition Notification (MDN) standard. Keep in mind - that the recipient may choose not to send you a return receipt, even if - you've requested one. Messages you send to a newsgroup address will not - include a return receipt request, since news servers don't support this - feature.

- -

To request return receipts for all messages you send, you can use the global - Return Receipt preferences to - specify how to manage requests you receive for return receipts. You can - override these global preferences for individual accounts.

- -

To request a return receipt on a per-message basis:

- - - -

To automatically request return receipts when sending messages from each of - your mail accounts:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, click - Return Receipts. (If no - subcategories are visible, double-click Mail & Newsgroups to expand the - list.)
  4. -
  5. Select When sending messages, always request a return receipt.
  6. -
  7. Click OK.
  8. -
- -

For more information on setting return receipt preferences, see - Mail & Newsgroups Preferences - - Return Receipts.

- -

[Return to beginning of section]

- -

Saving and Editing a Message - Draft

- -

To save a mail message as a draft so you can complete it later:

- - - -

To edit or send a message draft, begin from the Mail window:

- -
    -
  1. Click the Drafts folder for the account where you created the message - draft.
  2. -
  3. Click the message that you want to edit.
  4. -
  5. In the top-right corner of the message, click the Edit Draft - button.
  6. -
  7. Edit the message as necessary.
  8. -
  9. Click Send to send the message or click Save to save the message so you - can complete it later. - -

    Note: Sending the message removes it from the Drafts - folder.

    -
  10. -
- -

Tip: You can also double-click the message to open it for - editing. This is especially useful if the message pane is closed.

- -

To delete one or more unwanted message drafts, begin from the Mail - window:

- -
    -
  1. Click the Drafts folder for the account where you created the message - drafts.
  2. -
  3. Select the message drafts that you want to delete.
  4. -
  5. Click Delete in the Mail toolbar.
  6. -
- -

[Return to beginning of section]

- -

Creating and Using Templates

- -

Templates are useful for setting the default format for messages that you - send regularly, such as weekly status reports. You can save a message as a - template from any window in which it is displayed, including from within a - Mail compose window.

- -

To save a message to use as a template:

- -
    -
  1. In the Mail window, click Compose to create a new message and then set - the default font, text size, text color, background color, and any other - default formatting you want. - -

    Alternatively, open an existing message that already has the formatting - you want.

    -
  2. -
  3. While displaying the message, open the File menu, choose Save As, then - choose Template. The message is stored as a template in the Templates - folder for the current mail account.
  4. -
- -

To compose a message using a template:

- -
    -
  1. In the Mail window, select the Templates folder for the account where you - created the message template.
  2. -
  3. Double-click the message template to open it.
  4. -
  5. Edit the message, then save it (to put it in the Drafts folder) or send - it. - -

    Note: Sending the message does not remove the template - from the Templates folder. The template is preserved for future use.

    -
  6. -
- -

To delete one or more unwanted message templates, begin from the Mail - window:

- -
    -
  1. Click the Templates folder for the account where you created the message - templates.
  2. -
  3. Select the message templates that you want to delete.
  4. -
  5. Click Delete in the Mail toolbar.
  6. -
- -

[Return to beginning of section]

- -

Creating HTML Mail Messages

- -
In this section: - -
- -

Using HTML in Your Messages

- -

HTML messages can include formatted text, links, images, and - tables—just like a web page. However, some recipients may not be able - to receive HTML messages. &brandShortName; Mail & Newsgroups allows you - to compose mail and newsgroup messages using either the HTML (rich-text) - formatting editor or the plain-text editor for each mail account you have. - In addition, you can choose whether your addressees should receive HTML or - plain-text messages by default, and how Mail & Newsgroups should handle - messages when it's not known if an addressee can receive HTML-formatted - mail.

- -

To specify whether to use the HTML editor as the default for composing - messages, begin from the Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Select the mail or newsgroup account you want to use.
  4. -
  5. Go to the Composition & Addressing panel and select Compose - messages in HTML format. You see the Formatting toolbar in the Compose - window. Leave this box unchecked to use the plain-text editor for this - account.
  6. -
- -

[Return to beginning of - section]

- -

Editing or Inserting HTML - Elements

- -

If you understand how to work with HTML source code, you can edit or insert - additional HTML tags, style attributes, and JavaScript in your mail message. - If you are not sure how to work with HTML source code, it's best not to - change it. To work with HTML code, use one of these methods:

- - - -

For more information on editing HTML source code, see - Using the - Advanced Property Editor.

- -

[Return to beginning of - section]

- -

Choosing HTML Mail Sending - Options

- -

By default, Mail & Newsgroups prompts you before sending HTML messages - when it's not known whether the recipient's mail program can - display HTML-formatted messages.

- -

To choose sending-format options for mail messages, begin from the Mail - window:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, click - Send Format. (If no subcategories are visible, - double-click Mail & Newsgroups to expand the list). - -

    Note: This preference applies only to mail messages, - not to newsgroup messages.

    -
  4. -
  5. Select the option you want and then click OK.
  6. -
- -

If while composing a message you realize that one or more recipients may not - be able to receive HTML-formatted mail, you can easily convert the message to - a different format when you click Send:

- -
    -
  1. In the Compose window, open the Options menu and choose Format.
  2. -
  3. Select the format you want to use for sending the message from the - submenu: - -
  4. -
  5. When you've finished composing the message, click Send.
  6. -
- -

[Return to beginning of - section]

- -

Specifying Recipients for HTML - Messages

- -

You can save time by indicating whether individuals in your address books - prefer to receive either HTML messages or plain text messages.

- -
    -
  1. Open the Window menu and choose Address Book.
  2. -
  3. Select the address book on the left and then select the individual's - card on the right.
  4. -
  5. Click Properties to display the Card for dialog box.
  6. -
  7. In the Contact tab, use the Prefers to receive messages formatted - as drop-down list to select HTML if you know this recipient can read - HTML-formatted messages (such as messages that include links, images, or - tables). - -

    If this recipient can only read messages sent as plain text (no - formatting), then choose Plain Text. If you don't know or are not - sure, choose Unknown.

    - -

    If you choose Unknown, &brandShortName; Mail & Newsgroups determines - the sending format based on the Send Format settings for Mail & - Newsgroups in the Preferences dialog box. If Mail & Newsgroups still - can't determine the correct format, it will prompt you to choose a - sending format when you send the message.

    -
  8. -
  9. Click OK.
  10. -
- -

[Return to beginning of - section]

- -

Viewing the Message - Source for HTML Messages

- -

You can quickly view the HTML and other code that generates an HTML message - you've received:

- -
    -
  1. In the message list window, open the message.
  2. -
  3. Open the View menu and choose Message Source.
  4. -
- -

[Return to beginning of - section]

- -

Using the HTML Mail Question - Dialog Box

- -

The HTML Mail Question dialog box appears when you try to send a message to - someone whose mail program may not be able to display HTML messages or when - Mail & Newsgroups cannot determine whether your recipient can display - HTML messages. If you are in doubt, send the message in both HTML and - plain-text formats.

- -

[Return to beginning of - section]

- -

Using Attachments

- -
In this section: - -
- -

Attaching a File or Web Page

- -

To attach a file to an outgoing mail message:

- -
    -
  1. In the Compose window, click Attach or open the File menu and choose - Attach File. You see the Enter file to attach dialog box. - -

    Tip: You can also click inside the Attachments area to - attach a file.

    -
  2. -
  3. Type the name of the file you want to attach, or select a file from your - hard drive that you want to attach.
  4. -
  5. Click Open. The filename appears in the Attachments area.
  6. -
- -

Tip: You can also drag and drop one or more files from your - desktop into the Attachments area in the Compose window.

- -

To attach a web page to an outgoing mail message:

- -
    -
  1. In the Compose window, open the File menu and choose Attach Web Page.
  2. -
  3. In the dialog box, enter the URL of the page and then click OK. The web - page URL appears in the Attachments area.
  4. -
- -

Tip: When you are viewing a page in the Navigator browser, - you can send the page to someone by opening the File menu and choosing Send - Page.

- -

[Return to beginning of section]

- -

Viewing and Opening Attachments

- -

If you receive a mail attachment that consists of a file type that - &brandShortName; can display (such as graphic files and HTML files), you see - the attachment displayed inline (in the body of the message). For - other file types, Mail & Newsgroups lets you open the attachment using - another application, or you can save the attachment on your hard disk.

- -

To open the attachment, make sure you have a program on your computer that - can open files of the same type as the attachment's file format. For - example, if you want to open a .DOC file, make sure you have a program on - your computer that can open .DOC files.

- -

To open an attachment:

- -
    -
  1. Double-click the attachment you want (if there is more than one).
  2. -
  3. In the Downloading dialog box, choose what you want &brandShortName; to - do with the attachment: - -
  4. -
  5. Click OK.
  6. -
- -

Note: If you are viewing your mail using an IMAP mail - server, all attachments remain on the server.

- -

[Return to beginning of section]

- -

Saving Attachments

- -

To save an attachment:

- -
    -
  1. In the right side of the message envelope, under Attachments, - select the attachment that you want to save.
  2. -
  3. Right-click or, if you have a one-button mouse, - Ctrl-clickthe attachment and choose Save As from the - pop-up menu.
  4. -
  5. Choose a filename and location for the attachment on your hard disk and - then click OK. Mail & Newsgroups downloads the attachment and saves it - to the specified location.
  6. -
- -

Tip: To save all attachments, right-click - or, if you have a one-button mouse, - Ctrl-clickthe first one in the attachment list, and choose - Save All. You can then specify the location where you want all the - attachments to be saved.

- -

[Return to beginning of section]

- -

Deleting Messages

- -
In this section: - -
- -

Deleting POP or IMAP Messages

- -

How you delete messages depends on your mail server type: POP or IMAP. - Deleted POP messages are automatically moved to the Trash folder. IMAP users - can set different options for deleting messages.

- -

To delete messages from your Inbox or other folders, begin from the Mail - window:

- -
    -
  1. In the message list, select the messages and click Delete. By default, - Mail & Newsgroups moves the selected messages to the Trash folder.
  2. -
  3. To delete messages permanently, open the File menu and choose Empty - Trash.
  4. -
- -

To delete messages without opening them, begin from the Mail window:

- -
    -
  1. Open the View menu and choose Show/Hide, and then uncheck Message Pane. - -

    Alternatively, click the Message Pane handle (the ridged area centered - at the bottom of the message list) to close the message pane.

    -
  2. -
  3. In the message list, select the messages and click Delete.
  4. -
- -

To set deletion preferences for IMAP messages:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Locate the IMAP account you want, and then click the Server Settings - category under the account name.
  4. -
  5. Select the options you want for - deleting messages and click OK.
  6. -
- -

[Return to beginning of section]

- -

Moving Messages To and From the - Trash

- -

If you use a POP server to deliver your mail, or if you set up IMAP to use - the Trash folder, follow these steps to delete messages from your Inbox or - other folders:

- -
    -
  1. In the message list, select the messages you want to delete.
  2. -
  3. Click Delete. Mail & Newsgroups moves the messages to the Trash - folder.
  4. -
- -

To recover messages from the Trash:

- -
    -
  1. Click the Trash folder.
  2. -
  3. Select the messages you want to recover and drag them to another - folder.
  4. -
- -

To delete messages permanently:

- - - -

[Return to beginning of section]

- -

Using Address Books

- -
In this section: - -
- -

About Address Books

- -

Address books store email addresses and contact information for people you - typically send mail to, such as colleagues, friends, and family. - &brandShortName; Mail & Newsgroups provides you with two address books: - the Personal Address Book and the Collected Addresses Book—and you can - create additional address books as well. You can also import address books - from other mail programs and previous versions of &brandShortName;. The - contents of these address books are stored locally on your hard disk.

- -

Your address book may also list email addresses from an LDAP directory, - which is located on an LDAP directory server. The directory server stores - email addresses of people that are not included in your locally-stored - address books. The Lightweight Directory Access Protocol (LDAP) is an - industry-standard method for accessing Internet or intranet directory - services such as corporate address books.

- -

Personal Address Book

- -

Use the Personal Address Book to add specific names of your choice. You can - create mailing lists and edit individual address entries.

- -

Collected Addresses

- -

By default, the Collected Address Book automatically collects the email - addresses contained in outgoing mail messages. Addresses from outgoing - messages are stored in the Collected Address Book as soon as you click - Send.

- -

LDAP Directory (if available)

- -

An LDAP directory (also known as an address lookup service) stores email - addresses of recipients who are not in your locally-stored address books. - LDAP directories offer you access to large, centrally maintained databases - of email addresses, which is especially useful with - address autocompletion.

- -

Automatic address collection is enabled by default. To change automatic - address collection settings, begin in the Mail window:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, click Addressing. (If no - subcategories are visible, double-click Mail & Newsgroups to expand the - list.)
  4. -
  5. Under Email Address Collection, select Add email addresses to my - and choose whether you want: - -
  6. -
  7. Click OK.
  8. -
- -

Opening the Address Book Window

- -

To open the Address Book window:

- - - -

Changing the Address Book Window Display

- -

To customize how the Address Book window and the cards are displayed:

- -
    -
  1. Open the Window menu and choose Address Book. You see the Address Book - window.
  2. -
  3. In the Address Book window, open the View menu and choose from the - following display options: - -
  4. -
- -

[Return to beginning of section]

- -

Adding Entries to Your Address - Books

- -

You can use any of the following ways to add entries to your address - books:

- - - -

[Return to beginning of section]

- -

Creating a New Address Book

- -

&brandShortName; Mail & Newsgroups provides a default personal address - book, but you can create additional address books.

- -

To create a new address book:

- -
    -
  1. Click the Address Book icon in the lower-left corner of any - &brandShortName; window, or open the Window menu and choose Address Book. - You see the Address Book window. - - - - - - - - - -
    Address Book icon
    -
  2. -
  3. In the Address Book window, open the File menu, choose New, and choose - Address Book. You see the New Address Book dialog box.
  4. -
  5. Type the name of the new address book, and click OK.
  6. -
- -

[Return to beginning of section]

- -

Creating a New Address Book Card

- -

Address book cards can be used to store names, postal addresses, email - addresses, phone numbers, and information such as whether the addressee - prefers to receive plain-text or HTML-formatted messages.

- -

To create an address book card for an individual:

- -
    -
  1. Click the Address Book icon on the status bar or open the Window menu and - choose Address Book.
  2. -
  3. Click New Card. (If you have multiple address books, select the one to - which you want to add a card.)
  4. -
  5. Each New Card dialog box has three tabs: - -
  6. -
- -

Tip: To quickly add entries to your address book, click any - email address in messages you receive and select Add to Address Book from the - drop-down list. The New Card dialog box appears where you can complete the - information.

- -

Viewing or Editing Card - Properties

- -

To view or edit the properties for an individual card:

- -
    -
  1. Select the card from the list of entries in the Address Book window.
  2. -
  3. Click Properties.
  4. -
- -

[Return to beginning of section]

- -

Creating a Mailing List

- -

If you regularly send messages to a group of recipients, you can quickly - address a message by using a mailing list that contains the names you - want.

- -

To create a mailing list and add it to your address book:

- -
    -
  1. In the Address Book window, click New List.
  2. -
  3. Enter the following information in the Mailing List dialog box: - -
  4. -
  5. Type email addresses to add them to the mailing list.
  6. -
  7. Click OK.
  8. -
- -

In the left side of the Address Book window, the mailing list appears - underneath the address book you added it to.

- -

[Return to beginning of section]

- -

Editing a Mailing List

- -

Mailing lists are stored in the address book in which you created them.

- -

To remove a member from the list, begin from the Mail window:

- -
    -
  1. Open the Window menu and choose Address Book.
  2. -
  3. Expand the address book containing your mailing list by clicking the - small triangle beside the address book title.
  4. -
  5. Highlight the mailing list by clicking its name. The list members appear - to the right of the mailing list name.
  6. -
  7. Click the entry you wish to delete.
  8. -
  9. Click the Delete button.
  10. -
- -

To add members to a mailing list:

- -
    -
  1. Open Window menu and choose Address Book.
  2. -
  3. Expand the address book containing your mailing list by clicking the - small triangle beside the address book title.
  4. -
  5. Highlight the mailing list by clicking its name.
  6. -
  7. Click Properties.
  8. -
  9. Add or remove entries as necessary.
  10. -
  11. Click OK when you are done.
  12. -
- -

[Return to beginning of section]

- -

Searching Address Books and - Directories

- -

&brandShortName; Mail & Newsgroups lets you quickly search an address - book or directory by name or email address, or use a combination of criteria - to perform a more specific search through an address book or directory.

- -

To quickly search an address book or directory for a name or email address, - begin from the Address Book window:

- -
    -
  1. In the Address Book window, in the list of address books, select the - address book or directory that you want to search.
  2. -
  3. In the Name or Email contains field, type the name or email - address that you want to find. You can type only part of the name or email - address, or you can type the exact text that you want to find. - -

    As soon as you stop typing, &brandShortName; Mail & Newsgroups - displays only those entries where the name or email address contains the - search text you entered.

    -
  4. -
  5. Click Clear to erase the search text and show all entries.
  6. -
- -

Searching for Specific Entries

- -

You can search address books or directories for specific entries. If you are - not already viewing the Advanced Address Book Search dialog box, begin from - the Address Book window:

- -
    -
  1. Open the Tools menu and choose Search Addresses. You see the Advanced - Address Book Search dialog box.
  2. -
  3. Next to Search in, choose the address book or directory through - which you want to search.
  4. -
  5. Select the matching option Mail & Newsgroups uses to search for - entries either that match all or at least one of the conditions (criteria) - that you choose.
  6. -
  7. Click More to add criteria and Fewer to remove them.
  8. -
  9. Click Search to begin, or click Clear to reset your entries. The search - results appear in lower part of the dialog box.
  10. -
  11. To sort the entries in a different order, click the column that you want - to sort by.
  12. -
  13. To view the card for an entry, select the entry and click - Properties.
  14. -
  15. To compose a message to selected recipients, select one or more entries - and click Compose.
  16. -
- -

[Return to beginning of section]

- -

Importing Address Books

- -

If you have a &brandShortName; address book from another user profile or - computer, or if you have an address book from another mail program, you can - import its entries into the Address Book window as a new address book. Keep - in mind that when you upgrade a user profile from an earlier version of - &brandShortName;, your address books are automatically included, so - there's no need to import them.

- -

You can import address books from Netscape 6, Netscape 7, Eudora, Outlook, - Outlook Express, or text files (LDIF, tab-delimited (.tab), comma-separated - (.csv), or text (.txt) formats). When you import an address book, Mail & - Newsgroups creates a new address book with the imported entries.

- -

You can also import mail - messages and settings from Communicator, Eudora, Outlook, and Outlook - Express.

- -

To import an address book, begin from the Mail window:

- -
    -
  1. Open the Tools menu, and choose Import. You see the Mail Import - Wizard.
  2. -
  3. Follow the instructions to import address books.
  4. -
- -

[Return to beginning of section]

- -

Exporting Address Books

- -

You can export a &brandShortName; address book if you later want to import - it into another user profile, move it to another computer, or use it with - another program that can import address books. You can export an address - book to one of these file formats: &brandShortName; (.ldif), tab-delimited - (.tab), comma-separated (.csv), or text (.txt) formats.

- -

To export an address book, begin from the Address Book window:

- -
    -
  1. Select the address book that you want to export.
  2. -
  3. Open the Tools menu, and choose Export.
  4. -
  5. In the Export Address Book dialog box, browse to the location where you - want to save the address book file.
  6. -
  7. Choose the file format for the exported address book (.ldif, - comma-separated, or tab-delimited).
  8. -
  9. Enter a name for the address book file. Be sure to include the - appropriate file extension (.ldif, .csv, .tab, or .txt).
  10. -
  11. Click Save.
  12. -
- -

[Return to beginning of section]

- -

Adding and Removing LDAP - Directories

- -

Adding an LDAP directory to your address book allows you to search the - directory for email addresses and other contact information. You can also use - the directory for address autocompletion when addressing mail messages.

- -

You typically add or remove LDAP directories using instructions provided by - your system administrator. Check with your system administrator for the - information you will need in order to add a new directory to your address - book.

- -

To add a new directory, begin from the Address Book window:

- -
    -
  1. Open the File menu, and choose New, and then choose LDAP Directory. You - see the Directory Server Properties dialog box.
  2. -
  3. Type the following information in the Directory Server Properties dialog - box General tab: - -
  4. -
  5. Click the Advanced tab to configure LDAP directory server settings.
  6. -
  7. Type the following information: - -
  8. -
  9. Click OK to close the Directory Server Properties dialog box.
  10. -
- -

The directory you added appears in the list of address books in the Address - Book window.

- -

To delete a directory:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences. You see the - Preferences dialog box.
  2. -
  3. Under the Mail & Newsgroups category, select Addressing. (If no - subcategories are visible, double-click Mail & Newsgroups to expand - the list.)
  4. -
  5. Under Address Autocompletion on the right side of the dialog box, click - Edit Directories.
  6. -
  7. In the LDAP Directory Servers dialog box, select the directory that you - want to delete and click Delete.
  8. -
  9. Click OK, then click OK again to close the Preferences dialog box.
  10. -
- -

For information on downloading or synchronizing a directory for offline use - so that you can search it or use it for address book autocompletion while - working offline, see - Downloading - Directory Entries for Offline Use.

- -

Directory Server Settings

- -

If you are not already viewing the Directory Server Settings dialog box, - begin from the Mail window:

- -
    -
  1. Open the Window menu, and choose Address Book.
  2. -
  3. In the list of address books, select a directory.
  4. -
  5. Click Properties.
  6. -
- -

General Tab

- - - -

Advanced Tab

- - - -

[Return to beginning of section]

- -

Organizing Your Messages

- -
- -
- -

Creating a Folder

- -

To create a message folder, begin from the Mail window:

- -
    -
  1. Open the File menu, choose New, and then Folder. You see the New Folder - dialog box.
  2. -
  3. Type the name of the folder.
  4. -
  5. Click the drop-down list and choose a folder location and click OK. Your - new folder appears in your Mail Folders list.
  6. -
- -

[Return to beginning of section]

- -

Renaming a Folder

- -

To rename an existing folder, begin from the Mail window:

- -
    -
  1. Select the folder you want to rename.
  2. -
  3. Open the File menu and choose Rename Folder. You see the Rename Folder - dialog box.
  4. -
  5. Type the new name and click OK.
  6. -
- -

Note: If you rename a folder that you've been using to - store filtered messages, the filter - will automatically update to use the renamed folder.

- -

[Return to beginning of section]

- -

Moving or Copying a Folder

- -

You can copy a folder and its contents to another mail account, or move a - folder within the same mail account.

- -

To move or copy a folder, begin from the Mail window:

- -
    -
  1. Select the folder you want to move or copy.
  2. -
  3. Do one of the following: - -
  4. -
- -

[Return to beginning of section]

- -

Filing Messages in Folders

- -

You can move messages from one folder to another by using either of these - methods:

- - - -

To copy a message from one folder to another:

- -
    -
  1. Select the message and right-click to display the pop-up menu.
  2. -
  3. Select Copy To and then select the destination account and folder - from the drop-down list.
  4. -
- -

Tip: Alternatively, you can copy a message between folders - by holding down the Shift key while dragging the message from the message - list over another folder.

- -

[Return to beginning of section]

- -

Sharing Folders With Other Users - (IMAP Only)

- -

Users with IMAP mail accounts can share mail folders with other users on the - same network. Sharing folders allows several users to see and work with the - same messages, similar to a newsgroup. To use shared folders, your IMAP mail - server must support Access Control List (ACL) management. Check with your - system administrator or help desk if you are not sure that shared folders - are supported by your IMAP mail server.

- -

To share a mail folder with other users on your network, or to view sharing - information for a folder, begin from the Mail window:

- -
    -
  1. Within an IMAP account, select a folder that you want to share, or select - a folder whose sharing privileges you want to view. - -

    Folders listed under Local Folders, or folders listed under a POP mail - account cannot be shared.

    -
  2. -
  3. Open the Edit menu, and choose Folder Properties.
  4. -
  5. Click the Sharing tab.
  6. -
  7. Click Privileges. You may be prompted to enter your network user name and - password. - -

    The Privileges button is only available if the IMAP mail server allows - you to set folder sharing privileges. If this button is not available, - you can view the folder sharing privileges for this folder but cannot - change them.

    -
  8. -
  9. Follow the instructions on the screen to add users and to set their - folder access privileges. - -
  10. -
  11. Click OK to confirm your changes.
  12. -
  13. Click OK to close the Folder Properties dialog box.
  14. -
- -

In the list of folders for your mail account, a shared folder displays a - distinctive folder icon to indicate that it is shared.

- -

To send a message that tells others how they can subscribe to your shared - folder, begin from the Mail window:

- -
    -
  1. Select the shared folder.
  2. -
  3. Right-click to display a pop-up menu, and choose Copy Folder - Location.
  4. -
  5. Click Compose to display a Mail compose window.
  6. -
  7. Click in the message body, open the Edit menu, and choose Paste.
  8. -
  9. Address the message, type a subject, and type the message text. Tell - message recipients that they can subscribe to the shared folder by clicking - the link you pasted into the message. - -

    Only message recipients who share the same network will be able to - subscribe to your shared folder.

    -
  10. -
  11. Click Send.
  12. -
- -

Subscribing to a Shared Folder

- -

Subscribing to a shared folder is similar to subscribing to a newsgroup. To - subscribe to a shared folder, begin from the Mail window:

- -
    -
  1. Open the File menu and choose Subscribe. You see the Subscribe dialog - box.
  2. -
  3. If necessary, click the Account drop-down list to choose another IMAP - mail account.
  4. -
  5. Select the folder that you want to subscribe to.
  6. -
  7. Click Subscribe or click in the Subscribe column next to the folder. You - see a checkmark next to each folder to which you subscribe. Click - Unsubscribe to cancel a selection.
  8. -
  9. Click OK. The list of your subscribed folders appears in the Mail - window.
  10. -
- -

[Return to beginning of section]

- -

Tagging Messages

- -

You can apply tags to messages to help you organize and prioritize them. - You can apply a standard color and tag text to messages, or you can create - your own color and tag text to suit your needs.

- -

One powerful way to use tags is to set up a message filter to - automatically tag incoming messages from a specific sender. For example, - you can set up a message filter so that incoming messages from your boss are - tagged Important and appear in red. See - Creating Message Filters for more - information.

- -

Applying a Tag

- -

To apply a tag to a message, begin from the Mail window:

- -
    -
  1. Select the message you want to tag.
  2. -
  3. Open the Message menu, and choose Tag.
  4. -
  5. Choose the tag you want to apply from the list.
  6. -
- -

The message summary row changes to the color of the tag with the topmost - priority. To see the tag text, you must display the Tags column in the Mail - window.

- -

Tip: To quickly tag messages or remove a tag, select - one or more messages and press one of the number keys 1-9 on your keyboard. - Press 0 to remove all tags.

- -

To display the Tags column, begin from the Mail window:

- - - -

Note: Message tags apply on a per-account basis. For - example, if you move or copy a tagged message to another mail account, the - tags are not preserved. Similarly, if you forward a tagged message to - another recipient, the tags are not preserved. For IMAP mail accounts, if - your IMAP server supports user-defined keywords, message tags will persist - when you log in to your mail account from a different location.

- -

[Return to beginning of section]

- -

Customizing Tags

- -

You can customize tag colors and text and their order to suit your needs.

- -

To customize tags, begin from the Mail window:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences. You see the - Preferences dialog box.
  2. -
  3. Under the Mail & Newsgroups category, click Tags. (If no - subcategories are visible, double-click Mail & Newsgroups to expand the - list.)
  4. -
  5. Edit the tag text, or replace it with your own tag text. The tag - can be up to 32 characters long.
  6. -
  7. To change the tag color, click the color block next to that tag and - select a new color.
  8. -
  9. Click the the Move Up and Move Down buttons to reorder the tags. Tags at - the top will have higher priority when coloring messages.
  10. -
  11. Click OK.
  12. -
- -

Your changes are immediately applied to all tagged messages in all your - mail accounts.

- -

Tip: To undo all customizations and restore just the - default tags' text and colors, follow the steps above to display the tag - settings, and click Restore Defaults.

- -

[Return to beginning of section]

- -

Sorting Messages by Tags

- -

To sort messages by tags, begin from the Mail window:

- -
    -
  1. To display the Tags column if it is hidden, click the Show/Hide Columns - icon and select Tags from the - list.
  2. -
  3. Click the Tags column to sort messages by tags, and within each tag - type, to sort messages by date.
  4. -
- -

[Return to beginning of section]

- -

Removing Tags

- -

To remove a message tag, begin from the Mail window:

- -
    -
  1. Select one or more tagged messages.
  2. -
  3. Open the Message menu, and choose Tag.
  4. -
  5. Choose the tag you want to remove or None to remove all tags - from this message.
  6. -
- -

[Return to beginning of section]

- -

Marking or Flagging Messages

- -

You might want to mark a message you've read as unread if you later - want to re-read the message or respond to it.

- -

To mark a message as unread, begin from the Mail window:

- -
    -
  1. Select a Mail or Newsgroup folder to display its messages.
  2. -
  3. Click in the Read column of each message you want to mark as unread. - Messages marked as unread display a symbol in the Read column. Messages marked as read display a - symbol in the Read column. If the - Read column is not visible, click the Show/Hide Columns icon - and select Read from the list.
  4. -
- - - - - - - - -
Read column
- -

You can flag messages that you later want to download for - offline - use.

- -

To flag messages, begin from the Mail window:

- -
    -
  1. Select a Mail or Newsgroup folder to display its messages.
  2. -
  3. Click in the Flag column of each message you want to download. A flag - appears where you clicked to - indicate that the message has been flagged. If the Flag column is not - visible, click the Show/Hide Columns icon and select Flag from the list.
  4. -
- - - - - - - - -
Flag column
- -

[Return to beginning of section]

- -

Using Message Views

- -

You can apply preset or custom message views to help you manage messages by - filtering displayed messages.

- -

To use a message view, open the View menu and choose Messages. Choose an - option from the submenu.

- - - -

Tip: You can quickly change message view from the View box - in the Search Bar. If you do not see the Search Bar, open the View menu, - choose Show/Hide, and then choose Search Bar.

- - - - - - - - - -
Quick mail search bar
- -

Creating a Custom View

- -

You can create custom message views to only display messages matching - certain criteria.

- -

To change or create a custom message view:

- -
    -
  1. Open the View menu, choose Messages, and then choose Customize...
  2. -
  3. To create a new view, click New. To modify a view, select a view and - click Edit.
  4. -
  5. Type a name for the message view.
  6. -
  7. Select the matching option you want Mail to use: all of the - following conditions (criteria) you choose, or any of the - following.
  8. -
  9. Use the drop-down lists to choose the search criteria (for example, - Subject, Sender, contains, doesn't - contain) and then type the text or phrase you want to match. - -

    Tip: To search for messages that contain a header not - listed in the first drop-down menu (for example, if you want to search - for messages that include the header Resent-From), choose Customize and - type the header you want to search for. &brandShortName; Mail & - Newsgroups adds your custom header to the drop-down list, so you can then - choose it to search for matching entries. Make sure you enter the custom - header correctly, since Mail will only find entries that exactly match - what you type.

    -
  10. -
  11. Click More to add criteria and Fewer to remove them.
  12. -
  13. Click OK to confirm your settings.
  14. -
  15. Click OK in the Customize Message Views dialog box. The selected view - setting applies automatically.
  16. -
- -

[Return to beginning of section]

- -

Creating Message Filters

- -

Message filters allow you to manage and organize your messages. You can - create message filters that &brandShortName; Mail & Newsgroups uses to - automatically perform certain actions on incoming messages based on criteria - you specify. For example, you can create a message filter that automatically - moves incoming messages to a particular folder. Message filters operate on a - per-account basis.

- -

If you are not already viewing the Message Filters dialog box, begin from - the Mail window:

- -
    -
  1. Open the Tools menu and choose Message Filters. You see the Message - Filters dialog box.
  2. -
  3. If you have multiple mail accounts, choose the one to which you want to - apply the filter.
  4. -
  5. Click New. You use the Filter Rules dialog box to specify the types of - messages to act on, and the action you want the filter to perform.
  6. -
  7. Type a name for the filter.
  8. -
  9. Select the matching option you want Mail to use: all of the - following conditions (criteria) you choose, or any of the - following conditions.
  10. -
  11. Use the drop-down lists to choose the search criteria (for example, - Subject, Sender, contains, doesn't - contain) and then type the text or phrase you want to match. - -

    Tip: To search for messages that contain a header not - listed in the first drop-down menu (for example, if you want to search - for messages that include the header Resent-From), choose Customize and - type the header you want to search for. &brandShortName; Mail & - Newsgroups adds your custom header to the drop-down list, so you can then - choose it to search for matching entries. Make sure you enter the custom - header correctly, since Mail will only find entries that exactly match - what you type.

    -
  12. -
  13. Click + to add criteria and - to remove them.
  14. -
  15. Use the list to choose the action you want the filter to perform on the - messages (for example, Move to Folder). - -

    Tip: To automatically tag incoming messages, choose - Tag the message from the drop-down list.

    -
  16. -
  17. Choose a destination folder in which to store the messages, or create a - new folder.
  18. -
  19. Click OK to confirm your settings.
  20. -
  21. Click OK in the Message Filters dialog box. The filter begins filtering - incoming messages as soon as you click OK.
  22. -
- -

To manage your filters, begin from the Mail window:

- -
    -
  1. Open the Tools menu and choose Message Filters. You see the Message - Filters dialog box.
  2. -
  3. If you have multiple mail accounts, choose the one to which you want to - apply the filter.
  4. -
  5. Choose from the following: - -
  6. -
  7. Click OK when you are done managing your filters. If you created a new - filter, it begins filtering incoming messages as soon as you click OK.
  8. -
- -

Note: If you delete a folder that you've been using to - store filtered messages, the filter will no longer work. Incoming messages - that match the filter criteria will appear in your Inbox. If you rename or - move the folder, the filter will automatically update to use the renamed or - moved folder.

- -

Tip: If you have existing messages that you want to move to - another folder, use the Run Filters on Messages option in the Tools menu.

- -

[Return to beginning of section]

- -

Filtering Messages From a - Specific Sender

- -

You can quickly create a filter for messages from a particular sender. For - example, if you want to automatically move all incoming messages from your - child's teacher into a folder called School, you can quickly set - up a filter to do this.

- -

To create a filter for messages from a specific sender, begin from the Mail - window:

- -
    -
  1. Select a message from a specific sender.
  2. -
  3. Open the Message menu, and choose Create Filter From Message. You see the - Filter Rules dialog box. Using the sender's email address, - &brandShortName; prefills the filter name, the filter matching criteria, - and the filter action (Move to folder).
  4. -
  5. Choose a destination folder in which to store the incoming messages from - the specified sender, or create a new folder.
  6. -
  7. Click OK to confirm your settings. You see the - Message Filters dialog box, where - you can create, delete, or edit message filters.
  8. -
  9. Click OK. The filter begins filtering incoming messages from the - specified sender as soon as you click OK.
  10. -
- -

[Return to beginning of section]

- -

Searching Through Messages

- -

&brandShortName; Mail & Newsgroups lets you quickly find text in a - single message, search messages by subject or sender, or use a combination of - criteria to perform a thorough search through all messages in a specific mail - folder, newsgroup, or account.

- -

To locate text in a single message, begin from the Mail window:

- -
    -
  1. Select the message, open the Edit menu, and choose Find in This - Message.
  2. -
  3. Type the text that you want to locate in the dialog box.
  4. -
  5. Click Find to locate the first occurrence of the text.
  6. -
  7. Continue clicking Find to locate additional occurrences, or click Cancel - when you are done.
  8. -
  9. Choose Find Again from the Edit menu to continue searching for the text - throughout the rest of the message.
  10. -
- -

To quickly search for messages in a selected folder by subject or sender, - begin from the Mail window:

- -
    -
  1. To the right of Subject or Sender contains:, type the subject text - or sender name that you want to find. You can type only part of the subject - or sender, or you can type the exact word or name that you want to find. - -

    As soon as you stop typing, &brandShortName; Mail & Newsgroups - displays only those messages in the selected folder where the subject or - sender contains the search text you entered.

    -
  2. -
  3. Click Clear to erase the search text and show all messages in the - selected folder.
  4. -
- -

Searching for Specific Messages

- -

You can search mail folders or newsgroups for specific messages. If you are - not already viewing the Search Messages dialog box, begin from the Mail - window:

- -
    -
  1. Open the Tools menu and choose Search Messages. You see the Search - Messages dialog box.
  2. -
  3. Next to Search for messages in, choose the account, newsgroup, or - folder through which you want to search.
  4. -
  5. Select Search subfolders to include all subfolders in the - search.
  6. -
  7. Select Search local system to search only messages from newsgroups - or IMAP accounts that have been saved locally. - -

    Note: The checkbox will be disabled if it's not - possible to search remotely stored messages.

    -
  8. -
  9. Select which matching option Mail & Newsgroups will use to search for - messages that match all or at least one of the conditions (criteria) that - you choose.
  10. -
  11. Use the drop-down lists to indicate the search criteria (for example, - Subject and contains) and then type the text or phrase that - you want to match. - -

    Tip: To search for messages that contain a header not - listed in the first drop-down menu (for example, if you want to search - for messages that include the header Resent-From), choose Customize and - type the header you want to search for. &brandShortName; Mail & - Newsgroups adds your custom header to the drop-down list, so you can then - choose it to search for matching entries. Make sure you enter the custom - header correctly, since Mail will only find entries that exactly match - what you type.

    -
  12. -
  13. Click More to add criteria and Fewer to remove them.
  14. -
  15. Click Search to begin, or click Clear to reset your entries. The search - results appear in lower part of the Search Messages dialog box. - -
  16. -
- -

[Return to beginning of section]

- - - -

Controlling Junk Mail

- -

This section describes how to use &brandShortName;'s Junk Mail Controls -to filter unwanted mail.

- -
In this section: - -
- - -

Using Junk Mail Controls

- -

&brandShortName;'s Junk Mail Controls feature can evaluate your - incoming messages and identify possible junk (or unsolicited) messages. The - feature uses the Bayesian classification method. You first train - &brandShortName; by showing it a bunch of mail that is junk, and a bunch of - mail that is not. Then, you let it auto-classify new mail for you. If - &brandShortName; makes any mistakes, you can correct them.

- -

To use Junk Mail Controls:

- -
    -
  1. First, train &brandShortName; to recognize Junk messages and Non-Junk - messages. There are three ways to toggle junk status of the selected - message(s): - - -

    When you toggle junk status, a trash-can icon will appear or disappear - in the Junk status column to indicate the junk status of the selected - message.

    -
  2. - -
  3. Open the Edit menu, and choose Mail & Newsgroups Account Settings. - You see the Mail & Newsgroups Account Settings dialog box.
  4. -
  5. Click the Junk Settings category for your mail account.
  6. -
  7. Enable the feature and &brandShortName; will automatically classify - incoming messages. (See - Junk Mail Controls Options. - Details on the other settings there can be found in the - Junk Settings preference panel description.) -
  8. -
  9. If you have trained it on virus mail, consider disabling the white - listing (many mail viruses send bulk messages to people in the address book - of the infected computer).
  10. -
  11. Make sure to correct the Junk Mail Controls when it incorrectly labels - messages either as junk or not junk.
  12. -
  13. To analyze existing messages, select messages, open the Tools menu - and choose Run Junk Mail Controls.
  14. -
- -

Note: &brandShortName; will only run Junk Mail Controls - when the training database has information on non-Junk messages. If Junk Mail - Controls do not work, select some messages and explicitly mark them as Not - Junk.

- -

[Return to beginning of section]

- - -

Junk Mail Controls Options

- -

To fine-tune how Junk Mail Controls work, use the - global Junk Mail preference panel for - account-independent settings and the account manager's - Junk Settings for settings of a specific mail - account.

- -

[Return to beginning of section]

- - -

Junk Mail Controls and Filters

- -

Junk Mail Controls run after mail filters and apply only to the Inbox folder - and its sub-folders. Use this to your advantage, for example, you can filter - mail you are sure not to be Junk to a special folder outside of Inbox so that - the messages will not be classified as Junk (especially useful if you - subscribe to newsletters or if you are on a moderated mailing list).

- -

[Return to beginning of section]

- - - -

Importing Mail from Other - Programs

- -

This section describes how to import mail messages and settings from - Netscape Communicator, Outlook, Outlook Express, and Eudora. To import - address books from these programs, see - Importing Address Books.

- -
In this section: - -
- -

Importing Mail Messages

- -

To import mail messages from Netscape Communicator, Outlook, Outlook - Express, or Eudora, begin from the Mail window:

- -
    -
  1. Open the Tools menu, and choose Import. You see the Import Wizard.
  2. -
  3. Follow the instructions to import mail messages.
  4. -
- -

For Netscape Communicator, the wizard imports a copy of all Communicator - mail folders included under Local Folders. Imported mail is added as a new - folder under Local Folders in the Mail window. (The Communicator mail - folders still remain in their original location).

- -

[Return to beginning of - section]

- -

Importing Mail Settings

- -

To import mail settings from Outlook, Outlook Express, or Eudora, begin from - the Mail window:

- -
    -
  1. Open the Tools menu, and choose Import. You see the Import Wizard.
  2. -
  3. Follow the instructions to import mail settings.
  4. -
- -

[Return to beginning of - section]

- -

Getting Started With Newsgroups

- -
In this section: - -
- -

Subscribing to Newsgroups

- -

If you have set up an account on a - newsgroup server, you can join (subscribe) to newsgroups (also called - discussion groups).

- -

To subscribe to a newsgroup, begin from the Mail window:

- -
    -
  1. Open the File menu and choose Subscribe. You see the Subscribe dialog - box.
  2. -
  3. If necessary, click the Account drop-down list to choose another - newsgroup account.
  4. -
  5. Select a newsgroup. To select more than one newsgroup, - CmdCtrl-click additional - newsgroup.
  6. -
  7. Click Subscribe or click in the Subscribe column next to the newsgroup. - You see a checkmark next to each newsgroup to which you subscribe. Click - Unsubscribe to cancel a selection.
  8. -
  9. Click OK. The list of your subscribed newsgroups appears in the Mail - window.
  10. -
- -

If you are an IMAP mail user, you can also subscribe to message folders - located on an IMAP server. (Your Inbox is a type of message folder.) Follow - the instructions above for subscribing, but select an IMAP account from the - Account drop-down list. For more information on sharing folders and - subscribing to folders, see - Sharing Folders With Other Users - (IMAP Only).

- -

[Return to beginning of - section]

- -

Reading Newsgroup Messages

- -

When you open your newsgroup server, you see the list of newsgroups to which - you subscribe. The server downloads the headers of new messages in - each newsgroup.

- -

To read newsgroup messages, begin from the Mail window:

- -
    -
  1. Double-click a newsgroup server icon to see its newsgroups. (If there are - no newsgroups, you may need to subscribe to one.)
  2. -
  3. Click a newsgroup name to see its messages.
  4. -
  5. Click a message to read it. Click the thread button to display all the - responses below the original message. You can click any header to display - its message. You can start a new - thread or post a - message in response.
  6. -
- -

[Return to beginning of - section]

- -

Posting Newsgroup Messages

- -

To start new threads (discussions):

- -
    -
  1. From the list of your subscribed newsgroups in the Mail window, select a - newsgroup.
  2. -
  3. Click Compose.
  4. -
  5. Compose your - message, and click Send to post it.
  6. -
  7. Click Get Msgs to see your posting on the newsgroup.
  8. -
- -

[Return to beginning of - section]

- -

Contributing to Ongoing - Discussions

- -

To post a response to the newsgroup:

- -
    -
  1. In the message list, select a message to reply to.
  2. -
  3. Click Reply.
  4. -
  5. Compose your - message, and click Send to post it.
  6. -
- -

To reply to an individual as well as post a response to the group:

- -
    -
  1. In the message list, select a message to reply to.
  2. -
  3. Click Reply All.
  4. -
  5. Compose your message, and click Send to post it.
  6. -
- -

To redirect a posting to another newsgroup:

- - - -

[Return to beginning of - section]

- -

Monitoring Threads

- -

To monitor unread messages in threads that are of interest to you:

- -
    -
  1. Select a message in a thread.
  2. -
  3. Open the Message menu, and choose Watch Thread.
  4. -
  5. If you want to monitor additional threads, repeat steps 1 and 2 for - messages in additional threads.
  6. -
  7. When you're ready to monitor messages in these threads, open the - View menu, choose Messages, and then choose Watched Threads with Unread. - &brandShortName; Mail & Newsgroups only displays the watched threads - that contain unread messages.
  8. -
  9. Open the View menu, choose Messages, and then choose All to return to - viewing all messages in the newsgroup.
  10. -
- -

To ignore a message thread:

- -
    -
  1. Select a message in the thread.
  2. -
  3. Open the Message menu, and choose Ignore Thread. &brandShortName; Mail - & Newsgroups marks all messages in the thread as read, and new replies - posted to the thread will appear as read.
  4. -
  5. To view ignored threads, open the View menu, choose Messages, and then - choose Ignored Threads.
  6. -
- -

[Return to beginning of - section]

- -

Removing a Newsgroup

- -

To remove a newsgroup from your list:

- - - -

[Return to beginning of - section]

- -

Adding a Newsgroup Server

- -

If the newsgroup you want to subscribe to is on a different server, you must - first set up access to that server.

- -

To set up an additional newsgroup server, open the File menu in the Mail - window and choose New, then Account.

- - - -

Once you've set up access to the new server, you can - subscribe to newsgroups on that - server. In the Mail window, open the File menu, and choose Subscribe.

- -

[Return to beginning of - section]

- -

Working Offline

- -
In this section: - -
- -

Setting Up - &brandShortName; Mail & Newsgroups to Work Offline

- -

&brandShortName; Mail & Newsgroups' offline feature lets you - download your mail and read it offline (while disconnected from the - Internet). If you use a dial-up (modem) connection to access your mail and - you want to reduce the time you are connected, or, if you need to temporarily - disconnect from your company's network while traveling or switching - locations, you can download your mail so that you can read it offline. The - offline feature can automatically download incoming messages and then later - send all your outgoing messages when you reconnect.

- -

Note that for POP accounts your mail is already downloaded by default, so - most of these offline features aren't relevant for POP accounts.

- -

If you occasionally want to work offline, &brandShortName; Mail & - Newsgroups lets you easily:

- - - -

If you frequently work offline, &brandShortName; Mail & Newsgroups also - lets you:

- - - -

[Return to beginning of section]

- -

Downloading Your Inbox for - Offline Use

- -

You can tell &brandShortName; Mail & Newsgroups to automatically - download your Inbox messages for offline use. Later, when you go back online, - &brandShortName; Mail & Newsgroups automatically synchronizes your Inbox - messages with the server.

- -

Note that the Inbox for POP accounts is downloaded by default, so this - section does not apply for POP accounts.

- -

To automatically download your Inbox for offline use, begin from the Mail - window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. In the left side of the dialog box, under the name of the account you - want to use offline, select Offline & Disk Space. (This category is not - available for POP accounts.)
  4. -
  5. Check the box labeled Make the messages in my Inbox available when I - am working offline.
  6. -
  7. Click OK.
  8. -
  9. In the folder pane, under the name of the account you want to use - offline, click any folder other than the Inbox. For example, click the Sent - or the Drafts folder. Then click the Inbox folder to start downloading its - messages.
  10. -
  11. Once downloading is complete, click the Online/Offline indicator - in the lower right corner of the - Mail window (to the left of the Cookie icon) to go offline.
  12. -
- -

&brandShortName; Mail & Newsgroups automatically downloads all messages - in your Inbox so you can read and respond to them while working offline. - After disconnecting, &brandShortName; Mail & Newsgroups remains open so - you can continue to work with your messages.

- -

To reconnect to the Internet so you can work online:

- - - -

When you go back online, &brandShortName; Mail & Newsgroups - automatically synchronizes your Inbox messages with the server, by - replicating any changes you made while working offline.

- -

Tip: &brandShortName; Mail & Newsgroups saves any - messages that you send while working offline in the Unsent Messages folder - under Local Folders. To have &brandShortName; Mail & Newsgroups - automatically send your unsent messages when you reconnect, use the - Preferences command on the &brandShortName; - Edit menu to change the - offline preferences for all - your accounts.

- -

[Return to beginning of section]

- -

Downloading an - Individual Folder for Offline Use

- -

Note that POP accounts don't allow you to manage folders on the POP - server, so this section does not apply to POP accounts.

- -

To download a specific folder for offline use, begin from the Mail - window:

- -
    -
  1. In the left side of the Mail window, select the folder that you want to - download for offline use.
  2. -
  3. Open the Edit menu, and choose Folder Properties. You see the Properties - dialog box.
  4. -
  5. Click the Offline tab.
  6. -
  7. Check Select this folder for offline use.
  8. -
  9. Click Download Now if you want to immediately begin downloading the - folder's messages. Alternatively, you can continue working, and when - you are ready to go offline, proceed to the next step.
  10. -
  11. Click the Online/Offline indicator - in the lower right corner of the Mail window to go offline.
  12. -
  13. In the Work Offline dialog box, click Download.
  14. -
- -

&brandShortName; Mail & Newsgroups automatically downloads all messages - in the selected folder so you can read and respond to them while working - offline. After disconnecting, &brandShortName; Mail & Newsgroups remains - open so you can continue to work with your messages.

- -

Note: Message headers that have been downloaded for reading - offline display a darker gray envelope or newsgroup icon.

- -

To reconnect to the Internet so you can work online:

- - - -

&brandShortName; Mail & Newsgroups automatically synchronizes the - offline folders with the server, by replicating any changes you made while - working offline.

- -

Tip: &brandShortName; Mail & Newsgroups saves any - messages that you sent while working offline in the Unsent Messages folder - under Local Folders. When you reconnect, choose Send Unsent Messages from the - File menu to send all your saved messages at once. To have &brandShortName; - Mail & Newsgroups automatically send your unsent messages when you - reconnect, use the Preferences command on the - &brandShortName; Edit - menu to change your offline - preferences.

- -

[Return to beginning of section]

- -

Downloading - Selected or Flagged Messages for Offline Use

- -

Note that messages are downloaded by default for POP accounts. However, if - you have enabled the Fetch headers only setting in the POP account - settings, then only the headers will be downloaded, and you will need to use - the commands in this section to download the complete messages.

- -

To download selected messages for offline use, begin from the Mail - window:

- -
    -
  1. Select a Mail or Newsgroup folder to display its messages.
  2. -
  3. Select the messages you want to download, as follows: - -
  4. -
  5. Open the File menu, choose Offline, and then choose Get Selected Messages - from the submenu. &brandShortName; Mail & Newsgroups downloads the - selected messages.
  6. -
- -

To download flagged messages for offline use, begin from the Mail - window:

- -
    -
  1. Select a Mail or Newsgroup folder to display its messages.
  2. -
  3. Click in the flag column of each message you want to download. A flag - appears where you clicked to indicate that the message has been marked. If - the flag column is not visible, click the Show/Hide Columns icon - and select Flag from the list.
  4. -
  5. Open the File menu, choose Offline, and then choose Get Flagged Messages. - &brandShortName; Mail & Newsgroups downloads the flagged messages.
  6. -
- -

Once downloading is complete, click the Online/Offline indicator in the - lower right corner of the Mail window (to the left of the Cookie icon) to go - offline. After you disconnect, &brandShortName; Mail & Newsgroups remains - open so you can continue to work with your messages.

- -

Note that the Get Selected Messages and Get Flagged Messages - menu items are also available in the pop-up thread context menu, for faster - access.

- -

Note: Message headers that have been downloaded for reading - offline display a darker gray envelope or newsgroup icon.

- -

To reconnect to the Internet so you can work online:

- - - -

Tip: &brandShortName; Mail & Newsgroups saves any - messages that you sent while working offline in the Unsent Messages folder - under Local Folders. When you reconnect, choose Send Unsent Messages from the - File menu to send all your saved messages at once. To have &brandShortName; - Mail & Newsgroups automatically send your unsent messages when you - reconnect, use the Preferences command on the - &brandShortName; Edit - menu to change your offline - preferences.

- -

[Return to beginning of section]

- -

Downloading - Directory Entries for Offline Use

- -

You can download (replicate) the entries in a directory server to your - computer so that they are available when you work offline. Once you've - downloaded directory entries, you can use the same procedure to update your - local copy of the entries with the latest entries on the directory - server.

- -

To download or update an address book LDAP directory for offline use:

- -
    -
  1. Make sure you're online.
  2. -
  3. Open the Window menu, and choose Address Book.
  4. -
  5. In the Address Book window, select the directory that you want to - download (replicate).
  6. -
  7. Click Properties in the Address Book toolbar. The Directory Server - Properties dialog box appears.
  8. -
  9. Click the Offline tab.
  10. -
  11. Click Download Now to start copying the entries to your computer.
  12. -
  13. If prompted, enter your network user name and password, and click OK to - start the download. - -

    Depending on the number of directory entries, the download process may - take a while, so please be patient.

    -
  14. -
- -

After the download finishes, you can work offline and search the directory - or use it for address autocompletion when composing messages. After - you've been using your local copy of the directory for a while, you may - wish to update it to get the latest entries from the directory server. To - update your local copy, use the procedure described above.

- -

[Return to beginning of section]

- -

Setting Up Your Accounts - for Working Offline

- -

To set up one or more accounts for working offline, you use the Offline and - Disk Space preferences in the Mail & Newsgroups Account Settings dialog - box. Once set, you don't need to change these preferences each time you - want to work offline. The offline and disk space preferences you can set for - an account depend on the type of account (IMAP, POP, or Newsgroup).

- -

Here's a summary of the steps you will follow to set up your accounts - for offline use:

- -
    -
  1. For each account that you want to work with while offline, use the Mail - & Newsgroups Account Settings dialog box to set the Offline & Disk - Space preferences for that account. You must select the items (folders and - newsgroups) that you want to download for offline use. See - Selecting Items for Offline - Viewing for more information. - -

    Once set, you don't need to change these settings. See the sections - below for information on setting offline and disk space preferences for - IMAP, - POP, and - Newsgroup - accounts.

    - -

    Tip: To set the Offline & Disk Space preferences - for the current account, open the File menu, choose Offline, and then - choose Offline Settings.

    -
  2. -
  3. Open the File menu, choose Offline, and then choose Download/Sync Now - from the submenu.
  4. -
  5. Select the type of messages (mail or newsgroup or both) that you want to - download. - -

    Important: You must select at least one category (mail - messages or newsgroup messages) in order for the download to work.

    -
  6. -
  7. Select Work offline once download and/or sync is complete.
  8. -
  9. Click OK to download the selected items and then go offline. See - Downloading and - Synchronizing Your Messages for more information.
  10. -
- -

For subsequent offline sessions, you can skip step 1.

- -

[Return to beginning of section]

- -

Selecting Items for Offline - Viewing

- -

Before you can read mail and newsgroup messages while offline, you must - first select them for downloading. You can set up an entire account for - offline use. You can also choose which folders and newsgroups that you - want to use offline.

- -

Note: Keep in mind that selecting more items may increase - download time and disk space used.

- -

To select accounts, folders, and newsgroups for offline viewing, begin from - the Mail window:

- -
    -
  1. Open the Edit menu, choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Choose the Offline & Disk Space category for the account you want to - change.
  4. -
  5. Click Select. You see your IMAP accounts, mail folders, and subscribed - newsgroups. - -

    Note: You see only the newsgroups and folders that - you've already subscribed - to. POP accounts and local mail folders don't appear in the - list.

    -
  6. -
  7. Select the items (folders, newsgroups) that you want to make available - for offline use.
  8. -
  9. Click OK.
  10. -
- -

Once set, you don't need to change these settings each time you want to - go offline. However, if you do want to change them, you can easily do so - before going offline, since the same Select button is available when using - the Download and - Sync command.

- -

[Return to beginning of section]

- -

Downloading and - Synchronizing Your Messages

- -

If you have already selected mail folders and newsgroups for offline use, - you are now ready to download and synchronize them. If you haven't yet - selected items to download, you can choose them before you go offline.

- -

If you are not already viewing the Download/Sync Now dialog box, follow - these steps:

- -

To download and synchronize your messages, begin from the Mail - window:

- -
    -
  1. Open the File menu, choose Offline, and then choose Download/Sync - Now.
  2. -
  3. Select the categories (mail messages or newsgroup messages) that you want - to download. - -

    Important: You must select at least one category (Mail - messages, Newsgroup messages) in order for the download to work. If the - checkboxes are disabled, it means that you haven't yet selected - items to download. Use the Select button to select items to download.

    -
  4. -
  5. To send messages in your Unsent Messages folder before going offline, - check Send Unsent Messages.
  6. -
  7. To go offline immediately after &brandShortName; Mail & Newsgroups - finishes downloading, select Work offline once download and/or sync is - complete.
  8. -
  9. To set or change the items to download, click Select. See - Selecting Items for Offline - Viewing for more information. You can skip this step if you've - already selected items for download.
  10. -
  11. Click OK. &brandShortName; Mail & Newsgroups begins downloading the - selected items.
  12. -
- -

If you chose to work offline once the download completes, then - &brandShortName; Mail & Newsgroups immediately switches to offline mode. - Otherwise, when you are ready to go offline, click the Online/Offline - indicator in the lower right corner of - the Mail window to go offline.

- -

[Return to beginning of section]

- -

Working Offline and - Reconnecting Later

- -

To work offline and reconnect later, begin from the Mail window.

- -

When you are ready to work offline:

- -
    -
  1. Click the online/offline indicator - in the lower-right corner of the Mail window. Mail & Newsgroups prompts - you to download messages, if you want, before going offline.
  2. -
  3. Click Download to download messages before going offline. If you want to - work offline without downloading messages, click Don't Download.
  4. -
- -

Note: Message headers that have been downloaded for reading - offline display a darker gray envelope or newsgroup icon.

- -

Tip: To set &brandShortName; Mail & Newsgroups' - download behavior when going offline, open the - &brandShortName; Edit - menu, choose Preferences, and then click the Offline & Disk Space - category. You can choose to have &brandShortName; Mail & Newsgroups - prompt you to download messages when going offline, to automatically - download messages, or to not download any messages.

- -

To reconnect and synchronize your messages:

- -
    -
  1. Click the online/offline indicator in the lower-right corner of any &brandShortName; window.
  2. -
  3. Open the File menu, choose Offline, and then choose Download/Sync - Now.
  4. -
- -

&brandShortName; Mail & Newsgroups synchronizes your messages with the - server by replicating any changes you made while working offline.

- -

Tip: To set &brandShortName; Mail & Newsgroups' - behavior when going online, open the - &brandShortName; Edit - menu, choose Preferences, and then choose the Offline & Disk Space - category. You can choose to have &brandShortName; Mail & Newsgroups - prompt you to send unsent messages, to automatically send unsent messages, - or to not send unsent messages.

- -

[Return to beginning of section]

- -

Mail & Newsgroups Account - Settings

- -

This section describes the settings in the Mail & Newsgroups Account - Settings dialog box. Unlike the Preferences dialog box, which applies - settings to all accounts, the Mail & Newsgroups Account Settings dialog - box lets you specify settings on a per-account basis.

- -

If you are not currently viewing the Mail & Newsgroups Account Settings - dialog box, follow these steps:

- -
    -
  1. Begin from the Mail window.
  2. -
  3. Open the Edit menu and choose Mail & Newsgroups Account - Settings.
  4. -
  5. Select the name of the account whose settings you want to view or - change.
  6. -
- -
In this section: - -
- -

Mail & Newsgroups Account Settings - Account - Settings

- -

This section describes how to view or change your Account Settings, such as - your user name, reply-to address, and signature file. If you are not already - viewing the Account Settings, begin from the Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Select the name of the account to display the Account Settings - panel.
  4. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Account Settings - Server - Settings

- -

&brandShortName; Mail & Newsgroups can work with two types of mail - servers: IMAP and POP. If you are not sure which server type your Internet - service provider supports, ask your service provider. If your Internet - service provider supports both, the following descriptions may help you - choose which one to use.

- -
In this section: - -
- -

[Return to beginning of - section]

- -

About Internet Message Access - Protocol (IMAP)

- -

Advantages: Your messages and any changes to them stay on - your server, saving local disk space. Also, you always have access to an - updated mailbox, and you can get your mail from multiple locations. - Performance on a modem is faster, since you initially download message - headers only.

- -

Disadvantages: Not all ISPs support IMAP.

- -

[Return to beginning of - section]

- -

About Post Office Protocol (POP)

- -

Advantages: Your messages are downloaded to your local - computer all at once, but you can also specify whether to keep copies of the - messages on the server and delete messages on the server when they are - deleted locally. Most ISPs currently support POP.

- -

Disadvantages: If you use more than one computer, messages - might reside on one or the other, but not both. POP doesn't work as well - as IMAP over a slow link connection. Also, you can't access all mail - folders from multiple locations.

- -

Note that more recent POP servers have features that allow retrieving only - the headers instead of the full message, like IMAP allows. Using these - features allows performance with POP to be nearly as fast as with IMAP.

- -

[Return to beginning of - section]

- -

IMAP Server Settings

- -

If you are not already viewing the IMAP server settings, begin from the Mail - window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Select the account name and click the Server Settings category. (If you - chose an IMAP server when you set up this account, you see your IMAP server - settings.)
  4. -
- - - -

Advanced IMAP Server Settings

- -

In most cases, advanced IMAP server settings are automatically supplied by - the server. If you are unsure about the settings for this dialog box, - contact your ISP or system administrator.

- -

If you are not already viewing the advanced IMAP server settings, begin - from the Mail window.

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Select the account name and click the Server Settings category.
  4. -
  5. If the mail server type is an IMAP server, you can click Advanced to set - additional IMAP options, such as: - -
  6. -
- -

For more information, see - Adding and Removing LDAP - Directories.

- -

[Return to beginning of - section]

- -

POP Server Settings

- -

If you are not already viewing the POP server settings, begin from the Mail - window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Select the account name and click the Server Settings category name. (If - you chose a POP server when you set up this account, you see your POP - server settings.)
  4. -
- - - -

[Return to beginning of - section]

- -

News Server Settings

- -

This section describes how to change news server settings. If you are not - already viewing news server settings, begin from the Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Select the account name and click the Server Settings category. (If you - chose a newsgroup server when you set up this account, you see your - newsgroup server settings.)
  4. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Account Settings - Copies - & Folders

- -

This section describes the settings for sending automatic copies, and for - storing copies of outgoing messages, message drafts, and message - templates.

- -

By default, &brandShortName; Mail & Newsgroups stores copies of your - outgoing messages in the Sent folder for the current account. - &brandShortName; Mail & Newsgroups also stores message drafts in the - Drafts folder and message templates in the Templates folder for the - current account.

- -

If you are not already viewing the settings for Copies & Folders, begin - from the Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Select the account, and click Copies & Folders. You see the Copies - & Folders panel.
  4. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Account Settings - Composition & - Addressing

- -

You use Composition settings to choose how to format text and to handle - replies.

- - - -

You use Addressing settings to override the global LDAP server settings - specified for all address books in the - Preferences dialog box. LDAP server settings affect the behavior of - address autocompletion, and you can - change these settings for each account if necessary.

- -

Address autocompletion uses your address books to find matching entries when - you type email addresses in the addressing area of the Compose window.

- -

If you are not already viewing the Addressing settings, begin from the Mail - window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Select the account and click the Composition & Addressing - category.
  4. -
- - - -

The directory you select will also be searched for matching certificates - when you attempt to send an encrypted message to one or more recipients for - whom you don't have certificates on file.

- -

[Return to beginning of - section]

- -

Mail & Newsgroups Account Settings - - Offline & Disk Space

- -

Offline & Disk Space settings let you conserve disk space or set up an - account so that you can use it while offline (disconnected from the - Internet). The settings available depend on the mail server type (IMAP, POP, - or News) associated with the account.

- -
- -
- -

[Return to beginning of - section]

- -

Offline and Disk Space Settings - (IMAP)

- -

If you are not already viewing the offline and disk space preferences for an - IMAP account, begin from the Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Choose the Offline & Disk Space category for an IMAP account.
  4. -
- - - -

[Return to beginning of - section]

- -

Disk Space Settings (POP)

- -

Messages from POP accounts are fully downloaded to your local machine unless - you have enabled the Fetch headers only setting. This section - describes how you can save disk space for a POP account. If your account has - the Fetch headers only setting enabled, then these Disk Space - preferences are ignored. If you are not already viewing the Disk Space - preferences for a POP account, follow these steps:

- -

Begin from the Mail window.

- -
    -
  1. Open the Edit menu, choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Click the Disk Space category for a POP account.
  4. -
- - - -

[Return to beginning of - section]

- -

Offline and Disk Space Settings - (News)

- -

If you are not already viewing the offline and disk space settings for a - News account, begin from the Mail window:

- -
    -
  1. Open the Edit menu, and choose Mail & Newsgroups Account Settings. - You see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Choose the Offline & Disk Space category for a News account.
  4. -
- - - -

The following settings help to save disk space and download time. Specify - which messages you don't want to download locally:

- - - -

&brandShortName; can automatically delete newsgroup messages for you. You - can configure this process with the options listed below - Keep:

- - - -

With the last two settings you can further constrain the three options to - delete messages automatically. This is especially useful in combination with - the option to keep all messages.

- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Account Settings - Junk - Settings

- -

This section describes how to use the account junk settings. If - you are not currently viewing the Junk Settings, follow these steps:

- -
    -
  1. Open the Edit menu, and choose Mail & Newsgroups Account Settings. - You see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Click the Junk Settings category for your mail account.
  4. -
- -

You use the Junk Settings panel to define your account-specific settings - for the adaptive mail filter. Global junk settings are changed under - Mail & Newsgroups Preferences - - Junk Mail.

- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Account Settings - Return - Receipts

- -

This section describes how to use the Return Receipts account settings. If - you are not currently viewing the Return Receipts settings, follow these - steps:

- -
    -
  1. Open the Edit menu, and choose Mail & Newsgroups Account Settings. - You see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Click the Return Receipts category for your mail account.
  4. -
- -

You use the Return Receipts settings to define return receipt settings for - outgoing messages from this mail account. You also use the Return Receipt - settings to specify how to manage requests you receive for return receipts. - These settings override global return receipt preferences you specified using - Mail & Newsgroups Preferences - - Return Receipts.

- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Account Settings - Security

- -

This section describes how to configure the Mail & Newsgroup Account - Settings that control mail message security. Before you do so, however, you - must obtain one or more mail certificates. For details, see - Signing & Encrypting Messages.

- -

If you are not already viewing the Security settings for your mail account, - begin from the Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account - Settings.
  2. -
  3. Click Security under the name of the mail account whose security settings - you want to configure.
  4. -
- -
In this section: - -
- -

About Certificates

- -

The main purpose of the Security panel in Mail & Newsgroup Account - Settings is to select two certificates:

- - - -

Depending on the policies of the - certificate authority (CA) - that issues your certificate(s), you can use one certificate for both - purposes or two different certificates. Even if you use just one, you must - specify it twice, once for digital signing and once for encryption.

- -

The certificates you select here are included with every signed message you - send. These certificates allow your recipients to verify your digital - signature and to encrypt messages that they send to you.

- -

Digital Signing

- -

You use the Digital Signing area in the Security - panel to specify how you want to sign your email messages:

- - - -

Regardless of whether the Digitally sign messages checkbox is - selected here, you can change your mind before you send an individual - message.

- -

To change the digital signature setting for a message you are writing in - the Compose window, click the arrow below the Security icon near the top of - the window and select or deselect Digital Sign This Message. For - details, see - Signing - & Encrypting a New Message.

- -

Encryption

- -

You use the Encryption area in the Security panel to - specify how you routinely want to use encryption when sending your - messages:

- - - -

Regardless of which encryption option you select, you can change your mind - before you send an individual message.

- -

To change the encryption setting for a message you are writing in the - Compose window, click the arrow below the Security icon near the top of the - window and choose the encryption setting you want. For details, see - Signing - & Encrypting a New Message.

- -

[Return to beginning of - section]

- -

Mail & Newsgroups Account Settings - Local - Folders

- -

Local Folders is the account where &brandShortName; Mail & Newsgroups - saves any messages that you send while working offline. Messages you send - while working offline are saved in the Unsent Messages folder under Local - Folders. Any folders you create under the Local Folders account reside on - your hard disk, so Local Folders is a good place to save messages that you - want to keep.

- -

If you are not already viewing the Local Folders settings, begin from the - Mail window:

- -
    -
  1. Open the Edit menu and choose Mail & Newsgroups Account Settings. You - see the Mail & Newsgroups Account Settings dialog box.
  2. -
  3. Select the Local Folders category.
  4. -
- - - -

[Return to beginning - of section]

- -

Mail & Newsgroups Account Settings - Outgoing - Server (SMTP)

- -

The outgoing server will transport your outgoing mail to the intended - recipients.

- -

If you are not already viewing the Outgoing Server (SMTP) settings, begin - from the Mail window:

- -
    -
  1. Click on any Mail window.
  2. -
  3. From the Edit menu, choose Mail & Newsgroup Account Settings.
  4. -
  5. Select Outgoing Server (SMTP) and set up as follows (If you are not sure - which option to choose, check with your ISP or system administrator):
  6. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroup Preferences

- -

The sections listed below describe the Mail & Newsgroups preferences - that apply to all your mail and newsgroup accounts. To see these - preferences:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Double-click Mail & Newsgroups to expand the list.
  4. -
- -
In this section: - -
- -

Mail & Newsgroups Preferences - Mail & - Newsgroups

- -

This section describes the main Mail & Newsgroups preferences. If you - are not already viewing the Mail & Newsgroups main preferences, follow - these steps:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences. You see the - Preferences dialog box.
  2. -
  3. Click the Mail & Newsgroups category.
  4. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Preferences - Message - Display

- -

Message Display preferences allow you to choose how messages are - displayed (for example, font style and color) in all accounts. If you are not - already viewing the Message Display settings, follow these steps:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences. You see the - Preferences dialog box.
  2. -
  3. Under the Mail & Newsgroups category, click Message Display. (If no - subcategories are visible, double-click Mail & Newsgroups to expand - the list.)
  4. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Preferences - Notifications

- -

Notification preferences allow you to select different methods for informing - you on arrival of a new message. So you don't have to always look in the - folders.

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, click Notifications. (If no - subcategories are visible, double-click Mail & Newsgroups to expand - the list.)
  4. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Preferences - Composition

- -

Composition preferences affect how you create messages (for example, - forwarding options and address autocompletion) in all accounts. If you are - not already viewing the Composition settings, follow these steps:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, click Composition. (If no - subcategories are visible, double-click Mail & Newsgroups to expand - the list.)
  4. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Preferences - Send Format

- -

Send Format preferences allow you to specify how you want to format your - outgoing messages. If you are not already viewing the Send Format settings, - follow these steps:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences. You see the - Preferences dialog box.
  2. -
  3. Under the Mail & Newsgroups category, click Send Format. (If no - subcategories are visible, double-click Mail & Newsgroups to expand - the list.)
  4. -
- - - -

For example, if you typically send mail to multiple recipients that have the - same domain name (for example, your colleagues all have email addresses that - end in netscape.net), and you know that this domain name is capable of - displaying HTML messages, then you can add the netscape.net domain to the - list of HTML Domains so that Mail & Newsgroups will automatically send - messages in HTML format to these recipients.

- -

Similarly, if you typically send mail to recipients at a domain that you - know can only receive Plain Text messages, you can add that domain name to - the list of Plain Text domains, so that Mail & Newsgroups automatically - sends messages to that domain in plain-text format.

- -

Note: If you regularly compose HTML (formatted) mail - messages, keep in mind that sometimes not all recipients use mail programs - that can display HTML formatting properly. Send Format preferences allow you - to specify how you want to format messages that go to recipients who cannot - display HTML-formatted mail. You can convert messages to plain text, format - them only as HTML, or format them as both HTML and plain text. These - preferences apply to all your mail accounts, but only to mail messages and - not to newsgroup messages.

- -

Whenever you add a person or address card to your address book, you can - specify whether that addressee can receive HTML-formatted messages. However, - when this information is unknown, you can set Send Format preferences for how - Mail & Newsgroups formats these messages.

- -

[Return to beginning of - section]

- -

Mail & Newsgroups Preferences - - Addressing

- -

Addressing preferences allow you to control the settings for - &brandShortName; Mail & Newsgroups address books (for example, email - address collection and address autocompletion). If you are not already - viewing the Addressing settings, follow these steps:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences. You see the - Preferences dialog box.
  2. -
  3. Under the Mail & Newsgroups category, select Addressing. (If no - subcategories are visible, double-click Mail & Newsgroups to expand - the list.)
  4. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Preferences - - Junk Mail

- -

This section describes how to use the Junk Mail preferences panel. If - you are not currently viewing the Junk Mail panel, follow these steps:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, select Junk Mail. (If no - subcategories are visible, double-click Mail & Newsgroups to expand the - list.)
  4. -
- - - -

[Return to beginning of - section]

- - -

Mail & Newsgroups Preferences - Tags

- -

This section describes how to use the Tags preferences panel. You use the - Tags preferences to define the tag text, colors and order for message tags. - If you are not currently viewing the panel, follow these steps:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, select Tags. (If no options - are visible, double-click the Mail & Newsgroups category to expand the - list.)
  4. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Preferences - Return - Receipts

- -

This section describes how to use the Return Receipts preferences panel. If - you are not currently viewing the Return Receipts panel, follow these - steps:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, select Return Receipts. (If no - subcategories are visible, double-click Mail & Newsgroups to expand the - list.)
  4. -
- -

You use the Return Receipts preferences to define return receipt settings - for outgoing messages from all your mail accounts. You also use the Return - Receipt preferences to specify how to manage requests you receive for return - receipts.

- - - -

To override these global preferences for individual accounts, see - Mail & Newsgroups Account Settings - Return - Receipts.

- -

[Return to beginning of - section]

- -

Mail & Newsgroups Preferences - Character - Encoding

- -

Character encoding preferences allow you to choose how messages are encoded - when being displayed or created in all accounts. If you are not already - viewing the Character Encoding settings, follow these steps:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences. You see the - Preferences dialog box.
  2. -
  3. Under the Mail & Newsgroups category, click Character Encoding. (If - no subcategories are visible, double-click Mail & Newsgroups to expand - the list.)
  4. -
- - - -

[Return to beginning of - section]

- -

Mail & Newsgroups Preferences - - Offline & Disk Space

- -

This section describes how to use the Offline & Disk Space preferences - panel. If you are not currently viewing the panel, follow these steps:

- -
    -
  1. Open the &brandShortName; - Edit menu and choose Preferences.
  2. -
  3. Under the Mail & Newsgroups category, select Offline & Disk - Space. (If no subcategories are visible, double-click Mail & - Newsgroups to expand the list.).
  4. -
- -

The Offline & Disk Space preferences allow you to set preferences for - working offline, going online, and disk space.

- - - -

See Working Offline for information on - working offline.

- -

[Return to beginning of - section]

- -

Copyright © 2003-2006 The Mozilla Foundation.

- - - diff --git a/mailnews/base/prefs/resources/content/mailPrefsOverlay.xul b/mailnews/base/prefs/resources/content/mailPrefsOverlay.xul index f8f881d9bc2..52b6787e220 100644 --- a/mailnews/base/prefs/resources/content/mailPrefsOverlay.xul +++ b/mailnews/base/prefs/resources/content/mailPrefsOverlay.xul @@ -91,7 +91,7 @@ - + diff --git a/mailnews/base/prefs/resources/content/pref-labels.js b/mailnews/base/prefs/resources/content/pref-labels.js index 4e4de39cef0..166271e3f51 100644 --- a/mailnews/base/prefs/resources/content/pref-labels.js +++ b/mailnews/base/prefs/resources/content/pref-labels.js @@ -11,16 +11,13 @@ * for the specific language governing rights and limitations under the * License. * - * The Original Code is Mozilla Communicator. + * The Original Code is SeaMonkey Internet Suite Code. * - * The Initial Developer of the Original Code is - * Netscape Communications Corp. - * Portions created by the Initial Developer are Copyright (C) 2001 + * The Initial Developer of the Original Code is the SeaMonkey project. + * Portions created by the Initial Developer are Copyright (C) 2006 * the Initial Developer. All Rights Reserved. * * Contributor(s): - * Sean Su - * Ian Neal * Karsten Düsterloh * * Alternatively, the contents of this file may be used under the terms of @@ -37,105 +34,366 @@ * * ***** END LICENSE BLOCK ***** */ -var gTagListBox = null; +// Each tag entry in our list looks like this, where is tag's unique key: +// +// +// ) type='button'/> +// +// +const TAGPANEL_URI = 'chrome://messenger/content/pref-labels.xul'; +const TAGLIST_ID = 'tagList'; // UI element +const ACTIVE_TAGS_ID = TAGLIST_ID + '.active'; // wsm element +const DELETED_TAGS_ID = TAGLIST_ID + '.deleted'; // wsm element + +var gTagList = null; // tagList root element +var gAddButton = null; +var gDeleteButton = null; +var gRaiseButton = null; +var gLowerButton = null; + +var gDeletedTags = null; // tags to be deleted by the tagService + +// init global stuff before the wsm is used +function InitTagPanel() +{ + gTagList = document.getElementById(TAGLIST_ID); + gAddButton = document.getElementById('addTagButton'); + gDeleteButton = document.getElementById('deleteTagButton'); + gRaiseButton = document.getElementById('raiseTagButton'); + gLowerButton = document.getElementById('lowerTagButton'); + UpdateButtonStates(); + parent.initPanel(TAGPANEL_URI); +} function Startup() { - gTagListBox = document.getElementById('tagList'); - BuildTagList(); + parent.hPrefWindow.registerOKCallbackFunc(OnOK); } -function GetCSSValue(aElement, aProperty) +// store pref values in the wsm +function GetFields(aPageData) { - return getComputedStyle(aElement, null).getPropertyCSSValue(aProperty).cssText; + // collect the tag definitions from the UI and store them in the wsm + var tags = []; + for (var entry = gTagList.firstChild; entry; entry = entry.nextSibling) + if (entry.localName == 'listitem') + { + // update taginfo with current values from textbox and colorpicker + var taginfo = entry.taginfo; + taginfo.tag = entry.firstChild.firstChild.value; + taginfo.color = entry.lastChild.lastChild.color; + tags.push(taginfo); + } + aPageData[ACTIVE_TAGS_ID] = tags; + + // store the list of tags to be deleted in the OKHandler + aPageData[DELETED_TAGS_ID] = gDeletedTags; + + return aPageData; } -// appends the tag to the tag list box -function AppendTagItem(aTagName, aKey, aColor) +// read pref values stored in the wsm +function SetFields(aPageData) { - var item = gTagListBox.appendItem(aTagName, aKey); - item.style.color = aColor; - var listBackColor = GetCSSValue(gTagListBox, "background-color"); - var itemForeColor = GetCSSValue(item, "color"); - if (listBackColor == itemForeColor) - item.style.color = GetCSSValue(gTagListBox, "color"); - return item; -} - -function BuildTagList() -{ - var tagService = Components.classes["@mozilla.org/messenger/tagservice;1"] - .getService(Components.interfaces.nsIMsgTagService); - var allTags = tagService.tagEnumerator; - var allKeys = tagService.keyEnumerator; - while (allTags.hasMore()) + var i, tags; + // If the wsm has no tag data yet, get the list from the tag service. + if (!(ACTIVE_TAGS_ID in aPageData)) { - var key = allKeys.getNext(); - AppendTagItem(allTags.getNext(), key, tagService.getColorForKey(key)); + var tagService = Components.classes["@mozilla.org/messenger/tagservice;1"] + .getService(Components.interfaces.nsIMsgTagService); + var tagArray = tagService.getAllTags({}); + tags = aPageData[ACTIVE_TAGS_ID] = []; + for (i = 0; i < tagArray.length; ++i) + { + // The nsMsgTag items are readonly, but we may need to change them. + // And we don't care for the current ordinal strings, we'll create new + // ones in the OKHandler if necessary + var t = tagArray[i]; + tags.push({tag: t.tag, key: t.key, color: t.color}); + } } + + // now create the dynamic elements + tags = aPageData[ACTIVE_TAGS_ID]; + + // Listitems we append to the "end" of the listbox and would be rendered + // outside the clipping area don't get their text and color set! + // (See also 354065.) + // So we stuff them in bottom-up... :-| + var beforeTag = null; + for (i = tags.length - 1; i >= 0; --i) + beforeTag = AppendTagEntry(tags[i], beforeTag); + + // grab the list of tags to be deleted in the OKHandler + gDeletedTags = (DELETED_TAGS_ID in aPageData) ? aPageData[DELETED_TAGS_ID] : {}; +} + +// set text and color of the listitem +function UpdateTagEntry(aTagInfo, aEntry) +{ + aEntry.firstChild.firstChild.value = aTagInfo.tag; + aEntry.lastChild.lastChild.color = aTagInfo.color; +} + +function AppendTagEntry(aTagInfo, aRefChild) +{ + // Creating a colorpicker dynamically in an onload handler is really sucky. + // You MUST first set its type attribute (to select the correct binding), then + // add the element to the DOM (to bind the binding) and finally set the color + // property(!) afterwards. Try in any other order and fail... :-( + var key = aTagInfo.key; + + var tagCell = document.createElement('listcell'); + var textbox = document.createElement('textbox'); + tagCell.appendChild(textbox); + + var colorCell = document.createElement('listcell'); + var colorpicker = document.createElement('colorpicker'); + colorpicker.setAttribute('type', 'button'); + colorCell.appendChild(colorpicker); + + var entry = document.createElement('listitem'); + entry.addEventListener('focus', OnFocus, true); + entry.setAttribute('allowevents', 'true'); // activate textbox and colorpicker + entry.taginfo = aTagInfo; + entry.appendChild(tagCell); + entry.appendChild(colorCell); + + gTagList.insertBefore(entry, aRefChild); + UpdateTagEntry(aTagInfo, entry); + return entry; +} + +function OnFocus(aEvent) +{ + // walk up until we find the listitem + var entry = aEvent.target; + while (entry.localName != 'listitem') + entry = entry.parentNode; + gTagList.selectedItem = entry; + UpdateButtonStates(); +} + +function FocusTagEntry(aEntry) +{ + // focus the entry's textbox + gTagList.ensureElementIsVisible(aEntry); + aEntry.firstChild.firstChild.focus(); +} + +function UpdateButtonStates() +{ + var entry = gTagList.selectedItem; + // disable Delete if no selection + gDeleteButton.disabled = !entry; + // disable Raise if no selection or first entry + gRaiseButton.disabled = !entry || !gTagList.getPreviousItem(entry, 1); + // disable Lower if no selection or last entry + gLowerButton.disabled = !entry || !gTagList.getNextItem(entry, 1); +} + +function DisambiguateTag(aTag, aTagList) +{ + if (aTag in aTagList) + { + var suffix = 2; + while (aTag + ' ' + suffix in aTagList) + ++suffix; + aTag += ' ' + suffix; + } + return aTag; +} + +function AddTag() +{ + // Add a new tag to the UI here. It will be only be written to the + // preference system only if the OKHandler is executed! + + // create unique tag name + var dupeList = {}; // indexed by tag + for (var entry = gTagList.firstChild; entry; entry = entry.nextSibling) + if (entry.localName == 'listitem') + dupeList[entry.firstChild.firstChild.value] = true; + var tag = DisambiguateTag(gAddButton.getAttribute('defaulttagname'), dupeList); + + // create new tag list entry + var tagInfo = {tag: tag, key: '', color: '', ordinal: ''}; + var refChild = gTagList.getNextItem(gTagList.selectedItem, 1); + var newEntry = AppendTagEntry(tagInfo, refChild); + FocusTagEntry(newEntry); } function DeleteTag() { - var tagItemToRemove = gTagListBox.getSelectedItem(); - var index = gTagListBox.selectedIndex; - if (index >= 0) - { - var itemToRemove = gTagListBox.getItemAtIndex(index); - var tagService = Components.classes["@mozilla.org/messenger/tagservice;1"] - .getService(Components.interfaces.nsIMsgTagService); - tagService.deleteKey(itemToRemove.value); - gTagListBox.removeItemAt(index); - var numItemsInListBox = gTagListBox.getRowCount(); - gTagListBox.selectedIndex = index < numItemsInListBox ? index : numItemsInListBox - 1; - } + // Delete the selected tag from the UI here. If it was added during this + // preference dialog session, we can drop it at once; if it was read from + // the preferences system, we need to remember killing it in the OKHandler. + var entry = gTagList.selectedItem; + var key = entry.taginfo.key; + if (key) + gDeletedTags[key] = true; // dummy value + // after removing, move focus to next entry, if it exist, else try previous + var newFocusItem = gTagList.getNextItem(entry, 1) || + gTagList.getPreviousItem(entry, 1); + gTagList.removeItemAt(gTagList.getIndexOfItem(entry)); + if (newFocusItem) + FocusTagEntry(newFocusItem); + else + UpdateButtonStates(); } -function AddTag() -{ - var args = {result: "", okCallback: AddTagCallback}; - var dialog = window.openDialog("chrome://messenger/content/newTagDialog.xul", - "", - "chrome,titlebar,modal", - args); -} - -function AddTagCallback(aName, aColor) +function MoveTag(aMoveUp) { - var tagService = Components.classes["@mozilla.org/messenger/tagservice;1"] - .getService(Components.interfaces.nsIMsgTagService); - tagService.addTag(aName, aColor); - - var item = AppendTagItem(aName, tagService.getKeyForTag(aName), aColor); - var tagListBox = document.getElementById('tagList'); - tagListBox.ensureElementIsVisible(item); - tagListBox.selectItem(item); - tagListBox.focus(); + // Move the selected tag one position up or down in the tagList's child order. + // This reordering may require changing ordinal strings, which will happen + // when we write tag data to the preferences system in the OKHandler. + var entry = gTagList.selectedItem; + var successor = aMoveUp ? gTagList.getPreviousItem(entry, 1) + : gTagList.getNextItem(entry, 2); + entry.parentNode.insertBefore(entry, successor); + UpdateTagEntry(entry.taginfo, entry); + FocusTagEntry(entry); } -function RestoreDefaults() +function Restore() { - var tagService = Components.classes["@mozilla.org/messenger/tagservice;1"] - .getService(Components.interfaces.nsIMsgTagService); - // remove all existing labels - var allKeys = tagService.keyEnumerator; - while (allKeys.hasMore()) + // clear pref panel tag list + // Remember any known keys for deletion in the OKHandler. + while (gTagList.getRowCount()) { - tagService.deleteKey(allKeys.getNext()); - gTagListBox.removeItemAt(0); + var key = gTagList.removeItemAt(0).taginfo.key; + if (key) + gDeletedTags[key] = true; // dummy value } - // add default items + // add default items (no ordinal strings for those) var prefService = Components.classes["@mozilla.org/preferences-service;1"] .getService(Components.interfaces.nsIPrefService); var prefDescription = prefService.getDefaultBranch("mailnews.labels.description."); var prefColor = prefService.getDefaultBranch("mailnews.labels.color."); + const kLocalizedString = Components.interfaces.nsIPrefLocalizedString; for (var i = 1; i <= 5; ++i) { - // mimic nsMsgTagService::MigrateLabelsToTags() and create default tags from - // the former label defaults - var tag = prefDescription.getComplexValue(i, Components.interfaces.nsIPrefLocalizedString).data; + // create default tags from the former label defaults + var key = "$label" + i; + var tag = prefDescription.getComplexValue(i, kLocalizedString).data; var color = prefColor.getCharPref(i); - tagService.addTagForKey("$label" + i, tag, color); + var tagInfo = {tag: tag, key: key, color: color}; + AppendTagEntry(tagInfo, null); } - BuildTagList(); + FocusTagEntry(gTagList.getItemAtIndex(0)); +} + +function OnOK() +{ + var i; + var tagService = Components.classes["@mozilla.org/messenger/tagservice;1"] + .getService(Components.interfaces.nsIMsgTagService); + // we may be called in another page's context, so get the stored data from the + // wsm the hard way + var pageData = parent.hPrefWindow.wsm.dataManager.pageData[TAGPANEL_URI]; + var activeTags = pageData[ACTIVE_TAGS_ID]; + var deletedTags = pageData[DELETED_TAGS_ID]; + + // remove all deleted tags from the preferences system + for (var key in deletedTags) + tagService.deleteKey(key); + + // count dupes so that we can eliminate them later + var dupeCounts = {}; // indexed by tag + for (i = 0; i < activeTags.length; ++i) + { + var tag = activeTags[i].tag; + if (tag in dupeCounts) + ++dupeCounts[tag]; + else + dupeCounts[tag] = 0; // no dupes found yet + } + + // Now write tags to the preferences system, create keys and ordinal strings. + // Manually set ordinal strings are NOT retained! + var lastTagInfo = null; + for (i = 0; i < activeTags.length; ++i) + { + var tagInfo = activeTags[i]; + if (tagInfo) + { + var dupeCount = dupeCounts[tagInfo.tag]; + if (dupeCount > 0) + { + // ignore the first dupe, but set mark for further processing + dupeCounts[tagInfo.tag] = -1; + } + else if (dupeCount < 0) + { + tagInfo.tag = DisambiguateTag(tagInfo.tag, dupeCounts); + dupeCounts[tagInfo.tag] = 0; // new tag name is unique + } + + if (!tagInfo.key) + { + // newly added tag, need to create a key and read it + tagService.addTag(tagInfo.tag, '', ''); + try + { + tagInfo.key = tagService.getKeyForTag(tagInfo.tag); + } + catch (e) {} + } + + if (tagInfo.key) + { + if (!lastTagInfo) + { + // the first tag list entry needs no ordinal string + lastTagInfo = tagInfo; + tagInfo.ordinal = ''; + } + else + { + // if tagInfo's key is lower than that of its predecessor, + // it needs an ordinal string + var lastOrdinal = lastTagInfo.ordinal || lastTagInfo.key; + if (lastOrdinal >= tagInfo.key) + { + // create new ordinal + var tail = lastOrdinal.length - 1; + if (('a' <= lastOrdinal[tail]) && (lastOrdinal[tail] < 'z')) + { + // increment last character + lastOrdinal = lastOrdinal.substr(0, tail) + + String.fromCharCode(lastOrdinal.charCodeAt(tail) + 1); + } + else + { + // just begin a new increment position + lastOrdinal += 'a'; + } + tagInfo.ordinal = lastOrdinal; + } + else + { + // no ordinal necessary + tagInfo.ordinal = ''; + } + } + + // Update the tag definition + try + { + tagService.addTagForKey(tagInfo.key, + tagInfo.tag, + tagInfo.color, + tagInfo.ordinal); + } + catch (e) + { + dump('Could not update tag:\n' + e); + } + lastTagInfo = tagInfo; + } // have key + } // have tagInfo + } // for all active tags } diff --git a/mailnews/base/prefs/resources/content/pref-labels.xul b/mailnews/base/prefs/resources/content/pref-labels.xul index 5fcc28130be..2bee51ef7f1 100644 --- a/mailnews/base/prefs/resources/content/pref-labels.xul +++ b/mailnews/base/prefs/resources/content/pref-labels.xul @@ -48,39 +48,62 @@ - &pref.tags.description; - + + + + + + + + + + + -