From patchwork Tue Jul 5 01:31:12 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 9213413 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id E995C60467 for ; Tue, 5 Jul 2016 01:32:32 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id D878228800 for ; Tue, 5 Jul 2016 01:32:32 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id CD00E28802; Tue, 5 Jul 2016 01:32:32 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 6945128800 for ; Tue, 5 Jul 2016 01:32:32 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932977AbcGEBc3 (ORCPT ); Mon, 4 Jul 2016 21:32:29 -0400 Received: from bombadil.infradead.org ([198.137.202.9]:38641 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754216AbcGEBb0 (ORCPT ); Mon, 4 Jul 2016 21:31:26 -0400 Received: from 201.86.133.99.dynamic.adsl.gvt.net.br ([201.86.133.99] helo=smtp.w2.samsung.com) by bombadil.infradead.org with esmtpsa (Exim 4.85_2 #1 (Red Hat Linux)) id 1bKFCv-0001ga-Jk; Tue, 05 Jul 2016 01:31:25 +0000 Received: from mchehab by smtp.w2.samsung.com with local (Exim 4.87) (envelope-from ) id 1bKFCp-0001cO-Sp; Mon, 04 Jul 2016 22:31:19 -0300 From: Mauro Carvalho Chehab To: Linux Media Mailing List Cc: Mauro Carvalho Chehab , Mauro Carvalho Chehab , Jonathan Corbet , Markus Heiser , linux-doc@vger.kernel.org Subject: [PATCH 37/41] Documentation: dev-raw-vbi.rst fix conversion issues Date: Mon, 4 Jul 2016 22:31:12 -0300 Message-Id: X-Mailer: git-send-email 2.7.4 In-Reply-To: <376f8877e078483e22a906cb0126f8db37bde441.1467670142.git.mchehab@s-opensource.com> References: <376f8877e078483e22a906cb0126f8db37bde441.1467670142.git.mchehab@s-opensource.com> In-Reply-To: <376f8877e078483e22a906cb0126f8db37bde441.1467670142.git.mchehab@s-opensource.com> References: <376f8877e078483e22a906cb0126f8db37bde441.1467670142.git.mchehab@s-opensource.com> Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP 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 --- 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 ` 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 ` 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 ` 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 ` 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 ` 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 ` 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 ` 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 ` ioctl and the +first :ref:`read() `, :ref:`write() ` and +:ref:`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.