<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
  <!-- Define an entity for your application if it is not part of KDE
       CVS -->
  <!ENTITY i18n-folderarchiveagent "<application>Folder Archive Agent</application>">
  <!ENTITY kappname "&i18n-folderarchiveagent;">
  <!ENTITY package "kdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
  <!ENTITY imap "<acronym>IMAP</acronym>">
]>

<article id="folderarchiveagent" lang="&language;">
<articleinfo>
<title>The &i18n-folderarchiveagent; Handbook</title>
<authorgroup>
<author>
<personname>
<firstname>Laurent</firstname>
<surname>Montel</surname>
</personname>
<email>montel@kde.org</email>
</author>
<author>
<firstname>Scarlett</firstname>
<surname>Clark</surname>
<affiliation><address>
&Scarlett.Clark.mail;
</address></affiliation>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<copyright>
<year>2013</year>
<holder>Laurent Montel</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2013-11-21</date>
<releaseinfo>&kde; 4.12</releaseinfo>
</articleinfo>

<sect1 id="introduction">
<title>Introduction</title>

<para>&i18n-folderarchiveagent; can be enabled on a per account basis to allow you to archive individual emails through
the right click menu.</para>


<sect2 id="using-kapp">
<title>Using &i18n-folderarchiveagent;</title>

<screenshot>
<screeninfo>Screenshot of &i18n-folderarchiveagent;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="folderarchiveagent.png" format="PNG" />
    </imageobject>
  </mediaobject>
</screenshot>

<para>&i18n-folderarchiveagent; is used to archive single emails to a specified folder. For instance, you need to archive all of
those pesky bill receipts in one place. &i18n-folderarchiveagent; can easily accommodate those needs. <action>Start by
using <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Folder Archive Agent...</guimenuitem></menuchoice>
in &kmail;'s reader window to open a dialog to set up the folder archive agent.</action>
</para>

<para>This dialog will have a tab for each of your configured accounts including Local Folders and you will need to configure all accounts that you wish to
use this feature with. The first option allows you to enable/disable the folder archive agent. It is disabled by default, to enable check the <guilabel>Enable</guilabel>
checkbox. You can set the location of your Archive folder by clicking the folder icon next to
<guilabel>Folder:</guilabel> and selecting the folder you wish to use. For example, you could create
a folder called <quote>bill receipts</quote> by clicking the <guibutton>New Subfolder...</guibutton> and typing <userinput>bill receipts</userinput> in
the dialog. You may choose a folder location anywhere, &eg;.. a folder in your <quote>Local Folders</quote> or on your &imap; server.</para>
<para>
You have several choices on how the emails will be archived:
</para>
<variablelist id="archivefolder-options">
  <varlistentry>
  <term><guilabel>Unique folder</guilabel></term>
  <listitem><para>Uses the selected folder sorted by date.</para></listitem>
  </varlistentry>
  <varlistentry>
  <term><guilabel>Folder by months</guilabel></term>
  <listitem><para>Creates new folders inside the selected folder by months.</para></listitem>
  </varlistentry>
  <varlistentry>
  <term><guilabel>Folder by years</guilabel></term>
  <listitem><para>Creates new folders inside the selected folder by years.</para></listitem>
  </varlistentry>
</variablelist>
<para>
Now when you receive a bill receipt, &RMB; the email and select <guimenuitem>Archive</guimenuitem> from the menu. The email will be archived
into your configured archive folder for easy viewing later on.
</para>
</sect2>

<sect2 id="credits">

<title>Credits and License</title>

<para>&i18n-folderarchiveagent;</para>
<para>
Program copyright 2013 Laurent Montel montel@kde.org 
</para>
<para>
Documentation Copyright &copy; 2013 Laurent Montel montel@kde.org
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;               <!-- FDL: do not remove -->
&underGPL;        	 <!-- GPL License -->
</sect2>
</sect1>

</article>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->