diff --git a/glib/gbitlock.c b/glib/gbitlock.c
index 33cbb2a8a..c62ec3055 100644
--- a/glib/gbitlock.c
+++ b/glib/gbitlock.c
@@ -233,6 +233,7 @@ g_bit_lock (volatile gint *address,
  * g_bit_trylock:
  * @address: a pointer to an integer
  * @lock_bit: a bit value between 0 and 31
+ * @returns: %TRUE if the lock was acquired
  *
  * Sets the indicated @lock_bit in @address, returning %TRUE if
  * successful.  If the bit is already set, returns %FALSE immediately.
diff --git a/glib/gbitlock.h b/glib/gbitlock.h
index 15ee0e2a9..5f6a67fd8 100644
--- a/glib/gbitlock.h
+++ b/glib/gbitlock.h
@@ -31,11 +31,11 @@
 
 G_BEGIN_DECLS
 
-void      g_bit_lock                      (volatile gint *lock,
+void      g_bit_lock                      (volatile gint *address,
                                            gint           lock_bit);
-gboolean  g_bit_trylock                   (volatile gint *lock,
+gboolean  g_bit_trylock                   (volatile gint *address,
                                            gint           lock_bit);
-void      g_bit_unlock                    (volatile gint *lock,
+void      g_bit_unlock                    (volatile gint *address,
                                            gint           lock_bit);
 
 G_END_DECLS