summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMauro Carvalho Chehab <mchehab@s-opensource.com>2016-07-05 00:32:02 +0300
committerMauro Carvalho Chehab <mchehab@s-opensource.com>2016-07-05 00:32:02 +0300
commitca023c3d67970b9d2f5724036931596932cd56ba (patch)
treeff95e6fe92f418313107d3f0100872f7195b76a2
parentf84dd9007fa7280a02263e15fe4c7d1993b620c2 (diff)
downloadlinux-ca023c3d67970b9d2f5724036931596932cd56ba.tar.xz
doc-rst: dev-raw-vbi fix conversion issues
There are several things that didn't convert well. Fix them, in order to improve the layout of the formatted document. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
-rw-r--r--Documentation/linux_tv/media/v4l/dev-raw-vbi.rst29
1 files changed, 10 insertions, 19 deletions
diff --git a/Documentation/linux_tv/media/v4l/dev-raw-vbi.rst b/Documentation/linux_tv/media/v4l/dev-raw-vbi.rst
index 3aa93943fe9f..da85be88d57e 100644
--- a/Documentation/linux_tv/media/v4l/dev-raw-vbi.rst
+++ b/Documentation/linux_tv/media/v4l/dev-raw-vbi.rst
@@ -155,7 +155,7 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
- __u32
- - ``start``\ [2]
+ - ``start``\ [2]_
- This is the scanning system line number associated with the first
line of the VBI image, of the first and the second field
@@ -173,7 +173,7 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
- __u32
- - ``count``\ [2]
+ - ``count``\ [2]_
- The number of lines in the first and second field image,
respectively.
@@ -218,7 +218,7 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
- __u32
- - ``reserved``\ [2]
+ - ``reserved``\ [2]_
- This array is reserved for future extensions. Drivers and
applications must set it to zero.
@@ -275,11 +275,7 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
:alt: vbi_hsync.pdf / vbi_hsync.gif
:align: center
- Line synchronization
-
- Line synchronization diagram
-
-
+ **Figure 4.1. Line synchronization**
.. _vbi-525:
@@ -288,10 +284,7 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
:alt: vbi_525.pdf / vbi_525.gif
:align: center
- ITU-R 525 line numbering (M/NTSC and M/PAL)
-
- NTSC field synchronization diagram
-
+ **Figure 4.2. ITU-R 525 line numbering (M/NTSC and M/PAL)**
@@ -301,9 +294,7 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
:alt: vbi_625.pdf / vbi_625.gif
:align: center
- ITU-R 625 line numbering
-
- PAL/SECAM field synchronization diagram
+ **Figure 4.3. ITU-R 625 line numbering**
@@ -327,8 +318,7 @@ The total size of a frame computes as follows:
.. code-block:: c
- (count[0] + count[1]) *
- samples_per_line * sample size in bytes
+ (count[0] + count[1]) * samples_per_line * sample size in bytes
The sample size is most likely always one byte, applications must check
the ``sample_format`` field though, to function properly with other
@@ -339,8 +329,9 @@ A VBI device may support :ref:`read/write <rw>` and/or streaming
The latter bears the possibility of synchronizing video and VBI data by
using buffer timestamps.
-Remember the :ref:`VIDIOC_STREAMON` ioctl and the
-first read(), write() and select() call can be resource allocation
+Remember the :ref:`VIDIOC_STREAMON <VIDIOC_STREAMON>` ioctl and the
+first :ref:`read() <func-read>`, :ref:`write() <func-write>` and
+:ref:`select() <func-select>` call can be resource allocation
points returning an ``EBUSY`` error code if the required hardware resources
are temporarily unavailable, for example the device is already in use by
another process.