Fix docs

diff --git a/docs/reference/gobject/tmpl/objects.sgml b/docs/reference/gobject/tmpl/objects.sgml
index 522896e..c7c6133 100644 (file)
--- a/docs/reference/gobject/tmpl/objects.sgml
+++ b/docs/reference/gobject/tmpl/objects.sgml
@@ -464,6 +464,13 @@ Increase the reference count of @object, and possibly remove the
 <link linkend="floating-ref">floating</link> reference, if @object
 has a floating reference.
 </para>
+<para>
+In other words, if the object is floating, then this call "assumes 
+ownership" of the floating reference, converting it to a normal reference 
+by clearing the floating flag while leaving the reference count unchanged. 
+If the object is not floating, then this call adds a new normal reference 
+increasing the reference count by one.
+</para>
 
 @object: a #GObject
 @Returns: @object