[evolution-data-server] Update libedataserver API docs.

[Matthew Barnes <mbarnes src gnome org>]

commit c59714262357f5855c8bd7276c3eac57250867c4
Author: Matthew Barnes <mbarnes redhat com>
Date:   Sun Oct 16 17:13:10 2011 -0400

    Update libedataserver API docs.

 .../libedataserver/libedataserver-sections.txt     |    7 ++
 docs/reference/libedataserver/tmpl/e-util.sgml     |   66 ++++++++++++++++++++
 libedataserver/e-data-server-util.c                |   17 ++---
 libedataserver/e-proxy.c                           |   32 +++++++---
 4 files changed, 103 insertions(+), 19 deletions(-)
---
diff --git a/docs/reference/libedataserver/libedataserver-sections.txt b/docs/reference/libedataserver/libedataserver-sections.txt
index ef39457..1bd5ada 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 43721f7..8ec9707 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 94d2177..5228d09 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 c52b168..499114b 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);