aboutsummaryrefslogtreecommitdiffstats
path: root/doc/C
diff options
context:
space:
mode:
authorAaron Weber <aaron@src.gnome.org>2000-06-02 07:24:58 +0800
committerAaron Weber <aaron@src.gnome.org>2000-06-02 07:24:58 +0800
commit0432ec4d0ff907163693849b1c3ddb08ba3b33d3 (patch)
tree5d712407d785e087ba6eb19420ba945a5eeead20 /doc/C
parent66f4e5ce1c0d8830bea66844c8bd0cd79568953a (diff)
downloadgsoc2013-evolution-0432ec4d0ff907163693849b1c3ddb08ba3b33d3.tar.gz
gsoc2013-evolution-0432ec4d0ff907163693849b1c3ddb08ba3b33d3.tar.zst
gsoc2013-evolution-0432ec4d0ff907163693849b1c3ddb08ba3b33d3.zip
improved filter instructions, vFolder instructions. still need work
* C/usage-mail.sgml: improved filter instructions, vFolder instructions. still need work though. * C/usage-contact.sgml: added screenshot. * C/usage-calendar.sgml: added screenshot. * C/config-prefs.sgml: added screenshots, and now describes the actual prefs dialogs. * C/fig/config-camel.png: new (screenshot) file * C/fig/filter-druid.png: same * C/fig/vfolder-druid.png: same * C/fig/calendar.png: same * C/fig/contact.png: same * C/fig/vfolder-createrule-fig.png: same * C/fig/filter-new-fig.png: same * C/fig/config-camel-fig.png: same svn path=/trunk/; revision=3344
Diffstat (limited to 'doc/C')
-rw-r--r--doc/C/config-prefs.sgml148
-rw-r--r--doc/C/fig/calendar.pngbin0 -> 30522 bytes
-rw-r--r--doc/C/fig/config-camel.pngbin0 -> 5344 bytes
-rw-r--r--doc/C/fig/contact.pngbin0 -> 27473 bytes
-rw-r--r--doc/C/fig/filter-new-fig.pngbin0 -> 7393 bytes
-rw-r--r--doc/C/fig/mainwindow-pic.pngbin145792 -> 261494 bytes
-rw-r--r--doc/C/fig/vfolder-createrule-fig.pngbin0 -> 7324 bytes
-rw-r--r--doc/C/usage-calendar.sgml2
-rw-r--r--doc/C/usage-contact.sgml17
-rw-r--r--doc/C/usage-mail.sgml88
10 files changed, 219 insertions, 36 deletions
diff --git a/doc/C/config-prefs.sgml b/doc/C/config-prefs.sgml
index 8ca4dbbc7d..d0ccf2c454 100644
--- a/doc/C/config-prefs.sgml
+++ b/doc/C/config-prefs.sgml
@@ -1,10 +1,10 @@
<chapter id="config-prefs">
- <title>Advanced Configuration with the Preferences Window</title>
+ <title>Advanced Configuration</title>
<para>
To change your configuration settings, select
- <guimenuitem>Preferences</guimenuitem> from the
- <guimenu>Settings</guimenu> menu. This will open the
+ <guimenuitem>Configure Camel Providers</guimenuitem> from the
+ <guimenu>Tools</guimenu> menu. This will open the
preferences window, illustrated in <xref linkend="config-prefs-fig">.
Preferences are seperated into several categories:
<itemizedlist>
@@ -18,8 +18,22 @@
<listitem>
<para>
- <guilabel>Mail</guilabel>, which allows you to specify
- your email server and protocols, as well as attachment
+ <guilabel>Sources</guilabel>, which allows you to specify
+ your mail receiving server and protocols.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <guilabel>Transports</guilabel>, which allows you to
+ specify how you will send mail.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+<!-- THE FOLLOWING MAY BE REINSTATED:
+
+ as well as attachment
and HTML handling, forwarding behavior, filters, and
other <application>Evolution</application> behaviors
specific to email. The default behaviors are those
@@ -53,8 +67,8 @@
startup screen.
</para>
</listitem>
- </itemizedlist>
-
+ </itemizedlist>
+-->
</para>
<!-- ==============Figure===================== -->
@@ -62,7 +76,7 @@
<title>Preferences Dialog</title>
<screenshot>
<screeninfo>Preferences dialog</screeninfo>
- <graphic fileref="evolution_config_pic" format="png" srccredit="Aaron Weber">
+ <graphic fileref="fig/config-camel-fig" format="png" srccredit="Aaron Weber">
</graphic>
</screenshot>
</figure>
@@ -74,30 +88,54 @@
<para>
If you have only one email address, or use automatic
forwarding to funnel multiple addresses into one, then you
- will only need to configure one identity. To create a single
- user with a single identity, enter the following information:
- (INSERT detailed DESCRIPTION HERE)
+ will only need to configure one identity. You may, however,
+ want more thatn one. To alter an identity, click on it in
+ the <guilabel>Identity</guilabel> tab of the
+ <interface>Preferences</interface> window, and then click
+ <guibutton>Edit</guibutton>. To add a new identity, simply
+ click <guibutton>Add</guibutton>.
</para>
<para>
- If you have one email accout for your personal life, and one
- for work, you'll want to create multiple identities. You
- can do this by: (INSERT DESCRIPTION HERE)
- </para>
+ In either case, you'll be presented with a dialog box with
+ four fields:
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Full Name:</guilabel> by default, this is the
+ same name as the full name described in your user
+ account on your computer.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Email address:</guilabel> Enter your email
+ address in this space.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Organization:</guilabel> If you send email as
+ a representative of a company or other organization,
+ enter its name here.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Signature file:</guilabel> You may choose a
+ small text file to be appended to every message that you
+ send. Typically, signature files include address or
+ other contact information, or a favorite quotation.
+ They should not be more than three lines long.
+ </para>
+ </listitem>
+ </itemizedlist>
- <note id="config-prefs-identity-note">
- <title>Multiple Identities and Network Settings</title>
- <para>
- If you use multiple network connections&mdash;if, for
- example, you dial up an ISP for your personal mail, and use
- a LAN for your work-related tasks&mdash; you will also have
- to set seperate network settings for each identity.
- </para>
- </note>
+ </para>
</sect1>
<sect1 id="config-prefs-network">
- <title>Setting up the Network</title>
+ <title>Network Settings</title>
<para>
In order to do much of anything with
<application>Evolution</application>, you need to connect to
@@ -107,14 +145,64 @@
you'll be using. If you're switching from another groupware
or email progam, you can almost certainly use the same
settings as you did with that program. Select the
- <guibutton>Network</guibutton> tab in the
- <interface>Preferences</interface> window to get started.
+ <guibutton>Sources</guibutton> tab in the
+ <interface>Preferences</interface> window to tell
+ <application>Evolution</application> where you want to get
+ your mail, and click <guibutton>Transports</guibutton> to
+ determine how you want to send your mail.
</para>
- <sect2 id="config-prefs-network-advanced">
- <title>Advanced Network Configuration</title>
+ <sect2 id="config-prefs-network-sources">
+ <title>Mail Sources</title>
<para>
- INSERT a little introduction paragraph here.
+ The <interface>Mail Sources</interface> tab allows you to
+ edit, add, or delete methods of retreiving mail from
+ servers. Clicking on <guibutton>Add</guibutton> or
+ <guibutton>Edit</guibutton> will bring up a dialog box to
+ offer you the following options:
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ <guilabel>Mail source type:</guilabel>At this point, you
+ can only select from POP or Unix-style mbox files, but
+ additional types will be supported in the future.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <guilabel>Server:</guilabel>Enter the name of your mail
+ server in this field, eg: mail.mycompany.com
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Username:</guilabel>Enter your user name here.
+ Eva Lucy Ann Tester's user name is eltester.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Authentication:</guilabel> Your system
+ administrator will know which type of authentication
+ your system requires.
+ <application>Evolution</application> can also detect
+ what sorts of authentication are available once it knows
+ where to find the server.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Test these values before continuing</guilabel>
+ If this box is checked,
+ <application>Evolution</application> will attempt to
+ make sure that all the other entries in the dialog box
+ are correct.
+ </para>
+ </listitem>
+ </itemizedlist>
+
</para>
<sect3 id="config-prefs-network-advanced-multiconnect">
<title>Multiple Network Connections</title>
diff --git a/doc/C/fig/calendar.png b/doc/C/fig/calendar.png
new file mode 100644
index 0000000000..91f485aa5f
--- /dev/null
+++ b/doc/C/fig/calendar.png
Binary files differ
diff --git a/doc/C/fig/config-camel.png b/doc/C/fig/config-camel.png
new file mode 100644
index 0000000000..e9e5debc78
--- /dev/null
+++ b/doc/C/fig/config-camel.png
Binary files differ
diff --git a/doc/C/fig/contact.png b/doc/C/fig/contact.png
new file mode 100644
index 0000000000..ed41ab0e3d
--- /dev/null
+++ b/doc/C/fig/contact.png
Binary files differ
diff --git a/doc/C/fig/filter-new-fig.png b/doc/C/fig/filter-new-fig.png
new file mode 100644
index 0000000000..84db72462c
--- /dev/null
+++ b/doc/C/fig/filter-new-fig.png
Binary files differ
diff --git a/doc/C/fig/mainwindow-pic.png b/doc/C/fig/mainwindow-pic.png
index b7c6067449..29af304147 100644
--- a/doc/C/fig/mainwindow-pic.png
+++ b/doc/C/fig/mainwindow-pic.png
Binary files differ
diff --git a/doc/C/fig/vfolder-createrule-fig.png b/doc/C/fig/vfolder-createrule-fig.png
new file mode 100644
index 0000000000..6be67ad5eb
--- /dev/null
+++ b/doc/C/fig/vfolder-createrule-fig.png
Binary files differ
diff --git a/doc/C/usage-calendar.sgml b/doc/C/usage-calendar.sgml
index 83e03c80c0..631a5b711b 100644
--- a/doc/C/usage-calendar.sgml
+++ b/doc/C/usage-calendar.sgml
@@ -13,7 +13,7 @@
<title>Evolution Calendar View</title>
<screenshot>
<screeninfo>Evolution Contact Manager Window</screeninfo>
- <graphic fileref="cal-pic" format="png" srccredit="Aaron Weber">
+ <graphic fileref="fig/calendar" format="png" srccredit="Aaron Weber">
</graphic>
</screenshot>
</figure>
diff --git a/doc/C/usage-contact.sgml b/doc/C/usage-contact.sgml
index c50d0ea10b..86cf73fd34 100644
--- a/doc/C/usage-contact.sgml
+++ b/doc/C/usage-contact.sgml
@@ -37,8 +37,21 @@
<para>
To open up your address book, click on
- <guibutton>Contacts</guibutton> in the shortcut bar.
+ <guibutton>Contacts</guibutton> in the shortcut bar. The
+ contact manager is illustrated in <xref
+ linkend="usage-contact-fig">
</para>
+
+
+ <figure id="usage-contact-fig">
+ <title>Evolution Contact Manager</title>
+ <screenshot>
+ <screeninfo>Evolution Contact Manager Window</screeninfo>
+ <graphic fileref="fig/contact.png" format="png" srccredit="Aaron Weber">
+ </graphic>
+ </screenshot>
+ </figure>
+
<para>
The contact manager interface is broken into two main parts.
The first part is the contact display section. This can be
@@ -56,7 +69,7 @@
<para>
You can create a new card by pressing the <guibutton>New
Card</guibutton> button, or by pressing
- <shortcut><keysym>KEYSYM</keysym></shortcut>. The
+ <keysym>KEYSYM</keysym>. The
<interface>New Card</interface> window will appear. It has
the following fields:
diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml
index 2dd289e4c3..35fa51fa38 100644
--- a/doc/C/usage-mail.sgml
+++ b/doc/C/usage-mail.sgml
@@ -704,6 +704,75 @@
</para>
</example>
+ <para>
+ To create a vFolder, select <guimenuitem>VFolder
+ Druid</guimenuitem> from the <guimenu>Tools</guimenu>
+ menu in the <interface>main window</interface>. This
+ will bring up a dialog box that looks suspiciously like
+ the Filter Druid (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 already created vFolders, you can
+ click on them in the frame labelled <guilabel>Select Rule
+ Type</guilabel>, and edit or remove them. 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'll be prompted to create a filtering rule. To do so,
+ select one of the base rules, and click
+ <guibutton>Next</guibutton> to customize it. Your options are:
+ <itemizedlist>
+ <listitem>
+ <para>
+ For matching messages: you may select one or more
+ search criteria; the vFolder you create will
+ contain messages that match all of
+ them.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Messages from a certain person: you enter an email
+ address, and the vFolder will contain any messages
+ from that address.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Messages to a certain address: any messages sent
+ directly to this address will be in the vFolder you create.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Messages with a given subject: enter a subject,
+ and the vFolder will contain messages with that
+ subject.
+ </para>
+ </listitem>
+ </itemizedlist>
+ as is shown in <xref linkend="usage-mail-vfolder-fig-createrule">
+
+ <figure id="usage-mail-vfolder-fig-createrule">
+ <title>Selecting a vFolder Rule</title>
+ <screenshot>
+ <screeninfo>Selecting a vFolder Rule</screeninfo>
+ <graphic fileref="fig/vfolder-createrule-fig" format="png" srccredit="Aaron Weber">
+ </graphic>
+ </screenshot>
+ </figure>
+ </para>
+ <para>
+
+ Once you click <guibutton>Next</guibutton>, you'll
+ customize the vFolder rule. This process is somewhat
+ complicated, but promises to get much more simple in
+ future versions of <application>Evolution</application>.
+ As it stands now, try clicking different things to have
+ the sentence in the bottom frame make sense.
+
+ </para>
</sect2>
<sect2 id="usage-mail-organize-filters">
@@ -717,9 +786,21 @@
To create a filter, go to your
<interface>Inbox</interface>. Then select
<guimenuitem>Filter Druid</guimenuitem> from the
- <guimenu>Tools</guimenu> menu. This will start the a
- <glossterm> druid</glossterm>, which will allow you to
- create filters.
+ <guimenu>Tools</guimenu> menu. This will bring up a
+ <glossterm>druid</glossterm>, or assistant, which will
+ allow you to create filters. The <interface>filter
+ druid</interface> is shown in <xref linkend="usage-mail-filters-fig-new">
+
+
+ <figure id="usage-mail-filters-fig-new">
+ <title>Creating a new Filter</title>
+ <screenshot>
+ <screeninfo>Creating a new Filter</screeninfo>
+ <graphic fileref="fig/filter-new-fig" format="png" srccredit="Aaron Weber">
+ </graphic>
+ </screenshot>
+ </figure>
+
</para>
<para> The <interface>filter druid</interface> window
@@ -774,3 +855,4 @@
</sect1>
</chapter>
<!-- ================ END OF MAILER CHAPTER ============= -->
+