From 0afe67c9e03ea39327342d1b9c60f15132b0b8f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim-Philipp=20M=C3=BCller?= <tim@centricular.net>
Date: Wed, 15 Aug 2007 17:05:45 +0000
Subject: [PATCH] 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.
---
 ChangeLog                              | 6 ++++++
 gst-libs/gst/pbutils/install-plugins.c | 4 ++++
 gst-libs/gst/pbutils/missing-plugins.c | 8 ++++----
 3 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 2bbb204237..90d6d82a9c 100644
--- 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 795880627c..a5bd65a0d8 100644
--- 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 3d6d9055fc..69f939d5b8 100644
--- 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.