Small docs fixes.

Original commit message from CVS:
* docs/design/part-live-source.txt:
* gst/gstclock.h:
Small docs fixes.

diff --git a/ChangeLog b/ChangeLog
index 2cf6bcb..34dfd08 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2006-10-18  Wim Taymans  <wim@fluendo.com>
+
+       * docs/design/part-live-source.txt:
+       * gst/gstclock.h:
+       Small docs fixes.
+
 2006-10-18  Tim-Philipp Müller  <tim at centricular dot net>
 
        * gst/gstbuffer.h:

diff --git a/docs/design/part-live-source.txt b/docs/design/part-live-source.txt
index 93508d8..ae198e3 100644 (file)
--- a/docs/design/part-live-source.txt
+++ b/docs/design/part-live-source.txt
@@ -41,7 +41,17 @@ buffer arrives at the sink, it will already be late and will be dropped.
 The latency is the time it takes to construct one buffer of data. This latency
 could be exposed by latency queries.
 
-Theses latency queries need to be done by the managing pipeline for all sinks.
-They can only be done after the meassurements have been taken (all are
-prerolled). Thus in pipeline:state_changed:PAUSED_TO_PLAYING we need
-get the max-latency and set this as a sync-offset in all sinks.
+Theses latency queries could to be done by the managing pipeline for all sinks.
+In that case they can only be done after the meassurements have been taken (all
+are prerolled). Thus in pipeline:state_changed:PAUSED_TO_PLAYING we need
+get the max-latency and set this as a sync-offset in all sinks. The problem is
+that in a live pipeline, we set the pipeline to PLAYING before waiting for the
+sinks to preroll.
+
+Another possibility would be to configure a fixed latency in a pipeline that
+would automatically be configured on any sink in the case of a NO_PREROLL
+element. For decoupled elements this is practically the only viable way to
+introduce enough latency that does not starve the sinks.
+
+The current latency can also be measured in the sinks and the pipeline could
+optimize it to the lowest possible latency.

diff --git a/gst/gstclock.h b/gst/gstclock.h
index c88c89e..d44a47e 100644 (file)
--- a/gst/gstclock.h
+++ b/gst/gstclock.h
@@ -204,7 +204,7 @@ typedef struct _GstClockClass       GstClockClass;
  * @clock: The clock that triggered the callback
  * @time: The time it was triggered
  * @id: The #GstClockID that expired
- * @user_data: user data passed in the async_wait call
+ * @user_data: user data passed in the gst_clock_id_wait_async() function
  *
  * The function prototype of the callback.
  *