From da83c888bfa5bee632953c57940c24846bb46965 Mon Sep 17 00:00:00 2001 From: Mauro Carvalho Chehab Date: Wed, 20 Jul 2016 10:36:18 -0300 Subject: [PATCH] [media] doc-rst: better organize the media books The uAPI book has 5 parts, but they lost numeration after conversion to rst. Manually number those parts, and make the main index with 1 depth, to only show the parts and the annexes. At each part, use :maxwidth: 5, in order to show a more complete index. While here, fix the cross-references between different books. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/kapi/mc-core.rst | 2 +- Documentation/media/media_uapi.rst | 2 +- Documentation/media/uapi/cec/cec-api.rst | 14 ++++++++------ Documentation/media/uapi/dvb/dvbapi.rst | 12 ++++++++---- .../media/uapi/mediactl/media-controller.rst | 17 +++++++---------- .../media/uapi/rc/remote_controllers.rst | 17 +++++++---------- Documentation/media/uapi/v4l/v4l2.rst | 12 ++++++++---- Documentation/media/v4l-drivers/fimc.rst | 10 ++++------ 8 files changed, 44 insertions(+), 42 deletions(-) diff --git a/Documentation/media/kapi/mc-core.rst b/Documentation/media/kapi/mc-core.rst index c1fe0d69207d..4c47f5e3611d 100644 --- a/Documentation/media/kapi/mc-core.rst +++ b/Documentation/media/kapi/mc-core.rst @@ -5,7 +5,7 @@ Media Controller ~~~~~~~~~~~~~~~~ The media controller userspace API is documented in -:ref:`the Media Controller uAPI book `. This document focus +:ref:`the Media Controller uAPI book `. This document focus on the kernel-side implementation of the media framework. Abstract media device model diff --git a/Documentation/media/media_uapi.rst b/Documentation/media/media_uapi.rst index aaa9a0e387c4..fd8ebe002cd2 100644 --- a/Documentation/media/media_uapi.rst +++ b/Documentation/media/media_uapi.rst @@ -19,7 +19,7 @@ License". Table of Contents .. toctree:: - :maxdepth: 5 + :maxdepth: 1 intro uapi/v4l/v4l2 diff --git a/Documentation/media/uapi/cec/cec-api.rst b/Documentation/media/uapi/cec/cec-api.rst index 246fbae2e079..bb018709970c 100644 --- a/Documentation/media/uapi/cec/cec-api.rst +++ b/Documentation/media/uapi/cec/cec-api.rst @@ -4,16 +4,18 @@ .. _cec: -####### -CEC API -####### - -.. _cec-api: +######################################### +Part V - Consumer Electronics Control API +######################################### This part describes the CEC: Consumer Electronics Control +.. class:: toc-title + + Table of Contents + .. toctree:: - :maxdepth: 1 + :maxdepth: 5 :numbered: cec-intro diff --git a/Documentation/media/uapi/dvb/dvbapi.rst b/Documentation/media/uapi/dvb/dvbapi.rst index 6c06147f167c..48e61aba741e 100644 --- a/Documentation/media/uapi/dvb/dvbapi.rst +++ b/Documentation/media/uapi/dvb/dvbapi.rst @@ -4,17 +4,21 @@ .. _dvbapi: -############## -Digital TV API -############## +######################## +Part II - Digital TV API +######################## .. note:: This API is also known as **DVB API**, although it is generic enough to support all digital TV standards. **Version 5.10** +.. class:: toc-title + + Table of Contents + .. toctree:: - :maxdepth: 1 + :maxdepth: 5 :numbered: intro diff --git a/Documentation/media/uapi/mediactl/media-controller.rst b/Documentation/media/uapi/mediactl/media-controller.rst index 7e08c93a15ab..7ae38d48969e 100644 --- a/Documentation/media/uapi/mediactl/media-controller.rst +++ b/Documentation/media/uapi/mediactl/media-controller.rst @@ -2,21 +2,18 @@ .. include:: -.. _media_common: - -#################### -Media Controller API -#################### - .. _media_controller: -**************** -Media Controller -**************** +############################## +Part IV - Media Controller API +############################## + +.. class:: toc-title + Table of Contents .. toctree:: - :maxdepth: 1 + :maxdepth: 5 :numbered: media-controller-intro diff --git a/Documentation/media/uapi/rc/remote_controllers.rst b/Documentation/media/uapi/rc/remote_controllers.rst index 169286501ebb..3e25cc9f65e0 100644 --- a/Documentation/media/uapi/rc/remote_controllers.rst +++ b/Documentation/media/uapi/rc/remote_controllers.rst @@ -2,21 +2,18 @@ .. include:: -.. _remotes: - -##################### -Remote Controller API -##################### - .. _remote_controllers: -****************** -Remote Controllers -****************** +################################ +Part III - Remote Controller API +################################ + +.. class:: toc-title + Table of Contents .. toctree:: - :maxdepth: 1 + :maxdepth: 5 :numbered: rc-intro diff --git a/Documentation/media/uapi/v4l/v4l2.rst b/Documentation/media/uapi/v4l/v4l2.rst index c0859ebc88ee..5e41a8505301 100644 --- a/Documentation/media/uapi/v4l/v4l2.rst +++ b/Documentation/media/uapi/v4l/v4l2.rst @@ -3,17 +3,21 @@ .. include:: .. _v4l2spec: -################### -Video for Linux API -################### +############################ +Part I - Video for Linux API +############################ This part describes the Video for Linux API version 2 (V4L2 API) specification. **Revision 4.5** +.. class:: toc-title + + Table of Contents + .. toctree:: :numbered: - :maxdepth: 1 + :maxdepth: 5 common pixfmt diff --git a/Documentation/media/v4l-drivers/fimc.rst b/Documentation/media/v4l-drivers/fimc.rst index d9f950d90eb5..3adc19bcf039 100644 --- a/Documentation/media/v4l-drivers/fimc.rst +++ b/Documentation/media/v4l-drivers/fimc.rst @@ -62,8 +62,7 @@ User space interfaces Media device interface ~~~~~~~~~~~~~~~~~~~~~~ -The driver supports Media Controller API as defined at -https://linuxtv.org/downloads/v4l-dvb-apis/media_common.html +The driver supports Media Controller API as defined at :ref:`media_controller`. The media device driver name is "SAMSUNG S5P FIMC". The purpose of this interface is to allow changing assignment of FIMC instances @@ -89,12 +88,11 @@ undefined behaviour. Capture video node ~~~~~~~~~~~~~~~~~~ -The driver supports V4L2 Video Capture Interface as defined at: -https://linuxtv.org/downloads/v4l-dvb-apis/devices.html +The driver supports V4L2 Video Capture Interface as defined at +:ref:`devices`. At the capture and mem-to-mem video nodes only the multi-planar API is -supported. For more details see: -https://linuxtv.org/downloads/v4l-dvb-apis/planar-apis.html +supported. For more details see: :ref:`planar-apis`. Camera capture subdevs ~~~~~~~~~~~~~~~~~~~~~~ -- 2.20.1