linux-kernel - RE: [PATCH 1/3] media: ipu3.rst: Prune unreferenced footnotes

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <DM8PR11MB56534969F9891ECC31C4681799E02@DM8PR11MB5653.namprd11.prod.outlook.com>
Date: Thu, 23 Jan 2025 03:55:38 +0000
From: "Cao, Bingbu" <bingbu.cao@...el.com>
To: Bagas Sanjaya <bagasdotme@...il.com>, Linux Media
	<linux-media@...r.kernel.org>, Linux Kernel Mailing List
	<linux-kernel@...r.kernel.org>, Linux Block Devices
	<linux-block@...r.kernel.org>, Linux Documentation
	<linux-doc@...r.kernel.org>, Linux Power Management
	<linux-pm@...r.kernel.org>
CC: Sakari Ailus <sakari.ailus@...ux.intel.com>, "Qiu, Tian Shu"
	<tian.shu.qiu@...el.com>, Mauro Carvalho Chehab <mchehab@...nel.org>, "Ming
 Lei" <ming.lei@...hat.com>, Jens Axboe <axboe@...nel.dk>, Jonathan Corbet
	<corbet@....net>, "Rafael J. Wysocki" <rafael@...nel.org>, "Brown, Len"
	<len.brown@...el.com>, Pavel Machek <pavel@....cz>, Rajmohan Mani
	<rajmohan.mani@...el.com>
Subject: RE: [PATCH 1/3] media: ipu3.rst: Prune unreferenced footnotes

Reviewed-by: Bingbu Cao <bingbu.cao@...el.com>

>-----Original Message-----
>From: Bagas Sanjaya <bagasdotme@...il.com>
>Sent: Wednesday, January 22, 2025 10:35 PM
>To: Linux Media <linux-media@...r.kernel.org>; Linux Kernel Mailing
>List <linux-kernel@...r.kernel.org>; Linux Block Devices <linux-
>block@...r.kernel.org>; Linux Documentation <linux-doc@...r.kernel.org>;
>Linux Power Management <linux-pm@...r.kernel.org>
>Cc: Sakari Ailus <sakari.ailus@...ux.intel.com>; Cao, Bingbu
><bingbu.cao@...el.com>; Qiu, Tian Shu <tian.shu.qiu@...el.com>; Mauro
>Carvalho Chehab <mchehab@...nel.org>; Ming Lei <ming.lei@...hat.com>;
>Jens Axboe <axboe@...nel.dk>; Jonathan Corbet <corbet@....net>; Rafael
>J. Wysocki <rafael@...nel.org>; Brown, Len <len.brown@...el.com>; Pavel
>Machek <pavel@....cz>; Bagas Sanjaya <bagasdotme@...il.com>; Rajmohan
>Mani <rajmohan.mani@...el.com>
>Subject: [PATCH 1/3] media: ipu3.rst: Prune unreferenced footnotes
>
>Sphinx reports unreferenced footnotes warning on ipu3 docs:
>
>Documentation/admin-guide/media/ipu3.rst:592: WARNING: Footnote [#] is
>not referenced. [ref.footnote]
>Documentation/admin-guide/media/ipu3.rst:598: WARNING: Footnote [#] is
>not referenced. [ref.footnote]
>
>Fix above warnings by pruning unreferenced footnote to intel_ipu3.h
>UAPI header (already referenced in its full path in "Running mode and
>firmware binary selection") and by directly link to v4l-utils repo in
>ov5670 configuration example with media-ctl (since the example is in
>literal code block).
>
>Footnote numbers are unchanged.
>
>Cc: Rajmohan Mani <rajmohan.mani@...el.com>
>Fixes: dc794d3d2424 ("media: staging: ipu3-imgu: Move the UAPI header
>from include under include/uapi")
>Fixes: 34fc0e1bf892 ("media: doc-rst: Add Intel IPU3 documentation")
>Signed-off-by: Bagas Sanjaya <bagasdotme@...il.com>
>---
> Documentation/admin-guide/media/ipu3.rst | 7 ++-----
> 1 file changed, 2 insertions(+), 5 deletions(-)
>
>diff --git a/Documentation/admin-guide/media/ipu3.rst
>b/Documentation/admin-guide/media/ipu3.rst
>index 83b3cd03b35c36..3a8c3d46304b7d 100644
>--- a/Documentation/admin-guide/media/ipu3.rst
>+++ b/Documentation/admin-guide/media/ipu3.rst
>@@ -98,7 +98,8 @@ frames in packed raw Bayer format to IPU3 CSI2
>receiver.
>     # and that ov5670 sensor is connected to i2c bus 10 with address
>0x36
>     export SDEV=$(media-ctl -d $MDEV -e "ov5670 10-0036")
>
>-    # Establish the link for the media devices using media-ctl [#f3]_
>+    # Establish the link for the media devices using media-ctl
>+    # (from https://git.linuxtv.org/v4l-utils.git)
>     media-ctl -d $MDEV -l "ov5670:0 -> ipu3-csi2 0:0[1]"
>
>     # Set the format for the media devices @@ -589,12 +590,8 @@
>preserved.
> References
> ==========
>
>-.. [#f5] drivers/staging/media/ipu3/include/uapi/intel-ipu3.h
>-
> .. [#f1] https://github.com/intel/nvt
>
> .. [#f2] http://git.ideasonboard.org/yavta.git
>
>-.. [#f3] http://git.ideasonboard.org/?p=media-ctl.git;a=summary
>-
> .. [#f4] ImgU limitation requires an additional 16x16 for all input
>resolutions
>--
>An old man doll... just what I always wanted! - Clara