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@xxxxxxxxxxxxxxxx> --- Documentation/linux_tv/media/v4l/dev-raw-vbi.rst | 29 ++++++++---------------- 1 file 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. -- 2.7.4 -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html