From 60bbb9c24f5b09ae4f6546b16ec64cd3484b2255 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Tim-Philipp=20M=C3=BCller?= <tim.muller@collabora.co.uk>
Date: Tue, 19 Apr 2011 13:23:19 +0100
Subject: [PATCH] docs: add note/warning to gst_index_get_writer_id() docs
 about the OBJECT_LOCK

https://bugzilla.gnome.org/show_bug.cgi?id=646811
---
 gst/gstindex.c | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/gst/gstindex.c b/gst/gstindex.c
index f606fbf..27d4b8b 100644
--- a/gst/gstindex.c
+++ b/gst/gstindex.c
@@ -695,6 +695,12 @@ gst_index_gtype_resolver (GstIndex * index, GstObject * writer,
  * to a string. That string will be used to register or look up an id
  * in the index.
  *
+ * <note>
+ * The caller must not hold @writer's #GST_OBJECT_LOCK, as the default
+ * resolver may call functions that take the object lock as well, and
+ * the lock is not recursive.
+ * </note>
+ *
  * Returns: TRUE if the writer would be mapped to an id.
  */
 gboolean
-- 
2.7.4