[kde-doc-english] [kdepim] doc/kmail: Documentation: Updated outdated intro doc to new features.

[Scarlett Clark]

Git commit 840df97fdb5e822e8569cd82399bb90346bb47a1 by Scarlett Clark.
Committed on 12/12/2013 at 17:56.
Pushed by scarlettclark into branch 'master'.

Documentation: Updated outdated intro doc to new features.

REVIEW:114420

M  +63   -30   doc/kmail/intro.docbook
A  +-    --    doc/kmail/kmailwelcome.png

http://commits.kde.org/kdepim/840df97fdb5e822e8569cd82399bb90346bb47a1

diff --git a/doc/kmail/intro.docbook b/doc/kmail/intro.docbook
index ec4fdd9..60d67d9 100644
--- a/doc/kmail/intro.docbook
+++ b/doc/kmail/intro.docbook
@@ -9,53 +9,86 @@
 <email>daniel.naber at t-online.de</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-12-12</date>
+<releaseinfo>&kde; 4.12</releaseinfo>
 </chapterinfo>
 
-<title>Introduction</title>
 
-<para>The &kmail; Team welcomes you to &kmail;, a user-friendly email client for the
-K Desktop Environment. Our goal is to make &kmail; a program that is beautiful
-and intuitive without sacrificing power. </para>
+<title>Introduction</title>
 
-<para>If you have never set up an email client on a &UNIX; system
-before, we suggest that you read through the <link
-linkend="getting-started">Getting Started</link> section first so that
-your setup goes smoothly.</para>
+<screenshot>
+<screeninfo>&kmail; Welcome Screen</screeninfo>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="kmailwelcome.png" format="PNG"/>
+    </imageobject>
+    <textobject>
+      <phrase>&kmail; Welcome Screen</phrase>
+    </textobject>
+    <caption>
+      <para>&kmail; Welcome Screen</para>
+    </caption>
+  </mediaobject>
+</screenshot>
 
-<para>Since most people do not read documentation anyway, here is a
-collection of the most helpful tips:</para>
+<para>The &kmail; Team welcomes you to &kmail;, a user-friendly email client for &kde;.
+Our goal is to make &kmail; a program that is beautiful and intuitive without sacrificing power. </para>
 
+<para>If you have never set up an email client on a &UNIX; system
+before, we suggest that you read through the <link linkend="getting-started">Getting Started</link>
+section first.</para>
+<sect1 id="features">
+<title>Some &kmail; Features</title>
+<para>Some links to the great features available in &kmail;</para>
 <itemizedlist>
 <listitem>
 <para>You do not have to use your mouse to use &kmail;. Everything can
 be done by using <link linkend="keyboard-shortcuts">Keyboard Shortcuts</link>.</para>
 </listitem>
-<!-- adapt to kmail2/akonadi lueck 31.05.2011-->
 <listitem>
 <para>Although &kmail; can be considered reliable you should keep 
-backups of your messages, &ie; just copy the files and folders 
-listed in the <link
-linkend="transfer-mail-and-settings">FAQ</link> to a safe place.</para>
+backups of your messages, &ie; use one of the export/archive options listed in <link
+linkend="backups">Backup Options</link> to backup your settings and email to a safe place.</para>
+</listitem>
+<listitem>
+<para>&kmail; is capable of importing email in several formats from your previous email applications using
+options in <link linkend="import-restore">Restore and Import in &kmail;</link>.</para>
+</listitem>
+<listitem>
+<para>Organize your folders with ease using &kmail;s extensive <link linkend="folders">Folders</link> options.
+Some of the features include handling per folder: mailing lists, acl (&imap; only), and archiving.</para>
+</listitem>
+<listitem>
+<para>Compliment your folder setup with highly configurable <link linkend="filters">filters</link>.</para>
+</listitem>
+<listitem>
+<para>By default &kmail; will detect common email <link linkend="configure-security-email-scams">scams</link>.
+You can also fight SPAM and viruses with built in wizards to work with external programs to scan email as it comes in.
+See <link linkend="the-anti-spam-wizard">Anti Spam Wizard</link> and <link linkend="the-anti-virus-wizard">Anti-Virus-Wizard</link>
+for details.</para>
+</listitem>
+<listitem>
+<para>Easily manage per-account settings using multiple <link linkend="configure-identity">identities</link>.</para>
 </listitem>
-<!-- TODO: add other tips for "invisible" features here -->
-
 </itemizedlist>
-
-<note><para>If you experience any problems migrating to &kmail; 2 in &kde; 
-4.8 please read the chapter <link linkend="troubleshooting">Troubleshooting</link>.
-</para></note>
-
-<para>&kmail;'s homepage can be found at <ulink
-url="http://userbase.kde.org/KMail">http://userbase.kde.org/KMail</ulink>. There you will
-find useful links, ⪚ to the user and developer mailing lists.
-Please report bugs in &kmail; using
-<menuchoice><guimenu>Help</guimenu><guimenuitem>Report
-Bug...</guimenuitem></menuchoice>.</para>
-
 <para>We hope you will enjoy &kmail;!</para>
+<sect2 id="getting-help">
+<title>Getting Help</title>
+<note><para>If you experience any problems migrating to &kmail; 2 please read the chapter <link linkend="troubleshooting">Troubleshooting</link>.
+</para></note>
+<para>&kmail;'s homepage can be found at <ulink url="http://userbase.kde.org/KMail">http://userbase.kde.org/KMail</ulink>. There you will
+find useful links, ⪚ to the user and developer mailing lists. Please report bugs in &kmail; using
+<menuchoice><guimenu>Help</guimenu><guimenuitem>Report Bug...</guimenuitem></menuchoice>.</para>
+</sect2>
 
+</sect1>
 </chapter>
diff --git a/doc/kmail/kmailwelcome.png b/doc/kmail/kmailwelcome.png
new file mode 100644
index 0000000..6244238
Binary files /dev/null and b/doc/kmail/kmailwelcome.png differ