[gobject-introspection] gibaseinfo: Expand g_base_info_iterate_attributes() documentation
- From: Philip Withnall <pwithnall src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gobject-introspection] gibaseinfo: Expand g_base_info_iterate_attributes() documentation
- Date: Mon, 23 Jun 2014 10:58:03 +0000 (UTC)
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.
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]