diff options
Diffstat (limited to 'doc/C/usage-mail.sgml')
| -rw-r--r-- | doc/C/usage-mail.sgml | 394 |
1 files changed, 283 insertions, 111 deletions
diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml index de2f3b0a23..8785231686 100644 --- a/doc/C/usage-mail.sgml +++ b/doc/C/usage-mail.sgml @@ -44,21 +44,20 @@ in case you need to refer to it later, you'll find that feature especially useful. </para> + </abstract> - <para> + <sect1 id="usage-mail-getnsend"> + <title>Reading, Getting and Sending Mail</title> + <sect2 id="usage-mail-getnsend-read"> + <title>Reading Mail</title> + <para> You can start reading email by clicking <guibutton>Inbox</guibutton> in the shortcut bar. By default, the <interface>Inbox</interface> is open when you start <application>Evolution</application>, and the first time you see your inbox, there's a message in it from Helix Code welcoming you to the application. - </para> - </abstract> - - <sect1 id="usage-mail-getnsend"> - <title>Reading, Getting and Sending Mail</title> - <sect2 id="usage-mail-getnsend-read"> - <title>Reading a Message</title> + </para> <para> The first time you open your <application>Evolution</application> @@ -75,10 +74,10 @@ <variablelist> <varlistentry> - <term><guimenuitem>View Message</guimenuitem> </term> + <term><guimenuitem>Open in New Window</guimenuitem> </term> <listitem><para> Select this item to view the message in - the view pane of the <application>Evolution</application> + a new <application>Evolution</application> window. </para></listitem> </varlistentry> @@ -141,38 +140,124 @@ from a folder tree. </para></listitem> </varlistentry> - </variablelist> - </para> - - <para> - You can also select the order in which messages appear in - that list. To sort by sender, subject, or date, click on the - bars with those labels at the top of the message list. If - you click twice, you'll sort them in reverse order. - </para> + + <varlistentry> + <term><guimenuitem>vFolder for Subject</guimenuitem></term> + <listitem><para> + Select this item to create a pre-fabricated vFolder based on + the current message's Subject line. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>vFolder for Sender</guimenuitem></term> + <listitem><para> + Select this item to create a pre-fabricated vFolder based on + who sent the current message. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>vFolder for Recipients</guimenuitem></term> + <listitem><para> + Select this item to create a pre-fabricated vFolder based on + who the recipients are. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>Filter for Subject</guimenuitem></term> + <listitem><para> + Select this item to create a pre-fabricated filter based on + the current message's Subject line. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>Filter for Sender</guimenuitem></term> + <listitem><para> + Select this item to create a pre-fabricated filter based on + who sent the current message. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>Filter for Recipients</guimenuitem></term> + <listitem><para> + Select this item to create a pre-fabricated filter based on + who the recipients are. + </para></listitem> + </varlistentry> + </variablelist> + </para> + + <note id="usage-mail-listorder"> + <title>The Order of the Message List</title> + <para> + You can also select the order in which messages appear in + that list. To sort by sender, subject, or date, click on the + bars with those labels at the top of the message list. If + you click twice, you'll sort them in reverse order. + </para> + <para> + Aside from sorting the messages, you can opt to have the + messages threaded. Select <menuchoice> + <guimenu>View</guimenu> <guimenuitem>Threaded Message + List</guimenuitem> </menuchoice> to turn the threaded view + on or off. If the option selected, + <application>Evolution</application> will attempt to + associate related messages by using the + <systemitem>References</systemitem>, + <systemitem>In-Reply-To</systemitem>, and + <systemitem>Subject</systemitem> message headers. Messages + which are related are then placed next to each other, so + that it's easier to follow the thread of a conversation from + message to message. + </para> + </note> <para> - Aside from sorting the messages, you can opt to have the - messages threaded. Select <menuchoice> - <guimenu>View</guimenu> <guimenuitem>Threaded Message - List</guimenuitem> </menuchoice> to turn the threaded view on - or off. If the option selected, - <application>Evolution</application> will attempt to - associate related messages by using the - <systemitem>References</systemitem>, - <systemitem>In-Reply-To</systemitem>, and - <systemitem>Subject</systemitem> message headers. Messages - which are related are then placed next to each other, so that - it's easier to follow the thread of a conversation from - message to message. + Other actions you can perform are listed, appropriately, in + the <guimenu>Actions</guimenu> menu in the menu bar: + <variablelist> + <varlistentry> + <term><guimenuitem>Mark all Messages Read</guimenuitem></term> + <listitem><para> + <application>Evolution</application> keeps track of which + messages you have read, and which ones you haven't: + When you've looked at a message for more than a few seconds, + it's no longer marked as new. If you want to mark all mail + in a folder as read, select this item. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>View Message</guimenuitem></term> + <listitem><para> + <guimenuitem>View Message</guimenuitem> opens the selected message + in its own window. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>Edit Message</guimenuitem></term> + <listitem><para> + Only available for messages you have written (drafts and + mail in the <guilabel>Outbox</guilabel>, this item opens the message + in a new mail composition window. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>Expunge</guimenuitem></term> + <listitem><para> + Clicking the <guibutton>Delete</guibutton> button marks + messages for deleteion. <guimenuitem>Expunge</guimenuitem> + wipes them off the face of the earth. + </para></listitem> + </varlistentry> + </variablelist> </para> <para> - Go ahead and click on the message in the <interface>message - list</interface>. That selects the message. Then click on - the <guibutton>Delete</guibutton> button in the tool bar. The - message now has a line through it, because you've marked it - for deletion. If you really want to get rid of it, choose - <guimenuitem>Expunge</guimenuitem> from the - <guimenu>Tools</guimenu> menu. That will delete it + Now that you've had a look around the + <interface>Inbox</interface>, select the welcome message in + the <interface>message list</interface> by clicking on it + once. Then click on the <guibutton>Delete</guibutton> button + in the tool bar. The message now has a line through it, + because you've marked it for deletion. If you really want to + get rid of it, choose <guimenuitem>Expunge</guimenuitem> from + the <guimenu>Actions</guimenu> menu. That will delete it permanently. If you want to keep it, click <guibutton>Delete</guibutton> again, and it will no longer be marked as deleted. At some point in the future, this feature @@ -300,39 +385,75 @@ <guibutton>Send</guibutton>. That's easy. It may even be too easy, which is why I like to queue my messages up to be sent a few minutes later. - - <tip id="usage-mail-getnsend-send-attach-tip"> - <title>Send Now, Send Later</title> - <para> - Evolution will send mail immediately unless you tell it to - do otherwise by selecting <guimenuitem>Send - Later</guimenuitem> from the <guimenu>MENU</guimenu> in - the message composition window. Then, when you press - <guibutton>Send</guibutton>, all your unsent messages will - go out at once. I like to use "Send Later" because it - gives me a chance to change my mind about a message before - it goes out. That way, I don't send anything I'll regret - the next day. - </para> - <para> - To learn more about how you can specify message queue - and filter behavior, see <xref linkend="config-prefs-mail">. - </para> - </tip> </para> - - <para> - You can probably guess the purpose of the buttons labelled - <guilabel>Cut</guilabel>, <guilabel>Copy</guilabel>, - <guilabel>Paste</guilabel> and <guilabel>Undo</guilabel>, but - there's a bit more to sending mail that's less obvious. In - the next few sections, you'll see how - <application>Evolution</application> handles additional - features, including mailing lists, attachments, and - forwarding. - </para> - - + <sect3 id="usage-mail-getnsend-send-delay"> + <title>Saving Messages for Later</title> + <para> + Evolution will send mail immediately unless you tell it to + do otherwise by selecting <menuchoice> + <guimenu>File</guimenu> <guimenuitem>Send + Later</guimenuitem></menuchoice>. That will add messages to the + <guilabel>Outbox</guilabel> queue. Then, when you press + <guibutton>Send</guibutton> in another message, or + <guibutton>Get Mail</guibutton> in the main mail window, + all your unsent messages will go out at once. I like to + use "Send Later" because it gives me a chance to change my + mind about a message before it goes out. That way, I don't + send anything I'll regret the next day. + </para> + <para> + You can also choose to save messages as drafts or as text + files. Choose + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Save</guimenuitem> + </menuchoice> + or <guimenuitem>Save As</guimenuitem> to save your message + as a text file. If you prefer to keep your message in a + folder (the <guilabel>Drafts</guilabel> folder would be the + obvious place), you can select <menuchoice> + <guimenu>File</guimenu> <guimenuitem>Save In + Folder</guimenuitem> </menuchoice>. + </para> + <para> + To learn more about how you can specify message queue and + filter behavior, see <xref linkend="config-prefs-mail">. + </para> + + <para> + You can probably guess the purpose of the buttons labelled + <guibutton>Cut</guibutton>, <guibutton>Copy</guibutton>, + <guibutton>Paste</guibutton>, <guibutton>Undo</guibutton> + and <guibutton>Redo</guibutton> , but there's a bit more to + sending mail that's less obvious. In the next few sections, + you'll see how <application>Evolution</application> handles + additional features, including mailing lists, attachments, + and forwarding. + </para> + </sect3> + <sect3 id="usage-mail-getnsend-send-attach"> + <title>Attachments</title> + <para> + If you want to attach a file to your email message, you + can drag it from your desktop into the message window, or + click the button in the toolbar with a paper clip on it, + labelled <guibutton>Attach</guibutton>. If you click the + <guibutton>Attach</guibutton> button, + <application>Evolution</application> will open a file + selection dialog box, to ask you which file you want to + send. Select the file and click <guilabel>OK</guilabel>. + </para> + <para> + To see what files you've attached to the message you're + composing, select <menuchoice> <guimenu>View</guimenu> + <guimenuitem>Show Attachments</guimenuitem> </menuchoice>. + </para> + <para> + When you send the message, a copy of the attached file + will go with it. Be aware that big attachments can take a + long time to download. + </para> + </sect3> <sect3 id="usage-mail-getnsend-send-to"> <title>Choosing Recipients</title> <para> @@ -340,9 +461,13 @@ you can also enter nicknames or other portions of address data, and <application>Evolution</application> will complete the address for you. <!-- (INSERT description of UI for this - feature, once it is decided upon). --> If you enter a name or - nickname that can go with more than one card, Evolution will - open a dialog box to ask you which person you meant. + feature, once it is decided upon). --> If you enter a name + or nickname that can go with more than one card, Evolution + will open a dialog box to ask you which person you meant. + <!-- (NOT YET) Also, <application>Evolution</application> + will add a domain to any unqualified addresses. By default, + this is your domain, but you can choose which one mail + preferences dialog. --> </para> <para> Alternately, you can click on the @@ -362,11 +487,11 @@ <sect4 id="usage-mail-getnsend-send-to-mult"> <title>Multiple Recipients</title> <para> - In addition, you can mark recipients in three different - ways. The <guilabel>To:</guilabel> field is for the - primary recipients of the message you are going to send. - However, it is considered bad form to have more than a few - email addresses in this section. + You can address your email in three different ways. The + <guilabel>To:</guilabel> field is for the primary + recipients of the message you are going to send. However, + it is considered bad form to have more than a few email + addresses in this section. </para> <para> If you're writing to one person, but want to keep a third @@ -471,7 +596,61 @@ with quoted materials and the relevant replies interspersed--> </example> </para> </sect3> + <sect3 id="usage-mail-getnsend-send-find"> + <title>Searching and Replacing with the Composer</title> + <para> + You're probably familiar with search and replace features, + and if you come from a Linux or Unix background, you + probably know what <guimenuitem>Find Regex</guimenuitem> + does. If you aren't among the lucky who already know, + here's a quick rundown of an important section of the + <guimenu>Edit</guimenu> menu. + </para> + <para> + <variablelist> + <varlistentry> + <term><guimenuitem>Find</guimenuitem></term> + <listitem><para> Enter a word or phrase, and + <application>Evolution</application> will find it + in your message. + </para></listitem> + </varlistentry> + + <varlistentry> + <term><guimenuitem>Find Regex</guimenuitem></term> + <listitem> + <para> + Regular expressions, often called "regex" for short, + are a powerful way of expressing complicated + statements using metacharacters or wildcard symbols. + For example, the statement + <userinput>fly*so[a|u]p</userinput> means "any + phrase beginning with 'fly' and ending in 'soup' or + 'soap'", so you'd find both "fly in my soup" and + "fly in my soap." There's not room here to go into + depth here, but if you want, have a look at the + documentation for the <command>grep</command> + command. + </para></listitem> + </varlistentry> + + <varlistentry> + <term><guimenuitem>Find Again</guimenuitem></term> + <listitem><para> + Select this item to repeat the last search you performed. + </para></listitem> + </varlistentry> + + <varlistentry> + <term><guimenuitem>Replace</guimenuitem></term> + <listitem><para> Find something, replace it with + something else. </para></listitem> + </varlistentry> + </variablelist> + + </para> + </sect3> <sect3 id="usage-mail-getnsend-send-html"> <title>Embellish your email with HTML</title> <para> @@ -493,18 +672,13 @@ with quoted materials and the relevant replies interspersed--> get very angry if you send them HTML mail, which is why <application>Evolution</application> sends plain text unless you explicitly ask for HTML. To send HTML mail, - you will need to select <menuchoice> <guimenuitem> - HTML</guimenuitem></menuchoice> in the mail settings dialog box. See - <xref linkend="config-prefs-mail-other"> for more information. + you will need to select <menuchoice> + <guimenu>Format</guimenu> <guimenuitem> + HTML</guimenuitem></menuchoice>. Alternately, you can set + your default mail format preferences in the mail + configuration dialog. See <xref + linkend="config-prefs-mail-other"> for more information. </para> - <para> - If you format a message with HTML, but do not have - <guilabel>Send Messages as HTML</guilabel> enabled in your - mail settings, the composer will remove your text styles. - It will, however, preserve indentation and lists. The - same is true for individuals in your address book whom you - have not marked as wanting to receive HTML mail. - </para> </note> <para> HTML formatting tools are located just above the @@ -625,24 +799,7 @@ with quoted materials and the relevant replies interspersed--> </para> </note> </sect3> - <sect3 id="usage-mail-getnsend-send-attach"> - <title>Attachments</title> - <para> - If you want to attach a file to your email message, you - can drag it from your desktop into the message window, or - click the button in the toolbar with a paper clip on it, - labelled <guibutton>Attach</guibutton>. If you click the - <guibutton>Attach</guibutton> button, - <application>Evolution</application> will open a file - selection dialog box, to ask you which file you want to - send. Select the file and click <guilabel>OK</guilabel>. - </para> - <para> - When you send the message, a copy of the file will - go with it. Be aware that big attachments can take a long - time to download. - </para> - </sect3> + <!-- Function not implemented, possibly never will be due to security evil. --> @@ -706,8 +863,8 @@ possibly never will be due to security evil. --> <para> Don't send spam or forward chain mail. If you must, watch out for hoaxes and urban legends, and make sure - the message doesn't have multiple layers of email - quotation symbols (>) indicating multiple layers + the message doesn't have multiple layers of + greater-than signs, (>) indicating multiple layers of careless inline forwarding. </para> </listitem> @@ -722,7 +879,8 @@ possibly never will be due to security evil. --> <listitem> <para> - ALL CAPS MEANS YOU'RE SHOUTING! + ALL CAPS MEANS YOU'RE SHOUTING! Don't write a whole + message in capital letters. It hurts people's ears. </para> </listitem> @@ -1130,3 +1288,17 @@ possibly never will be due to security evil. --> </sect1> </chapter> + + + + + + + + + + + + + + |