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

Many changes w/r/t IMAP and importation and encryption.

Browse Source 
2001-10-19  Aaron Weber  <aaron@ximian.com>

	* C/usage-mail-org.sgml: Many changes w/r/t IMAP and importation and encryption.

	* C/usage-contact.sgml: A few changes, w/r/t import.

	* C/usage-mainwindow.sgml: IMAP stuff.

	* C/usage-exec-summary.sgml: More changes. Update to intro sect.

	* C/usage-mainwindow.sgml: Assorted fixes. Kevin, there's a FIXME for ya in here.

svn path=/trunk/; revision=13806
This commit is contained in:
Aaron Weber
2001-10-19 21:53:07 +00:00
committed by Aaron Weber
parent 8c6c9b4643
commit d634c1e15e
5 changed files with 213 additions and 131 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
help/C/usage-contact.sgml
View File

@ -9,7 +9,11 @@
any amount of contact information, share addresses over a
network, and several ways to save time with everyday tasks. To
learn about configuring the address book, see <xref
linkend="config-prefs-contact">.
linkend="config-prefs-contact">. You can import contacts from
other contact management tools with the Import tool by
selecting
<menuchoice><guimenu>File</guimenu><guimenuitem>Import</guimenuitem></menuchoice>,
or by mailing them to yourself as vCard attachments.
</para>
<para>

6
help/C/usage-exec-summary.sgml
View File

@ -185,7 +185,11 @@
<title>Metric or Imperial?</title>
<para>
<application>Evolution</application> supports both
Imperial and Metric measurement for weather reports.
Imperial and Metric measurement for weather
reports. Imperial units are sometimes called British
units, but are used almost exclusively in the United
States. Britain, and most of the rest of the world, use
metric units.
</para>
</tip>
</para>

52
help/C/usage-mail-org.sgml
View File

@ -9,6 +9,8 @@
to help you do it.
</para>
<!-- Kevin, i'd suggest putting an "IMporting old mail" section here." -->
<sect1 id="usage-mail-organize-columns">
<title>Sorting Mail with Column Headers</title>
<para>
@ -436,16 +438,27 @@
<example id="filter-example">
<title>Using a Filter to Avoid Spam</title>
<para>
The majority of bulk mail is tagged with the
A good deal of bulk mail is eventually tagged with the
<computeroutput>Precedence: Bulk</computeroutput> header at
one point or another. Some of these messages, of course,
could be in mailing lists you've subscribed to, but many of
them are unsolicited commercial email.
one point or another. Not all of it is, of course, and
there are "good" messages (mailing lists you subscribe to,
for example) that are also considered "Bulk" mail.
However, if you filter out all the mail with that header,
you'll catch a lot of the mail you don't want to get.
</para>
<para>
To catch them and put them all in one place, create a
new filter for incoming mail. Then:
To catch them and automatically mark them for deletion, do
the following:
<orderedlist>
<listitem><para>
Select <menuchoice><guimenu>Tools</guimenu><guimenuitem>Filters</guimenuitem></menuchoice>.
</para></listitem>
<listitem><para>
Click <guibutton>New</guibutton>.
</para></listitem>
<listitem><para>
Set the first part of your search critera to look in a <guilabel>Specific header</guilabel>.
</para></listitem>
@ -469,11 +482,9 @@
folder where you'd like to place bulk mail.
</para></listitem>
<listitem><para>
If you like, add an action and choose <guilabel>Stop
Processing</guilabel> if you'd like this message to be
ignored by all other filters.
</para></listitem>
<listitem><para> If you like, add another action and
choose <guilabel>Delete</guilabel>.
</para></listitem>
<listitem><para>
Click OK. You're done.
@ -792,16 +803,15 @@
</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para>
If you want multiple criteria for this filter, press <guibutton>Add
criterion</guibutton> and repeat the previous step.
</para>
</listitem>
</orderedlist>
</para>
</listitem>
</orderedlist>
<para>
Remote folders are considered active if you are connected to the
server; you must be connected to your mail server for the vFolder to
include any messages from that source.
</para>
<figure id="usage-mail-vfolder-fig-createrule">
<title>Selecting a vFolder Rule</title>

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

@ -1,4 +1,3 @@
<chapter id="usage-mail">
<title>Using Evolution for Email</title>
<para>
@ -7,17 +6,90 @@
Evolution as a mail client. For information about how to set up
your mail account, see <xref linkend="config-prefs-mail">.
</para>
<note>
<title>If you use IMAP Mail</title>
<sect1 id="usage-mail-subscriptions">
<title>IMAP Mail Subscription Management</title>
<para>
If you chose IMAP mail during the setup process, you must
subscribe to your mail folders before you can read mail in
them. Read <xref linkend="usage-mail-subscriptions"> to find out
how.
If you chose IMAP mail during the setup process, you may still
have to subscribe to folders or select a specific namespace for
your IMAP mail folders. If you don't use IMAP mail, you can skip
this section.
</para>
<para>
Since IMAP folders exist on the server, and opening them or
checking them takes time, you need fine-grained control over the
ones you look at on a regular basis. There are two tools that
you can use to control IMAP mail displays. The first is in the
Mail Settings dialog. From there, choose the IMAP account you
want to change, and select the <guilabel>Receiving
Options</guilabel> tab. Your IMAP related options are:
<simplelist>
<member>Show only subscribed folders</member>
<member>Override server-supplied namespace</member>
</simplelist>
</para>
<para>
If, in your IMAP folder list, you see extraneous folders, folders you
haven't created, or items that don't appear to be mail folders at all,
you may wish to simplify your mail view by choosing one of these
options. Ask your system administrator what namespace you should use
if you're not sure, or just use the subscriptions dialog instead.
</para>
<para>
You can use the subscriptions tool to hide from view those folders
that you do not need, and to display folders in addition to those
provided as the defaults by your mailserver.
</para>
<para>
To use it:
<orderedlist numeration="arabic">
<listitem>
<para>
Select
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Subscribe
to Folders</guimenuitem></menuchoice>.
</para>
</listitem>
<listitem>
<para>
If you have accounts on multiple IMAP servers, select the
server where you'd like to manage your folder
use. <application>Evolution</application> will display a
list of available files and folders. Depending upon the
way your IMAP server is configured, the list of available
files may include non-mail folders. If it does, just
ignore them.
</para>
</listitem>
<listitem>
<para>
Select a file or folder by clicking on it. You will want
to select at least the <guilabel>INBOX</guilabel> folder.
</para>
</listitem>
<listitem>
<para>
Click the <guibutton>Subscribe</guibutton> to add it to
the subscribed list.
</para>
</listitem>
<listitem>
<para>
When you have subscribed to the folders you want, close
the window.
</para>
</listitem>
</orderedlist>
</para>
</note>
</sect1>
<sect1 id="usage-mail-getnsend-read">
<title>Reading Mail</title>
@ -1594,7 +1666,7 @@
</varlistentry>
<varlistentry>
<term>>Accept</term>
<term>Accept as Tentative</term>
<listitem>
<para>
Select this entry if you will probably attend the meeting.
@ -1631,85 +1703,49 @@
</para>
</sect1>
<sect1 id="usage-mail-subscriptions">
<title>Subscription Management</title>
<para>
Since IMAP folders exist on the server, and opening them or
checking them takes time, you need fine-grained control over
the way that you use IMAP folders. That's why
<application>Evolution</application> has an IMAP
subscriptions manager.
</para>
<para>
To use it:
<orderedlist numeration="arabic">
<listitem>
<para>
Select
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Subscribe
to Folders</guimenuitem></menuchoice>.
</para>
</listitem>
<listitem>
<para>
If you have accounts on multiple IMAP servers, select the
server where you'd like to manage your
subscriptions. <application>Evolution</application> will
display a list of available files and folders.
</para>
</listitem>
<listitem>
<para>
Select a file or folder by clicking on it. You will want
to select at least the <guilabel>INBOX</guilabel>
folder. Depending upon the way your IMAP server is
configured, the list of available files may include
non-mail folders. If it does, you can ignore them.
</para>
</listitem>
<listitem>
<para>
Click the <guibutton>Subscribe</guibutton> to add it to
the subscribed list.
</para>
</listitem>
<listitem>
<para>
When you have subscribed to the folders you want, close
the window.
</para>
</listitem>
</orderedlist>
</para>
</sect1>
<sect1 id="encryption">
<title>Encryption</title>
<sect2 id="encryption-whatis">
<title>What is Encryption?</title>
<para>
Encryption is an ancient method of keeping information safe
from prying eyes. <application>Evolution</application> helps
you you protect your privacy by using
<application>gpg</application>, an implementation of strong
<glossterm linkend="public-key-encryption">Public Key
Encryption.</glossterm>
Encryption is a method of hiding information by converting it
into code. <application>Evolution</application> helps you you
protect your privacy by using <application>gpg</application>,
an implementation of strong <glossterm
linkend="public-key-encryption">Public Key
Encryption.</glossterm>
<para>
You can use encryption in two different ways:
<simplelist>
<member>
Encrypt an entire message, so that nobody but the
recipient can read it. They will then use the same tool
to decrypt the message.
</member>
<member>
Attach an encrypted signature to a plain text message, so
that the recipient can read the message without decrypting
it, and only needs decryption to verify the sender's
identity.
</member>
</simplelist>
</para>
<note id="pub-priv">
<title>Public Key? Private Key? What is the difference?</title>
<para>
GPG uses two keys: public and private. You can give your
public key to anyone you want to recieve
encrypted messages, or put it on a public key server so
that people can look it up before contacting you.
<emphasis>Never give your private key to anyone,
ever</emphasis>. Your private key lets you decrypt any
message encrypted with your public key.
GPG uses a system with two numeric keys: one public and
one private. A message is encrypted or signed with the
public key, then sent to the holder of the private key;
any message encrypted with the public key can be decrypted
only with the private key. Distribute your public key as
widely as you like (many people put theirs on Internet
"keyservers" for automatic download), because people will
need it to send you encrypted mail. <emphasis>Never give
your private key to anyone, ever</emphasis>. Your private
key lets you decrypt any message encrypted with your
public key.
</para>
</note>
@ -1721,20 +1757,6 @@
your public key in advance.
</para>
<para>
You can use encryption in two different ways:
<simplelist>
<member>
Encrypt the entire message, so that nobody but the recipient can read it.
</member>
<member>
Attach an encrypted signature to a plain text message, so
that the recipient can read the message without decrypting it, and
only needs decryption to verify the sender's identity.
</member>
</simplelist>
</para>
<example>
<title>Sending an Encrypted Messagee</title>
<para>
@ -1769,6 +1791,10 @@
</para>
</listitem>
</orderedlist>
You may also want to check the box labelled
<guilabel></guilabel>. If you send encrypted mail to
someone else, and don't send it to yourself as well, you
won't be able to read it later on!
</para>
</tip>
</sect2>
@ -1805,13 +1831,16 @@
<listitem>
<para>
Choose a key length. The default, 1024 bits, should be
long enough.
long enough. The longer the key, the stronger the
encryption, and the longer it will take to generate the
keys and to decode or encode data.
</para>
</listitem>
<listitem>
<para>
Decide if you want your key to expire automatically, and if so, when.
Decide if you want your key to expire automatically, and
if so, when.
</para>
</listitem>
@ -1856,7 +1885,9 @@
pub 1024D/32j38dk2 2001-06-20 you &lt;you@your-address.com&gt;
sub 1024g/289sklj3 2001-06-20 [expires: 2002-11-14]
</programlisting>
The Key ID in this case is 32j38dk2.
</para>
<para>
GPG will create one list, or keyring, for your public keys
and one for your private keys. All the public keys you know
@ -1884,6 +1915,18 @@ wwwkeys.pgp.net 32j38dk2</command>. Substitute your key ID for
</listitem>
</orderedlist>
<para>
You can also have <application>Evolution</application> look up public
keys automatically by adding the following line to the file
<filename>~/.gnupg/options</filename> :
<programlisting>
keyserver wwwkeys.eu.pgp.net
</programlisting>
substituting the keyserver of your choice for the server name wwwkeys.eu.pgp.net.
</para>
<note id="why-keyserver">
<title>Why Use a Keyserver?</title>
<para>
@ -1989,9 +2032,11 @@ wwwkeys.pgp.net 32j38dk2</command>. Substitute your key ID for
<sect2 id="unencrypting">
<title>Unencrypting a Recieved Message</title>
<para>
If you get an encrypted message, you will need to decrypt it
before you read it. Remember, the sender has to have your
public key before they can send you an encrypted message.
If you get a signed message, Evolution will attempt to
verify the signature automatically. To view an encrypted
message, just click on the arrow icon. Remember, the sender
has to have your public key before they can send you an
encrypted message.
</para>
<para>
When you view the message,
@ -2002,3 +2047,5 @@ wwwkeys.pgp.net 32j38dk2</command>. Substitute your key ID for
</sect2>
</sect1>
</chapter>

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

@ -140,7 +140,9 @@
<para>
Server Type &mdash; There are numerous types of servers
from which <application>Ximian Evolution</application>
can fetch your mail:
can fetch your mail. Ask your system administrator if
you're not sure which of the following are available to
you:
<itemizedlist>
<listitem>
<para>
@ -150,18 +152,15 @@
</listitem>
<listitem>
<para>
IMAPv4 &mdash; Keeps the email on your server so
you can access your email from any computer that
supports IMAPv4 and have everything be the
same. For more information about how to use IMAP
mail, see <xref
linkend="usage-mail-subscriptions">.
IMAP &mdash; Keeps the email on your server so you
can access your email from multiple systems.
</para>
</listitem>
<listitem>
<para>
Unix mail spool file &mdash; If you run a mail
server on your desktop computer, choose this optino.
server on your desktop computer, choose this
option.
</para>
</listitem>
<listitem>
@ -180,10 +179,28 @@
</listitem>
<listitem>
<para>
None &mdash; How do you have None? figure out!
None &mdash; Select this if you do not plan to
check mail with this account.
</para>
</listitem>
</itemizedlist>
<note id="imap-note-one">
<title>What's an IMAP Namespace?</title>
<para>
For IMAP mail servers, your sysadmin may provide
you with a specific namespace, the path on the
IMAP server where you check for mail. If you
check your IMAP mail and your folder list includes
files that don't look like mail folders, you
probably need to change your mail
namespace. Typical values are "mail" and "Mail."
If you prefer, you can choose to subscribe to
individual mail folders. For more information
about how to use IMAP mail, see <xref
linkend="usage-mail-subscriptions">.
</para>
</note>
</para>
</listitem>
<listitem>