summaryrefslogtreecommitdiff
path: root/doc/grilo/environment-setup.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/grilo/environment-setup.xml')
-rw-r--r--doc/grilo/environment-setup.xml16
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/grilo/environment-setup.xml b/doc/grilo/environment-setup.xml
index b2a90ae..96267af 100644
--- a/doc/grilo/environment-setup.xml
+++ b/doc/grilo/environment-setup.xml
@@ -150,5 +150,21 @@ $ export GRL_DEBUG=registry:*,youtube:warning
$ export GRL_PLUGIN_RANKS=youtube:5,bookmarks:-4
</programlisting>
+ <para>
+ Some plugins extend their plugin name with login specific identifiers.
+ To match these plugins the ranks environment variable allows for simple
+ glob pattern matching with the '?' and '*' wildcards. This can of course
+ also be used in other situations.
+ Here is one example:
+ </para>
+
+ <programlisting>
+# Set the rank of all coverart plugins to 2, but the Last.FM
+# coverart plugin whether logged in or not to 5.
+# Note that order is important here: the ranks are interpreted from
+# right to left.
+$ export GRL_PLUGIN_RANKS=grl-lastfm-cover*:5,*cover*:2
+ </programlisting>
+
</section>
</section>