callisto-debian/evolution
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Revisions as suggested by Dan. Especially to filter dialogs... which still

Browse Source 
2000-12-13  Aaron Weber  <aaron@helixcode.com>

	* C/usage-mail.sgml: Revisions as suggested by Dan.  Especially to
	filter dialogs... which still need some renaming, IMHO.

	* C/usage-mainwindow.sgml: Revisions as suggested by
	Dan. Especially to the Folder Limits thing, which still upsets me
	somehow.

	* C/preface.sgml: Revisions as suggested by Dan.

svn path=/trunk/; revision=7033
This commit is contained in:
Aaron Weber
2000-12-14 23:57:29 +00:00
committed by Aaron Weber
parent cdc4e94bba
commit 3ba61815e2
8 changed files with 378 additions and 250 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
doc/C/preface.sgml
View File

@ -13,9 +13,9 @@
it's hardly even worth the name if you can't look at it and be
<emphasis>informed</emphasis>.
<application>Evolution</application>'s goal is to make the
tasks of storing, organizing, and retrieving information
easier, so you can work and communicate with others. That is,
it's a highly evolved <glossterm
tasks of storing, organizing, and retrieving your personal
information easier, so you can work and communicate with
others. That is, it's a highly evolved <glossterm
linkend="groupware">groupware</glossterm> program, an integral
part of the Internet-connected desktop. On the inside, it's a
powerful database; on the outside, it's a tool to help you get
@ -23,9 +23,9 @@
</para>
<para>
Because it's part of the GNOME project,
<application>Evolution</application> is free software. The
<application>Evolution</application> is Free Software. The
program and its source code are released under the terms of
the <ulink type="help" url="gnome-help:gpl"><citetitle>GNU
the GNU <ulink type="help" url="gnome-help:gpl"><citetitle>General
Public License (GPL)</citetitle></ulink>, and the
documentation falls under the <ulink type="help"
url="gnome-help:fdl"><citetitle>Free Documentation
@ -54,9 +54,6 @@
information, and one or more calendars. It can do that on one
or several computers, connected directly or over a network,
for one person or for large groups.
<application>Evolution</application> can handle almost all
your communications and information management tasks with the
power and flexibility of the GNOME desktop environment.
</para>
<para>
The <application>Evolution</application> project has four
@ -111,8 +108,8 @@
more efficient, so searches are faster and memory usage is
lower. People who get lots of mail will appreciate advanced
features like <link
linkend="usage-mail-organize-vFolders">vFolders</link>, which
let you save searches as though they were ordinary mail
linkend="usage-mail-organize-vFolders">Virtual Folders</link>,
which let you save searches as though they were ordinary mail
folders.
</para>
@ -317,7 +314,7 @@
<term>Reply to a Message</term>
<listitem>
<para>
Select the message to which you want to reply, and
To reply to the sender of the message only:
click <guibutton>Reply</guibutton> in the
toolbar, or press
<keycombo action="simul">
@ -326,6 +323,10 @@
<keycap>FIXME</keycap>
</keycombo>
</para>
<para>
To reply to the sender and all the other visible
recipients of the message, click:
</para>
</listitem>
</varlistentry>
@ -333,8 +334,8 @@
<term>Forward a Message</term>
<listitem>
<para>
Select the message you want to forward, and
click <guibutton>Forward</guibutton> in the
Select the message or messages you want to forward,
and click <guibutton>Forward</guibutton> in the
toolbar, or press
<keycombo action="simul">
<keycap>FIXME</keycap>
@ -349,7 +350,8 @@
<term>Open a Message in a New Window</term>
<listitem>
<para>
Double-click the message you want to view, or press
Double-click the message you want to view, or select
it and press
<keycombo action="simul">
<keycap>Ctrl</keycap>
<keycap>O</keycap>

184
doc/C/usage-mail.sgml
View File

@ -41,8 +41,8 @@
mail without slowing down or crashing. Both the <link
linkend="usage-mail-organize-filters">filtering</link> and <link
linkend="usage-mail-organize-search">searching</link> functions
were built for speed and efficiency on gargantuan mail
volumes. There's also the <application>Evolution</application>
were built for speed and efficiency on gargantuan volumes of
mail. 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
@ -58,11 +58,10 @@
<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.
<guibutton>Inbox</guibutton> in the shortcut bar. The first
time you use <application>Evolution</application>, it will
start with the <interface>Inbox</interface> open and show you a
message from Helix Code welcoming you to the application.
</para>
<para>
The <application>Evolution</application>
@ -72,10 +71,11 @@
<interface>message list</interface>. The message itself 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. Just like
with folders, you can right-click on messages in the message
list and get a menu of possible actions.
you can resize the pane, enlarge the whole window, or double-click
on the message in the <interface>message list</interface> to
have it open in a new window. Just like with folders, you can
right-click on messages in the message list and get a menu of
possible actions.
</para>
<!-- ==============Figure=================================== -->
@ -123,14 +123,9 @@
<menuchoice> <guimenu>View</guimenu>
<guimenuitem>Threaded</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 message ID numbers and
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.
<application>Evolution</application> will group the replies
to a message with the original, so you can follow the thread
of a conversation from one message to the next.
</para>
</sect3>
<sect3 id="usage-mail-getnsend-delete">
@ -147,11 +142,9 @@
If you really want to get rid of it, choose
<guimenuitem>Expunge</guimenuitem> from the
<guimenu>Folder</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 will change to something a little less
counter-intuitive.
permanently. If you change your mind and decide you want to
keep it, select <menuchoice> <guimenu>Message</guimenu>
<guimenuitem>Undelete</guimenuitem></menuchoice>.
</para>
</sect3>
</sect2>
@ -305,7 +298,7 @@
folder (the <guilabel>Drafts</guilabel> folder would be the
obvious place), you can select <menuchoice>
<guimenu>File</guimenu> <guimenuitem>Save In
Folder</guimenuitem> </menuchoice>.
Folder</guimenuitem> </menuchoice>.
</para>
</sect3>
<sect3 id="usage-mail-getnsend-send-compose">
@ -333,11 +326,11 @@
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>;
to hide them again, choose <guimenuitem>Hide
Attachments</guimenuitem>.
To hide the display of files you've attached to the
message, select <menuchoice>
<guimenu>View</guimenu> <guimenuitem>Hide
Attachments</guimenuitem> </menuchoice>; to show them
again, choose <guimenuitem>Show Attachments</guimenuitem>.
</para>
<para>
When you send the message, a copy of the attached file
@ -453,8 +446,8 @@
fields will already be filled, although you can alter them
if you wish. In addition, the full text of the old message
is inserted into the new message, either in italics (for
HTML display) or with the &gt; character (in plain text
mode) before each line, to indicate that it's part of the
HTML display) or with the &gt; character before each line
(in plain text mode), to indicate that it's part of the
previous message. People often intersperse their message
with the quoted material as shown in <xref
linkend="usage-mail-getnsend-reply-fig">.
@ -557,12 +550,12 @@ with quoted materials and the relevant replies interspersed-->
<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
You can't normally set text styles or insert pictures in
emails, which is why you've probably seen people use far
too many exclamation points for emphasis or use <glossterm
linkend="emoticon">emoticons</glossterm> to convey their
feelings. However, most of the newer email programs can
include and display images and text treatments as well as
include and display images and text styles as well as
basic alignment and paragraph formatting. They do this
with <glossterm linkend="html">HTML</glossterm>, just like
web sites do.
@ -685,18 +678,22 @@ with quoted materials and the relevant replies interspersed-->
<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>
enter the actual web address (URL). If you don't
want special link text, you can just enter the address
directly, and <application>Evolution</application>
will recognize it as a link.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term> <guimenuitem>Insert Image</guimenuitem>:</term>
<listitem>
<para>
<guimenuitem>Insert Image</guimenuitem>: Select this item to
embed an image into your email, as was done in the welcome
message. Images will appear at the location of the
cursor.
<guimenuitem>Insert Image</guimenuitem>: Select this
item to embed an image into your email, as was done in
the welcome message. Images will appear at the
location of the cursor. This is different from
attaching them to a message, but not very different.
</para>
</listitem>
</varlistentry>
@ -1040,11 +1037,10 @@ possibly never will be due to security evil. -->
<para>
The <interface>filter assistant</interface> window contains a
list of your current filters, sorted by the order in which
they will be performed. From the drop-down box at the top of
the window, choose <guilabel>Incoming</guilabel> to display
those filters which are performed on incoming mail, and
<guilabel>On Demand</guilabel> for those which are performed
only when you want.
they are used. From the drop-down box at the top of the
window, choose <guilabel>Incoming</guilabel> to display
filters for incoming mail, and <guilabel>On Demand</guilabel>
for those which sort your mail only when you want.
</para>
<para>
The <interface>filter assistant</interface> also has a set of
@ -1064,12 +1060,12 @@ possibly never will be due to security evil. -->
</para></listitem>
<listitem><para> <guibutton>Up</guibutton> &mdash; Move the
selected filter up in the list, so it will be performed
sooner. </para></listitem>
selected filter up in the list so it gets applied first.
</para></listitem>
<listitem><para>
<guibutton>Down</guibutton> &mdash; Move the selected filter down
in the list, so it will be performed later.
in the list, so it comes into play later.
</para></listitem>
</itemizedlist>
@ -1172,7 +1168,6 @@ possibly never will be due to security evil. -->
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Date Recieved</guilabel></term>
<listitem><para>
@ -1186,9 +1181,29 @@ possibly never will be due to security evil. -->
<term><guilabel>Priority</guilabel></term>
<listitem><para>
Emails have a standard priority range from -3 (least
important) to 3 (most important). If you can persuade
your friends and co-workers to use the priority levels
honestly, you can filter with them as well.
important) to 3 (most important). You can have filters set the
priority of messages you recieve, and then have other filters
applied only to those messages which have a certain priority.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Regex Match</guilabel></term>
<listitem><para>
If you know your way around a <glossterm
linkend="regular-expression">regular
expression</glossterm>, or regex, put your knowledge to
use here. You can match your expression in the message
headers or in its body.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Source</guilabel></term>
<listitem><para>
Filter messages according the server you got them from. You can enter a URL or
choose one from the drop-down list. This criterion is only relevant if you
use more than one mail source.
</para></listitem>
</varlistentry>
</variablelist>
@ -1198,6 +1213,17 @@ possibly never will be due to security evil. -->
actions, click <guibutton>Add Action</guibutton>; if you want fewer,
click <guibutton>Remove Action</guibutton>. And choose again:
<variablelist>
<varlistentry>
<term><guilabel>Copy to Folder</guilabel></term>
<listitem><para>
If you select this item, <application>Evolution</application>
will put the messages into a folder you specify. Click the
<guibutton>&lt;click here to select a folder&gt;</guibutton> button
to select a folder.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Move to Folder</guilabel></term>
<listitem><para>
@ -1227,10 +1253,11 @@ 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. If multiple filters copy
the message to a different folders, you'll have multiple
copies of the message. </para></listitem>
<listitem><para>
Select this if you want to tell all other filters to ignore
this message, because whatever you've done with it so far
is plenty.
</para></listitem>
</varlistentry>
<varlistentry>
@ -1243,11 +1270,11 @@ possibly never will be due to security evil. -->
<varlistentry>
<term><guilabel>Assign Score</guilabel></term>
<listitem><para> Priority numbers alone don't work, so you
can score emails on the same scale. Then, you can tell
which ones you want to read, or have scored messages
moved, copied, or colored in a subsequent filter.
</para></listitem>
<listitem><para> If you know that all mail with
"important" somewhere in the message body line is
important, you can give it a high priority score. In a subsequent filter you can
then arrange your messages by their priority score.
</para></listitem>
</varlistentry>
</variablelist>
@ -1312,26 +1339,26 @@ possibly never will be due to security evil. -->
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
mail or often forget where you put messages, virtual folders can help
you stay on top of things.
</para>
<para>
A vFolder is really a hybrid of all the other organizational
A virtual folder 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. In other words, while a conventional
folder actually contains messages, a vFolder is a view of
folder actually contains messages, a virtual folder 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>
<para>
As messages that meet the vFolder criteria arrive or are
As messages that meet the virtual folder 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
virtual folder contents list. When you delete a message, it gets
erased from the folder in which it actually exists, as well as
any vFolders which display it.
any virtual folders which display it.
</para>
<para>
@ -1340,16 +1367,16 @@ possibly never will be due to security evil. -->
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
organizational system that's not flexible enough. virtual folders
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>
<title>Using Folders, Searches, and Virtual Folders</title>
<para>
To organize my mail box, I set up a vFolder for emails from
To organize my mail box, I set up a virtual folder 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
@ -1358,29 +1385,29 @@ possibly never will be due to security evil. -->
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.
message both in the "Anna" virtual folder and in the "Internal
Evolution Discussion" virtual folder.
</para>
</example>
<!-- (INSERT SCREENSHOT HERE: vFolders in action) -->
<!-- (INSERT SCREENSHOT HERE: virtual folders in action) -->
<para>
To create a vFolder, select <menuchoice>
<guimenu>Tools</guimenu> <guimenuitem>vFolder
To create a virtual folder, select <menuchoice>
<guimenu>Tools</guimenu> <guimenuitem>Virtual Folder
Editor</guimenuitem> </menuchoice>. This will bring up a
dialog box that looks suspiciously like the filter window
(for more information on filters, see <xref
linkend="usage-mail-organize-filters">), and which
presents you with a list of vFolders you have previously
created. If you have created any vFolders, they are listed
presents you with a list of virtual folders you have previously
created. If you have created any virtual folders, they are listed
here, and you can select, edit or remove them if you wish.
If you have not created any, there will be only one available
option: click <guibutton>Add</guibutton> to add a new
vFolder.
</para>
<para>
You can enter a name for your vFolder in the
You can enter a name for your virtual folder in the
<guilabel>Name</guilabel>. Then, tell
<application>Evolution</application> what messages to look
for. This process is exactly like filter creation: decide
@ -1429,3 +1456,4 @@ possibly never will be due to security evil. -->
</sect1>
</chapter>

89
doc/C/usage-mainwindow.sgml
View File

@ -111,9 +111,10 @@
<term> <guibutton>Inbox:</guibutton></term>
<listitem>
<para>
The Inbox will show you all of your email. Your Inbox
is also where you can access Evolution's tools to
filter, sort, organize, and search your mail.
Click the <guibutton>Inbox</guibutton> button to start
reading your mail. Your Inbox is also where you can
access Evolution's tools to filter, sort, organize, and
search your mail.
</para>
</listitem>
</varlistentry>
@ -169,15 +170,16 @@
</variablelist>
</para>
<para>
If you don't like the shortcut bar, you can use the menu bar, or
keyboard shortcuts, also called <glossterm linkend="hot-key">hot keys</glossterm>.
They're shown next to their equivalent menu items in the menu
bar. You can also set your own hot keys for functions that don't
have any; this is covered in <xref linkend="config">. If you're
using the keyboard shortcuts you may also want to hide the
<interface>shortcut bar</interface> by selecting <menuchoice>
<guimenu>View</guimenu> <guimenuitem>Show Shortcut
Bar</guimenuitem> </menuchoice>.
If you don't like the shortcut bar, you can use the folder bar
or the menu bar to navigate. Press
<keycombo action="simul">
<keycap>Ctrl</keycap>
<keycap>O</keycap>
</keycombo>
to choose from a list of folders you'd like to visit, or use the
drop-down folder bar. You can hide and show the folder bar and
the shortcut bar by selecting those items in the
<guimenu>View</guimenu> menu.
</para>
<tip>
@ -187,7 +189,8 @@
and select <guimenuitem>Remove</guimenuitem>. To add one,
select <menuchoice> <guimenu>File</guimenu>
<guisubmenu>New</guisubmenu> <guimenuitem>Evolution Bar
Shortcut</guimenuitem> </menuchoice>. </para>
Shortcut</guimenuitem> </menuchoice>.
</para>
<para>
To change the way the shortcut bar looks, right-click in an
empty space on the shortcut bar. From the menu that appears,
@ -206,18 +209,21 @@
like a <glossterm linkend="filetree">file
tree</glossterm>&mdash; it starts small at the top, and branches
downwards. On most computers, there will be three folders at the
base. At the top are your <guilabel>vFolders</guilabel>, or
base. First, and probably most important, is the
<guilabel>Local</guilabel> folder, which holds all the
<application>Evolution</application> data that's stored on your
computer. After that come <guilabel>vFolders</guilabel>, or
virtual folders, discussed in <xref
linkend="usage-mail-organize-vfolders">. After that come any
linkend="usage-mail-organize-vfolders">, followed by any
<glossterm linkend="imap">IMAP</glossterm> mail folders you
might have available to you over your network. The next folder
is called <guilabel>External Directories</guilabel>, and holds
<glossterm linkend="ldap">LDAP</glossterm> contact directories
stored on a network. The most important one is probably
<guilabel>Local</guilabel>, which you can use to access all the
data that's stored on your computer. If you click on the plus
sign plus sign next to the <guilabel>Local</guilabel> folder,
you'll see the contents:
might have available to you over your network. Lastly, there
are <guilabel>External Directories</guilabel>, <glossterm
linkend="ldap">LDAP</glossterm> contact directories stored on a
network.
</para>
<para>
A typical <guilabel>Local</guilabel> folder contains the following folders:
<itemizedlist>
<listitem>
<para>
@ -232,20 +238,35 @@
</listitem>
<listitem>
<para>
<guilabel>Directories</guilabel>, for Internet contact directories.
<guilabel>Inbox</guilabel>, for incoming mail.
</para>
</listitem>
<listitem>
<listitem>
<para>
<guilabel>Inbox</guilabel>, for incoming mail.
<guilabel>Drafts</guilabel>, for messages you started and didn't finish.
</para>
</listitem>
<listitem>
<para>
<guilabel>Outbox</guilabel>, which is for drafts of
messages and mail that's already been sent.
<guilabel>Sent</guilabel>, for sent mail.
</para>
</listitem>
<listitem>
<para>
<guilabel>Trash</guilabel>, which is used to store
messages you don't want, but keep around just in case you
change your mind.
</para>
</listitem>
<listitem>
<para>
<guilabel>Outbox</guilabel>, for messages you have written
but not yet sent. This will be empty unless you use
<application>Evolution</application> while offline.
</para>
</listitem>
</itemizedlist>
</para>
@ -273,11 +294,13 @@
<note>
<title>Folders Have Limits</title>
<para>
You can always place a folder inside other folders,
regardless of folder type. However, calendars,
contacts, and mail can't go into the same
folder. Calendars have to go in calendar folders, mail
in mail folders, and contacts in contact folders.
No matter where they exist, calendars must go in
calendar folders, mail in mail folders, and contacts in
contact folders. Network folders follow the same type
restriction, because the network servers are only set up
to handle one kind of information. Within your local
system, though you can folders inside each other,
regardless of type.
</para>
</note>

11
doc/ChangeLog
View File

@ -1,3 +1,14 @@
2000-12-13 Aaron Weber <aaron@helixcode.com>
* C/usage-mail.sgml: Revisions as suggested by Dan. Especially to
filter dialogs... which still need some renaming, IMHO.
* C/usage-mainwindow.sgml: Revisions as suggested by
Dan. Especially to the Folder Limits thing, which still upsets me
somehow.
* C/preface.sgml: Revisions as suggested by Dan.
2000-11-29 Aaron Weber <aaron@helixcode.com>
* C/config-setupassist.sgml: added some <glossterms>, added linkends to existing glossterms.

30
help/C/preface.sgml
View File

@ -13,9 +13,9 @@
it's hardly even worth the name if you can't look at it and be
<emphasis>informed</emphasis>.
<application>Evolution</application>'s goal is to make the
tasks of storing, organizing, and retrieving information
easier, so you can work and communicate with others. That is,
it's a highly evolved <glossterm
tasks of storing, organizing, and retrieving your personal
information easier, so you can work and communicate with
others. That is, it's a highly evolved <glossterm
linkend="groupware">groupware</glossterm> program, an integral
part of the Internet-connected desktop. On the inside, it's a
powerful database; on the outside, it's a tool to help you get
@ -23,9 +23,9 @@
</para>
<para>
Because it's part of the GNOME project,
<application>Evolution</application> is free software. The
<application>Evolution</application> is Free Software. The
program and its source code are released under the terms of
the <ulink type="help" url="gnome-help:gpl"><citetitle>GNU
the GNU <ulink type="help" url="gnome-help:gpl"><citetitle>General
Public License (GPL)</citetitle></ulink>, and the
documentation falls under the <ulink type="help"
url="gnome-help:fdl"><citetitle>Free Documentation
@ -54,9 +54,6 @@
information, and one or more calendars. It can do that on one
or several computers, connected directly or over a network,
for one person or for large groups.
<application>Evolution</application> can handle almost all
your communications and information management tasks with the
power and flexibility of the GNOME desktop environment.
</para>
<para>
The <application>Evolution</application> project has four
@ -111,8 +108,8 @@
more efficient, so searches are faster and memory usage is
lower. People who get lots of mail will appreciate advanced
features like <link
linkend="usage-mail-organize-vFolders">vFolders</link>, which
let you save searches as though they were ordinary mail
linkend="usage-mail-organize-vFolders">Virtual Folders</link>,
which let you save searches as though they were ordinary mail
folders.
</para>
@ -317,7 +314,7 @@
<term>Reply to a Message</term>
<listitem>
<para>
Select the message to which you want to reply, and
To reply to the sender of the message only:
click <guibutton>Reply</guibutton> in the
toolbar, or press
<keycombo action="simul">
@ -326,6 +323,10 @@
<keycap>FIXME</keycap>
</keycombo>
</para>
<para>
To reply to the sender and all the other visible
recipients of the message, click:
</para>
</listitem>
</varlistentry>
@ -333,8 +334,8 @@
<term>Forward a Message</term>
<listitem>
<para>
Select the message you want to forward, and
click <guibutton>Forward</guibutton> in the
Select the message or messages you want to forward,
and click <guibutton>Forward</guibutton> in the
toolbar, or press
<keycombo action="simul">
<keycap>FIXME</keycap>
@ -349,7 +350,8 @@
<term>Open a Message in a New Window</term>
<listitem>
<para>
Double-click the message you want to view, or press
Double-click the message you want to view, or select
it and press
<keycombo action="simul">
<keycap>Ctrl</keycap>
<keycap>O</keycap>

184
help/C/usage-mail.sgml
View File

@ -41,8 +41,8 @@
mail without slowing down or crashing. Both the <link
linkend="usage-mail-organize-filters">filtering</link> and <link
linkend="usage-mail-organize-search">searching</link> functions
were built for speed and efficiency on gargantuan mail
volumes. There's also the <application>Evolution</application>
were built for speed and efficiency on gargantuan volumes of
mail. 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
@ -58,11 +58,10 @@
<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.
<guibutton>Inbox</guibutton> in the shortcut bar. The first
time you use <application>Evolution</application>, it will
start with the <interface>Inbox</interface> open and show you a
message from Helix Code welcoming you to the application.
</para>
<para>
The <application>Evolution</application>
@ -72,10 +71,11 @@
<interface>message list</interface>. The message itself 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. Just like
with folders, you can right-click on messages in the message
list and get a menu of possible actions.
you can resize the pane, enlarge the whole window, or double-click
on the message in the <interface>message list</interface> to
have it open in a new window. Just like with folders, you can
right-click on messages in the message list and get a menu of
possible actions.
</para>
<!-- ==============Figure=================================== -->
@ -123,14 +123,9 @@
<menuchoice> <guimenu>View</guimenu>
<guimenuitem>Threaded</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 message ID numbers and
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.
<application>Evolution</application> will group the replies
to a message with the original, so you can follow the thread
of a conversation from one message to the next.
</para>
</sect3>
<sect3 id="usage-mail-getnsend-delete">
@ -147,11 +142,9 @@
If you really want to get rid of it, choose
<guimenuitem>Expunge</guimenuitem> from the
<guimenu>Folder</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 will change to something a little less
counter-intuitive.
permanently. If you change your mind and decide you want to
keep it, select <menuchoice> <guimenu>Message</guimenu>
<guimenuitem>Undelete</guimenuitem></menuchoice>.
</para>
</sect3>
</sect2>
@ -305,7 +298,7 @@
folder (the <guilabel>Drafts</guilabel> folder would be the
obvious place), you can select <menuchoice>
<guimenu>File</guimenu> <guimenuitem>Save In
Folder</guimenuitem> </menuchoice>.
Folder</guimenuitem> </menuchoice>.
</para>
</sect3>
<sect3 id="usage-mail-getnsend-send-compose">
@ -333,11 +326,11 @@
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>;
to hide them again, choose <guimenuitem>Hide
Attachments</guimenuitem>.
To hide the display of files you've attached to the
message, select <menuchoice>
<guimenu>View</guimenu> <guimenuitem>Hide
Attachments</guimenuitem> </menuchoice>; to show them
again, choose <guimenuitem>Show Attachments</guimenuitem>.
</para>
<para>
When you send the message, a copy of the attached file
@ -453,8 +446,8 @@
fields will already be filled, although you can alter them
if you wish. In addition, the full text of the old message
is inserted into the new message, either in italics (for
HTML display) or with the &gt; character (in plain text
mode) before each line, to indicate that it's part of the
HTML display) or with the &gt; character before each line
(in plain text mode), to indicate that it's part of the
previous message. People often intersperse their message
with the quoted material as shown in <xref
linkend="usage-mail-getnsend-reply-fig">.
@ -557,12 +550,12 @@ with quoted materials and the relevant replies interspersed-->
<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
You can't normally set text styles or insert pictures in
emails, which is why you've probably seen people use far
too many exclamation points for emphasis or use <glossterm
linkend="emoticon">emoticons</glossterm> to convey their
feelings. However, most of the newer email programs can
include and display images and text treatments as well as
include and display images and text styles as well as
basic alignment and paragraph formatting. They do this
with <glossterm linkend="html">HTML</glossterm>, just like
web sites do.
@ -685,18 +678,22 @@ with quoted materials and the relevant replies interspersed-->
<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>
enter the actual web address (URL). If you don't
want special link text, you can just enter the address
directly, and <application>Evolution</application>
will recognize it as a link.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term> <guimenuitem>Insert Image</guimenuitem>:</term>
<listitem>
<para>
<guimenuitem>Insert Image</guimenuitem>: Select this item to
embed an image into your email, as was done in the welcome
message. Images will appear at the location of the
cursor.
<guimenuitem>Insert Image</guimenuitem>: Select this
item to embed an image into your email, as was done in
the welcome message. Images will appear at the
location of the cursor. This is different from
attaching them to a message, but not very different.
</para>
</listitem>
</varlistentry>
@ -1040,11 +1037,10 @@ possibly never will be due to security evil. -->
<para>
The <interface>filter assistant</interface> window contains a
list of your current filters, sorted by the order in which
they will be performed. From the drop-down box at the top of
the window, choose <guilabel>Incoming</guilabel> to display
those filters which are performed on incoming mail, and
<guilabel>On Demand</guilabel> for those which are performed
only when you want.
they are used. From the drop-down box at the top of the
window, choose <guilabel>Incoming</guilabel> to display
filters for incoming mail, and <guilabel>On Demand</guilabel>
for those which sort your mail only when you want.
</para>
<para>
The <interface>filter assistant</interface> also has a set of
@ -1064,12 +1060,12 @@ possibly never will be due to security evil. -->
</para></listitem>
<listitem><para> <guibutton>Up</guibutton> &mdash; Move the
selected filter up in the list, so it will be performed
sooner. </para></listitem>
selected filter up in the list so it gets applied first.
</para></listitem>
<listitem><para>
<guibutton>Down</guibutton> &mdash; Move the selected filter down
in the list, so it will be performed later.
in the list, so it comes into play later.
</para></listitem>
</itemizedlist>
@ -1172,7 +1168,6 @@ possibly never will be due to security evil. -->
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Date Recieved</guilabel></term>
<listitem><para>
@ -1186,9 +1181,29 @@ possibly never will be due to security evil. -->
<term><guilabel>Priority</guilabel></term>
<listitem><para>
Emails have a standard priority range from -3 (least
important) to 3 (most important). If you can persuade
your friends and co-workers to use the priority levels
honestly, you can filter with them as well.
important) to 3 (most important). You can have filters set the
priority of messages you recieve, and then have other filters
applied only to those messages which have a certain priority.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Regex Match</guilabel></term>
<listitem><para>
If you know your way around a <glossterm
linkend="regular-expression">regular
expression</glossterm>, or regex, put your knowledge to
use here. You can match your expression in the message
headers or in its body.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Source</guilabel></term>
<listitem><para>
Filter messages according the server you got them from. You can enter a URL or
choose one from the drop-down list. This criterion is only relevant if you
use more than one mail source.
</para></listitem>
</varlistentry>
</variablelist>
@ -1198,6 +1213,17 @@ possibly never will be due to security evil. -->
actions, click <guibutton>Add Action</guibutton>; if you want fewer,
click <guibutton>Remove Action</guibutton>. And choose again:
<variablelist>
<varlistentry>
<term><guilabel>Copy to Folder</guilabel></term>
<listitem><para>
If you select this item, <application>Evolution</application>
will put the messages into a folder you specify. Click the
<guibutton>&lt;click here to select a folder&gt;</guibutton> button
to select a folder.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Move to Folder</guilabel></term>
<listitem><para>
@ -1227,10 +1253,11 @@ 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. If multiple filters copy
the message to a different folders, you'll have multiple
copies of the message. </para></listitem>
<listitem><para>
Select this if you want to tell all other filters to ignore
this message, because whatever you've done with it so far
is plenty.
</para></listitem>
</varlistentry>
<varlistentry>
@ -1243,11 +1270,11 @@ possibly never will be due to security evil. -->
<varlistentry>
<term><guilabel>Assign Score</guilabel></term>
<listitem><para> Priority numbers alone don't work, so you
can score emails on the same scale. Then, you can tell
which ones you want to read, or have scored messages
moved, copied, or colored in a subsequent filter.
</para></listitem>
<listitem><para> If you know that all mail with
"important" somewhere in the message body line is
important, you can give it a high priority score. In a subsequent filter you can
then arrange your messages by their priority score.
</para></listitem>
</varlistentry>
</variablelist>
@ -1312,26 +1339,26 @@ possibly never will be due to security evil. -->
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
mail or often forget where you put messages, virtual folders can help
you stay on top of things.
</para>
<para>
A vFolder is really a hybrid of all the other organizational
A virtual folder 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. In other words, while a conventional
folder actually contains messages, a vFolder is a view of
folder actually contains messages, a virtual folder 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>
<para>
As messages that meet the vFolder criteria arrive or are
As messages that meet the virtual folder 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
virtual folder contents list. When you delete a message, it gets
erased from the folder in which it actually exists, as well as
any vFolders which display it.
any virtual folders which display it.
</para>
<para>
@ -1340,16 +1367,16 @@ possibly never will be due to security evil. -->
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
organizational system that's not flexible enough. virtual folders
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>
<title>Using Folders, Searches, and Virtual Folders</title>
<para>
To organize my mail box, I set up a vFolder for emails from
To organize my mail box, I set up a virtual folder 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
@ -1358,29 +1385,29 @@ possibly never will be due to security evil. -->
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.
message both in the "Anna" virtual folder and in the "Internal
Evolution Discussion" virtual folder.
</para>
</example>
<!-- (INSERT SCREENSHOT HERE: vFolders in action) -->
<!-- (INSERT SCREENSHOT HERE: virtual folders in action) -->
<para>
To create a vFolder, select <menuchoice>
<guimenu>Tools</guimenu> <guimenuitem>vFolder
To create a virtual folder, select <menuchoice>
<guimenu>Tools</guimenu> <guimenuitem>Virtual Folder
Editor</guimenuitem> </menuchoice>. This will bring up a
dialog box that looks suspiciously like the filter window
(for more information on filters, see <xref
linkend="usage-mail-organize-filters">), and which
presents you with a list of vFolders you have previously
created. If you have created any vFolders, they are listed
presents you with a list of virtual folders you have previously
created. If you have created any virtual folders, they are listed
here, and you can select, edit or remove them if you wish.
If you have not created any, there will be only one available
option: click <guibutton>Add</guibutton> to add a new
vFolder.
</para>
<para>
You can enter a name for your vFolder in the
You can enter a name for your virtual folder in the
<guilabel>Name</guilabel>. Then, tell
<application>Evolution</application> what messages to look
for. This process is exactly like filter creation: decide
@ -1429,3 +1456,4 @@ possibly never will be due to security evil. -->
</sect1>
</chapter>

89
help/C/usage-mainwindow.sgml
View File

@ -111,9 +111,10 @@
<term> <guibutton>Inbox:</guibutton></term>
<listitem>
<para>
The Inbox will show you all of your email. Your Inbox
is also where you can access Evolution's tools to
filter, sort, organize, and search your mail.
Click the <guibutton>Inbox</guibutton> button to start
reading your mail. Your Inbox is also where you can
access Evolution's tools to filter, sort, organize, and
search your mail.
</para>
</listitem>
</varlistentry>
@ -169,15 +170,16 @@
</variablelist>
</para>
<para>
If you don't like the shortcut bar, you can use the menu bar, or
keyboard shortcuts, also called <glossterm linkend="hot-key">hot keys</glossterm>.
They're shown next to their equivalent menu items in the menu
bar. You can also set your own hot keys for functions that don't
have any; this is covered in <xref linkend="config">. If you're
using the keyboard shortcuts you may also want to hide the
<interface>shortcut bar</interface> by selecting <menuchoice>
<guimenu>View</guimenu> <guimenuitem>Show Shortcut
Bar</guimenuitem> </menuchoice>.
If you don't like the shortcut bar, you can use the folder bar
or the menu bar to navigate. Press
<keycombo action="simul">
<keycap>Ctrl</keycap>
<keycap>O</keycap>
</keycombo>
to choose from a list of folders you'd like to visit, or use the
drop-down folder bar. You can hide and show the folder bar and
the shortcut bar by selecting those items in the
<guimenu>View</guimenu> menu.
</para>
<tip>
@ -187,7 +189,8 @@
and select <guimenuitem>Remove</guimenuitem>. To add one,
select <menuchoice> <guimenu>File</guimenu>
<guisubmenu>New</guisubmenu> <guimenuitem>Evolution Bar
Shortcut</guimenuitem> </menuchoice>. </para>
Shortcut</guimenuitem> </menuchoice>.
</para>
<para>
To change the way the shortcut bar looks, right-click in an
empty space on the shortcut bar. From the menu that appears,
@ -206,18 +209,21 @@
like a <glossterm linkend="filetree">file
tree</glossterm>&mdash; it starts small at the top, and branches
downwards. On most computers, there will be three folders at the
base. At the top are your <guilabel>vFolders</guilabel>, or
base. First, and probably most important, is the
<guilabel>Local</guilabel> folder, which holds all the
<application>Evolution</application> data that's stored on your
computer. After that come <guilabel>vFolders</guilabel>, or
virtual folders, discussed in <xref
linkend="usage-mail-organize-vfolders">. After that come any
linkend="usage-mail-organize-vfolders">, followed by any
<glossterm linkend="imap">IMAP</glossterm> mail folders you
might have available to you over your network. The next folder
is called <guilabel>External Directories</guilabel>, and holds
<glossterm linkend="ldap">LDAP</glossterm> contact directories
stored on a network. The most important one is probably
<guilabel>Local</guilabel>, which you can use to access all the
data that's stored on your computer. If you click on the plus
sign plus sign next to the <guilabel>Local</guilabel> folder,
you'll see the contents:
might have available to you over your network. Lastly, there
are <guilabel>External Directories</guilabel>, <glossterm
linkend="ldap">LDAP</glossterm> contact directories stored on a
network.
</para>
<para>
A typical <guilabel>Local</guilabel> folder contains the following folders:
<itemizedlist>
<listitem>
<para>
@ -232,20 +238,35 @@
</listitem>
<listitem>
<para>
<guilabel>Directories</guilabel>, for Internet contact directories.
<guilabel>Inbox</guilabel>, for incoming mail.
</para>
</listitem>
<listitem>
<listitem>
<para>
<guilabel>Inbox</guilabel>, for incoming mail.
<guilabel>Drafts</guilabel>, for messages you started and didn't finish.
</para>
</listitem>
<listitem>
<para>
<guilabel>Outbox</guilabel>, which is for drafts of
messages and mail that's already been sent.
<guilabel>Sent</guilabel>, for sent mail.
</para>
</listitem>
<listitem>
<para>
<guilabel>Trash</guilabel>, which is used to store
messages you don't want, but keep around just in case you
change your mind.
</para>
</listitem>
<listitem>
<para>
<guilabel>Outbox</guilabel>, for messages you have written
but not yet sent. This will be empty unless you use
<application>Evolution</application> while offline.
</para>
</listitem>
</itemizedlist>
</para>
@ -273,11 +294,13 @@
<note>
<title>Folders Have Limits</title>
<para>
You can always place a folder inside other folders,
regardless of folder type. However, calendars,
contacts, and mail can't go into the same
folder. Calendars have to go in calendar folders, mail
in mail folders, and contacts in contact folders.
No matter where they exist, calendars must go in
calendar folders, mail in mail folders, and contacts in
contact folders. Network folders follow the same type
restriction, because the network servers are only set up
to handle one kind of information. Within your local
system, though you can folders inside each other,
regardless of type.
</para>
</note>

11
help/ChangeLog
View File

@ -1,3 +1,14 @@
2000-12-13 Aaron Weber <aaron@helixcode.com>
* C/usage-mail.sgml: Revisions as suggested by Dan. Especially to
filter dialogs... which still need some renaming, IMHO.
* C/usage-mainwindow.sgml: Revisions as suggested by
Dan. Especially to the Folder Limits thing, which still upsets me
somehow.
* C/preface.sgml: Revisions as suggested by Dan.
2000-11-29 Aaron Weber <aaron@helixcode.com>
* C/config-setupassist.sgml: added some <glossterms>, added linkends to existing glossterms.