Doc improvements

svn path=/trunk/; revision=5988

diff --git a/ChangeLog b/ChangeLog
index 6167276..b19b12d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,7 +1,8 @@
 2007-11-28  Matthias Clasen  <mclasen@redhat.com>
 
-       * glib/gmarkup.c:
-       * glib/gerror.c: Add Since: tags to new API
+       * glib/gmarkup.h:
+       * glib/gmarkup.c: 
+       * glib/gerror.c: Add Since: tags to new API, other doc improvements.
 
 2007-11-28  Matthias Clasen  <mclasen@redhat.com>
 

diff --git a/glib/gmarkup.c b/glib/gmarkup.c
index 5be2cf6..381bea2 100644 (file)
--- a/glib/gmarkup.c
+++ b/glib/gmarkup.c
@@ -2447,12 +2447,13 @@ g_markup_parse_boolean (const char  *string,
  * particular attribute is to be allowed but
  * ignored.
  *
- * This function deals with issuing errors for
- * missing attributes, unknown attributes and
- * duplicate attributes as well as parse errors
- * for boolean-valued attributes.  In all of these
- * cases %FALSE will be returned and @error will
- * be set as appropriate.
+ * This function deals with issuing errors for missing attributes 
+ * (of type %G_MARKUP_ERROR_MISSING_ATTRIBUTE), unknown attributes 
+ * (of type %G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE) and duplicate 
+ * attributes (of type %G_MARKUP_ERROR_INVALID_CONTENT) as well 
+ * as parse errors for boolean-valued attributes (again of type
+ * %G_MARKUP_ERROR_INVALID_CONTENT). In all of these cases %FALSE 
+ * will be returned and @error will be set as appropriate.
  *
  * Return value: %TRUE if successful
  *

diff --git a/glib/gmarkup.h b/glib/gmarkup.h
index 63edba7..340a218 100644 (file)
--- a/glib/gmarkup.h
+++ b/glib/gmarkup.h
@@ -33,7 +33,7 @@ typedef enum
   G_MARKUP_ERROR_BAD_UTF8,
   G_MARKUP_ERROR_EMPTY,
   G_MARKUP_ERROR_PARSE,
-  /* These three are primarily intended for specific GMarkupParser
+  /* The following are primarily intended for specific GMarkupParser
    * implementations to set.
    */
   G_MARKUP_ERROR_UNKNOWN_ELEMENT,