[kde-doc-english] [kdepim/KDE/4.12] doc/kmail: Documentation:Improve Folders section in using-kmail Part 1
Burkhard Lück
lueck at hube-lueck.de
Tue Dec 24 09:14:10 UTC 2013
Git commit 1bccac07dcf088661f2f61a8eb67382479ab0a02 by Burkhard Lück, on behalf of Scarlett Clark.
Committed on 05/12/2013 at 21:51.
Pushed by lueck into branch 'KDE/4.12'.
Documentation:Improve Folders section in using-kmail Part 1
REVIEW:114309
(cherry picked from commit a5acfe04767d828518c0f102d20857aea1363ae1)
backport to 4.12.1
M +84 -52 doc/kmail/using-kmail.docbook
http://commits.kde.org/kdepim/1bccac07dcf088661f2f61a8eb67382479ab0a02
diff --git a/doc/kmail/using-kmail.docbook b/doc/kmail/using-kmail.docbook
index b798103..bdab681 100644
--- a/doc/kmail/using-kmail.docbook
+++ b/doc/kmail/using-kmail.docbook
@@ -164,16 +164,15 @@ at the bottom.</entry>
<entry><keycombo action="simul">&Alt;<keycap>Down Arrow</keycap></keycombo></entry>
<entry>Go to the previous folder in the folder list (if the folder list has focus.)</entry>
</row>
-<!-- wrong in 4.7 lueck
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>Left Arrow</keycap></keycombo></entry>
-<entry>Walk upwards in the list of folders. Use
+<entry>Focus on previous folder. Use
<keycombo action="simul">&Ctrl;<keycap>Space</keycap></keycombo> to actually
enter the folder.</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>Right Arrow</keycap></keycombo></entry>
-<entry>Walk downwards in the list of folders. Use
+<entry>Focus on next folder. Use
<keycombo action="simul">&Ctrl;<keycap>Space</keycap></keycombo> to actually
enter the folder.</entry>
</row>
@@ -183,7 +182,6 @@ enter the folder.</entry>
to using <keycombo action="simul">&Ctrl;<keycap>Left Arrow</keycap></keycombo> or
<keycombo action="simul">&Ctrl;<keycap>Right Arrow</keycap></keycombo>.</entry>
</row>
--->
<row>
<entry><keycombo action="simul">&Shift;<keycap>Left Arrow</keycap></keycombo> and
<keycombo action="simul">&Shift;<keycap>Right Arrow</keycap></keycombo></entry>
@@ -484,24 +482,31 @@ snippetDelimiter=$
<sect1 id="folders">
<title>Message Folders</title>
-<!-- review and adapt to kmail2/akonadi lueck 31.05.2011-->
-<para>Message Folders are used to organize your email messages. <!-- By default,
-if you have no existing message folders, messages are stored in the folder
-<filename
-class="directory">$<envar>KDEHOME</envar>/share/apps/kmail/</filename>. If
-you have existing message folders in <filename
- class="directory">~/Mail</filename>, these will be used instead.--> When you
-first start &kmail; the <guilabel>inbox</guilabel>,
+<screenshot>
+<screeninfo>Folder Setup Example</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="folder-example.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Folder Setup Example</phrase>
+ </textobject>
+ <caption>
+ <para>Folder Setup Example</para>
+ </caption>
+ </mediaobject>
+</screenshot>
+<para>Message Folders are used to organize your email messages. When you
+ first start &kmail; the <quote>Local Folders"</quote> containing <guilabel>inbox</guilabel>,
<guilabel>outbox</guilabel>, <guilabel>sent-mail</guilabel>,
<guilabel>trash</guilabel>, <guilabel>drafts</guilabel> and <guilabel>templates</guilabel>
folders are created. These folders each have special functions:</para>
-
<variablelist>
<varlistentry>
<term><guilabel>inbox:</guilabel></term>
<listitem>
<para>Where &kmail; by default puts your new messages when you ask it to check your
-mail. </para>
+ mail. </para><note><para>&imap; accounts will not use this inbox. The inbox is located on the &imap; server.</para></note>
</listitem>
</varlistentry>
<varlistentry>
@@ -509,56 +514,83 @@ mail. </para>
<listitem>
<para>Where messages are put while they are waiting to be delivered. Note that
you should not drag and drop messages here to send them, use the <guiicon>Send</guiicon>
-icon in the composer window instead.<!-- fixme 3.2: has this been 'fixed'? --></para>
-</listitem>
-</varlistentry>
+icon in the composer window instead.<!-- fixme 3.2: has this been 'fixed'? Still cannot drag and drop 12/4/2013 --></para>
+</listitem></varlistentry>
<varlistentry>
<term><guilabel>sent-mail:</guilabel></term>
<listitem>
<para>By default copies of all messages that you have sent are put into this folder.</para>
-</listitem>
-</varlistentry>
+</listitem></varlistentry>
<varlistentry>
<term><guilabel>trash:</guilabel></term>
<listitem>
<para>By default all messages that you have moved to trash are moved into this folder.</para>
-</listitem>
-</varlistentry>
+</listitem></varlistentry>
<varlistentry>
<term><guilabel>drafts:</guilabel></term>
<listitem>
<para>Contains messages you started to edit but then saved to this
-folder instead of sending them.</para>
-</listitem>
-</varlistentry>
-<varlistentry><term><guilabel>templates:</guilabel></term>
- <listitem>
- <para>This folder holds your templates created via <menuchoice><guimenu>Message</guimenu><guimenuitem>Save as Template</guimenuitem></menuchoice>
- in the composer window. Please see <link linkend="new-compose-from-templates">New Composer Templates</link> for details.</para>
- </listitem>
-</varlistentry>
+ folder through <menuchoice><guimenu>Message</guimenu><guimenuitem>Save as Draft</guimenuitem></menuchoice>.</para>
+</listitem></varlistentry>
+<varlistentry>
+<term><guilabel>templates:</guilabel></term>
+<listitem>
+<para>This folder holds your templates created via <menuchoice><guimenu>Message</guimenu><guimenuitem>Save as Template</guimenuitem></menuchoice>
+in the composer window. Please see <link linkend="new-compose-from-templates">New Composer Templates</link> for details.</para>
+</listitem></varlistentry>
+</variablelist>
+<sect2 id="folder-details">
+<title>Creating and Using Folders</title>
+
+<para>Organize your emails, ⪚ by mailing lists, bill receipts &etc;, by creating new folders. To create a new folder, select
+<menuchoice><guimenu>Folder</guimenu><guimenuitem>Add Folder...</guimenuitem></menuchoice> or <guimenuitem>Add Folder...</guimenuitem> from
+the &RMB; context menu. A dialog will pop up, enter the name of the new folder in the text box. You can fully customize each folder ⪚ views, replies, &etc;
+in the properties for a folder by selecting the folder you wish to modify in the folders pane and select <guimenuitem>Folder Properties</guimenuitem> from the &RMB; context menu.
+See <link linkend="folders-properties-window">Properties of Folder</link> for details.</para>
+
+<para>To move messages from one folder into another, select the message(s) you want to move and press the <keycap>M</keycap> key or select
+<menuchoice><guimenu>Message</guimenu><guimenuitem>Move Messages To</guimenuitem></menuchoice>. A list of folders will appear; select the folder
+from the list that you want to move the messages to. Messages can also be moved by dragging them from the Message list to a folder in the Folder list.</para>
+
+<para>If you have folders that are frequently accessed, you can add them to your favorite folders pane in the upper left corner. Add them through the &RMB;
+context menu <guimenuitem>Add to Favorite Folders</guimenuitem>.</para>
+
+<para>You can create a virtual folder with search parameters by going to either <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find Messages...</guimenuitem></menuchoice>, <menuchoice><guimenu>Tools</guimenu>
+<guimenuitem>Find Messages...</guimenuitem></menuchoice>, or Keyboard shortcut <keycap>S</keycap>. Enter your search parameters into the dialog. Name
+your search at the bottom <guilabel>Search folder name:</guilabel> textbox, ⪚ <replaceable>emails with the word Blog</replaceable>. Click the <guibutton>Search</guibutton> button. Now select
+the <guibutton>Open Search Folder</guibutton>. Your results folder will be at the bottom of the Folder pane.</para>
+
+<para>Creating filters to automatically move messages to specified folders is a great way to organize messages by mailing list, sender, subject &etc;
+Please see <link linkend="filters">Filters</link> for details.</para>
+
+<para>In the case that you receive emails from a trusted source, ⪚ a Blog you signed up for, that is formatted in &HTML; and you would like to enable &HTML; view for just those emails. You can achieve this
+by doing the following: Create a new folder, set up a <link linkend="filters">filter</link> to place those emails in the new folder,
+select the folder and select <menuchoice><guimenu>Folder</guimenu><guimenuitem>Prefer &HTML; to Plain Text</guimenuitem></menuchoice>.</para>
+
+<para>Some common folder actions are:</para>
+<variablelist>
+<varlistentry>
+<term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Move All Messages to Trash</guimenuitem></menuchoice></term>
+<listitem>
+<para><action>Moves</action> all your messages in the selected folder to the trash folder.</para>
+</listitem></varlistentry>
+<varlistentry>
+<term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Archive Folder</guimenuitem></menuchoice></term>
+<listitem>
+<para><action>Create an archive</action> of the folder. See <link linkend="folder-archive">Archive Folder</link> for details.</para>
+</listitem></varlistentry>
+<varlistentry>
+<term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Delete Folder</guimenuitem></menuchoice></term>
+<listitem>
+<para><action>Remove a folder</action> with all its messages and sub-folders.</para>
+</listitem></varlistentry>
+<varlistentry>
+<term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Remove Duplicate Messages</guimenuitem></menuchoice></term>
+<listitem>
+<para>This will <action>search</action> the currently selected folder for duplicates and <action>delete</action> them.</para>
+</listitem></varlistentry>
</variablelist>
-<para>You may find that the standard folders are fine for your
-needs; eventually, though, you will probably need folders to help you organize
-your messages. To create a new folder, select
-<menuchoice><guimenu>Folder</guimenu><guimenuitem>Add Folder...</guimenuitem></menuchoice>.
-The <link linkend="folders-properties-window">folder properties</link> dialog
-will then prompt you for the necessary information. If you ever need to change
-the settings for a folder, select the folder you wish to modify in the Folders pane and select
-<guimenuitem>Folder Properties</guimenuitem> from the context menu.</para>
-
-<para>To move messages from one folder into another, select the message(s) you
-want to move and press the <keycap>M</keycap> key or select
-<menuchoice><guimenu>Message</guimenu><guimenuitem>Move Messages
-To</guimenuitem></menuchoice>. A list of folders will appear; select the folder
-from the list that you want to move the messages to. Messages can also be moved
-by dragging them from the Message list to a folder in the Folder list.</para>
-
-<para>If you want to clear all of the messages out of a folder choose
-<menuchoice><guimenu>Folder</guimenu><guimenuitem>Move All Messages to
-Trash</guimenuitem></menuchoice>. You can use
-<menuchoice><guimenu>Folder</guimenu><guimenuitem>Delete Folder</guimenuitem></menuchoice>
-to remove a folder and all its messages and subfolders.</para>
+</sect2>
<sect2 id="folders-properties-window">
<title>Folder Properties</title>
@@ -1862,7 +1894,7 @@ you need to debug your filtering process.
<para>&kmail; can easily import several file formats from the following applications with the <application>KMailCVT</application> tool found in
:</para>
<simplelist>
- <member>KMail Archive</member>
+ <member>&kmail; Archive</member>
<member>mbox(Unix, Evolution)</member>
<member>Evolution 1.x</member>
<member>Evolution 2.x</member>
More information about the kde-doc-english
mailing list