From a695e2f06c579fb719353ed53354ce4e0a4c1844 Mon Sep 17 00:00:00 2001
From: Iain Holmes <iain@openedhand.com>
Date: Thu, 22 Jun 2006 09:25:01 +0000
Subject: [PATCH] More docustuff

---
 ChangeLog              |  4 ++++
 clutter/clutter-util.c | 20 ++++++++++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index cd9b9a853..bebb6cabc 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2006-06-22  Iain Holmes  <iain@openedhand.com>
+
+	* clutter/clutter-util.c: And more
+
 2006-06-22  Ross Burton  <ross@openedhand.com>
 
 	* clutter/clutter-label.c:
diff --git a/clutter/clutter-util.c b/clutter/clutter-util.c
index b48a042ce..1d66385b4 100644
--- a/clutter/clutter-util.c
+++ b/clutter/clutter-util.c
@@ -45,6 +45,11 @@ error_handler(Display     *xdpy,
   return 0;
 }
 
+/**
+ * clutter_util_trap_x_errors:
+ *
+ * Trap X errors so they don't cause an abort.
+ */
 void
 clutter_util_trap_x_errors(void)
 {
@@ -52,6 +57,13 @@ clutter_util_trap_x_errors(void)
   old_error_handler = XSetErrorHandler(error_handler);
 }
 
+/**
+ * clutter_util_untrap_x_errors:
+ *
+ * Stop trapping X errors.
+ *
+ * Return value: 0 if there was no error, or the last X error that occurred.
+ */
 int
 clutter_util_untrap_x_errors(void)
 {
@@ -59,6 +71,14 @@ clutter_util_untrap_x_errors(void)
   return TrappedErrorCode;
 }
 
+/**
+ * clutter_util_next_p2:
+ * @a: Value to get the next power
+ *
+ * Calculates the next power greater than @a.
+ *
+ * Return value: The next power after @a.
+ */
 int 
 clutter_util_next_p2 (int a)
 {