docs: FAQ update to mention create-uninstalled-setup.sh
authorFabian Kirsch <derFakir@web.de>
Wed, 16 Oct 2013 13:00:41 +0000 (15:00 +0200)
committerTim-Philipp Müller <tim@centricular.com>
Sat, 26 Oct 2013 08:41:26 +0000 (09:41 +0100)
https://bugzilla.gnome.org/show_bug.cgi?id=709916

docs/faq/developing.xml

index 8472b96..cbab862 100644 (file)
@@ -45,27 +45,21 @@ or integrate with autoconf using the pkg.m4 macro (providing PKG_CONFIG_CHECK).
         <para>
 It is possible to develop and compile against an uninstalled copy of
 gstreamer and gst-plugins-* (for example, against gits checkouts).
-The easiest way to do this is to use a bash script like  this:
-<ulink url="http://cgit.freedesktop.org/gstreamer/gstreamer/tree/scripts/gst-uninstalled">latest version of gst-uninstalled</ulink>.
 
-If you put this script in your path, and symlink it to gst-git (if you want
-to develop against git master) or to gst-released (if you want to develop
-against the lastest release of each module), it will automatically use the
-uninstalled version from that directory (ie. gst-git will look for a directory
-called 'git', and gst-released will expect the uninstalled modules to be in
-the 'released' directory; you are free to use any name or identifier you like
-here).
-        </para>
-        <para>
-This requires you to have put your checkouts of gstreamer and gst-plugins
-under ~/gst/git (for the master version).  The program is easily modifiable
-if this isn't the case.
-        </para>
-        <para>
-After running this script, you'll be in an environment where the uninstalled
+The easiest way too create such a setup is the
+<ulink url="http://cgit.freedesktop.org/gstreamer/gstreamer/tree/scripts/create-uninstalled-setup.sh">latest version of create-uninstalled-setup.sh</ulink>
+       </para>
+       <para>
+This setup makes use of the
+<ulink url="http://cgit.freedesktop.org/gstreamer/gstreamer/tree/scripts/gst-uninstalled">latest version of gst-uninstalled</ulink>.
+Running this script, you'll be in an environment where the uninstalled
 tools and plugins will be used by default.  Also, pkg-config will detect the
 uninstalled copies before (and prefer them to) any installed copies.
         </para>
+       <para>
+Multiple uninstalled setups can be used in parallel. Have a look at
+<ulink url="http://cgit.freedesktop.org/gstreamer/gstreamer/tree/scripts/gst-uninstalled">gst-uninstalled</ulink> to see how it determines which environment is used.
+       </para>
       </answer>
     </qandaentry>