aboutsummaryrefslogtreecommitdiffstats
path: root/doc/C/usage-mail.sgml
diff options
context:
space:
mode:
authorAaron Weber <aaron@helixcode.com>2000-09-08 00:02:44 +0800
committerAaron Weber <aaron@src.gnome.org>2000-09-08 00:02:44 +0800
commit64119bc6be1866141e7a48935d6e6b907608a880 (patch)
tree62709d285b0699969a43c4dcc34ff8b006b424fb /doc/C/usage-mail.sgml
parentd435ef1f87d7202c8cdbb210ed09068e14499f1e (diff)
downloadgsoc2013-evolution-64119bc6be1866141e7a48935d6e6b907608a880.tar
gsoc2013-evolution-64119bc6be1866141e7a48935d6e6b907608a880.tar.gz
gsoc2013-evolution-64119bc6be1866141e7a48935d6e6b907608a880.tar.bz2
gsoc2013-evolution-64119bc6be1866141e7a48935d6e6b907608a880.tar.lz
gsoc2013-evolution-64119bc6be1866141e7a48935d6e6b907608a880.tar.xz
gsoc2013-evolution-64119bc6be1866141e7a48935d6e6b907608a880.tar.zst
gsoc2013-evolution-64119bc6be1866141e7a48935d6e6b907608a880.zip
Accidentally broke docs, now valid.
2000-09-07 Aaron Weber <aaron@helixcode.com> * C/evolution-guide.sgml: Accidentally broke docs, now valid. svn path=/trunk/; revision=5231
Diffstat (limited to 'doc/C/usage-mail.sgml')
-rw-r--r--doc/C/usage-mail.sgml269
1 files changed, 152 insertions, 117 deletions
diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml
index 5dfa03d8c1..510fc145d5 100644
--- a/doc/C/usage-mail.sgml
+++ b/doc/C/usage-mail.sgml
@@ -1,6 +1,8 @@
<!--
<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
-->
+<!-- NOTE: Queue handling, Outbox, and Written Message Editing are not
+implemented with a stable UI yet, and are described wrong -->
<chapter id="usage-mail">
<title>Evolution Mail</title>
@@ -364,8 +366,8 @@
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.
+ additional features, including large recipient lists,
+ attachments, and forwarding.
</para>
</sect3>
<sect3 id="usage-mail-getnsend-send-attach">
@@ -424,20 +426,28 @@
<sect4 id="usage-mail-getnsend-send-to-mult">
<title>Multiple Recipients</title>
<para>
- You can address your email in three different ways. The
+ <application>Evolution</application>, like all email
+ programs (at least, all the ones in current use)
+ recognizes three types of addressee: primary recipients,
+ secondary recipients, and hidden ("blind") recipients. 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.
+ recipients of the message you are going to send.
+ </para>
+ <para>
+ The simplest way to direct a message is to put the email
+ address or addresses in the <guilabel>To:</guilabel>
+ field, to denote primary recipients. However, it is
+ considered bad form to have more than a few email
+ addresses in this section. If you are sending mail to
+ more than one or two people, consider the
+ <guilabel>Cc:</guilabel> field.
</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>
+ <example id="ex-mail-cc">
<title>Using the Cc: field</title>
<para>
When Susan sends an email to a client, she puts her
@@ -571,25 +581,36 @@ with quoted materials and the relevant replies interspersed-->
</varlistentry>
<varlistentry>
- <term><guimenuitem>Replace</guimenuitem></term>
- <listitem><para> Find something, replace it with
- something else. </para></listitem>
+ <term><guimenuitem>Replace</guimenuitem></term>
+ <listitem><para>
+ Find a word or phrase, replace it with
+ something else.
+ </para></listitem>
</varlistentry>
</variablelist>
-
+ </para>
+ <para>
+ For all of these items, you have two additional choices.
+ First, you can choose whether to <guilabel>Search
+ Backwards</guilabel>, which will perform the search
+ starting wherever your cursor is, and moving back towards
+ the beginning of the document (normally, it goes the other
+ way). Then, you can decide whether to have your search be
+ <guilabel>Case Sensitive</guilabel>, meaning should it pay
+ attention to the case of letters when locating a match.
</para>
</sect3>
<sect3 id="usage-mail-getnsend-send-html">
<title>Embellish your email with HTML</title>
<para>
You can't normally use text treatments or pictures in
- emails, which is why you've probably seen people use
- asterisks for emphasis or use
- <glossterm>emoticons</glossterm> to convey their
- feelings. However, most of the newer email programs can
- include and display images and text treatments as well as
- basic alignment and paragraph formatting.
+ emails, which is why you've probably seen people use far
+ too many exclamation points for emphasis or use
+ <glossterm>emoticons</glossterm> to convey their feelings.
+ However, most of the newer email programs can include and
+ display images and text treatments as well as basic
+ alignment and paragraph formatting.
</para>
<note>
<title>HTML Mail is not a Default Setting</title>
@@ -628,9 +649,9 @@ with quoted materials and the relevant replies interspersed-->
Choose <guilabel>Normal</guilabel> for a default
text style, or <guilabel>Header 1</guilabel> through
<guilabel>Header 6</guilabel> for varying sizes of
- header. You can also select
- <guilabel>pre</guilabel> for preformatted text
- blocks, and three types of <guilabel>List
+ header from large (1) to tiny (6). You can also
+ select <guilabel>pre</guilabel> for preformatted
+ text blocks, and three types of <guilabel>List
Item</guilabel>.
</para>
</listitem>
@@ -639,11 +660,16 @@ with quoted materials and the relevant replies interspersed-->
<term>Text style</term>
<listitem>
<para>
+ Use these buttons to determine the way your letters
+ look. If you have text selected, the style will
+ apply to the selected text. If you do not have text
+ selected, the style will apply to whatever you type
+ next. The buttons are:
<itemizedlist mark="none">
- <listitem><para><guibutton>B</guibutton> is for bold text</para></listitem>
- <listitem><para><guibutton>I</guibutton> for italics</para></listitem>
- <listitem><para><guibutton>U</guibutton> to underline</para></listitem>
- <listitem><para><guibutton>S</guibutton> for a strikethrough.</para></listitem>
+ <listitem><para>Push <guibutton>B</guibutton> for bold text</para></listitem>
+ <listitem><para>Push <guibutton>I</guibutton> for italics</para></listitem>
+ <listitem><para>Push <guibutton>U</guibutton> to underline</para></listitem>
+ <listitem><para>Push <guibutton>S</guibutton> for a strikethrough.</para></listitem>
</itemizedlist>
</para>
</listitem>
@@ -672,6 +698,23 @@ with quoted materials and the relevant replies interspersed-->
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>Color Selection</term>
+ <listitem>
+ <para>
+ At the far right is the color section tool. You can
+ choose from several colors by clickin on the arrow,
+ or create your own custom color by clicking on the
+ color box itself. If you have text selected, the
+ color will apply to the selected text. If you do
+ not have text selected, the color will apply to
+ whatever you type next.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
</variablelist>
</para>
<para>
@@ -682,12 +725,12 @@ with quoted materials and the relevant replies interspersed-->
<term><guimenuitem>Insert Link</guimenuitem>:</term>
<listitem>
<para>
- Use this tool to
- put hyperlinks in your HTML messages. When you
- select it, <application>Evolution</application> will
- prompt you for the <guilabel>Text</guilabel> that
- will appear, and the <guilabel>Link</guilabel>, where
- you should enter the actual web address (URL).
+ Use this tool to put hyperlinks in your HTML
+ messages. When you select it,
+ <application>Evolution</application> will prompt you
+ for the <guilabel>Text</guilabel> that will appear,
+ and the <guilabel>Link</guilabel>, where you should
+ enter the actual web address (URL).
</para>
</listitem>
</varlistentry>
@@ -958,16 +1001,27 @@ possibly never will be due to security evil. -->
<sect2 id="usage-mail-organize-filters">
<title>Staying organized: Mail Filters in Evolution</title>
<para>
- Filters sort your email for you as you send or recieve
- it. Most often, you'll want to have
- <application>Evolution</application> put mail into different
- folders, but you can have it do anything you like. People who
- subscribe to multiple mailing lists, or who often need to
- refer to messages they have sent, find filters especially
- helpful to separate personal from list-related mail, but
- they're good for anybody who gets more than a few messages a
- day. To create a filter, open the <interface>filter
- assistant</interface> by selecting
+ I once worked in the mail room of a large company, where my
+ job was to bundle, sort, and distribute mail to the various
+ mail boxes and desks throughout the building. Filters do that
+ same job with email, but they lose much less mail than I did.
+ In addition, you can have multiple filters performing multiple
+ actions that may effect the same message in several ways. For
+ example, your filters could put copies of one message into
+ multiple folders, or keep a copy and send one to another
+ person as well. Which is to say, it's quite a bit more
+ flexible than an actual person with a pile of envelopes.
+ </para>
+ <para>
+ Most often, you'll want to have
+ <application>Evolution</application> put mail into different
+ folders, but you can have it do almost anything you like.
+ People who subscribe to multiple mailing lists, or who often
+ need to refer to messages they have sent, find filters
+ especially helpful to separate personal from list-related
+ mail, but they're good for anybody who gets more than a few
+ messages a day. To create a filter, open the
+ <interface>filter assistant</interface> by selecting
<menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Mail Filters</guimenuitem>
@@ -1009,12 +1063,13 @@ possibly never will be due to security evil. -->
</para></listitem>
<listitem><para>
- <guibutton>Up</guibutton> &mdash; Move the selected filter up in the list.
+ <guibutton>Up</guibutton> &mdash; Move the selected filter up in the list,
+ so it will be performed sooner.
</para></listitem>
<listitem><para>
<guibutton>Down</guibutton> &mdash; Move the selected filter down
- in the list.
+ in the list, so it will be performed later.
</para></listitem>
</itemizedlist>
@@ -1039,16 +1094,16 @@ possibly never will be due to security evil. -->
</para>
<para>
Enter a name for your filter in the <guilabel>Name</guilabel>
- field, and then begin choosing criteria. You can use multiple
- criteria by pressing <guibutton>More</guibutton>, and remove
- the last one by pressing <guibutton>Fewer</guibutton>. you can
- choose from five types of criteria, and you can have as many
- as you like. If you have multiple criteria, you should also
- decide between <guilabel>Match all parts</guilabel>, which
- will make the filter affect only those messages which meet all
- the criteria you're about to describe, and <guilabel>Match any
- part</guilabel>, which will make the filter affect any message
- that meets even one of the criteria.
+ field, and then begin choosing criteria. Choose how many
+ criteria you'd like by pressing <guibutton>More</guibutton>
+ and <guibutton>Fewer</guibutton>. You can choose from five
+ types of criteria, and you can have as many as you like; at
+ least, I've never found a maximum. If you have multiple
+ criteria, you'll want to decide between <guilabel>Match all
+ parts</guilabel>, which will make the filter affect only those
+ messages which meet all the criteria you're about to describe,
+ and <guilabel>Match any part</guilabel>, which will make the
+ filter affect any message that meets even one of the criteria.
</para>
<para>
For each of your filter criteria, you must first select what
@@ -1085,10 +1140,10 @@ possibly never will be due to security evil. -->
<varlistentry>
<term><guilabel>Expression</guilabel></term>
<listitem><para>
- Enter a regular expression (see <xref linkend="apx-gloss">
- for more information), and <application>Evolution</application>
- will match it for you.
- </para></listitem>
+ Enter a <glossterm>regular expression</glossterm>, and
+ <application>Evolution</application> will match it for
+ you.
+ </para></listitem>
</varlistentry>
</variablelist>
</para>
@@ -1155,10 +1210,10 @@ possibly never will be due to security evil. -->
<varlistentry>
<term><guilabel>Stop Processing</guilabel></term>
- <listitem><para>
- Select this if you want to tell all other filters to ignore
- this message.
- </para></listitem>
+ <listitem><para> Select this if you want to tell all other
+ filters to ignore this message. If multiple filters copy
+ the message to a different folders, you'll have multiple
+ copies of the message. </para></listitem>
</varlistentry>
<varlistentry>
@@ -1207,8 +1262,10 @@ possibly never will be due to security evil. -->
<title>Two Notable Filter Features</title>
<para>
<itemizedlist>
- <listitem><para>Any incoming email that does not meet
- filter action criteria remains in the Inbox. </para>
+ <listitem><para>
+ Incoming email that your filters don't move goes into the Inbox;
+ outgoing mail that they don't move ends up in the Sent folder.
+ </para>
</listitem>
<listitem><para>If you move a folder, your filters
@@ -1234,51 +1291,28 @@ possibly never will be due to security evil. -->
<para>
A vFolder is really a hybrid of all the other organizational
tools: it looks like a folder, it acts like a search, and you
- set it up like a filter. Once you've set it up, you'll be
- able to open it and read the messages in it as though it were
- a normal mail folder. It's not a folder, though, because when
- you open a vFolder, <application>Evolution</application>
- performs a search for you. It's not a regular search, though,
- because you can build a vFolder with a very complicated set of
- criteria with multiple inclusions and exclusions, as though
- you were setting up a filter.
+ set it up like a filter. In other words, while a conventional
+ folder actually contains messages, a vFolder is a view of
+ messages that may be in several different folders. The
+ messages it contains are determined on the fly using a set of
+ criteria you choose in advance.
</para>
-<!-- potentially useful, but doesn't fit at the moment:
- <para>
- An important difference between a folder and a virtual folder
- 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 in which it actually exists, 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
- <emphasis>feel</emphasis> organized. But when the person
- sends me mail about the topic, my whole email filing universe
- becomes chaotic, and I need vFolders to save the day for me.
+ any vFolders which display it.
</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 more mail you need to organize, the less
- you can afford the sort of confusion that stems from an
+ 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 more mail you need to organize, the less you
+ can afford the sort of confusion that stems from an
organizational system that's not flexible enough. vFolders
make for better organization because they can accept
overlapping groups in a way that regular folders and filing
@@ -1288,24 +1322,22 @@ possibly never will be due to security evil. -->
<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. 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.
+ To organize my mail box, I set up a vFolder for emails from
+ my friend and co-worker Anna. I have another one for
+ messages from anybody at work that have "Evolution" in the
+ subject line, so I can keep a record of what people from
+ work send me about <application>Evolution</application>.
+ If Anna sends a message about a picnic on Saturday, it only
+ shows up in the "Anna" folder. When Anna sends me mail
+ about the user interface for
+ <application>Evolution</application>, I can see that
+ message both in the "Anna" vFolder and in the "Internal
+ Evolution Discussion" vFolder.
+ </para>
+ </example>
<!-- (INSERT SCREENSHOT HERE: vFolders in action) -->
- </para>
- </example>
<para>
To create a vFolder, select <guimenuitem>VFolder
Editor</guimenuitem> from the <guimenu>Tools</guimenu>
@@ -1334,9 +1366,12 @@ possibly never will be due to security evil. -->
The second part, however, is slightly different. In the
section of the window labelled <guilabel>vFolder Sources
</guilabel> is a list of folders in which
- <application>Evolution</application> will search for the contents
- of your vFolder. Click <guibutton>Add</guibutton> to add a folder,
- or <guibutton>Remove</guibutton> to remove one.
+ <application>Evolution</application> will search for the
+ contents of your vFolder. Click <guibutton>Add</guibutton>
+ to add a folder, or <guibutton>Remove</guibutton> to remove
+ one. That way, you can have your vFolder search in
+ newsgroups, or just in one of your mailboxes, or just in a
+ select few folders you've already screened with filters.
</para>
<para>
The vFolder creation window is shown in <xref