gst/: Small docs and debug updates.

Original commit message from CVS:
* gst/gstbin.c: (is_eos), (update_degree), (gst_bin_query):
* gst/gstelement.c: (gst_element_post_message):
* gst/gstpipeline.c: (gst_pipeline_change_state):
Small docs and debug updates.

ChangeLog

@@ -1,3 +1,10 @@
+2005-10-08  Wim Taymans  <wim@fluendo.com>
+
+	* gst/gstbin.c: (is_eos), (update_degree), (gst_bin_query):
+	* gst/gstelement.c: (gst_element_post_message):
+	* gst/gstpipeline.c: (gst_pipeline_change_state):
+	Small docs and debug updates.
+
 2005-10-08  Stefan Kost  <ensonic@users.sf.net>
 
 	* docs/gst/gstreamer-sections.txt:

gst/gstbin.c

@@ -1588,7 +1588,7 @@ gst_bin_query (GstElement * element, GstQuery * query)
   gboolean res = FALSE, done = FALSE;
 
   iter = gst_bin_iterate_sinks (bin);
-  GST_DEBUG_OBJECT (bin, "Sending event to sink children");
+  GST_DEBUG_OBJECT (bin, "Sending query to sink children");
 
   while (!(res || done)) {
     gpointer data;

gst/gstelement.c

@@ -67,8 +67,9 @@
  * Not all elements require a clock to operate correctly. If 
  * gst_element_requires_clock() returns TRUE, a clock should be set on the element
  * with gst_element_set_clock(). 
+ *
  * Note that clock slection and distribution is normally handled by the toplevel 
- * GstPipeline so the clock functions are only to be used in very specific situations.
+ * #GstPipeline so the clock functions are only to be used in very specific situations.
  */
 #include "gst_private.h"
 #include <glib.h>

gst/gstpipeline.c

@@ -21,13 +21,19 @@
  */
 /**
  * SECTION:gstpipeline
- * @short_description: Top-level bin with scheduling and pipeline management functionality.
+ * @short_description: Top-level bin with clocking and bus management functionality.
  * @see_also: #GstBin
  *
  * In almost all cases, you'll want to use a GstPipeline when creating a filter
- * graph.  The GstPipeline will manage all the scheduling issues, including
- * threading, as well as provide simple interfaces to common functions, like
- * 'Play'.
+ * graph.  The GstPipeline will manage the selection and distribution of a global
+ * clock as well as provide a GstBus to the application.
+ *
+ * The pipeline will also use the selected clock to calculate the stream time of
+ * the pipeline.
+ *
+ * When sending a seek event to a GstPipeline, it will make sure that the
+ * pipeline is properly PAUSED and resumed as well as update the new stream time
+ * after the seek.
  *
  * gst_pipeline_new() is used to create a pipeline. when you are done with 
  * the pipeline, use gst_object_unref() to free its resources including all