element: Document when a clock is available from gst_element_get_clock()

https://bugzilla.gnome.org/show_bug.cgi?id=744442

diff --git a/gst/gstelement.c b/gst/gstelement.c
index e4eba82..c681194 100644 (file)
--- 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.