stats major rework, with addition of function support

[lttv.git] / ltt / branches / poly / lttv / lttv / iattribute.h

diff --git a/ltt/branches/poly/lttv/lttv/iattribute.h b/ltt/branches/poly/lttv/lttv/iattribute.h
index 95d1fcf1e386c6f03ad309613f5873f62587ba1a..0783077f646473fd3d33f584575ad6b3a8348a46 100644 (file)
--- a/ltt/branches/poly/lttv/lttv/iattribute.h
+++ b/ltt/branches/poly/lttv/lttv/iattribute.h
@@ -16,6 +16,8 @@
  * MA 02111-1307, USA.
  */
 
+/* FIXME : unnamed attributes not implemented */
+
 #ifndef IATTRIBUTE_H
 #define IATTRIBUTE_H
 
@@ -28,6 +30,13 @@
    and access functions over a wide range of structures. The names are 
    represented by unique integer identifiers, GQuarks. */
 
+/* Please note that adding a value of type gobject that is non null does not
+ * increment the reference count of this object : the actual reference to
+ * the object is "given" to the attribute tree. When the gobject value
+ * is removed, the object is unreferenced. A value copy through
+ * lttv_iattribute_copy_value does increase the reference count of the 
+ * gobject. */
+
 typedef GQuark LttvAttributeName;
 
 typedef enum _LttvAttributeType {
@@ -125,7 +134,6 @@ LttvAttributeType lttv_iattribute_get_by_name(LttvIAttribute *self,
 LttvAttributeValue lttv_iattribute_add(LttvIAttribute *self, 
     LttvAttributeName name, LttvAttributeType t);
 
-
 /* Remove an attribute */
 
 void lttv_iattribute_remove(LttvIAttribute *self, unsigned i);