docs: FAQ update to mention create-uninstalled-setup.sh

https://bugzilla.gnome.org/show_bug.cgi?id=709916
This commit is contained in:
Fabian Kirsch 2013-10-16 15:00:41 +02:00 committed by Tim-Philipp Müller
parent a6f60fcf2e
commit d0dd23cf9f

View 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).
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 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
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>