From patchwork Wed Sep 30 06:35:55 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 255548 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.6 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, INCLUDES_PATCH, MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 666A6C4727C for ; Wed, 30 Sep 2020 06:36:35 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 1DE1320789 for ; Wed, 30 Sep 2020 06:36:35 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601447795; bh=6xPjWQx4pdqPWhe57hN7t0TY4FqQaqlHz6FS3YcZ3GM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:List-ID:From; b=NSqULZzzBa7u1m9G342OtT8qa3DO6Y1kyYAtYke6eXq4aM0QjepQrIY5AxMsN0FOP 3+lqSqYtuXNUORRJEIcPSlQi66tUT2TRuiqljB+Pk04QXaDBrdnPsx2CIO9nFtrFNr wNgGt0uHwWAwsBb0bgy1qa3RBrLBOOQ1lT7IYr3M= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728281AbgI3Gg2 (ORCPT ); Wed, 30 Sep 2020 02:36:28 -0400 Received: from mail.kernel.org ([198.145.29.99]:59278 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727761AbgI3GgH (ORCPT ); Wed, 30 Sep 2020 02:36:07 -0400 Received: from mail.kernel.org (ip5f5ad5c4.dynamic.kabel-deutschland.de [95.90.213.196]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 271F0207C3; Wed, 30 Sep 2020 06:36:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601447766; bh=6xPjWQx4pdqPWhe57hN7t0TY4FqQaqlHz6FS3YcZ3GM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=m7M3sku51uQsGUSfTgJbTNtAV2y1nJu3vIM/pXwnkqhy3ANGeimegLgZHVnr6Xuyp GGSkZkq0/2OrbSlRt1Ob+VFR8du2JDBPa+MDXRNgSFTeoBZB5fAYFYiLXa9EF5xB5k dh8ODelL+VY+xTvXqZ9oc4iwFYL0lQdqvXuT3ci0= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kNVid-001QmQ-Ri; Wed, 30 Sep 2020 08:36:03 +0200 From: Mauro Carvalho Chehab To: Linux Media Mailing List Cc: linuxarm@huawei.com, mauro.chehab@huawei.com, Mauro Carvalho Chehab , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org Subject: [PATCH 2/9] media: glossary.rst: use the right case for glossary entries Date: Wed, 30 Sep 2020 08:35:55 +0200 Message-Id: <1c16b009018debb34d2abc4525fd5ad434831343.1601447236.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org Sphinx 3.x is pedantic with glossary entries: Documentation/userspace-api/media/glossary.rst:17: WARNING: term device driver not found in case sensitive match.made a reference to Device Driver instead. Documentation/userspace-api/media/glossary.rst:59: WARNING: term media hardware not found in case sensitive match.made a reference to Media Hardware instead. Documentation/userspace-api/media/glossary.rst:59: WARNING: term IP block not found in case sensitive match.made a reference to IP Block instead. Documentation/userspace-api/media/glossary.rst:64: WARNING: term hardware component not found in case sensitive match.made a reference to Hardware Component instead. Documentation/userspace-api/media/glossary.rst:64: WARNING: term ip block not found in case sensitive match.made a reference to IP Block instead. Documentation/userspace-api/media/glossary.rst:70: WARNING: term peripheral not found in case sensitive match.made a reference to Peripheral instead. Documentation/userspace-api/media/glossary.rst:130: WARNING: term V4L2 hardware not found in case sensitive match.made a reference to V4L2 Hardware instead. Documentation/userspace-api/media/glossary.rst:151: WARNING: term hardware peripheral not found in case sensitive match.made a reference to Hardware Peripheral instead. Documentation/userspace-api/media/glossary.rst:183: WARNING: term device node not found in case sensitive match.made a reference to Device Node instead. Documentation/userspace-api/media/glossary.rst:191: WARNING: term bridge driver not found in case sensitive match.made a reference to Bridge Driver instead. While it works with case-insensitive entires, it complains. Let's fix it, in order to cleanup the warnings. Also, I won't doubt that a later change on Sphinx will end breaking support for it. Signed-off-by: Mauro Carvalho Chehab --- .../userspace-api/media/glossary.rst | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/Documentation/userspace-api/media/glossary.rst b/Documentation/userspace-api/media/glossary.rst index 59a95dba5909..cb165d7176b7 100644 --- a/Documentation/userspace-api/media/glossary.rst +++ b/Documentation/userspace-api/media/glossary.rst @@ -14,7 +14,7 @@ Glossary .. glossary:: Bridge Driver - A :term:`device driver` that implements the main logic to talk with + A :term:`Device Driver` that implements the main logic to talk with media hardware. CEC API @@ -56,18 +56,18 @@ Glossary See https://en.wikipedia.org/wiki/Field-programmable_gate_array. Hardware Component - A subset of the :term:`media hardware`. For example an :term:`I²C` or - :term:`SPI` device, or an :term:`IP block` inside an + A subset of the :term:`Media Hardware`. For example an :term:`I²C` or + :term:`SPI` device, or an :term:`IP Block` inside an :term:`SoC` or :term:`FPGA`. Hardware Peripheral - A group of :term:`hardware components ` that + A group of :term:`hardware components ` that together make a larger user-facing functional peripheral. For - instance, the :term:`SoC` :term:`ISP` :term:`IP block ` + instance, the :term:`SoC` :term:`ISP` :term:`IP Block` and the external camera sensors together make a camera hardware peripheral. - Also known as :term:`peripheral`. + Also known as :term:`Peripheral`. I²C **Inter-Integrated Circuit** @@ -127,7 +127,7 @@ Glossary See :ref:`media_controller`. MC-centric - :term:`V4L2 hardware` device driver that requires :term:`MC API`. + :term:`V4L2 Hardware` device driver that requires :term:`MC API`. Such drivers have ``V4L2_CAP_IO_MC`` device_caps field set (see :ref:`VIDIOC_QUERYCAP`). @@ -148,7 +148,7 @@ Glossary instructions on a single integrated circuit. Peripheral - The same as :term:`hardware peripheral`. + The same as :term:`Hardware Peripheral`. RC API **Remote Controller API** @@ -180,7 +180,7 @@ Glossary control a V4L2 hardware. V4L2 Device Node - A :term:`device node` that is associated to a V4L driver. + A :term:`Device Node` that is associated to a V4L driver. The V4L2 device node naming is specified at :ref:`v4l2_device_naming`. @@ -189,7 +189,7 @@ Glossary V4L2 Sub-device V4L2 hardware components that aren't controlled by a - :term:`bridge driver`. See :ref:`subdev`. + :term:`Bridge Driver`. See :ref:`subdev`. Video-node-centric V4L2 device driver that doesn't require a media controller to be used. From patchwork Wed Sep 30 06:35:56 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 255550 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.6 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, INCLUDES_PATCH, MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 655DFC2D0A8 for ; Wed, 30 Sep 2020 06:36:19 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 15A6C2075F for ; Wed, 30 Sep 2020 06:36:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601447779; bh=KSQdhVCwLXMmbKuCw0FaRITnyXOd7ETydwCFt7TfWg8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:List-ID:From; b=cFRuh5ELo69qP5DVEbLWcDZhLgrPLikq2IvE20eE7GnR7pv4m24vPSCO7Y21133KZ H6pR87qU37APZtQY6HxLKWWjVv0WKazV7GNYycszU9Y9El15dCYh8np3AhPNdtf8uO Jbdf8HFm21aNpr6dx7e8e1HgJVmD97tj4o4HhXvs= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728157AbgI3GgI (ORCPT ); Wed, 30 Sep 2020 02:36:08 -0400 Received: from mail.kernel.org ([198.145.29.99]:59314 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727887AbgI3GgI (ORCPT ); Wed, 30 Sep 2020 02:36:08 -0400 Received: from mail.kernel.org (ip5f5ad5c4.dynamic.kabel-deutschland.de [95.90.213.196]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 3A8272145D; Wed, 30 Sep 2020 06:36:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601447766; bh=KSQdhVCwLXMmbKuCw0FaRITnyXOd7ETydwCFt7TfWg8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=EncXzmypd8oBxoUobMn7J5C7OeBODcf9Kz2t6WFAoCiMqisI3109VUCZb7XzAgQ4D ekAxqPyHAs/6o8+XxsW2EEwzYG9897GwK5CTvgfC5pYqiZz185S3IzBy3BClruquHz bKUcRDCaOz+JskRWxrn3O7PT3a9W7kMioAO+l5ZU= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kNVid-001QmS-Sd; Wed, 30 Sep 2020 08:36:03 +0200 From: Mauro Carvalho Chehab To: Linux Media Mailing List Cc: linuxarm@huawei.com, mauro.chehab@huawei.com, Mauro Carvalho Chehab , Bingbu Cao , Mauro Carvalho Chehab , Sakari Ailus , Tianshu Qiu , linux-kernel@vger.kernel.org Subject: [PATCH 3/9] media: docs: ipu3.rst: rely at automarkup extension Date: Wed, 30 Sep 2020 08:35:56 +0200 Message-Id: X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org There are several :c:type: definitions there, in order to do cross-references with the driver's documentation. Those are broken when docs are built with Sphinx 3.x, as it would require :c:struct: instead. For Sphinx < 3.x, the automarkup.py extension is able to do the replacement already, and a future improvement on it should make it also work with Sphinx 3.x. So, get rid of the usage of the :c:type: macro there. Signed-off-by: Mauro Carvalho Chehab Acked-by: Sakari Ailus --- Documentation/admin-guide/media/ipu3.rst | 38 ++++++++++++------------ 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/Documentation/admin-guide/media/ipu3.rst b/Documentation/admin-guide/media/ipu3.rst index a4cd489fc5dc..07d139bf8459 100644 --- a/Documentation/admin-guide/media/ipu3.rst +++ b/Documentation/admin-guide/media/ipu3.rst @@ -488,63 +488,63 @@ Name Description Optical Black Correction Optical Black Correction block subtracts a pre-defined value from the respective pixel values to obtain better image quality. - Defined in :c:type:`ipu3_uapi_obgrid_param`. + Defined in struct ipu3_uapi_obgrid_param. Linearization This algo block uses linearization parameters to address non-linearity sensor effects. The Lookup table table is defined in - :c:type:`ipu3_uapi_isp_lin_vmem_params`. + struct ipu3_uapi_isp_lin_vmem_params. SHD Lens shading correction is used to correct spatial non-uniformity of the pixel response due to optical lens shading. This is done by applying a different gain for each pixel. The gain, black level etc are - configured in :c:type:`ipu3_uapi_shd_config_static`. + configured in struct ipu3_uapi_shd_config_static. BNR Bayer noise reduction block removes image noise by applying a bilateral filter. - See :c:type:`ipu3_uapi_bnr_static_config` for details. + See struct ipu3_uapi_bnr_static_config for details. ANR Advanced Noise Reduction is a block based algorithm that performs noise reduction in the Bayer domain. The convolution matrix etc can be found in - :c:type:`ipu3_uapi_anr_config`. + struct ipu3_uapi_anr_config. DM Demosaicing converts raw sensor data in Bayer format into RGB (Red, Green, Blue) presentation. Then add outputs of estimation of Y channel for following stream processing by Firmware. The struct is defined as - :c:type:`ipu3_uapi_dm_config`. + struct ipu3_uapi_dm_config. Color Correction Color Correction algo transforms sensor specific color space to the standard "sRGB" color space. This is done by applying 3x3 matrix defined in - :c:type:`ipu3_uapi_ccm_mat_config`. -Gamma correction Gamma correction :c:type:`ipu3_uapi_gamma_config` is a + struct ipu3_uapi_ccm_mat_config. +Gamma correction Gamma correction struct ipu3_uapi_gamma_config is a basic non-linear tone mapping correction that is applied per pixel for each pixel component. CSC Color space conversion transforms each pixel from the RGB primary presentation to YUV (Y: brightness, UV: Luminance) presentation. This is done by applying a 3x3 matrix defined in - :c:type:`ipu3_uapi_csc_mat_config` + struct ipu3_uapi_csc_mat_config CDS Chroma down sampling After the CSC is performed, the Chroma Down Sampling is applied for a UV plane down sampling by a factor of 2 in each direction for YUV 4:2:0 using a 4x2 - configurable filter :c:type:`ipu3_uapi_cds_params`. + configurable filter struct ipu3_uapi_cds_params. CHNR Chroma noise reduction This block processes only the chrominance pixels and performs noise reduction by cleaning the high frequency noise. - See struct :c:type:`ipu3_uapi_yuvp1_chnr_config`. + See struct struct ipu3_uapi_yuvp1_chnr_config. TCC Total color correction as defined in struct - :c:type:`ipu3_uapi_yuvp2_tcc_static_config`. + struct ipu3_uapi_yuvp2_tcc_static_config. XNR3 eXtreme Noise Reduction V3 is the third revision of noise reduction algorithm used to improve image quality. This removes the low frequency noise in the captured image. Two related structs are being defined, - :c:type:`ipu3_uapi_isp_xnr3_params` for ISP data memory - and :c:type:`ipu3_uapi_isp_xnr3_vmem_params` for vector + struct ipu3_uapi_isp_xnr3_params for ISP data memory + and struct ipu3_uapi_isp_xnr3_vmem_params for vector memory. TNR Temporal Noise Reduction block compares successive frames in time to remove anomalies / noise in pixel - values. :c:type:`ipu3_uapi_isp_tnr3_vmem_params` and - :c:type:`ipu3_uapi_isp_tnr3_params` are defined for ISP + values. struct ipu3_uapi_isp_tnr3_vmem_params and + struct ipu3_uapi_isp_tnr3_params are defined for ISP vector and data memory respectively. ======================== ======================================================= @@ -576,9 +576,9 @@ processor, while many others will use a set of fixed hardware blocks also called accelerator cluster (ACC) to crunch pixel data and produce statistics. ACC parameters of individual algorithms, as defined by -:c:type:`ipu3_uapi_acc_param`, can be chosen to be applied by the user -space through struct :c:type:`ipu3_uapi_flags` embedded in -:c:type:`ipu3_uapi_params` structure. For parameters that are configured as +struct ipu3_uapi_acc_param, can be chosen to be applied by the user +space through struct struct ipu3_uapi_flags embedded in +struct ipu3_uapi_params structure. For parameters that are configured as not enabled by the user space, the corresponding structs are ignored by the driver, in which case the existing configuration of the algorithm will be preserved. From patchwork Wed Sep 30 06:35:58 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 255547 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.6 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, INCLUDES_PATCH, MAILING_LIST_MULTI, SIGNED_OFF_BY, SPF_HELO_NONE, SPF_PASS, USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 00924C2D0A8 for ; Wed, 30 Sep 2020 06:36:40 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id B8ADC207C3 for ; Wed, 30 Sep 2020 06:36:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601447799; bh=EtRGmIsfdSn+nJFr0PpwO5FfDqpexevAafV+Zei2Qsw=; h=From:To:Cc:Subject:Date:In-Reply-To:References:List-ID:From; b=lTBZzeLp9hSMRqVEYJ4vMJlMUlRHx2jk/kXrGswQRbZKbXRGoeWcsdBII6I5zM/jZ jRTglQ50aOv1ryonEXf5SVrFK+Kx+UCKWDxhLy/WgGhFCKTFL06Gyn1DjyShR8pLj6 qc43Qn1iokalz7ojj6gyLORHxV7GMD5GLFz6zTh8= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728318AbgI3Ggg (ORCPT ); Wed, 30 Sep 2020 02:36:36 -0400 Received: from mail.kernel.org ([198.145.29.99]:59312 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727886AbgI3GgH (ORCPT ); Wed, 30 Sep 2020 02:36:07 -0400 Received: from mail.kernel.org (ip5f5ad5c4.dynamic.kabel-deutschland.de [95.90.213.196]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 382BB2137B; Wed, 30 Sep 2020 06:36:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601447766; bh=EtRGmIsfdSn+nJFr0PpwO5FfDqpexevAafV+Zei2Qsw=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=UorkgwiC3ozsGrZ3lX4UFpXLv8GMx1obQf5xy9Zm6sWAPHS2X7rohTnEb745Z6zIU HyH+P8K01T8CnQ1fTvBhjmqUqXgye51ZO0O7Nk4b6gCPSwQ2kEQH38saZ/aL0uHJzh Lgy/QFdLkyyH4JTadoX8duYUq/z6j/1GqxrH8Ie8= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kNVid-001QmW-Uy; Wed, 30 Sep 2020 08:36:03 +0200 From: Mauro Carvalho Chehab To: Linux Media Mailing List Cc: linuxarm@huawei.com, mauro.chehab@huawei.com, Mauro Carvalho Chehab , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org Subject: [PATCH 5/9] media: v4l2-subdev.rst: get rid of a duplicatd kernel-doc markup Date: Wed, 30 Sep 2020 08:35:58 +0200 Message-Id: <7b5bf459111b3b6056864513e636157218134299.1601447236.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org There are two kernel-doc markups for include/media/v4l2-async.h, one at v4l2-async.rst and another one at v4l2-subdev.rst. Sphinx 3.x checks it and complains for duplicated symbols. So, get rid of one of them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/media/v4l2-subdev.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/Documentation/driver-api/media/v4l2-subdev.rst b/Documentation/driver-api/media/v4l2-subdev.rst index d3e0fd6652b0..6248ea99e979 100644 --- a/Documentation/driver-api/media/v4l2-subdev.rst +++ b/Documentation/driver-api/media/v4l2-subdev.rst @@ -495,5 +495,3 @@ V4L2 sub-device functions and data structures --------------------------------------------- .. kernel-doc:: include/media/v4l2-subdev.h - -.. kernel-doc:: include/media/v4l2-async.h From patchwork Wed Sep 30 06:36:01 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 255549 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.6 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, INCLUDES_PATCH, MAILING_LIST_MULTI, SIGNED_OFF_BY, SPF_HELO_NONE, SPF_PASS, USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id A4FC2C4727F for ; Wed, 30 Sep 2020 06:36:26 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 6A3212076A for ; Wed, 30 Sep 2020 06:36:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601447786; bh=6FbpSr2Z77TWm5cLFUNzD9WaCkeZQAoribfaCC5rs7k=; h=From:To:Cc:Subject:Date:In-Reply-To:References:List-ID:From; b=oBYSaQjkhbjkJtk7J0vT+pKCgkB1On2soU5/raCCcUQqWBKCScqBBbc9265LrQPuS Aybp3lCihUDB+c2/TheJwZNiVekJQEsr2u5UXusEDMzNILEoQI4OZ1Z15Il7KXt3nf Z6B9T3uM31o4ukLCWZ9Ts/SKQnL/u3cibbKKSevA= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728061AbgI3GgH (ORCPT ); Wed, 30 Sep 2020 02:36:07 -0400 Received: from mail.kernel.org ([198.145.29.99]:59276 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725535AbgI3GgH (ORCPT ); Wed, 30 Sep 2020 02:36:07 -0400 Received: from mail.kernel.org (ip5f5ad5c4.dynamic.kabel-deutschland.de [95.90.213.196]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 2588E2076E; Wed, 30 Sep 2020 06:36:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601447766; bh=6FbpSr2Z77TWm5cLFUNzD9WaCkeZQAoribfaCC5rs7k=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Bp9trC2EldsrjLmG8826svFiTOuqV1aI2s4j0YBISifgOfwP37FIItroj3Yx4TUkJ bxb4oMg32dG9jC7ARMa7tifr7xdw5VToYmoQg0ogBBSRQ+KTOQn1GRezfR4KP44eOT /eQyq1V4MeeeKD9bwUfj+3SFJCnDjL0tSyTOBqLg= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kNVie-001Qme-1c; Wed, 30 Sep 2020 08:36:04 +0200 From: Mauro Carvalho Chehab To: Linux Media Mailing List Cc: linuxarm@huawei.com, mauro.chehab@huawei.com, Mauro Carvalho Chehab , Hans Verkuil , Mauro Carvalho Chehab , Randy Dunlap , linux-kernel@vger.kernel.org Subject: [PATCH 8/9] media: hist-v4l2.rst: remove struct duplication Date: Wed, 30 Sep 2020 08:36:01 +0200 Message-Id: <6ca487190fafa23f4ab53935a9c6d0fcde9f95d2.1601447236.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org There are several places there where struct was used twice, on multiple lines, like: struct struct ``v4l2_zoomcap`` That's probably done during the DocBook to ReSt conversion. Probably the cases where "struct struct" were at the same line was addressed back then, but the multi-line cases are still there. Get rid of them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/userspace-api/media/v4l/hist-v4l2.rst | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/Documentation/userspace-api/media/v4l/hist-v4l2.rst b/Documentation/userspace-api/media/v4l/hist-v4l2.rst index 8be82bdb1729..fe60cb9e2e07 100644 --- a/Documentation/userspace-api/media/v4l/hist-v4l2.rst +++ b/Documentation/userspace-api/media/v4l/hist-v4l2.rst @@ -582,11 +582,10 @@ This unnamed version was finally merged into Linux 2.5.46. above. A ``field`` field of type :c:type:`v4l2_field` was added to distinguish between field and frame (interlaced) overlay. -17. The digital zoom interface, including struct - struct ``v4l2_zoomcap``, struct +17. The digital zoom interface, including struct ``v4l2_zoomcap``, struct ``v4l2_zoom``, ``V4L2_ZOOM_NONCAP`` and ``V4L2_ZOOM_WHILESTREAMING`` was replaced by a new cropping and - scaling interface. The previously unused struct + scaling interface. The previously unused struct :c:type:`v4l2_cropcap` and struct :c:type:`v4l2_crop` where redefined for this purpose. See :ref:`crop` for details. @@ -811,7 +810,7 @@ V4L2 spec erratum 2006-02-04 1. The ``clips`` field in struct :c:type:`v4l2_window` must point to an array of struct :c:type:`v4l2_clip`, not - a linked list, because drivers ignore the struct + a linked list, because drivers ignore the struct :c:type:`v4l2_clip`. ``next`` pointer. @@ -926,7 +925,7 @@ V4L2 in Linux 2.6.22 A new ``global_alpha`` field was added to :c:type:`v4l2_window`, extending the structure. This - may *break compatibility* with applications using a struct + may *break compatibility* with applications using a struct :c:type:`v4l2_window` directly. However the :ref:`VIDIOC_G/S/TRY_FMT ` ioctls, which take a pointer to a :c:type:`v4l2_format` parent structure @@ -1013,8 +1012,7 @@ V4L2 in Linux 2.6.29 1. The ``VIDIOC_G_CHIP_IDENT`` ioctl was renamed to ``VIDIOC_G_CHIP_IDENT_OLD`` and ``VIDIOC_DBG_G_CHIP_IDENT`` was - introduced in its place. The old struct - struct ``v4l2_chip_ident`` was renamed to + introduced in its place. The old struct ``v4l2_chip_ident`` was renamed to struct ``v4l2_chip_ident_old``. 2. The pixel formats ``V4L2_PIX_FMT_VYUY``, ``V4L2_PIX_FMT_NV16`` and