From 6747b39441925f247f15d04b89be3588f465ad57 Mon Sep 17 00:00:00 2001
From: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
Date: Wed, 4 Nov 2015 12:07:02 -0200
Subject: [PATCH] [media] device-drivers.tmpl: better organize DVB function
 calls

Classify the functions at the DVB core per API. That makes easier
to understand how they're related to the userspace API.

Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
---
 Documentation/DocBook/device-drivers.tmpl | 24 ++++++++++++++---------
 drivers/media/dvb-core/demux.h            |  4 ++--
 2 files changed, 17 insertions(+), 11 deletions(-)

diff --git a/Documentation/DocBook/device-drivers.tmpl b/Documentation/DocBook/device-drivers.tmpl
index c2bc8f779a9b..fc7242dd5d65 100644
--- a/Documentation/DocBook/device-drivers.tmpl
+++ b/Documentation/DocBook/device-drivers.tmpl
@@ -238,19 +238,25 @@ X!Isound/sound_firmware.c
 !Iinclude/media/videobuf2-memops.h
      </sect1>
      <sect1><title>Digital TV (DVB) devices</title>
-!Idrivers/media/dvb-core/dvb_ca_en50221.h
-!Idrivers/media/dvb-core/dvb_frontend.h
+	<sect1><title>Digital TV Common functions</title>
 !Idrivers/media/dvb-core/dvb_math.h
 !Idrivers/media/dvb-core/dvb_ringbuffer.h
 !Idrivers/media/dvb-core/dvbdev.h
-     <sect1><title>Digital TV Demux API</title>
-!Pdrivers/media/dvb-core/demux.h Digital TV Demux API
-     </sect1>
-     <sect1><title>Demux Callback API</title>
-!Pdrivers/media/dvb-core/demux.h Demux Callback API
-     </sect1>
+	</sect1>
+	<sect1><title>Digital TV Frontend kABI</title>
+!Idrivers/media/dvb-core/dvb_frontend.h
+	</sect1>
+	<sect1><title>Digital TV Demux kABI</title>
+!Pdrivers/media/dvb-core/demux.h Digital TV Demux
+	<sect1><title>Demux Callback API</title>
+!Pdrivers/media/dvb-core/demux.h Demux Callback
+	</sect1>
 !Idrivers/media/dvb-core/demux.h
-    </sect1>
+	</sect1>
+	<sect1><title>Digital TV Conditional Access kABI</title>
+!Idrivers/media/dvb-core/dvb_ca_en50221.h
+	</sect1>
+     </sect1>
     <sect1><title>Remote Controller devices</title>
 !Iinclude/media/rc-core.h
 !Iinclude/media/lirc_dev.h
diff --git a/drivers/media/dvb-core/demux.h b/drivers/media/dvb-core/demux.h
index f8014aabf37b..f716e14f995f 100644
--- a/drivers/media/dvb-core/demux.h
+++ b/drivers/media/dvb-core/demux.h
@@ -33,7 +33,7 @@
 #include <linux/dvb/dmx.h>
 
 /**
- * DOC: Digital TV Demux API
+ * DOC: Digital TV Demux
  *
  * The kernel demux API defines a driver-internal interface for registering
  * low-level, hardware specific driver to a hardware independent demux layer.
@@ -231,7 +231,7 @@ struct dmx_section_feed {
 };
 
 /**
- * DOC: Demux Callback API
+ * DOC: Demux Callback
  *
  * This kernel-space API comprises the callback functions that deliver filtered
  * data to the demux client. Unlike the other DVB kABIs, these functions are
-- 
2.20.1