[evolution-kolab] KolabMailAccess: documentation update

[Christian Hilberg <chilberg src gnome org>]

commit cb698bf7eae4fda0e0bae995a4ca1ecb7833a78e
Author: Christian Hilberg <hilberg kernelconcepts de>
Date:   Thu Sep 20 14:19:37 2012 +0200

    KolabMailAccess: documentation update

 src/libekolab/kolab-mail-access.c |    8 +++++++-
 1 files changed, 7 insertions(+), 1 deletions(-)
---
diff --git a/src/libekolab/kolab-mail-access.c b/src/libekolab/kolab-mail-access.c
index b061eea..a21fb54 100644
--- a/src/libekolab/kolab-mail-access.c
+++ b/src/libekolab/kolab-mail-access.c
@@ -905,7 +905,9 @@ mail_access_local_delete (KolabMailAccess *self,
 			}
 		}
 		
-		/* offline delete operation (not done if online operation failed before) */
+		/* offline delete operation (not done if online operation failed before,
+		 * skipped for folders)
+		 */
 		if (online_ok && (location & KOLAB_OBJECT_CACHE_LOCATION_SIDE)) {
 			if (kmailhandle != NULL)
 				ok = kolab_mail_side_cache_delete (priv->sidecache,
@@ -3146,6 +3148,10 @@ kolab_mail_access_create_source (KolabMailAccess *self,
  * type and the folder context #KolabMailAccess is currently configured for,
  * so any folder can be deleted by this function.
  *
+ * The folder to be deleted must be emptied prior to the deletion operation.
+ * If a folder contains objects or subfolders, an attempt to delete the folder
+ * will fail.
+ *
  * The local #KolabMailSideCache and #KolabMailInfoDb data is not updated,
  * since the cache reaper of the E-D-S source registry will clean up the
  * entire cache directory associated with the deleted sourcename once the