diff options
| -rw-r--r-- | help/C/config-prefs.sgml | 526 | ||||
| -rw-r--r-- | help/C/usage-mail.sgml | 54 | ||||
| -rw-r--r-- | help/ChangeLog | 19 |
3 files changed, 338 insertions, 261 deletions
diff --git a/help/C/config-prefs.sgml b/help/C/config-prefs.sgml index 3e51c921ed..48da53b775 100644 --- a/help/C/config-prefs.sgml +++ b/help/C/config-prefs.sgml @@ -35,7 +35,7 @@ <term><guilabel>Display</guilabel></term> <listitem> <para> - Allows you to edit how email is handled and displayed. + Allows you to edit how email appears. </para> </listitem> </varlistentry> @@ -43,7 +43,7 @@ <term><guilabel>Composer</guilabel></term> <listitem> <para> - Customizes the composer's behavior. + Customizes the behavior of the email message composer. </para> </listitem> </varlistentry> @@ -51,8 +51,9 @@ <term><guilabel>Other</guilabel></term> <listitem> <para> - Configures miscellanious aspects of <application>Evolution</application> - such as character sets. + Configures miscellanious aspects of + <application>Evolution</application> such as character + set and encryption tools. </para> </listitem> </varlistentry> @@ -72,319 +73,332 @@ <!-- ==============End of Figure================--> - <sect2 id="config-prefs-mail-identity"> - <title>Identity Settings</title> + <sect2 id="config-prefs-mail-identity"> + <title>Working with the Accounts Tab</title> <para> - If you have only one email account, or send email from only - one address, you will only need to configure one identity. If - you want, however, you can have multiple identities. This - can be useful if you want to keep personal and professional - email separate, or if you wear several hats at work. - + <application>Ximian Evolution</application> allows you to + maintain multiple accounts, or identities. This is useful + want to keep personal and professional email separate, or if + you wear several hats at work. When you are writing an email + message, you can which account to use by selecting from the + drop-down list next to the <guilabel>From</guilabel> entry in + the message composer. </para> + <para> - To add a new identity, simply click - <guibutton>Add</guibutton>. To alter an existing identity, - click on it in the <guilabel>Identity</guilabel> tab of the + Clicking <guibutton>Get Mail</guibutton> will refresh any + IMAP, <systemitem><filename>mh</filename></systemitem>, or + <systemitem><filename>mbox</filename></systemitem> listings + and check and download mail from all POP servers. In other + words, <guibutton>Get Mail</guibutton> gets your mail, no + matter how many sources you have, or what types they are. If + you don't want to check mail for a given account, select it + in the <guilabel>Accounts</guilabel> tab and click the + <guibutton>Disable</guibutton> button. + </para> + + <para> + To add a new account, simply click <guibutton>Add</guibutton> + to open the mail configuration assistant. To alter an + existing identity, select it in the <interface>Preferences</interface> window, and then click - <guibutton>Edit</guibutton>. + <guibutton>Edit</guibutton> to open the account editor + dialog. </para> + <para> + The account editor dialog has six sections: + <variablelist> - <para> - <application>Evolution</application> will then present you - with a dialog box containing four fields: - <itemizedlist> + <varlistentry> + <term>Identity:</term> <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. You can select another if you - wish. + Here, enter the name, + email address, and other identifying information for the + account. </para> </listitem> + </varlistentry> + <varlistentry> + <term>Receiving Mail</term> + <listitem> + <para> + Here, select the way you will be getting mail: you may + download mail from a server (<glossterm + linkend="pop">POP</glossterm> or <glossterm + linkend="imap">IMAP</glossterm>) or access it from files + on your local system. If you use a server, it may permit + or require you to use a Secure Socket Layer (SSL) + connection. To turn SSL connections on, just click the + <guibutton>Use Secure Connection (SSL)</guibutton> + button. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Receiving Options</term> <listitem> <para> - <guilabel>Email address:</guilabel> Enter your email - address in this space. + Here, decide whether you'd like to check for mail + automatically, and set other options related to the + behavior of your server. If you use POP mail, you can + decide whether to leave mail on the server, and if you + use IMAP, you can set folder subscription options here. </para> </listitem> + </varlistentry> + <varlistentry> + <term>Sending Mail</term> <listitem> <para> - <guilabel>Organization:</guilabel> If you send email as - a representative of a company or other organization, - enter its name here. + In this section, you will choose and configure a method + for sending mail. You may choose <glossterm + linkend="smtp">SMTP</glossterm> or <glossterm + linkend="sendmail">sendmail</glossterm>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Special Folders</term> + <listitem> + <para> + Here, you can decide where this account will store the + messages that it has sent, and the messages that you + save as drafts. </para> </listitem> + </varlistentry> + <varlistentry> + <term>Security</term> <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. - It's good form to keep it to four lines at the maximum. + In this section, you will set the security options for + this account. Enter your PGP Key ID and decide how + frequently to encrypt and sign your messages. </para> </listitem> - </itemizedlist> + </varlistentry> + </variablelist> </para> </sect2> - <sect2 id="config-prefs-mail-network"> - <title>Network Settings</title> + <sect2 id="config-prefs-mail-display"> + <title>Mail Display Options</title> <para> - In order to send mail with - <application>Evolution</application>, you need to connect to - your network. To do that, you'll need to know your user name - and password, what sort of mail sending and receiving - protocols your network uses, and the names of the servers - you'll be using. If you're switching from another groupware - or email program, you can almost certainly use the same - settings as you did with that program. Network-related - settings are in the <guilabel>Mail Sources</guilabel> and - <guilabel>Mail Transport</guilabel> tabs. + In this tab you can decide how you would like + <application>Ximian Evolution</application> to display your + mail: how to display citations, how long to wait before + marking a message as read, and so forth. </para> - - <sect3 id="config-prefs-network-sources"> - <title>Mail Sources</title> - <para> - The <interface>Mail Sources</interface> tab allows you to - add, edit, or delete methods of retrieving mail from - servers. Clicking on <guibutton>Add</guibutton> or - <guibutton>Edit</guibutton> will bring up a dialog box to - offer you the following options: - <variablelist> - <varlistentry> - <term><guilabel>Mail source type:</guilabel></term> - <listitem> - <para> - Select from <glossterm - linkend="imap">IMAP</glossterm> or <glossterm - linkend="pop">POP</glossterm> servers, or Unix-style - <systemitem><filename>mbox</filename></systemitem> - or <systemitem><filename>mh</filename></systemitem> - files. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> <guilabel>Server:</guilabel></term> - <listitem> - <para> - Enter the name of the mail source server in this - field. Your POP server may or may not be the same as your - <glossterm linkend="smtp">SMTP</glossterm> server. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><guilabel>Username:</guilabel></term> - <listitem> - <para> - Enter the user name for the account you have on the - server - this should the part of your email address - before the @. If you use - <systemitem><filename>mbox</filename></systemitem> - or <systemitem><filename>mh</filename></systemitem> - files as your mail source, you do not need to enter - a username. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><guilabel>Authentication:</guilabel></term> - <listitem> - <para> - Tell <application>Evolution</application> how to - verify your identity with the server. Your options - vary depending upon the type of server you are - using, and the ways it is configured. Given the - name of a server, - <application>Evolution</application> can detect what - sorts of authentication it offers. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><guilabel>Test Settings</guilabel></term> - <listitem> - <para> - Click this button to have - <application>Evolution</application> check to see if - mail sources are configured correctly. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - <note> - <title>Encrypting Your Transmission</title> - <para> - Some servers require that the connection used to download email is encrypted. <application>Evolution</application> supports encrypting the connection to servers. To enable this, just click <guibutton>Use Secure Connection(SSL)</guibutton> in the Recieving Mail tab of the Account Editor. - </para> - </note> - <para> - If you have several mail sources, clicking <guibutton>Get - Mail</guibutton> will refresh any IMAP, - <systemitem><filename>mh</filename></systemitem>, or - <systemitem><filename>mbox</filename></systemitem> - listings and check and download mail from all POP servers. - In other words, <guibutton>Get Mail</guibutton> gets your - mail, no matter how many sources you have, or what types - they are. You can disable checking mail on accounts in their - properties. - </para> - <tip> - <title>Sharing Mailboxes with Other Mail Programs</title> + <para> + This is also where you can decide how you would like + <application>Ximian Evolution</application> to handle inline + images in HTML mail that you get. There is a detailed + discussion of the issues surrounding these options in <xref + linkend="usage-mail-getnsend-get-attach-html">. + </para> + <para> + To hange the font which <application>Ximian + Evolution</application> uses to display mail, do the + following: + <orderedlist numeration="arabic"> + <listitem> <para> - If you want to use <application>Evolution</application> - and another email client, such as - <application>Mutt</application>, at the same time, - here's how: - <orderedlist numeration="arabic"> - <listitem> - <para> - Download your mail in the other application as - you would normally. - </para> - </listitem> - <listitem> - <para> - In <application>Evolution</application> - <menuchoice><guimenu>Tools</guimenu><guimenuitem>Mail - Settings</guimenuitem></menuchoice>, and pick the account - you'd like to use to share mail. You may want to - create a new account just for this source of - mail. - </para> - </listitem> - <listitem> - <para> - Under the <guilabel>Receiving Mail</guilabel> - tab, select the type of mail file that your - other mail application uses, and then enter the - full path to that file. - </para> - </listitem> - <listitem> - <para> - Click the <guibutton>OK</guibutton> button. - </para> - </listitem> - </orderedlist> + Open the Control Center by selecting <menuchoice> + <guimenu>System</guimenu> + <guimenuitem>Settings</guimenuitem> </menuchoice> from + the menu panel. + </para> + </listitem> + <listitem> + <para> + Select the HTML Viewer settings tool. + </para> + </listitem> + <listitem> + <para>Choose the font and font size you would like to use. + </para> + </listitem> + </orderedlist> + + Alternately, open a terminal and run the + <command>gtkhtml-properties-capplet</command> command. This + will open the GNOME HTML Display Properties tool, and you can + select a font and other attributes of your HTML display, + including that in <application>Ximian Evolution</application>. + </para> + </sect2> + + <sect2 id="config-prefs-mail-composer"> + <title>Message Composer Preferences</title> + + <para> + Mercifully, there are only four preferences you can prefer in + the message composer preferences dialog: + <variablelist> + <varlistentry> + <term>Send mail in HTML format by default </term> + <listitem> + <para> + If you would like all email messages that you compose + to begin in HTML format, leave this box checked. You + can convert messages between HTML and plain text by + selecting the <menuchoice> <guimenu>Format</guimenu> + <guimenuitem>HTML</guimenuitem> </menuchoice> toggle + in the message composer. </para> - </tip> - </sect3> + </listitem> + </varlistentry> - <sect3 id="config-prefs-mail-network-transports"> - <title>Mail Transports</title> - <para> - The <interface>Mail Transports</interface> tab lets you choose - how you will send mail. <application>Evolution</application> currently supports two - mail transport options: <glossterm linkend="smtp">SMTP</glossterm>, which - uses a remote mail server, and - <glossterm linkend="sendmail">sendmail</glossterm>, which uses the - <application>sendmail</application> program on your local - system. <application>Sendmail</application> is more - difficult to configure, but offers more flexibility than - <glossterm>SMTP</glossterm>. - </para> - <para> - To use <guilabel>SMTP</guilabel>, you'll need to enter the - name of your SMTP server. It may have the same name as - your mail source server. - </para> - <para> - <application>Evolution</application> can attempt to - determine if you have entered a valid server name. To - have it do so, click the <guilabel>Test - Settings</guilabel> button. - </para> - </sect3> - </sect2> + <varlistentry> + <term>Default Forward style</term> + <listitem> + <para> + Select from: + <simplelist> + <member><guilabel>Attachment:</guilabel> the + message you forward appended to the message you send + as a seperate file.</member> + + <member> <guilabel>Inline:</guilabel> The message + you forward is included at the end of the message + you send.</member> + + <member> + <guilabel>Quoted:</guilabel> The message + you forward is included at the end of the message + you send, and a greater-than symbol (>) is + inserted at the beginning of each line to + indicate that it is quoted. + </member> + </simplelist> + </para> + </listitem> + </varlistentry> -<!-- NOT FOR 1.0, see usage-mail.sgml - <sect2 id="config-prefs-network-news"> - <title>News Servers</title> - <para> - Newsgroups are so much like mailing lists that there's no - reason not to keep them right next to your mail. When you - first select the <guilabel>News Servers</guilabel> tab, - you will see a blank box with the three familiar buttons - on the right: <guibutton>Add</guibutton>, - <guibutton>Edit</guibutton>, and - <guibutton>Delete</guibutton>. - </para> - <para> - Click <guibutton>Add</guibutton> to add a news server; you - will be prompted for its name. Enter the name, click - <guibutton>OK</guibutton>, and you're done. You can have - as many news servers as you like, of course. News servers - will appear next to your IMAP servers in the - <interface>folder bar</interface>. - </para> - </sect2> ---> + <varlistentry> + <term>Prompt when sending messages with an empty subject</term> + <listitem> + <para> + The composer will warn you if you try to send a + message without a subject. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Prompt when sending messages with only Bcc recipients defined</term> + <listitem> + <para> + The composer will warn you if you try to send a + message that has only <guilabel>Bcc</guilabel> + recipients. This is important because some mail + servers will fail to honor blind carbon copy if you + do not have at least one recipient that is visible to + all readers. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> <sect2 id="config-prefs-mail-other"> <title>Other Mail Preferences</title> <para> Not everything fits neatly into categories. This tab - contains some miscellaneous configurations that don't have - too much to do with each other. + contains some miscellaneous configuration options that + didn't fit anywhere else. <variablelist> <varlistentry> <term> - <guilabel>Send messages in HTML format</guilabel> + <guilabel>PGP binary path</guilabel> </term> <listitem> <para> - If you check this box, you will send - messages as HTML by default. If you leave it unchecked, your - messages will be sent without HTML formatting unless you select - <menuchoice> <guimenu>Format</guimenu> <guimenuitem>HTML</guimenuitem> - </menuchoice> in the message composer. - See <xref linkend="usage-mail-getnsend-send-html"> - for more information about HTML mail. + The complete path to your external encryption tool On + most Linux systems, this will be + <systemitem><filename>/usr/bin/gpg</filename></systemitem>. </para> </listitem> </varlistentry> + <varlistentry> <term> - <guilabel>Mark Messages as Read After</guilabel> + <guilabel>Remember PGP Passphrase until Exit</guilabel> </term> <listitem> - <para> - When you click on a message, - <application>Evolution</application> will wait a - moment before marking it as read. You can set the - delay, in milliseconds, here. + <para> Check this box if you want <application>Ximian + Evolution</application> to remember your PGP + passphrase for as long as it is running. You will + still have to enter your passphrase again each time + you start <application>Ximian Evolution</application>. </para> </listitem> </varlistentry> + + <varlistentry> + <term> + <guilabel>Default Character Encoding</guilabel> + </term> + <listitem> <para> Choose a default character encoding for + your messages. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <guilabel>Empty Trash Folders on Exit</guilabel> + </term> + <listitem> <para> If you would like to expunge all deleted + mail when you quit <application>Ximian + Evolution</application>, check this box. + </para> + </listitem> + </varlistentry> + <varlistentry> <term> - <guilabel>Folder Format</guilabel> + <guilabel>Log filter actions to:</guilabel> </term> - <listitem> - <para> - By default, - <application>Evolution</application> saves its mail - in the - <systemitem><filename>mbox</filename></systemitem> - format. You can switch to the - <systemitem><filename>mh</filename></systemitem> - format if you like. Note that this is an advanced - feature and may cause you to lose some messages, so - you should probably make a backup of your - <systemitem><filename>evolution</filename></systemitem> - directory first. In addition, it will take quite - some time if you have a large mailbox. - </para></listitem> + <listitem> <para> If you like, you can have + <application>Ximian Evolution</application> write all + its message filter actions to a log file. Select a log + file here. + </para> + </listitem> </varlistentry> </variablelist> </para> </sect2> </sect1> + +<!-- NOT FOR 1.0, see usage-mail.sgml + <sect1 id="config-prefs-news"> + <title>News Servers</title> + <para> + Newsgroups are so much like mailing lists that there's no + reason not to keep them right next to your mail. When you + first select the <guilabel>News Servers</guilabel> tab, + you will see a blank box with the three familiar buttons + on the right: <guibutton>Add</guibutton>, + <guibutton>Edit</guibutton>, and + <guibutton>Delete</guibutton>. + </para> + <para> + Click <guibutton>Add</guibutton> to add a news server; you + will be prompted for its name. Enter the name, click + <guibutton>OK</guibutton>, and you're done. You can have + as many news servers as you like, of course. News servers + will appear next to your IMAP servers in the + <interface>folder bar</interface>. + </para> + </sect2> +--> + + <sect1 id="config-prefs-cal"> <title>Configuring the Calendar</title> <para> diff --git a/help/C/usage-mail.sgml b/help/C/usage-mail.sgml index 36fe9b39ad..6c2fe30cfd 100644 --- a/help/C/usage-mail.sgml +++ b/help/C/usage-mail.sgml @@ -233,13 +233,57 @@ <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. To learn how to do that, - have a look at <xref linkend="config-prefs-mail-network">, or - ask your system administrator. + If you get an error message instead of mail, you probably need + to check your network settings. To learn how to do that, have + a look at <xref linkend="config-prefs-mail">, or ask your + system administrator. </para> </note> + + + <tip> + <title>Sharing Mailboxes with Other Mail Programs</title> + <para> + If you want to use <application>Evolution</application> + and another email client, such as + <application>Mutt</application>, at the same time, + here's how: + <orderedlist numeration="arabic"> + <listitem> + <para> + Download your mail in the other application as + you would normally. + </para> + </listitem> + <listitem> + <para> + In <application>Evolution</application> + <menuchoice><guimenu>Tools</guimenu><guimenuitem>Mail + Settings</guimenuitem></menuchoice>, and pick the account + you'd like to use to share mail. You may want to + create a new account just for this source of + mail. + </para> + </listitem> + <listitem> + <para> + Under the <guilabel>Receiving Mail</guilabel> + tab, select the type of mail file that your + other mail application uses, and then enter the + full path to that file. + </para> + </listitem> + <listitem> + <para> + Click the <guibutton>OK</guibutton> button. + </para> + </listitem> + </orderedlist> + </para> + </tip> + + <!-- NOT FOR 1.0 <sect2 id="usage-mail-getnsend-get-news"> <title>Using Evolution for News</title> @@ -323,7 +367,7 @@ </sect3> <sect3 id="usage-mail-getnsend-get-attach-html"> - <title>Images in HTML Mail</title> + <title>Inline Images in HTML Mail</title> <para> When someone sends you HTML mail that includes an image in the body of the message— like the welcome message in diff --git a/help/ChangeLog b/help/ChangeLog index 3c2a0a8eba..9e0378c577 100644 --- a/help/ChangeLog +++ b/help/ChangeLog @@ -1,3 +1,22 @@ +2001-09-15 Aaron Weber <aaron@ximian.com> + + * C/usage-mail.sgml: linked to a now-obsolete section. changed link. + + * C/config-prefs.sgml: Man, this needed so much more than style + revision-- the whole mail section had to be redone. Yech. + + * C/usage-mail.sgml: moved "sharing mail" tip from config-prefs. + + * C/config-prefs.sgml: style. + +2001-09-13 Aaron Weber <aaron@ximian.com> + + * C/usage-calendar.sgml: Add more info on tasks features. + +2001-09-11 Aaron Weber <aaron@ximian.com> + + * C/evolution.sgml: Validation issues. + 2001-09-10 Aaron Weber <aaron@ximian.com> * C/usage-contact.sgml: Contact lists. |