Update libedataserver API docs.

4 files changed, 103 insertions, 19 deletions

diff --git a/docs/reference/libedataserver/libedataserver-sections.txt b/docs/reference/libedataserver/libedataserver-sections.txt
index ef394570e..1bd5adaaa 100644
--- a/docs/reference/libedataserver/libedataserver-sections.txt
+++ b/docs/reference/libedataserver/libedataserver-sections.txt
@@ -540,8 +540,15 @@ e_util_utf8_make_valid
 e_util_ensure_gdbus_string
 e_util_gthread_id
 e_filename_make_safe
+e_filename_mkdir_encoded
 e_utf8_strftime
 e_strftime
+e_util_slist_to_strv
+e_util_strv_to_slist
+e_util_copy_string_slist
+e_util_copy_object_slist
+e_util_free_string_slist
+e_util_free_object_slist
 e_util_get_prefix
 e_util_get_cp_prefix
 e_util_get_localedir
diff --git a/docs/reference/libedataserver/tmpl/e-util.sgml b/docs/reference/libedataserver/tmpl/e-util.sgml
index 43721f7ac..8ec97075c 100644
--- a/docs/reference/libedataserver/tmpl/e-util.sgml
+++ b/docs/reference/libedataserver/tmpl/e-util.sgml
@@ -148,6 +148,18 @@ Miscellaneous utility functions for evolution-data-server.
 @string: 
 
 
+<!-- ##### FUNCTION e_filename_mkdir_encoded ##### -->
+<para>
+
+</para>
+
+@basepath: 
+@fileprefix: 
+@filename: 
+@fileindex: 
+@Returns: 
+
+
 <!-- ##### FUNCTION e_utf8_strftime ##### -->
 <para>
 
@@ -172,6 +184,60 @@ Miscellaneous utility functions for evolution-data-server.
 @Returns: 
 
 
+<!-- ##### FUNCTION e_util_slist_to_strv ##### -->
+<para>
+
+</para>
+
+@strings: 
+@Returns: 
+
+
+<!-- ##### FUNCTION e_util_strv_to_slist ##### -->
+<para>
+
+</para>
+
+@strv: 
+@Returns: 
+
+
+<!-- ##### FUNCTION e_util_copy_string_slist ##### -->
+<para>
+
+</para>
+
+@copy_to: 
+@strings: 
+@Returns: 
+
+
+<!-- ##### FUNCTION e_util_copy_object_slist ##### -->
+<para>
+
+</para>
+
+@copy_to: 
+@objects: 
+@Returns: 
+
+
+<!-- ##### FUNCTION e_util_free_string_slist ##### -->
+<para>
+
+</para>
+
+@strings: 
+
+
+<!-- ##### FUNCTION e_util_free_object_slist ##### -->
+<para>
+
+</para>
+
+@objects: 
+
+
 <!-- ##### FUNCTION e_util_get_prefix ##### -->
 <para>
 
diff --git a/libedataserver/e-data-server-util.c b/libedataserver/e-data-server-util.c
index 94d2177da..5228d0948 100644
--- a/libedataserver/e-data-server-util.c
+++ b/libedataserver/e-data-server-util.c
@@ -758,7 +758,10 @@ e_filename_make_safe (gchar *string)
  * Since: 3.4
  **/
 gchar *
-e_filename_mkdir_encoded (const gchar *basepath, const gchar *fileprefix, const gchar *filename, gint fileindex)
+e_filename_mkdir_encoded (const gchar *basepath,
+                          const gchar *fileprefix,
+                          const gchar *filename,
+                          gint fileindex)
 {
 	gchar *elem1, *elem2, *res, *fn;
 
@@ -925,11 +928,7 @@ e_util_copy_object_slist (GSList *copy_to,
 void
 e_util_free_string_slist (GSList *strings)
 {
-	if (!strings)
-		return;
-
-	g_slist_foreach (strings, (GFunc) g_free, NULL);
-	g_slist_free (strings);
+	g_slist_free_full (strings, (GDestroyNotify) g_free);
 }
 
 /**
@@ -944,11 +943,7 @@ e_util_free_string_slist (GSList *strings)
 void
 e_util_free_object_slist (GSList *objects)
 {
-	if (!objects)
-		return;
-
-	g_slist_foreach (objects, (GFunc) g_object_unref, NULL);
-	g_slist_free (objects);
+	g_slist_free_full (objects, (GDestroyNotify) g_object_unref);
 }
 
 #ifdef G_OS_WIN32
diff --git a/libedataserver/e-proxy.c b/libedataserver/e-proxy.c
index c52b16834..499114b80 100644
--- a/libedataserver/e-proxy.c
+++ b/libedataserver/e-proxy.c
@@ -150,7 +150,9 @@ ep_free_proxy_host_addr (ProxyHostAddr *host)
 }
 
 static gboolean
-ep_read_key_boolean (EProxy *proxy, EProxyKey key, GConfClient *client)
+ep_read_key_boolean (EProxy *proxy,
+                     EProxyKey key,
+                     GConfClient *client)
 {
 	gboolean res = FALSE;
 
@@ -181,7 +183,9 @@ ep_read_key_boolean (EProxy *proxy, EProxyKey key, GConfClient *client)
 }
 
 static gint
-ep_read_key_int (EProxy *proxy, EProxyKey key, GConfClient *client)
+ep_read_key_int (EProxy *proxy,
+                 EProxyKey key,
+                 GConfClient *client)
 {
 	gint res = 0;
 
@@ -218,7 +222,9 @@ ep_read_key_int (EProxy *proxy, EProxyKey key, GConfClient *client)
 
 /* free returned pointer with g_free() */
 static gchar *
-ep_read_key_string (EProxy *proxy, EProxyKey key, GConfClient *client)
+ep_read_key_string (EProxy *proxy,
+                    EProxyKey key,
+                    GConfClient *client)
 {
 	gchar *res = NULL;
 
@@ -279,7 +285,9 @@ ep_read_key_string (EProxy *proxy, EProxyKey key, GConfClient *client)
 
 /* list of newly allocated strings, use g_free() for each member and free list itself too */
 static GSList *
-ep_read_key_list (EProxy *proxy, EProxyKey key, GConfClient *client)
+ep_read_key_list (EProxy *proxy,
+                  EProxyKey key,
+                  GConfClient *client)
 {
 	GSList *res = NULL;
 
@@ -866,7 +874,9 @@ ep_setting_changed (GConfClient *client,
 }
 
 static void
-ep_sys_proxy_changed_cb (GSettings *settings, const gchar *key, EProxy *proxy)
+ep_sys_proxy_changed_cb (GSettings *settings,
+                         const gchar *key,
+                         EProxy *proxy)
 {
 	g_return_if_fail (proxy != NULL);
 
@@ -877,7 +887,9 @@ ep_sys_proxy_changed_cb (GSettings *settings, const gchar *key, EProxy *proxy)
 }
 
 static void
-ep_sys_proxy_http_changed_cb (GSettings *settings, const gchar *key, EProxy *proxy)
+ep_sys_proxy_http_changed_cb (GSettings *settings,
+                              const gchar *key,
+                              EProxy *proxy)
 {
 	g_return_if_fail (proxy != NULL);
 
@@ -888,7 +900,9 @@ ep_sys_proxy_http_changed_cb (GSettings *settings, const gchar *key, EProxy *pro
 }
 
 static void
-ep_sys_proxy_https_changed_cb (GSettings *settings, const gchar *key, EProxy *proxy)
+ep_sys_proxy_https_changed_cb (GSettings *settings,
+                               const gchar *key,
+                               EProxy *proxy)
 {
 	g_return_if_fail (proxy != NULL);
 
@@ -899,7 +913,9 @@ ep_sys_proxy_https_changed_cb (GSettings *settings, const gchar *key, EProxy *pr
 }
 
 static void
-ep_sys_proxy_socks_changed_cb (GSettings *settings, const gchar *key, EProxy *proxy)
+ep_sys_proxy_socks_changed_cb (GSettings *settings,
+                               const gchar *key,
+                               EProxy *proxy)
 {
 	g_return_if_fail (proxy != NULL);