From 518babf6cb6f71b2704a4b420804322cfa1dda54 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Olivier=20Cr=C3=AAte?= <olivier.crete@collabora.com>
Date: Thu, 12 Feb 2015 19:39:44 -0500
Subject: [PATCH] element: Document when a clock is available from
 gst_element_get_clock()

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

diff --git a/gst/gstelement.c b/gst/gstelement.c
index e4eba826ab..c681194d5b 100644
--- a/gst/gstelement.c
+++ b/gst/gstelement.c
@@ -417,6 +417,9 @@ gst_element_set_clock (GstElement * element, GstClock * clock)
  * Gets the currently configured clock of the element. This is the clock as was
  * last set with gst_element_set_clock().
  *
+ * Elements in a pipeline will only have their clock set when the
+ * pipeline is in the PLAYING state.
+ *
  * Returns: (transfer full): the #GstClock of the element. unref after usage.
  *
  * MT safe.