aboutsummaryrefslogtreecommitdiffstats
path: root/doc/C/usage-mail.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/C/usage-mail.sgml')
-rw-r--r--doc/C/usage-mail.sgml644
1 files changed, 0 insertions, 644 deletions
diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml
deleted file mode 100644
index c81c384cfb..0000000000
--- a/doc/C/usage-mail.sgml
+++ /dev/null
@@ -1,644 +0,0 @@
-
- <chapter id="usage-mail">
- <title>Evolution Mail: Witty Phrase to Come Later</title>
- <abstract>
- <title> An Overview of the Evolution Mailer</title>
- <para>
- Email is an integral part of life these days, and
- <application>Evolution</application> mail is here to help
- you keep track of it. <application>Evolution</application>
- email is like other email programs in all the ways you would
- hope: (INSERT GOOD SIMILARITIES).
- </para>
- <para>
- However, <application>Evolution</application> has some
- important differences. First, it's built to handle very
- large amounts of mail without slowing down or crashing. We
- had high mail volumes in mind when we designed our <link
- linkend="usage-mail-organize-filters">filtering</link> and
- <link linkend="usage-mail-organize-search">searching</link>
- functions. There's also the
- <application>Evolution</application> <link
- linkend="usage-mail-organize-vFolders">vFolder</link>, an
- advanced organizational feature not found in other mail
- clients. If you get a lot of mail, or if you keep every
- message you get in case you need to refer to it later,
- you'll find that feature especially useful.
- </para>
-
- <para>
- You can start reading email by clicking
- <guibutton>Inbox</guibutton> in the shortcut bar.
- </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>
- The first time you open your
- <application>Evolution</application>
- <guilabel>Inbox</guilabel>, you will see a window like the
- one in <xref linkend="usage-mail-intro-fig">, with a
- message from Helix Code in the<interface> message
- list</interface>. A preview of the message is displayed
- below that, in the <interface>view pane</interface>. If
- you find the<interface> view pane</interface> too small,
- you can double-click on the message in the
- <interface>message list</interface> to have it open in a
- new window. As is the case with folders, you can
- right-click on messages in the message list and get a
- menu of possible actions.
- </para>
- <para>
- Go ahead and right-click on the message, and select
- <guimenuitem>Delete Message</guimenuitem> from the menu
- that appears. The message will move into the
- <guilabel>Trash</guilabel> folder. If you want to keep
- it, you can open the <guilabel>Trash</guilabel> folder
- and drag the message back to your
- <guilabel>Inbox</guilabel>. The trash will be
- automatically emptied the next time you quit
- <application>Evolution</application>. (FEATURE
- UNIMPLEMENTED! Text may change to fit featureset)
-
- <!-- ==============Figure=================================== -->
- <!-- MAKE SURE THIS SCREENSHOT HAS THE WELCOME MESSAGE! -->
- <figure id="usage-mail-intro-fig">
- <title>Evolution Mail</title>
- <screenshot>
- <screeninfo>Evolution Mail</screeninfo>
- <graphic fileref="mail-intro-pic" format="png" srccredit="Aaron Weber">
- </graphic>
- </screenshot>
- </figure>
- <!-- ==============End of Figure=================================== -->
- </para>
- </sect2>
-
- <sect2 id="usage-mail-getnsend-get">
- <title>Getting Mail</title>
- <para>
- To check your email, just click <guibutton>Send and
- Receive</guibutton> in the toolbar.
- <application>Evolution</application> will download your
- mail for you and send any mail you've marked ready to
- send. New mail will appear in your
- <interface>Inbox</interface> and also in the
- <interface>Today View</interface>.
- </para>
- <para>
- If you get an error message, you probably need to
- change your network preferences. To do that, you can run
- the setup assistant again, have a look at <xref
- linkend="config-prefs-network">, or ask your system
- administrator.
- </para>
-
- <sect3 id="usage-mail-getnsend-get-attach">
- <title>Attachments, HTML Mail, and Live Documents</title>
- <para>
- If you receive a file attached to an email,
- <application>Evolution</application> will ask where you
- want to put it. Once you've downloaded it, you can
- open, move, copy, or execute those files just like any
- others, using <application>Nautilus</application> or
- your favorite shell or file manager.
- </para>
- <para>
- <application>Evolution</application> can also display
- HTML-formatted mail, complete with graphics. HTML
- formatting will display automatically, although you can
- turn it off if you prefer.
- </para>
- <para>
- It can also display <glossterm>live
- documents</glossterm>, which have scripted or
- executable contents&mdash; for example, a working
- spreadsheet page or a chess game.
- </para>
- <tip id="badidea-attachment">
- <title>Bad Idea</title>
- <para>
- When someone you don't know sends you an attached
- program, go ahead and run it. Set your preferences to
- always run live documents when you recieve them, too.
- Everybody knows all that virus stuff is just a Windows
- problem.
- </para>
- </tip>
- </sect3>
- </sect2>
-
- <sect2 id="usage-mail-getnsend-send">
- <title>Writing and Sending Mail</title>
- <para>
- You can start writing a new
- email message by selecting <guimenuitem>New
- Mail</guimenuitem> from the <guimenu>File Menu</guimenu>,
- or by pressing <keysym>Ctrl-N</keysym>. When you do so,
- the <interface>New Message</interface> window will open,
- as shown in <xref linkend="usage-mail-newmsg-fig">.
- </para>
-
-<!-- ==============Figure=================================== -->
- <figure id="usage-mail-newmsg-fig">
- <title>New Message Window</title>
- <screenshot>
- <screeninfo>Evolution Main Window</screeninfo>
- <graphic fileref="newmsg-pic" format="png" srccredit="Aaron Weber">
- </graphic>
- </screenshot>
- </figure>
-<!-- ==============End of Figure=================================== -->
-
- <para>
- Enter an address in the <guilabel>To:</guilabel> field, a
- message in the <guilabel>Message:</guilabel> field, and
- press <guibutton>Send and Receive</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>.
- Then, when you press <guibutton>Send &
- Receive</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>
- There is more to sending mail, though. In the
- next few sections, we'll go over additional features,
- including mailing lists, attachments, and forwarding.
- </para>
-
-
- <sect3 id="usage-mail-getnsend-send-to">
- <title>Choosing Recipients</title>
- <para>
- If you have created address cards in the contact
- manager, 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. (QUESTION: will users be able to drag & drop
- address cards to send email?). For more information
- about using email together with the contact manager and
- the calendar, see <xref
- linkend="usage-contact-automate"> and <xref
- linkend="usage-calendar-apts-group">.
- </para>
- <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.
- </para>
- <para>
- If you're writing to one person, but want to keep a
- third party up to date, you can use
- <guilabel>Cc:</guilabel>. Hearkening back to the dark
- ages when people used typewriters and there were no copy
- machines, "Cc" stands for "Carbon Copy." Use it
- whenever you want to share a message you've written to
- someone else.
- <example>
- <title>Using the Cc: field</title>
- <para>
- Say, for example, Susan sends an email to a client.
- She puts her co-worker, Tim, in the in the
- <guilabel>Cc:</guilabel> field, so that he know
- what's going on. The client can see that Tim also
- recieved the message, and know that they can talk
- to Tim about the message as well.
- </para>
- </example>
- </para>
- <para>
- If you have a large number of recipients, or if you want
- to send mail to several people without sharing the
- recipient list, you should use
- <guilabel>BCc:</guilabel>. "BCc" stands for "Blind
- Carbon Copy", and means that addresses in the
- <guilabel>BCc:</guilabel> field will receive copies of
- the message, but they will not receive the list of the
- other recipients' addresses, nor will other recipients
- know that they have recieved the message. When I send a
- generic message to all my friends and I want them to
- think I've written a personalized email to every one of
- them, I put them all in the <guilabel>BCc:</guilabel>
- list.
- </para>
- </sect3>
-
- <sect3 id="usage-mail-getnsend-send-reply">
- <title>Replying to Messages</title>
- <para>
- In order to reply to a message, click on it once in the
- message list to select it. Then press the
- <guibutton>Reply</guibutton> button, or use the
- <keysym>REPLY COMBO</keysym> hot key. A window like
- the <interface>New Message</interface> window will
- appear, but the subject will already be present&mdash;
- typically, your new message will have the same subject
- as the message to which you are replying, but with Re:
- before it, to mark it as a reply. In addition, the
- full text of the previous message may be inserted into
- the new message, with the &gt; character before each
- line. This indicates quoting. You can intersperse
- your message with the quoted material as shown in <xref
- linkend="usage-mail-getnsend-reply-fig">
-
-<!-- note that this figure should have a reply mail ready to send, with quoted materials and the relevant replies interspersed-->
-<!-- ==============Figure=================================== -->
- <figure id="usage-mail-getnsend-reply-fig">
- <title>Reply Message Window</title>
- <screenshot>
- <screeninfo>Evolution Main Window</screeninfo>
- <graphic fileref="replymsg-pic" format="png" srccredit="Aaron Weber">
- </graphic>
- </screenshot>
- </figure>
-<!-- ==============End of Figure=================================== -->
-
- </para>
-
- <para>
- If a message has several recipients, as in the case of
- mailing lists or messages that have been carbon copied,
- you may wish to select one of the items under the
- <guimenuitem>Reply-To</guimenuitem> submenu on the
- <guimenu>MENU</guimenu> menu. This will allow you to
- choose one or several of the other message recipients in
- addition to the person who originally sent you the
- message.
- <example>
- <title>Using the Reply-To feature</title>
- <para>
- Returning to the previous example, the client can
- decide whether to reply just to Susan, just to Tim,
- or to both of them by selecting a menu item, rather
- than by cutting and pasting the email addresses. If
- there are large numbers of people in the Cc: fields,
- this can save substantial amounts of time.
- </para>
- </example>
- </para>
- </sect3>
-
-
- <sect3 id="usage-mail-getnsend-send-fancy">
- <title>Embellishing that email</title>
- <para>
- <application>Evolution</application> allows you to
- make your email more attractive in a number of ways. You
- can send messages formatted with HTML, attach any sort
- of file to them, and even include live documents, like
- spreadhseets or chess games. This section will tell
- you how.
- </para>
-
-
- <sect4 id="usage-mail-getnsend-send-html">
- <title>Colors, pictures, and fonts with HTML Mail</title>
- <para>
- Most email messages are sent as plain text, but they
- can also be sent as HTML, which means they can include
- color, text style, and other formatting information.
- Evolution will read and display HTML properly without
- trouble, and also allows you to send outgoing
- email messages as HTML. To send an HTML message, just
- use the composition toolbar to add formatting;
- your message text will appear formatted in the composer
- window, and the message will be sent as HTML.
- </para>
- <note>
- <title>A Technical note on HTML Tags</title>
- <para>
- Any text, including HTML tags, entered into the
- message composition window is assumed to be plain
- text. If you enter HTML directly into the
- composer&mdash; say, <markup
- role="html">&lt;BR&gt;Bold Text&lt;/BR&gt</markup>,
- the the composer will assume you meant exactly that,
- and not "make this text bold," as a HTML composition
- tool would. For the technically inclined, that
- means that when the text <markup
- role="html">&lt;BR&gt</markup> is sent as HTML, it
- will be converted to the string
- <literal>&amp;lt;BR&amp;gt;</literal>.
- </para>
- </note>
- <para>
- Some people do not have HTML-capable mail clients, or
- prefer not to receive HTML-enhanced mail because it
- is slower to download and display. Some people refer
- to HTML mail as "the root of all evil" and get very
- angry if you send them HTML mail, which is why the
- default in <application>Evolution</application> is
- plain text. If you have an address book entry for
- someone who does not wish to receive HTML-enhanced
- mail, you can note that preference in their address
- card. The mailer will automatically strip the HTML
- tags from any messages you send to that address.
- </para>
- </sect4>
-
- <sect4 id="usage-mail-getnsend-send-attach">
- <title>Attachments</title>
- <para>
- If you want to attach a file to your email message,
- you can do so by <!--describe process here-->. If
- your recipients can read HTML mail, you can put an
- image inside the mail by dragging the file into the
- composer window, or by selecting (INSERT DESCRIPTION
- HERE) (IS THIS CORRECT?). Still, unless you know what
- email client the recipient is using, it's best to send
- a message or attachment in the simplest manner
- possible.
- </para>
- </sect4>
- <sect4 id="usage-mail-getnsend-send-live">
- <title></title>
- <para>
- Later versions of <application>Evolution</application>
- will allow you to enliven your email with almost any
- sort of document, and even with entire
- applications. At this point, however, I don't know how
- that will work.
- </para>
- </sect4>
- </sect3>
-
- <sect3 id="usage-getnsend-fwd">
- <title>Forwarding Mail</title>
- <para>
- <guilabel>Forward</guilabel> is useful if you have
- received a message and you think someone else would like
- to see it, or if you get a message intended for someone
- else. You can forward a message as an attachment to a
- new message (the default way of forwarding) or you can send it
- <glossterm>inline</glossterm> as a quoted portion of the
- message you are sending. Attachment forwarding is best
- if you want to send the entire message you received,
- unaltered. Inline forwarding is best if you want to
- send portions of a message, or if you have a large
- number of comments on different sections of the message
- you are forwarding. Remember to note from whom the
- message came, and where, if at all, you have removed or
- altered content.
- </para>
- <para>
- To forward a message, first make sure it is selected by
- clicking it once in the message list. Then, press
- <guibutton>Forward</guibutton> on the toolbar, or select
- SOMETHING. To forward a message inline instead of as an
- attachment, DO SOMETHING ELSE. Choose an addressee as
- you would when sending a new message; the subject will
- already be entered, but you can alter it. Enter your
- comments on the message in the <interface>composition
- frame</interface>, and press <guibutton>Send and
- Receive</guibutton>. To forward it
- <glossterm>inline</glossterm> instead of attached,
- select <guimenuitem>Forward Inline</guimenuitem> from
- the <guimenu>Message</guimenu> menu.
- </para>
- </sect3>
- <sect3 id="usage-mail-getnsend-ettiquette">
- <title>Seven Tips for Email Usage</title>
- <para>
- I started with ten, but four were "Don't send
- <glossterm>spam</glossterm>."
- <itemizedlist>
- <listitem>
- <para>
- Always begin and close with a salutation. Say
- "please" and "thank you", just like you do in real
- life. You can keep your pleasantries short, but be pleasant!
- </para>
- </listitem>
-
- <listitem>
- <para>
- ALL CAPS MEANS YOU'RE SHOUTING!
- </para>
- </listitem>
-
- <listitem>
- <para>
- Never write anything in email you wouldn't say in
- public. Old messages have a nasty habit of
- resurfacing when you least expect them to.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Check your spelling and use complete sentences.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Don't send nasty emails (flames). If you get one,
- don't write back.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Don't send spam or forward chain mail. If you
- must, verify any rumors, and make sure the
- message doesn't have multiple layers of email
- quotation symbols (&gt;) indicating multiple
- layers of careless inline forwarding.
- </para>
- </listitem>
-
- <listitem>
- <para>
- When you reply or forward, include just enough of
- the previous message to provide context. Not too
- much, not too little.
- </para>
- </listitem>
- </itemizedlist>
- </para>
- <para> Happy mailing! </para>
- </sect3>
- </sect2>
- </sect1>
-
- <sect1 id="usage-mail-organize">
- <title>Organizing Your Mail</title>
- <para>
- Even if you only get a few email messages a day, you
- probably want to sort and organize them. When you get a
- hundred a day and you want to refer to a message you
- received six weeks ago, you need to sort and organize them,
- and <application>Evolution</application> has the tools to
- help you do it.
- </para>
-
- <sect2 id="usage-mail-organize-folders">
- <title>Getting Organized with Folders</title>
- <para>
- You can create new folders by selecting
- <guimenuitem>ITEM</guimenuitem> from the
- <guimenu>MENU</guimenu>, or by pressing
- <keysym>COMBO</keysym>. (Will there be a dialog box to
- determine name and location? Must wait for feature to
- describe) The new folders will appear in the
- <interface>tree view</interface>, and you can drag them
- wherever you want to relocate them. You can move messages
- into them by dragging, or by selecting them and choosing
- <guimenuitem>ITEM</guimenuitem> from the
- <guimenu>MENU</guimenu>. An email message can be in only
- one folder at a time, just like real mail in real folders.
- This is also the case for folders of address cards and calendar
- information.
- </para>
- </sect2>
-
- <sect2 id="usage-mail-organize-search">
- <title>Searching for Messages</title>
- <para>
- Because <application>Evolution</application> automatically
- creates an index of every email you send or receive, it
- can search through your old messages and present you with
- results very quickly. You can search for messages by
- author, subject, keyword, or headers. (INSERT descriptons
- of what those terms mean)
- </para>
- <para>
- (INSERT the way one creates a search and so forth)
- </para>
- </sect2>
-
- <sect2 id="usage-mail-organize-vFolders">
- <title>Getting Really Organized with Virtual Folders</title>
- <para>
- If you find yourself performing a search frequently, you
- can save it as a virtual folder. Virtual folders, or
- vFolders, are an advanced way of viewing your email
- messages within <application>Evolution</application>. If
- you get a lot of mail or often forget where you put
- messages, vFolders can help you stay on top of things.
- </para>
- <para>
- A vFolder looks and acts a lot like a folder, but it's
- actually a saved search that you can access in most of the
- same ways you would a regular folder. The one important
- differences between them is that a conventional folder
- actually contains messages, but a vFolder is a view of
- messages that may be in several different folders. This
- means that while a message may fall into several vFolders,
- it can be in only one conventional folder. Also, it means
- that you cannot remove a message from a vFolder unless you
- delete it, and you cannot add a message to a vFolder
- unless you change the vFolder's search criteria.
- </para>
- <para>
- As messages that meet the vFolder criteria arrive or are
- deleted, <application>Evolution</application> will
- automatically place them in and and remove them from the
- vFolder contents list. When you delete a message, it gets
- erased from the folder it actually exists in as well as
- any vFolders which include it.
- </para>
- <para>
- That's pretty complicated. But it can be useful. For
- example, if I have a folder for all the email from one
- person, and another folder for all the email on a given
- topic, I feel organized. But when the person sends me
- mail about the topic, my whole email filing universe
- becomes chaotic. I need vFolders to save the day for me.
- </para>
- <para>
- That sounds silly, but imagine a business trying to keep
- track of mail from hundreds of vendors and clients, or a
- university with overlapping and changing groups of
- faculty, staff, administrators and students. The larger
- the system, the less you can afford that sort of
- confusion. vFolders make for better organization because
- they can accept overlapping groups in a way that regular
- folders and filing systems can't.
- </para>
-
- <example id="usage-mail-organize-vFolders-ex">
- <title>Using Folders, Searches, and vFolders</title>
- <para>
- To organize my mail box, I can set up a vFolder
- for emails from my friend Vince, by doing (INSERT
- PROCESS HERE). Then, whenever I want to see the
- messages Vince has sent me, I open the vFolder, and
- every message he's sent me shows up, no matter where
- I've actually filed it. If I want, I can also create a
- vFolder containing any message from my list of
- co-workers which also has the name of the project in
- it. That way, when Vince sends me mail about the
- project, I can see that message both in the "Vince"
- vFolder and in the "Project" vFolder. That's because
- when I open up the "Vince" folder, I'm really
- performing a search for all the mail from Vince, and
- when I open the "Project" folder I'm really performing
- a search for all the mail about the project.
-
- (INSERT SCREENSHOT HERE)
-
- </para>
- </example>
- </sect2>
-
- <sect2 id="usage-mail-organize-filters">
- <title>Staying organized: Mail Filters in Evolution</title>
- <para>
- Filters sort your email for you as it arrives in your
- Inbox, so you don't have to sort them all yourself.
- People who subscribe to multiple mailing lists find
- filters especially helpful to sort personal from
- list-related mail. To create a filter, go to your
- <interface>Inbox</interface>. Then select BLAH BLAH BLAH.
- This will open the <interface>filters</interface> window.
- </para>
-
- <para>
- The <interface>filters</interface> window contains the
- following items: <!--DESCRIBE INTERFACE-->
- </para>
-
- <note>
- <title>Two Notable Filter Features</title>
- <para>
- <itemizedlist>
- <listitem><para>Any email that does not meet filter
- action criteria remains in the Inbox. </para>
- </listitem>
-
- <listitem><para>If you move a folder, your filters
- will follow it. </para></listitem>
- </itemizedlist>
- </para>
- </note>
- </sect2>
- </sect1>
- </chapter>
-<!-- ================ END OF MAILER CHAPTER ============= -->