[media] doc-rst: better name the media books
The titles at the media books were misleading, and some books
were not numbered.
Rename the kAPI book to better reflect its contents, be more
consistent on the initial rst file for each book and better
name them.
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
diff --git a/Documentation/index.rst b/Documentation/index.rst
index 31273cc..43c722f 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -15,7 +15,7 @@
kernel-documentation
media/media_uapi
- media/media_drivers
+ media/media_kapi
media/dvb-drivers/index
media/v4l-drivers/index
diff --git a/Documentation/media/dvb-drivers/index.rst b/Documentation/media/dvb-drivers/index.rst
index 14da36f..e1d4d87 100644
--- a/Documentation/media/dvb-drivers/index.rst
+++ b/Documentation/media/dvb-drivers/index.rst
@@ -2,9 +2,9 @@
.. include:: <isonum.txt>
-#############################################
-Linux Digital Video Broadcast (DVB) subsystem
-#############################################
+##############################################
+Linux Digital TV driver-specific documentation
+##############################################
**Copyright** |copy| 2001-2016 : LinuxTV Developers
@@ -17,6 +17,9 @@
.. toctree::
:maxdepth: 5
+ :numbered:
+ :caption: Table of Contents
+ :name: dvb_mastertoc
intro
avermedia
diff --git a/Documentation/media/media_drivers.rst b/Documentation/media/media_kapi.rst
similarity index 76%
rename from Documentation/media/media_drivers.rst
rename to Documentation/media/media_kapi.rst
index 8e0f455..0af80e9 100644
--- a/Documentation/media/media_drivers.rst
+++ b/Documentation/media/media_kapi.rst
@@ -2,9 +2,9 @@
.. include:: <isonum.txt>
-=========================
-Media subsystem core kAPI
-=========================
+===================================
+Media subsystem kernel internal API
+===================================
**Copyright** |copy| 2009-2016 : LinuxTV Developers
@@ -16,6 +16,9 @@
.. toctree::
:maxdepth: 5
+ :numbered:
+ :caption: Table of Contents
+ :name: kapi_mastertoc
kapi/v4l2-framework
kapi/v4l2-controls
diff --git a/Documentation/media/media_uapi.rst b/Documentation/media/media_uapi.rst
index 5e872c8..debe4531 100644
--- a/Documentation/media/media_uapi.rst
+++ b/Documentation/media/media_uapi.rst
@@ -2,9 +2,9 @@
.. include:: <isonum.txt>
-##############################
-Linux Media Infrastructure API
-##############################
+########################################
+Linux Media Infrastructure userspace API
+########################################
**Copyright** |copy| 2009-2016 : LinuxTV Developers
@@ -15,10 +15,10 @@
License".
-.. contents::
-
.. toctree::
:maxdepth: 5
+ :caption: Table of Contents
+ :name: uapi_mastertoc
intro
uapi/v4l/v4l2
diff --git a/Documentation/media/v4l-drivers/index.rst b/Documentation/media/v4l-drivers/index.rst
index 34990b5..8d17102 100644
--- a/Documentation/media/v4l-drivers/index.rst
+++ b/Documentation/media/v4l-drivers/index.rst
@@ -2,9 +2,9 @@
.. include:: <isonum.txt>
-###########################
-Video4Linux (V4L) subsystem
-###########################
+################################################
+Video4Linux (V4L) driver-specific documentation
+################################################
**Copyright** |copy| 1999-2016 : LinuxTV Developers
@@ -18,6 +18,8 @@
.. toctree::
:maxdepth: 5
:numbered:
+ :caption: Table of Contents
+ :name: v4l_mastertoc
fourcc
v4l-with-ir