From b66a4dbd42e238f5245a327f040723aadc40251f Mon Sep 17 00:00:00 2001
From: Stefan Kost <ensonic@users.sf.net>
Date: Wed, 28 Oct 2009 09:58:52 +0200
Subject: [PATCH] docs: tell more about what happens in gst_init.

Add links to gst_update_registry and the env-vars.
---
 gst/gst.c | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/gst/gst.c b/gst/gst.c
index a2eb80e47a..8ab3918628 100644
--- a/gst/gst.c
+++ b/gst/gst.c
@@ -456,6 +456,13 @@ gst_init_check (int *argc, char **argv[], GError ** err)
  * Initializes the GStreamer library, setting up internal path lists,
  * registering built-in elements, and loading standard plugins.
  *
+ * Unless the plugin registry is disabled at compile time, the registry will be
+ * loaded. By default this will also check if the registry cache needs to be
+ * updated and rescan all plugins if needed. See gst_update_registry() for
+ * details and section
+ * <link linkend="gst-running">Running GStreamer Applications</link>
+ * for how to disable automatic registry updates.
+ *
  * This function should be called before calling any other GLib functions. If
  * this is not an option, your program must initialise the GLib thread system
  * using g_thread_init() before any other GLib functions are called.