Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 31 insertions, 0 deletions

diff --git a/doc/kioslave/imap.docbook b/doc/kioslave/imap.docbook
new file mode 100644
index 000000000..e34c1e4e9
--- /dev/null
+++ b/doc/kioslave/imap.docbook
@@ -0,0 +1,31 @@
+<article lang="&language;" id="imap">
+<title>imap</title>
+<articleinfo>
+<authorgroup>
+<author>&Michael.Haeckel; &Michael.Haeckel.mail;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+ 
+<date>2001-08-07</date>
+
+ 
+</articleinfo>
+
+<para>The IMAP4rev1 protocol (Internet Message Access Protocol) allows
+access to messages in mail folders on a server. Unlike POP3, which is designed
+to download the mails and delete them from the server, the purpose of IMAP is
+to store all mails on the server to be able to access these mails from
+everywhere. Messages can be stored on the server, retrieved from there or
+moved between folders.</para>
+
+<para>This plugin is currently mainly used by KMail, but you can also use it
+in any other KDE application that uses kioslave plugins.</para>
+
+<para>For example in &konqueror;, simply type
+<userinput>imap://username@your.mail.server/</userinput> to get your IMAP
+folders listed. You can then deal with the folders and mails like with folders
+and files on a local file system.
+IMAP URLs are defined in <ulink url="http://www.ietf.org/rfc/rfc2192.txt?number=2192">RFC 2192</ulink>.
+</para>
+
+</article>