Transfer type wording is ambiguous
The tooltips next to function names, and the corresponding glossary items have confusing explanations in some cases. From https://developer.gnome.org/glib/stable/annotation-glossary.html
transfer container
Free data container after the code is done.
transfer full
Free data after the code is done.
transfer none
Don't free data after the code is done.
They can be read as orders, or as descriptions:
- please user, free data,
- please user, don't free data
or:
- I will free data
- ??? don't free data.
In reality, the second option seems to be right, despite weird wording.
The definitions seem to be better, if less concise, here: https://gi.readthedocs.io/en/latest/annotations/giannotations.html#memory-and-lifecycle-management
Could the tooltips be improved?