aboutsummaryrefslogtreecommitdiffstats
path: root/help/C
diff options
context:
space:
mode:
authorAaron Weber <aaron@ximian.com>2001-10-20 05:53:07 +0800
committerAaron Weber <aaron@src.gnome.org>2001-10-20 05:53:07 +0800
commitd634c1e15e08bec61d6880baf8a3c76eff22fffb (patch)
treee7a4e1dba0a4496f7615c307f05f5a55f2d0d4ad /help/C
parent8c6c9b4643f3ff6a7719a25c1f8a397550b5eac1 (diff)
downloadgsoc2013-evolution-d634c1e15e08bec61d6880baf8a3c76eff22fffb.tar
gsoc2013-evolution-d634c1e15e08bec61d6880baf8a3c76eff22fffb.tar.gz
gsoc2013-evolution-d634c1e15e08bec61d6880baf8a3c76eff22fffb.tar.bz2
gsoc2013-evolution-d634c1e15e08bec61d6880baf8a3c76eff22fffb.tar.lz
gsoc2013-evolution-d634c1e15e08bec61d6880baf8a3c76eff22fffb.tar.xz
gsoc2013-evolution-d634c1e15e08bec61d6880baf8a3c76eff22fffb.tar.zst
gsoc2013-evolution-d634c1e15e08bec61d6880baf8a3c76eff22fffb.zip
Many changes w/r/t IMAP and importation and encryption.
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
Diffstat (limited to 'help/C')
-rw-r--r--help/C/usage-contact.sgml6
-rw-r--r--help/C/usage-exec-summary.sgml6
-rw-r--r--help/C/usage-mail-org.sgml52
-rw-r--r--help/C/usage-mail.sgml245
-rw-r--r--help/C/usage-mainwindow.sgml35
5 files changed, 213 insertions, 131 deletions
diff --git a/help/C/usage-contact.sgml b/help/C/usage-contact.sgml
index 5a49602374..5c883fec47 100644
--- a/help/C/usage-contact.sgml
+++ b/help/C/usage-contact.sgml
@@ -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>
diff --git a/help/C/usage-exec-summary.sgml b/help/C/usage-exec-summary.sgml
index 455a7cc47e..285a9d6991 100644
--- a/help/C/usage-exec-summary.sgml
+++ b/help/C/usage-exec-summary.sgml
@@ -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>
diff --git a/help/C/usage-mail-org.sgml b/help/C/usage-mail-org.sgml
index 4299a2dfbe..79d9629388 100644
--- a/help/C/usage-mail-org.sgml
+++ b/help/C/usage-mail-org.sgml
@@ -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>
diff --git a/help/C/usage-mail.sgml b/help/C/usage-mail.sgml
index b78a9edcb4..630990a234 100644
--- a/help/C/usage-mail.sgml
+++ b/help/C/usage-mail.sgml
@@ -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 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>
- 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.
+ 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>
+
+
diff --git a/help/C/usage-mainwindow.sgml b/help/C/usage-mainwindow.sgml
index 7b57548423..f01f519b8a 100644
--- a/help/C/usage-mainwindow.sgml
+++ b/help/C/usage-mainwindow.sgml
@@ -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>