gst-libs/gst/pbutils/: Small docs fix and addition.

Original commit message from CVS:
* gst-libs/gst/pbutils/install-plugins.c:
* gst-libs/gst/pbutils/missing-plugins.c:
Small docs fix and addition.

diff --git a/ChangeLog b/ChangeLog
index 2bbb204..90d6d82 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2007-08-15  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * gst-libs/gst/pbutils/install-plugins.c:
+       * gst-libs/gst/pbutils/missing-plugins.c:
+         Small docs fix and addition.
+
 2007-08-13  Tim-Philipp Müller  <tim at centricular dot net>
 
        * tests/icles/.cvsignore:

diff --git a/gst-libs/gst/pbutils/install-plugins.c b/gst-libs/gst/pbutils/install-plugins.c
index 7958806..a5bd65a 100644 (file)
--- a/gst-libs/gst/pbutils/install-plugins.c
+++ b/gst-libs/gst/pbutils/install-plugins.c
@@ -584,6 +584,10 @@ gst_install_plugins_installer_exited (GPid pid, gint status, gpointer data)
  * messages that have been caught on a pipeline's bus or created by the
  * application via the provided API, such as gst_missing_element_message_new().
  *
+ * It is possible to request the installation of multiple missing plugins in
+ * one go (as might be required if there is a demuxer for a certain format
+ * installed but no suitable video decoder and no suitable audio decoder).
+ *
  * Returns: result code whether an external installer could be started
  *
  * Since: 0.10.12

diff --git a/gst-libs/gst/pbutils/missing-plugins.c b/gst-libs/gst/pbutils/missing-plugins.c
index 3d6d905..69f939d 100644 (file)
--- a/gst-libs/gst/pbutils/missing-plugins.c
+++ b/gst-libs/gst/pbutils/missing-plugins.c
@@ -383,11 +383,11 @@ missing_structure_get_caps_detail (const GstStructure * s, GstCaps ** p_caps)
  * @msg: a missing-plugin #GstMessage of type #GST_MESSAGE_ELEMENT
  *
  * Returns an opaque string containing all the details about the missing
- * element to be passed to an external installer or installer library
- * such as libgimme-codec.
+ * element to be passed to an external installer called via
+ * gst_install_plugins_async() or gst_install_plugins_sync().
  * 
- * This function is mainly for applications that use libgimme-codec or
- * other libraries that call external plugin installation mechanisms.
+ * This function is mainly for applications that call external plugin
+ * installation mechanisms using one of the two above-mentioned functions.
  *
  * Returns: a newly-allocated detail string, or NULL on error. Free string
  *          with g_free() when not needed any longer.