summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/conf.py2
-rw-r--r--doc/plugins.rst18
-rw-r--r--doc/user.rst6
3 files changed, 25 insertions, 1 deletions
diff --git a/doc/conf.py b/doc/conf.py
index 9402ae0d5..1d486ae48 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -38,7 +38,7 @@ author = 'Max Kellermann'
# built documents.
#
# The short X.Y version.
-version = '0.21.5'
+version = '0.21.6'
# The full version, including alpha/beta/rc tags.
release = version
diff --git a/doc/plugins.rst b/doc/plugins.rst
index 0e09b35ab..060435537 100644
--- a/doc/plugins.rst
+++ b/doc/plugins.rst
@@ -87,6 +87,22 @@ Mount file systems (e.g. USB sticks or other removable media) using
the udisks2 daemon via D-Bus. To obtain a valid udisks2 URI, consult
:ref:`the according neighbor plugin <neighbor_plugin>`.
+It might be necessary to grant :program:`MPD` privileges to control
+:program:`udisks2` through :program:`policykit`. To do this, create a
+file called :file:`/usr/share/polkit-1/rules.d/mpd-udisks.rules` with
+the following text::
+
+ polkit.addRule(function(action, subject) {
+ if ((action.id == "org.freedesktop.udisks2.filesystem-mount" ||
+ action.id == "org.freedesktop.udisks2.filesystem-mount-other-seat") &&
+ subject.user == "mpd") {
+ return polkit.Result.YES;
+ }
+ });
+
+If you run MPD as a different user, change ``mpd`` to the name of your
+MPD user.
+
.. _neighbor_plugin:
Neighbor plugins
@@ -935,6 +951,8 @@ The pulse plugin connects to a `PulseAudio <http://www.freedesktop.org/wiki/Soft
- Sets the host name of the PulseAudio server. By default, :program:`MPD` connects to the local PulseAudio server.
* - **sink NAME**
- Specifies the name of the PulseAudio sink :program:`MPD` should play on.
+ * - **scale_volume FACTOR**
+ - Specifies a linear scaling coefficient (ranging from 0.5 to 5.0) to apply when adjusting volume through :program:`MPD`. For example, chosing a factor equal to ``"0.7"`` means that setting the volume to 100 in :program:`MPD` will set the PulseAudio volume to 70%, and a factor equal to ``"3.5"`` means that volume 100 in :program:`MPD` corresponds to a 350% PulseAudio volume.
recorder
~~~~~~~~
diff --git a/doc/user.rst b/doc/user.rst
index b16956fc3..9bc049d8e 100644
--- a/doc/user.rst
+++ b/doc/user.rst
@@ -531,6 +531,12 @@ choice::
bind_to_address "/var/run/mpd/socket"
+On Linux, local sockets can be bound to a name without a socket inode
+on the filesystem; MPD implements this by prepending ``@`` to the
+address::
+
+ bind_to_address "@mpd"
+
If no port is specified, the default port is 6600. This default can
be changed with the port setting::