From 7ecbb0454f4cbdd10389e06531bc9889cd7fbe5d Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@duempel.org>
Date: Fri, 7 Oct 2011 06:38:23 +0200
Subject: decoder/dsdiff: add documentation

---
 doc/user.xml                        | 8 ++++++++
 src/decoder/dsdiff_decoder_plugin.c | 7 +++++++
 2 files changed, 15 insertions(+)

diff --git a/doc/user.xml b/doc/user.xml
index 4ca91da3..2e654bcc 100644
--- a/doc/user.xml
+++ b/doc/user.xml
@@ -736,6 +736,14 @@ cd mpd-version</programlisting>
     <section>
       <title>Decoder plugins</title>
 
+      <section>
+        <title><varname>dsdiff</varname></title>
+
+        <para>
+          Decodes DFF files containing DSDIFF data (e.g. SACD rips).
+        </para>
+      </section>
+
       <section>
         <title><varname>mikmod</varname></title>
 
diff --git a/src/decoder/dsdiff_decoder_plugin.c b/src/decoder/dsdiff_decoder_plugin.c
index d1b12e0a..2c03cce5 100644
--- a/src/decoder/dsdiff_decoder_plugin.c
+++ b/src/decoder/dsdiff_decoder_plugin.c
@@ -17,6 +17,13 @@
  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  */
 
+/* \file
+ *
+ * This plugin decodes DSDIFF data (SACD) embedded in DFF files.  It
+ * was modeled after the specification found here:
+ * http://www.sonicstudio.com/pdf/dsd/DSDIFF_1.5_Spec.pdf
+ */
+
 #include "config.h"
 #include "dsdiff_decoder_plugin.h"
 #include "decoder_api.h"
-- 
cgit v1.2.3