From 687834328c78215470a870c0af9125bd46a575c3 Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@musicpd.org>
Date: Tue, 5 Jun 2018 21:00:59 +0200
Subject: [PATCH] doc/user.xml: add section explaining storage/neighbor plugins
and mounts
---
doc/user.xml | 30 ++++++++++++++++++++++++++++++
1 file changed, 30 insertions(+)
diff --git a/doc/user.xml b/doc/user.xml
index 15f12143e..1cf926dad 100644
--- a/doc/user.xml
+++ b/doc/user.xml
@@ -442,6 +442,12 @@ systemctl start mpd.socket</programlisting>
recipe, read the <link linkend="satellite">Satellite
MPD</link> section.
</para>
+
+ <para>
+ You can also <link linkend="mount">use multiple storage
+ plugins to assemble a virtual music directory consisting of
+ multiple storages</link>.
+ </para>
</section>
<section id="config_database_plugins">
@@ -1531,6 +1537,30 @@ database {
Matching files in the current directory and all subdirectories
are excluded.
</para>
+
+ <section id="mount">
+ <title>Mounting other storages into the music directory</title>
+
+ <para>
+ <application>MPD</application> has various <link
+ linkend="storage_plugins">storage plugins</link> of which
+ multiple instances can be "mounted" into the music
+ directory. This way, you can use local music, file servers
+ and USB sticks at the same time. Example:
+ </para>
+
+ <programlisting>mpc mount foo nfs://192.168.1.4/export/mp3
+mpc mount usbstick udisks://by-uuid-2F2B-D136
+mpc unmount usbstick</programlisting>
+
+ <para>
+ MPD's <link
+ linkend="neighbor_plugins">neighbor plugins</link> can be
+ helpful with finding mountable storages:
+ </para>
+
+ <programlisting>mpc listneighbors</programlisting>
+ </section>
</section>
<section id="tags">