From 435f0a2eee16974807a72391c74911433a1bf3fb Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Mon, 29 Dec 2008 05:58:19 +0000
Subject: [PATCH] Document GtkBuilderError

svn path=/trunk/; revision=21985
---
 docs/reference/ChangeLog                |  1 +
 docs/reference/gtk/tmpl/gtkbuilder.sgml | 27 ++++++++++++++++---------
 2 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index f46a6fbba1..002b6b9c8e 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,6 +1,7 @@
 2008-12-28  Matthias Clasen <mclasen@redhat.com>
 
 	* gtk/tmpl/gtkenums.sgml: Document GtkArrowPlacement
+	* gtk/tmpl/gtkbuilder.sgml: Document GtkBuilderError
 
 2008-12-28  Matthias Clasen <mclasen@redhat.com>
 
diff --git a/docs/reference/gtk/tmpl/gtkbuilder.sgml b/docs/reference/gtk/tmpl/gtkbuilder.sgml
index 57e18735d5..305565ea73 100644
--- a/docs/reference/gtk/tmpl/gtkbuilder.sgml
+++ b/docs/reference/gtk/tmpl/gtkbuilder.sgml
@@ -265,17 +265,26 @@ respective objects, see
 
 <!-- ##### ENUM GtkBuilderError ##### -->
 <para>
-
+Error codes that identify various error that can occur while
+using #GtkBuilder.
 </para>
 
-@GTK_BUILDER_ERROR_INVALID_TYPE_FUNCTION: 
-@GTK_BUILDER_ERROR_UNHANDLED_TAG: 
-@GTK_BUILDER_ERROR_MISSING_ATTRIBUTE: 
-@GTK_BUILDER_ERROR_INVALID_ATTRIBUTE: 
-@GTK_BUILDER_ERROR_INVALID_TAG: 
+@GTK_BUILDER_ERROR_INVALID_TYPE_FUNCTION: A type-func attribute didn't name
+    a function that returns a #GType.
+@GTK_BUILDER_ERROR_UNHANDLED_TAG: The input contained a tag that #GtkBuilder
+    can't handle. 
+@GTK_BUILDER_ERROR_MISSING_ATTRIBUTE: An attribute that is required by
+    #GtkBuilder was missing.
+@GTK_BUILDER_ERROR_INVALID_ATTRIBUTE: #GtkBuilder found an attribute that 
+    it doesn't understand.
+@GTK_BUILDER_ERROR_INVALID_TAG: #GtkBuilder found a tag that
+    it doesn't understand.
 @GTK_BUILDER_ERROR_MISSING_PROPERTY_VALUE: 
-@GTK_BUILDER_ERROR_INVALID_VALUE: 
-@GTK_BUILDER_ERROR_VERSION_MISMATCH: 
+@GTK_BUILDER_ERROR_INVALID_VALUE: #GtkBuilder couldn't parse
+    some attribute value.
+@GTK_BUILDER_ERROR_VERSION_MISMATCH: The input file requires a newer version
+    of GTK+.
+
 
 <!-- ##### FUNCTION gtk_builder_new ##### -->
 <para>
@@ -436,7 +445,7 @@ respective objects, see
 
 <!-- ##### MACRO GTK_BUILDER_ERROR ##### -->
 <para>
-
+The #GError quark for #GtkBuilder errors
 </para>