document a little pitfall

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index b24ee0ec175cd0e17b5b8779b16435c964a58bc3..bfb7f7e2693ed8a4f8e7603a38365d18b5cbffd9 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2006-05-02  Matthias Clasen  <mclasen@redhat.com>
+
+       * gobject/tmpl/gtypemodule.sgml: Document a little
+       pitfall with the last unref for an object.
+
 2006-04-27  Matthias Clasen  <mclasen@redhat.com>
 
        * glib/tmpl/unicode.sgml: Mention that GLib 2.12 will

diff --git a/docs/reference/gobject/tmpl/gtypemodule.sgml b/docs/reference/gobject/tmpl/gtypemodule.sgml
index a240de14fa32f18a35abb91bfb073b142371096c..bd86f2dc38b5d4c5c94e86e443b227876b98fdc4 100644 (file)
--- a/docs/reference/gobject/tmpl/gtypemodule.sgml
+++ b/docs/reference/gobject/tmpl/gtypemodule.sgml
@@ -15,7 +15,9 @@ g_type_module_add_interface().  As long as any instances of these
 types and interface implementations are in use, the module is kept
 loaded. When the types and interfaces are gone, the module may be
 unloaded. If the types and interfaces become used again, the module
-will be reloaded.
+will be reloaded. Note that the last unref can not happen in module
+code, since that would lead to the caller's code being unloaded before
+g_object_unref() returns to it.
 </para>
 <para>
 Keeping track of whether the module should be loaded or not is done by