diff options
author | Kevin Breit <battery841@mediaone.net> | 2001-07-04 03:58:21 +0800 |
---|---|---|
committer | Kevin Breit <battery841@src.gnome.org> | 2001-07-04 03:58:21 +0800 |
commit | 8ce7603f8356ca2c775fa6a3edfb71949afb6383 (patch) | |
tree | bb0735b95791878cae339c5628ad37da117f2fb0 | |
parent | 3fe9876bc7a1e13cf15287dd78ded6f3def401e8 (diff) | |
download | gsoc2013-evolution-8ce7603f8356ca2c775fa6a3edfb71949afb6383.tar.gz gsoc2013-evolution-8ce7603f8356ca2c775fa6a3edfb71949afb6383.tar.zst gsoc2013-evolution-8ce7603f8356ca2c775fa6a3edfb71949afb6383.zip |
Put in lots of orderedlists...more SGML, less for the user to read.
2001-07-03 Kevin Breit <battery841@mediaone.net>
* C/usage-mail.sgml: Put in lots of orderedlists...more SGML, less
for the user to read. They'll thank me in droves later.
svn path=/trunk/; revision=10764
-rw-r--r-- | doc/C/usage-exec-summary.sgml | 201 | ||||
-rw-r--r-- | doc/C/usage-mail.sgml | 808 | ||||
-rw-r--r-- | doc/ChangeLog | 7 | ||||
-rw-r--r-- | help/C/usage-exec-summary.sgml | 201 | ||||
-rw-r--r-- | help/C/usage-mail.sgml | 808 | ||||
-rw-r--r-- | help/ChangeLog | 7 |
6 files changed, 1300 insertions, 732 deletions
diff --git a/doc/C/usage-exec-summary.sgml b/doc/C/usage-exec-summary.sgml index 77f84e8230..cccf6c409f 100644 --- a/doc/C/usage-exec-summary.sgml +++ b/doc/C/usage-exec-summary.sgml @@ -3,8 +3,8 @@ <para> My Evolution is designed to show you a summary of important information: the appointments for a given - day, important email, and so forth. To see your My Evolution. - , click on the <guibutton>My Evolution</guibutton> + day, important email, and so forth. To see your My Evolution, + click on the <guibutton>My Evolution</guibutton> button in the shortcut bar, or select the <guilabel>My Evolution</guilabel> folder in the folder bar. @@ -14,40 +14,24 @@ <title>Introducing My Evolution</title> <para> The first thing you'll want to do with My Evolution - is add a service. Click the <guibutton>Add Service</guibutton> - button in the toolbar, then select one of the available - services. Services may vary depending upon your system, but - most installations will have at least the following options: + is add a service. Go to + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>My Evolution Settings</guimenuitem> + </menuchoice> + then select one of the available + services. Services may vary depending upon your system, but + most installations will have at least the following options: + <variablelist> - <variablelist> - - <varlistentry> - <term>Calendar</term> - <listitem> - <para> - Pending appointments and other events for that day. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>Inbox</term> - <listitem> - <para> - Information about your mail, such as the number of - new messages you have waiting. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>To Do</term> - <listitem> - <para> - A short summary of your task pad. - </para> - </listitem> - </varlistentry> + <varlistentry> + <term>Mail</term> + <listitem> + <para> + Display amount of unread email in your selected folders. + </para> + </listitem> + </varlistentry> <varlistentry> <term>RDF Summary</term> @@ -61,27 +45,136 @@ </listitem> </varlistentry> - </variablelist> - - </para> + <varlistentry> + <term>Weather</term> + <listitem> + <para> + Shows you the current weather for the cities of your choice. + </para> + </listitem> + </varlistentry> - <para> - Each service appears in a small box on the screen; you can - remove the service by clicking the <guibutton>x</guibutton> - button in the upper right, or bring up a settings dialog by - clicking the little wrench icon below that. - </para> - </sect1> -<!-- - <sect1 id="exec-services-detail"> - <title>Services in Detail</title> + <varlistentry> + <term>Schedule</term> + <listitem> + <para> + Lets you see the events for the day. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + <application>Evolution</application> comes with ... enabled by + default. + </para> + <sect2 id="new-components"> + <title>Adding New Components</title> + <para> + To add a new service: + <orderedlist numeration="arabic"> + <listitem> + <para> + Choose + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>My Evolution Settings</guimenuitem> + </menuchoice> + from the menubar. + </para> + </listitem> + <listitem> + <para> + Select the service you wish to add by clicking on the respective + tab. + </para> + </listitem> + <listitem> + <para> + Choose <guibutton>OK</guibutton> when finished configuring the + item. + </para> + </listitem> + </orderedlist> + </para> + </sect2> + <sect2 id="delete-components"> + <title>Deleting Components</title> + <para> + Of course, there are possibly some components which you'd prefer not too + view in your My Evolution. + To remove a component: + <orderedlist numeration="arabic"> + <listitem> + <para> + Choose + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>My Evolution Settings</guimenuitem> + </menuchoice> + from the menubar. + </para> + </listitem> + <listitem> + <para> + Click the <guilabel>Enable</guilabel> button in the component you + would like to disable. + <!-- This is incorrect. I am going to ask Iain if he could throw + in an Enable button --> + </para> + </listitem> + </orderedlist> + </para> + </sect2> + <sect2 id="modifying-components"> + <title>Modifying Components</title> <para> - This section will show you how to use several - <application>Evolution</application> services, once they - become available. Wait for updates. FIXME + Chances are, the components that you setup aren't going to be setup for + your needs. For instance, you may choose that you want to use different + city choices than the default settings. + <application>Evolution</application> lets you configure all the + components in My Evolution. </para> - - </sect1> ---> + <sect3 id="modifying-components-mail"> + <title>Modifying Mail</title> + <para> + To modify mail: + <orderedlist numeration="arabic"> + <listitem> + <para> + Choose + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>My Evolution Settings</guimenuitem> + </menuchoice> + from the menubar. + </para> + </listitem> + <listitem> + <para> + Click the <guilabel>Mail</guilabel> tab at the top of the + window. + </para> + </listitem> + </orderedlist> + </para> + <para> + The <guilabel>Mail</guilabel> service window is broken up into two + sections. The left section is where your mail folders are listed. + The right section shows which folders are displayed. + </para> + <para> + To add a folder to be displayed, click on a folder in the + <guilabel>All folders</guilabel> section and click the + <guibutton>Add</guibutton> button. + </para> + <para> + To remove a folder from the service, click on the folder in the + <guilabel>Display folders</guilabel> section and click the + <guibutton>Remove</guibutton> button. + </para> + </sect3> + </sect2> + </sect1> </chapter> diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml index 1217109a25..3f8ced92f1 100644 --- a/doc/C/usage-mail.sgml +++ b/doc/C/usage-mail.sgml @@ -56,6 +56,7 @@ start with the <interface>Inbox</interface> open and show you a message from Ximian welcoming you to the application. </para> + <para> Your <application>Evolution</application> <guilabel>Inbox</guilabel> will look something like the one in @@ -82,172 +83,296 @@ </figure> <!-- ==============End of Figure============================== --> - <para> - <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> - <guilabel>Email Viewer</guilabel> - </para> - - <para> - This is where your email is displayed. - </para> + <para> + <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> + <guilabel>Email Viewer</guilabel> + </para> + + <para> + This is where your email is displayed. + </para> - <para> - <inlinegraphic fileref="fig/full-2.png"></inlinegraphic> - <guilabel>Email List</guilabel> - </para> + <para> + <inlinegraphic fileref="fig/full-2.png"></inlinegraphic> + <guilabel>Email List</guilabel> + </para> + + <para> + The <guilabel>Email List</guilabel> lists off all the emails that you + have. This includes all your read, unread, and email that is flagged + to be deleted. + </para> + + <para> + Most of the mail-related actions you'll want to perform are + listed in the <guimenu>Message</guimenu> menu in the menu + bar. The most frequently used ones, like + <guimenuitem>Reply</guimenuitem> and + <guimenuitem>Forward</guimenuitem>, also appear as buttons in + the toolbar. Almost all of them are also located in the + right-click menu and as keyboard shortcuts, which tend to be + faster once you get the hang of them. You can choose + whichever way you like best; the idea is that the software + should work the way you want, rather than making you work the + way the it does. + + <tip id="view-headers"> + <title>Take a look at the headers</title> + <para> + To look at the entire source of your email message, including + all the header information, select + <menuchoice><guimenu>View</guimenu><guimenuitem>Source</guimenuitem></menuchoice> + </para> + </tip> + </para> + + <sect2 id="usage-mail-listorder"> + <title>Sorting the message list</title> <para> - The <guilabel>Email List</guilabel> lists off all the emails that you - have. This includes all your read, unread, and email that is flagged to be deleted. + One of the ways <application>Evolution</application> lets + you choose the way you work is the way it lets you sort your + message lists. To sort by sender, subject, or date, click + on the bars with those labels at the top of the message + list. The direction of the arrow next to the label indicates + the direction of the sort, and if you click again, you'll + sort them in reverse order. For example, click once on + <guilabel>Date</guilabel> to sort messages by date from + oldest to newest. Click again, and + <application>Evolution</application> sorts the list from + newest to oldest. You can also right-click on the message + header bars to get a set of sorting options, and add or + remove columns from the message list. You can find detailed + instructions on how to customize your message display + columns in <xref linkend="usage-mail-organize-columns">. </para> - <para> - Most of the mail-related actions you'll want to perform are - listed in the <guimenu>Message</guimenu> menu in the menu - bar. The most frequently used ones, like - <guimenuitem>Reply</guimenuitem> and - <guimenuitem>Forward</guimenuitem>, also appear as buttons in - the toolbar, and almost all of them are duplicated in the - right-click menu and as keyboard shortcuts, which tend to be - faster once you get the hang of them. You can choose - whichever way you like best; the idea is that the software - should work the way you want, rather than making you work the - way the it does. - <tip id="view-headers"> - <title>Take a look at the headers</title> - <para> - To look at the entire source of your email message, including - all the header information, select - <menuchoice><guimenu>View</guimenu><guimenuitem>Source</guimenuitem></menuchoice> - </para> - </tip> + You can also choose a threaded message view. Select + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Threaded</guimenuitem> + </menuchoice> + to turn the threaded view on or off. When you select this option, + <application>Evolution</application> groups the replies to a + message with the original, so you can follow the thread of a + conversation from one message to the next. </para> - - <sect2 id="usage-mail-listorder"> - <title>Sorting the message list</title> - <para> - One of the ways <application>Evolution</application> lets - you choose the way you work is the way it lets you sort your - message lists. To sort by sender, subject, or date, click - on the bars with those labels at the top of the message - list. The direction of the arrow next to the label indicates - the direction of the sort, and if you click again, you'll - sort them in reverse order. For example, click once on - <guilabel>Date</guilabel> to sort messages by date from - oldest to newest. Click again, and - <application>Evolution</application> sorts the list from - newest to oldest. You can also right-click on the message - header bars to get a set of sorting options, and add or - remove columns from the message list. You can find detailed - instructions on how to customize your message display - columns in <xref linkend="usage-mail-organize-columns">. - </para> - <para> - You can also choose a threaded message view. Select - <menuchoice> <guimenu>View</guimenu> - <guimenuitem>Threaded</guimenuitem> </menuchoice> to turn - the threaded view on or off. When you select this option, - <application>Evolution</application> groups the replies to a - message with the original, so you can follow the thread of a - conversation from one message to the next. - </para> - </sect2> - <sect2 id="usage-mail-getnsend-delete"> + </sect2> + + <sect2 id="usage-mail-getnsend-delete"> <title>Deleting Mail</title> <para> Once you've read your mail, you may want to get rid of - it. To mark a message for deletion, select it in the the - <interface>message list</interface> by clicking on it once. - Then click on the <guibutton>Delete</guibutton> button in - the tool bar. Or, right-click on a message and choose - <guimenuitem>Delete</guimenuitem> from the right-click - menu. The message will appear with a line through it, to - show that you've marked it for deletion. - </para> - <para> - If you change your mind and decide you want to keep it, - select <menuchoice> <guimenu>Message</guimenu> - <guimenuitem>Undelete</guimenuitem></menuchoice>. If you - really want to get rid of it, choose - <guimenuitem>Expunge</guimenuitem> from the - <guimenu>Folder</guimenu> menu. That will delete it - permanently. - </para> - </sect2> - </sect1> - - <sect1 id="usage-mail-getnsend-get"> - <title>Checking Mail</title> - <para> - Now that you've had a look around the - <interface>Inbox</interface>, it's time to check for new mail. - Click <guibutton>Get mail</guibutton> in the toolbar to check - your mail. If it's the first time you've done so, the - <interface>mail setup assistant</interface> will ask you for - the information it needs to check your mail (see <xref - linkend="config-setupassist"> for more information). - </para> - <para> - Then, you need to enter your email - password. <application>Evolution</application> will remember - your password until until you select <menuchoice> - <guimenu>Settings</guimenu> <guimenuitem>Forget - Passwords</guimenuitem> </menuchoice>. + it. + To delete a message: + <orderedlist numeration="arabic"> + <listitem> + <para> + Click the message to select it + </para> + </listitem> + <listitem> + <para> + Press delete button or right click and click on + <guilabel>Delete</guilabel>. + </para> + <note> + <title>Deleted but still here?</title> + <para> + When you do this, your message is marked to be deleted. It is + not until you expunge the message that the message is gone. + </para> + </note> + </listitem> + <listitem> + <para> + Click + <menuchoice> + <guimenu>Actions</guimenu> + <guimenuitem>Expunge</guimenuitem> + </menuchoice> + or press + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>E</keycap> + </keycombo> + </para> + </listitem> + </orderedlist> </para> + </sect2> + <sect2 id="usage-mail-getnsend-undelete"> + <title>Undeleting Messages</title> <para> - Once it's validated the password, - <application>Evolution</application> will check your mail. - New mail will appear in the local <interface>Inbox</interface> - if you're using a <glossterm>POP</glossterm> account, and in - your <glossterm>IMAP</glossterm> folders if you use IMAP. If - you have chosen to use IMAP, and you have multiple folders on - your IMAP server, you may need to subscribe to them. To learn - how to use the subscription manager, read <xref - linkend="usage-mail-subscriptions">. - </para> - - <note id="badmailsettings"> - <title>Can't Check Mail?</title> - <para> - If you get an error message instead of mail, you probably need - to change your network settings. To learn how to do that, - have a look at <xref linkend="config-prefs-mail-network">, or - ask your system administrator. + To undelete a message: + <orderedlist numeration="arabic"> + <listitem> + <para> + Click a message marked for deletion to select it + </para> + </listitem> + <listitem> + <para> + Click + <menuchoice> + <guimenu>Actions</guimenu> + <guimenuitem>Undelete</guimenuitem> + </menuchoice> + </para> + <note> + <title>What does Undelete actually do?</title> + <para> + Undelete doesn't bring back messages that have been expunged. + Undelete simply unmarks messages for expunging. + </para> + </note> + </listitem> + </orderedlist> </para> - </note> + </sect2> + </sect1> - <sect2 id="usage-mail-getnsend-get-news"> - <title>Using Evolution for News </title> - <para> - Newsgroups are so similar to email that there's no reason not - to read them side by side. If you want to do that, add a - news source to your configuration (see <xref - linkend="config-prefs-network-news">). The news server will - appear as a remote server, and will look quite similar to an - IMAP folder. When you click <guibutton>Get Mail</guibutton>, - <application>Evolution</application> will also check for news - messages. + <sect1 id="usage-mail-getnsend-get"> + <title>Checking Mail</title> + <para> + Now that you've had a look around the <interface>Inbox</interface>, it's + time to check for new mail. Click <guibutton>Get Mail</guibutton> in the + toolbar to check your mail. If it's the first time you've done so, the + <interface>mail setup assistance</interface> will ask you for the + information it needs to check your email. + </para> + <para> + The druid will give you several dialogue boxes where you setup: + <itemizedlist> + <listitem> + <para> + Setup your personal information + </para> + </listitem> + <listitem> + <para> + Setup your outgoing email server information + </para> + </listitem> + <listitem> + <para> + Identity Name + </para> + </listitem> + </itemizedlist> + </para> + <para> + To check your email, press the <guibutton>Check Mail</guibutton> button. + If this is your first time checking mail, or you don't have + <application>Evolution</application> setup to store your password, you'll + be prompted for the password. Enter your password and your email will be + downloaded. + </para> + <note id="badmailsettings"> + <title>Can't Check Mail?</title> + <para> + If you get an error message instead of mail, you probably need to check + your network settings. If you. To learn how to do that, + have a look at <xref linkend="config-prefs-mail-network">, or + ask your system administrator. </para> - </sect2> + </note> - <sect2 id="usage-mail-getnsend-get-attach"> - <title>Attachments and HTML Mail</title> - <para> - If someone sends you an <glossterm>attachment</glossterm>, a - file attached to an email, - <application>Evolution</application> will display the file - at the bottom of the message to which it's attached. Text, - HTML, and most images will be displayed within the message - itself. For other files, - <application>Evolution</application> will show an icon at - the end of the message. Right-click on the icon to get a - list of options which will vary depending on the type of - attachment. You will have the option to display most files - as part of the message, export them to a different - application (images to Eye of GNOME, spreadsheets to - Gnumeric, and so forth), or save them to disk. - </para> + <sect2 id="usage-mail-getnsend-get-news"> + <title>Using Evolution for News </title> + <para> + Newsgroups are so similar to email that there's no reason not + to read them side by side. If you want to do that, add a + news source to your configuration (see <xref + linkend="config-prefs-network-news">). The news server will + appear as a remote server, and will look quite similar to an + IMAP folder. When you click <guibutton>Get Mail</guibutton>, + <application>Evolution</application> will also check for news + messages. + </para> + </sect2> + <sect2 id="usage-mail-getnsend-get-attach"> + <title>Attachments and HTML Mail</title> + <para> + If someone sends you an <glossterm>attachment</glossterm>, a + file attached to an email, + <application>Evolution</application> will display the file + at the bottom of the message to which it's attached. Text, + HTML, and most images will be displayed within the message + itself. For other files, + <application>Evolution</application> will show an icon at + the end of the message. + </para> + <para> + To Save an Attachment to Disk: + <orderedlist numeration="arabic"> + <listitem> + <para> + Open up the desired email + </para> + </listitem> + <listitem> + <para> + Click on the down arrow at the bottom of the email for the desired + attachment. + </para> + </listitem> + <listitem> + <para> + Select <guibutton>Save to Disk</guibutton>. + </para> + </listitem> + <listitem> + <para> + Choose the directory and filename you wish. + </para> + </listitem> + <listitem> + <para> + Click <guibutton>OK</guibutton> + </para> + </listitem> + </orderedlist> + </para> + <tip> + <para> + To automatically view an attachment inline, press the arrow button next + to the attachment. + </para> + </tip> + <para> + To Open an Attachment in a Program: + <orderedlist numeration="arabic"> + <listitem> + <para> + Open up the desired email + </para> + </listitem> + <listitem> + <para> + Click the down arrow at the bottom of the email for the desired + attachment. + </para> + </listitem> + <listitem> + <para> + Click <guibutton>Open in Program</guibutton> where program is the + program that is assigned to open that file type. + </para> + </listitem> + </orderedlist> + </para> + + + <!-- Right-click on the icon to get a + list of options which will vary depending on the type of + attachment. You will have the option to display most files + as part of the message, export them to a different + application (images to Eye of GNOME, spreadsheets to + Gnumeric, and so forth), or save them to disk. + </para> + --> <para> <application>Evolution</application> can also display HTML-formatted mail, complete with graphics. HTML @@ -283,14 +408,14 @@ <!-- Check the alignment of the following paragraph in the PS and HTML output: it's indented for no good reason - Kevin Breit: I dont see a problem with it. ---> + Kevin Breit: I dont see a problem with the HTML. + --> <para> - Enter an address in the <guilabel>To:</guilabel> field, a - subject in the <guilabel>Subject:</guilabel> and a message in - the big empty box at the bottom of the window, and press - <guibutton>Send</guibutton>. - </para> + Enter an address in the <guilabel>To:</guilabel> field. If you wish + enter a subject in the <guilabel>Subject:</guilabel> and a message in + the big empty box at the bottom of the window. Once you have revised + your message, press <guibutton>Send</guibutton>. + </para> <sect2 id="usage-mail-getnsend-send-delay"> <title>Saving Messages for Later</title> @@ -312,44 +437,57 @@ filter behavior, see <xref linkend="config-prefs-mail">. </para> - <para> - You can also choose to save messages as drafts or as text - files. Choose - <menuchoice> - <guimenu>File</guimenu> - <guimenuitem>Save</guimenuitem> + <para> + You can also choose to save messages as drafts or as text + files. Choose + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Save</guimenuitem> </menuchoice> - or <guimenuitem>Save As</guimenuitem> to save your message - as a text file. If you prefer to keep your message in a - folder (the <guilabel>Drafts</guilabel> folder would be the - obvious place), you can select <menuchoice> + or <guimenuitem>Save As</guimenuitem> to save your message + as a text file. If you prefer to keep your message in a + folder (the <guilabel>Drafts</guilabel> folder would be the + obvious place), you can select <menuchoice> <guimenu>File</guimenu> <guimenuitem>Save In - Folder</guimenuitem> </menuchoice>. - </para> - </sect2> - <sect2 id="usage-mail-getnsend-send-compose"> - <title>Advanced Mail Composition</title> - <para> - You can probably guess the purpose of the buttons labelled - <guibutton>Cut</guibutton>, <guibutton>Copy</guibutton>, - <guibutton>Paste</guibutton>, <guibutton>Undo</guibutton> - and <guibutton>Redo</guibutton>, but there's a bit more to - sending mail that's less obvious. In the next few sections, - you'll see how <application>Evolution</application> handles - additional features, including large recipient lists, - attachments, and forwarding. - </para> + Folder</guimenuitem> </menuchoice>. + </para> + </sect2> + + <sect2 id="usage-mail-getnsend-send-compose"> + <title>Advanced Mail Composition</title> + <para> + <application>Evolution</application> is meant to not only handle large + amounts of incoming mail, but helps you manage all the tasks of having + an email account. + In the next few sections, you'll see how + <application>Evolution</application> handles additional features, + including large recipient lists, attachments, and forwarding. + </para> <sect3 id="usage-mail-getnsend-send-attach"> <title>Attachments</title> <para> - If you want to attach a file to your email message, you - can drag it from your desktop into the message window, or - click the button in the toolbar with a paper clip on it, - labelled <guibutton>Attach</guibutton>. If you click the - <guibutton>Attach</guibutton> button, - <application>Evolution</application> will open a file - selection dialog box to ask you which file you want to - send. Select the file and click <guilabel>OK</guilabel>. + To attach a file to your email: + <orderedlist numeration="arabic"> + <listitem> + <para> + Push the attach button in the composer toolbar + </para> + </listitem> + <listitem> + <para> + Select the file you want to attach + </para> + </listitem> + <listitem> + <para> + Press <guibutton>OK</guibutton> + </para> + </listitem> + </orderedlist> + </para> + <para> + You can drag a file from your desktop into the composer window to + attach it as well. </para> <para> To hide the display of files you've attached to the @@ -371,11 +509,12 @@ addressbook, or never load images. </para> </sect3> + <sect3 id="usage-mail-getnsend-send-to-types"> - <title>Types of Recipients</title> + <title>Types of Recipients</title> <para> - <application>Evolution</application>, like most email - programs recognizes three types of addressee: primary + <application>Evolution</application>, like most email + programs recognizes three types of addressee: primary recipients, secondary recipients, and hidden ("blind") recipients. </para> @@ -429,7 +568,7 @@ <sect3 id="usage-mail-getnsend-send-to"> <title>Choosing Recipients Quickly</title> <para> -f you have created address cards in the contact manager, + If you have created address cards in the contact manager, you can also enter nicknames or other portions of address data, and <application>Evolution</application> will transparently complete @@ -446,7 +585,7 @@ f you have created address cards in the contact manager, Alternately, you can click on the <guibutton>To:</guibutton>, <guibutton>Cc:</guibutton>, or <guibutton>Bcc:</guibutton> buttons to get a list — - potentially a very long one — of the email addresses + a potentially a very long one — of the email addresses in your contact manager. Select addresses and click on the arrows to move them into the appropriate address columns. @@ -543,7 +682,7 @@ with quoted materials and the relevant replies interspersed--> <sect2 id="usage-mail-getnsend-send-find"> <title>Searching and Replacing with the Composer</title> <para> - You're probably familiar with search and replace features, + You maybe familiar with search and replace features, and if you come from a Linux or Unix background, you probably know what <guimenuitem>Find Regex</guimenuitem> does. If you aren't among the lucky who already know, @@ -588,6 +727,7 @@ with quoted materials and the relevant replies interspersed--> </variablelist> </para> + <para> For all of these menu items, you can choose whether or not to <guilabel>Search Backwards</guilabel> in the document @@ -598,6 +738,7 @@ with quoted materials and the relevant replies interspersed--> a match. </para> </sect2> + <sect2 id="usage-mail-getnsend-send-html"> <title>Embellish your email with HTML</title> <para> @@ -650,44 +791,44 @@ with quoted materials and the relevant replies interspersed--> or <guilabel>Header 1</guilabel> through <guilabel>Header 6</guilabel> for varying sizes of header from large (1) to tiny (6). Other styles - include <guilabel>pre</guilabel>, to use the HTML + include <guilabel>preformat</guilabel>, to use the HTML tag for preformatted blocks of text, and three types of <guilabel>List Item</guilabel> for the highly organized. </para> </listitem> </varlistentry> - <varlistentry> - <term>Text style</term> - <listitem> - <para> - Use these buttons to determine the way your letters - look. If you have text selected, the style will - apply to the selected text. If you do not have text - selected, the style will apply to whatever you type - next. The buttons are: - <itemizedlist mark="none"> - <listitem><para>Push <guibutton>B</guibutton> for bold text</para></listitem> - <listitem><para>Push <guibutton>I</guibutton> for italics</para></listitem> - <listitem><para>Push <guibutton>U</guibutton> to underline</para></listitem> - <listitem><para>Push <guibutton>S</guibutton> for a strikethrough.</para></listitem> - </itemizedlist> - </para> - </listitem> - </varlistentry> - <varlistentry> + <varlistentry> + <term>Text style</term> + <listitem> + <para> + Use these buttons to determine the way your letters + look. If you have text selected, the style will + apply to the selected text. If you do not have text + selected, the style will apply to whatever you type + next. The buttons are: + <itemizedlist mark="none"> + <listitem><para>Push <guibutton>B</guibutton> for bold text</para></listitem> + <listitem><para>Push <guibutton>I</guibutton> for italics</para></listitem> + <listitem><para>Push <guibutton>U</guibutton> to underline</para></listitem> + <listitem><para>Push <guibutton>S</guibutton> for a strikethrough.</para></listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> <term>Alignment</term> - <listitem> - <para> - Located next to the text style buttons, these three - paragraph icons should be familiar to users of most - word processing software. The leftmost button will - make your text aligned to the left, the center - button, centered, and the right hand button, - aligned on the right side. - </para> - </listitem> - </varlistentry> + <listitem> + <para> + Located next to the text style buttons, these three + paragraph icons should be familiar to users of most + word processing software. The leftmost button will + make your text aligned to the left, the center + button, centered, and the right hand button, + aligned on the right side. + </para> + </listitem> + </varlistentry> <varlistentry> <term>Indentation rules</term> @@ -719,79 +860,114 @@ with quoted materials and the relevant replies interspersed--> </variablelist> </para> <para> - There are three tools that you can find only in the - <guimenu>Insert</guimenu> menu. - <variablelist> - <varlistentry> - <term><guimenuitem>Insert Link</guimenuitem>:</term> - <listitem> - <para> - Use this tool to put hyperlinks in your HTML - messages. When you select it, - <application>Evolution</application> will prompt you - for the <guilabel>Text</guilabel> that will appear, - and the <guilabel>Link</guilabel>, where you should - enter the actual web address (URL). If you don't - want special link text, you can just enter the address + The <guimenu>Insert</guimenu> gives you three opinions which let you + spruce up your email to make it more interesting: + <variablelist> + <varlistentry> + <term><guimenuitem>Insert Link</guimenuitem></term> + <listitem> + <para> + Lets you link some text to a website. Use this tool to put hyperlinks in your HTML + messages. 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> - 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> - <varlistentry> - <term><guimenuitem>Insert Rule</guimenuitem>:</term> - <listitem><para> - This will insert a horizontal line, or rule, into your document. - You'll be presented with a dialog box which gives you - the choice of size, percentage of screen, shading, and - alignment; if you leave everything at the default - values you'll get a thin black rule all the way across - the screen.</para></listitem> - </varlistentry> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>Insert Image</guimenuitem></term> + <listitem> + <para> + Lets you put an image alongside text. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>Insert Rule</guimenuitem></term> + <listitem> + <para> + Inserts a horizontal line into the text to help divide two + sections. + </para> + </listitem> + </varlistentry> + </variablelist> + To add a hyperlink to your HTML message: + <orderedlist numeration="arabic"> + <listitem> + <para> + Select the text you want to link from + </para> + </listitem> + <listitem> + <para> + Right click on text and select + <guimenuitem>Link</guimenuitem> + </para> + </listitem> + <listitem> + <para> + Enter the address you wish to link to in the + <guilabel>URL</guilabel> field. + </para> + </listitem> + <listitem> + <para> + Press <guibutton>OK</guibutton>. + </para> + </listitem> + </orderedlist> + </para> + <para> + To add an image to your HTML message: + <orderedlist numeration="arabic"> + <listitem> + <para> + Click + <menuchoice> + <guimenu>Insert</guimenu> + <guimenuitem>Image</guimenuitem> + </menuchoice> + </para> + </listitem> + <listitem> + <para> + Click <guibutton>Browse</guibutton> + </para> + </listitem> + <listitem> + <para> + Select the image you want + </para> + </listitem> + <listitem> + <para> + Press <guibutton>OK</guibutton> + </para> + </listitem> + <listitem> + <para> + Press <guibutton>Insert</guibutton> + </para> + </listitem> + </orderedlist> - </variablelist> - </para> - <note> - <title>A Technical note on HTML Tags</title> - <para> - The composer is a <acronym>WYSIWYG</acronym> - (What You See Is What You Get) - editor for HTML. That means that if you enter HTML - directly into the composer— say, <markup - role="html"><B>Bold Text</B></markup>, the - the composer will assume you meant exactly that string - of characters, and not "make this text bold," as an HTML - composition tool or text editor would. - </para> + </para> + <note> + <title>A Technical note on HTML Tags</title> + <para> + The composer is a <acronym>WYSIWYG</acronym> + (What You See Is What You Get) + editor for HTML. That means that if you enter HTML + directly into the composer— say, + <markup role="html"><B>Bold Text</B></markup>, the + the composer will assume you meant exactly that string + of characters, and not "make this text bold," as an HTML + composition tool or text editor would. + </para> </note> </sect2> - -<!-- Function not implemented, possibly never will be due to security evil. --> -<!-- - <sect3 id="usage-mail-getnsend-send-live"> - <title>Live Documents</title> - <para> - Later versions of <application>Evolution</application> - will allow you to enliven your email with almost any - sort of document, and even with entire - applications. At this point, however, this feature has not - yet been implemented. - </para> - </sect3> ---> - <sect2 id="usage-mail-getnsend-fwd"> <title>Forwarding Mail</title> <para> @@ -828,6 +1004,7 @@ with quoted materials and the relevant replies interspersed--> <guibutton>Send</guibutton>. </para> </sect2> + <sect2 id="usage-mail-getnsend-ettiquette"> <title>Seven Tips for Email Courtesy</title> <para> @@ -892,24 +1069,31 @@ with quoted materials and the relevant replies interspersed--> <para> <application>Evolution</application> lets you handle your IMAP and newsgroup subscriptions with the same tool: the - subscriptions manager. To start using it, choose - <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Manage - Subscriptions</guimenuitem> </menuchoice>. - </para> - <para> - If you have configured any IMAP (mail) or NNTP (news) - servers, you will see them listed in the left half of the - subscription management window. Click on a server to select - it, and you will see the folders or newsgroups available to - you. You can then select individual folders and subscribe to - them, or remove yourself from the subscription list. - </para> - <para> - Once you have subscribed to a folder or newsgroup, your system - will check for new messages whenever you press the - <guibutton>Get Mail</guibutton> button. - </para> -</sect1> + subscriptions manager. + + <orderedlist numeration="arabic"> + <listitem> + <para> + Click on the folder you wish to subscribe to in the + <guilabel>Store</guilabel> section. + </para> + </listitem> + <listitem> + <para> + Click the <guibutton>Subscribe</guibutton> to add it to the + subscribed list. + </para> + </listitem> + <listitem> + <para> + Close the window. + </para> + </listitem> + + </orderedlist> + </para> + + </sect1> <sect1 id="encryption"> diff --git a/doc/ChangeLog b/doc/ChangeLog index 7caf5ae499..ac79ab4be3 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,10 @@ +2001-07-03 Kevin Breit <battery841@mediaone.net> + + * C/usage-mail.sgml: Put in lots of orderedlists...more SGML, less + for the user to read. They'll thank me in droves later. + + * C/usage-exec-summary.sgml: Fixed build error + 2001-06-29 Jeffrey Stedfast <fejj@ximian.com> * white-papers/mail/camel.sgml: Updated slightly. diff --git a/help/C/usage-exec-summary.sgml b/help/C/usage-exec-summary.sgml index 77f84e8230..cccf6c409f 100644 --- a/help/C/usage-exec-summary.sgml +++ b/help/C/usage-exec-summary.sgml @@ -3,8 +3,8 @@ <para> My Evolution is designed to show you a summary of important information: the appointments for a given - day, important email, and so forth. To see your My Evolution. - , click on the <guibutton>My Evolution</guibutton> + day, important email, and so forth. To see your My Evolution, + click on the <guibutton>My Evolution</guibutton> button in the shortcut bar, or select the <guilabel>My Evolution</guilabel> folder in the folder bar. @@ -14,40 +14,24 @@ <title>Introducing My Evolution</title> <para> The first thing you'll want to do with My Evolution - is add a service. Click the <guibutton>Add Service</guibutton> - button in the toolbar, then select one of the available - services. Services may vary depending upon your system, but - most installations will have at least the following options: + is add a service. Go to + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>My Evolution Settings</guimenuitem> + </menuchoice> + then select one of the available + services. Services may vary depending upon your system, but + most installations will have at least the following options: + <variablelist> - <variablelist> - - <varlistentry> - <term>Calendar</term> - <listitem> - <para> - Pending appointments and other events for that day. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>Inbox</term> - <listitem> - <para> - Information about your mail, such as the number of - new messages you have waiting. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>To Do</term> - <listitem> - <para> - A short summary of your task pad. - </para> - </listitem> - </varlistentry> + <varlistentry> + <term>Mail</term> + <listitem> + <para> + Display amount of unread email in your selected folders. + </para> + </listitem> + </varlistentry> <varlistentry> <term>RDF Summary</term> @@ -61,27 +45,136 @@ </listitem> </varlistentry> - </variablelist> - - </para> + <varlistentry> + <term>Weather</term> + <listitem> + <para> + Shows you the current weather for the cities of your choice. + </para> + </listitem> + </varlistentry> - <para> - Each service appears in a small box on the screen; you can - remove the service by clicking the <guibutton>x</guibutton> - button in the upper right, or bring up a settings dialog by - clicking the little wrench icon below that. - </para> - </sect1> -<!-- - <sect1 id="exec-services-detail"> - <title>Services in Detail</title> + <varlistentry> + <term>Schedule</term> + <listitem> + <para> + Lets you see the events for the day. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + <application>Evolution</application> comes with ... enabled by + default. + </para> + <sect2 id="new-components"> + <title>Adding New Components</title> + <para> + To add a new service: + <orderedlist numeration="arabic"> + <listitem> + <para> + Choose + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>My Evolution Settings</guimenuitem> + </menuchoice> + from the menubar. + </para> + </listitem> + <listitem> + <para> + Select the service you wish to add by clicking on the respective + tab. + </para> + </listitem> + <listitem> + <para> + Choose <guibutton>OK</guibutton> when finished configuring the + item. + </para> + </listitem> + </orderedlist> + </para> + </sect2> + <sect2 id="delete-components"> + <title>Deleting Components</title> + <para> + Of course, there are possibly some components which you'd prefer not too + view in your My Evolution. + To remove a component: + <orderedlist numeration="arabic"> + <listitem> + <para> + Choose + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>My Evolution Settings</guimenuitem> + </menuchoice> + from the menubar. + </para> + </listitem> + <listitem> + <para> + Click the <guilabel>Enable</guilabel> button in the component you + would like to disable. + <!-- This is incorrect. I am going to ask Iain if he could throw + in an Enable button --> + </para> + </listitem> + </orderedlist> + </para> + </sect2> + <sect2 id="modifying-components"> + <title>Modifying Components</title> <para> - This section will show you how to use several - <application>Evolution</application> services, once they - become available. Wait for updates. FIXME + Chances are, the components that you setup aren't going to be setup for + your needs. For instance, you may choose that you want to use different + city choices than the default settings. + <application>Evolution</application> lets you configure all the + components in My Evolution. </para> - - </sect1> ---> + <sect3 id="modifying-components-mail"> + <title>Modifying Mail</title> + <para> + To modify mail: + <orderedlist numeration="arabic"> + <listitem> + <para> + Choose + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>My Evolution Settings</guimenuitem> + </menuchoice> + from the menubar. + </para> + </listitem> + <listitem> + <para> + Click the <guilabel>Mail</guilabel> tab at the top of the + window. + </para> + </listitem> + </orderedlist> + </para> + <para> + The <guilabel>Mail</guilabel> service window is broken up into two + sections. The left section is where your mail folders are listed. + The right section shows which folders are displayed. + </para> + <para> + To add a folder to be displayed, click on a folder in the + <guilabel>All folders</guilabel> section and click the + <guibutton>Add</guibutton> button. + </para> + <para> + To remove a folder from the service, click on the folder in the + <guilabel>Display folders</guilabel> section and click the + <guibutton>Remove</guibutton> button. + </para> + </sect3> + </sect2> + </sect1> </chapter> diff --git a/help/C/usage-mail.sgml b/help/C/usage-mail.sgml index 1217109a25..3f8ced92f1 100644 --- a/help/C/usage-mail.sgml +++ b/help/C/usage-mail.sgml @@ -56,6 +56,7 @@ start with the <interface>Inbox</interface> open and show you a message from Ximian welcoming you to the application. </para> + <para> Your <application>Evolution</application> <guilabel>Inbox</guilabel> will look something like the one in @@ -82,172 +83,296 @@ </figure> <!-- ==============End of Figure============================== --> - <para> - <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> - <guilabel>Email Viewer</guilabel> - </para> - - <para> - This is where your email is displayed. - </para> + <para> + <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> + <guilabel>Email Viewer</guilabel> + </para> + + <para> + This is where your email is displayed. + </para> - <para> - <inlinegraphic fileref="fig/full-2.png"></inlinegraphic> - <guilabel>Email List</guilabel> - </para> + <para> + <inlinegraphic fileref="fig/full-2.png"></inlinegraphic> + <guilabel>Email List</guilabel> + </para> + + <para> + The <guilabel>Email List</guilabel> lists off all the emails that you + have. This includes all your read, unread, and email that is flagged + to be deleted. + </para> + + <para> + Most of the mail-related actions you'll want to perform are + listed in the <guimenu>Message</guimenu> menu in the menu + bar. The most frequently used ones, like + <guimenuitem>Reply</guimenuitem> and + <guimenuitem>Forward</guimenuitem>, also appear as buttons in + the toolbar. Almost all of them are also located in the + right-click menu and as keyboard shortcuts, which tend to be + faster once you get the hang of them. You can choose + whichever way you like best; the idea is that the software + should work the way you want, rather than making you work the + way the it does. + + <tip id="view-headers"> + <title>Take a look at the headers</title> + <para> + To look at the entire source of your email message, including + all the header information, select + <menuchoice><guimenu>View</guimenu><guimenuitem>Source</guimenuitem></menuchoice> + </para> + </tip> + </para> + + <sect2 id="usage-mail-listorder"> + <title>Sorting the message list</title> <para> - The <guilabel>Email List</guilabel> lists off all the emails that you - have. This includes all your read, unread, and email that is flagged to be deleted. + One of the ways <application>Evolution</application> lets + you choose the way you work is the way it lets you sort your + message lists. To sort by sender, subject, or date, click + on the bars with those labels at the top of the message + list. The direction of the arrow next to the label indicates + the direction of the sort, and if you click again, you'll + sort them in reverse order. For example, click once on + <guilabel>Date</guilabel> to sort messages by date from + oldest to newest. Click again, and + <application>Evolution</application> sorts the list from + newest to oldest. You can also right-click on the message + header bars to get a set of sorting options, and add or + remove columns from the message list. You can find detailed + instructions on how to customize your message display + columns in <xref linkend="usage-mail-organize-columns">. </para> - <para> - Most of the mail-related actions you'll want to perform are - listed in the <guimenu>Message</guimenu> menu in the menu - bar. The most frequently used ones, like - <guimenuitem>Reply</guimenuitem> and - <guimenuitem>Forward</guimenuitem>, also appear as buttons in - the toolbar, and almost all of them are duplicated in the - right-click menu and as keyboard shortcuts, which tend to be - faster once you get the hang of them. You can choose - whichever way you like best; the idea is that the software - should work the way you want, rather than making you work the - way the it does. - <tip id="view-headers"> - <title>Take a look at the headers</title> - <para> - To look at the entire source of your email message, including - all the header information, select - <menuchoice><guimenu>View</guimenu><guimenuitem>Source</guimenuitem></menuchoice> - </para> - </tip> + You can also choose a threaded message view. Select + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Threaded</guimenuitem> + </menuchoice> + to turn the threaded view on or off. When you select this option, + <application>Evolution</application> groups the replies to a + message with the original, so you can follow the thread of a + conversation from one message to the next. </para> - - <sect2 id="usage-mail-listorder"> - <title>Sorting the message list</title> - <para> - One of the ways <application>Evolution</application> lets - you choose the way you work is the way it lets you sort your - message lists. To sort by sender, subject, or date, click - on the bars with those labels at the top of the message - list. The direction of the arrow next to the label indicates - the direction of the sort, and if you click again, you'll - sort them in reverse order. For example, click once on - <guilabel>Date</guilabel> to sort messages by date from - oldest to newest. Click again, and - <application>Evolution</application> sorts the list from - newest to oldest. You can also right-click on the message - header bars to get a set of sorting options, and add or - remove columns from the message list. You can find detailed - instructions on how to customize your message display - columns in <xref linkend="usage-mail-organize-columns">. - </para> - <para> - You can also choose a threaded message view. Select - <menuchoice> <guimenu>View</guimenu> - <guimenuitem>Threaded</guimenuitem> </menuchoice> to turn - the threaded view on or off. When you select this option, - <application>Evolution</application> groups the replies to a - message with the original, so you can follow the thread of a - conversation from one message to the next. - </para> - </sect2> - <sect2 id="usage-mail-getnsend-delete"> + </sect2> + + <sect2 id="usage-mail-getnsend-delete"> <title>Deleting Mail</title> <para> Once you've read your mail, you may want to get rid of - it. To mark a message for deletion, select it in the the - <interface>message list</interface> by clicking on it once. - Then click on the <guibutton>Delete</guibutton> button in - the tool bar. Or, right-click on a message and choose - <guimenuitem>Delete</guimenuitem> from the right-click - menu. The message will appear with a line through it, to - show that you've marked it for deletion. - </para> - <para> - If you change your mind and decide you want to keep it, - select <menuchoice> <guimenu>Message</guimenu> - <guimenuitem>Undelete</guimenuitem></menuchoice>. If you - really want to get rid of it, choose - <guimenuitem>Expunge</guimenuitem> from the - <guimenu>Folder</guimenu> menu. That will delete it - permanently. - </para> - </sect2> - </sect1> - - <sect1 id="usage-mail-getnsend-get"> - <title>Checking Mail</title> - <para> - Now that you've had a look around the - <interface>Inbox</interface>, it's time to check for new mail. - Click <guibutton>Get mail</guibutton> in the toolbar to check - your mail. If it's the first time you've done so, the - <interface>mail setup assistant</interface> will ask you for - the information it needs to check your mail (see <xref - linkend="config-setupassist"> for more information). - </para> - <para> - Then, you need to enter your email - password. <application>Evolution</application> will remember - your password until until you select <menuchoice> - <guimenu>Settings</guimenu> <guimenuitem>Forget - Passwords</guimenuitem> </menuchoice>. + it. + To delete a message: + <orderedlist numeration="arabic"> + <listitem> + <para> + Click the message to select it + </para> + </listitem> + <listitem> + <para> + Press delete button or right click and click on + <guilabel>Delete</guilabel>. + </para> + <note> + <title>Deleted but still here?</title> + <para> + When you do this, your message is marked to be deleted. It is + not until you expunge the message that the message is gone. + </para> + </note> + </listitem> + <listitem> + <para> + Click + <menuchoice> + <guimenu>Actions</guimenu> + <guimenuitem>Expunge</guimenuitem> + </menuchoice> + or press + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>E</keycap> + </keycombo> + </para> + </listitem> + </orderedlist> </para> + </sect2> + <sect2 id="usage-mail-getnsend-undelete"> + <title>Undeleting Messages</title> <para> - Once it's validated the password, - <application>Evolution</application> will check your mail. - New mail will appear in the local <interface>Inbox</interface> - if you're using a <glossterm>POP</glossterm> account, and in - your <glossterm>IMAP</glossterm> folders if you use IMAP. If - you have chosen to use IMAP, and you have multiple folders on - your IMAP server, you may need to subscribe to them. To learn - how to use the subscription manager, read <xref - linkend="usage-mail-subscriptions">. - </para> - - <note id="badmailsettings"> - <title>Can't Check Mail?</title> - <para> - If you get an error message instead of mail, you probably need - to change your network settings. To learn how to do that, - have a look at <xref linkend="config-prefs-mail-network">, or - ask your system administrator. + To undelete a message: + <orderedlist numeration="arabic"> + <listitem> + <para> + Click a message marked for deletion to select it + </para> + </listitem> + <listitem> + <para> + Click + <menuchoice> + <guimenu>Actions</guimenu> + <guimenuitem>Undelete</guimenuitem> + </menuchoice> + </para> + <note> + <title>What does Undelete actually do?</title> + <para> + Undelete doesn't bring back messages that have been expunged. + Undelete simply unmarks messages for expunging. + </para> + </note> + </listitem> + </orderedlist> </para> - </note> + </sect2> + </sect1> - <sect2 id="usage-mail-getnsend-get-news"> - <title>Using Evolution for News </title> - <para> - Newsgroups are so similar to email that there's no reason not - to read them side by side. If you want to do that, add a - news source to your configuration (see <xref - linkend="config-prefs-network-news">). The news server will - appear as a remote server, and will look quite similar to an - IMAP folder. When you click <guibutton>Get Mail</guibutton>, - <application>Evolution</application> will also check for news - messages. + <sect1 id="usage-mail-getnsend-get"> + <title>Checking Mail</title> + <para> + Now that you've had a look around the <interface>Inbox</interface>, it's + time to check for new mail. Click <guibutton>Get Mail</guibutton> in the + toolbar to check your mail. If it's the first time you've done so, the + <interface>mail setup assistance</interface> will ask you for the + information it needs to check your email. + </para> + <para> + The druid will give you several dialogue boxes where you setup: + <itemizedlist> + <listitem> + <para> + Setup your personal information + </para> + </listitem> + <listitem> + <para> + Setup your outgoing email server information + </para> + </listitem> + <listitem> + <para> + Identity Name + </para> + </listitem> + </itemizedlist> + </para> + <para> + To check your email, press the <guibutton>Check Mail</guibutton> button. + If this is your first time checking mail, or you don't have + <application>Evolution</application> setup to store your password, you'll + be prompted for the password. Enter your password and your email will be + downloaded. + </para> + <note id="badmailsettings"> + <title>Can't Check Mail?</title> + <para> + If you get an error message instead of mail, you probably need to check + your network settings. If you. To learn how to do that, + have a look at <xref linkend="config-prefs-mail-network">, or + ask your system administrator. </para> - </sect2> + </note> - <sect2 id="usage-mail-getnsend-get-attach"> - <title>Attachments and HTML Mail</title> - <para> - If someone sends you an <glossterm>attachment</glossterm>, a - file attached to an email, - <application>Evolution</application> will display the file - at the bottom of the message to which it's attached. Text, - HTML, and most images will be displayed within the message - itself. For other files, - <application>Evolution</application> will show an icon at - the end of the message. Right-click on the icon to get a - list of options which will vary depending on the type of - attachment. You will have the option to display most files - as part of the message, export them to a different - application (images to Eye of GNOME, spreadsheets to - Gnumeric, and so forth), or save them to disk. - </para> + <sect2 id="usage-mail-getnsend-get-news"> + <title>Using Evolution for News </title> + <para> + Newsgroups are so similar to email that there's no reason not + to read them side by side. If you want to do that, add a + news source to your configuration (see <xref + linkend="config-prefs-network-news">). The news server will + appear as a remote server, and will look quite similar to an + IMAP folder. When you click <guibutton>Get Mail</guibutton>, + <application>Evolution</application> will also check for news + messages. + </para> + </sect2> + <sect2 id="usage-mail-getnsend-get-attach"> + <title>Attachments and HTML Mail</title> + <para> + If someone sends you an <glossterm>attachment</glossterm>, a + file attached to an email, + <application>Evolution</application> will display the file + at the bottom of the message to which it's attached. Text, + HTML, and most images will be displayed within the message + itself. For other files, + <application>Evolution</application> will show an icon at + the end of the message. + </para> + <para> + To Save an Attachment to Disk: + <orderedlist numeration="arabic"> + <listitem> + <para> + Open up the desired email + </para> + </listitem> + <listitem> + <para> + Click on the down arrow at the bottom of the email for the desired + attachment. + </para> + </listitem> + <listitem> + <para> + Select <guibutton>Save to Disk</guibutton>. + </para> + </listitem> + <listitem> + <para> + Choose the directory and filename you wish. + </para> + </listitem> + <listitem> + <para> + Click <guibutton>OK</guibutton> + </para> + </listitem> + </orderedlist> + </para> + <tip> + <para> + To automatically view an attachment inline, press the arrow button next + to the attachment. + </para> + </tip> + <para> + To Open an Attachment in a Program: + <orderedlist numeration="arabic"> + <listitem> + <para> + Open up the desired email + </para> + </listitem> + <listitem> + <para> + Click the down arrow at the bottom of the email for the desired + attachment. + </para> + </listitem> + <listitem> + <para> + Click <guibutton>Open in Program</guibutton> where program is the + program that is assigned to open that file type. + </para> + </listitem> + </orderedlist> + </para> + + + <!-- Right-click on the icon to get a + list of options which will vary depending on the type of + attachment. You will have the option to display most files + as part of the message, export them to a different + application (images to Eye of GNOME, spreadsheets to + Gnumeric, and so forth), or save them to disk. + </para> + --> <para> <application>Evolution</application> can also display HTML-formatted mail, complete with graphics. HTML @@ -283,14 +408,14 @@ <!-- Check the alignment of the following paragraph in the PS and HTML output: it's indented for no good reason - Kevin Breit: I dont see a problem with it. ---> + Kevin Breit: I dont see a problem with the HTML. + --> <para> - Enter an address in the <guilabel>To:</guilabel> field, a - subject in the <guilabel>Subject:</guilabel> and a message in - the big empty box at the bottom of the window, and press - <guibutton>Send</guibutton>. - </para> + Enter an address in the <guilabel>To:</guilabel> field. If you wish + enter a subject in the <guilabel>Subject:</guilabel> and a message in + the big empty box at the bottom of the window. Once you have revised + your message, press <guibutton>Send</guibutton>. + </para> <sect2 id="usage-mail-getnsend-send-delay"> <title>Saving Messages for Later</title> @@ -312,44 +437,57 @@ filter behavior, see <xref linkend="config-prefs-mail">. </para> - <para> - You can also choose to save messages as drafts or as text - files. Choose - <menuchoice> - <guimenu>File</guimenu> - <guimenuitem>Save</guimenuitem> + <para> + You can also choose to save messages as drafts or as text + files. Choose + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Save</guimenuitem> </menuchoice> - or <guimenuitem>Save As</guimenuitem> to save your message - as a text file. If you prefer to keep your message in a - folder (the <guilabel>Drafts</guilabel> folder would be the - obvious place), you can select <menuchoice> + or <guimenuitem>Save As</guimenuitem> to save your message + as a text file. If you prefer to keep your message in a + folder (the <guilabel>Drafts</guilabel> folder would be the + obvious place), you can select <menuchoice> <guimenu>File</guimenu> <guimenuitem>Save In - Folder</guimenuitem> </menuchoice>. - </para> - </sect2> - <sect2 id="usage-mail-getnsend-send-compose"> - <title>Advanced Mail Composition</title> - <para> - You can probably guess the purpose of the buttons labelled - <guibutton>Cut</guibutton>, <guibutton>Copy</guibutton>, - <guibutton>Paste</guibutton>, <guibutton>Undo</guibutton> - and <guibutton>Redo</guibutton>, but there's a bit more to - sending mail that's less obvious. In the next few sections, - you'll see how <application>Evolution</application> handles - additional features, including large recipient lists, - attachments, and forwarding. - </para> + Folder</guimenuitem> </menuchoice>. + </para> + </sect2> + + <sect2 id="usage-mail-getnsend-send-compose"> + <title>Advanced Mail Composition</title> + <para> + <application>Evolution</application> is meant to not only handle large + amounts of incoming mail, but helps you manage all the tasks of having + an email account. + In the next few sections, you'll see how + <application>Evolution</application> handles additional features, + including large recipient lists, attachments, and forwarding. + </para> <sect3 id="usage-mail-getnsend-send-attach"> <title>Attachments</title> <para> - If you want to attach a file to your email message, you - can drag it from your desktop into the message window, or - click the button in the toolbar with a paper clip on it, - labelled <guibutton>Attach</guibutton>. If you click the - <guibutton>Attach</guibutton> button, - <application>Evolution</application> will open a file - selection dialog box to ask you which file you want to - send. Select the file and click <guilabel>OK</guilabel>. + To attach a file to your email: + <orderedlist numeration="arabic"> + <listitem> + <para> + Push the attach button in the composer toolbar + </para> + </listitem> + <listitem> + <para> + Select the file you want to attach + </para> + </listitem> + <listitem> + <para> + Press <guibutton>OK</guibutton> + </para> + </listitem> + </orderedlist> + </para> + <para> + You can drag a file from your desktop into the composer window to + attach it as well. </para> <para> To hide the display of files you've attached to the @@ -371,11 +509,12 @@ addressbook, or never load images. </para> </sect3> + <sect3 id="usage-mail-getnsend-send-to-types"> - <title>Types of Recipients</title> + <title>Types of Recipients</title> <para> - <application>Evolution</application>, like most email - programs recognizes three types of addressee: primary + <application>Evolution</application>, like most email + programs recognizes three types of addressee: primary recipients, secondary recipients, and hidden ("blind") recipients. </para> @@ -429,7 +568,7 @@ <sect3 id="usage-mail-getnsend-send-to"> <title>Choosing Recipients Quickly</title> <para> -f you have created address cards in the contact manager, + If you have created address cards in the contact manager, you can also enter nicknames or other portions of address data, and <application>Evolution</application> will transparently complete @@ -446,7 +585,7 @@ f you have created address cards in the contact manager, Alternately, you can click on the <guibutton>To:</guibutton>, <guibutton>Cc:</guibutton>, or <guibutton>Bcc:</guibutton> buttons to get a list — - potentially a very long one — of the email addresses + a potentially a very long one — of the email addresses in your contact manager. Select addresses and click on the arrows to move them into the appropriate address columns. @@ -543,7 +682,7 @@ with quoted materials and the relevant replies interspersed--> <sect2 id="usage-mail-getnsend-send-find"> <title>Searching and Replacing with the Composer</title> <para> - You're probably familiar with search and replace features, + You maybe familiar with search and replace features, and if you come from a Linux or Unix background, you probably know what <guimenuitem>Find Regex</guimenuitem> does. If you aren't among the lucky who already know, @@ -588,6 +727,7 @@ with quoted materials and the relevant replies interspersed--> </variablelist> </para> + <para> For all of these menu items, you can choose whether or not to <guilabel>Search Backwards</guilabel> in the document @@ -598,6 +738,7 @@ with quoted materials and the relevant replies interspersed--> a match. </para> </sect2> + <sect2 id="usage-mail-getnsend-send-html"> <title>Embellish your email with HTML</title> <para> @@ -650,44 +791,44 @@ with quoted materials and the relevant replies interspersed--> or <guilabel>Header 1</guilabel> through <guilabel>Header 6</guilabel> for varying sizes of header from large (1) to tiny (6). Other styles - include <guilabel>pre</guilabel>, to use the HTML + include <guilabel>preformat</guilabel>, to use the HTML tag for preformatted blocks of text, and three types of <guilabel>List Item</guilabel> for the highly organized. </para> </listitem> </varlistentry> - <varlistentry> - <term>Text style</term> - <listitem> - <para> - Use these buttons to determine the way your letters - look. If you have text selected, the style will - apply to the selected text. If you do not have text - selected, the style will apply to whatever you type - next. The buttons are: - <itemizedlist mark="none"> - <listitem><para>Push <guibutton>B</guibutton> for bold text</para></listitem> - <listitem><para>Push <guibutton>I</guibutton> for italics</para></listitem> - <listitem><para>Push <guibutton>U</guibutton> to underline</para></listitem> - <listitem><para>Push <guibutton>S</guibutton> for a strikethrough.</para></listitem> - </itemizedlist> - </para> - </listitem> - </varlistentry> - <varlistentry> + <varlistentry> + <term>Text style</term> + <listitem> + <para> + Use these buttons to determine the way your letters + look. If you have text selected, the style will + apply to the selected text. If you do not have text + selected, the style will apply to whatever you type + next. The buttons are: + <itemizedlist mark="none"> + <listitem><para>Push <guibutton>B</guibutton> for bold text</para></listitem> + <listitem><para>Push <guibutton>I</guibutton> for italics</para></listitem> + <listitem><para>Push <guibutton>U</guibutton> to underline</para></listitem> + <listitem><para>Push <guibutton>S</guibutton> for a strikethrough.</para></listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> <term>Alignment</term> - <listitem> - <para> - Located next to the text style buttons, these three - paragraph icons should be familiar to users of most - word processing software. The leftmost button will - make your text aligned to the left, the center - button, centered, and the right hand button, - aligned on the right side. - </para> - </listitem> - </varlistentry> + <listitem> + <para> + Located next to the text style buttons, these three + paragraph icons should be familiar to users of most + word processing software. The leftmost button will + make your text aligned to the left, the center + button, centered, and the right hand button, + aligned on the right side. + </para> + </listitem> + </varlistentry> <varlistentry> <term>Indentation rules</term> @@ -719,79 +860,114 @@ with quoted materials and the relevant replies interspersed--> </variablelist> </para> <para> - There are three tools that you can find only in the - <guimenu>Insert</guimenu> menu. - <variablelist> - <varlistentry> - <term><guimenuitem>Insert Link</guimenuitem>:</term> - <listitem> - <para> - Use this tool to put hyperlinks in your HTML - messages. When you select it, - <application>Evolution</application> will prompt you - for the <guilabel>Text</guilabel> that will appear, - and the <guilabel>Link</guilabel>, where you should - enter the actual web address (URL). If you don't - want special link text, you can just enter the address + The <guimenu>Insert</guimenu> gives you three opinions which let you + spruce up your email to make it more interesting: + <variablelist> + <varlistentry> + <term><guimenuitem>Insert Link</guimenuitem></term> + <listitem> + <para> + Lets you link some text to a website. Use this tool to put hyperlinks in your HTML + messages. 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> - 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> - <varlistentry> - <term><guimenuitem>Insert Rule</guimenuitem>:</term> - <listitem><para> - This will insert a horizontal line, or rule, into your document. - You'll be presented with a dialog box which gives you - the choice of size, percentage of screen, shading, and - alignment; if you leave everything at the default - values you'll get a thin black rule all the way across - the screen.</para></listitem> - </varlistentry> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>Insert Image</guimenuitem></term> + <listitem> + <para> + Lets you put an image alongside text. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guimenuitem>Insert Rule</guimenuitem></term> + <listitem> + <para> + Inserts a horizontal line into the text to help divide two + sections. + </para> + </listitem> + </varlistentry> + </variablelist> + To add a hyperlink to your HTML message: + <orderedlist numeration="arabic"> + <listitem> + <para> + Select the text you want to link from + </para> + </listitem> + <listitem> + <para> + Right click on text and select + <guimenuitem>Link</guimenuitem> + </para> + </listitem> + <listitem> + <para> + Enter the address you wish to link to in the + <guilabel>URL</guilabel> field. + </para> + </listitem> + <listitem> + <para> + Press <guibutton>OK</guibutton>. + </para> + </listitem> + </orderedlist> + </para> + <para> + To add an image to your HTML message: + <orderedlist numeration="arabic"> + <listitem> + <para> + Click + <menuchoice> + <guimenu>Insert</guimenu> + <guimenuitem>Image</guimenuitem> + </menuchoice> + </para> + </listitem> + <listitem> + <para> + Click <guibutton>Browse</guibutton> + </para> + </listitem> + <listitem> + <para> + Select the image you want + </para> + </listitem> + <listitem> + <para> + Press <guibutton>OK</guibutton> + </para> + </listitem> + <listitem> + <para> + Press <guibutton>Insert</guibutton> + </para> + </listitem> + </orderedlist> - </variablelist> - </para> - <note> - <title>A Technical note on HTML Tags</title> - <para> - The composer is a <acronym>WYSIWYG</acronym> - (What You See Is What You Get) - editor for HTML. That means that if you enter HTML - directly into the composer— say, <markup - role="html"><B>Bold Text</B></markup>, the - the composer will assume you meant exactly that string - of characters, and not "make this text bold," as an HTML - composition tool or text editor would. - </para> + </para> + <note> + <title>A Technical note on HTML Tags</title> + <para> + The composer is a <acronym>WYSIWYG</acronym> + (What You See Is What You Get) + editor for HTML. That means that if you enter HTML + directly into the composer— say, + <markup role="html"><B>Bold Text</B></markup>, the + the composer will assume you meant exactly that string + of characters, and not "make this text bold," as an HTML + composition tool or text editor would. + </para> </note> </sect2> - -<!-- Function not implemented, possibly never will be due to security evil. --> -<!-- - <sect3 id="usage-mail-getnsend-send-live"> - <title>Live Documents</title> - <para> - Later versions of <application>Evolution</application> - will allow you to enliven your email with almost any - sort of document, and even with entire - applications. At this point, however, this feature has not - yet been implemented. - </para> - </sect3> ---> - <sect2 id="usage-mail-getnsend-fwd"> <title>Forwarding Mail</title> <para> @@ -828,6 +1004,7 @@ with quoted materials and the relevant replies interspersed--> <guibutton>Send</guibutton>. </para> </sect2> + <sect2 id="usage-mail-getnsend-ettiquette"> <title>Seven Tips for Email Courtesy</title> <para> @@ -892,24 +1069,31 @@ with quoted materials and the relevant replies interspersed--> <para> <application>Evolution</application> lets you handle your IMAP and newsgroup subscriptions with the same tool: the - subscriptions manager. To start using it, choose - <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Manage - Subscriptions</guimenuitem> </menuchoice>. - </para> - <para> - If you have configured any IMAP (mail) or NNTP (news) - servers, you will see them listed in the left half of the - subscription management window. Click on a server to select - it, and you will see the folders or newsgroups available to - you. You can then select individual folders and subscribe to - them, or remove yourself from the subscription list. - </para> - <para> - Once you have subscribed to a folder or newsgroup, your system - will check for new messages whenever you press the - <guibutton>Get Mail</guibutton> button. - </para> -</sect1> + subscriptions manager. + + <orderedlist numeration="arabic"> + <listitem> + <para> + Click on the folder you wish to subscribe to in the + <guilabel>Store</guilabel> section. + </para> + </listitem> + <listitem> + <para> + Click the <guibutton>Subscribe</guibutton> to add it to the + subscribed list. + </para> + </listitem> + <listitem> + <para> + Close the window. + </para> + </listitem> + + </orderedlist> + </para> + + </sect1> <sect1 id="encryption"> diff --git a/help/ChangeLog b/help/ChangeLog index 7caf5ae499..ac79ab4be3 100644 --- a/help/ChangeLog +++ b/help/ChangeLog @@ -1,3 +1,10 @@ +2001-07-03 Kevin Breit <battery841@mediaone.net> + + * C/usage-mail.sgml: Put in lots of orderedlists...more SGML, less + for the user to read. They'll thank me in droves later. + + * C/usage-exec-summary.sgml: Fixed build error + 2001-06-29 Jeffrey Stedfast <fejj@ximian.com> * white-papers/mail/camel.sgml: Updated slightly. |