diff options
| -rw-r--r-- | doc/C/config-setupassist.sgml | 6 | ||||
| -rw-r--r-- | doc/C/evolution-faq.sgml | 25 | ||||
| -rw-r--r-- | doc/C/preface.sgml | 176 | ||||
| -rw-r--r-- | doc/C/usage-calendar.sgml | 6 | ||||
| -rw-r--r-- | doc/C/usage-contact.sgml | 4 | ||||
| -rw-r--r-- | doc/C/usage-exec-summary.sgml | 13 | ||||
| -rw-r--r-- | doc/C/usage-mail.sgml | 6 | ||||
| -rw-r--r-- | doc/C/usage-mainwindow.sgml | 630 | ||||
| -rw-r--r-- | doc/ChangeLog | 25 | ||||
| -rw-r--r-- | help/C/config-setupassist.sgml | 6 | ||||
| -rw-r--r-- | help/C/evolution-faq.sgml | 25 | ||||
| -rw-r--r-- | help/C/preface.sgml | 176 | ||||
| -rw-r--r-- | help/C/usage-calendar.sgml | 6 | ||||
| -rw-r--r-- | help/C/usage-contact.sgml | 4 | ||||
| -rw-r--r-- | help/C/usage-exec-summary.sgml | 13 | ||||
| -rw-r--r-- | help/C/usage-mail.sgml | 6 | ||||
| -rw-r--r-- | help/C/usage-mainwindow.sgml | 630 | ||||
| -rw-r--r-- | help/ChangeLog | 25 |
18 files changed, 822 insertions, 960 deletions
diff --git a/doc/C/config-setupassist.sgml b/doc/C/config-setupassist.sgml index 8ed5cd0e38..bbc7ed6a34 100644 --- a/doc/C/config-setupassist.sgml +++ b/doc/C/config-setupassist.sgml @@ -1,3 +1,7 @@ +<!-- + +this chapter is useless and outdated now. + <chapter id="config-setupassist"> <title>Easy Setup with the Setup Assistant</title> <para> @@ -192,7 +196,7 @@ </chapter> - +--> diff --git a/doc/C/evolution-faq.sgml b/doc/C/evolution-faq.sgml index 1666f26b36..45dc89e784 100644 --- a/doc/C/evolution-faq.sgml +++ b/doc/C/evolution-faq.sgml @@ -27,7 +27,7 @@ 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 + proprietary segments of Exchange and Notes servers eventually, but this will come after Evolution 1.0. </para> </answer> @@ -270,7 +270,7 @@ <para> Mozilla on Windows accesses the <filename>.pst</filename> files through the <filename>MAPI.DLL</filename>, which is - only avaliable on Windows. <filename>MAPI.DLL</filename> + only available on Windows. <filename>MAPI.DLL</filename> is the only way to access <filename>.pst</filename> files and Evolution cannot use this DLL in Linux. </para> @@ -541,24 +541,7 @@ </itemizedlist> </answer> </qandaentry> - - <qandaentry> - <question> - <para> - I get <computeroutput>Cannot open composer window</computeroutput>. - </para> - </question> - <answer> - <para> - This actually means that Evolution cannot activate the HTML - editor component from GtkHTML. The comments in the previous - answer still apply; also make sure that - <command>gnome-gtkhtml-editor</command> is in your - <envar>PATH</envar>. - </para> - </answer> - </qandaentry> - + <qandaentry> <question> <para> @@ -930,7 +913,7 @@ bt <para> In one, type <command>gdb evolution-mail</command> . Replace "evolution-mail" with the name of the - component that is crashing: evolution-addresbook, + component that is crashing: evolution-addressbook, evolution-calendar, etc.) </para> </listitem> diff --git a/doc/C/preface.sgml b/doc/C/preface.sgml index 81a6a0dc93..26c7bd4e6f 100644 --- a/doc/C/preface.sgml +++ b/doc/C/preface.sgml @@ -17,9 +17,11 @@ information easier, so you can work and communicate with others. That is, it's a highly evolved <glossterm linkend="groupware">groupware</glossterm> 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. + part of the Internet-connected desktop. + </para> + <para> + Without all the hot air, that means it's a tool to help you + get your work done. </para> <para> Because it's part of the GNOME project, @@ -36,12 +38,11 @@ </para> <para> <note> - <title>This is a preview release</title> + <title>This is a Beta release</title> <para> - <application>Evolution</application> 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 <ulink + <application>Evolution</application> is now on the home + stretch to version 1.0. Please help prepare for the 1.0 + release by reporting bugs to us at <ulink url="http://bugzilla.ximian.com">bugzilla.ximian.com</ulink>. There are detailed bug reporting instructions in <xref linkend="evolution-faq">. @@ -49,8 +50,7 @@ <para> Please send comments on the guide to <email>aaron@ximian.com</email>. The first person to send - me some good constructive criticism wins a free Ximian - t-shirt. + some good suggestions gets a free Ximian t-shirt. </para> </note> </para> @@ -100,9 +100,10 @@ <listitem> <para> Data must be safe: <application>Evolution</application> - must not lose mail, corrupt mailbox files or other - data, execute arbitrary <glossterm linkend="script">scripts</glossterm>, - or delete files from your hard disk. + must not lose mail, corrupt mailbox files or other data, + execute arbitrary <glossterm + linkend="script">scripts</glossterm>, or delete files from + your hard disk. </para> </listitem> </itemizedlist> @@ -165,15 +166,18 @@ <tip id="example-tip"> <title>Example Tip</title> <para> - This is what an example looks like. + Tips and bits of extra information will look like + this. </para> </tip> + <example> <title>Example Example</title> <para> This is what an example looks like. </para> </example> + <warning id="example-warning"> <title>Example Warning</title> <para> @@ -183,151 +187,7 @@ </para> </formalpara> </sect1> - <sect1 id="ui-intro"> - <title>Evolution Interface Introduction</title> - <para> - <application>Evolution</application> follows a consistent UI. This means - that in each component, you will find many UI characteristics the same as - others components. - </para> - - <figure id="preface-basic-interface"> - <title>Evolution's Interface</title> - <screenshot> - <screeninfo>Inbox</screeninfo> - <graphic fileref="fig/mainwindow-pic.png" srccredit="Kevin Breit"> - </graphic> - </screenshot> - </figure> - - <para> - <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> - <guilabel>Menubar</guilabel> - </para> - - <para> - The <guilabel>Menubar</guilabel> gives you access to nearly all the - features that can be found in <application>Evolution</application>. - </para> - - <para> - <inlinegraphic fileref="fig/full-2.png"></inlinegraphic> - <guilabel>Toolbar</guilabel> - </para> - - <para> - The <guilabel>Toolbar</guilabel> gives you fast and easy access to the - most used features in each component. - </para> - - <para> - <inlinegraphic fileref="fig/full-3.png"></inlinegraphic> - <guilabel>Shortcut Bar</guilabel> - </para> - - <para> - The <guilabel>Shortcut Bar</guilabel> lets you go to your favorite - components with the click of a click of a button. - </para> - - <para> - <inlinegraphic fileref="fig/full-4.png"></inlinegraphic> - <guilabel>Status Bar</guilabel> - </para> - - <para> - Periodically, <application>Evolution</application> will need to quietly - display a message, or tell you the progress of a task. This most - often happens when you're checking or sending email. These progress - queues are shown here, in the <guilabel>Status Bar</guilabel>. - </para> - - <para> - <inlinegraphic fileref="fig/full-5.png"></inlinegraphic> - <guilabel>Search Bar</guilabel> - </para> - - <para> - The <guilabel>Search Bar</guilabel> lets you search through your email - with precision so you can easily find what you're looking for. - </para> - </sect1> - <sect1 id="import-tool"> -<!-- This section sucks. Look at it, ask for improvements --> - <title>Importing External Files</title> - <para> - Chances are, <application>Evolution</application> isn't your first email - program. You're probably switching from another program and will want - access to your email from your old program. It's for exactly these - situations that <application>Evolution</application> includes an import - feature. - </para> - <para> - <application>Evolution</application> can import the following types of - files: - <itemizedlist> - <listitem> - <para> - VCard (.vcf, gcrd) - Contacts - </para> - </listitem> - <listitem> - <para> - Outlook Express 4 (.mbx) - Email - </para> - </listitem> - <listitem> - <para> - MBox(mbox) - Email - </para> - </listitem> - </itemizedlist> - VCard is a format to store addressbooks and contact information. Outlook - handles your email. If you're coming from - Windows, you're probably going to be importing Outlook Express files. If - you're coming from a Unix program, you're probably using mbox. Ask your - system administrator if you aren't sure which you use. - </para> - <note> - <title>Eudora</title> - <para> - Eudora email client uses mbox format to store mail. So if you're coming - from Eudora, you'll want to select mbox. - </para> - </note> - <note> - <title>Outlook 2000</title> - <para> - Outlook 2000 uses a format which <application>Evolution</application> - cannot directly import. However, you can import it using Mozilla on - Windows. Please see the FAQ for more information. - </para> - </note> - - <para> - To import your files, go to - <menuchoice> - <guimenu>File</guimenu> - <guimenuitem>Import File</guimenuitem> - </menuchoice> - </para> - <para> - An assistant will appear, helping you to import your files. You'll need to - specify where the file is that you want to import. Click - <guibutton>Next</guibutton> and then <guibutton>Import</guibutton>. - <application>Evolution</application> will present you with the Folder - dialoge, so you can specify where your new messages will go. Select the - desired folder, and your file will be imported into - <application>Evolution</application>. - </para> - <para> - And if you're timid about using <application>Evolution</application>, - don't worry. <application>Evolution</application> won't mangle your - files, so if you choose to use your old application instead, you can - import your files right back in. - </para> - </sect1> <sect1 id="quickref-commontasks"> <title>Quick Reference for Common Tasks</title> <para> diff --git a/doc/C/usage-calendar.sgml b/doc/C/usage-calendar.sgml index ed69f5081e..6c44db3d61 100644 --- a/doc/C/usage-calendar.sgml +++ b/doc/C/usage-calendar.sgml @@ -28,7 +28,7 @@ </para> <para> - <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-1.png" format="png"></inlinegraphic> <guilabel>Event List</guilabel> </para> @@ -39,7 +39,7 @@ </para> <para> - <inlinegraphic fileref="fig/full-2.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-2.png" format="png"></inlinegraphic> <guilabel>Todo List</guilabel> </para> @@ -51,7 +51,7 @@ </para> <para> - <inlinegraphic fileref="fig/full-3.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-3.png" format="png"></inlinegraphic> <guilabel>Calendar Window</guilabel> </para> diff --git a/doc/C/usage-contact.sgml b/doc/C/usage-contact.sgml index a825139af0..678cca2a50 100644 --- a/doc/C/usage-contact.sgml +++ b/doc/C/usage-contact.sgml @@ -42,13 +42,13 @@ <title>Evolution Contact Interface</title> <screenshot> <screeninfo>Evolution Contact List Window</screeninfo> - <graphic fileref="fig/contact.png" srccredit="Kevin Breit"> + <graphic fileref="fig/contact.png" format="png" srccredit="Kevin Breit"> </graphic> </screenshot> </figure> <para> - <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-1.png" format="png"></inlinegraphic> <guilabel>Contact List</guilabel> </para> diff --git a/doc/C/usage-exec-summary.sgml b/doc/C/usage-exec-summary.sgml index 996e4b3132..76724e4362 100644 --- a/doc/C/usage-exec-summary.sgml +++ b/doc/C/usage-exec-summary.sgml @@ -101,9 +101,7 @@ <sect2 id="delete-components"> <title>Deleting Components</title> <para> - There are possibly some components which you'd prefer not too - view in your My Evolution. - To remove a component: + To remove a service from My Evolution, do the following: <orderedlist numeration="arabic"> <listitem> <para> @@ -178,3 +176,12 @@ </sect1> </chapter> + + + + + + + + + diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml index 12ceb903db..54549a5dbc 100644 --- a/doc/C/usage-mail.sgml +++ b/doc/C/usage-mail.sgml @@ -82,14 +82,14 @@ <title>Evolution Mail</title> <screenshot> <screeninfo>Inbox</screeninfo> - <graphic fileref="fig/mail-inbox.png" srccredit="Kevin Breit"> + <graphic fileref="fig/mail-inbox.png" format="png" srccredit="Kevin Breit"> </graphic> </screenshot> </figure> <!-- ==============End of Figure============================== --> <para> - <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-1.png" format="png"></inlinegraphic> <guilabel>Email Viewer</guilabel> </para> @@ -98,7 +98,7 @@ </para> <para> - <inlinegraphic fileref="fig/full-2.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-2.png" format="png"></inlinegraphic> <guilabel>Email List</guilabel> </para> diff --git a/doc/C/usage-mainwindow.sgml b/doc/C/usage-mainwindow.sgml index 572f568c07..a2ce19a0cf 100644 --- a/doc/C/usage-mainwindow.sgml +++ b/doc/C/usage-mainwindow.sgml @@ -1,41 +1,350 @@ -<!-- - <!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> ---> +<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> + <chapter id="usage-mainwindow"> <title>The Evolution Workspace</title> <sect1 id="usage-mainwindow-starting"> - <title>Starting Evolution</title> - <para> - Start <application>Evolution</application> by selecting - <guimenuitem>Evolution</guimenuitem> from your - <guimenu>Programs</guimenu> menu, or by typing - <command>evolution</command> at the command line. The first time - you run the program, it will create a directory called - <filename>evolution</filename> in your home directory, where it - will keep all your <application>Evolution</application>-related - files. At this point, it will also offer to import old messages - from other mail clients, such as Netscape mail. - </para> + <title>The First Time you Start Evolution</title> + <para> + Start <application>Evolution</application> by selecting + <guimenuitem>Evolution</guimenuitem> from your + <guimenu>Programs</guimenu> menu, or by typing + <command>evolution</command> at the command line. The first + time you run the program, it will create a directory called + <filename>evolution</filename> in your home directory, where it + will keep all your <application>Evolution</application>-related + files. Then, it will offer to help you set up mail accounts and + import data from other applications. + </para> + <para> + The first screen welcomes you to the assistant. It is estimated that + configuring your mail will take 2 to 5 minutes and importing mail will + take 1 to 2 minutes. + </para> + + <sect2 id="first-step"> + <title>Step 1 of 4</title> + <para> + The Identity window is the first of four steps in the + assistant. The identity step will ask you to enter your basic + personal information. + <itemizedlist> + <listitem> + <para> + Full Name — Your full name (Example: John Doe). + </para> + </listitem> + <listitem> + <para> + Email Address — Your email address (Example: john@doe.com) + </para> + </listitem> + <listitem> + <para> + Organization — The company where you work (optional). + </para> + </listitem> + <listitem> + <para> + Signature file — If you'd like to use an email + <glossterm linkend="signature">signature</glossterm>, + select your signature file here. Normally, the + signature will be the contents of the + <filename>.signature</filename> file in your home + directory. + </para> + </listitem> + </itemizedlist> + </para> + </sect2> + + <sect2 id="second-step"> + <title>Step 2 of 4</title> + <para> + The <guilabel>Recieving Email</guilabel> step lets you configure + receving email people have sent you. + <itemizedlist> + <listitem> + <para> + Server Type — There are numerous types of servers which + <application>Evolution</application> can download your email from: + <itemizedlist> + <listitem> + <para> + POP — Downloads your email to your hard disk for + permanent storage. + </para> + </listitem> + <listitem> + <para> + IMAPv4 — Keeps the email on your server so you can + access your email from any computer that supports IMAPv4 and + have everything be the same. + </para> + </listitem> + <listitem> + <para> + Unix mbox spool-format file — Bad description, we're + getting a better definition shortly. + </para> + </listitem> + <listitem> + <para> + Standard Unix mailbox file — Bad description, we're + getting a better definition shortly. + </para> + </listitem> + <listitem> + <para> + Qmail maildir format files — If you download your + mail using qmail, you'll want to use this. + </para> + </listitem> + <listitem> + <para> + None &mdash How do you have None? figure out! + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + Email Server — This is the address of the server you're + downloading from. + </para> + </listitem> + <listitem> + <para> + Username — The username that you login to your email. That + is often the part before the @ in your email. + </para> + <para> + Authentication Type — Chances are you are using + <guilabel>Password</guilabel>. Ask your administrator for more + details. You can have <application>Evolution</application> check + by clicking <guibutton>Check for supported types</guibutton>. + </para> + <para> + Remember Password — If you prefer to not enter your + password everytime you check email, press this button. + </para> + </listitem> + </itemizedlist> + </para> + </sect2> + <sect2 id="third-step"> + <title>Step 3 or 4</title> + <para> + The <guilabel>Sending Email</guilabel> step lets you configure sending + email. + <itemizedlist> + <listitem> + <para> + Server Type — There are numerous server types that + <application>Evolution</application> supports for sending your + mail. + <itemizedlist> + <listitem> + <para> + SMTP — Downloads mail into your mailbox file. + </para> + </listitem> + <listitem> + <para> + Sendmail — Uses another program to download your mail + to your mailbox files. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + Host — If you chose SMTP, enter the server's name + or IP address here. + </para> + </listitem> + <listitem> + <para> + Server requires authentication — If your server + requires you to enter a password to send mail, check + this box. + </para> + </listitem> + <listitem> + <para> + Authentication Type — Chances are you are using + <guilabel>Password</guilabel>. If you're not sure, ask + your system administrator or ISP, or have + <application>Evolution</application> check for you by + clicking <guibutton>Check for supported + types</guibutton>. + </para> + </listitem> + <listitem> + <para> + Username — The account name you use when you login + to check your email. Normally, this is the part of your + email address before the '@' character. + </para> + </listitem> + <listitem> + <para> + Remember Password — If you prefer to not enter + your password every time you check email, press this + button. + </para> + </listitem> + </itemizedlist> + </para> + </sect2> + + <sect2 id="fourth-step"> + <title>Step 4 of 4</title> + <para> + Chances are, <application>Evolution</application> isn't your first email + program. You're probably switching from another program and will want + access to your email from your old program. It's for exactly these + situations that <application>Evolution</application> includes an import + feature. + </para> + <para> + <application>Evolution</application> can import the following types of + files: + <variablelist> + <term>VCard (.vcf, gcrd)</term> + <listitem> + <para> + The most common addressbook format. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Outlook Express 4 (.mbx)</term> + <listitem> + <para> + Email file format used by Outlook Express 4. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>MBox (mbox)</term> + <listitem> + <para> + The email box format used by Netscape, Evolution, + Eudora, and many other email clients. + </para> + </listitem> + </varlistentry> + </itemizedlist> + + + <note> + <title>Outlook 2000</title> + <para> + Outlook 2000 uses a proprietary format that + <application>Evolution</application> cannot import directly. + To import files from Outlook 2000, you will need to boot to + Windows, import the files into Mozilla mail, then reboot and + import from Mozilla. Please see the <xref="faq">FAQ for more + information. + </para> + </note> + + + Ask your system administrator if you aren't sure which you use. + </para> + + <tip> + <title>Exporting Files From Evolution</title> + <para> + Evolution uses standard file types for all its information, + so you should have no trouble taking your information + elsewhere if you want. + </para> + <para> + For mail, that's <filename>mbox</filename>, for calendar, + <filename>iCal</filename>, and for the address book, vCards + in a <filename>.db3</filename> database. + </para> + </tip> + </sect2> </sect1> - <sect1 id="usage-mainwindow-basics"> - <title>Evolution Basics</title> + <sect1 id="ui-intro"> + <title>What's What in Evolution</title> <para> - After <application>Evolution</application> starts up, you will - see the <interface>main window</interface>, with the - <interface>Inbox</interface> open. On the left of - the <interface>main window</interface> is the <interface>shortcut - bar</interface>, with several buttons in it. Just underneath the - title bar is a series of menus in the <interface>menu - bar</interface>, and below that, the <interface>tool - bar</interface> with buttons for different functions. The largest - part of the <interface>main window</interface> 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. + Now that you've gotten the first-run configuration out of the + way, you're ready to get down to work. Here's a quick + explanation of what's going on in your main + <application>Evolution</application> window. </para> + + <figure id="preface-basic-interface"> + <title>The Evolution Main Window</title> + <screenshot> + <screeninfo>Inbox</screeninfo> + <graphic fileref="fig/mainwindow-pic.png" format="png" srccredit="Kevin Breit"> + </graphic> + </screenshot> + </figure> + + <para> + <inlinegraphic fileref="fig/full-1.png" format="png"></inlinegraphic> + <guilabel>Menubar</guilabel> + </para> + + <para> + The <guilabel>Menubar</guilabel> gives you access to nearly all the + features that can be found in <application>Evolution</application>. + </para> + + <para> + <inlinegraphic fileref="fig/full-2.png" format="png"></inlinegraphic> + <guilabel>Toolbar</guilabel> + </para> + + <para> + The <guilabel>Toolbar</guilabel> gives you fast and easy access to the + most used features in each component. + </para> + + <para> + <inlinegraphic fileref="fig/full-3.png" format="png"></inlinegraphic> + <guilabel>Shortcut Bar</guilabel> + </para> + + <para> + The <guilabel>Shortcut Bar</guilabel> lets you go to your favorite + components with the click of a click of a button. + </para> + + <para> + <inlinegraphic fileref="fig/full-4.png" format="png"></inlinegraphic> + <guilabel>Status Bar</guilabel> + </para> + + <para> + Periodically, <application>Evolution</application> will need to quietly + display a message, or tell you the progress of a task. This most + often happens when you're checking or sending email. These progress + queues are shown here, in the <guilabel>Status Bar</guilabel>. + </para> + + <para> + <inlinegraphic fileref="fig/full-5.png" format="png"></inlinegraphic> + <guilabel>Search Bar</guilabel> + </para> + + <para> + The <guilabel>Search Bar</guilabel> lets you search through your email + with precision so you can easily find what you're looking for. + </para> + + <sect2 id="usage-mainwindow-shortcutbar"> <title>The Shortcut Bar</title> <para> @@ -448,266 +757,11 @@ <para> Once you've familiarized yourself with the <interface>main window</interface> you can start doing things with it. We'll - start with your executive summary. - </para> - </sect2> - </sect1> - <sect1 id="first-time-druid"> - <title>First Time Druid</title> - <para> - When you first start <application>Evolution</application>, you are - presented with a first time druid. The druid will help you get your email - preferences configured and import your email from your other program. - </para> - <para> - The first screen welcomes you to the druid. It is estimated that - configuring your mail will take 2 to 5 minutes and importing mail will - take 1 to 2 minutes. + start with <guilabel>My Evolution</guilabel>, the summary of + everything that's going on. </para> - <sect2 id="first-step"> - <title>Step 1 of 4</title> - <para> - The Identity window is the first of four steps in the druid. The - identity step lets you configure your basic, personal information. - <itemizedlist> - <listitem> - <para> - Full Name — Your full name (Example: John Doe). - </para> - </listitem> - <listitem> - <para> - Email Address — Your email address (Example: john@doe.com) - </para> - </listitem> - <listitem> - <para> - Organization — The name of the organization you are a part - of (example: Big Company, Inc.). - </para> - </listitem> - <listitem> - <para> - Signature file — You can setup - <application>Evolution</application> to put text at the end of all - your emails. This is the file which that text is located in. - </para> - </listitem> - </itemizedlist> - </para> - </sect2> - <sect2 id="second-step"> - <title>Step 2 of 4</title> - <para> - The <guilabel>Recieving Email</guilabel> step lets you configure - receving email people have sent you. - <itemizedlist> - <listitem> - <para> - Server Type — There are numerous types of servers which - <application>Evolution</application> can download your email from: - <itemizedlist> - <listitem> - <para> - POP — Downloads your email to your hard disk for - permanent storage. - </para> - </listitem> - <listitem> - <para> - IMAPv4 — Keeps the email on your server so you can - access your email from any computer that supports IMAPv4 and - have everything be there. - </para> - </listitem> - <listitem> - <para> - Unix mbox spool-format file — Bad description, we're - getting a better definition shortly. - </para> - </listitem> - <listitem> - <para> - Standard Unix mailbox file — Bad description, we're - getting a better definition shortly. - </para> - </listitem> - <listitem> - <para> - Qmail maildir format files — Mail format which the - qmail server writes as. - </para> - </listitem> - <listitem> - <para> - None &mdash You intend on not reading email using this identity. - </para> - </listitem> - </itemizedlist> - </para> - </listitem> - <listitem> - <para> - Email Server — This is the address of the server you're - downloading from. - </para> - </listitem> - <listitem> - <para> - Username — The username that you login to your email. That - is often the part before the @ in your email. - </para> - <para> - Authentication Type — Chances are you are using - <guilabel>Password</guilabel>. Ask your administrator for more - details. You can have <application>Evolution</application> check - by clicking <guibutton>Check for supported types</guibutton>. - </para> - <para> - Remember Password — If you prefer to not enter your - password everytime you check email, press this button. - </para> - </listitem> - </itemizedlist> - </para> - </sect2> - <sect2 id="third-step"> - <title>Step 3 or 4</title> - <para> - The <guilabel>Sending Email</guilabel> step lets you configure sending - email. - <itemizedlist> - <listitem> - <para> - Server Type — There are numerous server types that - <application>Evolution</application> supports for sending your - mail. - <itemizedlist> - <listitem> - <para> - SMTP — Downloads mail from a server using <application>Evolution</application>. - </para> - </listitem> - <listitem> - <para> - Sendmail — Uses another program to download your mail - to your mailbox files. <application>Evolution</application> - then reads the mail from the files. - </para> - </listitem> - </itemizedlist> - </para> - </listitem> - <listitem> - <para> - Host — The server that sends your email. - </para> - </listitem> - <listitem> - <para> - Server requires authentication — Check if you need a password to - send mail. - </para> - </listitem> - <listitem> - <para> - Authentication Type — Chances are you are using - <guilabel>Password</guilabel>. Ask your administrator for more - details. You can have <application>Evolution</application> check - by clicking <guibutton>Check for supported types</guibutton>. - </para> - </listitem> - <listitem> - <para> - Username — The username that you login to your email. That - is often the part before the @ in your email. - </para> - </listitem> - <listitem> - <para> - Remember Password — If you prefer to not enter your - password everytime you check email, press this button. - </para> - </listitem> - </itemizedlist> - </para> - </sect2> - - <sect2 id="fourth-step"> -<!-- This section sucks. Look at it, ask for improvements --> - <title>Step 4 of 4</title> - <para> - Chances are, <application>Evolution</application> isn't your first email - program. You're probably switching from another program and will want - access to your email from your old program. It's for exactly these - situations that <application>Evolution</application> includes an import - feature. - </para> - <para> - <application>Evolution</application> can import the following types of - files: - <itemizedlist> - <listitem> - <para> - VCard (.vcf, gcrd) - Contacts - </para> - </listitem> - <listitem> - <para> - Outlook Express 4 (.mbx) - Email - </para> - </listitem> - <listitem> - <para> - MBox(mbox) - Email - </para> - </listitem> - </itemizedlist> - VCard is a format to store addressbooks and contact information. Outlook - handles your email. If you're coming from - Windows, you're probably going to be importing Outlook Express files. If - you're coming from a Unix program, you're probably using mbox. Ask your - system administrator if you aren't sure which you use. - </para> - <note> - <title>Eudora</title> - <para> - Eudora email client uses mbox format to store mail. So if you're coming - from Eudora, you'll want to select mbox. - </para> - </note> - <note> - <title>Outlook 2000</title> - <para> - Outlook 2000 uses a format which <application>Evolution</application> - cannot directly import. However, you can import it using Mozilla on - Windows. Please see the FAQ for more information. - </para> - </note> - - <para> - To import your files, go to - <menuchoice> - <guimenu>File</guimenu> - <guimenuitem>Import File</guimenuitem> - </menuchoice> - </para> - <para> - An assistant will appear, helping you to import your files. You'll need to - specify where the file is that you want to import. Click - <guibutton>Next</guibutton> and then <guibutton>Import</guibutton>. - <application>Evolution</application> will present you with the Folder - dialoge, so you can specify where your new messages will go. Select the - desired folder, and your file will be imported into - <application>Evolution</application>. - </para> - <para> - And if you're timid about using <application>Evolution</application>, - don't worry. <application>Evolution</application> won't mangle your - files, so if you choose to use your old application instead, you can - import your files right back in. - </para> </sect2> </sect1> + </chapter> diff --git a/doc/ChangeLog b/doc/ChangeLog index 049f2c4fc9..773197418d 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,6 +1,29 @@ +2001-07-23 Aaron Weber <aaron@ximian.com> + + * C/usage-exec-summary.sgml: Minor revisions. + + * C/usage-contact.sgml: Added 'format="png"' to all <image> tags + missing the attribute. + + * C/usage-calendar.sgml: Added 'format="png"' to all <image> tags + missing the attribute. + + * C/usage-mail.sgml: Added 'format="png"' to all <image> tags + missing the attribute. + + * C/usage-mainwindow.sgml: Style. Merged info from preface. Added + 'format="png"' to all <image> tags missing the attribute. + + * C/preface.sgml: Style changes. Removed info that was duplicated + in mainwindow.sgml. + 2001-07-20 Kevin Breit <battery841@mediaone.net> * C/usage-mainwindow.sgml: Fixed the first time druid stuff a little more. + +2001-07-16 Aaron Weber <aaron@ximian.com> + + * C/evolution-faq.sgml: Sepllcheck. 2001-07-15 Kevin Breit <battery841@mediaone.net> @@ -12,7 +35,7 @@ 2001-07-12 Aaron Weber <aaron@ximian.com> - * C/evolution-faq.sgml: + * C/evolution-faq.sgml: TYPO fixing. 2001-07-12 Aaron Weber <aaron@ximian.com> diff --git a/help/C/config-setupassist.sgml b/help/C/config-setupassist.sgml index 8ed5cd0e38..bbc7ed6a34 100644 --- a/help/C/config-setupassist.sgml +++ b/help/C/config-setupassist.sgml @@ -1,3 +1,7 @@ +<!-- + +this chapter is useless and outdated now. + <chapter id="config-setupassist"> <title>Easy Setup with the Setup Assistant</title> <para> @@ -192,7 +196,7 @@ </chapter> - +--> diff --git a/help/C/evolution-faq.sgml b/help/C/evolution-faq.sgml index 1666f26b36..45dc89e784 100644 --- a/help/C/evolution-faq.sgml +++ b/help/C/evolution-faq.sgml @@ -27,7 +27,7 @@ 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 + proprietary segments of Exchange and Notes servers eventually, but this will come after Evolution 1.0. </para> </answer> @@ -270,7 +270,7 @@ <para> Mozilla on Windows accesses the <filename>.pst</filename> files through the <filename>MAPI.DLL</filename>, which is - only avaliable on Windows. <filename>MAPI.DLL</filename> + only available on Windows. <filename>MAPI.DLL</filename> is the only way to access <filename>.pst</filename> files and Evolution cannot use this DLL in Linux. </para> @@ -541,24 +541,7 @@ </itemizedlist> </answer> </qandaentry> - - <qandaentry> - <question> - <para> - I get <computeroutput>Cannot open composer window</computeroutput>. - </para> - </question> - <answer> - <para> - This actually means that Evolution cannot activate the HTML - editor component from GtkHTML. The comments in the previous - answer still apply; also make sure that - <command>gnome-gtkhtml-editor</command> is in your - <envar>PATH</envar>. - </para> - </answer> - </qandaentry> - + <qandaentry> <question> <para> @@ -930,7 +913,7 @@ bt <para> In one, type <command>gdb evolution-mail</command> . Replace "evolution-mail" with the name of the - component that is crashing: evolution-addresbook, + component that is crashing: evolution-addressbook, evolution-calendar, etc.) </para> </listitem> diff --git a/help/C/preface.sgml b/help/C/preface.sgml index 81a6a0dc93..26c7bd4e6f 100644 --- a/help/C/preface.sgml +++ b/help/C/preface.sgml @@ -17,9 +17,11 @@ information easier, so you can work and communicate with others. That is, it's a highly evolved <glossterm linkend="groupware">groupware</glossterm> 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. + part of the Internet-connected desktop. + </para> + <para> + Without all the hot air, that means it's a tool to help you + get your work done. </para> <para> Because it's part of the GNOME project, @@ -36,12 +38,11 @@ </para> <para> <note> - <title>This is a preview release</title> + <title>This is a Beta release</title> <para> - <application>Evolution</application> 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 <ulink + <application>Evolution</application> is now on the home + stretch to version 1.0. Please help prepare for the 1.0 + release by reporting bugs to us at <ulink url="http://bugzilla.ximian.com">bugzilla.ximian.com</ulink>. There are detailed bug reporting instructions in <xref linkend="evolution-faq">. @@ -49,8 +50,7 @@ <para> Please send comments on the guide to <email>aaron@ximian.com</email>. The first person to send - me some good constructive criticism wins a free Ximian - t-shirt. + some good suggestions gets a free Ximian t-shirt. </para> </note> </para> @@ -100,9 +100,10 @@ <listitem> <para> Data must be safe: <application>Evolution</application> - must not lose mail, corrupt mailbox files or other - data, execute arbitrary <glossterm linkend="script">scripts</glossterm>, - or delete files from your hard disk. + must not lose mail, corrupt mailbox files or other data, + execute arbitrary <glossterm + linkend="script">scripts</glossterm>, or delete files from + your hard disk. </para> </listitem> </itemizedlist> @@ -165,15 +166,18 @@ <tip id="example-tip"> <title>Example Tip</title> <para> - This is what an example looks like. + Tips and bits of extra information will look like + this. </para> </tip> + <example> <title>Example Example</title> <para> This is what an example looks like. </para> </example> + <warning id="example-warning"> <title>Example Warning</title> <para> @@ -183,151 +187,7 @@ </para> </formalpara> </sect1> - <sect1 id="ui-intro"> - <title>Evolution Interface Introduction</title> - <para> - <application>Evolution</application> follows a consistent UI. This means - that in each component, you will find many UI characteristics the same as - others components. - </para> - - <figure id="preface-basic-interface"> - <title>Evolution's Interface</title> - <screenshot> - <screeninfo>Inbox</screeninfo> - <graphic fileref="fig/mainwindow-pic.png" srccredit="Kevin Breit"> - </graphic> - </screenshot> - </figure> - - <para> - <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> - <guilabel>Menubar</guilabel> - </para> - - <para> - The <guilabel>Menubar</guilabel> gives you access to nearly all the - features that can be found in <application>Evolution</application>. - </para> - - <para> - <inlinegraphic fileref="fig/full-2.png"></inlinegraphic> - <guilabel>Toolbar</guilabel> - </para> - - <para> - The <guilabel>Toolbar</guilabel> gives you fast and easy access to the - most used features in each component. - </para> - - <para> - <inlinegraphic fileref="fig/full-3.png"></inlinegraphic> - <guilabel>Shortcut Bar</guilabel> - </para> - - <para> - The <guilabel>Shortcut Bar</guilabel> lets you go to your favorite - components with the click of a click of a button. - </para> - - <para> - <inlinegraphic fileref="fig/full-4.png"></inlinegraphic> - <guilabel>Status Bar</guilabel> - </para> - - <para> - Periodically, <application>Evolution</application> will need to quietly - display a message, or tell you the progress of a task. This most - often happens when you're checking or sending email. These progress - queues are shown here, in the <guilabel>Status Bar</guilabel>. - </para> - - <para> - <inlinegraphic fileref="fig/full-5.png"></inlinegraphic> - <guilabel>Search Bar</guilabel> - </para> - - <para> - The <guilabel>Search Bar</guilabel> lets you search through your email - with precision so you can easily find what you're looking for. - </para> - </sect1> - <sect1 id="import-tool"> -<!-- This section sucks. Look at it, ask for improvements --> - <title>Importing External Files</title> - <para> - Chances are, <application>Evolution</application> isn't your first email - program. You're probably switching from another program and will want - access to your email from your old program. It's for exactly these - situations that <application>Evolution</application> includes an import - feature. - </para> - <para> - <application>Evolution</application> can import the following types of - files: - <itemizedlist> - <listitem> - <para> - VCard (.vcf, gcrd) - Contacts - </para> - </listitem> - <listitem> - <para> - Outlook Express 4 (.mbx) - Email - </para> - </listitem> - <listitem> - <para> - MBox(mbox) - Email - </para> - </listitem> - </itemizedlist> - VCard is a format to store addressbooks and contact information. Outlook - handles your email. If you're coming from - Windows, you're probably going to be importing Outlook Express files. If - you're coming from a Unix program, you're probably using mbox. Ask your - system administrator if you aren't sure which you use. - </para> - <note> - <title>Eudora</title> - <para> - Eudora email client uses mbox format to store mail. So if you're coming - from Eudora, you'll want to select mbox. - </para> - </note> - <note> - <title>Outlook 2000</title> - <para> - Outlook 2000 uses a format which <application>Evolution</application> - cannot directly import. However, you can import it using Mozilla on - Windows. Please see the FAQ for more information. - </para> - </note> - - <para> - To import your files, go to - <menuchoice> - <guimenu>File</guimenu> - <guimenuitem>Import File</guimenuitem> - </menuchoice> - </para> - <para> - An assistant will appear, helping you to import your files. You'll need to - specify where the file is that you want to import. Click - <guibutton>Next</guibutton> and then <guibutton>Import</guibutton>. - <application>Evolution</application> will present you with the Folder - dialoge, so you can specify where your new messages will go. Select the - desired folder, and your file will be imported into - <application>Evolution</application>. - </para> - <para> - And if you're timid about using <application>Evolution</application>, - don't worry. <application>Evolution</application> won't mangle your - files, so if you choose to use your old application instead, you can - import your files right back in. - </para> - </sect1> <sect1 id="quickref-commontasks"> <title>Quick Reference for Common Tasks</title> <para> diff --git a/help/C/usage-calendar.sgml b/help/C/usage-calendar.sgml index ed69f5081e..6c44db3d61 100644 --- a/help/C/usage-calendar.sgml +++ b/help/C/usage-calendar.sgml @@ -28,7 +28,7 @@ </para> <para> - <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-1.png" format="png"></inlinegraphic> <guilabel>Event List</guilabel> </para> @@ -39,7 +39,7 @@ </para> <para> - <inlinegraphic fileref="fig/full-2.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-2.png" format="png"></inlinegraphic> <guilabel>Todo List</guilabel> </para> @@ -51,7 +51,7 @@ </para> <para> - <inlinegraphic fileref="fig/full-3.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-3.png" format="png"></inlinegraphic> <guilabel>Calendar Window</guilabel> </para> diff --git a/help/C/usage-contact.sgml b/help/C/usage-contact.sgml index a825139af0..678cca2a50 100644 --- a/help/C/usage-contact.sgml +++ b/help/C/usage-contact.sgml @@ -42,13 +42,13 @@ <title>Evolution Contact Interface</title> <screenshot> <screeninfo>Evolution Contact List Window</screeninfo> - <graphic fileref="fig/contact.png" srccredit="Kevin Breit"> + <graphic fileref="fig/contact.png" format="png" srccredit="Kevin Breit"> </graphic> </screenshot> </figure> <para> - <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-1.png" format="png"></inlinegraphic> <guilabel>Contact List</guilabel> </para> diff --git a/help/C/usage-exec-summary.sgml b/help/C/usage-exec-summary.sgml index 996e4b3132..76724e4362 100644 --- a/help/C/usage-exec-summary.sgml +++ b/help/C/usage-exec-summary.sgml @@ -101,9 +101,7 @@ <sect2 id="delete-components"> <title>Deleting Components</title> <para> - There are possibly some components which you'd prefer not too - view in your My Evolution. - To remove a component: + To remove a service from My Evolution, do the following: <orderedlist numeration="arabic"> <listitem> <para> @@ -178,3 +176,12 @@ </sect1> </chapter> + + + + + + + + + diff --git a/help/C/usage-mail.sgml b/help/C/usage-mail.sgml index 12ceb903db..54549a5dbc 100644 --- a/help/C/usage-mail.sgml +++ b/help/C/usage-mail.sgml @@ -82,14 +82,14 @@ <title>Evolution Mail</title> <screenshot> <screeninfo>Inbox</screeninfo> - <graphic fileref="fig/mail-inbox.png" srccredit="Kevin Breit"> + <graphic fileref="fig/mail-inbox.png" format="png" srccredit="Kevin Breit"> </graphic> </screenshot> </figure> <!-- ==============End of Figure============================== --> <para> - <inlinegraphic fileref="fig/full-1.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-1.png" format="png"></inlinegraphic> <guilabel>Email Viewer</guilabel> </para> @@ -98,7 +98,7 @@ </para> <para> - <inlinegraphic fileref="fig/full-2.png"></inlinegraphic> + <inlinegraphic fileref="fig/full-2.png" format="png"></inlinegraphic> <guilabel>Email List</guilabel> </para> diff --git a/help/C/usage-mainwindow.sgml b/help/C/usage-mainwindow.sgml index 572f568c07..a2ce19a0cf 100644 --- a/help/C/usage-mainwindow.sgml +++ b/help/C/usage-mainwindow.sgml @@ -1,41 +1,350 @@ -<!-- - <!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> ---> +<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> + <chapter id="usage-mainwindow"> <title>The Evolution Workspace</title> <sect1 id="usage-mainwindow-starting"> - <title>Starting Evolution</title> - <para> - Start <application>Evolution</application> by selecting - <guimenuitem>Evolution</guimenuitem> from your - <guimenu>Programs</guimenu> menu, or by typing - <command>evolution</command> at the command line. The first time - you run the program, it will create a directory called - <filename>evolution</filename> in your home directory, where it - will keep all your <application>Evolution</application>-related - files. At this point, it will also offer to import old messages - from other mail clients, such as Netscape mail. - </para> + <title>The First Time you Start Evolution</title> + <para> + Start <application>Evolution</application> by selecting + <guimenuitem>Evolution</guimenuitem> from your + <guimenu>Programs</guimenu> menu, or by typing + <command>evolution</command> at the command line. The first + time you run the program, it will create a directory called + <filename>evolution</filename> in your home directory, where it + will keep all your <application>Evolution</application>-related + files. Then, it will offer to help you set up mail accounts and + import data from other applications. + </para> + <para> + The first screen welcomes you to the assistant. It is estimated that + configuring your mail will take 2 to 5 minutes and importing mail will + take 1 to 2 minutes. + </para> + + <sect2 id="first-step"> + <title>Step 1 of 4</title> + <para> + The Identity window is the first of four steps in the + assistant. The identity step will ask you to enter your basic + personal information. + <itemizedlist> + <listitem> + <para> + Full Name — Your full name (Example: John Doe). + </para> + </listitem> + <listitem> + <para> + Email Address — Your email address (Example: john@doe.com) + </para> + </listitem> + <listitem> + <para> + Organization — The company where you work (optional). + </para> + </listitem> + <listitem> + <para> + Signature file — If you'd like to use an email + <glossterm linkend="signature">signature</glossterm>, + select your signature file here. Normally, the + signature will be the contents of the + <filename>.signature</filename> file in your home + directory. + </para> + </listitem> + </itemizedlist> + </para> + </sect2> + + <sect2 id="second-step"> + <title>Step 2 of 4</title> + <para> + The <guilabel>Recieving Email</guilabel> step lets you configure + receving email people have sent you. + <itemizedlist> + <listitem> + <para> + Server Type — There are numerous types of servers which + <application>Evolution</application> can download your email from: + <itemizedlist> + <listitem> + <para> + POP — Downloads your email to your hard disk for + permanent storage. + </para> + </listitem> + <listitem> + <para> + IMAPv4 — Keeps the email on your server so you can + access your email from any computer that supports IMAPv4 and + have everything be the same. + </para> + </listitem> + <listitem> + <para> + Unix mbox spool-format file — Bad description, we're + getting a better definition shortly. + </para> + </listitem> + <listitem> + <para> + Standard Unix mailbox file — Bad description, we're + getting a better definition shortly. + </para> + </listitem> + <listitem> + <para> + Qmail maildir format files — If you download your + mail using qmail, you'll want to use this. + </para> + </listitem> + <listitem> + <para> + None &mdash How do you have None? figure out! + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + Email Server — This is the address of the server you're + downloading from. + </para> + </listitem> + <listitem> + <para> + Username — The username that you login to your email. That + is often the part before the @ in your email. + </para> + <para> + Authentication Type — Chances are you are using + <guilabel>Password</guilabel>. Ask your administrator for more + details. You can have <application>Evolution</application> check + by clicking <guibutton>Check for supported types</guibutton>. + </para> + <para> + Remember Password — If you prefer to not enter your + password everytime you check email, press this button. + </para> + </listitem> + </itemizedlist> + </para> + </sect2> + <sect2 id="third-step"> + <title>Step 3 or 4</title> + <para> + The <guilabel>Sending Email</guilabel> step lets you configure sending + email. + <itemizedlist> + <listitem> + <para> + Server Type — There are numerous server types that + <application>Evolution</application> supports for sending your + mail. + <itemizedlist> + <listitem> + <para> + SMTP — Downloads mail into your mailbox file. + </para> + </listitem> + <listitem> + <para> + Sendmail — Uses another program to download your mail + to your mailbox files. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + Host — If you chose SMTP, enter the server's name + or IP address here. + </para> + </listitem> + <listitem> + <para> + Server requires authentication — If your server + requires you to enter a password to send mail, check + this box. + </para> + </listitem> + <listitem> + <para> + Authentication Type — Chances are you are using + <guilabel>Password</guilabel>. If you're not sure, ask + your system administrator or ISP, or have + <application>Evolution</application> check for you by + clicking <guibutton>Check for supported + types</guibutton>. + </para> + </listitem> + <listitem> + <para> + Username — The account name you use when you login + to check your email. Normally, this is the part of your + email address before the '@' character. + </para> + </listitem> + <listitem> + <para> + Remember Password — If you prefer to not enter + your password every time you check email, press this + button. + </para> + </listitem> + </itemizedlist> + </para> + </sect2> + + <sect2 id="fourth-step"> + <title>Step 4 of 4</title> + <para> + Chances are, <application>Evolution</application> isn't your first email + program. You're probably switching from another program and will want + access to your email from your old program. It's for exactly these + situations that <application>Evolution</application> includes an import + feature. + </para> + <para> + <application>Evolution</application> can import the following types of + files: + <variablelist> + <term>VCard (.vcf, gcrd)</term> + <listitem> + <para> + The most common addressbook format. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Outlook Express 4 (.mbx)</term> + <listitem> + <para> + Email file format used by Outlook Express 4. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>MBox (mbox)</term> + <listitem> + <para> + The email box format used by Netscape, Evolution, + Eudora, and many other email clients. + </para> + </listitem> + </varlistentry> + </itemizedlist> + + + <note> + <title>Outlook 2000</title> + <para> + Outlook 2000 uses a proprietary format that + <application>Evolution</application> cannot import directly. + To import files from Outlook 2000, you will need to boot to + Windows, import the files into Mozilla mail, then reboot and + import from Mozilla. Please see the <xref="faq">FAQ for more + information. + </para> + </note> + + + Ask your system administrator if you aren't sure which you use. + </para> + + <tip> + <title>Exporting Files From Evolution</title> + <para> + Evolution uses standard file types for all its information, + so you should have no trouble taking your information + elsewhere if you want. + </para> + <para> + For mail, that's <filename>mbox</filename>, for calendar, + <filename>iCal</filename>, and for the address book, vCards + in a <filename>.db3</filename> database. + </para> + </tip> + </sect2> </sect1> - <sect1 id="usage-mainwindow-basics"> - <title>Evolution Basics</title> + <sect1 id="ui-intro"> + <title>What's What in Evolution</title> <para> - After <application>Evolution</application> starts up, you will - see the <interface>main window</interface>, with the - <interface>Inbox</interface> open. On the left of - the <interface>main window</interface> is the <interface>shortcut - bar</interface>, with several buttons in it. Just underneath the - title bar is a series of menus in the <interface>menu - bar</interface>, and below that, the <interface>tool - bar</interface> with buttons for different functions. The largest - part of the <interface>main window</interface> 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. + Now that you've gotten the first-run configuration out of the + way, you're ready to get down to work. Here's a quick + explanation of what's going on in your main + <application>Evolution</application> window. </para> + + <figure id="preface-basic-interface"> + <title>The Evolution Main Window</title> + <screenshot> + <screeninfo>Inbox</screeninfo> + <graphic fileref="fig/mainwindow-pic.png" format="png" srccredit="Kevin Breit"> + </graphic> + </screenshot> + </figure> + + <para> + <inlinegraphic fileref="fig/full-1.png" format="png"></inlinegraphic> + <guilabel>Menubar</guilabel> + </para> + + <para> + The <guilabel>Menubar</guilabel> gives you access to nearly all the + features that can be found in <application>Evolution</application>. + </para> + + <para> + <inlinegraphic fileref="fig/full-2.png" format="png"></inlinegraphic> + <guilabel>Toolbar</guilabel> + </para> + + <para> + The <guilabel>Toolbar</guilabel> gives you fast and easy access to the + most used features in each component. + </para> + + <para> + <inlinegraphic fileref="fig/full-3.png" format="png"></inlinegraphic> + <guilabel>Shortcut Bar</guilabel> + </para> + + <para> + The <guilabel>Shortcut Bar</guilabel> lets you go to your favorite + components with the click of a click of a button. + </para> + + <para> + <inlinegraphic fileref="fig/full-4.png" format="png"></inlinegraphic> + <guilabel>Status Bar</guilabel> + </para> + + <para> + Periodically, <application>Evolution</application> will need to quietly + display a message, or tell you the progress of a task. This most + often happens when you're checking or sending email. These progress + queues are shown here, in the <guilabel>Status Bar</guilabel>. + </para> + + <para> + <inlinegraphic fileref="fig/full-5.png" format="png"></inlinegraphic> + <guilabel>Search Bar</guilabel> + </para> + + <para> + The <guilabel>Search Bar</guilabel> lets you search through your email + with precision so you can easily find what you're looking for. + </para> + + <sect2 id="usage-mainwindow-shortcutbar"> <title>The Shortcut Bar</title> <para> @@ -448,266 +757,11 @@ <para> Once you've familiarized yourself with the <interface>main window</interface> you can start doing things with it. We'll - start with your executive summary. - </para> - </sect2> - </sect1> - <sect1 id="first-time-druid"> - <title>First Time Druid</title> - <para> - When you first start <application>Evolution</application>, you are - presented with a first time druid. The druid will help you get your email - preferences configured and import your email from your other program. - </para> - <para> - The first screen welcomes you to the druid. It is estimated that - configuring your mail will take 2 to 5 minutes and importing mail will - take 1 to 2 minutes. + start with <guilabel>My Evolution</guilabel>, the summary of + everything that's going on. </para> - <sect2 id="first-step"> - <title>Step 1 of 4</title> - <para> - The Identity window is the first of four steps in the druid. The - identity step lets you configure your basic, personal information. - <itemizedlist> - <listitem> - <para> - Full Name — Your full name (Example: John Doe). - </para> - </listitem> - <listitem> - <para> - Email Address — Your email address (Example: john@doe.com) - </para> - </listitem> - <listitem> - <para> - Organization — The name of the organization you are a part - of (example: Big Company, Inc.). - </para> - </listitem> - <listitem> - <para> - Signature file — You can setup - <application>Evolution</application> to put text at the end of all - your emails. This is the file which that text is located in. - </para> - </listitem> - </itemizedlist> - </para> - </sect2> - <sect2 id="second-step"> - <title>Step 2 of 4</title> - <para> - The <guilabel>Recieving Email</guilabel> step lets you configure - receving email people have sent you. - <itemizedlist> - <listitem> - <para> - Server Type — There are numerous types of servers which - <application>Evolution</application> can download your email from: - <itemizedlist> - <listitem> - <para> - POP — Downloads your email to your hard disk for - permanent storage. - </para> - </listitem> - <listitem> - <para> - IMAPv4 — Keeps the email on your server so you can - access your email from any computer that supports IMAPv4 and - have everything be there. - </para> - </listitem> - <listitem> - <para> - Unix mbox spool-format file — Bad description, we're - getting a better definition shortly. - </para> - </listitem> - <listitem> - <para> - Standard Unix mailbox file — Bad description, we're - getting a better definition shortly. - </para> - </listitem> - <listitem> - <para> - Qmail maildir format files — Mail format which the - qmail server writes as. - </para> - </listitem> - <listitem> - <para> - None &mdash You intend on not reading email using this identity. - </para> - </listitem> - </itemizedlist> - </para> - </listitem> - <listitem> - <para> - Email Server — This is the address of the server you're - downloading from. - </para> - </listitem> - <listitem> - <para> - Username — The username that you login to your email. That - is often the part before the @ in your email. - </para> - <para> - Authentication Type — Chances are you are using - <guilabel>Password</guilabel>. Ask your administrator for more - details. You can have <application>Evolution</application> check - by clicking <guibutton>Check for supported types</guibutton>. - </para> - <para> - Remember Password — If you prefer to not enter your - password everytime you check email, press this button. - </para> - </listitem> - </itemizedlist> - </para> - </sect2> - <sect2 id="third-step"> - <title>Step 3 or 4</title> - <para> - The <guilabel>Sending Email</guilabel> step lets you configure sending - email. - <itemizedlist> - <listitem> - <para> - Server Type — There are numerous server types that - <application>Evolution</application> supports for sending your - mail. - <itemizedlist> - <listitem> - <para> - SMTP — Downloads mail from a server using <application>Evolution</application>. - </para> - </listitem> - <listitem> - <para> - Sendmail — Uses another program to download your mail - to your mailbox files. <application>Evolution</application> - then reads the mail from the files. - </para> - </listitem> - </itemizedlist> - </para> - </listitem> - <listitem> - <para> - Host — The server that sends your email. - </para> - </listitem> - <listitem> - <para> - Server requires authentication — Check if you need a password to - send mail. - </para> - </listitem> - <listitem> - <para> - Authentication Type — Chances are you are using - <guilabel>Password</guilabel>. Ask your administrator for more - details. You can have <application>Evolution</application> check - by clicking <guibutton>Check for supported types</guibutton>. - </para> - </listitem> - <listitem> - <para> - Username — The username that you login to your email. That - is often the part before the @ in your email. - </para> - </listitem> - <listitem> - <para> - Remember Password — If you prefer to not enter your - password everytime you check email, press this button. - </para> - </listitem> - </itemizedlist> - </para> - </sect2> - - <sect2 id="fourth-step"> -<!-- This section sucks. Look at it, ask for improvements --> - <title>Step 4 of 4</title> - <para> - Chances are, <application>Evolution</application> isn't your first email - program. You're probably switching from another program and will want - access to your email from your old program. It's for exactly these - situations that <application>Evolution</application> includes an import - feature. - </para> - <para> - <application>Evolution</application> can import the following types of - files: - <itemizedlist> - <listitem> - <para> - VCard (.vcf, gcrd) - Contacts - </para> - </listitem> - <listitem> - <para> - Outlook Express 4 (.mbx) - Email - </para> - </listitem> - <listitem> - <para> - MBox(mbox) - Email - </para> - </listitem> - </itemizedlist> - VCard is a format to store addressbooks and contact information. Outlook - handles your email. If you're coming from - Windows, you're probably going to be importing Outlook Express files. If - you're coming from a Unix program, you're probably using mbox. Ask your - system administrator if you aren't sure which you use. - </para> - <note> - <title>Eudora</title> - <para> - Eudora email client uses mbox format to store mail. So if you're coming - from Eudora, you'll want to select mbox. - </para> - </note> - <note> - <title>Outlook 2000</title> - <para> - Outlook 2000 uses a format which <application>Evolution</application> - cannot directly import. However, you can import it using Mozilla on - Windows. Please see the FAQ for more information. - </para> - </note> - - <para> - To import your files, go to - <menuchoice> - <guimenu>File</guimenu> - <guimenuitem>Import File</guimenuitem> - </menuchoice> - </para> - <para> - An assistant will appear, helping you to import your files. You'll need to - specify where the file is that you want to import. Click - <guibutton>Next</guibutton> and then <guibutton>Import</guibutton>. - <application>Evolution</application> will present you with the Folder - dialoge, so you can specify where your new messages will go. Select the - desired folder, and your file will be imported into - <application>Evolution</application>. - </para> - <para> - And if you're timid about using <application>Evolution</application>, - don't worry. <application>Evolution</application> won't mangle your - files, so if you choose to use your old application instead, you can - import your files right back in. - </para> </sect2> </sect1> + </chapter> diff --git a/help/ChangeLog b/help/ChangeLog index 049f2c4fc9..773197418d 100644 --- a/help/ChangeLog +++ b/help/ChangeLog @@ -1,6 +1,29 @@ +2001-07-23 Aaron Weber <aaron@ximian.com> + + * C/usage-exec-summary.sgml: Minor revisions. + + * C/usage-contact.sgml: Added 'format="png"' to all <image> tags + missing the attribute. + + * C/usage-calendar.sgml: Added 'format="png"' to all <image> tags + missing the attribute. + + * C/usage-mail.sgml: Added 'format="png"' to all <image> tags + missing the attribute. + + * C/usage-mainwindow.sgml: Style. Merged info from preface. Added + 'format="png"' to all <image> tags missing the attribute. + + * C/preface.sgml: Style changes. Removed info that was duplicated + in mainwindow.sgml. + 2001-07-20 Kevin Breit <battery841@mediaone.net> * C/usage-mainwindow.sgml: Fixed the first time druid stuff a little more. + +2001-07-16 Aaron Weber <aaron@ximian.com> + + * C/evolution-faq.sgml: Sepllcheck. 2001-07-15 Kevin Breit <battery841@mediaone.net> @@ -12,7 +35,7 @@ 2001-07-12 Aaron Weber <aaron@ximian.com> - * C/evolution-faq.sgml: + * C/evolution-faq.sgml: TYPO fixing. 2001-07-12 Aaron Weber <aaron@ximian.com> |