diff --git a/glib/glist.c b/glib/glist.c
index 2f3a49bfb..1639a9f92 100644
--- a/glib/glist.c
+++ b/glib/glist.c
@@ -186,7 +186,10 @@ g_list_free (GList *list)
  * g_list_free_1:
  * @list: a #GList element
  *
- * Frees one #GList element.
+ * Frees one #GList element, but does not update links from the next and
+ * previous elements in the list, so you should not call this function on an
+ * element that is currently part of a list.
+ *
  * It is usually used after g_list_remove_link().
  */
 /**