From: Mauro Carvalho Chehab Date: Sun, 3 Jul 2016 14:17:12 +0000 (-0300) Subject: doc-rst: selection-api-005: Fix ReST parsing X-Git-Tag: v4.8-rc1~131^2^2~300 X-Git-Url: https://git.karo-electronics.de/?a=commitdiff_plain;h=8e97cd94319ee7121bb254657f01681fc7e45693;p=karo-tx-linux.git doc-rst: selection-api-005: Fix ReST parsing The ReST markup is limited: it doesn't accept a const just after a reference. So, change the documentation to avoid such constraint. Signed-off-by: Mauro Carvalho Chehab --- diff --git a/Documentation/linux_tv/media/v4l/selection-api-005.rst b/Documentation/linux_tv/media/v4l/selection-api-005.rst index 6fdb0af2b13d..78448023a79a 100644 --- a/Documentation/linux_tv/media/v4l/selection-api-005.rst +++ b/Documentation/linux_tv/media/v4l/selection-api-005.rst @@ -15,10 +15,11 @@ appropriate targets. The V4L2 API lacks any support for composing to and cropping from an image inside a memory buffer. The application could configure a capture device to fill only a part of an image by abusing V4L2 API. Cropping a smaller image from a larger one is achieved by -setting the field struct -:ref:`v4l2_pix_format ```::bytesperline``. -Introducing an image offsets could be done by modifying field struct -:ref:`v4l2_buffer ```::m_userptr`` before calling +setting the field ``bytesperline`` at struct +:ref:`v4l2_pix_format `. +Introducing an image offsets could be done by modifying field ``m_userptr`` +at struct +:ref:`v4l2_buffer ` before calling :ref:`VIDIOC_QBUF`. Those operations should be avoided because they are not portable (endianness), and do not work for macroblock and Bayer formats and mmap buffers. The selection API deals with configuration of buffer