Merge branch '590-rwlock-docs' into 'master'

gthread: Fix g_rw_lock_reader_lock() documentation

Closes #590

See merge request GNOME/glib!882

1 files changed, 4 insertions, 2 deletions

diff --git a/glib/gthread-posix.c b/glib/gthread-posix.c
index 1e2fdb59a..8b8561639 100644
--- a/glib/gthread-posix.c
+++ b/glib/gthread-posix.c
@@ -587,8 +587,10 @@ g_rw_lock_writer_unlock (GRWLock *rw_lock)
  * @rw_lock: a #GRWLock
  *
  * Obtain a read lock on @rw_lock. If another thread currently holds
- * the write lock on @rw_lock or blocks waiting for it, the current
- * thread will block. Read locks can be taken recursively.
+ * the write lock on @rw_lock, the current thread will block. If another thread
+ * does not hold the write lock, but is waiting for it, it is implementation
+ * defined whether the reader or writer will block. Read locks can be taken
+ * recursively.
  *
  * It is implementation-defined how many threads are allowed to
  * hold read locks on the same lock simultaneously. If the limit is hit,