From 52acea7b1f8fa38ed884acfafe593d1494ade4c2 Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@duempel.org>
Date: Thu, 22 Jan 2015 11:04:21 +0100
Subject: [PATCH] doc/user: move resampler list to the plugin reference section

---
 doc/user.xml | 65 ++++++++++++++++++++++++++++++----------------------
 1 file changed, 37 insertions(+), 28 deletions(-)

diff --git a/doc/user.xml b/doc/user.xml
index e5061f1ca..914a89620 100644
--- a/doc/user.xml
+++ b/doc/user.xml
@@ -770,36 +770,10 @@ systemctl start mpd.socket</programlisting>
         </para>
 
         <para>
-          The following resamplers are available (if enabled at
-          compile time):
+          Check the <link linkend="resampler_plugins">resampler plugin
+          reference</link> for a list of resamplers.
         </para>
 
-        <itemizedlist>
-          <listitem>
-            <para>
-              <ulink
-              url="http://www.mega-nerd.com/SRC/"><application>libsamplerate</application></ulink>
-              a.k.a. Secret Rabbit Code (SRC).
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              <ulink
-              url="http://sourceforge.net/projects/soxr/"><application>libsoxr</application></ulink>,
-              the SoX Resampler library
-            </para>
-          </listitem>
-
-          <listitem>
-            <para>
-              internal: low CPU usage, but very poor quality.  This is
-              the fallback if <application>MPD</application> was
-              compiled without an external resampler.
-            </para>
-          </listitem>
-        </itemizedlist>
-
         <para>
           The setting <varname>samplerate_converter</varname> controls
           how <application>MPD</application> shall resample music.
@@ -2331,6 +2305,41 @@ buffer_size: 16384</programlisting>
       </section>
     </section>
 
+    <section id="resampler_plugins">
+      <title>Resampler plugins</title>
+
+      <section id="internal_resampler">
+        <title><varname>internal</varname></title>
+
+        <para>
+          A resampler built into <application>MPD</application>.  Its
+          quality is very poor, but its CPU usage is low.  This is the
+          fallback if <application>MPD</application> was compiled
+          without an external resampler.
+        </para>
+      </section>
+
+      <section id="libsamplerate_resampler">
+        <title><varname>libsamplerate</varname></title>
+
+        <para>
+          A resampler using <ulink
+          url="http://www.mega-nerd.com/SRC/"><application>libsamplerate</application></ulink>
+          a.k.a. Secret Rabbit Code (SRC).
+        </para>
+      </section>
+
+      <section id="soxr_resampler">
+        <title><varname>soxr</varname></title>
+
+        <para>
+          A resampler using <ulink
+          url="http://sourceforge.net/projects/soxr/"><application>libsoxr</application></ulink>,
+          the SoX Resampler library
+        </para>
+      </section>
+    </section>
+
     <section id="output_plugins">
       <title>Output plugins</title>