diff --git a/glib/gmain.c b/glib/gmain.c
index 7442d3d05..d34648f51 100644
--- a/glib/gmain.c
+++ b/glib/gmain.c
@@ -3525,7 +3525,7 @@ g_main_dispatch (GMainContext *context)
  *
  * You must be the owner of a context before you
  * can call g_main_context_prepare(), g_main_context_query(),
- * g_main_context_check(), g_main_context_dispatch().
+ * g_main_context_check(), g_main_context_dispatch(), g_main_context_release().
  *
  * Since 2.76 @context can be %NULL to use the global-default
  * main context.
@@ -3583,6 +3583,9 @@ g_main_context_acquire_unlocked (GMainContext *context)
  * with g_main_context_acquire(). If the context was acquired multiple
  * times, the ownership will be released only when g_main_context_release()
  * is called as many times as it was acquired.
+ *
+ * You must have successfully acquired the context with
+ * g_main_context_acquire() before you may call this function.
  **/
 void
 g_main_context_release (GMainContext *context)