[kde-doc-english] [kdepim/KDE/4.11] doc/kmailcvt: Added documentation for kmailcvt

[Burkhard Lück]

Git commit 91d46563a4d7318afc2424cd6668b5601775c3cd by Burkhard Lück, on behalf of Scarlett Clark.
Committed on 13/08/2013 at 13:01.
Pushed by lueck into branch 'KDE/4.11'.

Added documentation for kmailcvt

REVIEW:112030
(cherry picked from commit 5cd34593dfe86b8e21fc189481ef9dbae740075c)
backport to 4.11.1

M  +60   -4    doc/kmailcvt/index.docbook
A  +-    --    doc/kmailcvt/kmailcvt.png

http://commits.kde.org/kdepim/91d46563a4d7318afc2424cd6668b5601775c3cd

diff --git a/doc/kmailcvt/index.docbook b/doc/kmailcvt/index.docbook
index 2238d05..ce7dd23 100644
--- a/doc/kmailcvt/index.docbook
+++ b/doc/kmailcvt/index.docbook
@@ -3,7 +3,7 @@
 "dtd/kdex.dtd" [
   <!-- Define an entity for your application if it is not part of KDE
        CVS -->
-  <!ENTITY kapplication "<application>kmailcvt</application>">
+  <!ENTITY kapplication "<application>KMailCVT</application>">
   <!ENTITY kappname "&kapplication;">
   <!ENTITY package "kdepim">
   <!ENTITY % addindex "IGNORE">
@@ -24,6 +24,13 @@
 </personname>
 <email>montel at kde.org</email>
 </author>
+<author>
+<firstname>Scarlett</firstname>
+<surname>Clark</surname>
+<affiliation><address>
+&Scarlett.Clark.mail;
+</address></affiliation>
+</author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
@@ -39,7 +46,7 @@
 
 <abstract>
 <para>
-&kapplication; allows to import emails.
+&kapplication; assists in importing email messages.
 </para>
 </abstract>
 
@@ -52,13 +59,61 @@
 <chapter id="introduction">
 <title>Introduction</title>
 
-<para>&kapplication; allows to import emails from other mailers.</para>
+<para>&kapplication; is to be used to import your email messages if your previous email application/format is listed below.</para>
+  <simplelist>
+    <member>KMail Archive</member>
+    <member>mbox(Unix, Evolution)</member>
+    <member>Evolution 1.x</member>
+    <member>Evolution 2.x</member>
+    <member>Evolution 3.x</member>
+    <member>&kmail;</member>
+    <member>OS X Mail</member>
+    <member>Opera</member>
+    <member>Sylpheed</member>
+    <member>Thunderbird/Mozilla</member>
+    <member>The Bat!</member>
+    <member>Outlook Express</member>
+    <member>Pegasus-Mail</member>
+    <member>Lotus Notes</member>
+    <member>Plain Text</member>
+  </simplelist>
+<para>If your previous email application/format is not listed here, please see <ulink url="help:/kmail/importing.html">Importing</ulink>
+ for other importing options.</para>
 
 </chapter>
 
 <chapter id="using-kapp">
 <title>Using &kapplication;</title>
-<para>using</para>
+
+<para>
+<screenshot>
+<screeninfo>Screenshot of &kapplication;</screeninfo>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="kmailcvt.png" format="PNG" />
+    </imageobject>
+  </mediaobject>
+</screenshot>
+</para>
+
+
+
+<sect1 id="kmailcvt-basic-usage">
+<title>&kapplication; Basic Usage</title>
+<para>&kapplication; is a tool that allows easy importing from supported application.
+ Access it using <menuchoice><guimenu>File</guimenu><guimenuitem>Import Messages</guimenuitem></menuchoice>
+within &kmail; or run &kapplication; as a stand alone application.</para>
+<note><para> Please make sure that you compact your folders in the other email client.</para></note>
+<para>Select your previous email program from the drop down box. The center text area of &kapplication; will update
+ with special instructions (if applicable), and the known location of email message storage for that application.
+ Follow these instructions, then select the folder you wish to import your messages to.</para>
+<para>If you want the &kapplication; tool to remove duplicate messages, check <guilabel>Remove duplicate messages during import</guilabel>.
+ A file select dialog will pop up and you need to select the file/folder noted in the instructions.
+ Click the <guibutton>Next</guibutton> button to complete the import. When the import is finished you
+ can click the <guibutton>Back</guibutton> button to import from another application or the <guibutton>Finish</guibutton> button to exit.
+</para>
+
+</sect1>
 
 </chapter>
 
@@ -72,6 +127,7 @@ Program copyright 2013 Laurent Montel montel at kde.org
 </para>
 <para>
 Documentation Copyright © 2013 Laurent Montel montel at kde.org
+and Scarlett Clark scarlett at scarlettgatelyclark.com
 </para>
 
 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
diff --git a/doc/kmailcvt/kmailcvt.png b/doc/kmailcvt/kmailcvt.png
new file mode 100644
index 0000000..1b90d67
Binary files /dev/null and b/doc/kmailcvt/kmailcvt.png differ