[gobject-introspection] gibaseinfo: Expand g_base_info_iterate_attributes() documentation

[Philip Withnall <pwithnall src gnome org>]

commit 3aeb5f0a98b2913b9e96e09028ad4942d8dac715
Author: Philip Withnall <philip withnall collabora co uk>
Date:   Mon Jun 23 09:35:02 2014 +0100

    gibaseinfo: Expand g_base_info_iterate_attributes() documentation
    
    Clarify what an attribute is, in response to a question on
    gir-devel-list.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=732078

 girepository/gibaseinfo.c |    5 ++++-
 1 files changed, 4 insertions(+), 1 deletions(-)
---
diff --git a/girepository/gibaseinfo.c b/girepository/gibaseinfo.c
index 4bbe850..25c98b0 100644
--- a/girepository/gibaseinfo.c
+++ b/girepository/gibaseinfo.c
@@ -562,7 +562,10 @@ _attribute_blob_find_first (GIBaseInfo *info,
  *
  * Iterate over all attributes associated with this node.  The iterator
  * structure is typically stack allocated, and must have its first
- * member initialized to %NULL.
+ * member initialized to %NULL.  Attributes are arbitrary namespaced key–value
+ * pairs which can be attached to almost any item.  They are intended for use
+ * by software higher in the toolchain than bindings, and are distinct from
+ * normal GIR annotations.
  *
  * Both the @name and @value should be treated as constants
  * and must not be freed.