docs: Fix location of plugins and registry in home directories

Fixes out of date documentation left over since 0.10.  In 1.0 plugins are
stored in $XDG_DATA_HOME and the registry in $XDG_CACHE_HOME conformant
with the XDG Base Directory Specification[1].

[1]: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html

https://bugzilla.gnome.org/show_bug.cgi?id=724132
This commit is contained in:
William Manley 2014-02-11 16:30:31 +00:00 committed by Sebastian Dröge
parent 71ad1d6fdd
commit be8eeabefc
2 changed files with 11 additions and 5 deletions

View file

@ -46,7 +46,7 @@ plug-ins in the user's home directory, or rather the user's "data home"
directory according to the xdg base dir specification. Usually this will be directory according to the xdg base dir specification. Usually this will be
a directory called a directory called
<filename>plugins</filename> inside the <filename>plugins</filename> inside the
<filename>.local/share/.gstreamer-&GST_API_VERSION;</filename> directory in <filename>.local/share/gstreamer-&GST_API_VERSION;</filename> directory in
the user's home directory by default, though this search path may change if the user's home directory by default, though this search path may change if
the XDG_DATA_HOME environment variable is set. the XDG_DATA_HOME environment variable is set.
</para> </para>

View file

@ -57,15 +57,21 @@
* <listitem> * <listitem>
* <para>default locations (if GST_PLUGIN_SYSTEM_PATH is not set). Those * <para>default locations (if GST_PLUGIN_SYSTEM_PATH is not set). Those
* default locations are: * default locations are:
* <filename>~/.gstreamer-$GST_API_VERSION/plugins/</filename> * <filename>$XDG_DATA_HOME/gstreamer-$GST_API_VERSION/plugins/</filename>
* and <filename>$prefix/libs/gstreamer-$GST_API_VERSION/</filename>. * and <filename>$prefix/libs/gstreamer-$GST_API_VERSION/</filename>.
* <ulink url="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">
* <filename>$XDG_DATA_HOME</filename></ulink> defaults to
* <filename>$HOME/.local/share</filename>.
* </para> * </para>
* </listitem> * </listitem>
* </itemizedlist> * </itemizedlist>
* The registry cache file is loaded from * The registry cache file is loaded from
* <filename>~/.gstreamer-$GST_API_VERSION/registry-$ARCH.bin</filename> or the * <filename>$XDG_CACHE_HOME/gstreamer-$GST_API_VERSION/registry-$ARCH.bin</filename>
* file listed in the GST_REGISTRY env var. One reason to change the registry * (where
* location is for testing. * <ulink url="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">
* <filename>$XDG_CACHE_HOME</filename></ulink> defaults to
* <filename>$HOME/.cache</filename>) or the file listed in the GST_REGISTRY
* env var. One reason to change the registry location is for testing.
* *
* For each plugin that is found in the plugin search path, there could be 3 * For each plugin that is found in the plugin search path, there could be 3
* possibilities for cached information: * possibilities for cached information: