From 53777feb9a476864246e7bacb1ff139541271b35 Mon Sep 17 00:00:00 2001 From: nobody Date: Sat, 23 Jun 2001 05:14:10 +0000 Subject: This commit was manufactured by cvs2svn to create tag 'GTKHTML_0_10_0'. svn path=/tags/GTKHTML_0_10_0/; revision=10423 --- doc/C/.cvsignore | 11 - doc/C/Makefile.am | 72 -- doc/C/POTFILES.in | 16 - doc/C/apx-authors.sgml | 85 -- doc/C/apx-bugs.sgml | 23 - doc/C/apx-gloss.sgml | 470 ---------- doc/C/config-encryption.sgml | 147 --- doc/C/config-prefs.sgml | 628 ------------- doc/C/config-setupassist.sgml | 201 ----- doc/C/config-sync.sgml | 124 --- doc/C/evolution-C.omf | 14 - doc/C/evolution-faq.sgml | 948 -------------------- doc/C/evolution.sgml | 148 ---- doc/C/fig/calendar.png | Bin 43949 -> 0 bytes doc/C/fig/config-cal.png | Bin 7338 -> 0 bytes doc/C/fig/config-mail.png | Bin 9210 -> 0 bytes doc/C/fig/contact-editor.png | Bin 37707 -> 0 bytes doc/C/fig/contact.png | Bin 39742 -> 0 bytes doc/C/fig/filter-assist-fig.png | Bin 5575 -> 0 bytes doc/C/fig/filter-new-fig.png | Bin 8802 -> 0 bytes doc/C/fig/full-1.png | Bin 1218 -> 0 bytes doc/C/fig/full-2.png | Bin 1260 -> 0 bytes doc/C/fig/full-3.png | Bin 1290 -> 0 bytes doc/C/fig/full-4.png | Bin 1251 -> 0 bytes doc/C/fig/full-5.png | Bin 1293 -> 0 bytes doc/C/fig/full-6.png | Bin 1284 -> 0 bytes doc/C/fig/full-7.png | Bin 818 -> 0 bytes doc/C/fig/mail-composer.png | Bin 14971 -> 0 bytes doc/C/fig/mail-druid-pic.png | Bin 8457 -> 0 bytes doc/C/fig/mail-inbox.png | Bin 127593 -> 0 bytes doc/C/fig/mainwindow-pic.png | Bin 130739 -> 0 bytes doc/C/fig/print-dest.png | Bin 7358 -> 0 bytes doc/C/fig/print-preview.png | Bin 51801 -> 0 bytes doc/C/fig/vfolder-createrule-fig.png | Bin 8321 -> 0 bytes doc/C/menuref.sgml | 1138 ------------------------ doc/C/preface.sgml | 557 ------------ doc/C/usage-calendar.sgml | 439 --------- doc/C/usage-contact.sgml | 626 ------------- doc/C/usage-encryption.sgml | 147 --- doc/C/usage-exec-summary.sgml | 87 -- doc/C/usage-mail.sgml | 1622 ---------------------------------- doc/C/usage-mainwindow.sgml | 457 ---------- doc/C/usage-notes.sgml | 49 - doc/C/usage-print.sgml | 105 --- doc/C/usage-sync.sgml | 21 - 45 files changed, 8135 deletions(-) delete mode 100644 doc/C/.cvsignore delete mode 100644 doc/C/Makefile.am delete mode 100644 doc/C/POTFILES.in delete mode 100644 doc/C/apx-authors.sgml delete mode 100644 doc/C/apx-bugs.sgml delete mode 100644 doc/C/apx-gloss.sgml delete mode 100644 doc/C/config-encryption.sgml delete mode 100644 doc/C/config-prefs.sgml delete mode 100644 doc/C/config-setupassist.sgml delete mode 100644 doc/C/config-sync.sgml delete mode 100644 doc/C/evolution-C.omf delete mode 100644 doc/C/evolution-faq.sgml delete mode 100644 doc/C/evolution.sgml delete mode 100644 doc/C/fig/calendar.png delete mode 100644 doc/C/fig/config-cal.png delete mode 100644 doc/C/fig/config-mail.png delete mode 100644 doc/C/fig/contact-editor.png delete mode 100644 doc/C/fig/contact.png delete mode 100644 doc/C/fig/filter-assist-fig.png delete mode 100644 doc/C/fig/filter-new-fig.png delete mode 100644 doc/C/fig/full-1.png delete mode 100644 doc/C/fig/full-2.png delete mode 100644 doc/C/fig/full-3.png delete mode 100644 doc/C/fig/full-4.png delete mode 100644 doc/C/fig/full-5.png delete mode 100644 doc/C/fig/full-6.png delete mode 100644 doc/C/fig/full-7.png delete mode 100644 doc/C/fig/mail-composer.png delete mode 100644 doc/C/fig/mail-druid-pic.png delete mode 100644 doc/C/fig/mail-inbox.png delete mode 100644 doc/C/fig/mainwindow-pic.png delete mode 100644 doc/C/fig/print-dest.png delete mode 100644 doc/C/fig/print-preview.png delete mode 100644 doc/C/fig/vfolder-createrule-fig.png delete mode 100644 doc/C/menuref.sgml delete mode 100644 doc/C/preface.sgml delete mode 100644 doc/C/usage-calendar.sgml delete mode 100644 doc/C/usage-contact.sgml delete mode 100644 doc/C/usage-encryption.sgml delete mode 100644 doc/C/usage-exec-summary.sgml delete mode 100644 doc/C/usage-mail.sgml delete mode 100644 doc/C/usage-mainwindow.sgml delete mode 100644 doc/C/usage-notes.sgml delete mode 100644 doc/C/usage-print.sgml delete mode 100644 doc/C/usage-sync.sgml (limited to 'doc/C') diff --git a/doc/C/.cvsignore b/doc/C/.cvsignore deleted file mode 100644 index 548121644a..0000000000 --- a/doc/C/.cvsignore +++ /dev/null @@ -1,11 +0,0 @@ -Makefile -Makefile.in -*.junk -*.log -*.ps -*.dvi -*.tex -DBTOHTML_OUTPUT_DIR* -evolution -evolution-faq -fig/*.eps diff --git a/doc/C/Makefile.am b/doc/C/Makefile.am deleted file mode 100644 index 60158b03ce..0000000000 --- a/doc/C/Makefile.am +++ /dev/null @@ -1,72 +0,0 @@ -evolution_helpdir = $(datadir)/gnome/help/evolution/C - -GUIDE_SGML_FILES = \ - evolution.sgml \ - apx-authors.sgml \ - apx-bugs.sgml \ - apx-gloss.sgml \ - config-encryption.sgml \ - config-prefs.sgml \ - config-setupassist.sgml \ - config-sync.sgml \ - preface.sgml \ - usage-calendar.sgml \ - usage-contact.sgml \ - usage-mail.sgml \ - usage-mainwindow.sgml \ - usage-sync.sgml - -FAQ_SGML_FILES = \ - evolution-faq.sgml - -EXTRA_DIST = \ - $(FAQ_SGML_FILES) \ - $(GUIDE_SGML_FILES) - -all: evolution-guide evolution-faq - -evolution-guide: $(GUIDE_SGML_FILES) - -db2html $(srcdir)/evolution.sgml - -evolution-faq: $(FAQ_SGML_FILES) - -db2html $(srcdir)/evolution-faq.sgml - -dist-hook: - mkdir $(distdir)/evolution - -cp evolution/*.html evolution/*.css $(distdir)/evolution - mkdir $(distdir)/fig - -cp fig/*.png $(distdir)/fig - mkdir $(distdir)/evolution/stylesheet-images - -cp evolution/stylesheet-images/* $(distdir)/evolution/stylesheet-images - -# FIXME really messy here -install-data-local: evolution-guide evolution-faq - $(top_srcdir)/mkinstalldirs $(DESTDIR)$(evolution_helpdir)/evolution-guide - -for file in $(srcdir)/evolution/*.html $(srcdir)/evolution/*.css; do \ - basefile=`basename $$file`; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(evolution_helpdir)/evolution-guide/$$basefile; \ - done - - $(top_srcdir)/mkinstalldirs $(DESTDIR)$(evolution_helpdir)/evolution-faq - -for file in $(srcdir)/evolution-faq/*.html $(srcdir)/evolution-faq/*.css; do \ - basefile=`basename $$file`; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(evolution_helpdir)/evolution-faq/$$basefile; \ - done - - $(top_srcdir)/mkinstalldirs $(DESTDIR)$(evolution_helpdir)/evolution-guide/fig - -for file in $(srcdir)/fig/*.png; do \ - basefile=`basename $$file`; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(evolution_helpdir)/evolution-guide/fig/$$basefile; \ - done - - $(top_srcdir)/mkinstalldirs $(DESTDIR)$(evolution_helpdir)/evolution-guide/stylesheet-images - -for file in $(srcdir)/evolution/stylesheet-images/*; do \ - basefile=`basename $$file`; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(evolution_helpdir)/evolution-guide/stylesheet-images/$$basefile; \ - done - -evolution.ps: evolution.sgml - -db2ps $< - -evolution.rtf: evolution.sgml - -db2rtf $< diff --git a/doc/C/POTFILES.in b/doc/C/POTFILES.in deleted file mode 100644 index d9393e82cc..0000000000 --- a/doc/C/POTFILES.in +++ /dev/null @@ -1,16 +0,0 @@ -apx-authors.sgml -apx-bugs.sgml -apx-gloss.sgml -config-prefs.sgml -config-setupassist.sgml -config-sync.sgml -evolution.sgml -menuref.sgml -preface.sgml -usage-calendar.sgml -usage-contact.sgml -usage-mail.sgml -usage-mainwindow.sgml -usage-notes.sgml -usage-print.sgml -usage-sync.sgml diff --git a/doc/C/apx-authors.sgml b/doc/C/apx-authors.sgml deleted file mode 100644 index e06c600a13..0000000000 --- a/doc/C/apx-authors.sgml +++ /dev/null @@ -1,85 +0,0 @@ - - Authors - - Evolution was written by: - - Seth Alves: alves@ximian.com - Anders Carlsson: andersca@gnu.org - Damon Chaplin: damon@ximian.com - Clifford R. Conover: rusty@zootweb.com - Miguel De Icaza: miguel@ximian.com - Radek Doulik: rodo@ximian.com - Arturo Espinoza: arturo@nucleu.unam.mx - Larry Ewing: lewing@ximian.com - Bertrand Guiheneuf: bertrand@ximian.com - Tuomas Kuosmanen: tigert@gimp.org - Christopher J. Lahey: clahey@ximian.com - Matthew Loper: matt@loper.org - Federico Mena: federico@ximian.com - Eskil Heyn Olsen: deity@eski.dk - Nat Friedman: nat@ximian.com - Ettore Perazzoli: ettore@ximian.com - Jeffrey Stedfast: jeff@ximian.com - Russell Steinthal: rms39@columbia.edu - Peter Teichman: peter@ximian.com - Chris Toshok: toshok@ximian.com - Peter Williams: peter@newton.cx - Dan Winship: danw@ximian.com - Michael Zucchi: notzed@ximian.com - -and other dedicated GNOME programmers. - - - The Evolution code owes a great debt - to the GNOME-pim and - GNOME-Calendar applications, and to - KHTMLW. The developers of - Evolution acknowledge the efforts - and contributions of all who worked on those projects. - - - - For more information please visit the - Evolution Web page. Please send all comments, - suggestions, and bug reports to the GNOME bug tracking - database. Instructions for submitting bug reports can be - found on-line at - http://bugs.gnome.org/Reporting.html. You can also use - command bug-buddy for submitting bug reports. - - - This manual was written by Aaron Weber - (aaron@ximian.com), Kevin Breit - (battery841@mypad.com) Duncan Mak - (duncan@ximian.com) and Ettore Perazzoli - (ettore@ximian.com) with the help of the - application programmers and the GNOME Documentation Project. - Please send all comments and suggestions regarding the manual to - the GNOME Documentation Project at - docs@gnome.org. You can also add your comments - online by using GNOME Documentation - Status Table. - - - Translations: - - - Daniel Persson for .se - - - - Hector Garcia Alvarez for .es - - - - - - - - - diff --git a/doc/C/apx-bugs.sgml b/doc/C/apx-bugs.sgml deleted file mode 100644 index e4a96a8155..0000000000 --- a/doc/C/apx-bugs.sgml +++ /dev/null @@ -1,23 +0,0 @@ - - - Known bugs and limitations - - - This appendix describes known bugs and limitations of - Evolution. Please use the GNOME - Bug Report Tool (known as - bug-buddy at the command line) if you find one - we have not listed. - - - - - Evolution is still beta software, so the bug tracking is best - left to the bugzilla system and to the programmers. However, - there are a number of limitations that will not be addressed - before version 1.0. The most notable are: Import of Microsoft - Outlook .pst files, and compatibility with the Microsoft - Exchange protocol. - - - diff --git a/doc/C/apx-gloss.sgml b/doc/C/apx-gloss.sgml deleted file mode 100644 index 76102417c4..0000000000 --- a/doc/C/apx-gloss.sgml +++ /dev/null @@ -1,470 +0,0 @@ - - - Glossary - - - Attachment - - - Any file sent along with an email. Attachments may be embedded in - a message or appended to it. - - - - - - Automatic Indexing - - - Pre-sorting procedure that allows - Evolution to refer to data quickly. - It enables faster searches and decreases memory usage for - data displays. - - - - - - Bcc (Blind Carbon Copy) - - - 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. - - - - - - Cc (Carbon Copy) - - - 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. - - - - - - Conduit - - - A synchronization conduit is a small application which controls - the transfer of data between a handheld device and a desktop - computer. - - - - - - - Druid - - - A tool which guides a user through a series of steps, usually to - configure or set up a program. Equivalent to "Assistant" and - "Wizard." - - - - - - Emoticon - - - Also called "smileys," emoticons are the little sideways faces made - of colons and parentheses which people use to convey emotion in email. - Examples: :-) or ;( . - - - - - - Evolution - - - Evolution is the GNOME - groupware application. - - - - - - Execute - - - To run a program. Any file that can be run is called an - executable. Evolution 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. - - - - - - Expunge - - - 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. - - - - - - File Tree - - - 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 /. - 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, - /home/root. - - - - - - Filter - - - Within Evolution, a filter is a method - of sorting mail automatically. You can create filters to perform - one or more actions on a message that meets any (or all) of a wide - range of criteria. - - - - - - Forward - - - If you get a message intended for someone else, you can use - message forwarding to send it on to the right person. - - - - - - Groupware - - - 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. - - - - - - Haiku - - - A traditional Japanese form of poetry. The poems are three lines - long, with first and last lines having five syllables, and the - second line seven syllables. - - - - - - HTML - - - Hyper-text Markup Language(HTML) 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. - - - - - - Hot Key - - - Hot-keys are keyboard combinations used to do actions on a - computer instead of using the mouse to do the same action. - Hot-keys can speed up computer usage. - - - - - - iCal - - - iCal is the program which - Evolution uses to manage the calendar - section. - - - - - - IMAP - - - Depending upon whom you ask, IMAP stands for the Internet Mail - Access Protocol, or the Interim Mail Access Protocol. Whatever it - stands for, 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 POP. - This will not be on the test. - - - - - - - Inline - - - Displayed as part of a message or other document, rather than - attached as a separate file. Contrast with Attachment. - - - - - - LDAP - - - 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. - - - - - - Mail Client - - - 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. - - - - - - - Minicard - - - A format for the display of contact data. Similar in appearance - to a small business card. - - - - - - Nautilus - - - Nautilus is the next generation file - manager for GNOME being written by Eazel. - - - - - - Nickname - - - An alias for an e-mail address. - - - - - - POP - - - 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. - - - - - - Protocol - - - 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. - - - - - - - - Regular Expression - - - A regular expression, or "regex", is a way of describing a - string of text using metacharacters or wild-card symbols. For - example, the statement fly.*so[a|u]p 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 grep command. - - - - - - Script - - - 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. - - - - - - Sendmail - - - As its name implies, sendmail is a - program which sends mail. Evolution - can use it instead of SMTP; some people - prefer it because it offers more flexibility, but is more - difficult to set up. - - - - - - - Shortcut Bar - - - A portion of Evolution which offers - users fast access to the most frequently used portions of the - application. - - - - - - Signature - - - In email terms, a signature is a piece of text placed at the end - of every email sent, like 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. - - - - - - SMTP - - - 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. - - - - - - Spam - - - Useless, unsolicited e-mail. Spam normally comes in forms of - chain letters and advertisements for unscrupulous or clueless - companies. Messages that are merely useless are called "opt-in - newsletters." - - - - - - - Tool-Tip - - - A small box of explanatory text which appears when the mouse - pointer is held motionless over a button or other interface - element. - - - - - - - - - Virus - - - A malicious program which inserts itself into others so that it will be - executed, allowing it to spread to still more programs and other computers. - A virus can cause substantial damage by clogging networks or disk drives, - deleting files, or opening security holes. - - - - - - vCard - - - 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 vFolder. - - - - - - vFolder - - - An email organization tool. vFolders allows you to create a folder - that contains the results of a complex search. Folder contents are - are updated dynamically. - - - - - - - - - - - - - - - - - - - diff --git a/doc/C/config-encryption.sgml b/doc/C/config-encryption.sgml deleted file mode 100644 index e36f17c652..0000000000 --- a/doc/C/config-encryption.sgml +++ /dev/null @@ -1,147 +0,0 @@ - - -
- - - What is Encryption? - - Encryption is an ancient method of changing readable text to unreadable - text that dates back to Egyptian times. Encryption takes the statement - "Evolution" and turns it into something which cannot be read without help - through decryption. - - Encryption Example - - Kevin orders an Evolution t-shirt from - Ximian, Inc. over the internet. He puts in his credit card number - which is 1234-567-8901. For security, his computer encrypts the - credit card number so it can be safely transmitted over the internet. - The number now is @#$23ui7yr87#@!48970fsd, which holds no intentional - resemblance to the inital number. When the information gets to - Ximian, Inc. it'll be decrypted into the inital number. - - - Encryption can be used in email in two ways: to verify that the sender is - the real sender, and to hide the message while in transmission. - Evolution has the capability to do both. - - - - Generating your PGP key - - First, you need to create a PGP key. To do this, you'll need GPG - installed. - - - GPG Versions - - This manual covers version 1.0.6 of GPG. If your version is different, - this may not be entirely accurate. You may find out your version number - by typing in: gpg --version. - - - - You can start by typing in: gpg --gen-key. At the - first question, select 1. The next question asks you about key length. - The longer the key, more stronger it is. However, the longer the key, the - longer it takes to generate. This is your choice. However, 1024 bits - (default) should be adequate. The next question asks you if you want your - key to expire. Expiring keys make your key invalid after a certain amount - of time, so old keys don't float around active. This is the same concept - as a coupon at a supermarket. Next, you'll type in your Real name, your - email address, and a comment. You should not forge this information, as - it is used later to verify who you are. Assuming that all your - information is correct, press "O" to continue. GPG now asks you for a - passphrase. This is a password which you will need to decrypt and encrypt - messages. This can be any length, with any characters in it. It is case - sensitive, which means that it does know the difference between capital - letters and lower-case. Now your key is generated. It is recommend you - surf the internet, read your email, or write a letter in a word - processor. This help creates randomness in the key. - - - Once this is completed, you'll be dropped back to the command line. - Now you can view your key information by typing gpg - --list-keys. You should see something similar to this: - - GPG Listing Keys - - /home/bob/.gnupg/pubring.gpg - ---------------------------- - pub 1024D/32j38dk2 2001-06-20 bob <bob@bob.com> - sub 1024g/289sklj3 2001-06-20 [expires: 2002-11-14] - - - You'll now need to upload your public key to a keyserver, so that your - friends can use your key. You'll need to know the ID of your key, which - is after the 1024D on the line beginning with pub. For this example, it - is 32j38dk2. You now type in gpg --send-keys --keyserver - wwwkeys.pgp.net 32j38dk2. Substitute your key ID for 32j38dk2. - You will be prompted to type in your password and your key will be uploaded for your - friends to download. - - - - Setting up Evolution's Encryption - - You'll need to open - - Tools - Mail Settings - - Once there, select the account you'd like to associate the key to and click - the Edit button. In the - Security tab is a section labeled Pretty - Goog Privacy. Enter your key ID and click - OK. Your key is now integrated into your identity - in Evolution. - - - - Sending Encrypted Messages - - You can either sign or encrypt a message. When you sign a message, verify - that you were the one who sent it, and that no one is forging your - identity. Encrypting a message makes it impossible for someone with - prying eyes to view it while it's in tranmission. - - - - Signing a Message - - To sign a message, you simply click - - Security - PGP Sign - - . You will be prompted for your PGP password. Once you enter it, - click OK and your message will be signed. - - - - Encrypting a Message - - Encrypting a message is very similar to signing a message. You simply - click the menu item - - Security - PGP Encrypt - - - - - - - Unencrypting a Recieved Message - - Sometimes, a friend will send you a message which is encrypted. In order - for you to read it, you need to unencrypt it. - - - When you view the encrypted message, Evolution - will prompt you for your PGP password. You type in your PGP password and - the message is then decrypted. - - -
diff --git a/doc/C/config-prefs.sgml b/doc/C/config-prefs.sgml deleted file mode 100644 index f55c053aed..0000000000 --- a/doc/C/config-prefs.sgml +++ /dev/null @@ -1,628 +0,0 @@ - - - - Advanced Configuration - - 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 - Evolution settings. This chapter - will tell you how to do just that. - - - - Mail Settings - - To change your mail settings, select - Tools Mail - Settings in the Inbox. This - will open the mail preferences window, - illustrated in . Mail - preferences are separated into several categories: - - - Accounts - - - This allows you to create and alter one or more identities for your - email. - - - - - Display - - - Allows you to edit how email is handled and displayed. - - - - - Composer - - - Customizes the composer window's behavior. - - - - - Other - - - Configures miscellanious aspects of Evolution - such as character sets. - - - - - - - - -
- Mail Preferences Dialog - - Setting mail preferences - - - -
- - - - - Identity Settings - - If you have only one email account, or send email from only - one address, you will only need to configure one identity. If - you want, however, you can have multiple identities. This - can be useful if you want to keep personal and professional - email separate, or if you wear several hats at work. - - - - To add a new identity, simply click - Add. To alter an existing identity, - click on it in the Identity tab of the - Preferences window, and then click - Edit. - - - - Evolution will then present you - with a dialog box containing four fields: - - - - Full Name: by default, this is the - same name as the full name described in your user - account on your computer. You can select another if you - wish. - - - - - Email address: Enter your email - address in this space. - - - - - Organization: If you send email as - a representative of a company or other organization, - enter its name here. - - - - - Signature file: You may choose a - small text file to be appended to every message that you - send. Typically, signature files include address or - other contact information, or a favorite quotation. - It's good form to keep it to four lines at the maximum. - - - - - - - - Network Settings - - In order to send mail with - Evolution, you need to connect to - your network. To do that, you'll need to know your user name - and password, what sort of mail sending and receiving - protocols your network uses, and the names of the servers - you'll be using. If you're switching from another groupware - or email program, you can almost certainly use the same - settings as you did with that program. Network-related - settings are in the Mail Sources and - Mail Transport tabs. - - - - Mail Sources - - The Mail Sources tab allows you to - edit, add, or delete methods of retrieving mail from - servers. Clicking on Add or - Edit will bring up a dialog box to - offer you the following options: - - - Mail source type: - - - Select from IMAP or POP servers, or Unix-style - mbox - or mh - files. - - - - - Server: - - - Enter the name of the mail source server in this - field. If you use an may or may not be the same as your - SMTP server. - - - - - Username: - - - Enter the user name for the account you have on the - server-- this should the part of your email address - before the @. If you use - mbox - or mh - files as your mail source, you do not need to enter - a username. - - - - - Authentication: - - - Tell Evolution how to - verify your identity with the server. Your options - vary depending upon the type of server you are - using, and the ways it is configured. Given the - name of a server, - Evolution can detect what - sorts of authentication it offers. - - - - - Test Settings - - - Click this button to have - Evolution check to see if - mail sources are configured correctly. - - - - - - - If you have several mail sources, clicking Get - Mail will refresh any IMAP, - mh, or - mbox - listings and check and download mail from all POP servers. - In other words, Get Mail gets your - mail, no matter how many sources you have, or what types - they are. - - - - - Mail Transports - - The Mail Transports tab lets you set - how you will send mail. Evolution currently supports two - mail transport options: SMTP, which - uses a remote mail server, and - sendmail, which uses the - sendmail program on your local - system. Sendmail is more - difficult to configure, but offers more flexibility than - SMTP. - - - To use SMTP, you'll need to enter the - name of your SMTP server. It may have the same name as - your mail source server. - - - Evolution can attempt to - determine if you have entered a valid server name. To - have it do so, click the Test - Settings button. - - - - - News Servers - - 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 News Servers tab, - you will see a blank box with the three familiar buttons - on the right: Add, - Edit, and - Delete. - - - Click Add to add a news server; you - will be prompted for its name. Enter the name, click - OK, and you're done. You can have - as many mail servers as you like, of course. News servers - will appear next to your IMAP servers in the - folder bar. - - - - - Other Mail Preferences - - Not everything fits neatly into categories. This tab - contains some miscellaneous configurations that don't have - too much to do with each other. - - - - - Send messages in HTML format - - - If you check this box, you will send - messages as HTML by default. If you leave it unchecked, your - messages will be sent without HTML formatting unless you select - Format HTML - in the message composer. - See - for more information about HTML mail. - - - - - Mark Messages as Seen After - - - When you click on a message, - Evolution will wait a - moment before marking it as seen. You can set the - delay, in milliseconds, here. - - - - - Folder Format - - By default, - Evolution saves its mail - in the - mbox - format. You can switch to the - mh - format if you like. Note that this is an advanced - feature and may cause you to lose some messages, so - you should probably make a backup of your - evolution - directory first. In addition, it will take quite - some time if you have a large mailbox. - - - - - - - - - Configuring the Calendar - - To set your calendar preferences, select - Settings - Calendar - Configuration from the Calendar - view. This will open up the - Preferences window. It contains four - tabs: Time display, - Colors, To Do List - and Alarms. The calendar - preferences window is illustrated in . - - -
- Calendar Preferences Dialog - - If this worked on my job as well as my calendar... - - - -
- - - - - Time Display Settings - - The Time display tab lets you set the - following: - - - Time format - - You may choose between twelve-hour (AM/PM) and - twenty-four hour time formats here by clicking the - appropriate radio button. - - - - - Weeks start on - - You can set weeks to start on Sunday or on Monday. - - - - Day range - - - When does your work day start, and when does it end? - In the day and week views, - Evolution 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. - - - - - - - - Calendar Colors - - The colors tab allows you to decide - what color your calendar will be. The tab consists of a - sample calendar on the right and a list of ten items that can - be colored in different ways. If you click on the color - button to the right of each item, you will bring up a - color-selector window where you can choose to alter that - color. By clicking OK in the color - selection dialog, you can see the results of the color on the - sample calendar. - - The display elements whose color you can set are: - - - - - Outline: The lines between days - and at the top of the display. - - - - - Headings: Text color for day - and month names and other headings. - - - - - Empty days: This is the - background color for any time slots in which you have no appointments. - - - - - - Appointments: This is the - background color for any time slots in which you have appointments. - - - - - Highlighted day: The - background color for a selected time slot. - - - - - - - Day numbers: Text color for date numbers. - - - - - - - Current day's number: Text color for today's date. - - - - - To-Do item that is not yet - due: Text color for To-Do list items that are - not yet due. (Or maybe background color? find out!) - - - - - - To-Do item that is due today: - Text color for today's tasks. - - - - - To-Do item that is overdue: - Text color for overdue tasks. - - - - - - - - - To Do List Settings - - You can choose what information the To Do list displays and the - way it is displayed. The two areas of the To Do - List tab offer several options each: - - - Show on To Do List - - - This box contains three items. If you select the - check boxes next to them, that information will appear - in the To Do list for each task it contains: - - - Due Date - - - Time Until Due - - - Priority - - - - - - - Style Options - - - Select among the following checkboxes to determine - how your To Do list will look: - - - Highlight overdue items - - - Highlight items due today - - - Highlight not yet due items - - - - - - - - - - - Alarms Settings - - The alarms tab enables you to select from three boxes: - - - Beep on display alarms: select - this box to have Evolution beep - at you for any alarms you have set. If you leave this box - unchecked, Evolution will only - alert you to events by opening a dialog box. These beeps - are distinct from full-fledged audio alarms. - - - - Audio alarms timeout after: - Select this button to have your audio alarms stop - automatically after a certain number of seconds. - - - Enable snoozing for: If you - would like to have the option to tell - Evolution to repeat an alarm in - a few minutes, select this button and decide how long - you'd like it to wait. - - - - - - - - - - Managing the Contact Manager - - To set the behavior of your Contact Manager, click on the - Contact Manager tab in the - Preferences window. - - - You can set the following options: - - - - Adding Directory Servers - - To add a new LDAP server to your available contact - folders, select Actions - New Directory Server - . This brings up a small dialog box which - will let you enter the following options: - - - Name — any name you choose for the server. - - - - Description — a longer description of the server. - - - - LDAP Server — the network address of the server. - - - - Port Number — by default, the port number is 389. - - - - Root DN — enter the root DN here. - - - - - - - - - - General Preferences - - Additional configuration options will be covered here, as - they become available. - - - - - - - - - diff --git a/doc/C/config-setupassist.sgml b/doc/C/config-setupassist.sgml deleted file mode 100644 index d76deba090..0000000000 --- a/doc/C/config-setupassist.sgml +++ /dev/null @@ -1,201 +0,0 @@ - - Easy Setup with the Setup Assistant - - The first time you try to use email, the mail setup assistant - will ask you for some basic information, so - Evolution can let you use email. If - you prefer more detailed configuration, or if you want to make - changes to an existing email setup, see . - - - - Mail Setup - - The first time you try to send or receive mail with - Evolution, the mail - setup assistant will pop up to help you with your - email preferences. If you don't plan to use email, or if - you'd rather deal with your email preferences later, click - Cancel. - - - - - - The setup assistant (sometimes called a - Druid, by analogy with the "Wizards" - that some other programs use) will guide you through the - network configuration process. It will ask you for some - basic information; your system administrator or ISP should - have the answers you'll need. The mail setup assistant is - pictured in . - - - - -
- Mail Setup Assistant - - Evolution Main Window - - - -
- - - - - The assistant will ask you for the following information: - - - - Full Name: - Your name. - - - - Email address: - - Your complete email address. - - - - - Organization: - - - Any organization you represent, or the company where you - work. Leave this blank if you wish, or type "My own bad - self" so people know your opinions are yours alone. - - - - - - Signature File: - - - A text file appended to any email you send. A signature - file typically consists of your name and email address, - or a quotation you like. It's good form to keep your - "sig" on the short side: four lines is plenty. Remember, - this is attached to every email you send. - - - - - - Receiving Email - - - Evolution supports several - mail sources: POP and - IMAP servers, UNIX-style - mbox and - Qmail maildir-format files. - POP servers retrieve your mail and store it on your - local system so you can refer to it even when not - connected to a network; IMAP - servers store the mail on the server so you can access - it from multiple locations; - mbox> - files are used by your computer for internal mail, and - may be useful if you want to switch from another email - client such as Spruce or - Netscape Communicator. Qmail files - maybe useful if you use qmail to retrieve your mail. Ask - your system administrator which you should use, or keep - guessing until one works. You may use multiple sources - if you wish; see for more - information. - - - If you decide not to have - Evolution use any servers, - the remaining items are not relevant; you only need to - point to the location of the files you wish to access. - - - - - - Sending Email - - - This should be the name of the server where you send - mail. It may (or may not) be the same as the - server where you get your incoming mail. - - - - - - Authentication: - - - Select the type of authentication you will use. You can - click Detect supported types to - find out which authentication protocols your network - allows. - - - In the Username: input box, type your - username for your email account (the part before the @). - - - - - - Account Management - - - This is where you put the name of this email account. It - could be "Home" or "Work". - - - - - - - To learn how to configure Evolution - in greater detail, or to change preferences once you have set - them, see . - - - - - - - - - - - - - diff --git a/doc/C/config-sync.sgml b/doc/C/config-sync.sgml deleted file mode 100644 index 0445b474c4..0000000000 --- a/doc/C/config-sync.sgml +++ /dev/null @@ -1,124 +0,0 @@ - - Setting up your synchronization system - - Synchronization presents you with two issues you'll need to - deal with. - - - Your computer needs to recognize and access your handheld. - At this time, Evolution only - supports Palm-OS devices like the PalmPilot and the - Handspring Visor. - - - You should decide what sort of synchronization behavior you - want. - - - - - - If you haven't used a handheld device with your computer - before, you'll need to run the GNOME Control - Center and make sure that Pilot - Link is properly configured. Then, select the - Evolution conduits under the - Pilot Conduits section of the Control - Center. - - - Once your computer and your Palm-OS device are talking happily - to each other, you'll have to decide what exactly you want - them to do with the data they exchange. Your options may vary - depending on the conduit, but typically they will be: - - - - Disabled - - - Do nothing. - - - - - - Synchronize - - - 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. - - - - - - Copy From Pilot - - - If there is any new data on the the handheld device, - copy it to the computer. - - - - - - Copy To Pilot - - - Copy new data from the computer to the handheld. - - - - - - Merge From Pilot - - - Copy new data from the handheld to the computer, and - remove any information from the computer that has - been deleted on the handheld. - - - - - - Merge To Pilot - - - Copy new data from the computer to the handheld, and - remove any information from the handheld that has - been deleted on the computer. - - - - - - - - Select a behavior for each conduit available. For the most - part, you'll want to stick with - Synchronize. Then, put your handheld on - its cradle and press the synchronization button. - - - - - - Data Loss Prevention - - It's always a good idea to make a backup. To do that, - make a copy of your - ~/evolution directory. - - - - - - - - - diff --git a/doc/C/evolution-C.omf b/doc/C/evolution-C.omf deleted file mode 100644 index 320aec7b6d..0000000000 --- a/doc/C/evolution-C.omf +++ /dev/null @@ -1,14 +0,0 @@ - - - - - The Evolution Manual - - - GNOME|PIM - - - - - - diff --git a/doc/C/evolution-faq.sgml b/doc/C/evolution-faq.sgml deleted file mode 100644 index 184c1fa436..0000000000 --- a/doc/C/evolution-faq.sgml +++ /dev/null @@ -1,948 +0,0 @@ - - - Frequently Asked Questions About Ximian Evolution - - Here are some frequently asked questions about the - Evolution groupware suite from - Ximian. If you have a question that's not listed, you can - contact us at evolve@ximian.com. - - - - Features - - - - - - - How can I use Evolution with Microsoft Exchange or Lotus Notes? - - - - - If your server uses standard open protocols like IMAP, - POP, and SMTP, you can use Evolution with it. You can - share addresses with vCards and calendar items with iCal - appointments. We hope to have support for the - proprietary segments of Exchange and Notes severs - eventually, but this will come after Evolution 1.0. - - - - - - - - Can I use Evolution with KDE? - - - - - 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). - - - - - - - - How can I remove or rename a folder? - - - - - We're going to add a good way to do this soon. In the - mean time, you have to remove it by hand. - - - - All the folders are stored in - ~/evolution/local. Each folder is a - directory containing the data files, as well as a - subfolders directory that contains - all its subfolders. So for example if you have a - subfolder of the Inbox called - Foo, you can run the following - command to get rid of it (and all it subfolders): - - - -rm -rf ~/evolution/local/Inbox/subfolders/Foo - - - - You should do this after exiting Evolution. - - - - - - - - Why doesn't drag and drop between folders seem to work? - - - - - The implementation isn't finished, although it's planned - to be finished soon. - - - - In the meantime, you can copy the folders' contents by - hand from the shell (please do this after quitting - Evolution). For example: - - - -cp -r ~/evolution/local/Inbox/subfolders/Foo ~/evolution/local/Inbox/subfolders/Bar - - - - Likewise, you can use mv to rename or - move folders. - - - - - - - - Can I read mail from a mailbox file created by some other - application (e.g. Mutt) without importing mail from it? - - - - - No, but it's a planned feature. - - - - - - - - Can Evolution sync with my Palm OS (tm) device? - - - - - 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 - README 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. - - - - - - - What is the difference between a virtual folder (vfolder) - and a regular folder? - - - - - 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. - - - - - - - Can Evolution spell-check messages while I compose them? - - - - - 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 - gnome-spell component, which is not - shipped with Ximian GNOME yet. - - - - If you are brave enough, you can check out module - gnome-spell from the GNOME CVS and - compile it yourself. Check out its README file for a list - of gnome-spell's requirements for - compilation. - - - - Note that you don't need to recompile Evolution after - installing gnome-spell; it will be - picked up automatically. - - - - - - - - Why can't I see the images that are contained in some HTML - mail messages. - - - - - 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. - - - - - - - - Can I change the font that Evolution uses to compose and - display mail messages? - - - - - 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. - - - - - - - How do I import my Outlook .pst files into Evolution? - - - - - You cannot import these files directly into Evolution - because the .pst format is a - proprietary format. However, Mozilla Mail on Windows can - convert them into the mbox format, which can - then be imported by Evolution. - - - - To start importing your Outlook mail to Evolution, run - Mozilla Mail on Windows and select the - FileImport... - to begin. Then select that you wish to import Mail from - Outlook. Once Mozilla has imported all your mail, reboot - your computer into Linux. - - - - Mount your Windows partition in Linux and run Evolution to - begin importing your mail. Select - FileImport - File... to start importing. Set - the file type to MBox (mbox) and click on - Browse to select the mail you want - to import. - - - - If you are the only user on Windows, the mail files will - be stored in /mnt/c/windows/Application - Data/Mozilla/Profiles/default/XXXX/Mail/imported.mail/ - where /mnt/c/ is your windows - partition mount point and XXXX is some collection of - numbers and digits ending in .slt. - - - - If there is more than one user, the file will be in - /mnt/c/windows/Profiles/USERNAME/XXXX/Mail/imported.mail/ - where USERNAME is your Windows username. - - - - 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 .msf - extension. - - - - - - - - If Mozilla can import .pst files, why can't Evolution? - - - - - Mozilla on Windows accesses the .pst - files through the MAPI.DLL, which is - only avaliable on Windows. MAPI.DLL - is the only way to access .pst files - and Evolution cannot use this DLL in Linux. - - - - - - - Will there be a server? How about a text-based or web-based front end? - - - - - 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. - - - - - - - - Will Evolution make a good mocha? - - - - - Only espresso is planned, but you can easily plug in a chocolate component. - - - - - - - - - - - - - Getting and Compiling Evolution - - - - - - Where can I get the latest Evolution release? - - - - - There are two ways to install the latest Evolution - release: - - - - 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. - - - - - - If you want to compile from source, you can - download the latest official Evolution tarball - from: - - - - - ftp://ftp.gnome.org/pub/GNOME/unstable/sources/evolution - - - - - - - - - - Are binary snapshots available? - - - - - Yes, if you have Ximian GNOME installed. Just run Red - Carpet and subscribe to the Evolution Snapshot channel. - - - - You can check the status of snapshots at - http://primates.ximian.com/~snapshot. - - - - - - - Why isn't a new snapshot available today? - - - - - Sometimes the build might fail because of problems with - the source on CVS. In this case, just wait for next day's - snapshot. - - - - - - - How do I get Evolution from CVS? - - - - - If you already have - GNOME CVS access, - simply check out the following modules: evolution, - gtkhtml, gal. - - - 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. - - - - Before using the anoncvs server, you have to log into it. - This only needs to be done once. Use this command: - - - - cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome login - - - - Then you can retrieve the modules needed to compile Evolution - using the following command: - - - - cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co evolution gtkhtml gal - - - - - - - - How should I compile Evolution avoiding conflicts with my - existing GNOME installation? - - - - - The best way is to install Evolution into a separate prefix. - In order to specify a non-default installation prefix, you - can pass the --prefix option to - configure or - autogen.sh. For example: - - - - cd /cvs/evolution - ./autogen.sh --prefix=/opt/gnome - - - - 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: - - - - export PATH=/opt/gnome:$PATH - export GNOME_PATH=/opt/gnome:/usr - - - - You may also need to add $prefix/lib - (e.g. /opt/gnome/lib) to your - /etc/ld.so.conf. Of course, this will - not work for systems which do not use ld.so.conf, such as - HP-UX. - - - - - - - I get the error message: make: *** No rule - to make target - `all-no-@BUILD_INCLUDED_LIBINTL@' - - - - - You probably have gettext 0.10.36 or - later installed. Try downgrading to 0.10.35; - unfortunately, 0.10.36 introduced some incompatibilities - with the current xml-i18n-tools. - - - - - - - - Troubleshooting - - - - - I get Cannot initialize the Evolution - shell. - - - - - There are a number of things that can cause this error. - Check that: - - - - - - oafd is listed in your PATH - environment variable. - - - - - - GNOME_Evolution_Shell.oaf and - the other       - GNOME_Evolution_*.oaf files are - readable and installed in - $prefix/share/oaf, where - $prefix is one of the prefixes - listed in GNOME_PATH or - OAF_INFO_PATH.  (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. - - - - - - evolution, - evolution-mail and the other - evolution-* executables are in your - $PATH. - - - - - - - - - - I get Cannot open composer window. - - - - - 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 - gnome-gtkhtml-editor is in your - PATH. - - - - - - - - I get Cannot open composer window. - - - - - 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 - gnome-gtkhtml-editor is in your - PATH. - - - - - - - - I updated Evolution and now my addressbook information is gone! - What should I do? - - - - - Evolution uses the libdb library to - handle the addressbook database. Two versions of - libdb can be used with Evolution: version - 1.88 and version 2. - - - - Unfortunately, an Evolution executable that is linked against - a certain version of libdb 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 libdb, - but now it gets linked to a different version. - - - - Because of the way libdb 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. - - - - - - - First of all, check the format of the database using the - file command: - - - - file ~/evolution/local/Contacts/addressbook.db - - - - 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: - - - - - - Quit Evolution. - - - - - - Make a copy of the addressbook database for backup - purposes. - - - - cd ~/evolution/local/Contacts - cp addressbook.db addressbook.db.backup - - - - - - Convert the contacts to the new format using - db_dump185 and - db_load: - - - - db_dump185 ~/evolution/local/Contacts/addressbook.db.backup | db_load ~/evolution/local/Contacts/addressbook.db - - - - - - Restart Evolution. - - - - - - - - - - - Evolution reported an error when trying to retrieve from my - local spool in /var/spool/mail/username. Why? - - - - - Evolution doesn't have an external helper for moving mail, - so /var/spool/mail/ must be writable - by you. Try this: - - - - chmod 1777 /var/spool/mail - - - - We're working on a solution to this problem now. - - - - - - - - Evolution crashes reporting that it couldn't allocate N - billion bytes; how do I fix this? - - - - - 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. - - - - 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. - - - - - - - - What is killev and why do I need to use it? - - - - - 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. - - - - It's always a good idea to run killev - 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.) - - - - - - - - What is oaf-slay and why do I need to use it? - - - - - oaf-slay 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 (oafd) as well - as all the active components on the system. - - - - Using oaf-slay - oaf-slay is quite drastic and can cause - problems with other programs that use oaf, especially with - Nautilus. To avoid problems, do - not run oaf-slay while you are in GNOME. - - - - - - - - Questions about Bugs and Debugging - - Find a bug? Here's how to help us fix it! - - - - - - - Where should I report bugs for Evolution? - - - - - You should report bugs about Evolution into the Ximian bug - reporting system (Bugzilla), located at - http://bugzilla.ximian.com. - - - - Please use the query function to check if a bug has been - submitted already before submitting it. - - - - - - - - Can I just use Bug-Buddy? - - - - - Not yet. The Ximian bug tracker does not yet have an - email-based interface, so Bug Buddy cannot talk to it. This - will be fixed eventually. - - - - - - - What is a stack trace (backtrace) and how do I get one? - - - - - 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. Once we have - bug-buddy working with our - bug database, it will be much easier to do this. Until - then, here's how: - - - 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. - - - Finally, you must put the component that crashes through - gdb, the GNU debugging tool. - To do so, make sure all the components are dead (exit - Evolution and run killev), then run the - following command: - - gdb name-of-component - - - Where "name-of-component" is the name of the component that - crashed. - - - 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 - Evolution normally from a - different terminal. - - - When you have started - Evolution, 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 - info threads. This will give you a - screen that looks like this: - - - -(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 - - - For the most part, only - evolution-mail will have more - than one thread. - - - Now, for each of the threads listed, type the following commands: - -thread N -bt - - Where 'N' is the number of the thread (in this example, 1 - through 8). - - - Cut and paste all the output gdb gives you into a text - file. You can quit gdb by typing - quit - - - 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 gdb as above, but instead - of using r, type attach - PID where PID is the process ID of the - component you want to debug. - - - - - - - - diff --git a/doc/C/evolution.sgml b/doc/C/evolution.sgml deleted file mode 100644 index 08537732d0..0000000000 --- a/doc/C/evolution.sgml +++ /dev/null @@ -1,148 +0,0 @@ - - - - - - - - - - - - - - - - - - -]> - - - - - - - A User's Guide to Evolution - - AaronWeber - KevinBreit - EttorePerazzoli - DuncanMak - - - 2001 - Ximian, Inc. - - - - - - Permission is granted to copy, distribute and/or modify this - document under the terms of the GNU Free Documentation - License, 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 GNU Free Documentation - License from the Free Software Foundation by - visiting their - Web site or by writing to: Free Software Foundation, - Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, - USA. - - - 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. - - - - - This is version 0.11 of the Evolution manual. - - - - - &PREFACE; - - - Using Evolution - - - Part one of the Evolution manual - describes how to use Evolution 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. - - - - &USAGE-MAINWINDOW; - &USAGE-EXEC-SUMMARY; - &USAGE-MAIL; - &USAGE-CONTACT; - &USAGE-CALENDAR; - - &USAGE-SYNC; - &USAGE-PRINT; - - - Configuring and Managing Evolution - - - Evolution 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 - Evolution, "configurable" means - what it ought to. 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. - - - - &CONFIG-SETUPASSIST; - &CONFIG-PREFS; - &CONFIG-SYNC; - - - - Comprehensive Menu reference - - - The following reference covers all, or nearly all, of the - menus and menu commands that - Evolution has to offer you. - - - &MENUREF; - - &FAQ; - &APX-GLOSS; - &APX-BUGS; - &APX-AUTHORS; - - - - - - - - - - - - diff --git a/doc/C/fig/calendar.png b/doc/C/fig/calendar.png deleted file mode 100644 index 9c267d572a..0000000000 Binary files a/doc/C/fig/calendar.png and /dev/null differ diff --git a/doc/C/fig/config-cal.png b/doc/C/fig/config-cal.png deleted file mode 100644 index 5be44dc68d..0000000000 Binary files a/doc/C/fig/config-cal.png and /dev/null differ diff --git a/doc/C/fig/config-mail.png b/doc/C/fig/config-mail.png deleted file mode 100644 index 5fb06c705c..0000000000 Binary files a/doc/C/fig/config-mail.png and /dev/null differ diff --git a/doc/C/fig/contact-editor.png b/doc/C/fig/contact-editor.png deleted file mode 100644 index 988ad2f918..0000000000 Binary files a/doc/C/fig/contact-editor.png and /dev/null differ diff --git a/doc/C/fig/contact.png b/doc/C/fig/contact.png deleted file mode 100644 index 0748b30d69..0000000000 Binary files a/doc/C/fig/contact.png and /dev/null differ diff --git a/doc/C/fig/filter-assist-fig.png b/doc/C/fig/filter-assist-fig.png deleted file mode 100644 index 3240196307..0000000000 Binary files a/doc/C/fig/filter-assist-fig.png and /dev/null differ diff --git a/doc/C/fig/filter-new-fig.png b/doc/C/fig/filter-new-fig.png deleted file mode 100644 index 51fc680df9..0000000000 Binary files a/doc/C/fig/filter-new-fig.png and /dev/null differ diff --git a/doc/C/fig/full-1.png b/doc/C/fig/full-1.png deleted file mode 100644 index 84afc9d3e7..0000000000 Binary files a/doc/C/fig/full-1.png and /dev/null differ diff --git a/doc/C/fig/full-2.png b/doc/C/fig/full-2.png deleted file mode 100644 index 929e356db5..0000000000 Binary files a/doc/C/fig/full-2.png and /dev/null differ diff --git a/doc/C/fig/full-3.png b/doc/C/fig/full-3.png deleted file mode 100644 index 175fd1d970..0000000000 Binary files a/doc/C/fig/full-3.png and /dev/null differ diff --git a/doc/C/fig/full-4.png b/doc/C/fig/full-4.png deleted file mode 100644 index 45d66bb193..0000000000 Binary files a/doc/C/fig/full-4.png and /dev/null differ diff --git a/doc/C/fig/full-5.png b/doc/C/fig/full-5.png deleted file mode 100644 index 5fcfd20e45..0000000000 Binary files a/doc/C/fig/full-5.png and /dev/null differ diff --git a/doc/C/fig/full-6.png b/doc/C/fig/full-6.png deleted file mode 100644 index 484eca4903..0000000000 Binary files a/doc/C/fig/full-6.png and /dev/null differ diff --git a/doc/C/fig/full-7.png b/doc/C/fig/full-7.png deleted file mode 100644 index 8a19eaab42..0000000000 Binary files a/doc/C/fig/full-7.png and /dev/null differ diff --git a/doc/C/fig/mail-composer.png b/doc/C/fig/mail-composer.png deleted file mode 100644 index d85f632b64..0000000000 Binary files a/doc/C/fig/mail-composer.png and /dev/null differ diff --git a/doc/C/fig/mail-druid-pic.png b/doc/C/fig/mail-druid-pic.png deleted file mode 100644 index 18e29aa49d..0000000000 Binary files a/doc/C/fig/mail-druid-pic.png and /dev/null differ diff --git a/doc/C/fig/mail-inbox.png b/doc/C/fig/mail-inbox.png deleted file mode 100644 index 7659cb003a..0000000000 Binary files a/doc/C/fig/mail-inbox.png and /dev/null differ diff --git a/doc/C/fig/mainwindow-pic.png b/doc/C/fig/mainwindow-pic.png deleted file mode 100644 index 18b68c96a5..0000000000 Binary files a/doc/C/fig/mainwindow-pic.png and /dev/null differ diff --git a/doc/C/fig/print-dest.png b/doc/C/fig/print-dest.png deleted file mode 100644 index fb1faf7d70..0000000000 Binary files a/doc/C/fig/print-dest.png and /dev/null differ diff --git a/doc/C/fig/print-preview.png b/doc/C/fig/print-preview.png deleted file mode 100644 index 51ab5e795e..0000000000 Binary files a/doc/C/fig/print-preview.png and /dev/null differ diff --git a/doc/C/fig/vfolder-createrule-fig.png b/doc/C/fig/vfolder-createrule-fig.png deleted file mode 100644 index cc0a7abf66..0000000000 Binary files a/doc/C/fig/vfolder-createrule-fig.png and /dev/null differ diff --git a/doc/C/menuref.sgml b/doc/C/menuref.sgml deleted file mode 100644 index a2a4ea1b32..0000000000 --- a/doc/C/menuref.sgml +++ /dev/null @@ -1,1138 +0,0 @@ - - - - Menu Reference - - Evolution's menus may not hold the - secret to happiness, they do hold every ability that - Evolution has. This section will serve - as a reference for all those menus, and the capabilites that they - offer you. - - - In addition, the editor tools for messages, appointments, and - contacts all have menu bars of their own. From left to right, the - menus available to you when you are reading mail are: - File, Edit, - View, Settings, - Message, Folderand - Help. - - - - Menus in Evolution are - context-sensitive, which means that they vary depending on what - you're doing. If you're reading your mail, you'll have - mail-related menus; for your calendar, you'll have - calendar-related menu items. Some menus, of course, like - Help and File don't much, if - at all, because they have more universal functions. But you'd - never mark an address card as "read," or set the recurrence for an - email message you've recieved. depending on whether you're looking - at mail, contacts, or calendar information. - - - - Mail Menus - - Note that the File menu and the - Help are identical within the - Evolution main window, regardless - of what features you are using. - - - - File Menu - - - - FileNewMail - Message - - - Ctl - N - - - - - - FileNewEvolution - Window - - ShftCtlW - - - - FileNewShortcut - ShftCtlS - - - - FileNewMail - Message - ShftCtlM - - - - FileNewAppointment - ShftCtlA - - - - FileNewContact - ShftCtlC - - - - FileNewTask - ShftCtlT - - - - FileOpen Selected Items - CtlO - - - - FileSave As - CtlAltS - - - - FileFolder - New Folder - ShftCtlF - - - - FileGo to Folder - CtlG - - - - FilePrint - CtlP - - - - FileClose - CtlW - - - - FileExit - CtlQ - - - - - - - Edit Menu - - - EditSelect All - - CtlA - - - EditInvert Selection - CtlI - - - EditDelete - CtlD - - - - EditUndelete - CtlU - - - - EditMark as Read - CtlK - - - - EditMark as Unread - ShftCtlK - - - - - - - - View Menu - - - - ViewThreaded - CtlT - - - - - - - Actions Menu - - - - - ActionsForward - AsInline - - - - - ShftCtlJ - - - - - - - ActionsForward As - Attachment - - - - CtlF - - - - - - ActionsReply - - - CtlR - - - - - - ActionsReply to All - - - ShftCtlR - - - - - - ActionsMove - to Folder - CtlM - - - - - - - ActionsCopy to Folder - - - >CtlC - - - - - - - ActionsApply - Filters - CtlY - - - - - - - ActionsExpunge - - CtlX - - - - - - HelpIndex - - CtlH - - - - - - - - - - - - - - The Message Composer Menus - - The message composition window has its own set of menus: - File, which controls operations on files and - data, Edit, for text editing, - Format, which controls the file format of - messages you send, View, to set how you view - the message, and Insert, which holds tools - for embedding files and other items in messages. Here's what's in them: - - - The Message Composer's File Menu - - - - Open - - Open a text file or a draft mail message. - - - - - Save - - Save a mail message as a text file. - - - - - Save As - - Choose a file name and location for - a message you want to save as a text file. - - - - - Save in Folder - - Save a message as a draft, rather than - as a separate text file. - - - - - Insert Text File - - Open a text file and insert it into - the current message. (FIXME: belongs under "Insert"). - - - - - Send Now - - Sends the message immediately. - - - - - Send Later - - Queue - - - - - Close - - Closes the message composer. If you have not done so, - Evolution - will ask you if you want to save your message. - - - - - - - - - Task List Shortcuts and Menus - - - - - - The Message Composer's Edit Menu - - The Edit menu in the message composer - contains the following items. Keyboard shortcuts are listed - next to the items in the menus themselves. - - - - - Undo - - Undoes the last action you performed. - - - - - Redo - - If you change your mind about Undoing something, - you can always use this item. - - - - - Cut - - Removes the selected text from the text entry window and - retains it in the system "clipboard" memory, ready for pasting. - - - - - Copy - - Copies selected text to the system clipboard without deleting it. - The text can then be inserted elsewhere with the - Paste command. - - - - - Paste - - Inserts the contents of the system clipboard at the - location of the cursor. - - - - - Find - - Enter a phrase and find your match in your message body. - As with Find Regex, - Find Again, and - Replace, Evolution - will offer you the option to search forwards or backwards. - - - - - Find Regex - - If you are familiar with regular expressions, - often called "regexes," you can search for something more complicated, - using wildcards and boolean logic. - - - - - Find Again - - Repeats your last search. - - - - - Replace - - Enter a word or phrase and the word or phrase with which you'd like - to replace it. - - - - - Properties - - This item brings up the Message Composer Properties Capplet, - a portion of the GNOME Control Center that determines the - key bindings for the message composer. Help for this capplet is - available directly from the Control Center. - (FIXME: Write that help doc too) (FIXME: this is in the wrong place!) - - - - - - - - The Message Composer's Format Menu - - The Format menu has only one item: - - - HTML - - Toggles HTML mode for the message composer. When selected, - the message is displayed and sent in HTML. If you have written a - message in HTML and turn HTML off, most formatting will be lost. - Evolution will attempt to preserve spacing - and to remove formatting gracefully, however. - - - - - - - The Message Composer's View Menu - - The View menu controls the way messages are - displayed, and how much of the message, its headers, and - attachments appear. It contains: - - - Show Attachments - - Toggles the display of attachments. When this item is selected, - Evolution will create a separate pane - of the composition window to show what attachments you are appending - to the message. - - - - - - - The Message Composer's Insert Menu - - The Insert menu holds tools that allow you - to include images, horizontal rules, and other objects - in the body of your message. The tools are: - - - - Image - - This tool will prompt you to select an image file to - insert into your HTML message. For text messages, this - is the same as attaching an image file. - - - - - Link - - Opens the link creation window, - which lets you specify the URL and text description - for a link in your message. This only works with HTML - messages. - - - - - Rule - - Opens the horizontal rule creation dialog, which lets you - create an HTML horizontal rule. For more information, - see . - This tool only works with HTML messages. - - - - - Text File - - Open a text file and insert it into the current message. - This tool works with both plain text and HTML messages. - - - - - - - - - The Calendar Menus - - The Main window of the calendar has the same menus as the main - window of the mail client. However, their contents vary in a - number of ways. - - - The Calendar Edit Menu - - The contents of the Edit menu are currently so borked that I - refuse to document them right now. (That means FIXME). They - should be: - - - - Item - - Description - - - - Item - - Description - - - - - Item - - Description - - - - - - - The Calendar View Menu - - The Calendar's View menu contains the following items: - - - - Show Shortcut Bar - - Toggle the Shortcut Bar on and off with this item. - - - - - Show Folder Bar - - Toggle the folder bar on and off with this item. - See for - more information about the folder bar. - - - - - View By Day - - Switch to the day view for your calendar. - - - - - View Five Days - - View five calendar days at once. - - - - - View by Week - - Switch the calendar view to full week mode. - - - - - View By Month - - Look at a month at a time. - - - - - - - - The Calendar Settings Menu - - This menu is empty. - - - - - - - The Appointment Editor Menus - - The appointment editor has its own menus, to help you use its - wide-ranging abilities. - - - - The Appointment Editor's File Menu - - This menu contains several items, including a - FileNew - submenu that is identical to that in the main window. The - other contents are: - - - - Send - - Opens a mail message with the appointment attached to it. - - - - - - Save - - Save this appointment in the existing location and name. If you have not yet - chosen a location and name, this is the same as Save As. - - - - - - Save As - - Choose a location and name for this appointment, and save it. - - - - - Delete - - Deletes the appointment. - - - - - Move to Folder - - Chose a folder, and move the appointment into it. - - - - - - Copy to Folder - - Chose a folder, and put a copy of the appointment into it. - - - - - - Page Setup Submenu - - This menu contains two items: - - - Memo Style — - FIXME: What does this do? - - - - Define Print Styles — - FIXME: What does this do? - - - - - - - Print Preview - Shows you what your appointment will look - like if you print it. See - for details on printing and the Print Preview function. - - - - - - Print - - Prints the appointment without preview. - - - - - - Properties - - FIXME: What does this do? - - - - - - Close - - Close the appointment editor window. - - - - - - - - The Appointment Editor's Edit Menu - - FIXME: this menu is copied and pasted entirely from somewhere - else. - - - - - The Appointment Editor's View Menu - - This menu allows you to look at different appointments, and - set the way you look at them, without having to move back to - the Main Window. It contains: - - - - Previous - - The items in this submenu will take you to appointments - prior to the current one. (FIXME: describe). - - - - - Next - - The items in this submenu will take you to appointments - scheduled to occur after the current one. (FIXME: describe). - - - - - Calendar - - FIXME: What does this item do? - - - - - Toolbars - - The Toolbars submenu - allows you to choose which toolbars - are displayed in the - Appointment Editor. They are: - - - Standard — - Toggle the standard toolbar on and off. - - - - Formatting — - Toggle the formatting toolbar on and off. - - - - Customize — - Select the contents of the formatting and standard toolbars. - - - - - - - - - - The Appointment Editor's Insert Menu - - This menu contains: (FIXME: Insert Content Here) - - - File - - Choose a file to append to your appointment or appointment request. - - - - - - Item - - FIXME: ? - - - - - - Object - - FIXME: ? - - - - - - - - The Appointment Editor's Format Menu - - This menu contains two items, neither of which - have any functionality yet: - - - Font - - FIXME: ? - - - - - - Paragraph - - FIXME: ? - - - - - - - - The Appointment Editor's Tools Menu - - This menu contains four items, including the - Forms submenu, which allows you to - alter calendar forms and create your own entries. None of - this works yet, though. - - - - - Spelling - - Checks the spelling of your calendar entry. - - - - - Check Names - Checks the names listed here against - those in your address book. - - - - - - Address Book - - FIXME: ? - - - - - - Forms Submenu - - The Forms submenu lets you alter the - appearance of Calendar Forms. - - - - - - - - - The Appointment Editor's Actions Menu - - This menu contains: - - - - Schedule Meeting - - Brings up the Meeting Invitation window, - described in . - - - - - Cancel Invitation - - Cancels the event, notifying all attendees. You may be prompted - to specify an invitation message. - - - - - Forward as vCalendar - - Opens the message composer with the current event attached. - - - - - Forward as Text - - Opens the message composer with a text description of the current - event included in the message body. - - - - - - - - The Appointment Editor's File Menu - - This menu is empty. - - - - - - - Contact Manager Menus - - The contact manager has six menus: File, - Edit, View, - Settings, Tools, and - Help. - - - - Contact Manager Edit Menu - - This menu is empty. - - - - - - Contact Manager View Menu - - This menu contains the following items: - - - - Show Shortcut Bar - - Toggle the Shortcut Bar on and off with this item. - - - - - Show Folder Bar - - Toggle the folder bar on and off with this item. - See for - more information about the folder bar. - - - - - As Table / As Minicards - - View your contacts as a table. - When in table-view mode, this menu item reads - As Minicards, and changes the view - back to the minicard format. - - - - - - - - Contact Manager Tools Menu - - This menu contains one item: - - - - Search for - Contacts Brings up - the in-depth search window. describes how to use this - feature. - - - - - - - - - Contact Manager Tools Menu - - This menu contains only one item: - - - - New Directory Server Brings up - the in-depth search window. describes how to use this - feature. - - - - - - - - - The Contact Editor Menus - - This window has only one menu: the file menu. - - - - Contact Editor File Menu - - This menu contains five items: - - - - Save - - - - - - - Save As - - Allows you to save the contact as an external - file in the VCard format. - - - - - Print - - Prints the current contact. - - - - - - Delete - - Deletes the current contact. - - - - - - Close - - Closes the Contact Editor without saving. - - - - - - - - - - - - - - - - - diff --git a/doc/C/preface.sgml b/doc/C/preface.sgml deleted file mode 100644 index 967c739ddf..0000000000 --- a/doc/C/preface.sgml +++ /dev/null @@ -1,557 +0,0 @@ - - - - - Introduction - - - What is Evolution, and What Can It Do for Me? - - Information is useless unless it's organized and accessible; - it's hardly even worth the name if you can't look at it and be - informed. - Evolution's goal is to make the - tasks of storing, organizing, and retrieving your personal - information easier, so you can work and communicate with - others. That is, it's a highly evolved groupware program, an integral - part of the Internet-connected desktop. On the inside, it's a - powerful database; on the outside, it's a tool to help you get - your work done. - - - Because it's part of the GNOME project, - Evolution is Free Software. The - program and its source code are released under the terms of - the GNU General - Public License (GPL), and the - documentation falls under the Free Documentation - License (FDL). For more information about - the GPL and the FDL, visit the Free Software Foundation's - website at http://www.fsf.org. - - - - This is a preview release - - Evolution is not complete, and - still has a lot of flaws. Please help improve it by - letting us know about them. You should do this on the - Ximian GNOME bug report page at bugzilla.ximian.com. There - are detailed bug reporting instructions in . - - - - - - Evolution can help you work in a - group by handling email, address and other contact - information, and one or more calendars. It can do that on one - or several computers, connected directly or over a network, - for one person or for large groups. - - - The Evolution project has four - central goals: - - - - - The application must be both powerful and easy - to use. In other words, it needs a familiar - and intuitive interface that users can customize to their - liking, and users should have access to shortcuts for - complex tasks. - - - - - Evolution must meet and - exceed the standards set by other groupware products. - It must include support for major network protocols so that it can - integrate seamlessly with existing hardware and network - environments. - - - - - The project must support open standards and be open to - expansion, so that it can become a development platform - as well as an application. From the simplest scripting - to the most complex network and component programming, - Evolution must offer - developers an environment for cutting-edge application - development. - - - - - Data must be safe: Evolution - must not lose mail, corrupt mailbox files or other - data, execute arbitrary scripts, - or delete files from your hard disk. - - - - - - Evolution is designed to make most - daily tasks faster. For example, it takes only one or two - clicks to enter an appointment or an address card sent to you - by email, or to send email to a contact or appointment. - Evolution makes displays faster and - more efficient, so searches are faster and memory usage is - lower. People who get lots of mail will appreciate advanced - features like - Virtual Folders, which let you save searches as though - they were ordinary mail folders. - - - - - - About This Book - - - This version of the Evolution - User's Guide is a draft. Please send - comments on the guide to aaron@ximian.com. The - first person to send me some good constructive criticism wins - a free Ximian t-shirt. Include preferred shirt size and postal - address. If you would like to work on the guide please contact - me or see the GNOME Documentation project web - site. - - - - - This book is divided into two parts, with several - appendices. The first part is a guided - tour— it will explain how to use - Evolution. If you are new to - Evolution or to groupware in - general, this section is for you. The second section, covering - configuration, is targeted at - more advanced users, but anyone who wants to change the way - Evolution looks or acts can benefit - from reading it. In addition, there is a comprehensive menu reference which describes nearly - every capability that Evolution has - to offer. - - - Typographical conventions - - Some kinds of words are marked off with special typography: - - Applications - Commands typed at the command line - Labels for interface items - - Menu selections look like this: - - Menu - Submenu - Menu Item - - - Buttons you can - click Anything you type - in Text - output from a computer - Words - that are defined in the . - - - - - - Evolution Interface Introduction - - Evolution follows a consistent UI. This means - that in each component, you will find many UI characteristics the same as - others components. - - -
- Evolution's Interface - - Inbox - - - -
- - - - Menubar - - - - The Menubar gives you access to nearly all the - features that can be found in Evolution. - - - - - Toolbar - - - - The Toolbar gives you fast and easy access to the - most used features in each component. - - - - - Shortcut Bar - - - - The Shortcut Bar lets you go to your favorite - components with a click of a button. You can even add your favorite - folders to the Shortcut Bar. - - - - - Status Bar - - - - Periodically, Evolution will need to quietly - display a message, or tell you the progress of something. This most - often happens when you're checking or sending email. These progress - queues are shown here, in the Status Bar. - - - - - Search Bar - - - - The Search Bar lets you search through your email - with precision so you can easily find what you're looking for. - - - - - Quick Reference for Common Tasks - - 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 - Evolution. Read if - you would like a complete list of keyboard shortcuts for menu commands. - - - - Opening or Creating Anything - - - - - - Create a new folder - - - FileNew - Folder or - - Ctrl - Shift - F - - - - - - - Create a new Shortcut in the Evolution Bar - - - File - New - Evolution Bar Shortcut or - - Ctrl - Shift - S - - - - - - - Create a new email message: - - - Use - FileNewMail - Message or - - Ctrl - Shift - M - - - - - - - Create a new Appointment - - - File - New - Appointment or - - Ctrl - Shift - A - - - - - - - - Enter a new Contact - - - File - New - Contact or - - Ctrl - Shift - C - - - - - - - - Create a new Task - - - File - New - Task or - - Ctrl - Shift - T - - - - - - - - - - Mail Tasks - - Here are the most frequent email tasks, and shortcuts for - navigating your mailbox with the keyboard instead of the - mouse: - - - Check Mail - - - Click Get Mail in the - toolbar. There is no keyboard shortcut for this task, - but you can ask Evolution - to check for new mail periodically in the - Mail Settings dialog. - - - - - - Reply to a Message - - - To reply to the sender of the message only: - click Reply in the - toolbar, or press - - Ctrl - R - - - - To reply to the sender and all the other visible - recipients of the message, click Reply to - All or select the message and press - - Shift - Ctrl - R - - - - - - - Forward a Message - - - Select the message or messages you want to forward, - and click Forward in the - toolbar, or press - - Ctrl - J - - - - - - - Open a Message in a New Window - - - Double-click the message you want to view, or select - it and press - - Ctrl - O - - - - - - - Create Filters and Virtual Folders - - - You can create filters and Virtual Folders based on - specific message attributes from the message's - right-click menu. Alternately, select a message, and - then choose Settings - Mail Filters - or Settings - Virtual Folder Editor - . Filters are discussed in , and Virtual - Folders in . - - - - - - - - - Calendar - - - - - - - - - - - - - - - - Contact Manager - - Here are the most frequent tasks that are done in the Contact Manager, - with the shortcuts so that you can use these tasks without having to use - your mouse: - - - - Edit a User - - - You can edit a user two ways: - - - - Single click on the person's "rolodex card" and you can - edit the person's properties all in the same window. - - - - - Double-click on the contact's card. - - - - - - - - - - - Deleting a Contact - - - Right click on a contact and click Delete - or select a contact and press the Delete - on the toolbar. - - - - - - - - - Email a Contact - - - Right click on a contact and click on - Send message to contact. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/doc/C/usage-calendar.sgml b/doc/C/usage-calendar.sgml deleted file mode 100644 index 9d257ab651..0000000000 --- a/doc/C/usage-calendar.sgml +++ /dev/null @@ -1,439 +0,0 @@ - - - - The Evolution Calendar - - To begin using the calendar, select - Calendar from the shortcut - bar. By default, the calendar starts showing today's - schedule on a ruled background. At the upper right, there's a - monthly calendar you can use to switch days. Below that, there's - a TaskPad, where you can keep a list of tasks - seperate from your calendar appointments. The calendar's daily - view is shown in . - - -
- Evolution Calendar View - - Evolution Contact Manager Window - - - -
- - - - - - - Event List - - - - The Event List is responsible for showing you all of - your scheduled events, whether they are all day events or simply one time - events that last a half an hour. - - - - - Todo List - - - - The Todo List compliments the Event List - as it keeps track of your chores or tasks which don't have - any time associated with them. These may include "Clean Room" or "Call - Repairman". - - - - - Calendar Window - - - - The Calendar Window has a graphical representation of - the calendar, so you can select what days to view in the Event - List. - - - - Ways of Looking at your Calendar - - - The toolbar offers you four different views of your calendar: - one day, five days, a week, or a month at once. Press the - calendar-shaped buttons on the right side of the toolbar to - switch between views. You can also select a range of - days— three days, ten days, a fortnight if you want - — in the small calendar at the upper right. - - - The Prev and Next - 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, - month, fortnight, or anything else, you'll move around by just - that much. To come back to today's listing, click - Today. - - - To visit a specific date's calendar entries, click - Go To and select the date in the dialog - box that appears. - - - - - - - - Scheduling With the Evolution Calendar - - 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 - events, set alarms, and determine event recurrence. - - - Creating events - - To create a new calendar event, select - - File - New - Appointment - - or click the New button on the left end - of the toolbar. The New Appointment - dialog will pop up with the usual menu bar, tool bar, and - window full of choices for you. - - - Shortcut - - 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. - - - - - Your event 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 All - day event. An All day event - appears at the top of a day's event list rather than inside - it. That makes it easy to have events that overlap and fit - inside each other. For example, a conference might be an all - day event, and the meetings at the conference would be timed - events. Of course, events 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. - - - Doing Two Things At Once - - If you create calendar events that overlap, - Evolution will display them side - by side in your calendar. However, - Evolution cannot help you do - multiple things at once. - - - - You can have as many as four different - Alarms, any time prior to the event - you've scheduled. You can have one alarm of each type: - - - Display - - - A window will pop up on your screen to remind you of - your event. - - - - - Audio - - - Choose this to have your computer deliver a sound - alarm. - - - - - Program - - - 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 Browse - button. - - - - - Mail - - - Evolution will send an - email reminder to the address you enter into the text - field. - - - - - - - - Classification - and only applies to calendars on a - network. Public is the default category, - and a public event can be viewed by anyone on the calendar - sharing network. Private denotes one - level of security, and Confidential a - higher level. Exact determinations and - implementations of this feature have yet to be - determined. - - - Evolution allows for categorizing your - appointments, which can help if you lead a busy life. The bottom - section of the Appointment tab is where your - categorization is done. - - - - Adding a New Category - - You can add a new cateogry to your category list by clicking on - Edit Master Category List... and single-clicking - on * Click here to add a category *. - - - - - The purpose of categories is to let you view all appointments which have - similar activities. To do this, change Any field contains - to Has category and enter your category at right. - - - - Clicking on the Categories button opens up the category - list. To assocate a category to an event, simply click the check box. - - - Once you've selected your categories, click OK to - assign these categories to the event. The categories you selected are now - listed in the text box to the right of the Categories... - button. - - - - The Recurrence tab lets you describe - repetition in events ranging from once every day up to once - every 100 years. You can then choose a time and date when the - event will stop recurring, and, under - Exceptions, pick individual days when the - event will not 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." - - - - Once you're done with all those settings, click on the disk - icon in the toolbar. That will save the event and close the - event editor window. If you want, you can alter an event - summary in the calendar view by clicking on it and typing. You - can change other settings by right-clicking on the event then - choosing Edit this Appointment. - - - - - - - - - The Task Pad - - The Task Pad, located in the lower right corner of the - calendar, lets you keep a list of tasks separate from your - calendar events. Tasks are colored and sorted by priority and - due-date (see for more - information), and are included with calendar data during - synchronization with a hand-held device. You can use the list - in a larger format by choosing the Tasks - button in the shortcut bar or in the folder tree. - - - To record a new task, click the Add - button below the list. Evolution - will pop up a small window with five items in it: - - - - Summary: - - - The description you enter here will appear in the To Do - list itself. - - - - - - Due Date: - - - Decide when this item is - due. You can either type in a date and time, or select one from - the Calendar and time drop-down menus. - - - - - Priority: - - - Select a level of importance from 1 (most important) to 9 - (least important). - - - - - Item Comments: - - - If you wish, you can keep a more detailed description of - the item here. - - - - - - - Once you've added a task to your to-do list, its summary - appears in the Summary section of task - list. To view or edit a detailed description of an item, - double-click on it, or select it and click - Edit. You can delete items by selecting - them and clicking on the Delete button. - - - - - Multiple Calendars - - Evolution 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. - - - - Keeping Multiple Calendars - - Keelyn, the office manager for a small company, has one - calendar for her own schedule. On the local network, she - maintains one for the conference room, so people know when - they can 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 Red Sox are - playing. - - - - To create a new calendar, select - - File New - Calendar - . - You can place the calendar in any calendar folder and access it - from the folder view. Alarms, configuration, and display for - each calendar are separate from each other. - - - - - - - - - - - - - - diff --git a/doc/C/usage-contact.sgml b/doc/C/usage-contact.sgml deleted file mode 100644 index 887050fc5c..0000000000 --- a/doc/C/usage-contact.sgml +++ /dev/null @@ -1,626 +0,0 @@ - - - - The Evolution Address Book - - - The Evolution address book can - handle all of the functions of an address book, phone book, or - Rolodex. Of course, it's a lot easier to update - Evolution than it is to change an - actual paper book. Evolution also - allows easy synchronization with hand-held devices. Since - Evolution supports the LDAP directory protocol, you can use - it with almost any type of existing directory server on your - network. - - - Another advantage of the Evolution - address book is its integration with the rest of the - application. When you look for someone's address, you can also - see a history of appointments with that person. Or, you can - create address cards from emails with just a few clicks. In - addition, searches and folders work in the same way they do in - the rest of Evolution. - - - This chapter will show you how to use the - Evolution address book 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 address book, see . - - - - Getting Started With the Address Book - -
- Evolution Contact Interface - - Evolution Contact List Window - - - -
- - - - Contact List - - - - The Contact List lists your contacts which you - entered. - - - - To open up your address book, click on - Contacts in the shortcut bar, or select - one of your contacts folders from the folder bar. shows the address book in all - its organizational glory. By default, the address book - shows all your cards in alphabetical order, in a minicard format. You can select - other views from the View menu, and adjust - the width of the columns by clicking and dragging the grey - column dividers. - - - - The toolbar for the address book is quite simple: - - - New creates a new card. - - - - Find brings up an in-depth search window. - - - - Print sends one or more of your cards to the printer. - - - Delete deletes a selected card. - - - View All displays all - the address information in the folder. Use this button to - refresh the display for a network folder, or to switch from - viewing the results of a search and see the whole contents. - - - Stop stops loading - contact data from the network. This button is only - relevant if you are looking at contact information on a - network. - - - - - Your contact information fills the rest of the display. Move - through the cards alphabetically with the buttons and the - scrollbar at 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. - - - - Searching for Contacts - - Between Delete and View - All is a quick search field. To use it, select - from the drop-down list which sort of search you'd like to - perform (the whole card, just the name, or just the email - address), then enter one or more words in the text entry - box, and press Enter. - Evolution will search through - the contents of every displayed card to find one that - matches. You can refine searches by doing several in - succession, or start over by pressing the View - All button. - - - If there are no matches, the card display will be - blank. When you'd like to see all the cards again, press - Show All. - - - Refining a Quick Search - - 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. - - - 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 - Evolution narrows it down to the - right Curtis. He only becomes annoyed when he discovers that - the call was not actually important. - - - - - If you prefer to perform a more complex search, press - Find or choose - ToolsSearch for - Contact. This will open the - in-depth search window, which lets you use multiple search - criteria in the same way that email filters and virtual folders do.. - - Click Add Criterion to increase the - number of criteria you'd like to use in the search, and - Remove Criterion to remove one from the - bottom of the list. Your criteria may be a search within the - Name or Email - fields; alternately you can choose to search through all the - fields with a regular expression. Then, you can select from - all the familiar requirements like Begins - With and Does Not Contain, - decide whether to match All or - Any of your criteria, and press - Search to set it all off. - - - - - - - Destroy, Create, and Change: The Contact Editor - - To delete a card, click on it once to select it, then press the - Delete button. If you have multiple - cards selected, you'll delete multiple cards. - - - 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 with all the current - information already filled in. If you want to create a new - one, clicking the New button in the - toolbar will open the same window, with blank entry boxes for - you to fill in. - - - - The contact editor window has two tabs, - General, for basic contact information, - and Details, for a more specific - description of the person. In addition, it contains a - File menu, (see ) and a toolbar with three - items: Save and Close, - Print, and Delete. - - -
- Evolution Contact Editor - - Evolution Contact Editor - - - -
- - The General 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. - - - - - - Full Name - - - The Full Name field has two - major features: - - - - You can enter a name into the Full - Name field, but you can also click the - Full Name button to bring - up a small dialog box with a few text boxes - - - Title: - - Enter an honorific or select one from the menu. - - - - First: - - Enter the first, or given, name. - - - - Middle: - - Enter the middle name or initial, if any. - - - - Last: - - Enter the last name (surname). - - - - Suffix: - - Enter suffixes such as "Jr." or "III." - - - - - - - - The Full Name field also - interacts with the File As - box to help you organize your contacts. - - - To see how it works, type a name in the - Full Name field: - Rupert T. Monkey. You'll - notice that the File As field - also fills up, but in reverse: - Monkey, Rupert. - You can pick Rupert Monkey - from the drop-down, or type in - your own, such as T. Rupert Monkey - . - - - Filing Suggestion - - - 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." - - - - - - - - - Multiple Values for Fields - - - If you click on the small arrow buttons next to the - Primary Email field, you can also - choose Email 2 and - Email 3. Although the contact - editor will only display one of those at any given - time, Evolution will - store them all. The arrow buttons next to the - telephone and postal address fields work in the same - way. - - - - - - - The last item in the General tab is the - Categories organization tool; for - information on that, read . - - - The Details tab is, fortunately, much more - simple: three sections, all of which are more or less obvious: - the briefcase next to the details about the contact's - professional life; the face next to the details about their - personal life; the globe next to a big blank space you can use - for anything and everything else you'd like to note about them. - If you ever wanted to have that uncanny knack for remembering - obscure details like the date of someone's anniversary (perhaps - your own) this is the way to develop it. - - - - - - - - - - - Organizing your Address Book - - Organizing your address book is a lot like organizing your - mail. You can have folders and searches the same way you can - with mail, but the address book does not allow vFolders. It - does, however, allow each card to fall under several - categories, and allow you to create your own categories. To - learn about categories, read . - - - - - - Groups of contacts - - Evolution offers two ways for you - to organize your cards. The first way is to use folders; - this works the same way that mail folders do. For more - flexibility, you can also mark contacts as members of - different categories. - - - - Grouping with Folders - - The simplest way to group address cards is to use folders. - By default, cards start in the - Contacts folder. If you've read then you already know that you - can create a new folder by selecting - - File - New - Folder - - 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 . - - - 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. - - - - - Grouping with Categories - - The other way to group cards is to mark them as belonging - to different categories. The difference between folders - and categories is that folders contain cards, but category - membership is a property of each card. 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. - - - To mark a card as belonging to a category, click the - Categories button at the lower - right. From the dialog box that appears, you can check as - many or as few categories as you like. - - - Then, you can refer to all the cards in that category by: - Waiting for Evolution to support the - operation. - - - - - - - - - - Sharing your Cards - - If you keep your cards on a network using an LDAP server, you can share access to - them, browse other address books, or maintain a shared set of - contact information for your company or your department. This - is the sort of feature you'll want to use if your company has a - list of vendors and clients that needs constant updating. If - share calendars as well as address books, people can avoid - duplicating work and keep up to date on developments within - their work-group or across the entire company. - - - - Sharing Address Cards and Calendar Data - - Ray 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. - - - - 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. - - - To learn how to add a remote directory to your available - contact folders, see . - Once you have a connection, the network contacts folder or - folders will appear inside the External - Directories folder in the folder bar. It will work - exactly like a local folder of cards, with the following - exceptions: - - - - - 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 and then synchronize your copy with - the networked version periodically. - - - - - - To prevent excess network traffic, - Evolution will not normally - load the contents of LDAP folders immediately upon - opening. You must click Display - All before LDAP folder cards will be loaded - from the network. You can change this behavior in the - Contact Preferences window. - - - - - Your ability to view, change, add, and delete contacts - depends on the settings of the LDAP server. - - - - - - - - Address Book Tools - - The address book works closely with - Evolution's mail and calendar tools. - For example, you can use the address book to help you manage - mailing lists, and send or recieve address cards over email. - More tools are on the way, and when they arrive, - they will be described in this section. - - - - Send me a Card: Adding New Cards Quickly - - 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 Add Address - Card from the menu that appears. Of course, - Evolution also adds cards from a - hand-held device during HotSync operation. For more - information about that, see . - - - - - Managing a Mailing list - - You already know that when you are writing an email, you can - address it to one or more people, and that - Evolution will fill in addresses - from your address book's address cards if you let it. In - addition to that, you can send email to everyone in a - particular group if you choose. - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/doc/C/usage-encryption.sgml b/doc/C/usage-encryption.sgml deleted file mode 100644 index e36f17c652..0000000000 --- a/doc/C/usage-encryption.sgml +++ /dev/null @@ -1,147 +0,0 @@ - - -
- - - What is Encryption? - - Encryption is an ancient method of changing readable text to unreadable - text that dates back to Egyptian times. Encryption takes the statement - "Evolution" and turns it into something which cannot be read without help - through decryption. - - Encryption Example - - Kevin orders an Evolution t-shirt from - Ximian, Inc. over the internet. He puts in his credit card number - which is 1234-567-8901. For security, his computer encrypts the - credit card number so it can be safely transmitted over the internet. - The number now is @#$23ui7yr87#@!48970fsd, which holds no intentional - resemblance to the inital number. When the information gets to - Ximian, Inc. it'll be decrypted into the inital number. - - - Encryption can be used in email in two ways: to verify that the sender is - the real sender, and to hide the message while in transmission. - Evolution has the capability to do both. - - - - Generating your PGP key - - First, you need to create a PGP key. To do this, you'll need GPG - installed. - - - GPG Versions - - This manual covers version 1.0.6 of GPG. If your version is different, - this may not be entirely accurate. You may find out your version number - by typing in: gpg --version. - - - - You can start by typing in: gpg --gen-key. At the - first question, select 1. The next question asks you about key length. - The longer the key, more stronger it is. However, the longer the key, the - longer it takes to generate. This is your choice. However, 1024 bits - (default) should be adequate. The next question asks you if you want your - key to expire. Expiring keys make your key invalid after a certain amount - of time, so old keys don't float around active. This is the same concept - as a coupon at a supermarket. Next, you'll type in your Real name, your - email address, and a comment. You should not forge this information, as - it is used later to verify who you are. Assuming that all your - information is correct, press "O" to continue. GPG now asks you for a - passphrase. This is a password which you will need to decrypt and encrypt - messages. This can be any length, with any characters in it. It is case - sensitive, which means that it does know the difference between capital - letters and lower-case. Now your key is generated. It is recommend you - surf the internet, read your email, or write a letter in a word - processor. This help creates randomness in the key. - - - Once this is completed, you'll be dropped back to the command line. - Now you can view your key information by typing gpg - --list-keys. You should see something similar to this: - - GPG Listing Keys - - /home/bob/.gnupg/pubring.gpg - ---------------------------- - pub 1024D/32j38dk2 2001-06-20 bob <bob@bob.com> - sub 1024g/289sklj3 2001-06-20 [expires: 2002-11-14] - - - You'll now need to upload your public key to a keyserver, so that your - friends can use your key. You'll need to know the ID of your key, which - is after the 1024D on the line beginning with pub. For this example, it - is 32j38dk2. You now type in gpg --send-keys --keyserver - wwwkeys.pgp.net 32j38dk2. Substitute your key ID for 32j38dk2. - You will be prompted to type in your password and your key will be uploaded for your - friends to download. - - - - Setting up Evolution's Encryption - - You'll need to open - - Tools - Mail Settings - - Once there, select the account you'd like to associate the key to and click - the Edit button. In the - Security tab is a section labeled Pretty - Goog Privacy. Enter your key ID and click - OK. Your key is now integrated into your identity - in Evolution. - - - - Sending Encrypted Messages - - You can either sign or encrypt a message. When you sign a message, verify - that you were the one who sent it, and that no one is forging your - identity. Encrypting a message makes it impossible for someone with - prying eyes to view it while it's in tranmission. - - - - Signing a Message - - To sign a message, you simply click - - Security - PGP Sign - - . You will be prompted for your PGP password. Once you enter it, - click OK and your message will be signed. - - - - Encrypting a Message - - Encrypting a message is very similar to signing a message. You simply - click the menu item - - Security - PGP Encrypt - - - - - - - Unencrypting a Recieved Message - - Sometimes, a friend will send you a message which is encrypted. In order - for you to read it, you need to unencrypt it. - - - When you view the encrypted message, Evolution - will prompt you for your PGP password. You type in your PGP password and - the message is then decrypted. - - -
diff --git a/doc/C/usage-exec-summary.sgml b/doc/C/usage-exec-summary.sgml deleted file mode 100644 index a2a0860b85..0000000000 --- a/doc/C/usage-exec-summary.sgml +++ /dev/null @@ -1,87 +0,0 @@ - - My Evolution - - My Evolution is designed to show you a - summary of important information: the appointments for a given - day, important email, and so forth. To see your My Evolution. - , click on the My Evolution - button in the shortcut bar, or select the - My Evolution folder in the folder - bar. - - - - Introducing the My Evolution - - The first thing you'll want to do with the My Evolution - is add a service. Click the Add Service - button in the toolbar, then select one of the available - services. Services may vary depending upon your system, but - most installations will have at least the following options: - - - - - Calendar - - - Pending appointments and other events for that day. - - - - - - Inbox - - - Information about your mail, such as the number of - new messages you have waiting. - - - - - - To Do - - - A short summary of your task pad. - - - - - - RDF Summary - - - News headlines from sites that allow this - feature. The default - is news about the GNOME project from gnotices. - - - - - - - - - - Each service appears in a small box on the screen; you can - remove the service by clicking the x - button in the upper right, or bring up a settings dialog by - clicking the little wrench icon below that. - - - - - diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml deleted file mode 100644 index d05565e27e..0000000000 --- a/doc/C/usage-mail.sgml +++ /dev/null @@ -1,1622 +0,0 @@ - - - - Evolution Mail - - A Guide to the Evolution Mailer - - Evolution email is like other email - programs in all the ways you would hope: - - - - It can sort and organize your mail in a wide variety of ways with - folders, searches, and filters. - - - - - It can send and receive mail in HTML or as plain text, and - permits multiple file attachments. - - - - - It supports multiple mail sources, including IMAP, POP3, local - mbox and - mh files, and - even NNTP messages (newsgroups), which aren't technically - email. - - - - - - However, Evolution has some important - differences. First, it's built to handle very large amounts of - mail without slowing down or crashing. Both the filtering and searching functions - were built for speed and efficiency on gargantuan volumes of - mail. There's also the Evolution - Virtual - Folder, an advanced organizational feature not found in - many other mail clients. If you get a lot of mail, or if you keep - every message you get in case you need to refer to it later, - you'll find this feature especially useful. - - - - - - Reading, Getting and Sending Mail - - - Reading Mail - - You can start reading email by clicking - Inbox in the shortcut bar. The first - time you use Evolution, it will - start with the Inbox open and show you a - message from Ximian welcoming you to the application. - - - Your Evolution - Inbox will look something like the one in - . - If you find the view pane too small, you can resize - the pane, enlarge the whole window, or double-click on the - message in the message list to have it - open in a new window. To change the sizes of a pane, just click - and hold on the divider between the two panes. Then you can drag - up and down to select the size of the panes. Just like with - folders, you can right-click on messages in the message list and - get a menu of possible actions. - - - - -
- Evolution Mail - - Inbox - - - -
- - - - - - - Email Viewer - - - - This is where your email is displayed. - - - - - Email List - - - - The Email List lists off all the emails that you - have. This includes all your read, unread, and email that is flagged to - be deleted. - - - - - Most of the mail-related actions you'll want to perform are - listed in the Message menu in the menu - bar. The most frequently used ones, like - Reply and - Forward, also appear as buttons in - the toolbar, and almost all of them are duplicated in the - right-click menu and as keyboard shortcuts, which tend to be - faster once you get the hang of them. You can choose - whichever way you like best; the idea is that the software - should work the way you want, rather than making you work the - way the it does. - - Take a look at the headers - - To look at the entire source of your email message, including - all the header information, select - ViewSource - - - - - - Sorting the message list - - One of the ways Evolution lets - you choose the way you work is the way it lets you sort your - message lists. To sort by sender, subject, or date, click - on the bars with those labels at the top of the message - list. The direction of the arrow next to the label indicates - the direction of the sort, and if you click again, you'll - sort them in reverse order. For example, click once on - Date to sort messages by date from - oldest to newest. Click again, and - Evolution sorts the list from - newest to oldest. You can also right-click on the message - header bars to get a set of sorting options, and add or - remove columns from the message list. You can find detailed - instructions on how to customize your message display - columns in . - - - You can also choose a threaded message view. Select - View - Threaded to turn - the threaded view on or off. When you select this option, - Evolution groups the replies to a - message with the original, so you can follow the thread of a - conversation from one message to the next. - - - - Deleting Mail - - Once you've read your mail, you may want to get rid of - it. To mark a message for deletion, select it in the the - message list by clicking on it once. - Then click on the Delete button in - the tool bar. Or, right-click on a message and choose - Delete from the right-click - menu. The message will appear with a line through it, to - show that you've marked it for deletion. - - - If you change your mind and decide you want to keep it, - select Message - Undelete. If you - really want to get rid of it, choose - Expunge from the - Folder menu. That will delete it - permanently. - - - - - - Checking Mail - - Now that you've had a look around the - Inbox, it's time to check for new mail. - Click Get mail in the toolbar to check - your mail. If it's the first time you've done so, the - mail setup assistant will ask you for - the information it needs to check your mail (see for more information). - - - Then, you need to enter your email - password. Evolution will remember - your password until until you select - Settings Forget - Passwords . - - - Once it's validated the password, - Evolution will check your mail. - New mail will appear in the local Inbox - if you're using a POP account, and in - your IMAP folders if you use IMAP. If - you have chosen to use IMAP, and you have multiple folders on - your IMAP server, you may need to subscribe to them. To learn - how to use the subscription manager, read . - - - - Can't Check Mail? - - If you get an error message instead of mail, you probably need - to change your network settings. To learn how to do that, - have a look at , or - ask your system administrator. - - - - - Using Evolution for News - - Newsgroups are so similar to email that there's no reason not - to read them side by side. If you want to do that, add a - news source to your configuration (see ). The news server will - appear as a remote server, and will look quite similar to an - IMAP folder. When you click Get Mail, - Evolution will also check for news - messages. - - - - - Attachments and HTML Mail - - If someone sends you an attachment, a - file attached to an email, - Evolution will display the file - at the bottom of the message to which it's attached. Text, - HTML, and most images will be displayed within the message - itself. For other files, - Evolution will show an icon at - the end of the message. Right-click on the icon to get a - list of options which will vary depending on the type of - attachment. You will have the option to display most files - as part of the message, export them to a different - application (images to Eye of GNOME, spreadsheets to - Gnumeric, and so forth), or save them to disk. - - - - Evolution can also display - HTML-formatted mail, complete with graphics. HTML - formatting will display automatically, although you can - turn it off if you prefer. - - - - - - Writing and Sending Mail - - You can start writing a new email message by selecting - File - New - Mail Message, or by pressing the - Compose button in the Inbox toolbar. - When you do so, the New Message window - will open, as shown in . - - - -
- New Message Window - - Evolution Main Window - - - -
- - - - - Enter an address in the To: field, a - subject in the Subject: and a message in - the big empty box at the bottom of the window, and press - Send. - - - - Saving Messages for Later - - Evolution will send mail immediately unless you tell it to - do otherwise by selecting - File Send - Later. This will add your - messages to the Outbox queue. Then, - when you press Send in another - message, or Get Mail in the main - mail window, all your unsent messages will go out at once. - Many times, one might want to use "Send Later" becuase it gives - you a chance to change your mind about a message before it - is sent. This way, you may not say something you may regret. - - - To learn more about how you can specify message queue and - filter behavior, see . - - - - You can also choose to save messages as drafts or as text - files. Choose - - File - Save - - or Save As to save your message - as a text file. If you prefer to keep your message in a - folder (the Drafts folder would be the - obvious place), you can select - File Save In - Folder . - - - - Advanced Mail Composition - - You can probably guess the purpose of the buttons labelled - Cut, Copy, - Paste, Undo - and Redo, but there's a bit more to - sending mail that's less obvious. In the next few sections, - you'll see how Evolution handles - additional features, including large recipient lists, - attachments, and forwarding. - - - Attachments - - If you want to attach a file to your email message, you - can drag it from your desktop into the message window, or - click the button in the toolbar with a paper clip on it, - labelled Attach. If you click the - Attach button, - Evolution will open a file - selection dialog box to ask you which file you want to - send. Select the file and click OK. - - - To hide the display of files you've attached to the - message, select - View Hide - Attachments ; to show them - again, choose Show Attachments. - - - When you send the message, a copy of the attached file - will go with it. Be aware that big attachments can take a - long time to download. - - - When recieving a message that has an attached image, - Evolution gives you the choice - whether to view it or not. You can choose to have it - always shown, load images only if the sender is in your - addressbook, or never load images. - - - - Types of Recipients - - Evolution, like most email - programs recognizes three types of addressee: primary - recipients, secondary recipients, and hidden ("blind") - recipients. - - - The simplest way to direct a message is to put the email - address or addresses in the To: - field, which denotes primary recipients. To send mail to - more than one or two people, you can use the the - Cc: field. - - - Hearkening back to the dark ages when people used - typewriters and there were no copy machines, "Cc" stands - for "Carbon Copy." Use it whenever you want to share a - message you've written to someone else. - - Using the Cc: field - - When Susan sends an email to a client, she puts her - co-worker, Tim, in the in the - Cc: field, so that he know - what's going on. The client can see that Tim also - received the message, and knows that he can talk to - Tim about the message as well. - - - - - - - Using the Bcc: field - - Tim is sending an email announcement to all of his - company's clients, some of whom are in competition - with each other, and all of whom value their - privacy. He needs to use the - Bcc: field here. If he puts - every address from his address book's "Clients" - category into the To: or - Cc: fields, he'll make the - company's entire client list - public. However, but putting his "Clients" addressbook - into the Bcc: section, that will cause them to be hidden - from the competition. It seems insignificant, but it can - make a huge difference in some situations. - - - - - - - Choosing Recipients Quickly - - If you have created address cards in the contact manager, - you can also enter nicknames or other portions of address - data, and Evolution will transparently - complete - the address for you. If you enter a name - or nickname that can go with more than one card, Evolution - will open a dialog box to ask you which person you meant. - - - - Alternately, you can click on the - To:, Cc:, or - Bcc: buttons to get a list — - potentially a very long one — of the email addresses - in your contact manager. Select addresses and click on - the arrows to move them into the appropriate address - columns. - - - For more information about using email together with the - contact manager and the calendar, see and . - - - - - - Replying to Messages - - To reply to a message, press the - Reply button while it is selected, - or choose Reply to Sender from - the message's right-click menu. That will open the - message composer. The - To: and Subject - fields will already be filled, although you can alter them - if you wish. In addition, the full text of the old message - is inserted into the new message, either in italics (for - HTML display) or with the > character before each line - (in plain text mode), to indicate that it's part of the - previous message. People often intersperse their message - with the quoted material as shown in . - - - -
- Reply Message Window - - Evolution Main Window - - - -
- - - - - If you're reading a message with several recipients, you may - wish to use Reply to All instead of - Reply. If there are large numbers - of people in the Cc: or - To: fields, this can save substantial - amounts of time. - - Using the Reply to All feature - - Susan sends an email to a client and sends copies to Tim - and to an internal company mailing list of co-workers. - If Tim wants to make a comment for all of them to read, - he uses Reply to All, but if he - just wants to tell Susan that he agrees with her, he - uses Reply. Note that his reply - will not reach anyone that Susan put on her - Bcc list, since that list is not - shared with anyone. - - - - - - Searching and Replacing with the Composer - - You're probably familiar with search and replace features, - and if you come from a Linux or Unix background, you - probably know what Find Regex - does. If you aren't among the lucky who already know, - here's a quick rundown of an important section of the - Edit menu. - - - - - Find - Enter a word or phrase, and - Evolution will find it - in your message. - - - - - Find Regex - - - Find a regex, also called a - regular - expression, in your composer window. - - - - - - Find Again - - Select this item to repeat the last search you performed. - - - - - Replace - - Find a word or phrase, and replace it with - something else. - - - - - - - For all of these menu items, you can choose whether or not - to Search Backwards in the document - from the point where your cursor is. For all but the - regular expression search (which doesn't need it), you are - offered a check box to determine whether the search is to - be Case Sensitive when it determines - a match. - - - - Embellish your email with HTML - - Normally, you can't set text styles or insert pictures in - emails, which is why you've probably seen people use far - too many exclamation points for emphasis, or use - emoticons to - convey their feelings. However, most newer email programs - can display images and text styles as well as basic - alignment and paragraph formatting. They do this with - HTML, just like web - pages do. - - - HTML Mail is not a Default Setting - - Some people do not have HTML-capable mail clients, or - prefer not to receive HTML-enhanced mail because it is - slower to download and display. Some - people refer to HTML mail as "the root of all evil" and - get very angry if you send them HTML mail, which is why - Evolution sends plain text - unless you explicitly ask for HTML. To send HTML mail, - you will need to select - Format - HTML. Alternately, you can set - your default mail format preferences in the mail - configuration dialog. See for more information. - - - - HTML formatting tools are located in the toolbar just above - the space where you'll actually compose the message, and - they also appear in the Insert and - Format menus. - - - The icons in the toolbar are explained in tool-tips, which appear when - you hold your mouse over the buttons. The buttons fall - into four categories: - - - Headers and lists - - - At the left edge of the toolbar, you can choose - Normal for a default text style - or Header 1 through - Header 6 for varying sizes of - header from large (1) to tiny (6). Other styles - include pre, to use the HTML - tag for preformatted blocks of text, and three types - of List Item for the highly - organized. - - - - - Text style - - - Use these buttons to determine the way your letters - look. If you have text selected, the style will - apply to the selected text. If you do not have text - selected, the style will apply to whatever you type - next. The buttons are: - - Push B for bold text - Push I for italics - Push U to underline - Push S for a strikethrough. - - - - - - Alignment - - - Located next to the text style buttons, these three - paragraph icons should be familiar to users of most - word processing software. The leftmost button will - make your text aligned to the left, the center - button, centered, and the right hand button, - aligned on the right side. - - - - - - Indentation rules - - - The button with the arrow pointing left will reduce - a paragraph's indentation, and the right arrow will - increase its indentation. - - - - - - Color Selection - - - At the far right is the color section tool. The - colored box displays the current text color; to - choose a new one, click the arrow button just to the - right. If you have text selected, the color will - apply to the selected text. If you do not have text - selected, the color will apply to whatever you type - next. - - - - - - - - - There are three tools that you can find only in the - Insert menu. - - - Insert Link: - - - Use this tool to put hyperlinks in your HTML - messages. When you select it, - Evolution will prompt you - for the Text that will appear, - and the Link, where you should - enter the actual web address (URL). If you don't - want special link text, you can just enter the address - directly, and Evolution - will recognize it as a link. - - - - - Insert Image: - - - Select this item to embed an image into your email, as - was done in the welcome message. Images will appear at - the location of the cursor. This is different from - attaching them to a message, but not very different. - - - - - Insert Rule: - - This will insert a horizontal line, or rule, into your document. - You'll be presented with a dialog box which gives you - the choice of size, percentage of screen, shading, and - alignment; if you leave everything at the default - values you'll get a thin black rule all the way across - the screen. - - - - - - A Technical note on HTML Tags - - The composer is a WYSIWYG - (What You See Is What You Get) - editor for HTML. That means that if you enter HTML - directly into the composer— say, <B>Bold Text</B>, the - the composer will assume you meant exactly that string - of characters, and not "make this text bold," as an HTML - composition tool or text editor would. - - - - - - - - - - Forwarding Mail - - The post office forwards your mail for you when you change - addresses, and you can forward mail when you get a letter by - mistake. The email Forward button - works in much the same way. It's particularly useful if you - have received a message and you think someone else would - like to see it. You can forward a message as an attachment - to a new message (this is the default) or - you can send it inline as a quoted - portion of the message you are sending. Attachment - forwarding is best if you want to send the full, unaltered - message on to someone else. Inline forwarding is best if - you want to send portions of a message, or if you have a - large number of comments on different sections of the - message you are forwarding. Remember to note from whom the - message came, and where, if at all, you have removed or - altered content. - - - To forward a message you are reading, press - Forward on the toolbar, or select - Message - Forward . If you - prefer to forward the message inline - instead of attached, select - Message Forward - Inline from the menu. Choose an - addressee as you would when sending a new message; the - subject will already be entered, but you can alter it. - Enter your comments on the message in the - composition frame, and press - Send. - - - - Seven Tips for Email Courtesy - - I started with ten, but four were "Don't send - spam." - - - - - Don't send spam or forward chain mail. If you must, - watch out for hoaxes and urban legends, and make sure - the message doesn't have multiple layers of - greater-than signs, (>) indicating multiple layers - of careless in-line forwarding. - - - - - - Always begin and close with a salutation. Say "please" - and "thank you," just like you do in real life. You - can keep your pleasantries short, but be pleasant! - - - - - - ALL CAPS MEANS YOU'RE SHOUTING! Don't write a whole - message in capital letters. It hurts people's ears. - - - - - - Never write anything in email you wouldn't say in - public. Old messages have a nasty habit of - resurfacing when you least expect. - - - - - - Check your spelling and use complete sentences. - - - - - - Don't send nasty emails (flames). If you get one, - don't write back. - - - - - - When you reply or forward, include just enough of - the previous message to provide context: not too - much, not too little. - - - - - Happy mailing! - - - - - - Organizing Your Mail - - Even if you only get a few email messages a day, you probably - want to sort and organize them. When you get a hundred a day - and you want to refer to a message you received six weeks ago, - you need to sort and organize them. - Fortunately, Evolution has the tools - to help you do it. - - - Sorting Mail with Column Headers - - By default, the message list has columns with the following - headings: an envelope icon indicating whether you have read - or replied to a message (closed for unread, open for read, - and open with an arrow on it to indicate you've sent a - reply), an exclamation point indicating priority, and the - From, Subject, and - Date fields. You can change their order - and remove them by dragging and dropping them. You can add - new ones with the Field Chooser - item in the right click menu for the column headings. - - - Right-click on one of the column headers to get a list of - options: - - - - Sort Ascending - - Sorts the messages top to bottom. - - - - - Sort Descending - - Sorts the messages bottom to top. - - - - - Group By this Field - - Groups messages instead of sorting them. (FIXME: Explain further) - - - - - Remove this - Column Remove - this column from the display. You can also remove - columns by dragging the header off the list and - letting it drop. - - - - Field - Chooser A list - of column headers; just drag and drop them into - place between two existing headers. A red arrow will - appear to show you where you're about to put the - column. - - - - - - - Getting Organized with Folders - - Evolution keeps mail, as well as - address cards and calendars, in folders. You start out with a - few, like Inbox, - Outbox, and Drafts, - but you can create as many as you like. Create new folders by - selecting New and then - Folder from the - File menu. - Evolution will as you for the name - and the type of the folder, and will provide you with a folder - tree so you can pick where it goes. - - - When you click OK, your new folder will - appear in the folder view. You can - then put messages in it by dragging and dropping them, or by - using the Move button in the - toolbar. If you want to move several messages at once, click - on the ones you want to move while holding down the - CTRL key, or use Shift to - select a range of messages. If you create a filter with the - filter assistant, you can have mail - moved to your folder automatically. - - - - - Searching for Messages - - Most mail clients can search through your messages for you, - but Evolution does it faster. You - can search through just the message subjects, just the message - body, or both body and subject. - - - To start searching, enter a word or phrase in the text area - right below the toolbar, and choose a search type: - - - Body or subject contains: - - - This will search message subjects and the messages - themselves for the word or phrase you've entered in - the search field. - - - - - Body contains: - - - This will search only in message text, not the subject - lines. - - - - - Subject contains: - - - This will show you messages where the search text is - in the subject line. It will not search in the - message body. - - - - - Body does not contain: - - - This finds every email message that does not have the - search text in the message body. It will still show - messages that have the search text in the subject - line, if it is not also in the body. - - - - - Subject does not contain: - - - This finds every mail whose subject does not contain - the search text. - - - - - - When you've entered your search phrase, press - Enter. Evolution - will show your search results in the message list. - - - - If you think you'll want to return to a search again, you can - save it as a virtual folder by selecting Store - Search as Virtual Folder. - - - - When you're done with the search, go back to seeing all your - messages by choosing Show All from - the Search drop-down box. If you're - sneaky, just enter a blank search: since every message has at - least one space in it, you'll see every message in the - folder. - - - - If you'd like to perform a more complex search, open the - advanced search dialog by selecting - Advanced... from the - Search drop-down menu. Then, create your - search criteria (each with the same options you saw in the - regular search bar), and decide whether you want to find - messages that match all of them, or messages that match even - one. Then, click Search to go and find - those messages. - - - - You'll see a similar approach to sorting messages when you - create filters and virtual folders in the next few sections. - - - - - - Staying organized: Mail Filters in Evolution - - Filters work very much like the mail room in a large company. - Their purpose is to bundle, sort, and distribute mail to the - various folders. - In addition, you can have multiple filters performing multiple - actions that may effect the same message in several ways. For - example, your filters could put copies of one message into - multiple folders, or keep a copy and send one to another - person as well, and it can do that in under a second. Which is - to say, it's faster and more flexible than an actual person - with a pile of envelopes. - - - Most often, you'll want to have - Evolution put mail into different - folders, but you can have it do almost anything you like. - People who get lots of mail, or who often need to refer to old - messages, find filters especially helpful, but they can greatly benefit - anybody who gets more than a few messages a day. To - create a filter, open the filter - assistant by selecting - - Settings - Mail Filters - . - - -
- The Filter Assistant - - The Filter Assistant - - - -
- - - The filter assistant window contains a - list of your current filters, sorted by the order in which - they are used. From the drop-down box at the top of the - window, choose Incoming to display - filters for incoming mail, and Outgoing - for those which sort only outgoing mail. - - - The filter assistant also has a set of - buttons: - - - - Add — Create a new filter. - - - - Edit — Edit an existing filter. - - - - Delete — Delete the selected filter. - - - Up — Move the - selected filter up in the list so it gets applied first. - - - - Down — Move the selected filter down - in the list, so it comes into play later. - - - - If you don't have any filters set up, the only one of those - buttons you can click is Add, which - will open a dialog to let you add a filter rule. If you do - have filters, you can either add a new filter rule, or select - one from your list and click Edit. - - - The filter rule editor, shown in , is where you'll - actually create your filtering rule. - -
- Creating a new Filter - - Creating a new Filter - - - -
- - - Enter a name for your filter in the Rule - Name field, and then begin choosing the criteria - you'd like to use as you sort your mail. Choose how many - criteria you'd like by pressing Add - Criterion and Remove - Criterion. If you have multiple criteria, you - should then decide whether to have the filter do its job only - if all criteria are met, or if - any criteria are met. - - - For each filter criterion, you must first select - which of the following parts of the message you want the filter to - examine: - - - Sender - - The sender's address. - - - - - Recipients - - The recipients of the message. - - - - - Subject - - The subject line of the message. - - - - - - Specific Header - - The filter can look at any header you - want, even obscure or custom ones. Enter the header name - in the first text box, and put your search text in the - second one. - - - - - Message Body - - Search in the actual text of the message. - - - - - Expression - - - For programmers only: match a message according to an - expression you write in the Scheme language, used to - define filters in Evolution. - - - - - - - Date Sent - Filter messages according to the date on - which they were sent: First, choose the conditions you - want a message to meet — before - a given time, after it, and so forth. - Then, choose the time. The filter will compare the - message's time-stamp to the system clock when the filter - is run, or to a specific time and date you choose from a - calendar. You can even have it look for messages within a - range of time relative to the filter &mdash perhaps you're - looking for messages less than two days old. - - - - - Date Recieved - - This works the same way as the Date Sent - option, except that it compares the time you got the message - with the dates you specify. - - - - - Priority - - Emails have a standard priority range from -3 (least - important) to 3 (most important). You can have filters set the - priority of messages you recieve, and then have other filters - applied only to those messages which have a certain priority. - - - - - Regex Match - - - If you know your way around a regex, or - regular expression, put your knowledge to use here. - - - - - - Source - - - Filter messages according the server you got them from. - You can enter a URL or choose one from the drop-down - list. This ability is only relevant if you use more - than one mail source. - - - - - - - Now, tell it what to do with those messages. If you want more - actions, click Add Action; if you want - fewer, click Remove Action. And choose - again: - - - - Copy to Folder - - If you select this item, Evolution - will put the messages into a folder you specify. Click the - <click here to select a folder> button - to select a folder. - - - - - Move to Folder - - If you select this item, Evolution - will put the messages into a folder you specify. Click the - <click here to select a folder> button - to select a folder. - - - - - Forward to Address - - Select this, enter an address, and the addressee will - get a copy of the message. - - - - - Delete - - Marks the message for deletion. You can still get the message - back, at least until you Expunge your - mail yourself. - - - - - Stop Processing - - Select this if you want to tell all other filters to ignore - this message, because whatever you've done with it so far - is plenty. - - - - - Assign Color - - Select this item, and Evolution - will mark the message with whatever color you please. - - - - - Assign Score - If you know that all mail with - "important" somewhere in the message body line is - important, you can give it a high priority score. In a subsequent filter you can - then arrange your messages by their priority score. - - - - - - - You're done. Click OK to use this - filter, or Cancel to close the window - without saving any changes. - - - - - - - - Two Notable Filter Features - - - - 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. - - - - If you move a folder, your filters - will follow it. - - - - - - - - - Getting Really Organized with Virtual Folders - - If filters aren't flexible enough for you, or you find - yourself performing the same search again and again, consider - a virtual folder. Virtual folders, or vFolders, are an - advanced way of viewing your email messages within - Evolution. If you get a lot of - mail or often forget where you put messages, virtual folders can help - you stay on top of things. - - - A virtual folder is really a hybrid of all the other organizational - tools: it looks like a folder, it acts like a search, and you - set it up like a filter. In other words, while a conventional - folder actually contains messages, a virtual folder is a view of - messages that may be in several different folders. The - messages it contains are determined on the fly using a set of - criteria you choose in advance. - - - - As messages that meet the virtual folder criteria arrive or are - deleted, Evolution will - automatically place them in and remove them from the - virtual folder contents list. When you delete a message, it gets - erased from the folder in which it actually exists, as well as - any virtual folders which display it. - - - - Imagine a business trying to keep track of mail from hundreds - of vendors and clients, or a university with overlapping and - changing groups of faculty, staff, administrators and - students. The more mail you need to organize, the less you - can afford the sort of confusion that stems from an - organizational system that's not flexible enough. Virtual folders - make for better organization because they can accept - overlapping groups in a way that regular folders and filing - systems can't. - - - - Using Folders, Searches, and Virtual Folders - - To organize my mail box, I set up a virtual folder for - emails from my friend and co-worker Anna. I have another - one for messages that have "ximian.com" in the address and - "Evolution" in the subject line, so I can keep a record of - what people from work send me about - Evolution. If Anna sends me a - message about anything other than Evolution, it only shows - up in the "Anna" folder. When Anna sends me mail about the - user interface for Evolution, I - can see that message both in the "Anna" virtual folder and - in the "Internal Evolution Discussion" virtual folder. - - - - - - - To create a virtual folder, select - Settings Virtual Folder - Editor . This will bring up a - dialog box that looks suspiciously like the filter window - (for more information on filters, see ), and which - presents you with a list of virtual folders you have previously - created. If you have created any virtual folders, they are listed - here, and you can select, edit or remove them if you wish. - If you have not created any, there will be only one available - option: click Add to add a new - Virtual Folder. - - - You can enter a name for your virtual folder in the - Name. Then, tell - Evolution what messages to look - for. This process is exactly like filter creation: decide - between Match all parts and - Match any part, then choose what part of - the message to look in, what sort of matching to perform, and - specify exactly what it is that you want to find, be it a - line of text, a score, a regular expression, or a particular date or - range of dates. - - - The second part, however, is slightly different. In the - section of the window labelled Virtual Folder Sources - is a list of folders in which - Evolution will search for the - contents of your vFolder. Click Add - to add a folder, or Remove to remove - one. That way, you can have your vFolder search in - newsgroups, or just in one of your mailboxes, or just in a - select few folders you've already screened with filters. - - - The vFolder creation window is shown in - -
- Selecting a vFolder Rule - - Creating a vFolder Rule - - - -
- - - - Subscription Management - - Evolution lets you handle your - IMAP and newsgroup subscriptions with the same tool: the - subscriptions manager. To start using it, choose - Settings Manage - Subscriptions . - - - If you have configured any IMAP (mail) or NNTP (news) - servers, you will see them listed in the left half of the - subscription management window. Click on a server to select - it, and you will see the folders or newsgroups available to - you. You can then select individual folders and subscribe to - them, or remove yourself from the subscription list. - - - Once you have subscribed to a folder or newsgroup, your system - will check for new messages whenever you press the - Get Mail button. - - - - - - - diff --git a/doc/C/usage-mainwindow.sgml b/doc/C/usage-mainwindow.sgml deleted file mode 100644 index 6c2b92ffb1..0000000000 --- a/doc/C/usage-mainwindow.sgml +++ /dev/null @@ -1,457 +0,0 @@ - - - - The Main Window: Evolution Basics - - Start Evolution by selecting - Evolution from your - Programs menu, or by typing - evolution at the command line. The first time - you run the program, it will create a directory called - evolution in your home directory, where it - will keep all your Evolution-related - files. At this point, it will also offer to import old messages - from other mail clients, such as Netscape mail. - - - After Evolution starts up, you will - see the main window, with the - Inbox open. It should look a lot like the - picture in . On the left of - the main window is the shortcut - bar, with several buttons in it. Just underneath the - title bar is a series of menus in the menu - bar, and below that, the tool - bar with buttons for different functions. The largest - part of the main window is taken up by the - content view, where your messages are displayed. Above that is - the message list view, where a summary of your email is displayed. - If you're running the program for the first time, - you'll have one message: a welcome from Ximian. - - - -
- Evolution Main Window and Inbox - - Evolution Main Window - - - -
- - - - - - The Way Evolution Looks - - Both GNOME and - Evolution's appearances can be customized, - so your graphics may not look the same as the screenshots. - - - - - - The Shortcut Bar - - Evolution's most important job is - to give you access to your information and help you use it - quickly. One way it does that is through the - shortcut bar, the column on the left - hand side of the main window. The large buttons with names - like Inbox and - Contacts are the shortcuts, and you can - select different groups of shortcuts by clicking the - rectangular group buttons. - - - Take a look at the Shortcut Bar - The shortcut buttons in that category are: - - - - - - My Evolution - - - Start your day here. My Evolution - gives you a quick summary of new or important messages, - daily appointments and urgent tasks. You can customize - its appearance and content, and use it to access - Evolution services. - - - - - - - Inbox - - - Click the Inbox button to start - reading your mail. Your Inbox is also where you can - access Evolution's tools to filter, sort, organize, and - search your mail. - - - - - - Calendar - - - The Calendar can store your appointments and To do lists - for you. Connected to a network, you can use it to keep - a group of people on schedule and up to date. - - - - - - Tasks - - - A full-size view of your calendar's task pad. - - - - - - Contacts - - - The Contact Manager holds your addresses, phone numbers, - and contact information. Like calendar information, - contact data can be synchronized with hand-held devices - and shared over a network. - - - - - - - - - - If you don't like the shortcut bar, you can use the folder bar - or the menu bar to navigate the main window. Press - - Ctrl - O - - to choose from a list of folders you'd like to visit, or use the - drop-down folder bar. You can hide and show the folder bar and - the shortcut bar by selecting those items in the - View menu. - - - - Shortcut Bar Tricks - - To remove a shortcut from the shortcut bar, right-click on it - and select Remove. To add one, - select File - New Evolution Bar - Shortcut . - - - To change the way the shortcut bar looks, right-click in an - empty space on the shortcut bar. From the menu that appears, - you can select icon sizes. - - - - - - Folders and The Folder Bar - - The folder bar is a more comprehensive - way to view the information you've stored with - Evolution. It displays all your - appointments, address cards, and email in a tree that's a lot - like a file - tree— it starts small at the top, and branches - downwards. On most computers, there will be three or four - folders at the base. First is the Local - folder, which holds all the Evolution - data that's stored on your computer. After that are - Other Contacts, LDAP contact directories stored on a - network, followed by any IMAP mail folders you may have - available to you over your network. Lastly, there are - Virtual Folders, discussed in , - - - - A typical Local folder contains the following folders: - - - - My Evolution, a quick summary to help you do - your tasks. - - - - - Calendar, for appointments and - event listings. - - - - - Contacts, for address cards. - - - - - Drafts, for messages you started and didn't finish. - - - - - Inbox, for incoming mail. - - - - - - Outbox, for messages you have written - but not yet sent. This will be empty unless you use - Evolution while offline. - - - - - - Sent, for sent mail. - - - - - - Trash, a virtual folder view of all - the messages you have marked for deletion but not yet - expunged. Note that - once you have expunged a message, it - is gone for good. - - - - - - - Navigating without the Folder Bar - - You don't need the folder bar or the shortcut bar to move - around the main window. You can use Tab to - switch from one part of the window to another, and the folder - menu on the right side of the window just below the toolbar - to move about the folder tree, even with the folder and - shortcut bars hidden. - - - - - If you get any serious amount of mail, you'll want more folders - than just your Inbox. To create a new folder, select - File - New - Folder - - Shift - Ctrl - E - . You'll be - asked where you want to put it, and what kind of folder it - should be. You can choose from three types: - Mail, for storing mail, - Calendar for storing calendars, and - Contacts for storing contacts. - - - - Subfolders - - Evolution can also manage subfolders. - Subfolders are folders inside of folders. This works well if - you want to try to separate your home folders from your work - folders. - - - - - - Folders Have Limits - - Calendars must go in calendar folders, mail in mail - folders, and contacts in contact folders. - - - - - Right-clicking will bring up a menu for just about anything - in GNOME, and Evolution is no - exception. If you right-click on a folder, you'll have a - menu with the following options: - - View, to view the folder. - Open in New Window, to see it in a new Evolution window. - Move, to move the folder to another location. - Copy, to duplicate the folder. - Delete, to delete the folder and all its contents. - Rename, to change its name. - Create New Folder, to create another folder in the same location. - Add to Shortcut Bar, to add the folder to your shortcut bar. - Properties, to view or change the folder properties. - - - - - - You can also rearrange folders and messages with by dragging and - dropping them. - - - - - - - - Any time new information arrives in a folder, that folder label - is displayed in bold text, along with the amount of new messages in - that folder inside of paranthesis. - - - - - The Menu Bar - - The menu bar's contents will always - provide all the possible actions for any given view of your - data. That means that, depending on the context, menu bar items - will change. If you're looking at your Inbox, most of the menu - items will relate to mail; some will relate to other components - of Evolution and some, especially - those in the File Menu will relate to the - application as a whole. The contents of the menu bar are - described in . - - - - - File - - - Anything even related to a file or to the operations - of the application generally falls under this - menu: creating things, saving them to disk, - printing them, and quitting the program itself. - - - - - - Edit - - The Edit menu holds - useful tools that help you edit text and move it around. - - - - - View - - This menu lets you decide how Evolution - should look. Some of the features control the appearance of - Evolution as a whole, and others - the way a particular kind of information appears. - - - - - Actions - - Holds actions which maybe applied to a message. Normally, - if there is only one target for the action — for - example, replying to a message — you can find it in - the Actions menu. - - - - - - Tools - - Tools for configuring, changing, and - setting up preferences go here. For mail, that means things like - Mail Configuration and the - Virtual Folder Editor. For the - Calendar and the Contact - Manager, it's color, network, and layout - configuration. - - - - - Help - - Select among these items to open the - Help Browser - and read the Evolution manual. - - - - - - - Once you've familiarized yourself with the main - window you can start doing things with it. We'll - start with your executive summary. - - - - diff --git a/doc/C/usage-notes.sgml b/doc/C/usage-notes.sgml deleted file mode 100644 index 1ff2283128..0000000000 --- a/doc/C/usage-notes.sgml +++ /dev/null @@ -1,49 +0,0 @@ - - Evolution Notes - - An Overview of the Evolution Notes - - 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 - Evolution will eventually have a - Notes feature. Evolution can help - you take notes in the following ways: - - - - Take down phone numbers, take school notes, take phone - messages, or even write poetry. - - - - - Color code notes to organize them, or just to - make them look good. - - - - - Turn a note into an email or a text file. - - - - - Write Haiku - - - - - - You can start writing notes by clicking - Notes in the shortcut bar. Of course, - it's not there yet. But when it is, it'll take you to the - notepad. - - - - - - diff --git a/doc/C/usage-print.sgml b/doc/C/usage-print.sgml deleted file mode 100644 index faa9e58534..0000000000 --- a/doc/C/usage-print.sgml +++ /dev/null @@ -1,105 +0,0 @@ - -Printing with Evolution - - This is a very short chapter, because printing with - Evolution is not a complex task. Like - most GNOME applications, Evolution uses - the gnome-print system, so if you've used any other GNOME - application to print, you should be able to print from - Evolution immediately. - - - 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. - - - - Print Preview - - Print Preview appears both as a button in - the printing dialog and as an item in the - File 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. - - - 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 Fit button) - or match the width of the page and the window (the - Fit Width 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 things - look, click Print to send your document - on its way. If you'd like to change it, just close the - Print Preview window and make the changes - you want from the Mail, Calendar, or Contact Manager. - - - - - - - - - - - - File or Printer? - - The printer selection window, shown in , lets you choose the format for - printing— Generic - Postscript, 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 - lpr) 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. - - - - - - - - - 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. - - - When you're ready, click Print to print, - Preview to have a look (or another look) - at the preview, or Cancel to cancel the - whole deal. - - - - - - - - - - diff --git a/doc/C/usage-sync.sgml b/doc/C/usage-sync.sgml deleted file mode 100644 index 4c61c02bed..0000000000 --- a/doc/C/usage-sync.sgml +++ /dev/null @@ -1,21 +0,0 @@ - - - Synchronizing with a Hand-held Device - - This chapter covers is how to synchronize data - installed and configured. If you need information on how to - set up a synchronization system, consult . - - - Using HotSync - - Put your hand-held device on its cradle and press the - HotSync button. - - - If your environment is correctly configured to sync with your - PDA, then it should sync with Evolution. - - - -- cgit v1.2.3