Reorganize tdeioslave help handbooks, fix related protocol files and issues, update and add handbooks.

CMakeLists.txt

@@ -88,7 +88,7 @@ endif( )
 # WITH_ARTS   affects kalarm
 # WITH_ARTS   description without arts kalarm won't play sounds
 #                         with messages.
-# WITH_SASL   affects tdeioslaves(sieve imap4)
+# WITH_SASL   affects tdeioslave(sieve imap4)
 # WITH_SASL   description sieve tdeioslave won't build without sasl and 
 #	                      imap4 tdeioslave will lose the ability of SASL
 #	                      authentification
@@ -138,7 +138,7 @@ option( BUILD_LIBKPGP "Build libkpgp" ${BUILD_ALL} )
 option( BUILD_MIMELIB "Build mimelib" ${BUILD_ALL} )
 option( BUILD_LIBKSIEVE "Build libksieve" ${BUILD_ALL} )
 option( BUILD_LIBKPIMEXCHANGE "Build libkpimexchange" ${BUILD_ALL} )
-option( BUILD_TDEIOSLAVES "Build tdeioslaves" ${BUILD_ALL} )
+option( BUILD_TDEIOSLAVE "Build tdeioslave" ${BUILD_ALL} )
 option( BUILD_KMAIL "Build kmail" ${BUILD_ALL} )
 option( BUILD_AKREGATOR "Build akregator" ${BUILD_ALL} )
 option( BUILD_KALARM "Build kalarm" ${BUILD_ALL} )
@@ -185,7 +185,7 @@ set( CMAKE_MODULE_LINKER_FLAGS "-Wl,--no-undefined" )
 
 ##### activate dependencies #####################
 
-if( BUILD_LIBKCAL OR BUILD_LIBTDEPIM OR BUILD_LIBKPIMIDENTITIES OR BUILD_TDEIOSLAVES OR BUILD_KMAIL OR BUILD_KNODE )
+if( BUILD_LIBKCAL OR BUILD_LIBTDEPIM OR BUILD_LIBKPIMIDENTITIES OR BUILD_TDEIOSLAVE OR BUILD_KMAIL OR BUILD_KNODE )
   add_subdirectory( libemailfunctions )
 endif()
 
@@ -209,7 +209,7 @@ tde_conditional_add_subdirectory( BUILD_LIBKPGP libkpgp )
 tde_conditional_add_subdirectory( BUILD_MIMELIB mimelib )
 tde_conditional_add_subdirectory( BUILD_LIBKSIEVE libksieve )
 tde_conditional_add_subdirectory( BUILD_LIBKPIMEXCHANGE libkpimexchange )
-tde_conditional_add_subdirectory( BUILD_TDEIOSLAVES tdeioslaves )
+tde_conditional_add_subdirectory( BUILD_TDEIOSLAVE tdeioslave )
 tde_conditional_add_subdirectory( BUILD_KMAIL kmail )
 tde_conditional_add_subdirectory( BUILD_AKREGATOR akregator )
 tde_conditional_add_subdirectory( BUILD_KALARM kalarm )

Makefile.am.in

@@ -28,7 +28,7 @@ COMPILE_BEFORE_knode= libtdepim libkpgp libkmime
 COMPILE_BEFORE_karm = libtdepim tderesources
 COMPILE_BEFORE_plugins = kmail libtdepim libkcal
 COMPILE_BEFORE_kontact = kaddressbook knotes korganizer akregator karm
-COMPILE_BEFORE_tdeioslaves = libkmime libtdepim
+COMPILE_BEFORE_tdeioslave = libkmime libtdepim
 COMPILE_BEFORE_libkpimexchange = libtdepim
 COMPILE_BEFORE_kalarm = libtdepim libkmime
 COMPILE_BEFORE_tderesources = libkpimexchange knotes kaddressbook kode

config.h.cmake

@@ -29,7 +29,7 @@
 #cmakedefine MAX_CMD_LENGTH @MAX_CMD_LENGTH@
 #cmakedefine HAVE_C99_INITIALIZERS 1
 
-// tdeioslaves
+// tdeioslave
 #cmakedefine HAVE_LIBSASL2 1
 
 // kmail

doc/tdeioslave/CMakeLists.txt

@@ -0,0 +1,9 @@
+#################################################
+#
+#  Improvements and feedback are welcome
+#
+#  This file is released under GPL >= 2
+#
+#################################################
+
+tde_auto_add_subdirectories()

doc/tdeioslave/Makefile.am

@@ -0,0 +1,4 @@
+SUBDIRS = $(AUTODIRS)
+KDE_LANG = en
+KDE_DOCS = AUTO
+

doc/tdeioslave/mbox/CMakeLists.txt

@@ -0,0 +1,9 @@
+#################################################
+#
+#  Improvements and feedback are welcome
+#
+#  This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION tdeioslave/mbox )

doc/tdeioslave/mbox/Makefile.am

@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = tdeioslave/mbox

doc/tdeioslave/mbox/index.docbook

@@ -0,0 +1,25 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<article lang="&language;" id="mbox">
+<title>mbox</title>
+
+<articleinfo>
+
+<authorgroup>
+<author><personname><firstname>Bertjan</firstname><surname>Broeksema</surname></personname></author>
+<author>&tde-authors;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+</articleinfo>
+
+<para>The mbox file format is an simple but rather inefficient way to store email 
+messages. All messages are appended after each other in the same file 
+separated by a special separator line. This gets especially expensive when 
+you have many emails in the same file.</para> 
+
+</article>

doc/tdeioslave/sieve/CMakeLists.txt

@@ -0,0 +1,9 @@
+#################################################
+#
+#  Improvements and feedback are welcome
+#
+#  This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION tdeioslave/sieve )

doc/tdeioslave/sieve/Makefile.am

@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = tdeioslave/sieve

doc/tdeioslave/sieve/index.docbook

@@ -0,0 +1,27 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<article lang="&language;" id="sieve">
+<title>sieve</title>
+
+<articleinfo>
+
+<authorgroup>
+<author><personname><firstname>Daniel</firstname><surname>Black</surname></personname></author>
+<author>&tde-authors;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+</articleinfo>
+
+<para>Sieve is a protocol that is used to manage filters for email.</para> 
+
+<para>The filters are stored and run on the email server.</para>
+
+<para><ulink url="http://www.ietf.org/rfc/rfc5228.txt">IETF
+RF5228</ulink> provides more information.</para>
+
+</article>

tdeioslave/Makefile.am

@@ -6,6 +6,6 @@ endif
 
 SUBDIRS = imap4 mbox $(SIEVE_SUBDIR)
 
-DOXYGEN_REFERENCES = tdeioslaves/imap4 tdeioslaves/mbox
+DOXYGEN_REFERENCES = tdeioslave/imap4 tdeioslave/mbox
 include $(top_srcdir)/admin/Doxyfile.am
 

tdeioslave/imap4/imaps.protocol

@@ -27,4 +27,4 @@ source=true
 Capabilities=Subscription,ACL,Quota
 
 Icon=folder_inbox
-DocPath=tdeioslave/imaps/index.html
+DocPath=tdeioslave/imap/index.html