Apply 3 suggestion(s) to 1 file(s)

1 files changed, 3 insertions, 3 deletions

diff --git a/gtkdoc/mkdb.py b/gtkdoc/mkdb.py
index 1e3bfec..7c8b5fa 100644
--- a/gtkdoc/mkdb.py
+++ b/gtkdoc/mkdb.py
@@ -150,10 +150,10 @@ AnnotationDefinition = {
     'scope notified': "The callback is valid until the GDestroyNotify argument is called.",
     'set-value-func': "The specified function is used to convert from a struct to a GValue, must be a GTypeInstance.",
     'skip': "Exposed in C code, not necessarily available in other languages.",
-    'transfer container': "The receiver becomes responsible for freeing the data container but not contained items.",
+    'transfer container': "The caller owns the data container, but not the data inside it.",
     'transfer floating': "Alias for <acronym>transfer none</acronym>, used for objects with floating refs.",
-    'transfer full': "The receiver becomes responsible for freeing the data.",
-    'transfer none': "The source remains responsible for freeing the data.",
+    'transfer full': "The caller owns the data, and is responsible for free it.",
+    'transfer none': "The data is owned by the callee, which is responsible of freeing it.",
     'type': "Override the parsed C type with given type.",
     'unref-func': "The specified function is used to unref a struct, must be a GTypeInstance.",
     'virtual': "This is the invoker for a virtual method.",