From bacd47805ed9be1bd1fcb7b3fc3e12adf12ade64 Mon Sep 17 00:00:00 2001
From: Andre Klapper <a9016009@gmx.de>
Date: Thu, 4 Aug 2011 15:38:54 +0200
Subject: Put new user documentation in place

---
 help/C/intro-first-run.page | 108 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 108 insertions(+)
 create mode 100644 help/C/intro-first-run.page

(limited to 'help/C/intro-first-run.page')

diff --git a/help/C/intro-first-run.page b/help/C/intro-first-run.page
new file mode 100644
index 0000000000..92b5613988
--- /dev/null
+++ b/help/C/intro-first-run.page
@@ -0,0 +1,108 @@
+<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its"
+      type="topic" id="intro-first-run">
+
+  <info>
+    <desc>Running Evolution for the very first time.</desc>
+
+    <link type="guide" xref="index#getting-started"/>
+
+    <revision pkgversion="2.30.2" version="0.1" date="2010-12-09" status="stub"/>
+    <credit type="author">
+      <name>Andre Klapper</name>
+      <email>ak-47@gmx.net</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+
+  </info>
+
+  <title>Starting <em>Evolution</em> for the first time</title>
+
+<p>The first time you run Evolution, it opens the First-Run Assistant to help you set up email accounts and <link xref="import-data">import data from other applications.</link></p>
+
+<section id="identity">
+<title>Identity</title>
+<p>Here you define your name and your email address.</p>
+<p>Optionally you can make this account your default account (e.g. when writing emails), set a Reply-To email address (if you want replies to messages sent to a different address), and set an organization (the company where you work, or the organization you represent when you send email from this account).</p>
+</section>
+
+<section id="restore">
+<title>Restore from backup</title>
+<p>You will get asked whether to restore from a backup of a previous version. If you have such a backup, continue <link xref="backup-restore#restore">here</link>. Otherwise, go to the next page.</p>
+</section>
+
+<section id="receiving">
+<title>Receiving Email</title>
+<p>First, choose the server type from the <gui>Server Type</gui> dropdown-list.</p>
+<p>If you are unsure about the type of server to choose, ask your system administrator or Internet Service Provider.</p>
+
+
+<section id="common-server-types">
+<title>Common server types</title>
+<p>The most common available server types for normal users are:</p>
+<list>
+<item><p>None: If you do not plan to use Evolution for receiving email.</p><p>Continue <link xref="#sending">here</link> for configuration.</p></item>
+<item><p>IMAP: Keeps the mail on the server so you can access your mail from multiple systems.</p><p>Continue <link xref="mail-receiving-options-imap">here</link> for configuration.</p></item>
+<!-- TODO:DEVELOPERS: So what's the difference between IMAP and IMAP+, and what is recommended, dear developers? -->
+<item><p>IMAP+: Keeps the mail on the server so you can access your mail from multiple systems.</p><p>Continue <link xref="mail-receiving-options-imap-plus">here</link> for configuration.</p></item>
+<item><p>POP: Downloads your email to your hard disk.</p><p>Continue <link xref="mail-receiving-options-pop">here</link> for configuration.</p></item>
+<item><p>USENET News: Connects to a news server and downloads a list of available news digests.</p><p>Continue <link xref="mail-receiving-options-usenet-news">here</link> for configuration.</p></item>
+</list>
+</section>
+
+<section id="corporate-server-types">
+<title>Corporate server types</title>
+<p>Available server types for corporate users are:</p>
+<!-- TODO:POST-3-2: Add evolution-ews once it is stable -->
+<list>
+<item><p>Exchange MAPI: For connecting to a Microsoft Exchange 2007/2010 or OpenChange server.</p><p>Continue <link xref="mail-receiving-options-exchange-mapi">here</link> for configuration.</p>
+<note style="tip"><p>This requires having the evolution-mapi package installed. <link action="install:evolution-mapi" href="http://ftp.gnome.org/pub/gnome/sources/evolution-mapi/">Install evolution-mapi now.</link></p></note>
+</item>
+<item><p>Microsoft Exchange: For connecting to a Microsoft Exchange 2000 or 2003 server.</p><p>Continue <link xref="mail-receiving-options-evolution-exchange">here</link> for configuration.</p>
+<note style="tip"><p>This requires having the evolution-exchange package installed. <link action="install:evolution-exchange" href="http://ftp.gnome.org/pub/gnome/sources/evolution-exchange/">Install evolution-exchange now.</link></p></note>
+</item>
+<item><p>Novell Groupwise: For connecting to a Novell GroupWise server.</p><p>Continue <link xref="mail-receiving-options-novell-groupwise">here</link> for configuration.</p></item>
+</list>
+</section>
+
+<section id="local-account-server-types">
+<title>Local account server types</title>
+<p>Available local account server types for advanced users are:</p>
+<list>
+<item><p>Local delivery: If you want to move email from the spool (the location where mail waits for delivery) and store it in your home directory. You need to provide the path to the mail spool you want to use. If you want to leave email in your system's spool files, choose the <gui>Standard Unix Mbox Spool</gui> option instead.</p><p>Continue <link xref="mail-receiving-options-local-delivery">here</link> for configuration.</p></item>
+
+<item><p>MH-Format Mail Directories: For downloading email using MH or another MH-style program.</p><p>You need to provide the path to the directory you want to use.</p><p>Continue <link xref="mail-receiving-options-mh-format-directories">here</link> for configuration.</p></item>
+
+<item><p>Maildir-Format Mail Directories: For downloading your email using Qmail or another Maildir-style program.</p><p>You need to provide the path to the directory you want to use.</p><p>Continue <link xref="mail-receiving-options-maildir-format-directories">here</link> for configuration.</p></item>
+
+<item><p>Standard Unix mbox spool file: For reading and storing email in the mail spool file on your local system.</p><p>Continue <link xref="mail-receiving-options-unix-mbox-spool-file">here</link> for configuration.</p><p>You need to provide the path to the mail spool file you want to use.</p></item>
+
+<item><p>Standard Unix mbox spool directory: For reading and storing email in the mail spool directory on your local system.</p><p>You need to provide the path to the directory you want to use.</p><p>Continue <link xref="mail-receiving-options-unix-mbox-spool-directory">here</link> for configuration.</p></item>
+</list>
+
+<note style="tip"><p>Later on, if you want to change an account, or if you want to create another one, go to <guiseq><gui>Edit</gui><gui>Preferences</gui><gui>Mail Accounts</gui></guiseq>. Select the account you want to change, then click <gui style="button">Edit</gui>. Alternately, add a new account by clicking <gui style="button">Add</gui>.</p></note>
+</section>
+
+</section>
+
+<section id="sending"> <!-- Do not rename, we link to it from the subpages -->
+<title>Sending mail</title>
+<p>Available server types are:</p>
+<list>
+<item><p>SMTP: Sends mail using an outbound mail server. This is the most common choice for sending mail.</p><p>Continue <link xref="mail-sending-options-smtp">here</link> for configuration.</p></item>
+<item><p>Sendmail: Uses the Sendmail program to send mail from your system. It is not easy to configure, so you should select this option only if you know how to set up a Sendmail service.</p></item>
+</list>
+</section>
+
+<section id="account-information">
+<title>Account Information</title>
+<p>Give the account any name you prefer.</p>
+</section>
+
+<section id="account-import">
+<title>Importing Mail (Optional)</title>
+<p>Continue with <link xref="import-data">Importing data from another application</link>.</p>
+</section>
+
+</page>
-- 
cgit