diff options
author | Aaron Weber <aaron@src.gnome.org> | 2002-02-16 04:34:06 +0800 |
---|---|---|
committer | Aaron Weber <aaron@src.gnome.org> | 2002-02-16 04:34:06 +0800 |
commit | d33ffacc7075e91aaea8ecf1bc403db42d45c4a9 (patch) | |
tree | eba495bb7c99e2d9e1e7380d712da878e5edefd8 /help/C | |
parent | f0490ebb1bd363cd925711fed56e774065d5263b (diff) | |
download | gsoc2013-evolution-d33ffacc7075e91aaea8ecf1bc403db42d45c4a9.tar gsoc2013-evolution-d33ffacc7075e91aaea8ecf1bc403db42d45c4a9.tar.gz gsoc2013-evolution-d33ffacc7075e91aaea8ecf1bc403db42d45c4a9.tar.bz2 gsoc2013-evolution-d33ffacc7075e91aaea8ecf1bc403db42d45c4a9.tar.lz gsoc2013-evolution-d33ffacc7075e91aaea8ecf1bc403db42d45c4a9.tar.xz gsoc2013-evolution-d33ffacc7075e91aaea8ecf1bc403db42d45c4a9.tar.zst gsoc2013-evolution-d33ffacc7075e91aaea8ecf1bc403db42d45c4a9.zip |
Somehow accidentally removed all these files. Don't know what that was. :(
svn path=/trunk/; revision=15744
Diffstat (limited to 'help/C')
-rw-r--r-- | help/C/apx-authors.sgml | 71 | ||||
-rw-r--r-- | help/C/apx-bugs.sgml | 39 | ||||
-rw-r--r-- | help/C/apx-gloss.sgml | 470 | ||||
-rw-r--r-- | help/C/config-prefs.sgml | 925 | ||||
-rw-r--r-- | help/C/config-sync.sgml | 133 | ||||
-rw-r--r-- | help/C/evolution-faq.sgml | 973 | ||||
-rw-r--r-- | help/C/evolution.sgml | 126 | ||||
-rw-r--r-- | help/C/menuref.sgml | 421 | ||||
-rw-r--r-- | help/C/preface.sgml | 83 | ||||
-rw-r--r-- | help/C/usage-calendar.sgml | 710 | ||||
-rw-r--r-- | help/C/usage-contact.sgml | 617 | ||||
-rw-r--r-- | help/C/usage-exchange.sgml | 710 | ||||
-rw-r--r-- | help/C/usage-mail-org.sgml | 30 | ||||
-rw-r--r-- | help/C/usage-mainwindow.sgml | 43 | ||||
-rw-r--r-- | help/C/usage-notes.sgml | 49 | ||||
-rw-r--r-- | help/C/usage-print.sgml | 115 | ||||
-rw-r--r-- | help/C/usage-sync.sgml | 39 |
17 files changed, 5530 insertions, 24 deletions
diff --git a/help/C/apx-authors.sgml b/help/C/apx-authors.sgml new file mode 100644 index 0000000000..9a0e3d2f42 --- /dev/null +++ b/help/C/apx-authors.sgml @@ -0,0 +1,71 @@ + <appendix id="authors"> + <title>Authors</title> + <para> + <application>Evolution</application> was written by the Ximian + Evolution team and numerous other dedicated GNOME programmers. + You can see their names by selecting <menuchoice> + <guimenu>Help</guimenu> <guimenuitem>About</guimenuitem> + </menuchoice> from any Evolution window. + </para> + <para> + The <application>Evolution</application> code owes a great debt + to the <application>GNOME-pim</application> and + <application>GNOME-Calendar</application> applications, and to + <application>KHTMLW</application>. The developers of + <application>Evolution</application> acknowledge the efforts + and contributions of all who worked on those projects. + </para> + + <para> + Ximian would like to thank Miles Lane for his contributions in + quality assurance, and the staff of the El Pelon Taqueria, on + Peterborough St. in Boston, for sustenance. + </para> + + <para> + For more information please visit the + <application>Evolution</application> <ulink + url="http://www.ximian.com/products/ximian_evolution/" + type="http">Web page</ulink>. Please send all comments, + suggestions, and bug reports to the <ulink + url="http://bugzilla.ximian.com" type="http">Ximian bug tracking + database</ulink>. Instructions for submitting bug reports can be + found on-line at the same location. You can also use the GNOME + bug report tool, <command>bug-buddy,</command> to submit your + defect reports. + </para> + <para> + This manual was written by Aaron Weber + (<email>aaron@ximian.com</email>), Kevin Breit + (<email>mrproper@ximian.com</email>) Duncan Mak + (<email>duncan@ximian.com</email>) and Ettore Perazzoli + (<email>ettore@ximian.com</email>) with the help of the + application programmers and the GNOME Documentation Project. + Please file comments and suggestions for this manual as bugs in + the Ximian bug tracking system. If you contributed to this + project but do not see your name here, please contact Aaron + Weber (<email>aaron@ximian.com</email>) and he'll list you. + </para> + <para> + Partial list of Translators: + <itemizedlist> + <listitem><para> + Daniel Persson for .se + </para></listitem> + + <listitem><para> + Hector Garcia Alvarez for .es + </para></listitem> + + <listitem><para> + Kjartan Maraas for .no + </para></listitem> + </itemizedlist> + + </para> + </appendix> + + + + + diff --git a/help/C/apx-bugs.sgml b/help/C/apx-bugs.sgml new file mode 100644 index 0000000000..7de959dda8 --- /dev/null +++ b/help/C/apx-bugs.sgml @@ -0,0 +1,39 @@ + <appendix id="bugs"> + + <title>Known bugs and limitations</title> + <abstract> + <para> + Ximian Evolution bug tracking is done at the <ulink + url="http://bugzilla.ximian.com">Ximian bug tracking + System</ulink>. You may use that, or the GNOME <application>Bug + Report Tool</application> (known as <command>bug-buddy</command> + at the command line) if you find bugs or would like to request new + features. + </para> + <para> + If you need additional help with Ximian Evolution, please visit + the Ximian support site at <ulink + url="http://support.ximian.com">ximian.com/support</ulink>. + </para> + </abstract> + + <para> + A number of often-requested features will not make it into + Ximian Evolution 1.0, but we plan to include them for version + 1.1. Some of them are: + <simplelist> + <member>Direct import of Microsoft Outlook contact cards</member> + <member>Synchronization of email with handheld devices</member> + <member>S/MIME support</member> + <member>Read foreign mail folders without importing them</member> + <member>Import of WINMAIL.DAT attachments</member> + <member>Playing a sound to indicate new mail arriving</member> + </simplelist> + </para> + <para> + A more complete list of feature requests and other issues with + Evolution is available online in the Ximian bug tracking system. + </para> + +</appendix> + diff --git a/help/C/apx-gloss.sgml b/help/C/apx-gloss.sgml new file mode 100644 index 0000000000..380f9e38be --- /dev/null +++ b/help/C/apx-gloss.sgml @@ -0,0 +1,470 @@ +<glossary id="apx-gloss"> + + <title>Glossary</title> + + <glossentry id="assistant"> + <glossterm>Assistant:</glossterm> + <glossdef> + <para> + See druid + </para> + </glossdef> + </glossentry> + + <glossentry id="attachment"> + <glossterm>Attachment:</glossterm> + <glossdef> + <para> + Any file sent along with an email. Attachments may be embedded in + a message or appended to it. + </para> + </glossdef> + </glossentry> + +<glossentry id="automatic-indexing"> + <glossterm>Automatic Indexing:</glossterm> + <glossdef> + <para> + Pre-fetching procedure that allows + <application>Evolution</application> to refer to data quickly. + It enables faster searches and decreases memory usage for + data displays. + </para> + </glossdef> + </glossentry> + + <glossentry id="bcc"> + <glossterm>Bcc (Blind Carbon Copy):</glossterm> + <glossdef> + <para> + A way of addressing a message. Bcc is used to send a group of + people an e-mail, while hiding their names and addresses from each + other. + </para> + </glossdef> + </glossentry> + + <glossentry id="cc"> + <glossterm>Cc (Carbon Copy):</glossterm> + <glossdef> + <para> + Carbon-copies are used to send a 3rd party a copy of the e-mail, + so they an keep up to date on a conversation, without being in the + To: list. + </para> + </glossdef> + </glossentry> + + <glossentry id="conduit"> + <glossterm>Conduit:</glossterm> + <glossdef> + <para> + A small application which controls + the transfer of data between a handheld device and a desktop + computer. + </para> + </glossdef> + </glossentry> + + + <glossentry id="druid"> + <glossterm>Druid:</glossterm> + <glossdef> + <para> + A tool which guides a user through a series of steps, usually to + configure or set up a program. Equivalent to "Assistant" and + "Wizard." + </para> + </glossdef> + </glossentry> + + <glossentry id="evolution"> + <glossterm>Evolution:</glossterm> + <glossdef> + <para> + <application>Evolution</application> is the <acronym> GNOME + </acronym> groupware application. + </para> + </glossdef> + </glossentry> + + <glossentry id="execute"> + <glossterm>Execute:</glossterm> + <glossdef> + <para> + To run a program. Any file that can be run is called an + executable. <application>Evolution</application> can download + executable attachments, but before they can be run, the files must + be marked as executable with a shell or file manager. This + security precaution prevents the automatic or accidental execution + of malicious programs. For more information on executables and file + permissions, see the documentation for your file manager or shell. + </para> + </glossdef> + </glossentry> + + <glossentry id="expunge"> + <glossterm>Expunge:</glossterm> + <glossdef> + <para> + When messages are marked for deletion, they remain till they are expunged. + When a message is expunged, it is permanently deleted, as long as it was + marked for deletion. + </para> + </glossdef> + </glossentry> + + <glossentry id="filetree"> + <glossterm>File Tree:</glossterm> + <glossdef> + <para> + A way of describing a group of files on a computer. With the + perversity typical of computer (and especially Unix and Linux) + nomenclature, the top of the tree is called the root directory, + and denoted by <filename>/</filename>. + The rest of the "branches" spread downwards from the root. Don't + confuse the root directory with the root + account, or root's home directory, normally + <filename>/root</filename>. + </para> + </glossdef> + </glossentry> + + <glossentry id="filter"> + <glossterm>Filter:</glossterm> + <glossdef> + <para> + Within <application>Evolution</application>, a filter is a method + of sorting mail automatically when it's downloaded. You can create filters to perform + one or more actions on a message that meets any (or all) of a wide + range of criteria. + </para> + </glossdef> + </glossentry> + + <glossentry id="forward"> + <glossterm>Forward:</glossterm> + <glossdef> + <para> + If you get a message intended for someone else, you can use + message forwarding to send it on to the right person. + </para> + </glossdef> + </glossentry> + + <glossentry id="groupware"> + <glossterm>Groupware:</glossterm> + <glossdef> + <para> + Groupware is a term describing an application which helps groups + of people work together. Typically, a groupware application will + have several productivity features built into one program, + including: email, calendar, and addressbook tools. + </para> + </glossdef> + </glossentry> + + <glossentry id="html"> + <glossterm>HTML:</glossterm> + <glossdef> + <para> + Hyper-text Markup Language (<acronym>HTML</acronym>) is a language + for describing page layout in electronic documents like web pages, + help files, and email messages. HTML can be used in email and + news posts to insert images and apply text treatments. + </para> + </glossdef> + </glossentry> + + <glossentry id="hot-key"> + <glossterm>Hot Key:</glossterm> + <glossdef> + <para> + Hot-keys are keyboard combinations used to do actions on a + computer instead of using the mouse. + Hot-keys can speed up computer usage. + </para> + </glossdef> + </glossentry> + + <glossentry id="ical"> + <glossterm>iCal:</glossterm> + <glossdef> + <para> + <application>iCal</application> is the program which + <application>Evolution</application> uses to manage the calendar + section. + </para> + </glossdef> + </glossentry> + + <glossentry id="imap"> + <glossterm>IMAP:</glossterm> + <glossdef> + <para> + Depending upon whom you ask, IMAP stands for the Internet Mail + Access Protocol, or the Interim Mail Access Protocol. It allows access to email which is typically (although + not always) stored remotely on a server rather than on a local + hard disk. Often contrasted with <glossterm>POP:</glossterm>. + This will not be on the test. + </para> + </glossdef> + </glossentry> + + + <glossentry id="inline"> + <glossterm>Inline:</glossterm> + <glossdef> + <para> + Displayed as part of a message or other document, rather than + attached as a separate file. Contrast with <glossterm + linkend="attachment">Attachment:</glossterm>. + </para> + </glossdef> + </glossentry> + + <glossentry id="ldap"> + <glossterm>LDAP:</glossterm> + <glossdef> + <para> + LDAP, the Lightweight Directory Access Protocol, allows a client + to search through a large database of addresses, phone numbers, + and people stored on a server. + </para> + </glossdef> + </glossentry> + + <glossentry id="mail-client"> + <glossterm>Mail Client:</glossterm> + <glossdef> + <para> + A mail client is the application with which a person reads and + sends e-mail. Its counterparts are the various types of mail + servers, which handle user authentication and direct messages from + sender to recipient. + </para> + </glossdef> + </glossentry> + + + <glossentry id="minicard"> + <glossterm>Minicard:</glossterm> + <glossdef> + <para> + A format for the display of contact data. Similar in appearance + to a small business card. + </para> + </glossdef> + </glossentry> + + <glossentry id="nautilus"> + <glossterm>Nautilus:</glossterm> + <glossdef> + <para> + <application>Nautilus</application> is the next generation file + manager for <acronym>GNOME</acronym>. + </para> + </glossdef> + </glossentry> + + <glossentry id="pop"> + <glossterm>POP:</glossterm> + <glossdef> + <para> + POP, the Post Office Protocol, is a mechanism for email + transport. In contrast to IMAP, it is used only to get mail from + a server and store it locally on your hard disk. + </para> + </glossdef> + </glossentry> + + <glossentry id="protocol"> + <glossterm>Protocol:</glossterm> + <glossdef> + <para> + An agreed-upon method of communication, especially one for + sending particular types of information between computer systems. + Examples include POP (Post Office Protocol), for email, and HTTP + (HypterText Transfer Protocol), for web pages. + </para> + </glossdef> + </glossentry> + + <glossentry id="public-key-encryption"> + <glossterm>Public Key Encryption:</glossterm> + <glossdef> + <para> + A strong encryption method that uses a set of two "keys," one of + which is made public, and one of which is kept private. Data + encrypted using the public key can only be decrypted using the + private key. The longer the keys, the more difficult it is to + break the encryption. + </para> + </glossdef> + </glossentry> + + + + <glossentry id="regular-expression"> + <glossterm>Regular Expression:</glossterm> + <glossdef> + <para> + A regular expression, or "regex", is a way of describing a + string of text using metacharacters or wild-card symbols. For + example, the statement <userinput>fly.*so[au]p</userinput> means + "any phrase beginning with 'fly' and ending in 'soup' or + 'soap'". If you searched for that expression, you'd find both + "fly in my soup" and "fly in my soap." There's not room here to + go into depth, but if you want, have a look at the documentation + for the <command>grep</command> command by opening a command + line and typing in <command>man grep</command>. + </para> + </glossdef> + </glossentry> + + <glossentry id="script"> + <glossterm>Script:</glossterm> + <glossdef> + <para> + A program written in an interpreted (rather than compiled) + language. Often used as a synonym for "macro," to denote a series + of pre-recorded commands or actions within an application. Often + times, accomplish repetitive and tedious tasks, to save the + user time. + </para> + </glossdef> + </glossentry> + + <glossentry id="search-base"> + <glossterm>Search Base:</glossterm> + <glossdef> + <para> + LDAP can break contact lists into many groups. The Search + Base tells LDAP the top group to use. How much of the Search + Base that is searched is set by the <glossterm + linkend="search-scope">Search Scope</glossterm> option. + </para> + </glossdef> + </glossentry> + + <glossentry id="search-scope"> + <glossterm>Search Scope:</glossterm> + <glossdef> + <para> + Search Scope states how much of the <glossterm + linkend="search-base">Search Base</glossterm> to search. + </para> + </glossdef> + </glossentry> + + <glossentry id="sendmail"> + <glossterm>Sendmail:</glossterm> + <glossdef> + <para> + As its name implies, <application>sendmail</application> is a + program which sends mail. <application>Evolution</application> + can use it instead of <glossterm>SMTP:</glossterm>; some people + prefer it because it offers more flexibility, but is more + difficult to set up. + </para> + </glossdef> + </glossentry> + + + <glossentry id="shortcut-bar"> + <glossterm>Shortcut Bar:</glossterm> + <glossdef> + <para> + A portion of <application>Evolution</application> which offers + users fast access to the most frequently used portions of the + application. + </para> + </glossdef> + </glossentry> + + <glossentry id="signature"> + <glossterm>Signature:</glossterm> + <glossdef> + <para> + In email terms, a signature is a piece of text placed at the end + of every email sent, similar to a hand-written signature at the bottom + of a written letter. A signature can be anything from a favorite + quotation to a link to a web page; courtesy dictates that it be + fewer than four lines long. + </para> + </glossdef> + </glossentry> + + <glossentry id="SMTP"> + <glossterm>SMTP:</glossterm> + <glossdef> + <para> + This is the most common way of transporting mail messages from + the client's computer (you) to the server. SMTP stands for + Simple Mail Transfer Protocol. + </para> + </glossdef> + </glossentry> + + <glossentry id="tooltip"> + <glossterm>Tool-Tip:</glossterm> + <glossdef> + <para> + A small box of explanatory text which appears when the mouse + pointer is held motionless over a button or other interface + element. + </para> + </glossdef> + </glossentry> + + <glossentry id="virus"> + <glossterm>Virus:</glossterm> + <glossdef> + <para> + A program which inserts itself into other files or programs and + which, when executed, spreads to more programs and other + computers. A virus can cause substantial damage by clogging + networks or disk drives, deleting files, or opening security + holes. + </para> + </glossdef> + </glossentry> + + <glossentry id="vcard"> + <glossterm>vCard:</glossterm> + <glossdef> + <para> + A file format for the exchange of contact information. When you + get an address card attached to an email, it's probably in vCard + format. Not to be confused with <glossterm + linkend="vfolder">vFolder:</glossterm>. + </para> + </glossdef> + </glossentry> + + <glossentry id="vfolder"> + <glossterm>vFolder:</glossterm> + <glossdef> + <para> + An email organization tool. vFolders allows you to create a folder + that contains the results of a complex search. vFolder contents are + are updated dynamically. + </para> + </glossdef> + </glossentry> + +</glossary> + + + + + + + + + + + + + + diff --git a/help/C/config-prefs.sgml b/help/C/config-prefs.sgml new file mode 100644 index 0000000000..15c9bf15a1 --- /dev/null +++ b/help/C/config-prefs.sgml @@ -0,0 +1,925 @@ +<!-- +<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> +--> +<chapter id="config-prefs"> + + <title>Advanced Configuration</title> + <para> + Perhaps your mail server has changed names. Perhaps you've + grown tired of a certain layout for your appointments. + Whatever the reason, you want to change your + <application>Evolution</application> settings. This chapter + will tell you how to do just that. + </para> + + <sect1 id="config-prefs-mail"> + <title>Mail Settings</title> + <para> + To change your mail settings, select <menuchoice> + <guimenu>Tools</guimenu> <guimenuitem>Mail + Settings</guimenuitem></menuchoice> in the Inbox. This + will open the <interface>mail preferences window</interface>, + illustrated in <xref linkend="config-prefs-mail-fig">. Mail + preferences are separated into several categories: + <variablelist> + <varlistentry> + <term><guilabel>Accounts</guilabel></term> + <listitem> + <para> + This allows you to create and alter one or more + identities for your email. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Display</guilabel></term> + <listitem> + <para> + Allows you to edit how email appears. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Composer</guilabel></term> + <listitem> + <para> + Customizes the behavior of the email message composer. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Other</guilabel></term> + <listitem> + <para> + Configures miscellanious aspects of + <application>Evolution</application> such as character + set and encryption tools. + </para> + </listitem> + </varlistentry> + </variablelist> + + </para> + + <!-- ==============Figure===================== --> + <figure id="config-prefs-mail-fig"> + <title>Account Editor Window</title> + <screenshot> + <screeninfo>Account Editor Window</screeninfo> + <mediaobject><imageobject><imagedata fileref="figures/config-mail" format="png" srccredit="Aaron Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> + <!-- ==============End of Figure================--> + + + <sect2 id="config-prefs-mail-identity"> + <title>Working with the Accounts Tab</title> + <para> + <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> + Clicking <guibutton>Get Mail</guibutton> will refresh any + IMAP, <filename>mh</filename>, or + <filename>mbox</filename> 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> to open the account editor + dialog. + </para> + <para> + The account editor dialog has six sections: + <variablelist> + + <varlistentry> + <term>Identity:</term> + <listitem> + <para> + 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>), read and keep it on the + server (Microsoft Exchange or <glossterm + linkend="imap">IMAP</glossterm>), or read it from files + that already exist on your desktop computer. 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. + +<note id="config-arbitrary-port"> +<title>Specifying Port Numbers</title> +<para> +Your system administrator may ask you to connect to a specific port on +a mail server. To specify which port you use, just type a colon and +the port number after the server name. For example, to connect to port +143 on the server smtp.omniport.com, you would enter +as +<userinput> +smtp.omniport.com:143 +</userinput> as the server name. +</para> +</note> + + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Receiving Options</term> + <listitem> + <para> + Here, decide whether you'd like to check for mail + automatically and how often. + + <variablelist> + <varlistentry> + <term>If you chose POP:</term> + <listitem> + <para> + <itemizedlist> + <listitem> + <para>Checking for new mail: If you would + like <application>Evolution</application> + to check for new mail automatically, + check the box and select a frequency in + minutes. + </para> + </listitem> + + <listitem> + <para> + Message Storage: If you'd like to store + copies of your mail on the server, check + this option. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>If you chose Microsoft Exchange:</term> + <listitem> + <para> + + <itemizedlist> <listitem> + <para>Checking for new mail: If you would like + <application>Evolution</application> to check for new mail + automatically, check the box and select a frequency in + minutes. + </para> + </listitem> + + <listitem> + <para>Exchange Server: If your active directory user name + is different from your Exchange mail user name, check this + box and enter your mail username here. + </para> + </listitem> + + <listitem> + <para>Create a Global Address List folder: If you would + like to have a seperate folder for the Active Directory's + Global Address List, leave this box checked. </para> + </listitem> + + <listitem> + <para> + Active Directory Server Name: In most organizations, + the Active Directory server will be different from + the Exchange mail server. If so, check the box and + enter the Active Directory server name here. + </para> + </listitem> + + <listitem> + <para>Limit number of Responses: Select a maximum number + of results for an address search. A maximum number of + results limits the load on your system and on your network. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>If you chose IMAP:</term> + <listitem> + <para> + + <itemizedlist> + <listitem> + <para>Checking for new mail: If you would like + <application>Evolution</application> to check for new mail + automatically, check the box and select a frequency in + minutes. + </para> + </listitem> + + <listitem> + <para>If you want <application>Evolution</application> + to check for new messages in <emphasis>all</emphasis> your + IMAP folders, make sure the <guilabel>Check for new + messages in all folders</guilabel> box is selected.</para> + </listitem> + + <listitem> + <para>Show only subscribed folders: Check this box if you + have more folders in your IMAP view than you want to + read.</para> + </listitem> + + <listitem> + <para> + Override server-supplied namespace: If you like, enter a + specific directory where your server stores mail for + you. Typical values are "mail" and "Mail." For more + information about how to use IMAP mail, see <xref + linkend="usage-mail-subscriptions">.</para> + </listitem> + + <listitem> + <para>Apply filters to new messages in INBOX on this + server: If you'd like your filters to work on this account + as well as on locally downloaded mail, check this box.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + + + </variablelist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Sending Mail</term> + <listitem> + <para> + In this section, you will choose and configure a method + for sending mail. You may choose <glossterm + linkend="smtp">SMTP</glossterm>, Microsoft Exchange (if + you have purchased the Ximian Connector for Microsoft + Exchange) 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> + 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. You can + learn more about PGP and encryption in <xref + linkend="encryption">. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + + <sect2 id="config-prefs-mail-display"> + <title>Mail Display Options</title> + <para> + 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> + <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> + 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> + </listitem> + </varlistentry> + + <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> + + <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 configuration options that + didn't fit anywhere else. + <variablelist> + + <varlistentry> + <term> + <guilabel>PGP binary path</guilabel> + </term> + <listitem> + <para> + The complete path to your external encryption tool On + most Linux systems, this will be + <filename>/usr/bin/gpg</filename>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <guilabel>Remember PGP Passphrase until Exit</guilabel> + </term> + <listitem> + <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>Log filter actions to:</guilabel> + </term> + <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> + To set your calendar preferences, select + <menuchoice><guimenu>Settings</guimenu> + <guimenuitem>Calendar + Settings</guimenuitem></menuchoice> from the Calendar + view. This will open up the + <interface>Preferences</interface> window. It contains four + tabs: <guilabel>General</guilabel>, <guilabel>Display</guilabel>, <guilabel>Task List</guilabel>, and <guilabel>Other</guilabel>. The <interface>calendar + preferences window</interface> is illustrated in <xref + linkend="config-prefs-cal-fig">. + + <!-- ==============Figure===================== --> + <figure id="config-prefs-cal-fig"> + <title>Calendar Preferences Dialog</title> + <screenshot> + <screeninfo>If this worked on my job as well as my calendar...</screeninfo> + <mediaobject><imageobject><imagedata fileref="figures/config-cal" format="png" srccredit="Aaron Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> + <!-- ==============End of Figure================--> + </para> + + <sect2 id="config-prefs-cal-general"> + <title>Calendar's General Settings</title> + <para> + The <guilabel>Time display</guilabel> tab lets you set the + following: + <variablelist> + <varlistentry> + <term>Time zone</term> + <listitem> + <para> + The city you're located in, to judge your time zone. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Time format</term> + <listitem> + <para>You may choose between twelve-hour (AM/PM) and + twenty-four hour time formats here by clicking the + appropriate radio button. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Work Week</term> + <listitem> + <para> + When does your work day start, and when does it end? + In the day and week views, + <application>Evolution</application> displays all the + hours in the range you select here, even if there are + no appointments for those times. Of course, you can + still schedule an appointment outside of these hours, + and if you do, the display will be extended to show + it. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>First day of the week</term> + <listitem> + <para>You can set weeks to start on Sunday or on Monday.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Start of day</term> + <listitem> + <para> + Says what time of the day your weekday starts. This will show all times till the end of the day, regardless of there is an appointment during the time period. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>End of day</term> + <listitem> + <para> + Sets the time the day ends at. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + <sect2 id="config-prefs-cal-display"> + <title>Display</title> + <para> + The <interface>Display</interface> section lets you configure some visual properties of the calendar. + </para> + <para>The display properties you can set are: + + <variablelist> + <varlistentry> + <term>Time divisions</term> + <listitem> + <para> + Sets the increments shown on the daily view in the calendar. You can set this to be: + <itemizedlist> + <listitem> + <para> + 5 minutes + </para> + </listitem> + <listitem> + <para> + 10 minutes + </para> + </listitem> + <listitem> + <para> + 15 minutes + </para> + </listitem> + <listitem> + <para> + 30 minutes + </para> + </listitem> + <listitem> + <para> + 60 minutes + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Show appointment end times in week and month views</term> + <listitem> + <para> + If there is space, <application>Evolution</application> will show the end times in the week and month views for each appointment. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Compress weekends in month view</term> + <listitem> + <para> + If checked, your weekends will be shown in one box, instead of one for each day in the month view. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Show week numbers in date navigator</term> + <listitem> + <para> + This will show the week numbers next to the respective weeks in the calendar. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + + <sect2 id="config-prefs-cal-tasklist"> + <title>Task List Settings</title> + <para> + You can choose what information the To Do list displays and the + way it is displayed. + <variablelist> + <varlistentry> + <term>Tasks due today</term> + <listitem> + <para> + Configures what color to set your tasks that are due today to. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Overdue tasks</term> + <listitem> + <para> + Configures what color to set your overdue items to. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + + <sect2 id="config-prefs-cal-other"> + <title>Other Calendar Settings</title> + <para> + This configures miscellaneous items for the calendar and todo list's functionality. + <variablelist> + <varlistentry> + <term>Ask for confirmation when deleting items</term> + <listitem> + <para> + When you delete an item in either the Task List or the Calendar, you will be prompted to confirm that you want to delete the item. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Create new appointments with a default reminder</term> + <listitem> + <para> + All your appointments will be created using a default reminder enabled. You can still change what way you are reminded though. If enabled, you can then set the time before your appointment to be reminded. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect2> + </sect1> + + <sect1 id="config-prefs-contact"> + <title>Managing the Addressbook</title> + <para> + The addressbook does not have a large list of configuration + settings, but those that are there can be found in the + <guimenu>Tools</guimenu> menu. + </para> + + <sect2 id="config-prefs-contact-ldap-add"> + <title>Adding Directory Servers</title> + <para> + To add a new <glossterm linkend="ldap">LDAP</glossterm> server + to your available contact folders: + <orderedlist numeration="arabic"> + <listitem> + <para> + Select + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Addressbook Sources</guimenuitem> + </menuchoice> + from the menu. + </para> + </listitem> + <listitem> + <para> + Click the <guibutton>Add</guibutton> button on the right + side. + </para> + </listitem> + <listitem> + <para> + Enter the server information: + <variablelist> + <varlistentry> + <term>Account name</term> + <listitem> + <para> + The name that you see on the screen. This could + be anything you wish. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Server name</term> + <listitem> + <para> + Address of the server where the addressbook is located. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>My server requires authentication</term> + <listitem> + <para> + Select this if the server requires + <application>Evolution</application> to provide + a server in order to access the LDAP contacts. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Port</term> + <listitem> + <para> + The internet port + <application>Evolution</application> connects to + in order to access the LDAP database. This is + normally 389. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><glossterm linkend="search-base">Search base</glossterm></term> + <listitem> + <para> + The base entry to use for all your searches. + Contact your administrator for information about + the correct settings. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><glossterm linkend="search-scope">Search scope</glossterm></term> + <listitem> + <para> + How broad the search is in the directory. The + following options are available: + <variablelist> + <varlistentry> + <term>Base</term> + <listitem> + <para> + Searches just the Search Base. Most of the time, + not very useful. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>One</term> + <listitem> + <para> + Searches the Search Base and one entry + below it. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Sub</term> + <listitem> + <para> + Searches the Search Base and all entries + below it. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </listitem> + <listitem> + <para> + Click <guibutton>OK</guibutton>. + </para> + </listitem> + <listitem> + <para> + Click <guibutton>OK</guibutton> to permanenty make + changes or <guibutton>Apply</guibutton> to temporarily + set the changes. + </para> + </listitem> + </orderedlist> +<!-- I gotta finish this example --> + <example id="ldap-config-example"> + <title>LDAP Configuration</title> + <para> + Rich works at a large chip manufacturer. He needs to + access the company's LDAP server. Their LDAP address is + wemakechips.com. + </para> + <para> + His Account Name would be: We Make Chips Employees + </para> + <para> + His Server Name would be: ldap.wemakechips.com + </para> + </example> + </para> + </sect2> + </sect1> + + +<!-- + <sect1 id="config-prefs-general"> + <title>General Preferences</title> + <para> + Additional configuration options will be covered here, as + they become available. + </para> + </sect1> +--> +</chapter> + + + + + + diff --git a/help/C/config-sync.sgml b/help/C/config-sync.sgml new file mode 100644 index 0000000000..5ce42c3467 --- /dev/null +++ b/help/C/config-sync.sgml @@ -0,0 +1,133 @@ + <chapter id="config-sync"> + <title>Setting up your synchronization system</title> + <para> + Synchronization presents you with two issues you'll need to + address. + <simplelist> + <member> + Your computer needs to recognize and access your handheld. + At this time, <application>Ximian Evolution</application> only + supports Palm-OS devices like the PalmPilot and the + Handspring Visor. + </member> + <member> + You should decide what sort of synchronization behavior you + want. + </member> + </simplelist> + </para> + + <para> + If you haven't used a handheld device with your computer + before, you'll need to run the GNOME <application>Control + Center</application> by selecting + <menuchoice><guimenu>System</guimenu><guimenuitem>Settings</guimenuitem></menuchoice>, + and make sure that <application>Pilot Link</application> is + properly configured. + </para> + <para> + Once your computer and your Palm-OS device are talking happily + to each other, select the <glossterm + linkend="conduit">conduits</glossterm> you want under the + <guilabel>Pilot Conduits</guilabel> section of the Control + Center. You may use conduits to synchronize data with several + applications; the <application>Ximian Evolution</application> + conduits are labelled <guilabel>EAddress</guilabel>, for the + contacts in your addressbook, <guilabel>ECalendar</guilabel>, + for your calendar, and <guilabel>ETodo</guilabel>, for your + task list. + </para> + <para> + To enable a conduit, click the + <guibutton>Enable</guibutton> to enable it, and click + <guibutton>Settings</guibutton> to change what it will do when + activated. Your options may vary depending on the conduit, + but typically they will be: + + <variablelist> + <varlistentry> + <term>Disabled:</term> + <listitem> + <para> + Do nothing. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Synchronize:</term> + <listitem> + <para> + Copy new data from the computer to the handheld, and + from the handheld to the computer. Remove items + that were on both systems but have been deleted on + one. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Copy From Pilot:</term> + <listitem> + <para> + If there is any new data on the the handheld device, + copy it to the computer. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Copy To Pilot:</term> + <listitem> + <para> + Copy new data from the computer to the handheld. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Merge From Pilot:</term> + <listitem> + <para> + Copy new data from the handheld to the computer, and + remove any information from the computer that has + been deleted on the handheld. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Merge To Pilot:</term> + <listitem> + <para> + Copy new data from the computer to the handheld, and + remove any information from the handheld that has + been deleted on the computer. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + + <para> + Select the behavior you want for each conduit you choose to use. + If you're not sure, go ahead and stick with + <guilabel>Synchronize</guilabel>. Then, put your handheld on + its cradle and press the HotSync button. + </para> + <para> + <tip> + <title>Data Loss Prevention</title> + <para> + It's always a good idea to make a backup. To do that, + make a copy of the <filename>evolution</filename> + directory inside your home directory. + </para> + </tip> + </para> + + </chapter> + + + + diff --git a/help/C/evolution-faq.sgml b/help/C/evolution-faq.sgml new file mode 100644 index 0000000000..8e658ff308 --- /dev/null +++ b/help/C/evolution-faq.sgml @@ -0,0 +1,973 @@ +<!-- +<!DOCTYPE appendix PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> +--> +<appendix id="evolution-faq"> + <title>Frequently Asked Questions About Ximian Evolution</title> + <para> + Here are some frequently asked questions about the + <application>Evolution</application> groupware suite from + Ximian. If you have a question that's not listed, you can + contact us at evolve@ximian.com. + </para> + + <sect1 id="faq-features"> + <title>Features</title> + + <qandaset> + + <qandaentry> + <question> + <para> + How can I use Evolution with Microsoft Exchange or Lotus Notes? + </para> + </question> + <answer> + <para> + If your server uses standard open protocols like IMAP, + LDAP, POP, and SMTP, you can use Evolution with it. You + can share addresses with vCards and calendar items with + iCal appointments. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + Can I use Evolution with KDE? + </para> + </question> + <answer> + <para> + Evolution will work fine in KDE. You will need to + install all of the GNOME libraries that it depends on. + Also, certain configuration options, such as default + fonts and the message editor keybinding behavior, must be + changed using the GNOME Control Center application (this + will also run from within KDE). + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + How can I remove or rename a folder? + </para> + </question> + <answer> + <para> + Right-click on the folder and select the + <guimenuitem>Delete</guimenuitem> or + <guimenuitem>Rename</guimenuitem> items. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + Why doesn't drag and drop between folders seem to work? + </para> + </question> + <answer> + <para> + The implementation isn't finished, although it's nearly done. + </para> + + <para> + In the meantime, right-click on the folders or messages + you want to move, and select the + <guimenuitem>Move</guimenuitem> or + <guimenuitem>Copy</guimenuitem> options. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + Can I read mail from a mailbox file created by some other + application (e.g. Mutt) without importing mail from it? + </para> + </question> + <answer> + <para> + No, but it's a planned feature. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + Can Evolution sync with my Palm OS (tm) device? + </para> + </question> + <answer> + <para> + Yes. However, it is not yet stable enough for general + release and we do not yet ship Evolution with Palm + synchronization enabled default. Until we do, you will + need to compile this in yourself. Check the + <filename>README</filename> file for additional + information on the requirements. Full compatibility and + synchronization for calendar and addressbook applications + on Palm devices will be implemented and shipped soon. + </para> + </answer> + </qandaentry> + <qandaentry> + <question> + <para> + What is the difference between a virtual folder (vfolder) + and a regular folder? + </para> + </question> + <answer> + <para> + A virtual folder is like a saved search: it is a view of + your mail. Regular folders actually contain the mail + messages. You can have one message be in multiple virtual + folders, but only in one regular folder. See the section + in the Evolution manual about virtual folders for more + information. + </para> + </answer> + </qandaentry> + <qandaentry> + <question> + <para> + Can Evolution spell-check messages while I compose them? + </para> + </question> + <answer> + <para> + Yes. The Evolution composer is able to highlight + mis-spelled word on the fly as you type them, and also + give you suggestions for possible corrections. In order + for this to work you need the + <filename>gnome-spell</filename> component, which is not + shipped with Ximian GNOME yet. + </para> + + <para> + If you are brave enough, you can check out module + <filename>gnome-spell</filename> from the GNOME CVS and + compile it yourself. Check out its README file for a list + of <filename>gnome-spell</filename>'s requirements for + compilation. + </para> + + <para> + Note that you don't need to recompile Evolution after + installing <filename>gnome-spell</filename>; it will be + picked up automatically. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + Why can't I see the images that are contained in some HTML + mail messages. + </para> + </question> + <answer> + <para> + Evolution currently doesn't support this, but it's a + planned feature. It will be an option: many people like + to turn off the images because they use up bandwidth and can + be used to spy on your email reading habits. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + Can I change the font that Evolution uses to compose and + display mail messages? + </para> + </question> + <answer> + <para> + You have to change the GtkHTML settings for that: in the + GNOME Control Center, go to the "HTML Viewer" + configuration page, which is under the "Document Handlers" + category. + </para> + </answer> + </qandaentry> + <qandaentry> + <question> + <para> + How do I import my Outlook <filename>.pst</filename> files into Evolution? + </para> + </question> + <answer> + <para> + You cannot import these files directly into Evolution + because the <filename>.pst</filename> format is a + proprietary format. However, Mozilla Mail on Windows can + convert them into the <type>mbox</type> format, which can + then be imported by Evolution. + </para> + + <para> + To start importing your Outlook mail to Evolution, run + Mozilla Mail on Windows and select the + <menuchoice><guimenu>File</guimenu><guimenuitem>Import...</guimenuitem></menuchoice> + to begin. Then select that you wish to import Mail from + Outlook. Once Mozilla has imported all your mail, reboot + your computer into Linux. + </para> + + <para> + Mount your Windows partition in Linux and run Evolution to + begin importing your mail. Select + <menuchoice><guimenu>File</guimenu><guimenuitem>Import + File...</guimenuitem></menuchoice> to start importing. Set + the file type to MBox (mbox) and click on + <guibutton>Browse</guibutton> to select the mail you want + to import. + </para> + + <para> + If you are the only user on Windows, the mail files will + be stored in <filename>/mnt/c/windows/Application + Data/Mozilla/Profiles/default/XXXX/Mail/imported.mail/</filename> + where <filename>/mnt/c/</filename> is your windows + partition mount point and XXXX is some collection of + numbers and digits ending in <filename>.slt</filename>. + </para> + + <para> + If there is more than one user, the file will be in + <filename>/mnt/c/windows/Profiles/USERNAME/XXXX/Mail/imported.mail/</filename> + where USERNAME is your Windows username. + </para> + + <para> + For each mail folder in Outlook, Mozilla will convert the + folder into one mbox file. To import all your mail, import + all the files without a <filename>.msf</filename> + extension. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + If Mozilla can import <filename>.pst</filename> files, why can't Evolution? + </para> + </question> + <answer> + <para> + Mozilla on Windows accesses the <filename>.pst</filename> + files through the <filename>MAPI.DLL</filename>, which is + only available on Windows. <filename>MAPI.DLL</filename> + is the only way to access <filename>.pst</filename> files + and Evolution cannot use this DLL in Linux. + </para> + </answer> + </qandaentry> + <qandaentry> + <question> + <para> + Will there be an Evolution server? How about a text-based or web-based front end? + </para> + </question> + <answer> + <para> + Of course, we can't comment on unannounced future product + plans, but Evolution's architecture would permit the + existence of that kind of software. If there is enough + demand for such software we will consider moving in that + direction. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + Will Evolution make a good mocha? + </para> + </question> + <answer> + <para> + Only espresso is planned, but you can easily plug in a chocolate component. + </para> + </answer> + </qandaentry> + + </qandaset> + </sect1> + + + <!-- Section: Getting and compiling --> + + <sect1 id="faq-get-and-compile"> + <title> + Getting and Compiling Evolution + </title> + <qandaset> + <qandaentry> + <question> + <para> + Where can I get the latest Evolution release? + </para> + </question> + <answer> + <para> + There are two ways to install the latest Evolution + release: + <itemizedlist> + <listitem> + <para> + If you have Ximian GNOME installed, you can start + Red Carpet, Ximian's software updating system, and + subscribe to the Evolution channel. This will let + you install a binary for the latest release, and + will also warn you when a new version has been made + available. + </para> + </listitem> + + <listitem> + <para> + If you want to compile from source, you can + download the latest official Evolution tarball + from: + </para> + + <para> + <ulink url="ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution"> + ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution</ulink> + </para> + </listitem> + </itemizedlist> + </para> + </answer> + </qandaentry> + <qandaentry> + <question> + <para> + Are binary snapshots available? + </para> + </question> + <answer> + <para> + Yes, if you have Ximian GNOME installed. Just run Red + Carpet and subscribe to the Evolution Snapshot channel. + </para> + + <para> + You can check the status of snapshots at + <ulink url="http://primates.ximian.com/~snapshot">http://primates.ximian.com/~snapshot</ulink>. + </para> + </answer> + </qandaentry> + <qandaentry> + <question> + <para> + Why isn't a new snapshot available today? + </para> + </question> + <answer> + <para> + Sometimes the build might fail because of problems with + the source on CVS. In this case, just wait for next day's + snapshot. + </para> + </answer> + </qandaentry> + <qandaentry> + <question> + <para> + How do I get Evolution from CVS? + </para> + </question> + <answer> + <para> + If you already have + <ulink url="http://cvs.gnome.org">GNOME CVS</ulink> access, + simply check out the following modules: evolution, + gtkhtml, gal. + </para> + <para> + If you don't have a CVS account, you can use anoncvs + instead. Bear in mind that anoncvs is only synchronized once + a day, and code received from anoncvs may not be latest + version available. + </para> + + <para> + Before using the anoncvs server, you have to log into it. + This only needs to be done once. Use this command: + </para> + + <programlisting> + cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome login + </programlisting> + + <para> + Then you can retrieve the modules needed to compile Evolution + using the following command: + </para> + + <programlisting> + cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co evolution gtkhtml gal + </programlisting> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + How should I compile Evolution avoiding conflicts with my + existing GNOME installation? + </para> + </question> + <answer> + <para> + The best way is to install Evolution into a separate prefix. + In order to specify a non-default installation prefix, you + can pass the <parameter>--prefix</parameter> option to + <filename>configure</filename> or + <filename>autogen.sh</filename>. For example: + </para> + + <programlisting> + cd /cvs/evolution + ./autogen.sh --prefix=/opt/gnome + </programlisting> + + <para> + If you install Evolution and the Evolution libraries in a + non-standard prefix, make sure you set the appropriate + environment variables in the startup script for Evolution: + </para> + + <programlisting> + export PATH=/opt/gnome:$PATH + export GNOME_PATH=/opt/gnome:/usr + </programlisting> + + <para> + You may also need to add <filename>$prefix/lib</filename> + (e.g. <filename>/opt/gnome/lib</filename>) to your + <filename>/etc/ld.so.conf</filename>. Of course, this will + not work for systems which do not use ld.so.conf, such as + HP-UX. + </para> + </answer> + </qandaentry> + <qandaentry> + <question> + <para> + I get the error message: <computeroutput>make: *** No rule + to make target + `all-no-@BUILD_INCLUDED_LIBINTL@'</computeroutput> + </para> + </question> + <answer> + <para> + You probably have <filename>gettext</filename> 0.10.36 or + later installed. Try downgrading to 0.10.35; + unfortunately, 0.10.36 introduced some incompatibilities + with the current <filename>xml-i18n-tools</filename>. + </para> + </answer> + </qandaentry> + </qandaset> + </sect1> + + <sect1 id="faq-trouble"> + <title>Troubleshooting</title> + <qandaset> + <qandaentry> + <question> + <para> + I get <computeroutput>Cannot initialize the Evolution + shell</computeroutput>. + </para> + </question> + <answer> + <para> + There are a number of things that can cause this error. + Check that: + </para> + + <itemizedlist> + <listitem> + <para> + <filename>oafd</filename> is listed in your <envar>PATH</envar> + environment variable. + </para> + </listitem> + + <listitem> + <para> + <filename>GNOME_Evolution_Shell.oaf</filename> and + the other + <filename>GNOME_Evolution_*.oaf</filename> files are + readable and installed in + <filename>$prefix/share/oaf</filename>, where + <filename>$prefix</filename> is one of the prefixes + listed in <envar>GNOME_PATH</envar> or + <envar>OAF_INFO_PATH</envar>. (These variables are + supposed to contain $PATH-like colon-separated lists of + paths. If the installation prefix for Evolution is + different from that). Run `oaf-slay' once before running + `evolution' again if you change $GNOME_PATH or + $OAF_INFO_PATH. + </para> + </listitem> + + <listitem> + <para> + <filename>evolution</filename>, + <filename>evolution-mail</filename> and the other + <filename>evolution-*</filename> executables are in your + $PATH. + </para> + </listitem> + </itemizedlist> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + I get <computeroutput>Cannot open composer window</computeroutput>. + </para> + </question> + <answer> + <para> + This actually means that Evolution cannot activate the HTML + editor component from GtkHTML. The comments in the previous + answer still apply; also make sure that + <command>gnome-gtkhtml-editor</command> is in your + <envar>PATH</envar>. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + The address suggestion list steals focus from the "To:" + entry box when I'm typing. How can I make it keep focus? + </para> + </question> + <answer> + <para> + This is a bug in GTK version 1.2.10. To avoid it, downgrade + to GTK version 1.2.9, or install the Ximian version of GTK + 1.2.10. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + I updated Evolution and now my addressbook information is gone! + What should I do? + </para> + </question> + <answer> + <para> + Evolution uses the <filename>libdb</filename> library to + handle the addressbook database. Two versions of + <filename>libdb</filename> can be used with Evolution: version + 1.88 and version 2. + </para> + + <para> + Unfortunately, an Evolution executable that is linked against + a certain version of <filename>libdb</filename> will only be + able to read addressbook files written by another Evolution + executable that is linked with the same version of the + library. If your addressbook is not readable by Evolution + anymore, it probably means that you used to have Evolution + linked with a certain version of <filename>libdb</filename>, + but now it gets linked to a different version. + </para> + + <para> + Because of the way <filename>libdb</filename> is designed, it + is not easy for Evolution to automatically do the conversion + between the two formats. But, if your Evolution used to be + linked against version 1.85 and now is linked to version 2, + there is a very simple way to convert the database and recover + your data. + </para> + + <itemizedlist> + + <listitem> + <para> + First of all, check the format of the database using the + <command>file</command> command: + </para> + + <programlisting> + file ~/evolution/local/Contacts/addressbook.db + </programlisting> + + <para> + You want version 1.85 there. If your version is 2, then + your current Evolution is probably linked against + version 1.85 and you cannot convert the database to the + old format. To do that, follow these instructions: + </para> + </listitem> + + <listitem> + <para> + Quit Evolution. + </para> + </listitem> + + <listitem> + <para> + Make a copy of the addressbook database for backup + purposes, then move the original out of the way. + </para> + + <programlisting> + cd ~/evolution/local/Contacts + cp addressbook.db addressbook.db.backup + mv addressbook.db addressbook.db.tmp + </programlisting> + </listitem> + + <listitem> + <para> + Convert the contacts to the new format using + <command>db_dump185</command> and + <command>db_load</command>: + </para> + + <programlisting> + db_dump185 addressbook.db.tmp | db_load ~/evolution/local/Contacts/addressbook.db + </programlisting> + </listitem> + + <listitem> + <para> + Restart Evolution. + </para> + </listitem> + + </itemizedlist> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + Evolution reported an error when trying to retrieve from my + local spool in <filename>/var/spool/mail/username</filename>. Why? + </para> + </question> + <answer> + <para> + Evolution doesn't have an external helper for moving mail, + so <filename>/var/spool/mail/</filename> must be writable + by you. Try this: + </para> + + <programlisting> + chmod 1777 /var/spool/mail + </programlisting> + + <para> + We're working on a solution to this problem now. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + Evolution crashes reporting that it couldn't allocate N + billion bytes; how do I fix this? + </para> + </question> + <answer> + <para> + This usually happens when a component tries talking a + certain version of a CORBA interface to another component + that supports a different version. For example, this can + happen when you recompile and install a single component + without recompiling/installing the rest of Evolution. + </para> + + <para> + If you run into this problem, make sure all the components + are compiled and installed at the same time. This also + applies to GtkHTML upgrades; after upgrading and + installing a newer GtkHTML, always re-compile and + re-install Evolution against it. + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + What is <command>killev</command> and why do I need to use it? + </para> + </question> + <answer> + <para> + Evolution is actually made up of several components that run + as separate processes. Evolution's shell is not very good + at cleaning up stale processes, so it is possible that + sometimes already-running components cause unexpected and/or + broken behavior. + </para> + + <para> + It's always a good idea to run <command>killev</command> + after a crash in Evolution, especially if the Evolution + shell itself crashed. (If a component crashes instead, you + should try to exit the shell cleanly first, so you give a + chance to the other components to clean things up properly.) + </para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para> + What is <command>oaf-slay</command> and why do I need to use it? + </para> + </question> + <answer> + <para> + <command>oaf-slay</command> is an utility which comes with + OAF, the Object Activation Framework that is used in the + GNOME Desktop to activate components. It will kill the + object activation daemon (<command>oafd</command>) as well + as all the active components on the system. + </para> + + <para> + Using <command>oaf-slay</command> + <command>oaf-slay</command> is quite drastic and can cause + problems with other programs that use oaf, especially with + <application>Nautilus</application>. To avoid problems, do + not run <command>oaf-slay</command> while you are in GNOME. + </para> + </answer> + </qandaentry> + </qandaset> + </sect1> + + <sect1 id="faq-debugging"> + <title>Questions about Bugs and Debugging</title> + <para> + Find a bug? Here's how to help us fix it! + </para> + + <qandaset> + <qandaentry> + <question> + <para> + Where should I report bugs for Evolution? + </para> + </question> + <answer> + <para> + You can use the GNOME Bug Report Tool + (<command>bug-buddy</command>), or report bugs to the + Ximian bug reporting system (Bugzilla), located at <ulink + url="http://bugzilla.ximian.com">http://bugzilla.ximian.com</ulink>. + </para> + + <para> + Please use the query function to check if a bug has been + submitted already, so that we avoid duplicate reports. + </para> + </answer> + </qandaentry> + + + <qandaentry> + <question> + <para> + What is a stack trace (backtrace) and how do I get one? + </para> + </question> + <answer> + <para> + A stack trace is a list of the chain of function calls + that lead to some point in the program. Typically, you + want to get a stack trace when Evolution crashes or + hangs and you want to try to figure out where in the + code that happened and why. For this reason, stack + traces are extremely useful for the Evolution + developers, so it's important that you learn how to get + them, and include them in crash reports. The + <application>bug-buddy</application> tool can get and + submit a stack trace for you. If you want to do it by + yourself, here's how: + </para> + <para> + First of all, in order to get a stack trace, your + executable (and possibly the libraries) must be compiled + with debugging symbols. Debugging symbols are created by + default if you compile from CVS, and are included in the + snapshot builds. If you decide to compile by yourself + with some custom CFLAGS value, make sure -g is included + in them. + </para> + <para> + Finally, you must put the component that crashes through + <application>gdb</application>, the GNU debugging tool. + To do so, make sure all the components are dead (exit + Evolution and run <command>killev</command>), then run the + following command: + <programlisting> + <command>gdb name-of-component</command> + </programlisting> + + Where "name-of-component" is the name of the component that + crashed. + </para> + <para> + Then, at the gdb prompt, type r (for "run") and wait a + few seconds to make sure the component has registered + with the name service. Then start + <application>Evolution</application> normally from a + different terminal. + </para> + <para> + When you have started + <application>Evolution</application>, reproduce the + crash, and go back to the terminal where you ran gdb. If + the component crashed, you should have a prompt there; + otherwise, just hit Control+C. At the prompt, type + <command>info threads</command>. This will give you a + screen that looks like this: + </para> + <para> + <programlisting> +(gdb) info threads + 8 Thread 6151 (LWP 14908) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 7 Thread 5126 (LWP 14907) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 6 Thread 4101 (LWP 1007) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 5 Thread 3076 (LWP 1006) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 4 Thread 2051 (LWP 1005) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 3 Thread 1026 (LWP 1004) 0x409778fe in sigsuspend () from /lib/libc.so.6 + 2 Thread 2049 (LWP 1003) 0x40a10d90 in poll () from /lib/libc.so.6 + 1 Thread 1024 (LWP 995) 0x40a10d90 in poll () from /lib/libc.so.6 + </programlisting> + + For the most part, only + <application>evolution-mail</application> will have more + than one thread. + </para> + <para> + Now, for each of the threads listed, type the following commands: +<programlisting> +thread N +bt +</programlisting> + Where 'N' is the number of the thread (in this example, 1 + through 8). + </para> + <para> + Cut and paste all the output gdb gives you into a text + file. You can quit gdb by typing + <userinput>quit</userinput> + </para> + <para> + If you prefer, you can start gdb while a process is + running. You'll want to do this right after a crash dialog + appears, but before hitting "OK" or "Submit bug report". + Start <application>gdb</application> as above, but instead + of using <userinput>r</userinput>, type <userinput>attach + PID</userinput> where PID is the process ID of the + component you want to debug. + </para> + <para> + If that sounds too complicated, you can always use + <command>bug-buddy</command> to get and submit the stack + trace. + </para> + </answer> + </qandaentry> + <qandaentry> + <question> + <para> + A component of evolution crashed, but since the rest of + evolution stayed up, I couldn't use bug-buddy to get a + stack trace. How can I use gdb to get a stack trace of + the component? + </para> + </question> + <answer> + <para> + To trace a failing component (in this example, evolution-mail): + <orderedlist numeration="arabic"> + <listitem> + <para> + Open two terminals. + </para> + </listitem> + <listitem> + <para> + In one, type <command>gdb evolution-mail</command> + . Replace "evolution-mail" with the name of the + component that is crashing: evolution-addressbook, + evolution-calendar, etc.) + </para> + </listitem> + <listitem> + <para> + Once gdb starts, type <userinput>r</userinput> and + hit enter. Give it a few seconds, to make sure it + starts up completely. + </para> + </listitem> + <listitem> + <para> + In the second terminal, type + <command>evolution</command>. Do whatever you did + to cause the crash in the component you used in + step two. + </para> + </listitem> + <listitem> + <para> + When the crash occurs, type 'bt' in the first + terminal. + </para> + </listitem> + + <listitem> + <para> + Cut and paste the output into your bug report. + </para> + </listitem> + </orderedlist> + </para> + </answer> + </qandaentry> + </qandaset> + </sect1> + </appendix> + +<!-- Local Variables: --> <!-- indent-tabs-mode:nil --> <!-- End: --> + + + + diff --git a/help/C/evolution.sgml b/help/C/evolution.sgml new file mode 100644 index 0000000000..8cc6534a1d --- /dev/null +++ b/help/C/evolution.sgml @@ -0,0 +1,126 @@ +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN"[ + +<!ENTITY PREFACE SYSTEM "preface.sgml"> +<!ENTITY USAGE-MAINWINDOW SYSTEM "usage-mainwindow.sgml"> +<!ENTITY USAGE-EXEC-SUMMARY SYSTEM "usage-exec-summary.sgml"> +<!ENTITY USAGE-MAIL SYSTEM "usage-mail.sgml"> +<!ENTITY USAGE-MAIL-ORG SYSTEM "usage-mail-org.sgml"> +<!ENTITY USAGE-CONTACT SYSTEM "usage-contact.sgml"> +<!ENTITY USAGE-CALENDAR SYSTEM "usage-calendar.sgml"> +<!ENTITY USAGE-EXCHANGE SYSTEM "usage-exchange.sgml"> +<!ENTITY USAGE-SYNC SYSTEM "usage-sync.sgml"> +<!ENTITY USAGE-PRINT SYSTEM "usage-print.sgml"> +<!ENTITY CONFIG-PREFS SYSTEM "config-prefs.sgml"> +<!ENTITY CONFIG-SYNC SYSTEM "config-sync.sgml"> +<!ENTITY MENUREF SYSTEM "menuref.sgml"> +<!ENTITY APX-GLOSS SYSTEM "apx-gloss.sgml"> +<!ENTITY APX-COMMON-TASKS SYSTEM "apx-common-tasks.sgml"> +<!ENTITY APX-BUGS SYSTEM "apx-bugs.sgml"> +<!ENTITY APX-AUTHORS SYSTEM "apx-authors.sgml"> + +]> + + +<!-- Almost every chapter is an entity. Files, Chapter id's, and +entity names correspond. APX is for appendix. --> + +<book id="index"> + <bookinfo> + <title>A User's Guide to Ximian Evolution</title> + <authorgroup> + <author><firstname>Aaron</firstname><surname>Weber</surname></author> + <author><firstname>Kevin</firstname><surname>Breit</surname></author> + <author><firstname>Ettore</firstname><surname>Perazzoli</surname></author> + <author><firstname>Duncan</firstname><surname>Mak</surname></author> + </authorgroup> + <copyright> + <year>2000-2002</year> + <holder>Ximian, Inc.</holder> + </copyright> + + <legalnotice id="legalnotice"> + + <para> + Permission is granted to copy, distribute and/or modify this + document under the terms of the <ulink type="help" + url="gnome-help:fdl"><citetitle>GNU Free Documentation + License</citetitle></ulink>, Version 1.1 or any later version + published by the Free Software Foundation with no Invariant + Sections, no Front-Cover Texts, and no Back-Cover Texts. You + may obtain a copy of the <citetitle>GNU Free Documentation + License</citetitle> from the Free Software Foundation by + visiting <ulink type="http" url="http://www.fsf.org">their + Web site</ulink> or by writing to: Free Software Foundation, + Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, + USA. + </para> + <para> + Many of the names used by companies to distinguish their + products and services are claimed as trademarks. Where those + names appear in any GNOME documentation, and those trademarks + are made aware to the members of the GNOME Documentation + Project, the names have been printed in caps or initial caps. + </para> + </legalnotice> + + <releaseinfo> + This is version 1.0 of the Ximian Evolution manual. It describes + version 1.0 of the Ximian Evolution groupware suite. + </releaseinfo> + + </bookinfo> + + &PREFACE; + + <part id="usage"> + <title>Getting Started with Ximian Evolution</title> + <partintro> + <para> + Part one of the <application>Ximian Evolution</application> manual + describes how to use <application>Ximian Evolution</application> for + email, contact management, and appointment and task + scheduling. You'll find as you go along that there's more + than one way to do things, and you can pick whichever method + you like best. + </para> + </partintro> + + &USAGE-MAINWINDOW; + &USAGE-EXEC-SUMMARY; + &USAGE-MAIL; + &USAGE-MAIL-ORG; + &USAGE-CONTACT; + &USAGE-CALENDAR; + &USAGE-EXCHANGE; + &USAGE-SYNC; + &USAGE-PRINT; + </part> + <part id="config"> + <title>Configuring and Managing Ximian Evolution</title> + <partintro> + <para> + <application>Ximian Evolution</application> is highly + configurable. Usually, when developers say that, they mean + that they didn't test it out thoroughly and have left it to + other programmers to "configure" themselves a working + system. In the case of <application>Ximian + Evolution</application>, "configurable", it means that, while + you can expect the program to work perfectly well in its + default settings, it's also easy to alter its behavior in a + wide variety of ways, so that it fits your needs exactly. + This part of the book will describe that process, from the + quickest glimpse of the Setup Assistant to an in-depth tour of + the preferences dialogs. + </para> + </partintro> + + &CONFIG-PREFS; + &CONFIG-SYNC; + </part> + + &MENUREF; + &APX-GLOSS; + &APX-BUGS; + &APX-AUTHORS; + +</book>
\ No newline at end of file diff --git a/help/C/menuref.sgml b/help/C/menuref.sgml new file mode 100644 index 0000000000..340a408847 --- /dev/null +++ b/help/C/menuref.sgml @@ -0,0 +1,421 @@ +<!-- +<!DOCTYPE Appendix PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> +--> + +<appendix id="menuref"> + <title>Quick Reference</title> + <para> + You might want to copy this section and tape it to the wall + next to your computer: it's a very short summary of most of + the things you'll want to do with + <application>Ximian Evolution</application>. + </para> + + +<note id="shortcuts"> +<title>Custom Keyboard Shortcuts</title> +<para> + If you have set custom keyboard shortcuts for your desktop, (you can + do this the control center: select + <menuchoice><guimenu>System</guimenu><guimenuitem>Settings</guimenuitem></menuchoice> + from your menu panel), they may interfere with Evolution keyboard + shortcuts. +</para> +<para> + For example, if you have chosen Emacs-style key bindings for your + desktop-wide text editor, the shortcut + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>W</keycap> + </keycombo> + will act as "Cut region" rather than as "Close Window" in the + message composer. +</para> +</note> + + + + + <sect1 id="quickref-open"> + <title>Opening or Creating Anything</title> + <para> + <variablelist> + + + <varlistentry> + <term>New Item:</term> + <listitem> + <para> + Press <keycombo action="simul"> <keycap>Ctrl</keycap> + <keycap>N</keycap> </keycombo> to open a new item + for whatever part of <application>Ximian + Evolution</application> you're working on. In mail, + that means you'll create a new message. If you're + looking at your addressbook, <keycombo + action="simul"> <keycap>Ctrl</keycap> + <keycap>N</keycap> </keycombo> creates a new contact + card, and in the calendar, a new appointment. + </para> + </listitem> + </varlistentry> + + + <varlistentry> + <term>Create a new folder:</term> + <listitem> + <para> + <menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu> + <guimenuitem>Folder</guimenuitem></menuchoice> or + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>Shift </keycap> + <keycap>E</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Create a new Shortcut in the Evolution Bar:</term> + <listitem> + <para> + <menuchoice><guimenu>File</guimenu> + <guisubmenu>New</guisubmenu> + <guimenuitem>Evolution Bar Shortcut</guimenuitem> </menuchoice> or + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>Shift</keycap> + <keycap>S</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Create a new email message:</term> + <listitem> + <para> + Use + <menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu><guimenuitem>Mail + Message</guimenuitem> </menuchoice> or + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>Shift </keycap> + <keycap>M</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Create a new Appointment:</term> + <listitem> + <para> + <menuchoice><guimenu>File</guimenu> + <guisubmenu>New</guisubmenu> + <guimenuitem>Appointment</guimenuitem> </menuchoice> or + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>Shift</keycap> + <keycap>A</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + + + <varlistentry> + <term>Enter a new Contact:</term> + <listitem> + <para> + Double-click in any blank space in the contact + manager to create a new address card. You can also + use + <menuchoice><guimenu>File</guimenu> + <guisubmenu>New</guisubmenu> + <guimenuitem>Contact</guimenuitem> </menuchoice> or + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>Shift</keycap> + <keycap>C</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Create a new Task:</term> + <listitem> + <para> + <menuchoice><guimenu>File</guimenu> + <guisubmenu>New</guisubmenu> + <guimenuitem>Task</guimenuitem> </menuchoice> or + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>Shift</keycap> + <keycap>T</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect1> + <sect1 id="quickref-mail"> + <title>Mail Tasks</title> + <para> + Here are the most frequent email tasks, and shortcuts for + navigating your mailbox with the keyboard instead of the + mouse: + <variablelist> + + + <varlistentry> + <term>Send and Receive Mail:</term> + <listitem> + <para> + Press <keycap>F9</keycap>, click the + <guibutton>Send/Receive</guibutton> button in the + toolbar, or choose + <menuchoice><guimenu>Actions</guimenu> + <guimenuitem>Send/Receive</guimenuitem></menuchoice>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Navigating the Message List with the Keyboard:</term> + <listitem> + <para> + Press <keycap>N</keycap> to jump to the next unread + message. <keycap>P</keycap> goes to the previous + unread message. Use the arrow keys to move up + and down along the list of all messages. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Move the display up and down in the preview pane:</term> + <listitem> + <para> + Press the space bar to go a page down. Press + <keycap>Backspace</keycap> to go a page up. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Reply to a Message:</term> + <listitem> + <para> + To reply to the sender of the message only: + click <guibutton>Reply</guibutton> in the + toolbar, or press + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>R</keycap> + </keycombo> + </para> + <para> + To reply to the sender and all the other visible + recipients of the message, click <guibutton>Reply to + All</guibutton> or select the message and press + <keycombo action="simul"> + <keycap>Shift</keycap> + <keycap>Ctrl</keycap> + <keycap>R</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Forward a Message:</term> + <listitem> + <para> + Select the message or messages you want to forward, + and click <guibutton>Forward</guibutton> in the + toolbar, or press + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>F</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Open a Message in a New Window:</term> + <listitem> + <para> + Double-click the message you want to view, or select + it and press + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>O</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Create Filters and Virtual Folders:</term> + <listitem> + <para> + Right-click on a message and select + <guimenuitem>Create Rule From + Message</guimenuitem>. You can also create filters and + virtual folders in the <guimenu>Tools</guimenu> menu. + </para> + </listitem> + </varlistentry> + + + <varlistentry> + <term>Add Sender to Address Book:</term> + <listitem> + <para> + Right-click on a message and select <guimenuitem>Add + Sender to Address Book</guimenuitem>. You can also + right-click on any email address to add it to your + address book. + </para> + </listitem> + </varlistentry> + </variablelist> + + + + </para> + </sect1> + <sect1 id="quickref-cal"> + <title>Calendar</title> + <para> + <variablelist> + + <varlistentry> + <term>Create a new Appointment:</term> + <listitem> + <para> + <menuchoice><guimenu>File</guimenu> + <guisubmenu>New</guisubmenu> + <guimenuitem>Appointment</guimenuitem> </menuchoice> or + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>Shift</keycap> + <keycap>A</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Create a new Task:</term> + <listitem> + <para> + <menuchoice><guimenu>File</guimenu> + <guisubmenu>New</guisubmenu> + <guimenuitem>Task</guimenuitem> </menuchoice> or + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>Shift</keycap> + <keycap>T</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term></term> + <listitem> + <para> + <tip id="new-appt"> + <title>New Appointments Fast</title> + <para> + Click on any blank spot in the calendar and start + typing to create a new appointment entry. + </para> + </tip> + </para> + </listitem> + </varlistentry> + </variablelist> + + </para> + </sect1> + <sect1 id="quickref-contact"> + <title>Addressbook</title> + <para> + Here are shortcuts for the most frequent addressbook actions: + <variablelist> + <varlistentry> + <term>Edit a Contact:</term> + <listitem> + <para> + You can edit a contact two ways: + <itemizedlist> + <listitem> + <para> + Click once on the person's address card and you can + edit the person's properties all in the same window. + </para> + </listitem> + <listitem> + <para> + Double-click on the contact's card and alter their details. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + + <variablelist> + <varlistentry> + <term>Deleting a Contact:</term> + <listitem> + <para> + Right click on a contact and click <guilabel>Delete</guilabel> + or select a contact and press the <guibutton>Delete</guibutton> + on the <guilabel>toolbar</guilabel>. + </para> + </listitem> + </varlistentry> + </variablelist> + + + <variablelist> + <varlistentry> + <term>Email a Contact:</term> + <listitem> + <para> + Right click on a contact and select + <guilabel>Send message to contact</guilabel>. + </para> + </listitem> + </varlistentry> + </variablelist> + + <variablelist> + <varlistentry> + <term>Creating a New Contact:</term> + <listitem> + <para> + Double-click in any blank space in the contact + manager to create a new address card. You can also + use <menuchoice><guimenu>File</guimenu> + <guisubmenu>New</guisubmenu> + <guimenuitem>Contact</guimenuitem> </menuchoice> or + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>Shift</keycap> + <keycap>C</keycap> + </keycombo> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </sect1> +</appendix>
\ No newline at end of file diff --git a/help/C/preface.sgml b/help/C/preface.sgml new file mode 100644 index 0000000000..9637beaf4c --- /dev/null +++ b/help/C/preface.sgml @@ -0,0 +1,83 @@ +<!-- +<!DOCTYPE preface PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> +--> + <preface id="introduction"> + <title>About this Book</title> + <sect1 id="organization"> + <title>Organization</title> + <para> + This book is divided into two parts, with several + appendices. The first part is a <link linkend="usage">guided + tour</link>, which will explain how to use + <application>Evolution</application>. If you are new to + <application>Evolution</application> or to groupware in + general, this section is for you. The second section, covering + <link linkend="config">configuration</link>, is targeted at + more advanced users, but anyone who wants to change the way + <application>Evolution</application> looks or acts can benefit + from reading it. + </para> + </sect1> + + <sect1 id="typography"> + <title>Typographical conventions</title> + <para> + In this book, we'll mark some words with special typography: + <simplelist> + <member><application>Applications</application></member> + <member><command>Commands</command> you type at the command line</member> + <member><guilabel>Labels</guilabel> for buttons and other portions of the graphical interface</member> + + <member> Menu selections look like this: + <menuchoice> + <guimenu>Menu</guimenu> + <guisubmenu>Submenu</guisubmenu> + <guimenuitem>Menu Item</guimenuitem> + </menuchoice> + </member> + <member><guibutton>Buttons</guibutton> you can + click</member> <member><userinput>Anything you type + in</userinput></member> <member><computeroutput>Text + output from a computer</computeroutput></member> + <member><glossterm linkend="apx-gloss">Words</glossterm> + that are defined in the <xref linkend="apx-gloss">.</member> + </simplelist> +</para> +<para> +We'll provide assorted bits of additional information in tips set off from the rest of the book, as well. + + <tip id="example-tip"> + <title>Tip</title> + <para> + Tips and bits of extra information will look like + this. + </para> + </tip> +</para> + +<para> +Examples are also set off from the rest of the text. They look like this: + + <example> + <title>Example Example</title> + <para> + This is what an example looks like. We'll provide + examples for some of the more complicated tasks you + might be performing. + </para> + </example> +</para> +<para> +Lastly, we'll have warnings, in cases where you should be careful: + + <warning id="example-warning"> + <title>Example Warning</title> + <para> + This is what a warning looks like. If there's a chance + you'll run into trouble, we'll warn you beforehand. + </para> + </warning> + </para> + </sect1> +</preface> + diff --git a/help/C/usage-calendar.sgml b/help/C/usage-calendar.sgml new file mode 100644 index 0000000000..05f5e8e3d8 --- /dev/null +++ b/help/C/usage-calendar.sgml @@ -0,0 +1,710 @@ +<!-- +<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> +--> + +<chapter id="usage-calendar"> + <title>Managing your Schedule</title> + + <para> + This chapter will show you how to use the Ximian Evolution + Calendar to manage your schedule alone or in conjunction with + peers. + </para> + + <sect1 id ="usage-calendar-view"> + <title>Ways of Looking at your Calendar</title> + <para> + The toolbar offers you four different views of your calendar: + <itemizedlist> + <listitem> + <para> + Day + </para> + </listitem> + <listitem> + <para> + Work Week + </para> + </listitem> + <listitem> + <para> + Week + </para> + </listitem> + <listitem> + <para> + Month + </para> + </listitem> + </itemizedlist> +</para> +<para> + Press the calendar-shaped buttons on the right side of the toolbar to + switch between views. +</para> +<para> + You can also select an arbitrary range of days in the small + calendar at the upper right. To do this, click and drag on the + days that you wish to view in your calendar. + </para> + <para> + The <guibutton>Prev</guibutton> and <guibutton>Next</guibutton> + buttons will move you forward and back in your calendar pages. + If you're looking at only one day, you'll see tomorrow's page, + or yesterday's. If you're looking at your calendar by week or + month, you'll move around by just that much. + To come back to today's listing, click the + <guibutton>Today</guibutton> button in the toolbar. + </para> + <para> + To visit a specific date's calendar entries, click + <guibutton>Go To</guibutton> and select the date in the dialog + box that appears. + </para> + + </sect1> + <sect1 id="usage-calendar-apts"> + <title>Scheduling With the Evolution Calendar</title> + <para> + Of course, you'll want to use the calendar to do more than find + out what day it is. This section will tell you how to schedule + appointments, set alarms, and determine appointment + recurrence. If you have installed the Ximian Connector for + Microsoft Exchange, you can also read <xref + linkend="full-advantage"> to learn about how to take full + advantage of the collaborative group scheduling functions + available on the Microsoft Exchange Server. + </para> + + <sect2 id="usage-calendar-apts-basic"> + <title>Creating appointments</title> + <para> + To create a new appointment, select + <menuchoice> + <guimenu>File</guimenu> + <guisubmenu>New</guisubmenu> + <guimenuitem>Appointment</guimenuitem> + </menuchoice> + or click the <guibutton>New Appointment</guibutton> button on the left end + of the toolbar. The <interface>New Appointment</interface> + dialog will pop up with the menu bar, tool bar, and + window full of choices for you. + </para> + <tip id="new-appointment-shortcut"> + <title>Shortcut</title> + <para> + If you don't need to enter more information than the date + and time of the appointment, you just click in any blank + space in the calendar and start typing. You can enter other + information later with the appointment editor. + </para> + </tip> + + <para> + Your appointment must have a starting and ending date — by + default, today — but you can choose whether to give it + starting and ending times or to mark it as an <guilabel>All + day event</guilabel>. An <guilabel>All day event</guilabel> + appears at the top of a day's appointment list, in the grey header under the date, rather than inside + it. That makes it easy to have appointments that overlap and fit + inside each other. For example, a conference might be an all + day appointment, and the meetings at the conference would be timed + appointments. Of course, appointments with specific starting and ending + times can also overlap. When they do they're displayed as + multiple columns in the day view of the calendar. + </para> + <para> + <application>Evolution</application> supports the use of + timezones. If you share calendar files with friends or + co-workers, it is quite possible you will need to configure + your timezone. To configure your timezone: + <orderedlist numeration="arabic"> + <listitem> + <para> + Click + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Calendar Settings</guimenuitem> + </menuchoice> + </para> + </listitem> + <listitem> + <para> + Click the <guibutton>Globe</guibutton> button in the + <guilabel>Time</guilabel> section, located in the + <guilabel>General</guilabel> tab. + </para> + </listitem> + <listitem> + <para> + Each red dot represents a major city. Click a dot and click <guibutton>OK</guibutton> to select your time zone. + </para> + </listitem> + </orderedlist> + </para> + <para> + You can also configure timezone information specific to the + Start and End time in each appointment. To do that, simply + create a new appointment and click on a globe to customize the + timezone that the time exists in. For example, if you live in + New York but have a telephone meeting set for noon with + someone in California, you need to make sure that you're not + calling each other a few hours off. Setting time-zones on a + per-appointment basis helps avoid that potential confusion. + </para> + <note> + <title>Multiple Simultanious Appointments</title> + <para> + If you create calendar appointments that overlap, + <application>Evolution</application> will display them side + by side in your calendar. However, + <application>Evolution</application> cannot help you do + multiple things at once. + </para> + </note> + <para> + You can have as many + <guilabel>Alarms</guilabel>, any time prior to the appointment + you've scheduled. You can have one alarm of each of the following types: + <variablelist> + <varlistentry> + <term><guilabel>Display:</guilabel></term> + <listitem> + <para> + A window will pop up on your screen to remind you of + your appointment. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Audio:</guilabel></term> + <listitem> + <para> + Choose this to have your computer deliver a sound + alarm. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Program:</guilabel></term> + <listitem> + <para> + Select this if you would like to run a program as a + reminder. You can enter its name in the text field, + or find it with the <guibutton>Browse</guibutton> + button. + </para> + </listitem> + </varlistentry> + </variablelist> + + </para> + <para> + <guilabel>Classification</guilabel> + only applies to calendars on a + network. <guilabel>Public</guilabel> is the default category, + and a public appointment can be viewed by anyone on the calendar + sharing network. <guilabel>Private</guilabel> denotes one + level of security, and <guilabel>Confidential</guilabel> an even + higher level. + </para> + <para> + <application>Evolution</application> can handle not only time + that you're busy, but free time. This can be useful if you're + on a network sharing calendar files. You can easily compare + schedules with other people, allowing easy setup of a RSVP. + </para> + <para> + To set your appointment to be free or busy, simply click the + box in the <guilabel>Show Time As</guilabel> section in the + <guilabel>Appointment Editor</guilabel>. + </para> + <para> + <application>Evolution</application> lets you categorize your + appointments, which can help if you lead a busy life. The bottom + section of the <guilabel>Appointment</guilabel> tab is where your + categorization is done. + </para> + + <tip> + <title>Adding a New Appointment Category</title> + <para> + You can add a new category to your category list by clicking on + <guibutton>Edit Master Category List</guibutton> and single-clicking + on <guilabel> Click here to add a category</guilabel>. + </para> + </tip> + + <para> + The purpose of categories is to let you view all appointments which have + similar activities. To do this, change <guilabel>Any field contains</guilabel> + to <guilabel>Has category</guilabel> and enter your category at right. + </para> + + <para> + Clicking on the <guibutton>Categories</guibutton> button opens up the category + list. To associate a category to an appointment, simply click the check box. + </para> + <para> + Once you've selected your categories, click <guibutton>OK</guibutton> to + assign these categories to the appointment. The categories you selected are now + listed in the text box to the right of the <guibutton>Categories...</guibutton> + button. + </para> + + <para> + The <guilabel>Recurrence</guilabel> tab lets you describe + repetition in appointments ranging from once every day up to once + every 100 years. You can then choose a time and date when the + appointment will stop recurring, and, under + <guilabel>Exceptions</guilabel>, pick individual days when the + appointment will <emphasis>not</emphasis> recur. Make your + selections from left to right, and you'll form a sentence: + "Every two weeks on Monday and Friday until January 3, 2003" + or "Every month on the first Friday for 12 occurrences." + </para> + + <para> + Once you're done with all those settings, click on the disk + icon in the toolbar to save and close the appointment editor window. + If you want, you can alter an appointment + summary in the calendar view by clicking on it and typing. You + can change other settings by right-clicking on the appointment then + choosing <guimenuitem>Edit this Appointment</guimenuitem>. + </para> + </sect2> + <sect2 id="usage-calendar-rsvp"> + <title>Sending an RSVP with the Calendar</title> + <para> + <application>Evolution</application> can be used to schedule + group meetings and help you manage responses to meeting + requests. + </para> + <para> + When you create a meeting or group appointment, you can + specify the attendees in several categories, such as "chair" + or "required." When you save the appointment listing, each + attendee will be sent an email with the appointment + information and gives them the option to respond. + </para> + + <note id="meeting-announce"> + <title>Simple Announcements</title> + <para> + If you don't need to collect attendance information when + you're scheduling an event, and would rather just announce + it, select + <menuchoice><guimenu>Actions</guimenu><guimenuitem>Forward + as iCalendar</guimenuitem></menuchoice>. That will open a + new email message with the event notification attached as + an announcement. Recipients will be able to add the event + to their calendars with one click, but won't automatically + send you email about whether they'll attend. + </para> + </note> + + <para> + To schedule a meeting: + <orderedlist numeration="arabic"> + <listitem> + <para> + Select + <menuchoice> + <guimenu>Actions</guimenu> <guimenuitem>Schedule + Meeting</guimenuitem> </menuchoice>. The + <guilabel>Scheduling</guilabel> and + <guilabel>Meeting</guilabel> tabs open. + </para> + </listitem> + <listitem> + <para> + If you have multiple Evolution identities, choose the + one you'll use by selecting an item in the + <guilabel>Sent By</guilabel> field. + </para> + </listitem> + <listitem> + <para> + Click the space labelled <guilabel>Click here to add an + attendee</guilabel> to enter the names and email + addresses of people you will invite, or click the + <guibutton>Invite Others</guibutton> to select them from + your addressbook. + </para> + </listitem> + <listitem> + <para> + Save the Appointment. + </para> + </listitem> + </orderedlist> + An email is now sent out to all the recipients, inviting them to your event. + </para> + </sect2> + <sect2 id="replying-to-rsvp"> + <title>Replying to a Meeting Request</title> + <para> + Meeting requests are sent as iCal attachments. To view or + respond to one, click on the attachment icon and view it + inline in the mail window. All the details are shown about + the event including time and dates. Then you can choose how + to reply to the RSVP. Your choices are: + <itemizedlist> + <listitem> + <para> + Accept + </para> + </listitem> + <listitem> + <para> + Tentatively Accept + </para> + </listitem> + <listitem> + <para> + Decline + </para> + </listitem> + </itemizedlist> + Click <guibutton>OK</guibutton> and an email will be sent to + the organizer with your answer. The event will also be added + to your calendar if you accept. + </para> + </sect2> + + <sect2 id="recieving-rsvp-response"> + <title>Getting Responses to Meeting Requests</title> + <para> + Once you get a reply to your meeting invitation, you'll need + to view it inline in the email. Click the attachment and + select <guibutton>View Inline</guibutton>. At the bottom, you + can click <guibutton>OK</guibutton> to update your attendee + list. + </para> + </sect2> + +<!-- ############UNIMPLEMENTED FEATURES ################### + + <sect2 id="usage-calendar-apts-group"> + <title>Appointments for Groups</title> + <para> + You can use <application>Evolution</application> to mark a + meeting request on another person's calendar. To do it, click + <guibutton>New</guibutton> in the calendar toolbar, or select + <menuchoice> <guimenu>File</guimenu> + <guisubmenu>New</guisubmenu> + <guimenuitem>Appointment</guimenuitem> </menuchoice> to bring + up the <interface>new appointment</interface> window. Then + describe the appointment as you would any other. When you are + ready to send the invitation <guibutton>OK</guibutton> + <application>Evolution</application> will automatically send + email to each person on the request list, notifying of the + time and date of the meeting you have requested with them. In + addition, it will mark the appointment on your calendar and on + theirs as tentative, rather than a confirmed, appointment. + </para> + <para> + To mark a tentative appointment as confirmed, click once on the + appointment in the <interface>calendar view</interface> to select + it, and then choose <guimenuitem>Appointment + Properties</guimenuitem> from the <guimenu>Settings</guimenu> + menu. In the <interface>Appointment Properties</interface> dialog + window, click the "tentative" button to De-select the + appointment. + </para> + <para> + When your meeting attendees get the email inviting them to the + meeting, they'll be able to enter the information into their + calendars and let you know if they'll be able to attend; if + they use <application>Ximian Evolution</application> or + another iCal compliant mail client, they can do this with just + one click. When you get a response from them, it will include + an iCal attachment. Opening and accepting this attachment will + change the meeting data in your calendar to indicate that they + have responded to your invitation, and whether they will be in + attendance. + </para> + </sect2> + + + <sect2 id="usage-calendar-apts-privs"> + <title>Scheduling privileges</title> + <para> + There are several levels of scheduling privileges. You + can set whether people can see your calendar, whether they + can request meetings or appointments, and whether they can + create appointments. This section may have to be deleted, + because I don't know if we are going to support privileges + at all. + </para> + </sect2> + ########## END UNIMPLEMENTED FEATURESET ############ --> + <sect2 id="usage-calendar-freebusy"> + <title>The Free/Busy View</title> + <para> + <application>Evolution</application> has a Free/Busy window so + that you can view people's schedules together to help you + schedule appointments. Read <xref linkend="full-advantage"> to + learn about how to use this feature with the Ximian Connector + for Microsoft Exchange. + </para> + <para> + To access the free/busy view: + <orderedlist numeration="arabic"> + <listitem> + <para> + Open or create an appointment in the + <guilabel>Calendar</guilabel> window. + </para> + </listitem> + <listitem> + <para> + Click + <menuchoice> + <guimenu>Actions</guimenu> + <guimenuitem>Schedule Meeting</guimenuitem> + </menuchoice> + </para> + </listitem> + <listitem> + <para> + Open the <guilabel>Scheduling</guilabel> tab. + </para> + </listitem> + </orderedlist> + </para> + <figure> + <title>Appointment Scheduing Window</title> + <screenshot> + <screeninfo>Appointment Scheduling Window</screeninfo> + <mediaobject><imageobject> + <imagedata format="png" fileref="figures/freebusy" + srccredit="Kevin Breit"> + </imageobject></mediaobject> + </screenshot> + </figure> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="figures/full-1" format="png"> + </imageobject> + </inlinemediaobject> + <guilabel>Invitee List</guilabel> + </para> + <para> + The <guilabel>Invitee List</guilabel> lists off the people who + have been invited to the respective appointment. It also + shows their RSVP status. + </para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="figures/full-2" format="png"> + </imageobject> + </inlinemediaobject> + <guilabel>Schedule Grid</guilabel> + </para> + <para> + The <guilabel>Schedule Grid</guilabel> shows the invitee's + published Free/Busy information. This is where you compare + people's schedules to find free time to schedule the + appointment. + </para> + <para> + <inlinemediaobject> + <imageobject> + <imagedata fileref="figures/full-3" format="png"> + </imageobject> + </inlinemediaobject> + <guilabel>Meeting Scheduler</guilabel> + </para> + <para> + The <guilabel>Meeting Scheduler</guilabel> allows you to + schedule the meeting in the <guilabel>Free/Busy</guilabel> window. + </para> + <sect3 id="usage-calendar-freebusy-scheduling"> + <title>Scheduling an Appointment</title> + <para> + To schedule an appointment, you'll first need people's + free/busy information. If you're using the Ximian Connector + for Microsoft Exchange, all of the information is already + available to you in the Global Address List. Otherwise, each + person will have to email you their schedule files and you + will have to incorporate them into your calendar. + </para> + <para> + Regardless of how you get the information, Ximian Evolution + will display it in the <guilabel>Scheduling</guilabel> tab. + The pending appointment time will appear in white with bold + black borders. Each attendee's free and busy times appear + color-coded next to their names in the attendee list. + </para> + <para> + Adjust the meeting time, either by dragging the meeting + borders or by using the <guilabel>Autopick</guilabel> + buttons to choose a time automatically, then click + <guibutton>Save and Close</guibutton>. Attendees on an + Exchange server will have the appointment updated + automatically; others will receive email notification of any + change in plans. + </para> + </sect3> + </sect2> + </sect1> + + <sect1 id="usage-calendar-todo"> + <title>The Task Pad</title> + <para> + The Task Pad, located in the lower right corner of the + calendar, lets you keep a list of tasks separate from your + calendar appointments. You can use the list + in a larger window by choosing the <guibutton>Tasks</guibutton> + button in the shortcut bar or in the folder tree. + </para> + <para> + To record a new task, click the <guibutton>Add</guibutton> + button in the toolbar. <application>Evolution</application> + will pop up a small window with five items in it: + + <variablelist> + <varlistentry> + <term> <guilabel>Summary:</guilabel></term> + <listitem> + <para> + The description you enter here will appear in the To Do + list itself. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> <guilabel>Due Date:</guilabel></term> + <listitem> + <para> + Decide when this item is + due. You can either type in a date and time, or select one from + the <guibutton>Calendar</guibutton> and time drop-down menus. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Start Date:</guilabel></term> + <listitem> + <para> + The date you intend to start working. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> <guilabel>Description:</guilabel></term> + <listitem> + <para> + If you wish, you can keep a more detailed description of + the item here. For example, you can note that a task is + in progress, and display how close it is to completion. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Classification:</guilabel></term> + <listitem> + <para> + Sets who will see it if your calendar is shared. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + There are more options in the <guilabel>Details</guilabel> tab such as priority and progress settings. + </para> + <para> + Once you've added a task to your to-do list, its summary + appears in the <guilabel>Summary</guilabel> section of task + list. To view or edit a detailed description of an item, + double-click on it, or right click on it and select <guibutton>Open</guibutton>. You can delete items by selecting + them and clicking on the <guibutton>Delete</guibutton> button. + </para> + <para> + The list of tasks is sorted in a similar way to the list of + email messages in <application>Ximian Evolution + Mail</application>. Click once on the message headers to change + the direction and type of sorting, or right-click to add or + remove columns from the display. + </para> + <sect2 id="task-folders"> + <title>Folders for Your Tasks</title> + <para> + Like any other component in + <application>Evolution</application>, you can create a folder + to help organize your tasks. To do this: + <orderedlist numeration="arabic"> + <listitem> + <para> + Open the <guilabel>Folders Bar</guilabel>. + </para> + </listitem> + <listitem> + <para> + Click <guibutton>Tasks</guibutton>. + </para> + </listitem> + <listitem> + <para> + Right click on <guibutton>Tasks</guibutton>. + </para> + </listitem> + <listitem> + <para> + Click <menuchoice><guimenuitem>Create New Folder</guimenuitem></menuchoice>. + </para> + </listitem> + <listitem> + <para> + Enter the folder name. + </para> + </listitem> + <listitem> + <para> + Click <guibutton>OK</guibutton> + </para> + </listitem> + </orderedlist> + </para> + </sect2> + </sect1> + + <sect1 id="usage-calendar-multiple"> + <title>Multiple Calendars</title> + <para> + <application>Evolution</application> permits you to have and + maintain multiple calendars. This is useful if you maintain + schedules for other people, if you are responsible for resource + or room allocation, or if you have multiple personalities. + </para> + + <example> + <title>Keeping Multiple Calendars</title> + <para> + Lucy, the office manager for a small company, has one calendar + for her own schedule. She maintains one for the conference + room, to schedule meetings. Next to that, she maintains a + calendar that reflects when consultants are going to be on + site, and another that keeps track of when the Cubs are + playing. + </para> + </example> + <para> + To create a new calendar, select + <menuchoice> + <guimenu>File</guimenu> <guisubmenu>New</guisubmenu> + <guimenuitem>Folder</guimenuitem> + </menuchoice>. + You'll need to tell the <guilabel>New Folder</guilabel> dialog that the new folder should be of the calendar type. You can place the calendar in any calendar folder and access it + from the folder view. + </para> + <para> + Each calendar folder can hold only one calendar. + </para> + </sect1> +</chapter> diff --git a/help/C/usage-contact.sgml b/help/C/usage-contact.sgml new file mode 100644 index 0000000000..aff3da93fe --- /dev/null +++ b/help/C/usage-contact.sgml @@ -0,0 +1,617 @@ +<!-- +<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> +--> +<chapter id="usage-contact"> + <title>Working with Your Contacts</title> + <para> + This chapter will show you how to use the + <application>Evolution</application> addressbook to organize + any amount of contact information, share addresses over a + network, and several ways to save time with everyday tasks. To + learn about configuring the addressbook, see <xref + linkend="config-prefs-contact">. You can import contacts from + other contact management tools with the Import tool by + selecting + <menuchoice><guimenu>File</guimenu><guimenuitem>Import</guimenuitem></menuchoice>, + or by mailing them to yourself as vCard attachments. + </para> + + <para> + The toolbar for the addressbook is quite simple. + <itemizedlist> + <listitem><para> + Click <guibutton>New Contact</guibutton> to create a new card, or double-click + in a blank space in the contact list. + </para></listitem> + + <listitem><para> + Click <guibutton>New List</guibutton> to create a new card, or double-click + in a blank space in the contact list. + </para></listitem> + + <listitem><para> The <guiicon>printer</guiicon> icon sends one + or more of your cards to the printer. </para></listitem> + + <listitem><para> The <guiicon>stop sign</guiicon> icon stops loading + contact data from the network. This button is only + relevant if you are looking at contact information on a + network. </para></listitem> + </itemizedlist> + </para> + + <para> + Your contact information fills the rest of the display. Move + through the cards alphabetically with the buttons and the + scrollbar to the right of the window. Of course, if you have + more than a few people listed, you'll want some way of finding + them more quickly, which is why there's a search feature. + </para> + + <sect1 id="usage-contact-cards"> + <title>The Contact Editor</title> + <para> + To delete a contact: + <orderedlist numeration="arabic"> + <listitem> + <para> + Click once on the contact. + </para> + </listitem> + <listitem> + <para> + Press the <guibutton>Delete</guibutton> button. + </para> + </listitem> + </orderedlist> + </para> + <para> + If you want to add or change cards, you'll use the contact + editor. To change a card that already exists, double click on + it to open the contact editor window. If you want to create a new + card, clicking the <guibutton>New</guibutton> button in the + toolbar will open the same window, with blank entry boxes for + you to fill in. + </para> + + <para> + The contact editor window has two tabs, + <guilabel>General</guilabel>, for basic contact information, and + <guilabel>Details</guilabel>, for a more specific description of + the person. In addition, it contains a <guimenu>File</guimenu> + menu and a toolbar with three items: <guilabel>Save and + Close</guilabel>, <guilabel>Print</guilabel>, and + <guilabel>Delete</guilabel>. + </para> + + <figure id="usage-contact-editor-fig"> + <title>Evolution Contact Editor</title> + <screenshot> + <screeninfo>Evolution Contact Editor</screeninfo> + <mediaobject><imageobject><imagedata + fileref="figures/contact-editor" format="png" srccredit="Aaron + Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> + + <para> The <guilabel>General</guilabel> tab has seven sections, + each with an icon: a face, for name and company; a telephone + for phone numbers; an envelope for email address; a globe for + web page address; a house for postal address; a file folder + for contacts, and a briefcase for categories. + </para> + <para> + <variablelist> + + <varlistentry> + <term>Full Name</term> + <listitem> + <para> + The <guilabel>Full Name</guilabel> field has two + major features: + <itemizedlist> + <listitem> + <para> + You can enter a name into the <guibutton>Full + Name</guibutton> field, but you can also click the + <guibutton>Full Name</guibutton> button to bring + up a small dialog box with a few text boxes + <variablelist> + <varlistentry> + <term><guilabel>Title: </guilabel></term> + <listitem> <para> + Enter an honorific or select one from the menu. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guilabel>First: </guilabel></term> + <listitem> <para> + Enter the first, or given, name. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Middle: </guilabel></term> + <listitem> <para> + Enter the middle name or initial, if any. + </para></listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Last: </guilabel></term> + <listitem> <para> + Enter the last name (surname). + </para></listitem> + </varlistentry> + <varlistentry> + <term><guilabel>Suffix: </guilabel></term> + <listitem> <para> + Enter suffixes such as "Jr." or "III." + </para></listitem> + </varlistentry> + </variablelist> + </para> + </listitem> + </itemizedlist> + </para> + <para> + The <guilabel>Full Name</guilabel> field also + interacts with the <guilabel>File As</guilabel> + box to help you organize your contacts. + </para> + <para> + To see how it works, type a name in the + <guilabel>Full Name</guilabel> field. As an example, + we'll use the Ximian mascot, <userinput>Rupert + T. Monkey</userinput>. You'll notice that the + <guilabel>File As</guilabel> field also fills in, + but in reverse: <computeroutput>Monkey, + Rupert</computeroutput>. You can pick + <computeroutput>Rupert Monkey </computeroutput> from + the drop-down, or type in your own, such as + <userinput> T. Rupert Monkey </userinput>. + </para> + <tip> + <title>Filing Suggestion</title> + <para> + Don't enter something entirely different from the + actual name, since you might forget that you've filed + Rupert's information under "F" for "Fictitious Ximian + Employee." + </para> + </tip> + </listitem> + </varlistentry> + <varlistentry> + <term>Multiple Values for Fields:</term> + <listitem> + <para> + If you click on the downward pointing triangle buttons + next to the <guilabel>Primary Email</guilabel> field, + you can also choose <guilabel>Email 2</guilabel> and + <guilabel>Email 3</guilabel>. Although the contact + editor will only display one of those at any given + time, <application>Evolution</application> will store + them all. Entries that have information in them have + a check mark next to them. The buttons next to the + telephone and postal address fields work in the same + way. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + The last item in the <guilabel>General</guilabel> tab is the + <guilabel>Categories</guilabel> organization tool; for + information on that, read <xref + linkend="usage-contact-organize">. + </para> + <para> + The <guilabel>Details</guilabel> tab is much simpler: + <itemizedlist> + <listitem> + <para> + The briefcase - Describes the person's professional life + </para> + </listitem> + <listitem> + <para> + The face - Describes the person's personal life + </para> + </listitem> + <listitem> + <para> + The globe - Miscellanious notes + </para> + </listitem> + </itemizedlist> + + <tip> + <title>Contact Shortcuts</title> + <para> + You can add cards from within an email message or calendar + appointment. While looking at an email, right-click on + any email address or message, and choose + <guimenuitem>Create Card for this Address</guimenuitem> or + <guimenuitem>Create Card for this Sender</guimenuitem> + from the menu. + </para> + </tip> + </para> + </sect1> + + <sect1 id="contact-search"> + <title>Searching for Contacts</title> + <para> + <application>Evolution</application> allows searching through contacts + quickly and easily. + </para> + <para> + To search through contacts: + <orderedlist numeration="arabic"> + <listitem> + <para> + Select your search focus in the search bar. + </para> + </listitem> + <listitem> + <para> + Enter your query. + </para> + </listitem> + <listitem> + <para> + Press return to search. + </para> + </listitem> + </orderedlist> + </para> + <para> + You can refine searches by doing several in + succession, or start over by pressing the <guibutton>Show + All</guibutton> button. + </para> + <para> + If there are no matches, the card display will be + blank. When you'd like to see all the cards again, press + <guilabel>Show All</guilabel>. + </para> + <example id="contact-quicksearch-ex"> + <title>Refining a Quick Search</title> + <para> + Tom comes back from lunch and finds a note on his + keyboard: "Curtis in sales called for you, but he didn't + leave a number, and I forgot to write down the name of the + company he works for. He said it was important, though." + Tom is not at all annoyed. + </para> + <para> + He opens his contacts folder, and runs a quick search for + "Curtis." There are eighteen different people with that name + in the file. He then enters "Sales," and + <application>Evolution</application> narrows it down to the + right Curtis. He only becomes annoyed when he discovers that + the call was not actually important. + </para> + </example> + + <para> + To perform a complex search through your contacts: + <orderedlist numeration="arabic"> + <listitem> + <para> + Open + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Search for contacts</guimenuitem> + </menuchoice> + </para> + </listitem> + <listitem> + <para> + Name the rule in the <guilabel>Rule Name</guilabel> field. + </para> + </listitem> + <listitem> + <para> + Setup your criteria information in the <guilabel>If</guilabel> section. + </para> + </listitem> + <listitem> + <para> + If you want to add more critera, click the <guibutton>Add + Criterion</guibutton> button. + </para> + </listitem> + <listitem> + <para> + Click <guibutton>Search</guibutton>. + </para> + </listitem> + </orderedlist> + </para> + <para> + To show all your contacts, select <guibutton>Show All</guibutton> in the + <guilabel>Search Bar</guilabel> or search with an empty query. + </para> + + </sect1> + + <sect1 id="usage-contact-organize"> + <title>Organizing your Addressbook</title> + <para> + Organizing your addressbook is a lot like organizing your + mail. You can have folders and searches the same way you can + with mail, but the addressbook does not allow Virtual Folders. It + does, however, allow each card to fall under several + categories, and allow you to create your own categories. To + learn about categories, read <xref + linkend="usage-contact-organize-group-category">. + </para> + +<!-- UNIMPLEMENTED FEATURE + <para> + Another useful <application>Evolution</application> feature is + its ability to recognize when people live or work together. If + several people in your addressbook share an address, and you + change the address for one of them, + <application>Evolution</application> will ask you if you wish to + change the address for all of them, or just for one. + </para> +--> + + <sect2 id="usage-contact-organize-group"> + <title>Groups of contacts</title> + <para> + <application>Evolution</application> offers two ways for you + to organize your cards. The first way is to use folders; + this works the same way mail folders do. For more + flexibility, you can also mark contacts as elements of + different categories. To better integrate with email tools, + you can also create lists of contacts that you can send mail + to as a single person. + </para> + + <sect3 id="usage-contact-organize-group-folder"> + <title>Grouping with Folders</title> + <para> + The simplest way to group address cards is to use folders. + By default, cards start in the + <guilabel>Contacts</guilabel> folder. If you've read <xref + linkend="usage-mainwindow"> then you already know that you + can create a new folder by selecting + <menuchoice> + <guimenu>File</guimenu> + <guisubmenu>New</guisubmenu> + <guimenuitem>Folder</guimenuitem> + </menuchoice> + and that you can put new folders anywhere you like. Just + like with mail, cards must be in a card folder, and no card + can be in two places at once. If you want more + flexibility, try <xref + linkend="usage-contact-organize-group-category">. + </para> + <para> + To put a card into a folder, just drag it there from the + folder view. Remember that contact cards can only go in + contact folders, just like mail can only go in mail folders, + and calendars in calendar folders. + </para> + </sect3> + + <sect3 id="usage-contact-organize-group-category"> + <title>Grouping with Categories</title> + <para> + The other way to group cards is to mark them as belonging + to different categories. + That means that you + can mark a card as being in several categories or no + category at all. For example, I put my friend Matthew's + card in the "Business" category, because he works with me, + the "Friends" category, because he's also my friend, and + the "Frequent" category, because I call him all the time + and can never remember his phone number. + </para> + <para> + To mark a card as belonging to a category, click the + <guibutton>Categories</guibutton> button at the lower + right. From the dialog box that appears, you can check as + many or as few categories as you like. + </para> + + <!-- Feature Not Implemented + <para> + + If the master list of categories doesn't suit you, you can + add your own. Just enter the new category's name in the + text box, then click <guibutton>Categories</guibutton> and + choose <guilabel>Add to Master List</guilabel> in the + window that appears. + </para> + --> + + </sect3> + + <sect3 id="usage-contact-organize-group-list"> + <title>Creating a List of Contacts</title> + <para> + To create a list of contacts: + + <orderedlist numeration="arabic"> + <listitem> + <para> + Open the list creation dialog box by clicking the + <guibutton>New List</guibutton> button or selecting + <menuchoice> + <guimenu> + File + </guimenu> + <guisubmenu> + New + </guisubmenu> + <guimenuitem> + Contact List + </guimenuitem> + </menuchoice>. + </para> + </listitem> + + <listitem> + <para> + Enter a name for the list. + </para> + </listitem> + <listitem> + <para> + Enter names or email addresses of contacts, or just + drag contacts from the main window into the list. + </para> + </listitem> + + <listitem> + <para> + Choose whether you would like to hide the email + addresses when you send a message to the list. + Unless it is a very small list, it is recommended + that you leave the addresses hidden. This is the + same thing as using the "Bcc:" feature discussed in + <xref linkend="usage-mail-getnsend-send-to-types">. + </para> + </listitem> + + </orderedlist> + </para> + <para> + When you are done, click <guibutton>OK</guibutton>. The + list will appear as a contact card, which you can use as + you would any other. That includes emailing the list to + another person, and, of course, sending email to the list. + </para> + <para> + To mail the list, open a new email and type the name you + chose for the list. Ximian Evolution will address the + message to the entire list when you send it. You can also + right-click on the list's address card in the Addressbook + and select <guimenuitem>Send Message to List</guimenuitem>. + </para> + </sect3> + + + </sect2> + </sect1> + +<!-- we need a LDAP server up for me to test this --> + <sect1 id="usage-contact-sharing"> + <title>Sharing your Cards</title> + <para> + The <glossterm linkend="ldap">LDAP</glossterm> protocol was + created to let users share contact information over a network. + LDAP allows for users to browse other people's addressbooks, or + maintain a shared set of contact information for a company or + department. This feature comes in handy if you are in a group + where there are lots of people using the same contacts. Such an + example would be the sales department of a company with their + client list. + </para> + + <example id="usage-contact-sharing-ex"> + <title>Sharing Address Cards and Calendar Data</title> + <para> + Rich wants to schedule a meeting with Company X, so he + checks the network for the Company X address card so he + knows whom to call there. Since his company also shares + calendars, he then learns that his co-worker Deanna has + already scheduled a meeting with Company X next Thursday. + He can either go to the meeting himself or ask Deanna to + discuss his concerns for him. Either way, he avoids + scheduling an extra meeting with Company X. + </para> + </example> + + <para> + Of course, you don't want to share all of your cards— why + overload the network with a list of babysitters or tell + everyone in the office you're talking to new job prospects? If + you keep cards on your own computer, you can decide which items + you want to make accessible to others. + </para> + <para> + To learn how to add a remote directory to your available + contact folders, see <xref linkend="config-prefs-contact">. + Once you have a LDAP connection, the network contacts folder or + folders will appear inside the <guilabel>External + Directories</guilabel> folder in the folder bar. It will work + exactly like a local folder of cards, with the following + exceptions: + <itemizedlist> + + <listitem> + <para> + Network folders are only available when you are + connected to the network. If you use a laptop or have a + modem connection, you may wish to copy or cache the + network directory. You do this by dragging and dropping + your desired contacts into the local contacts list. + </para> + </listitem> + + <listitem> + <para> + To prevent excess network traffic, + <application>Evolution</application> will not normally + load the contents of LDAP folders immediately upon + opening. You must click <guilabel>Display + All</guilabel> before LDAP folder cards will be loaded + from the network. You can change this behavior in the + <interface>Contact Preferences</interface> window. + </para> + </listitem> + <listitem> + <para> + Your ability to view, change, add, and delete contacts + depends on the settings of the LDAP server. + </para> + </listitem> + </itemizedlist> + </para> + <sect2 id="usage-contact-sharing-setup"> + <title>Configuring Evolution to use LDAP</title> + <para> + For information about setting up + <application>Evolution</application> to use LDAP, please refer + to <xref linkend="config-prefs-contact-ldap-add" /> + </para> + </sect2> + </sect1> + + <sect1 id="contact-automation-basic"> + <title>Send me a Card: Adding New Cards Quickly</title> + <para> + As noted before, when you get information about a person in + the mail or in a calendar entry, you can add it to an address + card. To do so, right click on any email address or email + message, and select <guimenuitem>Add Address + Card</guimenuitem> from the menu that appears. + <application> Evolution</application> can also add cards from a + hand-held device during HotSync operation. For more + information about that, see <xref linkend="usage-sync">. + </para> + </sect1> + +<!-- Unimplemented features: + <para> + You can also use the addressbook to print postal addresses + on mailing labels. Future versions of + <application>Evolution</application> will allow you to you + export a group of cards to a spreadsheet, database, or word + processor so you can print address labels or prepare large + mailings. + </para> + <para> + Need a map or directions? Click <guibutton>MapIt</guibutton> from + within the addressbook, and <application>Evolution</application> + will map the address for you online. + </para> + --> +</chapter> + + diff --git a/help/C/usage-exchange.sgml b/help/C/usage-exchange.sgml new file mode 100644 index 0000000000..b87aee9cdc --- /dev/null +++ b/help/C/usage-exchange.sgml @@ -0,0 +1,710 @@ + <chapter id="usage-exchange"> + <title>The Ximian Connector for Microsoft Exchange</title> + <para> + The Ximian Connector for Microsoft Exchange allows Ximian + Evolution clients to access accounts on Microsoft Exchange 2000 + servers. It is available through Ximian Red Carpet in its own + channel, but cannot be used without a license file. The license + file may be purchased from the Ximian online store at <ulink + url="http://store.ximian.com">store.ximian.com</ulink>. Unlike the + regular Ximian Evolution client, the Ximian Connector for + Microsoft Exchange is proprietary software and source code is not + available. + </para> + <para> + The Ximian Connector offers a significant price advantage over + other Exchange access methods for Linux and UNIX systems: + <variablelist> + + <varlistentry> + <term>Dual Computer Installation:</term> + <listitem> + <para> + The purchase of a second computer for each client imposes + a very heavy expense burden and is exceptionally + inconvenient. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Dual Boot or Virtual Machine:</term> + <listitem> + <para> + Installation of multiple operating systems in a dual boot + or virtual machine configuration (such as VMWare) also + increases licensing and administration costs. Users + often complain that such a system is inconvenient, slow, + and not integrated with the rest of their operating + system. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Outlook Web Access:</term> + <listitem> + <para> + Outlook Web Access is a web interface for Exchange + servers, but works best in Microsoft Internet Explorer. + Outlook Web Access also is + not integrated with the rest of the host operating system + and offers only limited groupware functionality. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + The Ximian Connector offers a low cost, fully integrated, option + for Exchange 2000 server access in heterogeneous client + networks. This chapter will explain how to install, configure, and + use it. + </para> + <warning id="licensing"> + <title>Exchange Client Licenses</title> + <para> + Each user will need a valid Microsoft <application>Exchange</application>2000 server + account and license. + </para> + </warning> + + <sect1 id="features"> + <title>Connector Features</title> + <para> + <application>Ximian Connector</application> supports the most + often used features of <application>Microsoft + Exchange</application>: + <itemizedlist> + <listitem> + <para> + General + </para> + <variablelist> + <varlistentry> + <term>Remote <application>Exchange</application> Information Store</term> + <listitem> + <para> + Allows you to access mail, address book (including + Global Address List folder), and calendars, and task + folders on an <application>Exchange + 2000</application> server from + <application>Evolution</application>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Palm synchronization</term> + <listitem> + <para> + Supported for Contacts and Calendars on Exchange. + </para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + <listitem> + <para> + Mail + </para> + <variablelist> + <varlistentry> + <term>Viewing Mail in <application>Exchange</application>Folder</term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term>Sending Email via Exchange Protocols</term> + <listitem> + <para> + You may use the Microsoft Exchange mail transport + protocol to send email. Make sure that the address + you have entered as your email address is exactly + the one that the Exchange server has on file. This + may be "yourname@exchange-server.ximian.com" rather + than "yourname@ximian.com.a" + </para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + <listitem> + <para> + Calendar + </para> + <variablelist> + <varlistentry> + <term>Meeting Request/Proposal</term> + <listitem> + <para> + Allows <application>Evolution</application> users to + schedule meetings and view attendee availability for + other users (<application>Evolution</application> or + <application>Outlook</application> users) on + <application>Exchange</application>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Adding iCalendar Meeting Requests to Calendar</term> + <listitem> + <para> + If you receive an iCalendar meeting request and add it + to your calendar, it will be saved to your + <application>Exchange</application> calendar. + </para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + <listitem> + <para> + Contacts + </para> + <variablelist> + <varlistentry> + <term>Address Completion</term> + <listitem> + <para> + Supported for your <application>Exchange</application> + Contacts folder. Not yet supported for the Global + Address List. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Adding vCards to Address Book</term> + <listitem> + <para> + If you receive a vCard attachment and click + <guibutton>Save in Address Book</guibutton>, it will + be saved to your <application>Exchange</application>address book. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>New Address Book entries can be created on + <application>Exchange</application> from received email + messages with a single click</term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </listitem> +</itemizedlist> +</para> + +<para> +There are, however, some features which are not available: +<itemizedlist> + + <listitem> + <para> + Access to shared and public folders is not + available, although the Global Address List is + available. + </para> + </listitem> + <listitem> + <para> + Journal and Notes components are not available. + </para> + </listitem> + <listitem> + <para> + Work Offline (disconnected mode) support is not functional. + </para> + </listitem> + <listitem> + <para> + "Recall Message" function does not work yet. + </para> + </listitem> + + <listitem> + <para> + Creation of an automatic "out-of-office" reply messages + is not available. + </para> + </listitem> + + </itemizedlist> + </para> + </sect1> + <sect1 id="install"> + <title>Installing the Connector</title> + <para> + To install the Ximian Connector, run Ximian Red Carpet by + selecting <menuchoice><guimenu>System</guimenu><guimenuitem>Get + Software</guimenuitem></menuchoice>. Subscribe to the Ximian + Connector for Microsoft Exchange channel, select the Ximian + Connector for Microsoft + <application>Exchange</application>2000, and click the + <guibutton>Install</guibutton> button. You can also install + the Connector by downloading the individual packages from + ftp.ximian.com if you wish. + </para> + <para> + Once you have installed the software, you will also need to + install a license file. The license file is the verification + that you have paid for a license to use the Ximian + Connector. You can get the license file from the the Ximian + online store at <ulink + url="http://store.ximian.com">store.ximian.com</ulink>. You + will need a browser with strong (128-bit or greater) encryption + to access the store. When you purchase a Ximian Connector + license, the store will mail you the license file with + instructions for installation. Once installed, the license file + unlocks the Ximian Connector functionality and you may connect + to an <application>Exchange</application>server. + </para> + </sect1> + + <sect1 id="configure"> + <title>Configuration</title> + <para> + Once you have installed the Connector, you need to set up access + for your <application>Exchange</application>account on both the + <application>Exchange</application>server and within Evolution. + </para> + + <sect2 id="config-server"> + <title>Exchange Server Configuration</title> + <para> + Check with your system administrator to ensure that: + <itemizedlist> + <listitem> + <para> + You have a valid account on the <application>Exchange</application>server. + </para> + </listitem> + <listitem> + <para> You are permitted to access the account with + WebDAV. This is the default setting for the + <application>Exchange</application>server, so unless + your system administrator has specifically turned it + off, no changes should be necessary. + </para> + </listitem> + </itemizedlist> + </para> + <para> + The Ximian website knowledge base, at <ulink type="http" + url="http://support.ximian.com">support.ximian.com</ulink>, + has additional information about checking to make sure that + your <application>Exchange</application>server will accept + connections from Ximian Evolution. + </para> + </sect2> + + <sect2 id="config-client"> + <title>Evolution Settings for Connecting to an <application>Exchange</application>Server</title> + <para> + + Once you know that your server is ready for you to connect, start + Ximian Evolution and select + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Mail Settings</guimenuitem> + </menuchoice> + from any mail view. + </para> + <sect3 id="config-exchange-new-account"> + <title>Creating a New Exchange Account</title> + + + <para> + If you would like to create a new account for your Exchange + server, click the <guibutton>Add</guibutton> button in the + accounts list. The account creation assistant will guide you + through the process, which is also described in <xref + linkend="usage-mainwindow-starting">. If you're not sure + about any of the information you need, just ask your system + administrator. + </para> + <variablelist> + <varlistentry> + <term>Identity</term> + <listitem> + <para>Enter your name and email address. If you wish, + you may add your organization and the location of your + signature file. Only your name and email address are + required. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Receiving Mail</term> + <listitem> + <para> + In this step, you'll enter information about the way + you check mail: + <orderedlist> + <listitem> + <para> + First, select <guilabel>Microsoft + Exchange</guilabel> as your server type. + </para> + </listitem> + <listitem> + <para> + Enter the name of your Exchange email server, and + the user name you would use to log in to a + Windows workstation in your organization. + </para> + </listitem> + <listitem> + <para> + If you wish, select the box labelled + <guilabel>Use secure connection + (SSL)</guilabel>, to take advantage of a more + secure connection method. This may allow you to + connect to the server from outside your + firewall. + </para> + </listitem> + <listitem> + <para> + If you would like + <application>Evolution</application> to + remember your password, check the box labelled + <guilabel>Remember this password</guilabel>. + </para> + </listitem> + </orderedlist> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Receiving Mail, Step Two</term> + <listitem> + <para>There are a few additional options in this step: + <orderedlist> + <listitem> + <para> + Checking for New Mail: If you would like to + check for new mail automatically, click the + checkbox and enter an interval in minutes. + </para> + </listitem> + <listitem> + <para> + Exchange Server: If your Exchange mailbox name + is different from your Windows name, enter your + mailbox name here. + </para> + </listitem> + <listitem> + <para> + Active Directory: If you would like to use the + Global Address List (GAL), check the box + labelled <guilabel>Create a Global Address + List folder</guilabel> and enter the name + of the directory server. To avoid strain + on the server, the maximum number of + responses to any Active Directory query has + been set to 500. If you would like to + change that, you may do so here as well. + </para> + </listitem> + </orderedlist> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Sending Mail</term> + <listitem> + <para>Select <guilabel>Microsoft Exchange</guilabel> as + your email sending method. There is nothing else to do + in this step.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Account Management</term> + <listitem> + <para>Enter a name that you will use to remember this + account. "Exchange Account" is a good suggestion. Note + that you cannot have two accounts with the same name. + If you'd like to make this your default account for + sending email, check the <guilabel>Make this my default + account</guilabel> box.</para> + </listitem> + </varlistentry> + </variablelist> + <para> + You're done. Click <guibutton>Finish</guibutton> and + <guibutton>OK</guibutton>, then quit + <application>Evolution</application> and start it again. Now + you're ready to get to work on the Exchange server. + </para> + + <figure> + <title>Creating an Exchange Account, Step One: Identity</title> + <screenshot> + <screeninfo>Creating an Exchange Account, Step One: Identity</screeninfo> + <mediaobject><imageobject> + <imagedata format="png" fileref="figures/exchange-identity" srccredit="Aaron Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> + + <figure> + <title>Creating an Exchange Account, Step Two: Receiving Mail</title> + <screenshot> + <screeninfo>Creating an Exchange Account, Step Two: Receiving Mail</screeninfo> + <mediaobject><imageobject> + <imagedata format="png" fileref="figures/exchange-receive" srccredit="Aaron Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> + + <figure> + <title>Creating an Exchange Account, Step Three: Mail Options</title> + <screenshot> + <screeninfo>Creating an Exchange Account, Step Three: Mail Options</screeninfo> + <mediaobject><imageobject> + <imagedata format="png" fileref="figures/exchange-receive-options" srccredit="Aaron Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> + + + </sect3> + + <sect3 id="config-exchange-existing-account"> + <title>Changing an Existing Account to Work with Exchange</title> + <para> + If you have an existing email account, and want to convert it + to use for Exchange, select the account you want to convert + and click the <guibutton>Edit</guibutton> button. You'll want + to change settings in the following tabs of the account + dialog: + </para> + <variablelist> + <varlistentry> + <term>Identity</term> + <listitem> + <para> + If your email address will change because you are moving + to a new server, then change it in this tab. Otherwise, + move to the next tab. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Receiving Mail</term> + <listitem> + <para> + Select <guilabel>Microsoft Exchange</guilabel> as your + server type. Enter your name of your server next to + <guilabel>Host</guilabel>, and the user name for your + account next to <guilabel>Username</guilabel>. If your + server supports SSL (Secure Socket Layer) encryption, it + you can check the <guilabel>Use SSL</guilabel> box to + take advantage of more secure data transfers. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Receiving Options</term> + <listitem> + <para> + Here, tab, you'll find some additional settings: + <variablelist> + <varlistentry> + <term>Checking for New Mail</term> + <listitem> + <para> + Select whether you would like to check for + mail automatically, and if so, how often. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Exchange Server</term> + <listitem> + <para> + If your Exchange server requires you to use a + different mailbox name from the name you use to + log in, select the second check-box and enter + the mailbox name. Check with your system + administrator to be sure. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Active Directory</term> + <listitem> + <para> + If you would like to use the Global Address + List (GAL) maintained on your Exchange server, + click the tab labelled <guilabel>Receiving + Options</guilabel> and check the box labelled + <guilabel>Create a Global Address List + folder</guilabel>. The GAL is maintained by + your system administrator and you cannot add, + change, or remove items from it using Ximian + Evolution. However, you can use it to invite + people to meetings and to look up addresses and + other information. In many organizations, the + GAL is stored on a different server from email. + If this is the case, you should also specify + the directory server name here. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Sending Mail</term> + <listitem> + <para> + If you will use your Exchange server to send as well as + receive mail, select <guilabel>Microsoft + Exchange</guilabel> as your server type, and enter the + server name as the <guilabel>Host</guilabel>. + </para> + </listitem> + </varlistentry> + </variablelist> + <para> + + Once you have made those changes, click the + <guibutton>OK</guibutton> button. + </para> + <para> + Then, quit <application>Evolution</application> and start it + up again. Changes to the Ximian Connector accounts + configuration are not active until you have restarted the + application. + </para> + </sect3> + </sect2> + </sect1> + + <sect1 id="access"> + <title>Accessing the <application>Exchange</application>Server</title> + <para> + Like IMAP and LDAP data, information for + <application>Exchange</application>accounts is stored on the + server, not on your desktop computer. This means that you can + access it from multiple locations. It also means that your + Microsoft <application>Exchange</application>account information + is in a seperate folder tree from the <guilabel>Local</guilabel> + tree in your folder bar. You'll see it below the local tree, + with the name you gave the account. If you have multiple + accounts, you will have multiple folder trees. + </para> + <para> + Click on any of the folder tree items to visit them; you may + have to enter your server password. You can now create contact + cards, send and receive email as you would normally. If there + are items in your local calendar or addressbook that you'd like + to add to your <application>Exchange</application>stores, you + can copy and paste them over, or just drag items from one folder + to another as you would with two local stores. + </para> + + <note id="save-to-local-or-exchange"> + <title>Saving Attached Addresses and Appointments</title> + <para> + If you are using both an Exchange account and a local mail + account, you should be aware that whenever you save an email + address or appointment from an email message, it will be + saved in your Exchange contacts list or calendar, rather + than in your local account. The same is true of + synchronization with Palm-OS devices: tasks, appointments, + and addresses from your Palm-OS device will be synchronized + with those in the Exchange folders rather than local + folders. + </para> + </note> + + <tip id="gal-empty"> + <title>The Global Address List Is Empty At First</title> + <para> + To avoid unnecessary strain on the server, the GAL will + appear empty until you have searched for something in it. + If you want to display all the cards in the list, click in + the search box and press <keycap>Enter</keycap>. This + enters a blank search: since every card contains a blank in + it, every card will appear. + </para> + </tip> + </sect1> + <sect1 id="full-advantage"> + <title>Taking Full Advantage of the Exchange Server When Scheduling Appointments</title> + <para> + When you schedule a meeting with your calendar on the + <application>Exchange</application>server, you can check when + other local Exchange users are busy according to their + <application>Exchange</application>calendars. To do so: + </para> + <figure> + <title>Scheduling With Free/Busy Information</title> + <screenshot> + <screeninfo>Using the Free/Busy Feature</screeninfo> + <mediaobject><imageobject> + <imagedata format="png" fileref="figures/schedule" srccredit="Aaron Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> + + <orderedlist numeration="arabic"> + <listitem> + <para> + Open a new appointment in the calendar. + </para> + </listitem> + <listitem> + <para> Choose <menuchoice> <guimenu>Actions</guimenu> + <guimenuitem>Schedule Meeting</guimenuitem> + </menuchoice> in the meeting editor window. + </para> + </listitem> + <listitem> + <para> Add attendees, either by entering their email + addresses into the list, or by clicking the + <guibutton>Invite Others</guibutton> button. If you choose + to so, it's best to use the Global Address List (GAL). + Choose the GAL from the drop-down list of address sources + at the top of the dialog box. + </para> + </listitem> + <listitem> + <para> + Choose <guilabel>Options</guilabel> and then + <guilabel>Update Free/Busy</guilabel> to check participant + schedules and, if possible, update the meeting in all + participants' calendars. + </para> + </listitem> + </orderedlist> + <tip id="autopick"> + <title>Using Autopick to Adjust Meeting Times</title> + <para> + If meeting attendees are not available during the times you + have scheduled a meeting, you can "nudge" the meeting forward + or backward to the nearest available time. To do so, just + click the arrows to the left or right of the + <guilabel>Autopick</guilabel> button. The autopick tool will + move the meeting to the nearest time during which all + attendees are available. If you aren't satisfied with those + results, you can drag the edges of the meeting time to the + hours that you want to select. + </para> + </tip> + </sect1> +</chapter> + + diff --git a/help/C/usage-mail-org.sgml b/help/C/usage-mail-org.sgml index 16ab73902e..8dc4e13bcd 100644 --- a/help/C/usage-mail-org.sgml +++ b/help/C/usage-mail-org.sgml @@ -652,6 +652,29 @@ </listitem> </orderedlist> </para> + <note id="when-filters-go-wrong"> + <title>When Are Filters Applied?</title> + <para> + If you move mail from your server into your local system + using POP mail, filters are applied to incoming mail every + time you check for mail. + </para> + <para> + If you store your mail on the mail server and check your + mail with IMAP, filters are applied to the INBOX when you + open it. In some cases, you will see a number of unread + messages in the INBOX, click the INBOX, and then have the + messages move elsewhere as they are filtered out. + </para> + <para> + If you use Ximian Connector to store your mail on an + Exchange server, filters are not applied until you open + your INBOX folder and select + <menuchoice><guimenu>Actions</guimenu><guimenuitem>Apply + Filters</guimenuitem></menuchoice> or press + <keycombo><keycap>Ctrl</keycap><keycap>Y</keycap></keycombo> + </para> + </note> <example id="filter-example"> <title>Using a Filter to Avoid Spam</title> <para> @@ -780,9 +803,10 @@ <itemizedlist> <listitem> <para> - Incoming email that your filters don't move goes into the Inbox; - outgoing mail that they don't move ends up in the Sent - folder. So be sure to change the filters that go with it. + Incoming email that your filters don't move goes + into the Inbox; outgoing mail that they don't move + ends up in the Sent folder. So be sure to change + the filters that go with it. </para> </listitem> </itemizedlist> diff --git a/help/C/usage-mainwindow.sgml b/help/C/usage-mainwindow.sgml index 9be52d8115..b1494a1423 100644 --- a/help/C/usage-mainwindow.sgml +++ b/help/C/usage-mainwindow.sgml @@ -233,8 +233,8 @@ <listitem> <para>Whether you want to use a secure (SSL) - connection. This may allow you to access the - server from outside a firewall. + connection. If your server supports it, it's + best to enable this security option. </para> </listitem> @@ -313,9 +313,9 @@ </listitem> <listitem> - <para>Exchange Server: If your Echange mailbox name is is - different from your Windows user name, check this box and - enter your mailbox name here. + <para>Exchange Server: If your active directory user name + is different from your Exchange mailbox name, check this + box and enter your mailbox name here. </para> </listitem> @@ -469,18 +469,18 @@ Authentication Type: Chances are you are using <guilabel>Password</guilabel>. If you're not sure, ask your system administrator or ISP, or have - <application>Ximian Evolution</application> check for - you by clicking <guibutton>Check for supported - types</guibutton>. For exchange servers, Password is the - only type supported. + <application>Ximian Evolution</application> check for you by + clicking <guibutton>Check for supported + types</guibutton>. </para> </listitem> <listitem> <para> Username: The account name you use when you login to - check mail. For Exchange servers, enter the user name - you use to login to a Windows workstation in your - network. + check your email. Normally, this is the part of your + email address before the '@' character. For Exchange + servers, it is the username you would use to log in to a + Windows workstation at your company. </para> </listitem> <listitem> @@ -619,12 +619,12 @@ the workaround described in the note below. <sect2 id="mutt"> <title>Importing Mail from mutt</title> <para> - <application>mutt</application> is a text-based mail client - shipped with most Linux and Unix distributions. - <application>mutt</application> can use several different - formats, including mbox, maildir, and MH file formats, all of - which import cleanly into - <application>Evolution</application>. Here's how: + <application>mutt</application> is a full-featured mail client + which is shipped with most Linux and Unix distributions. + <application>mutt</application> uses the standard mbox, + maildir, and MH file formats, which makes importing your mail into + <application>Evolution</application> easy. By default, + <application>mutt</application> uses the mbox file format. <orderedlist numeration="arabic"> <listitem> <para> @@ -678,9 +678,10 @@ the workaround described in the note below. <sect2 id="kmail"> <title>Importing Mail from KMail</title> <para> - KMail is the mail client is shipped with the KDE desktop - environment. KMail uses the standard UNIX mbox file format to - store its messages. Here's how to import nessages from KMail: + KMail is a full-featured mail client which is shipped with the + KDE desktop environment. KMail uses the standard mbox file + format, which means that importing your mail into + <application>Evolution</application> is easy. <orderedlist numeration="arabic"> <listitem> <para> diff --git a/help/C/usage-notes.sgml b/help/C/usage-notes.sgml new file mode 100644 index 0000000000..1ff2283128 --- /dev/null +++ b/help/C/usage-notes.sgml @@ -0,0 +1,49 @@ +<chapter id="usage-notes"> + <title>Evolution Notes</title> + <abstract> + <title> An Overview of the Evolution Notes</title> + <para> + In the dark ages before email was invented, there were little + scraps of people which people used for short-term information + storage. These scraps of paper were called notes. Now, notes + are an almost necessary part of our lives, albeit in electronic + form. It only makes sense, then, that + <application>Evolution</application> will eventually have a + Notes feature. <application>Evolution</application> can help + you take notes in the following ways: + <itemizedlist> + <listitem> + <para> + Take down phone numbers, take school notes, take phone + messages, or even write poetry. + </para> + </listitem> + <listitem> + <para> + Color code notes to organize them, or just to + make them look good. + </para> + </listitem> + <listitem> + <para> + Turn a note into an email or a text file. + </para> + </listitem> + <listitem> + <para> + Write <glossterm>Haiku</glossterm> + </para> + </listitem> + </itemizedlist> + </para> + <para> + You can start writing notes by clicking + <guibutton>Notes</guibutton> in the shortcut bar. Of course, + it's not there yet. But when it is, it'll take you to the + notepad. + </para> + </abstract> +</chapter> + + + diff --git a/help/C/usage-print.sgml b/help/C/usage-print.sgml new file mode 100644 index 0000000000..2ef026e2f1 --- /dev/null +++ b/help/C/usage-print.sgml @@ -0,0 +1,115 @@ +<chapter id="usage-print"> + <title>Printing with Evolution</title> + <para> + Like most GNOME applications, <application>Evolution</application> uses + the gnome-print system, so if you've used any other GNOME + application to print, you should be able to print from + <application>Evolution</application> immediately. + </para> + <para> + Whether you're printing a message, a calendar page, or a selection + of address cards, you can choose to print directly to a printer, or + save the print output to a postscript file. You can also use the + preview feature to see how your printed output will look. + </para> + + + <sect1 id="printpreview"> + <title>Print Preview</title> + <para> + <guibutton>Print Preview</guibutton> appears both as a button in + the printing dialog and as an item in the + <guimenu>File</guimenu> menu. In both places, it does the same + thing: it opens a new window that shows you what would happen if + you were to print the current message, calendar, appointment, or + address card. + </para> + <para> + That window allows you to select which pages you want to see, + and how close you'd like to look at them. Zoom in or out, fit + the page to the window (the <guibutton>Fit</guibutton> button) + or match the width of the page and the window (the + <guibutton>Fit Width</guibutton> button). None of these buttons + changes the way the page will be printed, but they do let you + get a better look. If you're satisfied with the way the your paper + looks, click <guibutton>Print</guibutton> to send your document + on its way. If you'd like to change it, just close the + <guilabel>Print Preview</guilabel> window and make the changes + you want from your mail, calendar, or addressbook. + </para> + + + <!-- ==============Figure=================================== --> + + <figure id="print-preview"> + <title>Print Preview</title> + <screenshot> + <screeninfo>Print Preview</screeninfo> + <mediaobject><imageobject><imagedata fileref="figures/print-preview" format="png" srccredit="Aaron Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> +<!-- ==============End of Figure============================== --> + + </sect1> + + <sect1 id="print-destination"> + <title>File or Printer?</title> + <para> + The printer selection window, shown in <xref + linkend="print-dest">, lets you choose the format for + printing— <guilabel>Generic Postscript</guilabel>, + whether to write to a PDF file, and whether to print to a file + or to an actual printer in Generic Postscript. If you choose a + printer, you'll be asked for the printer command (probably + <guilabel>lpr</guilabel>) which your system uses. If you + choose to print to a file, you'll need to decide upon a + filename. And of course, you'll want to choose a number of + copies, and whether to collate them. + + <note id="windows-ps"> + <title>Printing to PostScript?</title> + <para> + PostScript is the file format used by most laser printers, + and in UNIX world is the easiest way to print to a file. + However, most systems running Microsoft Windows can't + recognize or handle PostScript files. You'll need to print + to PDF if you want to share your file with Windows users. + </para> + </note> + </para> + + <!-- ==============Figure=================================== --> + + <figure id="print-dest"> + <title>Choosing a Printer</title> + <screenshot> + <screeninfo>Choosing a Printer</screeninfo> + <mediaobject><imageobject><imagedata fileref="figures/print-dest" format="png" srccredit="Aaron Weber"> + </imageobject></mediaobject> + </screenshot> + </figure> +<!-- ==============End of Figure============================== --> + + <para> + If you're printing a message that's more than one page, you'll + have the option of choosing which pages to print. If you're + printing a calendar entry, you can decide what range of dates to + print. And, if you're printing contact cards, you can decide + whether to print only the selected cards, or all of them. + </para> + <para> + When you're ready, click <guibutton>Print</guibutton> to print, + <guibutton>Preview</guibutton> to have a look (or another look) + at the preview, or <guibutton>Cancel</guibutton> to cancel the + whole deal. + </para> + </sect1> +</chapter> + + + + + + + diff --git a/help/C/usage-sync.sgml b/help/C/usage-sync.sgml new file mode 100644 index 0000000000..5b93a65736 --- /dev/null +++ b/help/C/usage-sync.sgml @@ -0,0 +1,39 @@ + <chapter id="usage-sync"> + <title>Synchronizing Evolution with Hand-Held Devices</title> + <para> + This chapter is very short. It describes how to synchronize + the data on your Palm-OS device with the data you store in + <application>Ximian Evolution</application>. If you need + information on how to set up handheld synchronization, consult + <xref linkend="config-sync">. + </para> + + <sect1 id="hotsync"> + <title>Using HotSync</title> + <para> + Put your hand-held device in its cradle and press the + HotSync button. + </para> + +<tip id="sync-tip"> +<title>Palm OS v. 4.0 with Passwords</title> +<para> +If you use Palm OS v. 4.0 and have password protection turned on for +your handheld device, you may encounter trouble synchronizing. If +this happens, try turning off password protection on your handheld, +synchronize it with your desktop computer, and then re-enable password +protection on your handheld. +</para> +</tip> + <para> + If you have followed the set up instructions properly, your + Palm-OS device will synchronize data with <application>Ximian + Evolution</application>. + </para> + + <para> + That's it. + </para> + + </sect1> + </chapter> |