[kde-doc-english] [kdepim/KDE/4.11] doc/kmail: Documentation: Added Kmail Account Wizard

[Burkhard Lück]

Git commit 31fa99d4017b37eb0866aca2c7e14fde08282d01 by Burkhard Lück, on behalf of Scarlett Clark.
Committed on 24/07/2013 at 13:22.
Pushed by lueck into branch 'KDE/4.11'.

Documentation: Added Kmail Account Wizard

REVIEW:111668
(cherry picked from commit d907f1a26f029cfd2b7253e3755a847b21a4680a)
backport to 4.11.1

M  +57   -22   doc/kmail/getting-started.docbook

http://commits.kde.org/kdepim/31fa99d4017b37eb0866aca2c7e14fde08282d01

diff --git a/doc/kmail/getting-started.docbook b/doc/kmail/getting-started.docbook
index ac4b740..a483f13 100644
--- a/doc/kmail/getting-started.docbook
+++ b/doc/kmail/getting-started.docbook
@@ -23,34 +23,69 @@
 <email>michel at klaralvdalens-datakonsult.se</email>
 </address></affiliation>
 </author>
+<author>
+<firstname>Scarlett</firstname>
+<surname>Clark</surname>
+<affiliation><address>
+&Scarlett.Clark.mail;
+</address></affiliation>
+</author>
+
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
-<date>2011-07-15</date>
-<releaseinfo>2.1.96 (&kde; 4.7)</releaseinfo>
+<date>2013-07-23</date>
+<releaseinfo>&kde; 4.11</releaseinfo>
 </chapterinfo>
 
-<title>Getting Started</title>
 
-<!-- Accounts Wizard missing, launched at the first start on a system
-  the wizard can be later started with Tools->Accounts Wizard from the menu-->
+<title>Getting Started</title>
 
 <para>This is a short introduction to &kmail; and its usage so you can
 start working with it right away. For more in-depth information see the
 <link linkend="using-kmail">Using &kmail;</link> section. Note that
 &kmail;'s installation is described in <link linkend="installation">the
 appendix</link>.</para>
-<!-- adapt to kmail2/akonadi lueck 31.05.2011-->
-<para>Invoking &kmail; for the first time creates a folder called
-<filename class="directory">Mail</filename> in your home folder.
-This folder contains the initial folders
-(<filename class="directory">inbox</filename>, <filename class="directory">outbox</filename>,
-<filename class="directory">sent-mail</filename>, <filename class="directory">trash</filename> and
-<filename class="directory">drafts</filename>). Use <menuchoice>
-<guimenu>Settings</guimenu> <guimenuitem>Configure
-&kmail;...</guimenuitem> </menuchoice> to enter some initial information
-so &kmail; will be able to properly retrieve and send your
-messages.</para>
 
+<sect1 id="account-wizard">
+  <title>Account Wizard</title>
+  <para>The first time you run &kmail; you will be greeted with the Account Wizard.
+    <note><para>If at anytime you need to run the account wizard again, you can find it under
+        <menuchoice><guimenu>Tools</guimenu><guimenuitem>Account Wizard</guimenuitem></menuchoice>.</para></note>
+    The wizard will take you through the process of creating your email accounts. Your screens will vary depending
+    on how much the wizard can determine on its own. Below is an outline of the screens you may encounter while using this wizard.</para>
+<itemizedlist>
+  <listitem>
+    <para><guilabel>Provide personal data</guilabel> is the first screen of the wizard. It will prompt you for your basic account information: name, email, and password.
+      It is highly suggested to leave the <guilabel>Find provider settings on the Internet</guilabel> option checked, the wizard will attempt to retrieve the necessary
+      information from the server. If you are an expert user, and need to set up advanced configuration, uncheck it.
+      Click the <guibutton>Next</guibutton> button once finished.
+    </para>
+  </listitem>
+  <listitem>
+    <para>The <guilabel>Select Account Type</guilabel> screen will be next if the wizard cannot determine your account type. Select your account type from the
+      list (if you do not know, you will need to contact your email provider). If your account type is not listed, click the <guibutton>Check for more on Internet</guibutton> button.
+      Once your account type has been selected, click the <guibutton>Next</guibutton> button, and you will be presented with the <guilabel>Personal Settings</guilabel> screen.
+    </para>
+    <para>The <guilabel>Provide personal data</guilabel> screen will show if the wizard was successful at determining the account type.
+      Click the <guibutton>Create Account</guibutton> button, and it will set up the account. Click the <guibutton>Finish</guibutton> to complete the wizard and close the window.
+    </para>
+  </listitem>
+  <listitem>
+    <para>The <guilabel>Personal Settings</guilabel> screen will show if you had to enter your account type.
+      Verify that your information is correct on this page. Select <guilabel>Download all messages for offline use</guilabel>
+      if you want your messages available when you do not have an Internet connection (&imap; only).
+      Click the <guibutton>Next</guibutton> button once finished.</para>
+    </listitem>
+    <listitem>
+      <para>Your account will then be set up, and you can click the <guibutton>Finish</guibutton> button to complete the wizard and close the window.</para>
+    </listitem>
+  </itemizedlist>
+  <para>For manually creating accounts please continue reading the rest of this document.</para>
+
+</sect1>
+
+<sect1 id="manual-configuration-quickstart">
+  <title>Manual Configuration Quickstart</title>
 <para>The Configure window consists of six sections:
 <guilabel>Identities</guilabel>, <guilabel>Accounts</guilabel>,
 <guilabel>Appearance</guilabel>, <guilabel>Composer</guilabel>,
@@ -61,7 +96,7 @@ messages.</para>
 change some settings in the <guilabel>Identities</guilabel> and
 <guilabel>Accounts</guilabel> pages.</para>
 
-  <sect1 id="setting-your-identity">
+  <sect2 id="setting-your-identity">
     <title>
       Setting your Identity
     </title>
@@ -92,9 +127,9 @@ change some settings in the <guilabel>Identities</guilabel> and
       do with <emphasis>digital signatures</emphasis>.
     </para>
 
-  </sect1>
+  </sect2>
 
-<sect1 id="setting-up-your-account">
+<sect2 id="setting-up-your-account">
 <title>Setting up your Account</title>
 
 <para>The <guilabel>Accounts</guilabel> page contains the settings that
@@ -105,7 +140,7 @@ setting to choose or what to put in a field, consult your Internet
 Service Provider (<acronym>ISP</acronym>) or system
 administrator.</para>
 
-<sect2 id="sending-mail">
+<sect3 id="sending-mail">
 <title>Sending Messages</title>
 
 <para>The <guilabel>Sending</guilabel> tab provides a list of
@@ -136,13 +171,13 @@ section.</para>
 your default identity and for all other identities that do not have their own
 way of sending messages. You can use different ways of sending
 messages for different identities by selecting the <guilabel>Special
-transport</guilabel> checkbox in the <guilabel>Advanced</guilabel>
+transport</guilabel> check box in the <guilabel>Advanced</guilabel>
 tab of the <guilabel>Identities</guilabel> page.</para>
 
 <para>A description of the other options can be found
 in the <link linkend="configure-accounts-sending">Configuration</link>
 chapter.</para>
-
+</sect3>
 
 <sect3 id="sending-mail-kolab">
 <title>Options relevant to <acronym>Kolab</acronym> server</title>