[kmail] doc: Update KMail agent docs
Yuri Chornoivan
null at kde.org
Sat Sep 21 08:21:31 BST 2019
Git commit df33200a6ce2f7b753e7216b8ac6a5fa4024da7a by Yuri Chornoivan.
Committed on 21/09/2019 at 07:21.
Pushed by yurchor into branch 'master'.
Update KMail agent docs
M +- -- doc/akonadi_archivemail_agent/add-archive-mail.png
M +- -- doc/akonadi_archivemail_agent/configure-archive-mail-agent.png
M +10 -6 doc/akonadi_archivemail_agent/index.docbook
A +- -- doc/akonadi_followupreminder_agent/add-followup-reminder.png
A +- -- doc/akonadi_followupreminder_agent/followupreminder-configure.png
M +49 -4 doc/akonadi_followupreminder_agent/index.docbook
M +6 -5 doc/akonadi_sendlater_agent/index.docbook
M +- -- doc/akonadi_sendlater_agent/sendlateragent-configure.png
M +- -- doc/akonadi_sendlater_agent/sendlateragent-dialog.png
https://commits.kde.org/kmail/df33200a6ce2f7b753e7216b8ac6a5fa4024da7a
diff --git a/doc/akonadi_archivemail_agent/add-archive-mail.png b/doc/akonadi_archivemail_agent/add-archive-mail.png
index 638166bbf..495d34fe0 100644
Binary files a/doc/akonadi_archivemail_agent/add-archive-mail.png and b/doc/akonadi_archivemail_agent/add-archive-mail.png differ
diff --git a/doc/akonadi_archivemail_agent/configure-archive-mail-agent.png b/doc/akonadi_archivemail_agent/configure-archive-mail-agent.png
index 04f8d791e..b9b0d18e3 100644
Binary files a/doc/akonadi_archivemail_agent/configure-archive-mail-agent.png and b/doc/akonadi_archivemail_agent/configure-archive-mail-agent.png differ
diff --git a/doc/akonadi_archivemail_agent/index.docbook b/doc/akonadi_archivemail_agent/index.docbook
index 2cb270d07..7cf1434a1 100644
--- a/doc/akonadi_archivemail_agent/index.docbook
+++ b/doc/akonadi_archivemail_agent/index.docbook
@@ -30,8 +30,8 @@
<legalnotice>&FDLNotice;</legalnotice>
-<date>2013-08-30</date>
-<releaseinfo>&kde; 4.11</releaseinfo>
+<date>2019-09-21</date>
+<releaseinfo>Applications 19.12</releaseinfo>
</articleinfo>
<sect1 id="introduction">
@@ -45,7 +45,7 @@
<title>Using &i18n-archivemailagent;</title>
<!-- keep in sync with kmail/menus.docbook reader-tools-configure-automatic-archiving"-->
-<para>Use <menuchoice><guimenu>Tools</guimenu><guimenuitem>Configure Automatic Archiving...</guimenuitem>
+<para>Use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Automatic Archiving...</guimenuitem>
</menuchoice><action> in &kmail;'s reader window to open a dialog to set up automatic archiving of mail folders.</action>
</para>
@@ -73,7 +73,7 @@ the <guibutton>Add...</guibutton> button, and the <guilabel>Add Archive Mail</gu
<listitem><para>Select the format you would like to save it in. ⪚ <literal role="extension">.tar.bz2</literal>
in the drop down list. The archive filename will consist of the prefix <userinput>Archive_</userinput>,
the path of the selected folder in &kmail;'s folder list, the date in format <userinput>year-month-day</userinput>
-and the selected file extension ⪚ <filename>Archive_Local Folder_inbox_2013-09-03.tar.bz2</filename>.
+and the selected file extension ⪚ <filename>Archive_Local Folder_inbox_2019-09-03.tar.bz2</filename>.
</para></listitem>
<listitem><para>By default <guilabel>Archive all subfolders</guilabel> is enabled.
Uncheck this if you only want the parent folder archived.</para></listitem>
@@ -107,6 +107,10 @@ Agent</guilabel> dialog will list and allow to modify them.
<para>You can use the checkbox at the left of each entry in the list to enable or disable
archiving of this job.
</para>
+<para>It is possible to access this configurational dialog any time later using <menuchoice><guimenu>Settings</guimenu>
+<guimenuitem>Configure &kmail;...</guimenuitem></menuchoice> then select the <guilabel>Plugins</guilabel> page in &kmail; main window and pressing
+the configuration button against the <guilabel>Archive Mail Agent</guilabel> item.
+</para>
<para>Using the context menu launched with a &RMB; click on an archive job you can open the
folder containing the archives or start the archive job immediately. This will overwrite an existing
archive created earlier at the same day without notification.
@@ -120,10 +124,10 @@ archive created earlier at the same day without notification.
<para>&i18n-archivemailagent;</para>
<para>
-Program copyright 2013 Laurent Montel montel at kde.org
+Program copyright 2013-2019 Laurent Montel montel at kde.org
</para>
<para>
-Documentation Copyright © 2013 Laurent Montel montel at kde.org
+Documentation Copyright © 2013-2019 Laurent Montel montel at kde.org
</para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
diff --git a/doc/akonadi_followupreminder_agent/add-followup-reminder.png b/doc/akonadi_followupreminder_agent/add-followup-reminder.png
new file mode 100644
index 000000000..2583a51c1
Binary files /dev/null and b/doc/akonadi_followupreminder_agent/add-followup-reminder.png differ
diff --git a/doc/akonadi_followupreminder_agent/followupreminder-configure.png b/doc/akonadi_followupreminder_agent/followupreminder-configure.png
new file mode 100644
index 000000000..0f959eed9
Binary files /dev/null and b/doc/akonadi_followupreminder_agent/followupreminder-configure.png differ
diff --git a/doc/akonadi_followupreminder_agent/index.docbook b/doc/akonadi_followupreminder_agent/index.docbook
index 15515b1dd..f0f5cdf0d 100644
--- a/doc/akonadi_followupreminder_agent/index.docbook
+++ b/doc/akonadi_followupreminder_agent/index.docbook
@@ -25,8 +25,8 @@
<holder>&Laurent.Montel;</holder>
</copyright>
-<date>2014-06-10</date>
-<releaseinfo>&kde; 4.14</releaseinfo>
+<date>2019-09-21</date>
+<releaseinfo>Applications 19.12</releaseinfo>
</articleinfo>
@@ -37,16 +37,61 @@
&i18n-followupreminderagent; is an akonadi agent which follow up reminder mail
</para>
+<sect2 id="using-kapp">
+<title>Using &i18n-followupreminderagent;</title>
+
+<para>Use <menuchoice><guimenu>Options</guimenu><guimenuitem>Create Follow Up Reminder</guimenuitem></menuchoice>
+in &kmail;'s composer window to open a dialog which allows you to create a reminder to follow up your current email
+at a specific date.</para>
+
+<screenshot>
+<screeninfo>&i18n-followupreminderagent; Dialog</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="add-followup-reminder.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&i18n-followupreminderagent; Dialog</phrase>
+ </textobject>
+ <caption>
+ <para>&i18n-followupreminderagent; Dialog</para>
+ </caption>
+ </mediaobject>
+</screenshot>
+
+<para>Press the arrow-down button against the <guilabel>Date</guilabel> field to select the date from the &kde; calendar widget. It is also possible to choose your calender for the reminder using the <guilabel>Store ToDo in</guilabel> drop-down list.</para>
+<para>To remove reminders you have scheduled, use <menuchoice><guimenu>Settings</guimenu>
+<guimenuitem>Configure &kmail;...</guimenuitem></menuchoice> then select the <guilabel>Plugins</guilabel> page in &kmail; and press
+the configuration button against the <guilabel>Followup Reminder Agent</guilabel> item. Then use the context menu launched with a &RMB; click on a reminder item to select the <guimenuitem>Delete</guimenuitem> action.
+</para>
+
+<screenshot>
+<screeninfo>Configure &i18n-followupreminderagent;</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="followupreminder-configure.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Configure &i18n-followupreminderagent;</phrase>
+ </textobject>
+ <caption>
+ <para>Configure &i18n-followupreminderagent;</para>
+ </caption>
+ </mediaobject>
+</screenshot>
+
+</sect2>
+
<sect2 id="credits">
<title>Credits and License</title>
<para>&i18n-followupreminderagent;</para>
<para>
-Program copyright 2014 &Laurent.Montel; &Laurent.Montel.mail;
+Program copyright 2014-2019 &Laurent.Montel; &Laurent.Montel.mail;
</para>
<para>
-Documentation Copyright © 2014 &Laurent.Montel; &Laurent.Montel.mail;
+Documentation Copyright © 2014-2019 &Laurent.Montel; &Laurent.Montel.mail;
</para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
diff --git a/doc/akonadi_sendlater_agent/index.docbook b/doc/akonadi_sendlater_agent/index.docbook
index e0f844770..c00810a0a 100644
--- a/doc/akonadi_sendlater_agent/index.docbook
+++ b/doc/akonadi_sendlater_agent/index.docbook
@@ -32,8 +32,8 @@
<holder>&Laurent.Montel;</holder>
</copyright>
-<date>2013-11-30</date>
-<releaseinfo>&kde; 4.12</releaseinfo>
+<date>2019-09-21</date>
+<releaseinfo>Applications 19.12</releaseinfo>
</articleinfo>
@@ -82,7 +82,8 @@ and ask if you want to resend it later.</para>
messages overdue since the last logout if necessary.
</para>
<para>To change the options for emails you have scheduled to send later, use <menuchoice><guimenu>Settings</guimenu>
-<guimenuitem>Configure Send Later Agent...</guimenuitem></menuchoice> in &kmail;.
+<guimenuitem>Configure &kmail;...</guimenuitem></menuchoice> then select the <guilabel>Plugins</guilabel> page in &kmail; and press
+the configuration button against the <guilabel>Send Later Agent</guilabel> item.
</para>
<screenshot>
@@ -113,10 +114,10 @@ that have been sent using the send later feature.</action>
<para>&i18n-sendlateragent;</para>
<para>
-Program copyright 2013 &Laurent.Montel; &Laurent.Montel.mail;
+Program copyright 2013-2019 &Laurent.Montel; &Laurent.Montel.mail;
</para>
<para>
-Documentation Copyright © 2013 &Laurent.Montel; &Laurent.Montel.mail;
+Documentation Copyright © 2013-2019 &Laurent.Montel; &Laurent.Montel.mail;
</para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
diff --git a/doc/akonadi_sendlater_agent/sendlateragent-configure.png b/doc/akonadi_sendlater_agent/sendlateragent-configure.png
index cd8499fc6..9c11db3b7 100644
Binary files a/doc/akonadi_sendlater_agent/sendlateragent-configure.png and b/doc/akonadi_sendlater_agent/sendlateragent-configure.png differ
diff --git a/doc/akonadi_sendlater_agent/sendlateragent-dialog.png b/doc/akonadi_sendlater_agent/sendlateragent-dialog.png
index c5665db6d..f300c8efd 100644
Binary files a/doc/akonadi_sendlater_agent/sendlateragent-dialog.png and b/doc/akonadi_sendlater_agent/sendlateragent-dialog.png differ
More information about the kde-doc-english
mailing list