diff --git a/doc/user.xml b/doc/user.xml
index 3a3bd7521..fe67b9332 100644
--- a/doc/user.xml
+++ b/doc/user.xml
@@ -220,6 +220,13 @@ systemctl start mpd.socket</programlisting>
 
       <programlisting>connection_timeout "5"</programlisting>
 
+      <para>
+        For settings which specify a filesystem path, the tilde is
+        expanded:
+      </para>
+
+      <programlisting>music_directory "~/Music"</programlisting>
+
       <para>
         Some of the settings are grouped in blocks with curly braces,
         e.g. per-plugin settings: