{docbook}
    <highlights>
        <itemizedlist>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Mail.Create_mail_account">Create a Mail account</link>
				</para>
				<para>
				Steps to create a mail account that connects to another mail POP3 or SMTP supported servers and ways to edit/delete your account as well further information about Incoming and Outcoming mail server settings.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Mail.Get_mail">Get mails</link>
				</para>
				<para>
					Steps to fetch messages from the remote mail servers and forward them via SMTP, so it can be read in <emphasis role="bold">Mail</emphasis>.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Mail.Mail_views">Mail views</link>
				</para>
				<para>
					Introduction to the different view modes in <emphasis role="bold">Mail</emphasis>.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Mail.Read_email">Read an email</link>
				</para>
				<para>
				Instructions on how to open an email and to perform other actions, such as downloading attachments, marking as read, staring messages, moving to folder, marking as spam, deleting messages.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="Compose_new_message">Compose a new message</link>
				</para>
				<para>
				Steps to compose a new message and to perform other actions: adding attachments, saving as draft, setting priority level, changing message signatures and message preferences.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Mail.Reply_to_message">Reply to a message</link>
				</para>
				<para>
				Steps and ways to reply to the sender only or to all recipients of the message.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Mail.Forward_message">Forward a message</link>
				</para>
				<para>
				Steps to re-send messages to other people.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Mail.Print_message">Print a message</link>
				</para>
				<para>
					Steps to take a hard copy of the message, provided that your device is connected to a printer, either directly or through a network connection.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Mail.Export_messages">Export a message</link>
				</para>
				<para>
					Steps to back up your messages, then import them into your another accounts.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Mail.Import_messages">Import a message</link>
				</para>
				<para>
				Steps to import a message from your device to your selected folder.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Mail.Categorize_messages_by_folders_tags_filters">Categorize messages by folders/tags/filters</link>
				</para>
				<para>
				Ways to manage message by using folders, tags or by creating a filter to categorize message.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="Search_messages">Search for messages</link>
				</para>
				<para>
				Introduction to 2 search modes (Quick and Advanced) supported by the <emphasis role="bold">Mail</emphasis> application, and ways to use them.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="Add_event">Add an event</link>
				</para>
				<para>
					Steps to invite your colleagues to join events. You can create events, invite them by sending message or make email notifications to receive reminders right in the <emphasis role="bold">Mail</emphasis> application.
                </para>
            </listitem>
			<listitem>
				<para>
					<link linkend="Manage_address_books_in_Mail">Manage Address Book in <emphasis role="bold">Mail</emphasis></link>
				</para>
				<para>
					Introduction to some actions related to managing contacts and address books in <emphasis role="bold">Mail</emphasis>, and steps to perform them, including: adding a new address book/contact, editing contact details and deleting a contact.
				</para>
			</listitem>
            <listitem>
                <para>
                   <link linkend="Mail_settings">Change <emphasis role="bold">Mail</emphasis> settings</link>
				</para>
				<para>
					Steps and details to change the <emphasis role="bold">Mail</emphasis> settings to your preferences, including basic information, options when <emphasis role="bold">Mail</emphasis> gets a "Return Receipt" request, the <emphasis role="bold">Mail</emphasis> layout, and delegation of your account to any registered user in the system.
                </para>
            </listitem>
        </itemizedlist>
    </highlights>
{docbook}

{docbook}
<note>
<para>
The <emphasis role="bold">Mail</emphasis> portlet and its services are deprecated. It remains fully supported for eXo customers, however it will not receive any enhancement and will be removed from the product scope in future.
</para>
</note>
{docbook}

{docbook}
<para>
<prompt>
    <emphasis role="bold">See also</emphasis>
</prompt>
</para>
{docbook}

* [Manage your calendar|#Platform_User_Guide.Collaboration.Manage_calendar]
* [Manage your contacts|#Platform_User_Guide.Collaboration.Communicate_with_Contacts.Manage_Contacts]
* [Chat with your contacts|#Platform_User_Guide.Collaboration.Communicate_with_Contacts.Chat]


h1. Create a Mail account {anchor:id="CSUser_guide.How_to_use_Mail.Create_mail_accountRoleNotInToc"}
To get mails from other mail services, you first need to create a mail account in the *Mail* application which connects to another mail POP3 or SMTP supported servers, such as Gmail, Yahoo! Mail, Hotmail, GMX, Cyrus, Exchange Server. The *Mail* application allows you to get mails from different mail services at one place.

{docbook}
<para>To create one mail account, you first need to click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/add_mail_acount_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/add_mail_acount_icon.png" format="PNG" scalefit="0" width="4mm"/>
            </imageobject>
          </inlinemediaobject>, then select <guilabel>Add Account</guilabel> from the drop-down menu to open the <guilabel>Create New Account</guilabel> form. In the <guilabel>Create New Account</guilabel> form, there are 5 steps with clear instructions at each step. After completing information at each step, you can:</para>
{docbook}

{docbook}
<itemizedlist>
          <listitem>
            <para>Click <guilabel>Next</guilabel> to go to the next step, or directly left-click any number box at the left bottom of the <guilabel>Create New Account</guilabel> form to go to your desired step.</para>
          </listitem>
</itemizedlist>
{docbook}

!images/Step_boxes.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
        <itemizedlist>
          <listitem>
            <para>Click <guilabel>Back</guilabel> to return to the previous step.</para>
          </listitem>
        </itemizedlist>
{docbook}

{docbook}
<note>
    <para>
    The asterisk (*) next to each field indicates the required field.
    </para>
</note>
{docbook}

*1.* Fill your account name and brief description in Step 1.

!images/Add_acc_step1.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Configure identification settings for your mail in Step 2.

!images/Add_acc_step2.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Field</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>Your Display Name</guilabel>
                </entry>
                <entry>The name to be displayed when you use the account. This name will be displayed with your email address when you compose a new message.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Email Address</guilabel>
                </entry>
                <entry>The email address corresponding to your created account. It must be in a valid format. (See more details about the <emphasis role="bold">Email Address</emphasis> format <link linkend="Create_New_Account_form_details">here</link>.)</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Reply-to Address</guilabel>
                </entry>
                <entry>The email address which receives all replies.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Signature</guilabel>
                </entry>
                <entry>The identification text which is automatically inserted at the bottom of your sending messages.</entry>
              </row>
            </tbody>
          </tgroup>
</informaltable>
{docbook}

*3.* Give the server information in Step 3.

!images/Add_acc_step3.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Field</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>Server type</guilabel>
                </entry>
                <entry>
                  <para>Type of the mail server. Select either of two types supported by your mail server: <informalexample>
                      <informalexample/>
                    </informalexample> - POP3 (Post Office Protocol - Version 3) which is a protocol to get emails from a remote server. This type is selected by default. <informalexample>
                      <informalexample/>
                    </informalexample> - IMAP (Internet Message Access Protocol) which retrieves emails from a remote server over a TCP/IP connection.</para>
                </entry>
              </row>
              <row>
                <entry>
                  <guilabel>Incoming Mail Server &amp; Outgoing Mail Server</guilabel>
                </entry>
                <entry>The Incoming Mail Server (POP3) and Outgoing Mail Server (SMTP) of your current email provider. Each email provider has different Incoming Mail Server and Outgoing Mail Server settings. By default, the value of this field is "pop.gmail.com" and "smtp.gmail.com" which are the settings for Gmail. For settings of other mail servers, you can find the information on their websites. See <link linkend="Incoming_outgoing_reference">More about Incoming &amp; Outgoing mail server settings</link> for more information.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Use Incoming SSL</guilabel>
                </entry>
                <entry>This option allows using SSL (Secure Sockets Layer) or not. SSL is a cryptographic protocol which provides secure communication on Internet, such as web browsing, email, Internet faxing. The Incoming SSL allows using SSL to check incoming emails.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Use Outgoing SSL</guilabel>
                </entry>
                <entry>This option is to use SSL to send mail in the <emphasis role="bold">Mail</emphasis> application.</entry>
              </row>
            </tbody>
          </tgroup>
</informaltable>
{docbook}

*4.* Configure another account properties in Step 4.

!images/Add_acc_step4.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*Details:*

{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Field</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>Username</guilabel>
                </entry>
                <entry>The email address which is used in the <emphasis role="bold">Mail</emphasis> application.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Password</guilabel>
                </entry>
                <entry>The password of your email address. It will be used to get your messages of the email address entered in the <guilabel>Username</guilabel> field.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Save Password</guilabel>
                </entry>
                <entry> Tick the checkbox to avoid entering your password again for each mail check.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Do not download all messages (IMAP only)</guilabel>
                </entry>
                <entry>Check this option if you do not want to download all messages.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Limit to Messages Arrived Since</guilabel>
                </entry>
                <entry>Select the time to limit the downloaded messages from the drop-down calendar.</entry>
              </row>
            </tbody>
          </tgroup>
 </informaltable>
{docbook}

*5.* Verify your inputted information in Step 5.

!images/Add_acc_step5.png|align="center" width="120mm" height="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<itemizedlist>
          <listitem>
            <para>Tick the <guilabel>Start Downloading Messages Now</guilabel> checkbox to get messages automatically right after your account is successfully created. </para>
          </listitem>
</itemizedlist>
{docbook}

{docbook}
<para>
 <emphasis role="bold">6.</emphasis> Click <guilabel>Finish</guilabel> to complete your registration.</para>
{docbook}

h2. Edit your account details {anchor:id="CSUser_guide.How_to_use_Mail.Create_mail_account.Edit_account"}
{docbook}
<para>To make changes on your account, simply click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/add_mail_acount_icon.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/add_mail_acount_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> in the left pane, then select <guilabel>Edit Account</guilabel> from the drop-down menu;</para>
{docbook}

Or, select !images/accounts_icon.png|width="15mm" fo:scalefit="1" html:scalefit="0"! on the *Toolbar*.

{docbook}
<para>The <guilabel>Edit Account</guilabel> form will appear, allowing you to change information in the <guilabel>Identity, Incoming, Outgoing</guilabel> and <guilabel>Fetch Options</guilabel> tabs.</para>
{docbook}

!images/Edit_account_form.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

h2. Delete your account {anchor:id="CSUser_guide.How_to_use_Mail.Create_mail_account.Delete_account}
If you use multiple accounts, you can delete any unused mail accounts via either of the following ways:

*The first way*

*1.* Select the account from the accounts list in the left pane.

!images/Select_mail_account.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
            <emphasis role="bold">2.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/add_mail_acount_icon.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/add_mail_acount_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> in the left pane and select <guilabel>Delete Account</guilabel> from the drop-down menu.</para>
{docbook}

!images/Delete_acc_form.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
            <emphasis role="bold">3.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/Delete_icon.png" format="PNG" scalefit="1" width="11"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/Delete_icon.png" format="PNG" scalefit="0" width="11"/>
              </imageobject>
            </inlinemediaobject> corresponding to the account, then click <guilabel>OK</guilabel> in the confirmation message to accept your deletion.</para>
{docbook}

*The second way*

{docbook}
<para>
  <emphasis role="bold">1.</emphasis> Open the <guilabel>Edit Account</guilabel> form as stated in <link linkend="CSUser_guide.How_to_use_Mail.Create_mail_account.Edit_account">Edit your account details</link>.</para>
{docbook}

*2.* Select the account you want to delete in the left pane. Your currently selected account is marked with !images/marked_account_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"!.

*3.* Click !images/delete_account_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to delete your marked account.

h2. More about Incoming & Outgoing mail server settings {anchor:id="Incoming_outgoing_reference"}

The following reference introduces some common Incoming and Outgoing Mail Server settings. Provided that you are aware of the server type and name, you can start creating your mail accounts quickly. If you do not see your mail service in this list, find these settings on the mail provider websites. Remember that the *Mail* application only supports POP3 and SMTP mail servers.

*Yahoo! Mail settings*

* Yahoo Incoming Mail Server (POP3): pop.mail.yahoo.com (port 110)

* Yahoo Outgoing Mail Server (SMTP): smtp.mail.yahoo.com (port 25)

* Gmail (Google Mail) settings*

* Gmail Incoming Mail Server (POP3): pop.gmail.com (port 995)

* Gmail Outgoing Mail Server (SMTP): smtp.gmail.com (port 465)

*Hotmail settings*

* Hotmail Incoming Mail Server (POP3): pop3.live.com (port 995)

* Hotmail Outgoing Mail Server (SMTP): smtp.live.com (port 25)

*MSN Mail settings*

* MSN Incoming Mail Server (POP3): pop3.email.msn.com (port 110)

* MSN Outgoing Mail Server (SMTP): smtp.email.msn.com

*AOL Mail settings*

* AOL Incoming Mail Server (IMAP) - imap.aol.com (port 143)

* AOL Outgoing Mail Server - smtp.aol.com

h1. Get mails {anchor:id="CSUser_guide.How_to_use_Mail.Get_mailRoleNotInToc"}
This function is used to receive messages from the remote mail servers and forward them via SMTP, so it can be read in Mail. It supports any mail servers with POP3, IMAP, SMTP, such as Gmail, Hotmail, Yahoo! Mail, GMX, MS Exchange.

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Click the folder you want to check for new mails. If no folder is selected, the default folder will be <guilabel>Inbox</guilabel>.</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">2.</emphasis> Click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/get_mail_icon.png" format="PNG" scalefit="1" width="15mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/get_mail_icon.png" format="PNG" scalefit="0" width="15mm"/>
            </imageobject>
          </inlinemediaobject> on the <emphasis role="bold">Toolbar</emphasis>. The status notification with '<guilabel>Fetching email messages...</guilabel>' shows that emails are being loaded. All arrived mails are shown in the messages pane. Click <guilabel>Refresh</guilabel> if you want to refresh the fetching mails.</para>
{docbook}

!images/fetching_emails.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

h1. Mail views {anchor:id="CSUser_guide.How_to_use_Mail.Mail_viewsRoleNotInToc"}
{docbook}
<para>This function offers three options for viewing messages in your mailbox. Messages are displayed by date, where receipt hours are for today mails and dates are for mails received in previous days. You simply toggle between 3 views by clicking <guilabel>View as</guilabel> and selecting either of the views. The selected view is marked with <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/marked_account_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/marked_account_icon.png" format="PNG" scalefit="0" width="4mm"/>
            </imageobject>
          </inlinemediaobject>.</para>
{docbook}

!images/view_as.png|align="center" width="30mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<citetitle>
    <para xml:id="CSUser_guide.How_to_use_Mail.Mail_views.List_view">
        <emphasis role="bold">List view</emphasis>
    </para>
</citetitle>
{docbook}

In this view mode, all messages are arranged as a list.

!images/list_view.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<citetitle>
    <para xml:id="CSUser_guide.How_to_use_Mail.Mail_views.Thread_view">
        <emphasis role="bold">Thread view</emphasis>
    </para>
</citetitle>
{docbook}

Messages are arranged as a tree structure. All replies are shown as sub-nodes. When you click one message, its content is displayed in the message details pane with block quotes containing content of the parent messages.

!images/thread_view.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<citetitle>
    <para xml:id="CSUser_guide.How_to_use_Mail.Mail_views.Conversation_view">
        <emphasis role="bold">Conversation view</emphasis>
    </para>
</citetitle>
{docbook}

When this view mode is selected, only the subject of parent message and the number of replies in the conversation are displayed in the messages list pane. When being opened, all messages are shown in the message details pane with separate reading pane which can be expanded by left-clicking the relevant reading pane.

!images/conversation_view.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

h1. Read an email {anchor:id="CSUser_guide.How_to_use_Mail.Read_emailRoleNotInToc"}
If you want to read an email, simply click your preferred mail in the mails list and scroll down to read your selected email in the details pane.

!images/read_email.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

h2. Download an attached file {anchor:id=Download_attached_files}
{docbook}
<para>This function offers three options for viewing messages in your mailbox. Messages are displayed by date, where receipt hours are for today mails and dates are for mails received in previous days. You simply toggle between 3 views by clicking <guilabel>View as</guilabel> and selecting either of the views. The selected view is marked with <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/marked_account_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/marked_account_icon.png" format="PNG" scalefit="0" width="4mm"/>
            </imageobject>
          </inlinemediaobject>.</para>
{docbook}

!images/Attachment_details.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

Click !images/Download_button.png|width="15mm" fo:scalefit="1" html:scalefit="0"! to download an attachment to your local system. If the uploaded file is image, you can also click !images/Preview_button.png|width="10mm" fo:scalefit="1" html:scalefit="0"! to preview the image without downloading.

{docbook}
<citetitle>
<para xml:id="Download_attachments_to_server">
<emphasis role="bold">Download and save attachments to server</emphasis>
</para>
</citetitle>
{docbook}

*1.* Open the mail with attachments.

{docbook}
<para>
   <emphasis role="bold">2.</emphasis> Click <guilabel>Save to server</guilabel> to open the <guilabel>Save attachment</guilabel> form.</para>
{docbook}

!images/Server_saving_folder.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
    <emphasis role="bold">3.</emphasis> Change the name of the downloaded file in the <guilabel>Save file to the server</guilabel> field if needed.</para>
{docbook}

{docbook}
<para>
  <emphasis role="bold">4.</emphasis> Select a drive category from the <guilabel>Select Drives</guilabel> drop-down menu. The number of shown drive categories depends on your role. <anchor id="Download_attachments_Step_4_5_6"/>
</para>
{docbook}

*5.* Select one drive from the drives list to open a list of folders.

*6.* Select one folder which stores your downloaded file from the folders list.

* Click !images/Create_folder_server_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to create a new folder in your selected drive.

{docbook}
<note>
<para>
Your selected location is shown in the breadcrumb.
</para>
</note>
{docbook}

{docbook}
<para>
    <emphasis role="bold">7.</emphasis> Click <guibutton>Save</guibutton> to finish downloading the attachment to the server.</para>
{docbook}

h2. View all headers of a message {anchor:id=View_all_headers}
By default, the header's information shows email addresses of the sender and recipients and the mail subject. If you want to view full headers of a message, do as follows:

*1.* Open the message which you want to view its full headers.

{docbook}
<para>
            <emphasis role="bold">2.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/down_arrow_icon.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/down_arrow_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> at the right corner of message's content and select <guilabel>View All Headers</guilabel> from the drop-down menu. All message headers are then appeared in the pop-up window.</para>
{docbook}

h2. Mark/Unmark a message as read {anchor:id="Mark_Unmark_as_read"}
In the *Mail* application, the unread mails will be recognized in the bold format in the mails list pane, meanwhile the read mails will be unbold.

{docbook}
<citetitle>
<para xml:id="Mark_as_read">
<emphasis role="bold">Mark a message as read</emphasis>
</para>
</citetitle>
{docbook}

*The first way*

*1.* Select checkboxes corresponding to messages you want to mark as read.

{docbook}
<para>
 <emphasis role="bold">2.</emphasis> Click <guilabel>More Actions</guilabel>, then select <guilabel>Mark as Read</guilabel> from the drop-down menu.</para>
{docbook}

*The second way*

{docbook}
<note>
<para>
This way is used to mark all unread messages in a specific folder.
</para>
</note>
{docbook}

*1.* Right-click the folder which contains messages you want to mark as read.

{docbook}
<para>
  <emphasis role="bold">2.</emphasis> Select <guilabel>Mark all as read</guilabel> from the drop-down menu.</para>
{docbook}

After being marked as read, all unread messages inside the folder will be marked as read.

{docbook}
<citetitle>
<para xml:id="Mark_as_unread">
<emphasis role="bold">Mark as unread</emphasis>
</para>
</citetitle>
{docbook}

*1.* Select the messages you want to mark as unread.

{docbook}
<para>
   <emphasis role="bold">2.</emphasis> Select <guilabel>Mark all as read</guilabel> from the drop-down menu.</para>
{docbook}

h2. Star/Unstar a message  {anchor:id="Star_unstar_a_message"}

{docbook}
<citetitle>
<para xml:id="Star_a_message">
<emphasis role="bold">Star a message</emphasis>
</para>
</citetitle>
{docbook}

*The first way*
{docbook}
<para>
  <emphasis role="bold">2.</emphasis> Click <guilabel>More Actions</guilabel>, then select <guilabel>Mark as Unread</guilabel> from the drop-down menu.</para>
{docbook}

*The second way*

In the messages list pane, click !images/Grey_star_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! next to the message you want to add a star.

After being marked, the selected messages will be appended with !images/star_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"!, so that you can recognize them quickly.

{docbook}
<citetitle>
<para xml:id="Unstar_a_message">
<emphasis role="bold">Unstar a message</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>Simply select <guilabel>Unstar</guilabel> from the <guilabel>More Actions</guilabel> drop-down menu on the action bar;</para>
{docbook}

Or, click !images/star_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! next to the message.

h2. Move a message to other folders {anchor:id="Move_message_to_other_folders"}

*The first way*

{docbook}
<para>
 <emphasis role="bold">1.</emphasis> Open the <guilabel>Move Message</guilabel> form via one of the following ways.</para>
{docbook}

*The first way*

{docbook}
<para>Right-click the message you want to move to another folder in the messages list pane, and select <guilabel>Move to Folder</guilabel> from the drop-down menu; </para>
{docbook}

*The second way*
{docbook}
<para>Tick the checkbox corresponding to the message you want to move, then click <guilabel>More Actions</guilabel> on the action bar and select <guilabel>Move</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>
            <emphasis role="bold">2.</emphasis> Tick <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/down_arrow_icon1.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/down_arrow_icon1.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> next to the <guilabel>Move To Folder</guilabel> field to select your desired destination folder from the drop-down menu.</para>
{docbook}

!images/Move_message_form.png|align="center" width="110mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
   <emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to move messages to your selected folder.</para>
{docbook}

*The second way*

In the mails list pane, tick the message you want to move, then drag and drop it into your desired destination folder in the left pane.

!images/Drag_drop_message.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

h2. Report a message as spam {anchor:id="Report_message_as_spam"}
*The first way*

Simply tick the checkbox corresponding to the message you want to report as spam, then click !images/spam_mail_icon.png|width="5mm" fo:scalefit="1" html:scalefit="0"! on the *Action* bar.

*The second way*

{docbook}
<para>Drag the message in the right mails list pane and drop it into the <guilabel>Spam</guilabel> folder in the left pane.</para>
{docbook}

{docbook}
<itemizedlist>
            <listitem>
              <para>The selected email will be moved to the <guilabel>Spam</guilabel> folder. Go into the <guilabel>Spam</guilabel> folder to verify that the selected message has been moved to it.</para>
            </listitem>
            <listitem>
              <para>All messages marked as spam will be moved to the <guilabel>Spam</guilabel> folder.</para>
            </listitem>
</itemizedlist>
{docbook}

{docbook}
<citetitle>
<para xml:id="Unspam_message">
<emphasis role="bold">Unspam a message
</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
 <emphasis role="bold">1.</emphasis> Go to the <guilabel>Spam</guilabel> folder, then tick the checkbox corresponding to the relevant message.</para>
{docbook}

*2.* Click !images/move_spam_mail_icon.png|width="5mm" fo:scalefit="1" html:scalefit="0"! on the *Action* bar.

{docbook}
<para>The spam message will be removed from the <guilabel>Spam</guilabel> folder. All messages from this sender will be received normally.</para>
{docbook}

h2. Delete a message {anchor:id="Delete_a_message"}

{docbook}
<citetitle>
<para xml:id="Delete_message_temporarily">
<emphasis role="bold">Delete a message temporarily
</emphasis>
</para>
</citetitle>
{docbook}

*The first way*

{docbook}
 <para>Right-click the message, then select <guilabel>Delete</guilabel> from the drop-down menu.</para>
{docbook}

*The second way*

Tick the checkbox corresponding to the message you want to delete, then select !images/Delete_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the *Action* bar.

*The third way*

{docbook}
<para>Drag the message in the mails list pane and drop it into the <guilabel>Trash</guilabel> folder in the left pane.</para>
{docbook}

{docbook}
<itemizedlist>
            <listitem>
              <para>All temporarily deleted messages will be in the <guilabel>Trash</guilabel> folder.</para>
            </listitem>
          </itemizedlist>
{docbook}

{docbook}
<citetitle>
<para xml:id="Delete_message_permanently">
<emphasis role="bold">Delete a message permanently
</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<note>
<para>
All messages which have been deleted permanently cannot be restored any longer. To delete a message permanently, the message should first be in the <guilabel>Trash</guilabel> folder. It means that the message should <link linkend="Delete_message_temporarily">have been deleted</link> temporarily.
</para>
</note>
{docbook}

{docbook}
<para>
 <emphasis role="bold">1.</emphasis> Select the <guilabel>Trash</guilabel> folder in the left pane to see all messages in this folder.</para>
{docbook}

{docbook}
<para>
 <emphasis role="bold">2.</emphasis> Right-click the relevant message, then select <guilabel>Delete</guilabel> from the drop-down menu;</para>
{docbook}

Or, tick the checkbox corresponding to the relevant message, and click !images/add_mail_acount_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the action bar.

{docbook}
<citetitle>
<para xml:id="Undelete_message_permanently">
<emphasis role="bold">Undelete a message
</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<note>
<para>
This function is only for messages which have been TEMPORARILY deleted.
</para>
</note>
{docbook}

*The first way*

{docbook}
<para>
 <emphasis role="bold">1.</emphasis> Select the <guilabel>Trash</guilabel> folder in the left pane to see the list of temporarily deleted messages in the right mails list pane.</para>
{docbook}

*2.* Tick the checkbox corresponding to the message you want to undelete.

*3.* Drag and drop the message into another folder.

*The second way*

{docbook}
<para>Open the <guilabel>Trash</guilabel> folder, then use the <link linkend="Move_message_to_other_folders">Move</link> function to remove the message from the <guilabel>Trash</guilabel> folder.</para>
{docbook}

h1. Compose a new message {anchor:id="Compose_new_messageRoleNotInToc"}

In this section, you will know to [compose a message|#CSUser_guide.How_to_use_Calendar.Compose_message], [send message to multiple recipients|#CSUser_guide.How_to_use_Calendar.Send_message_to_multiple_recipients] and perform useful tasks when composing a message:
* [Attach a file to a message|#Attach_attachment_to_message]
* [Save a message as draft|#Save_message_as_draft]
* [Set a priority level|#Set_priority_level]
* [Change the message signature|#Change_signature_to_message]
* [Change message preferences|#Change_message_preferences]

{docbook}
<citetitle>
    <para xml:id="CSUser_guide.How_to_use_Calendar.Compose_message">
        <emphasis role="bold">Compose a message</emphasis>
    </para>
</citetitle>
{docbook}

{docbook}
<para>
          <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/write_mail_icon.png" format="PNG" scalefit="1" width="13mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/write_mail_icon.png" format="PNG" scalefit="0" width="13mm"/>
            </imageobject>
          </inlinemediaobject> on the <guilabel>Toolbar</guilabel> to open the <guilabel>Compose New Message</guilabel> form.</para>
{docbook}
!images/compose_message_form.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
 <emphasis role="bold">2.</emphasis> Specify the sender's email address from the <guilabel>From</guilabel> field.
</para>
{docbook}

!images/from_email.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
   <emphasis role="bold">3.</emphasis> Enter email addresses of recipients into the <guilabel>To</guilabel> field.</para>
{docbook}

{docbook}
<para>The <guilabel>To</guilabel> box must always contain at least one address; everyone who receives your message can see the addresses in the <guilabel>To</guilabel> box.</para>
{docbook}

{docbook}
<note>
    <para>
    You can use <guilabel>CC</guilabel> and <guilabel>BCC</guilabel> to send mail to more than one person easily and quickly.
    </para>
    <para>
    Use the <guilabel>CC</guilabel> (Carbon Copy) box for the addresses of people you want to send a copy of the message to other recipients. Everyone who receives your message can also see the addresses in the CC box. If someone responds to your message using "Reply to all", the carbon-copied recipients also receive the message.
    </para>
    <para><guilabel>BCC</guilabel> (Blind Carbon Copy) mails are private to the sender and the BCC recipients. Use BCC when you want to send the message to undisclosed recipients. It means you send the message to people and they do not know about other recipients. Addresses listed in the BBC box will not receive replies sent to this message.</para>
</note>
{docbook}

{docbook}
<para>
  <emphasis role="bold">4.</emphasis> Enter a few words into the <guilabel>Subject</guilabel> box to give the general topic to recipients.</para>
{docbook}

*5.* Enter your message in the text-input field. You can use this toolbar to format the message text.

!images/Compose_toolbar.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

Click !images/editor_icon.png|width="13mm" fo:scalefit="1" html:scalefit="0"! on the Mail toolbar to switch between *Rich Text* and *Plain Text* editors. If *Rich Text* is selected, the message text can be composed with format tools, meanwhile *Plain Text* only allows you to compose a message with the simple text format.

*6.* Click !images/send_mail_icon.png|width="13mm" fo:scalefit="1" html:scalefit="0"! to send your message. Click !images/discard_icon.png|width="13mm" fo:scalefit="1" html:scalefit="0"! to discard composing your new message.

{docbook}
<note>
    <para>
    Sent mails will be saved in the <guilabel>Sent</guilabel> folder. In case emails of recipients do not exist in your Address Book, they will be added automatically to the <guilabel>Collected Address</guilabel> in the <emphasis role="bold">Contact</emphasis> application.
    </para>
</note>
{docbook}

{docbook}
<citetitle>
<para xml:id="CSUser_guide.How_to_use_Calendar.Send_message_to_multiple_recipients">
<emphasis role="bold">
Send message to multiple recipients
</emphasis>
</para>
</citetitle>
{docbook}

*The first way*

Type more email addresses by separating them with commas.

!images/to_email.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

If your typed address matches one or more addresses in your Address Book, the list of matching addresses will appear and you can click one address to select.

!images/to_email1.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*The second way*

Select one or more contacts from your Address Book.

{docbook}
<para>
  <emphasis role="bold">1.</emphasis> Click the <guilabel>To</guilabel> button.</para>
{docbook}

!images/to_email2.png|align="center" width="80mm" fo:scalefit="1" html:scalefit="0"!
{docbook}
<para>The <guilabel>Contacts</guilabel> window listing all of your contacts will appear.</para>
{docbook}
!images/contacts.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Tick the checkboxes corresponding to the contacts who will receive your message.

Also, you can

* Search for email addresses in a specific address book as follows:

*i.* Type the contact name in the search box.

{docbook}
<para>
  <emphasis role="bold">ii.</emphasis> Define the address book where you want to search for your entered contact name to limit the search results in the <guilabel>Address Book</guilabel> select-box.</para>
{docbook}

!images/addressbook.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*iii.* Click !images/Search_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to perform your search.

{docbook}
<itemizedlist>
          <listitem>
            <para>Tick the <guilabel>Send To All</guilabel> checkbox if you want to send the email to the contacts defined in the <guilabel>Address Book</guilabel> select-box.</para>
          </listitem>
</itemizedlist>
{docbook}

{docbook}
<para><emphasis role="bold">3.</emphasis> Click <guilabel>Add</guilabel> to add your selected email addresses to the <guilabel>To</guilabel> box, or <guilabel>Replace</guilabel> to replace the current email addresses in the <guilabel>To</guilabel> field with your newly selected ones.</para>
{docbook}

{docbook}
<citetitle>
    <para xml:id="Attach_attachment_to_message">
        <emphasis role="bold">Attach a file to a message</emphasis>
    </para>
</citetitle>
{docbook}

*Attach a local file*

{docbook}<para>
            <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/attach_local_file_icon.png" format="PNG" scalefit="1" width="17mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/attach_local_file_icon.png" format="PNG" scalefit="0" width="17mm"/>
              </imageobject>
            </inlinemediaobject> in the <guilabel>Compose New Message</guilabel> form to open the <guilabel>Attach Files</guilabel> window.</para>
{docbook}
{docbook}
<para>
  <emphasis role="bold">2.</emphasis> Click <guibutton>Browse...</guibutton> to open the <guilabel>File Upload</guilabel> form.</para>
{docbook}

{docbook}
<para>
 <emphasis role="bold">3.</emphasis> Browse the file from your device, then click <guilabel>Open</guilabel> to upload your selected file.</para>
{docbook}

{docbook}
<itemizedlist>
            <listitem>
              <para>Open more <guilabel>Attach File</guilabel> fields by simply clicking <inlinemediaobject>
                  <imageobject role="fo">
                    <imagedata fileref="images/Add_more_button.png" format="PNG" scalefit="1" width="13mm"/>
                  </imageobject>
                  <imageobject role="html">
                    <imagedata fileref="images/Add_more_button.png" format="PNG" scalefit="0" width="13mm"/>
                  </imageobject>
                </inlinemediaobject>.</para>
            </listitem>
</itemizedlist>
{docbook}

{docbook}
<para>
 <emphasis role="bold">4.</emphasis> Click <guibutton>Save</guibutton> to accept your attachments and go back to the <guilabel>Compose New Message</guilabel> form. </para>
{docbook}

{docbook}
<para>You will see your uploaded files in the <guilabel>Attachments</guilabel> area of the <guilabel>Compose New Message</guilabel> window.</para>
{docbook}

!images/Attachments_area.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

* Click !images/Download_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to download or see if your uploaded file is correct or not without browsing the file on your device.
* Click !images/add_mail_acount_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! next to the attached file to remove it from your message.

*Attach a server file*

This function is only featured in eXo Platform 3.5, allowing you to browse and attach one file from your server as follows.

{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/Down_arrow_icon2.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/Down_arrow_icon2.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> next to the <guilabel>Attach a Local File</guilabel> in the <guilabel>Compose New Message</guilabel> form, then select <guilabel>Attach a Server File</guilabel> from the drop-down menu.</para>
{docbook}

!images/Attach_server_file_form.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Follow steps 4, 5, and 6 as stated in the [Download and save attachments to server|#Download_attachments_Step_4_5_6] section.

*3.* Click the server file from the files list of your selected folder.

* Click !images/File_Upload_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! if you want to upload a file from your device.

{docbook}
<para>
<emphasis role="bold">4.</emphasis> Click <guilabel>Attach</guilabel> to upload your selected source file into the message;</para>
{docbook}

{docbook}
<para>Or, click <guilabel>Attach Link</guilabel> to get the link pointing to the selected source file that is shown in your message body. The <emphasis role="bold">Attach Link</emphasis> function allows your mail recipients to download the attached source file just clicking the relevant link.</para>
{docbook}

{docbook}
<citetitle>
    <para xml:id="Save_message_as_draft">
        <emphasis role="bold">Save a message as draft</emphasis>
    </para>
</citetitle>
{docbook}

{docbook}
<para>If you are not ready to send your composed message, click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/save_in_drafts_icon.png" format="PNG" scalefit="1" width="17mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/save_in_drafts_icon.png" format="PNG" scalefit="0" width="17mm"/>
              </imageobject>
            </inlinemediaobject> to save it as draft. Your draft message will be in the <guilabel>Drafts</guilabel> folder for you to send whenever you like.</para>
{docbook}

{docbook}
<citetitle>
    <para xml:id="Set_priority_level">
        <emphasis role="bold">Set a priority level</emphasis>
    </para>
</citetitle>
{docbook}

The priority levels set to a message allow recipients to define if one received message is at a high, or normal, or low importance level. It means that when a message is set at the high priority level, its recipients need to read as soon as possible.

This useful tool can be done with a few clicks when you are composing a new message.

{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/priority_icon.png" format="PNG" scalefit="1" width="15mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/priority_icon.png" format="PNG" scalefit="0" width="15mm"/>
              </imageobject>
            </inlinemediaobject> in the <guilabel>Compose New Message</guilabel> form.</para>
{docbook}

*2.* Select your preferred priority from the drop-down menu.

{docbook}
<itemizedlist>
            <listitem>
              <para>
                <guilabel>Low:</guilabel> The exclamation icon corresponding to the mail is marked in grey in the <inlinemediaobject>
                  <imageobject role="fo">
                    <imagedata fileref="images/Priority_column_icon.png" format="PNG" scalefit="1" width="4mm"/>
                  </imageobject>
                  <imageobject role="html">
                    <imagedata fileref="images/Priority_column_icon.png" format="PNG" scalefit="0" width="4mm"/>
                  </imageobject>
                </inlinemediaobject> column.</para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Normal:</guilabel> There is no the exclamation icon. By default, the message is sent with the <emphasis role="bold">Normal</emphasis> priority.</para>
            </listitem>
            <listitem>
              <para>
                <guilabel>High:</guilabel> The exclamation icon is marked in red.</para>
            </listitem>
          </itemizedlist>
{docbook}

{docbook}
<citetitle>
    <para xml:id="Change_signature_to_message">
        <emphasis role="bold">Change the message signature</emphasis>
    </para>
</citetitle>
{docbook}

A message signature is an identification text which is automatically inserted at the bottom of your sending messages.
You can change this signature by [editing your account details|#CSUser_guide.How_to_use_Mail.Create_mail_account.Edit_account].

{docbook}
<citetitle>
    <para xml:id="Change_message_preferences">
        <emphasis role="bold">Change message preferences</emphasis>
    </para>
</citetitle>
{docbook}

At present, this function only allows you to receive a notification message that the recipient has already read your message or not.

{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/options_icon.png" format="PNG" scalefit="1" width="15mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/options_icon.png" format="PNG" scalefit="0" width="15mm"/>
              </imageobject>
            </inlinemediaobject> in the <guilabel>Compose New Message</guilabel> form.</para>
{docbook}
{docbook}
<para>
   <emphasis role="bold">2.</emphasis> Select the <guilabel>Return Receipt</guilabel> option from the drop-down menu. However, seeing the notification message or not also depends on the <guilabel>
              <link linkend="Return_Receipts_settings">Return Receipts</link>
            </guilabel> configuration of the recipient in the <link linkend="Mail_settings">Change Mail settings</link> section.</para>
{docbook}

h1. Reply to a message {anchor:id="CSUser_guide.How_to_use_Mail.Reply_to_messageRoleNotInToc"}

{docbook}
<citetitle>
<para xml:id="reply_to_a_sender">
<emphasis role="bold">Reply to the sender only</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
          <emphasis role="bold">1.</emphasis> Open the <guilabel>Reply</guilabel> form via either of 3 ways:</para>
{docbook}

*The first way*

Tick the checkbox corresponding to the message you want to reply in the mails list pane, then click !images/reply_mail_icon.png|width="5mm" fo:scalefit="1" html:scalefit="0"! on the action bar.

*The second way*

{docbook}
<para>Right-click the message you want to reply, then select <guilabel>Reply</guilabel> from the drop-down menu.</para>
{docbook}

*The third way*

Click the message that you want to reply to display its content, then select !images/reply_mail_icon.png|width="5mm" fo:scalefit="1" html:scalefit="0"! at the upper right corner of the message content.

{docbook}
<para>
          <emphasis role="bold">2.</emphasis> Compose the content in the <guilabel>
            <link linkend="Compose_new_message">Compose New Message</link>
          </guilabel> window.</para>
{docbook}

*3.* Click !images/send_mail_icon.png|width="13mm" fo:scalefit="1" html:scalefit="0"! to send your reply.

{docbook}
<citetitle>
<para xml:id="reply_to_all">
<emphasis role="bold">Reply to all recipients of the message</emphasis>
</para>
</citetitle>
{docbook}

*1.* Tick the checkbox corresponding to the message you want to reply, then click !images/reply_all_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the *Action* bar;

{docbook}
<para>Or right-click the message, then select <guilabel>Reply to All</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">2.</emphasis> Compose your reply message in the <guilabel>
            <link linkend="Compose_new_message">Compose New Message</link>
          </guilabel> window, then click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/send_mail_icon.png" format="PNG" scalefit="1" width="13mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/send_mail_icon.png" format="PNG" scalefit="0" width="13mm"/>
            </imageobject>
          </inlinemediaobject> to send your reply.</para>
{docbook}

h1. Forward a message {anchor:id="CSUser_guide.How_to_use_Mail.Forward_messageRoleNotInToc"}
This function allows you to resend a message, which has been delivered to your email address, to another email addresses.

{docbook}
<para>
  <emphasis role="bold">1.</emphasis> Open the <guilabel>Compose New Message</guilabel> window via either of 3 ways.</para>
{docbook}

*i.* Tick the checkbox corresponding to the message which you want to forward, then click !images/forward_mail_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the action bar.

!images/forward_mail.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
 <emphasis role="bold">ii.</emphasis> Or, right-click the message, then select <guilabel>Forward</guilabel> from the drop-down menu;</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">iii.</emphasis> Or, open the message which you want to forward, then click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/down_arrow_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/down_arrow_icon.png" format="PNG" scalefit="0" width="4mm"/>
            </imageobject>
          </inlinemediaobject> at the upper right corner of the message content, and select <guilabel>Forward</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>The <guilabel>Compose New Message</guilabel> window will be displayed with the original content of the message you want to forward.</para>
{docbook}

{docbook}
<para>
  <emphasis role="bold">2.</emphasis> Enter the recipient's email address in the <guilabel>To</guilabel> field.</para>
{docbook}

*3.* Click !images/send_mail_icon.png|width="13mm" fo:scalefit="1" html:scalefit="0"! to forward the message.

{docbook}
<note>
<para>
Before forwarding a message, you can edit it to your desires that is similar to <link linkend="Compose_new_message">composing a new message.</link>
</para>
</note>
{docbook}

h1. Print a message {anchor:id="CSUser_guide.How_to_use_Mail.Print_messageRoleNotInToc"}

This function helps you take a hard copy of the message, provided that your device is connected to a printer, either directly or through a network connection.

*The first way*

{docbook}
<para>Right-click the message which you want to print and click <guibutton>Print</guibutton> from the drop-down menu.</para>
{docbook}

*The second way*

Tick the checkbox corresponding to the message, then click !images/print_icon.png|width="5mm" fo:scalefit="1" html:scalefit="0"! on the action bar.

*The third way*

{docbook}
<para>Open the message, then click
<inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/down_arrow_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/down_arrow_icon.png" format="PNG" scalefit="0" width="4mm"/>
            </imageobject>
          </inlinemediaobject>  at the upper right corner of the message content and select <guibutton>Print</guibutton> from the drop-down menu.</para>
{docbook}

{docbook}
<para>You will be directed to the <emphasis role="bold">Print Preview</emphasis> page. Here, click <guibutton>Print</guibutton> to start printing.</para>
{docbook}

h1. Export a message {anchor:id="CSUser_guide.How_to_use_Mail.Export_messagesRoleNotInToc"}

This function allows you to back up your messages, then import them into your another accounts. Messages are exported in the \*.eml file.

{docbook}
<para>
          <emphasis role="bold">1.</emphasis> Open the <guilabel>Export Message</guilabel> form via either of 3 ways.</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">i.</emphasis> Right-click the message that you want to export, then select <guilabel>Export</guilabel> from the drop-down menu;</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">ii.</emphasis> Or, tick the checkbox corresponding to the message, then click <guilabel>More Actions</guilabel> on the action bar and select <guilabel>Export</guilabel> from the drop-down menu;</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">iii.</emphasis> Open the message, then click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/down_arrow_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/down_arrow_icon.png" format="PNG" scalefit="0" width="4mm"/>
            </imageobject>
          </inlinemediaobject> at the upper right corner of the message content and select <guilabel>Export (*.eml)</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>The <guilabel>Export Message</guilabel> form will appear.</para>
{docbook}

!images/export_message.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
          <emphasis role="bold">2.</emphasis> Change the file name in the <guilabel>File Name</guilabel> field if needed, and select the export format. At present, only the *.eml format is supported.</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">3.</emphasis> Click <guibutton>Export</guibutton> to accept exporting your selected message.</para>
{docbook}

h1. Import a message {anchor:id="CSUser_guide.How_to_use_Mail.Import_messagesRoleNotInToc"}
The function is used to import a message from your device to your selected folder in *Mail*.

{docbook}
<para>
  <emphasis role="bold">1.</emphasis> Click <guilabel>More Actions</guilabel> on the action bar and select <guilabel>Export</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>The <guilabel>Import Message</guilabel> form will appear.</para>
{docbook}

!images/import_message.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
          <emphasis role="bold">2.</emphasis> Click <guibutton>Browse...</guibutton> to get one <emphasis role="italic">.eml</emphasis> file from your device.</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">3.</emphasis> Select the folder into which you want to import the message in the <guilabel>Import to Folder</guilabel> field.</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">4.</emphasis> Click <guibutton>Import</guibutton> to accept importing your selected file.</para>
{docbook}

{docbook}
<note>
    <para>
    By default, your imported file must be in the *.eml format.
    </para>
</note>
{docbook}

h1. Categorize messages by folders/tags/filters {anchor:id="CSUser_guide.How_to_use_Mail.Categorize_messages_by_folders_tags_filtersRoleNotInToc"}

h2. Categorize by folder {anchor:id="CSUser_guide.How_to_use_Mail.Categorize_messages_by_folders_tags_filters.Folder}

{docbook}<para>Folders help you manage your messages more easily and flexibly. Once your new mail account is created successfully, five default folders, including <guilabel>Inbox, Drafts, Sent, Spam, Trash</guilabel>, will be automatically generated. You cannot delete, rename or move these folders.</para>
{docbook}
!images/Mail_folder.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<informaltable>
            <tgroup cols="2">
              <thead>
                <row>
                  <entry>Folder</entry>
                  <entry>Description</entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry>
                    <guilabel>Inbox</guilabel>
                  </entry>
                  <entry>Store all incoming messages.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Drafts</guilabel>
                  </entry>
                  <entry>Store all messages which have been composed but not sent yet.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Sent</guilabel>
                  </entry>
                  <entry>Store all sent messages.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Spam</guilabel>
                  </entry>
                  <entry>Store all messages suspected of being unwanted messages.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Trash</guilabel>
                  </entry>
                  <entry>Store temporarily deleted messages.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Personal Folders</guilabel>
                  </entry>
                  <entry>Store folders which are created by yourself.</entry>
                </row>
              </tbody>
            </tgroup>
          </informaltable>
{docbook}

Categorizing by folders can be performed via the following actions:

{docbook}
<para xml:id="Create_new_folder">
	<citetitle>
		<emphasis role="bold">Create a new folder</emphasis>
	</citetitle>
</para>
{docbook}

{docbook}
<para>
              <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/Down_arrow_addressbook_icon.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/Down_arrow_addressbook_icon.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject> on the <guilabel>Folders</guilabel> pane, then select <guilabel>Add</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>
   <emphasis role="bold">2.</emphasis> Enter the folder name into the <guilabel>Folder name</guilabel> field. Special characters are not accepted in this field.</para>
{docbook}

{docbook}
<para>
              <emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to complete adding your new folder.</para>
{docbook}

{docbook}
<note>
    <para>
    Your created folder will be displayed in the <guilabel>Personal Folders</guilabel> pane.
    </para>
</note>
{docbook}

{docbook}
<para xml:id="Manage_Personal_Folders">By right-clicking any folder under the <guilabel>Personal Folders</guilabel> pane, you will see the drop-down menu as follows. </para>
{docbook}

!images/personal-folder.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

Here you can manage personal folders through the following actions:
* [Create a sub-folder|#Create_subfolder]
* [Rename a folder|#Rename_folder]
* [Remove a folder|#Remove_folder]
* [Mark a folder as read|#Mark_folder_as_read]

{docbook}
<note>
<para>
All above actions are only for folders/sub-folders under the <guilabel>Personal Folders</guilabel> pane.
</para>
</note>
{docbook}

{docbook}
<citetitle>
<para xml:id="Create_subfolder">
<emphasis role="bold">Create a sub-folder</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
  <emphasis role="bold">1.</emphasis> Select <guilabel>New Subfolder</guilabel> from the drop-down menu.</para>
{docbook}

*2.* Follow steps as stated in the [Create a new folder|#Create_new_folder] section.

{docbook}
<citetitle>
<para xml:id="Rename_folder">
<emphasis role="bold">Rename a folder</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
  <emphasis role="bold">1.</emphasis> Select <guilabel>Rename</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
 <para>
    <emphasis role="bold">2.</emphasis> Enter a new name in the <guilabel>New Folder Name</guilabel> field of the <guilabel>Remove Folder</guilabel> form.</para>
{docbook}

{docbook}
<para>
   <emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to finish your removal.</para>
{docbook}

{docbook}
<citetitle>
<para xml:id="Remove_folder">
<emphasis role="bold">Remove a folder</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
  <emphasis role="bold">1.</emphasis> Select <guibutton>Remove</guibutton> from the drop-down menu.</para>
{docbook}

{docbook}
<para>
  <emphasis role="bold">2.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to accept your deletion.</para>
{docbook}

{docbook}
<citetitle>
<para xml:id="Mark_folder_as_read">
<emphasis role="bold">Mark a folder as read</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>This function is to mark all mails of a personal folder as read by clicking <guilabel>Mark all as read</guilabel> from the drop-down menu.</para>
{docbook}

h2. Categorize by tag {anchor:id="Tag"}

Tags are used as labels for filtering or categorizing messages from different folders. You can add more than one tag to a message. Using tags makes easy for you to find messages independently from the folder where they are stored.

You can categorize by tags through the following actions:

{docbook}
<para xml:id="Create_tag">
	<citetitle>
		<emphasis role="bold">Create a tag</emphasis>
	</citetitle>
</para>
{docbook}

{docbook}
<para>
              <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/Down_arrow_addressbook_icon.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/Down_arrow_addressbook_icon.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject> on the <guilabel>Tags</guilabel> pane of the right pane and select <guilabel>Add New Tag</guilabel> from the drop-down menu to open the <guilabel>Tag</guilabel> form.</para>
{docbook}

!images/tag.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<informaltable>
              <tgroup cols="2">
                <thead>
                  <row>
                    <entry>Field</entry>
                    <entry>Description</entry>
                  </row>
                </thead>
                <tbody>
                  <row>
                    <entry>
                      <guilabel>Name</guilabel>
                    </entry>
                    <entry>The new tag name.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Color</guilabel>
                    </entry>
                    <entry>The tag color.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Description</guilabel>
                    </entry>
                    <entry>The brief description of the tag.</entry>
                  </row>
                </tbody>
              </tgroup>
 </informaltable>
{docbook}

{docbook}
<para>
    <emphasis role="bold">2.</emphasis> Fill in required fields, then click <guibutton>Save</guibutton> to finish.</para>
{docbook}

{docbook}
<para>Your newly selected tag will be updated in the <guilabel>Tags</guilabel> pane.</para>
{docbook}

{docbook}
<para xml:id="Assign_tag">
	<citetitle>
		<emphasis role="bold">Assign a tag to a message</emphasis>
	</citetitle>
</para>
{docbook}

{docbook}
<note>
<para>
You can assign a tag to many messages simply by ticking their checkboxes first.
</para>
</note>
{docbook}

{docbook}
<para>
              <emphasis role="bold">1.</emphasis> Open the <guilabel>Tag Message</guilabel> form via one of the following ways.  <anchor id="Assign_tag_Step_1"/></para>
{docbook}

*The first way*

{docbook}
<para>
   <emphasis role="bold">i.</emphasis> Tick the checkbox corresponding to the message to which you want to assign a tag, then click <guilabel>More Actions</guilabel> on the <guilabel>Action bar</guilabel>.</para>
{docbook}

{docbook}
<para>
  <emphasis role="bold">ii.</emphasis> Select <guilabel>Tag</guilabel> from the drop-down menu.</para>
{docbook}

*The second way*

{docbook}
<para>Right-click your selected message, then select <guilabel>Tag</guilabel> from the drop-down menu;</para>
{docbook}

{docbook}
<para>The <guilabel>Tag Message</guilabel> form will be displayed.</para>
{docbook}

!images/tag_message.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Give a new tag name in the <guilabel>Tag Name</guilabel> field. This field contains words and keywords which are used to describe the same messages.</para>
{docbook}

Or, tick the checkboxes corresponding to your desired tags from the tags list.

{docbook}
<para>
              <emphasis role="bold">3.</emphasis> Select one color for the tag from the <guilabel>Color</guilabel> drop-down menu.</para>
{docbook}

{docbook}
<para>
              <emphasis role="bold">4.</emphasis> Click <guibutton>Add</guibutton> to finish assigning the tags to your selected messages;</para>
{docbook}

{docbook}
<para xml:id="Untag_messages">
	<citetitle>
		<emphasis role="bold">Untag a message</emphasis>
	</citetitle>
</para>
{docbook}

{docbook}
<para>
   <emphasis role="bold">1.</emphasis> Select a message which has been tagged, then follow <link linkend="Assign_tag_Step_1">Step 1</link> to open the <guilabel>Tag Message</guilabel> form. </para>
{docbook}

{docbook}
<para>
     <emphasis role="bold">2.</emphasis> Click <guilabel>Remove</guilabel> to remove the assigned tag from your selected message.</para>
{docbook}

{docbook}
<note>
<para>
To remove one tag from all messages, simply use the <link linkend="Empty_tag">Empty function.</link>
</para>
</note>
{docbook}

{docbook}
<para xml:id="Edit_tag">
	<citetitle>
		<emphasis role="bold">Edit a tag</emphasis>
	</citetitle>
</para>
{docbook}

{docbook}
 <para>
    <emphasis role="bold">1.</emphasis> Right-click a tag name in the <guilabel>Tags</guilabel> pane, and click <guilabel>Edit</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>The <guilabel>Tag</guilabel> form will appear.</para>
{docbook}

!images/tag.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
              <emphasis role="bold">2.</emphasis> Make changes on the tag, then click <guibutton>Save</guibutton> to save your changes.</para>
{docbook}

{docbook}
<para xml:id="Remove_tag">
	<citetitle>
		<emphasis role="bold">Remove a tag</emphasis>
	</citetitle>
</para>
{docbook}

{docbook}
<para>Right-click the tag that you want to remove in the <guilabel>Tags</guilabel> pane, then select <guilabel>Remove</guilabel> from the drop-down menu.</para>
{docbook}

The selected tag will be removed from the tags list and from all messages.

{docbook}
<para xml:id="Empty_tag">
	<citetitle>
		<emphasis role="bold">Empty a tag</emphasis>
	</citetitle>
</para>
{docbook}

By using this function, you can remove one tag from all messages.

{docbook}
<para>
              <emphasis role="bold">1.</emphasis> Right-click the tag in the <guilabel>Tags</guilabel> pane.</para>
{docbook}

{docbook}
<para>
              <emphasis role="bold">2.</emphasis> Select <guilabel>Empty</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para xml:id="Change_tag_color">
	<citetitle>
		<emphasis role="bold">Change the tag color</emphasis>
	</citetitle>
</para>
{docbook}

{docbook}
<para>Right-click the tag in the <guilabel>Tags</guilabel> pane, then select your desired color from the 32-color palette.</para>
{docbook}

!images/tags_color.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

h2. Categorize by filter {anchor:id="Filter"}
By default, the messages list shows all of your received messages in your inbox but you can filter to specify which message to be displayed.

!images/Filter_message_dropdown.png|align="center" width="30mm" fo:scalefit="1" html:scalefit="0"!

You can filter messages according to the following criteria:
{docbook}
<itemizedlist>
            <listitem>
              <para>
                <guilabel>Unread</guilabel>: Only show unread messages.</para>
            </listitem>

            <listitem>
              <para>
                <guilabel>Starred</guilabel>: Only show starred messages.</para>
            </listitem>

            <listitem>
              <para>
                <guilabel>With Attachments</guilabel>: Only show messages with attachments.</para>
            </listitem>

            <listitem>
              <para>
                <guilabel>View All</guilabel>: Show all types of messages.</para>
            </listitem>
          </itemizedlist>
{docbook}
You can categorize by filter through the following actions:

{docbook}
<para xml:id="Create_new_filter">
	<citetitle>
		<emphasis role="bold">Create a new filter by defining all filter rules</emphasis>
	</citetitle>
</para>
{docbook}

By this way, you need to manually define conditions for the new message filter.

{docbook}
<para>
              <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/filter_icon.png" format="PNG" scalefit="1" width="12mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/filter_icon.png" format="PNG" scalefit="0" width="12mm"/>
                </imageobject>
              </inlinemediaobject> on the <emphasis role="bold">Toolbar</emphasis> to open the <guilabel>Message Filter</guilabel> form.</para>
{docbook}

!images/message_filter.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Click !images/add_new_filter_icon.png|width="5mm" fo:scalefit="1" html:scalefit="0"! or the "Click here to add a new filter" link to create a new filter.

{docbook}
<para>The <guilabel>Add/Edit Message Filter</guilabel> will appear.</para>
{docbook}

!images/add_edit_message_filter.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<informaltable>
              <tgroup cols="2">
                <thead>
                  <row>
                    <entry>Field</entry>
                    <entry>Description</entry>
                  </row>
                </thead>
                <tbody>
                  <row>
                    <entry>
                      <guilabel>Filter Name</guilabel>
                    </entry>
                    <entry>The filter name.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>From</guilabel>
                    </entry>
                    <entry>Filter the email address of sender.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>To</guilabel>
                    </entry>
                    <entry>Filter the email address of recipient.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Subject</guilabel>
                    </entry>
                    <entry>Filter the subject of incoming messages.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Body</guilabel>
                    </entry>
                    <entry>Filter the body of incoming messages.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Move the message to folder</guilabel>
                    </entry>
                    <entry>The folder to which the filtered messages will be moved.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Apply Tag</guilabel>
                    </entry>
                    <entry>Assign the tag to messages matching the filter rules.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Execute now</guilabel>
                    </entry>
                    <entry>Take the action right after editing the filter.</entry>
                  </row>
                </tbody>
              </tgroup>
            </informaltable>
{docbook}

*3.* Define the rules for the new filter.

{docbook}
<para>
   <emphasis role="bold">4.</emphasis> Click <guibutton>Save</guibutton> to finish creating your new filter.</para>
{docbook}

{docbook}
<para xml:id="Create_filter_from_message">
	<citetitle>
		<emphasis role="bold">Create a filter from a message</emphasis>
	</citetitle>
</para>
{docbook}

By this way, you could create a filter which is based on existing conditions of one existing message without defining the filter rules.

*1.* Right-click a message containing the criteria you want to include in your new filter.

!images/filter_message.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>The <guilabel>Add/Edit Message Filter</guilabel> form will appear with some pre-defined filter conditions of the current selected message.</para>
{docbook}

!images/add_edit_message_filter.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
 <emphasis role="bold">2.</emphasis> Modify the rule if necessary, then click <guibutton>Save</guibutton> to finish.</para>
{docbook}

The created filter will be displayed in the list. All messages matching the defined filter rules will be affected.

{docbook}
<para xml:id="Edit_filter">
	<citetitle>
		<emphasis role="bold">Edit a filter</emphasis>
	</citetitle>
</para>
{docbook}

{docbook}
<para>
              <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/filter_icon.png" format="PNG" scalefit="1" width="12mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/filter_icon.png" format="PNG" scalefit="0" width="12mm"/>
                </imageobject>
              </inlinemediaobject> on the <emphasis role="bold">Toolbar</emphasis> to open the <guilabel>Message Filter</guilabel> form.</para>
{docbook}

*2.* Click the filter you want to edit in the left pane. Your selected filter is marked with !images/Selected_filter_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"!.

{docbook}
<para>
              <emphasis role="bold">3.</emphasis> Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/edit_filter.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/edit_filter.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject> on the filter bar to open the <guilabel>Add/Edit Message Filter</guilabel> form.</para>
{docbook}

*4.* Change the filter conditions to your desires.

{docbook}
<para>
   <emphasis role="bold">5.</emphasis> Click <guibutton>Save</guibutton> to complete your changes.</para>
{docbook}

{docbook}
<para xml:id="Delete_filter">
	<citetitle>
		<emphasis role="bold">Delete a filter</emphasis>
	</citetitle>
</para>
{docbook}

{docbook}
<para>
              <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/filter_icon.png" format="PNG" scalefit="1" width="12mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/filter_icon.png" format="PNG" scalefit="0" width="12mm"/>
                </imageobject>
              </inlinemediaobject> on the <emphasis role="bold">Toolbar</emphasis> to open the <guilabel>Message Filter</guilabel> form.</para>
{docbook}

*2.* Click the filter you want to delete, then select !images/delete_filter.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the filter bar.

{docbook}
<para>
   <emphasis role="bold">3.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to accept your deletion.</para>
{docbook}

h1. Search for messages {anchor:id="Search_messagesRoleNotInToc"}
The *Mail* application supports two search modes: [Quick search|#Mail_Quick_search] or [Advanced search|#Mail_Advanced_search].

{docbook}
<para xml:id="Mail_Quick_search">
<citetitle>
<emphasis role="bold">Quick search</emphasis>
</citetitle>
</para>
{docbook}

Quick search allows you to conduct a search with specific keywords in all of your messages. All messages from the different folders that match with your search term will be displayed.

*1.* Enter your search term into the search box in the left pane.

!images/Mail_quick_search.png|align="center" width="50mm" fo:scalefit="1" html:scalefit="0"!

*2.* Click !images/Search_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"!. All messages containing the search term will be listed in the search results.

!images/Mail_quick_search_result.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<note>
    <para>By default, the <emphasis role="bold">Quick Search</emphasis> function of the <emphasis role="bold">Mail</emphasis> application does not retrieve messages of the <emphasis role="bold">Spam</emphasis> and <emphasis role="bold">Trash</emphasis> folders. To do <emphasis role="bold">Quick Search</emphasis> on these folders, simply select these folders before searching.
    </para>
</note>
{docbook}

{docbook}
<para xml:id="Mail_Advanced_search">
<citetitle>
<emphasis role="bold">Advanced search</emphasis>
</citetitle>
</para>
{docbook}

The Advanced Search allows you to specify criteria to narrow your search results.
{docbook}
<para>
          <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/Advanced_search_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/Advanced_search_icon.png" format="PNG" scalefit="0" width="4mm"/>
            </imageobject>
          </inlinemediaobject> in the left pane to open the <guilabel>Advanced Search</guilabel> form.</para>
{docbook}

*2.* Define the search conditions to your details, including:

!images/Advanced_search_form.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<itemizedlist>
          <listitem>
            <para>
              <guilabel>Search in Folder</guilabel>: The folder in which you want to search in the.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>From</guilabel>: The condition corresponding to the sender's name or mail address. There are some further conditions:</para>
          </listitem>
</itemizedlist>
{docbook}


{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Condition</entry>
                <entry>Function</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>contains</guilabel>
                </entry>
                <entry>Include the term in the search box.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>doesn't contain</guilabel>
                </entry>
                <entry>Not include the term in the search box.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>is</guilabel>
                </entry>
                <entry>Include exactly the term in the search box.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>is not</guilabel>
                </entry>
                <entry>Not include exactly the term in the search box.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>starts with</guilabel>
                </entry>
                <entry>Start with the term in the search box.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>does not start with</guilabel>
                </entry>
                <entry>Not start with the term in the search box.</entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
{docbook}

{docbook}
<itemizedlist>
          <listitem>
            <para>
              <guilabel>To</guilabel>: The condition corresponding to the recipient's name or mail address.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Subject</guilabel>: This condition which corresponds to the message subject.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Message</guilabel>: This condition which corresponds to the message content.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Received Before &amp; Received After</guilabel>: The interval time when the searched messages were receipted.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Has Star</guilabel>:  Search for messages with star.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Has Attachment</guilabel>: Search for messages that have the attachment.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Priority</guilabel>: The priority of the search messages.</para>
          </listitem>
        </itemizedlist>
{docbook}
{docbook}
<para>
  <emphasis role="bold">3.</emphasis> Click <guibutton>Search</guibutton> to perform your search.</para>
{docbook}

h1. Add an event {anchor:id="Add_eventRoleNotInToc"}

If you want to invite your colleagues to join a conference or a meeting, you can create an event, invite them or make email notifications to receive reminders right in the *Mail* application.

{docbook}
<para>
          <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/new_event_button.png" format="PNG" scalefit="1" width="14mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/new_event_button.png" format="PNG" scalefit="0" width="14mm"/>
            </imageobject>
          </inlinemediaobject> on the <emphasis role="bold">Toolbar</emphasis> to open the <guilabel>Add Event</guilabel> form.</para>
{docbook}

{docbook}
<para>
  <emphasis role="bold">2.</emphasis> Give basic information for your event in the <guilabel>Event Detail</guilabel> tab, such as setting the event priority, creating repeating events, attaching files.</para>
{docbook}

!images/add_event.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
  <emphasis role="bold">3.</emphasis> Select the <guilabel>Reminders</guilabel> tab to create the event reminder via an email. This step is optional.</para>
{docbook}

!images/add_event_reminder_tab.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
          <emphasis role="bold">4.</emphasis> Click <guibutton>Save</guibutton> to finish adding your event.</para>
{docbook}

h1. Manage Address Book in Mail {anchor:id="Manage_address_books_in_MailRoleNotInToc"}
*Address Book* in the *Mail* application provides you with a list of contacts which can be retrieved for sending your mails. This section will explain some actions related to managing contacts and address books in *Mail* via the following topics:

* [Add a new address book|#Add_address_book]
* [Add a new contact|#Add_new_contact]
* [Edit contact details|#Edit_contact_details]
* [Delete a contact|#Delete_contact]

{docbook}
<citetitle>
    <para xml:id="Add_address_book">
        <emphasis role="bold">Add a new address book</emphasis>
    </para>
</citetitle>
{docbook}

{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/contacts_button.png" format="PNG" scalefit="1" width="14mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/contacts_button.png" format="PNG" scalefit="0" width="14mm"/>
              </imageobject>
            </inlinemediaobject> on the <emphasis role="bold">Toolbar</emphasis> to open the <guilabel>Contacts</guilabel> form.</para>
{docbook}

{docbook}
<para>
  <emphasis role="bold">2.</emphasis> Click <guilabel>Add Address Book</guilabel> to add a new address book.</para>
{docbook}

{docbook}
<para>
            <emphasis role="bold">3.</emphasis> Enter values in fields of the <guilabel>Add Address Book</guilabel> form.</para>
{docbook}

!images/Add_address_book_from_Mail.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<informaltable>
            <tgroup cols="2">
              <thead>
                <row>
                  <entry>Field</entry>
                  <entry>Description</entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry>
                    <guilabel>Name</guilabel>
                  </entry>
                  <entry> The name of your address book that is required.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Description</guilabel>
                  </entry>
                  <entry>The brief description of your address book.</entry>
                </row>
              </tbody>
            </tgroup>
          </informaltable>
{docbook}

{docbook}
<para>
            <emphasis role="bold">3.</emphasis> Click <guibutton>Add</guibutton> to finish adding your address book.</para>
{docbook}

{docbook}
<citetitle>
    <para xml:id="Add_new_contact">
        <emphasis role="bold">Add a new contact</emphasis>
    </para>
</citetitle>
{docbook}

The function is used to add a new contact to a group.

{docbook}
<para>
  <emphasis role="bold">1.</emphasis> Open the <guilabel>Add New Contact</guilabel> form via the following ways.</para>{docbook}

*The first way*

{docbook}
<para>Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/contacts_button.png" format="PNG" scalefit="1" width="14mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/contacts_button.png" format="PNG" scalefit="0" width="14mm"/>
              </imageobject>
            </inlinemediaobject>, then select <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/add_button.png" format="PNG" scalefit="1" width="10mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/add_button.png" format="PNG" scalefit="0" width="10mm"/>
              </imageobject>
            </inlinemediaobject> on the <guilabel>Contacts</guilabel> form.</para>
{docbook}

*The second way*

{docbook}
<para>Right-click a message, then select <guilabel>Add to Contacts</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<note>
<para>
This way is used to add the message sender to a specific address book.
</para>
</note>
{docbook}

{docbook}
<para>The <guilabel>Contact</guilabel> form will appear.</para>
{docbook}

!images/contact_form.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Enter information for your contact. For more details, see the [Create a new contact|#CSUser_guide.How_to_use_Address_book.Create_new_contact] section.

{docbook}
<para>
 <emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to finish adding your contact.</para>
{docbook}

{docbook}
<citetitle>
    <para xml:id="Edit_contact_details">
        <emphasis role="bold">Edit contact details</emphasis>
    </para>
</citetitle>
{docbook}

The function is used to edit a contact in a specific group.

{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Open the <guilabel>Contacts</guilabel> form by clicking <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/contacts_button.png" format="PNG" scalefit="1" width="18mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/contacts_button.png" format="PNG" scalefit="0" width="16mm"/>
              </imageobject>
            </inlinemediaobject> on the <emphasis role="bold">Toolbar</emphasis>.</para>
{docbook}

*2.* Select the contact whom you want to edit in the left pane.

*3.* Click !images/edit_button.png|width="10mm" fo:scalefit="1" html:scalefit="0"!.

{docbook}
<para>
            <emphasis role="bold">4.</emphasis> Change the contact details, then click <guibutton>Save</guibutton> to finish.</para>
{docbook}

{docbook}
<citetitle>
    <para xml:id="Delete_contact">
        <emphasis role="bold">Delete a contact</emphasis>
    </para>
</citetitle>
{docbook}

The function is used to delete a contact from a specific group. This contact will be removed from your address book as well.

{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Open the <guilabel>Contacts</guilabel> form by clicking <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/contacts_button.png" format="PNG" scalefit="1" width="18mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/contacts_button.png" format="PNG" scalefit="0" width="14mm"/>
              </imageobject>
            </inlinemediaobject> on the <emphasis role="bold">Toolbar</emphasis>.</para>
{docbook}

{docbook}
<para>
            <emphasis role="bold">2.</emphasis> Select the contact whom you want to delete in the <guilabel>Address Book</guilabel> form.</para>
{docbook}

{docbook}
<para>
            <emphasis role="bold">3.</emphasis> Select <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/delete_button.png" format="PNG" scalefit="1" width="12mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/delete_button.png" format="PNG" scalefit="0" width="12mm"/>
              </imageobject>
            </inlinemediaobject>, then click <guibutton>OK</guibutton> in the confirmation message to accept your deletion.</para>
{docbook}

{docbook}
<note>
<para>
You cannot delete your own contact from your address book.
</para>
</note>
{docbook}

h1. Change Mail settings {anchor:id="Mail_settingsRoleNotInToc"}
The function allows you to change the behavior and the layout of *Mail* to your needs.

{docbook}
<para>
          <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/settings_button.png" format="PNG" scalefit="1" width="12mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/settings_button.png" format="PNG" scalefit="0" width="12mm"/>
            </imageobject>
          </inlinemediaobject> on the <emphasis role="bold">Toolbar</emphasis> to open the <guilabel>Settings</guilabel> form.</para>
{docbook}

*2.* Change settings for the *Mail* application in 4 tabs: General, Return Receipts, Layout and Delegation.

{docbook}
<para>
          <emphasis role="bold">i.</emphasis> In the <guilabel>General</guilabel> tab, change basic information.</para>
{docbook}

!images/settings.png|align="center" width="130mm" fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Field</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>Select a Default Account</guilabel>
                </entry>
                <entry>Set the default account if you use multiple accounts.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Number of conversations per page</guilabel>
                </entry>
                <entry>Select the number of conversations which will be displayed per page from the list: 10, 20, 30, or 70 messages.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Automatically check messages every</guilabel>
                </entry>
                <entry>Select the time interval to automatically check the system, including 6 available options: Never, 5 minutes, 10 minutes, 20 minutes, 30 minutes and 1 hour.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Compose message with</guilabel>
                </entry>
                <entry>Select the editor type for composing messages, including <emphasis role="bold">Rich Text</emphasis> and <emphasis role="bold">Plain Text</emphasis>.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Reply to message with</guilabel>
                </entry>
                <entry>
                  <para> Select the message type to reply, including <informalexample>
                      <informalexample/>
                    </informalexample> -  <guilabel>Original message as attachment:</guilabel> Reply to messages with attachments. <informalexample>
                      <informalexample/>
                    </informalexample> - <guilabel>Original message text quoted:</guilabel> Reply to messages with text only.</para>
                </entry>
              </row>
              <row>
                <entry>
                  <guilabel>Forward message with</guilabel>
                </entry>
                <entry>
                  <para> Select the message type to reply, including <informalexample>
                      <informalexample/>
                    </informalexample> - <guilabel>Original message as attachment:</guilabel> Forward messages with attachment. <informalexample>
                      <informalexample/>
                    </informalexample> - <guilabel>Original message text quoted:</guilabel> Forward messages with text only.</para>
                </entry>
              </row>
              <row>
                <entry>
                  <guilabel>Save sent messages in the 'Sent' folder</guilabel>
                </entry>
                <entry> Tick this checkbox to save sent messages in the 'Sent' folder.</entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
{docbook}

{docbook}
<para>
          <emphasis role="bold">ii.</emphasis> In the <guilabel>Return Receipts</guilabel> tab, set options to specify what the <emphasis role="bold">Mail</emphasis> application should do when it gets a "<link linkend="Change_message_preferences">Return Receipt</link>" request. It means that you can determine whether to send a notification of having read the message to the sender or not. <anchor id="Return_Receipts_settings"/>
        </para>
{docbook}

!images/Mail_return_receipts.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Field</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>Ask me when someone requests a return receipt</guilabel>
                </entry>
                <entry>If you receive a message with the <emphasis role="bold">Return Receipt</emphasis> request, the <emphasis role="bold">Mail</emphasis> application will show a pop-up message for you to decide sending a notification of having read the message to the sender or not.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Never send a return receipt</guilabel>
                </entry>
                <entry> The <emphasis role="bold">Mail</emphasis> application will ignore all <emphasis role="bold">Return Receipt</emphasis> requests from senders.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Always send a return receipt</guilabel>
                </entry>
                <entry> If you receive a message with the <emphasis role="bold">Return Receipt</emphasis> request, the <emphasis role="bold">Mail</emphasis> application will automatically send a notification of having read the message to the sender without asking for your permission.</entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
{docbook}
{docbook}
<para>
          <emphasis role="bold">iii.</emphasis> In the <guilabel>Layout</guilabel> tab, personalize the <guilabel>Mail</guilabel> layout by ticking another checkbox corresponding to your desired layout. The <guilabel>Horizontal Split</guilabel> type is set by default.</para>
{docbook}

!images/settings2.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!
{docbook}
<para>
          <emphasis role="bold">iv.</emphasis> In the <guilabel>Delegation</guilabel> tab, delegate your account to any registered user in the system as follows:</para>
{docbook}

!images/Mail_delegation.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<itemizedlist>
          <listitem>
            <para>Select the account you want to delegate from the <guilabel>This account</guilabel> list by clicking <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/down_arrow_icon1.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/down_arrow_icon1.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject>.</para>
          </listitem>
          <listitem>
            <para>Enter the name of user to whom you want to delegate your selected account in the <guilabel>will be delegated to</guilabel> field.</para>
          </listitem>
          <listitem>
            <para>Tick the <guilabel>Full</guilabel> checkbox next to <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/Add_delegated_user.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/Add_delegated_user.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject> if you want to assign all permissions, which can be done on your selected account, to the delegated user. If this checkbox is not selected, the user can only view mails of the delegated account.</para>
          </listitem>
          <listitem>
            <para>Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/Add_delegated_user.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/Add_delegated_user.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject> to accept adding your delegated user. The delegated user will be updated in the Accounts table. In this table, you can revoke the <emphasis role="bold">Full</emphasis> permission or add the <emphasis role="bold">Full</emphasis> permission to your delegated accounts by unticking or ticking the relevant checkbox respectively in the <guilabel>Full</guilabel> column of the Accounts table.</para>
          </listitem>
</itemizedlist>
{docbook}

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to accept your changes.</para>
{docbook}
