Added lots of good stuff with the first time druid.

2001-07-13  Kevin Breit  <battery841@mediaone.net>

	* C/usage-mainwindow.sgml: Added lots of good stuff with the first time druid.

svn path=/trunk/; revision=11102

2 files changed, 510 insertions, 0 deletions

diff --git a/doc/C/usage-mainwindow.sgml b/doc/C/usage-mainwindow.sgml
index e0b413742b..157eaad279 100644
--- a/doc/C/usage-mainwindow.sgml
+++ b/doc/C/usage-mainwindow.sgml
@@ -452,5 +452,260 @@
     </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.
+    </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 &mdash; Your full name (Example: John Doe).
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Email Address &mdash; Your email address (Example: john@doe.com)
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Organization &mdash; The company you work for (optional).
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Signature file &mdash; 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 &mdash; There are numerous types of servers which
+	      <application>Evolution</application> can download your email from:
+	      <itemizedlist>
+		<listitem>
+		  <para>
+		    POP &mdash; Downloads your email to your hard disk for
+		    permanent storage.
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    IMAPv4 &mdash; 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 &mdash; Bad description, we're
+		    getting a better definition shortly.
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Standard Unix mailbox file &mdash; Bad description, we're
+		    getting a better definition shortly.
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Qmail maildir format files &mdash; 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 &mdash; This is the address of the server you're
+	      downloading from.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Username &mdash; The username that you login to your email.  That
+	      is often the part before the @ in your email.
+	    </para>
+	    <para>
+	      Authentication Type &mdash; 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 &mdash; 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 &mdash; There are numerous server types that
+	      <application>Evolution</application> supports for sending your
+	      mail.
+	      <itemizedlist>
+		<listitem>
+		  <para>
+		    SMTP &mdash; Downloads mail into your mailbox file.
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Sendmail &mdash; Uses another program to download your mail
+		    to your mailbox files.
+		  </para>
+		</listitem>
+	      </itemizedlist>
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Host &mdash; The server to connect to that sends your mail.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Server requires authentication &mdash; Check if you need a password to
+	      send mail.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Authentication Type &mdash; 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 &mdash; The username that you login to your email.  That
+	      is often the part before the @ in your email.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Remember Password &mdash; 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/C/usage-mainwindow.sgml b/help/C/usage-mainwindow.sgml
index e0b413742b..157eaad279 100644
--- a/help/C/usage-mainwindow.sgml
+++ b/help/C/usage-mainwindow.sgml
@@ -452,5 +452,260 @@
     </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.
+    </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 &mdash; Your full name (Example: John Doe).
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Email Address &mdash; Your email address (Example: john@doe.com)
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Organization &mdash; The company you work for (optional).
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Signature file &mdash; 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 &mdash; There are numerous types of servers which
+	      <application>Evolution</application> can download your email from:
+	      <itemizedlist>
+		<listitem>
+		  <para>
+		    POP &mdash; Downloads your email to your hard disk for
+		    permanent storage.
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    IMAPv4 &mdash; 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 &mdash; Bad description, we're
+		    getting a better definition shortly.
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Standard Unix mailbox file &mdash; Bad description, we're
+		    getting a better definition shortly.
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Qmail maildir format files &mdash; 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 &mdash; This is the address of the server you're
+	      downloading from.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Username &mdash; The username that you login to your email.  That
+	      is often the part before the @ in your email.
+	    </para>
+	    <para>
+	      Authentication Type &mdash; 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 &mdash; 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 &mdash; There are numerous server types that
+	      <application>Evolution</application> supports for sending your
+	      mail.
+	      <itemizedlist>
+		<listitem>
+		  <para>
+		    SMTP &mdash; Downloads mail into your mailbox file.
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Sendmail &mdash; Uses another program to download your mail
+		    to your mailbox files.
+		  </para>
+		</listitem>
+	      </itemizedlist>
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Host &mdash; The server to connect to that sends your mail.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Server requires authentication &mdash; Check if you need a password to
+	      send mail.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Authentication Type &mdash; 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 &mdash; The username that you login to your email.  That
+	      is often the part before the @ in your email.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Remember Password &mdash; 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>