* Re: [PATCH 2/3] media: rzg2l-cru: Remove unused kerneldoc description
2026-06-10 16:20 ` [PATCH 2/3] media: rzg2l-cru: " Ricardo Ribalda
@ 2026-06-10 16:22 ` Dan Scally
2026-06-10 16:30 ` Jacopo Mondi
` (2 subsequent siblings)
3 siblings, 0 replies; 16+ messages in thread
From: Dan Scally @ 2026-06-10 16:22 UTC (permalink / raw)
To: Ricardo Ribalda, Dave Stevenson, Sakari Ailus,
Mauro Carvalho Chehab, Xiaolei Wang, Tarang Raval, Lad Prabhakar,
Jacopo Mondi, Hans Verkuil, Laurent Pinchart
Cc: Mauro Carvalho Chehab, linux-media, linux-kernel, Jacopo Mondi,
linux-renesas-soc
Hi Ricardo - thanks for the patch
On 10/06/2026 17:20, Ricardo Ribalda wrote:
> The variable has been previously removed but not its kerneldoc.
>
> Also remove the leftover reference to state in the description of qlock.
>
> This patch fixes the following warning:
>
> Warning: drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h:164
> Excess struct member 'state' description in 'rzg2l_cru_dev'
>
> Fixes: 85d8820d4869 ("media: rzg2l-cru: Remove the 'state' variable")
> Signed-off-by: Ricardo Ribalda <ribalda@chromium.org>
> ---
Reviewed-by: Daniel Scally <dan.scally@ideasonboard.com>
> drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h | 2 --
> 1 file changed, 2 deletions(-)
>
> diff --git a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> index 5bf334e173d2..b426bc7898bf 100644
> --- a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> +++ b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> @@ -116,11 +116,9 @@ struct rzg2l_cru_info {
> * @scratch_phys: physical address of the scratch buffer
> *
> * @qlock: protects @queue_buf, @buf_list, @sequence
> - * @state
> * @queue_buf: Keeps track of buffers given to HW slot
> * @buf_list: list of queued buffers
> * @sequence: V4L2 buffers sequence number
> - * @state: keeps track of operation state
> *
> * @format: active V4L2 pixel format
> */
>
^ permalink raw reply [flat|nested] 16+ messages in thread* Re: [PATCH 2/3] media: rzg2l-cru: Remove unused kerneldoc description
2026-06-10 16:20 ` [PATCH 2/3] media: rzg2l-cru: " Ricardo Ribalda
2026-06-10 16:22 ` Dan Scally
@ 2026-06-10 16:30 ` Jacopo Mondi
2026-06-10 16:35 ` Ricardo Ribalda
2026-06-10 20:21 ` Laurent Pinchart
2026-06-16 9:15 ` Lad, Prabhakar
3 siblings, 1 reply; 16+ messages in thread
From: Jacopo Mondi @ 2026-06-10 16:30 UTC (permalink / raw)
To: Ricardo Ribalda
Cc: Dave Stevenson, Sakari Ailus, Mauro Carvalho Chehab,
Xiaolei Wang, Tarang Raval, Lad Prabhakar, Jacopo Mondi,
Daniel Scally, Hans Verkuil, Laurent Pinchart,
Mauro Carvalho Chehab, linux-media, linux-kernel, Jacopo Mondi,
linux-renesas-soc
Hi Ricardo
On Wed, Jun 10, 2026 at 04:20:07PM +0000, Ricardo Ribalda wrote:
> The variable has been previously removed but not its kerneldoc.
>
> Also remove the leftover reference to state in the description of qlock.
>
> This patch fixes the following warning:
>
> Warning: drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h:164
> Excess struct member 'state' description in 'rzg2l_cru_dev'
upsie
indeed!
>
> Fixes: 85d8820d4869 ("media: rzg2l-cru: Remove the 'state' variable")
My only question is if this qualifies for stable or not...
Honestly, I would drop the Fixes tag here
> Signed-off-by: Ricardo Ribalda <ribalda@chromium.org>
Reviewed-by: Jacopo Mondi <jacopo.mondi@ideasonboard.com>
> ---
> drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h | 2 --
> 1 file changed, 2 deletions(-)
>
> diff --git a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> index 5bf334e173d2..b426bc7898bf 100644
> --- a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> +++ b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> @@ -116,11 +116,9 @@ struct rzg2l_cru_info {
> * @scratch_phys: physical address of the scratch buffer
> *
> * @qlock: protects @queue_buf, @buf_list, @sequence
> - * @state
> * @queue_buf: Keeps track of buffers given to HW slot
> * @buf_list: list of queued buffers
> * @sequence: V4L2 buffers sequence number
> - * @state: keeps track of operation state
> *
> * @format: active V4L2 pixel format
> */
>
> --
> 2.54.0.1099.g489fc7bff1-goog
>
^ permalink raw reply [flat|nested] 16+ messages in thread* Re: [PATCH 2/3] media: rzg2l-cru: Remove unused kerneldoc description
2026-06-10 16:30 ` Jacopo Mondi
@ 2026-06-10 16:35 ` Ricardo Ribalda
2026-06-10 16:47 ` Jacopo Mondi
0 siblings, 1 reply; 16+ messages in thread
From: Ricardo Ribalda @ 2026-06-10 16:35 UTC (permalink / raw)
To: Jacopo Mondi
Cc: Dave Stevenson, Sakari Ailus, Mauro Carvalho Chehab,
Xiaolei Wang, Tarang Raval, Lad Prabhakar, Daniel Scally,
Hans Verkuil, Laurent Pinchart, Mauro Carvalho Chehab,
linux-media, linux-kernel, Jacopo Mondi, linux-renesas-soc
Hi Jacopo
On Wed, 10 Jun 2026 at 18:30, Jacopo Mondi
<jacopo.mondi@ideasonboard.com> wrote:
>
> Hi Ricardo
>
> On Wed, Jun 10, 2026 at 04:20:07PM +0000, Ricardo Ribalda wrote:
> > The variable has been previously removed but not its kerneldoc.
> >
> > Also remove the leftover reference to state in the description of qlock.
> >
> > This patch fixes the following warning:
> >
> > Warning: drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h:164
> > Excess struct member 'state' description in 'rzg2l_cru_dev'
>
> upsie
>
> indeed!
>
> >
> > Fixes: 85d8820d4869 ("media: rzg2l-cru: Remove the 'state' variable")
>
> My only question is if this qualifies for stable or not...
> Honestly, I would drop the Fixes tag here
Yeah, I am not even sure myself
On one hand, it might help other CIs down there have cleaner logs, it
is very low risk, and I doubt that it will have any conflicts.
On the other, what real user will benefit from this backport?
I wrote in the cover that this can be dropped. I'd let more clever
people decide :P
>
> > Signed-off-by: Ricardo Ribalda <ribalda@chromium.org>
>
> Reviewed-by: Jacopo Mondi <jacopo.mondi@ideasonboard.com>
>
> > ---
> > drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h | 2 --
> > 1 file changed, 2 deletions(-)
> >
> > diff --git a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> > index 5bf334e173d2..b426bc7898bf 100644
> > --- a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> > +++ b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> > @@ -116,11 +116,9 @@ struct rzg2l_cru_info {
> > * @scratch_phys: physical address of the scratch buffer
> > *
> > * @qlock: protects @queue_buf, @buf_list, @sequence
> > - * @state
> > * @queue_buf: Keeps track of buffers given to HW slot
> > * @buf_list: list of queued buffers
> > * @sequence: V4L2 buffers sequence number
> > - * @state: keeps track of operation state
> > *
> > * @format: active V4L2 pixel format
> > */
> >
> > --
> > 2.54.0.1099.g489fc7bff1-goog
> >
--
Ricardo Ribalda
^ permalink raw reply [flat|nested] 16+ messages in thread* Re: [PATCH 2/3] media: rzg2l-cru: Remove unused kerneldoc description
2026-06-10 16:35 ` Ricardo Ribalda
@ 2026-06-10 16:47 ` Jacopo Mondi
0 siblings, 0 replies; 16+ messages in thread
From: Jacopo Mondi @ 2026-06-10 16:47 UTC (permalink / raw)
To: Ricardo Ribalda
Cc: Jacopo Mondi, Dave Stevenson, Sakari Ailus,
Mauro Carvalho Chehab, Xiaolei Wang, Tarang Raval, Lad Prabhakar,
Daniel Scally, Hans Verkuil, Laurent Pinchart,
Mauro Carvalho Chehab, linux-media, linux-kernel, Jacopo Mondi,
linux-renesas-soc
On Wed, Jun 10, 2026 at 06:35:36PM +0200, Ricardo Ribalda wrote:
> Hi Jacopo
>
> On Wed, 10 Jun 2026 at 18:30, Jacopo Mondi
> <jacopo.mondi@ideasonboard.com> wrote:
> >
> > Hi Ricardo
> >
> > On Wed, Jun 10, 2026 at 04:20:07PM +0000, Ricardo Ribalda wrote:
> > > The variable has been previously removed but not its kerneldoc.
> > >
> > > Also remove the leftover reference to state in the description of qlock.
> > >
> > > This patch fixes the following warning:
> > >
> > > Warning: drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h:164
> > > Excess struct member 'state' description in 'rzg2l_cru_dev'
> >
> > upsie
> >
> > indeed!
> >
> > >
> > > Fixes: 85d8820d4869 ("media: rzg2l-cru: Remove the 'state' variable")
> >
> > My only question is if this qualifies for stable or not...
> > Honestly, I would drop the Fixes tag here
>
> Yeah, I am not even sure myself
>
> On one hand, it might help other CIs down there have cleaner logs, it
> is very low risk, and I doubt that it will have any conflicts.
> On the other, what real user will benefit from this backport?
>
> I wrote in the cover that this can be dropped. I'd let more clever
> people decide :P
>
From Documentation/process/stable-kernel-rules.rst:
- It must either fix a real bug that bothers people or just add a device ID.
To elaborate on the former:
- It fixes a problem like an oops, a hang, data corruption, a real security
issue, a hardware quirk, a build error (but not for things marked
CONFIG_BROKEN), or some "oh, that's not good" issue.
- Serious issues as reported by a user of a distribution kernel may also
be considered if they fix a notable performance or interactivity issue.
As these fixes are not as obvious and have a higher risk of a subtle
regression they should only be submitted by a distribution kernel
maintainer and include an addendum linking to a bugzilla entry if it
exists and additional information on the user-visible impact.
- No "This could be a problem..." type of things like a "theoretical race
condition", unless an explanation of how the bug can be exploited is also
provided.
- No "trivial" fixes without benefit for users (spelling changes, whitespace
cleanups, etc).
Are Documentation warnings considered "build errors" ?
> >
> > > Signed-off-by: Ricardo Ribalda <ribalda@chromium.org>
> >
> > Reviewed-by: Jacopo Mondi <jacopo.mondi@ideasonboard.com>
> >
> > > ---
> > > drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h | 2 --
> > > 1 file changed, 2 deletions(-)
> > >
> > > diff --git a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> > > index 5bf334e173d2..b426bc7898bf 100644
> > > --- a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> > > +++ b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> > > @@ -116,11 +116,9 @@ struct rzg2l_cru_info {
> > > * @scratch_phys: physical address of the scratch buffer
> > > *
> > > * @qlock: protects @queue_buf, @buf_list, @sequence
> > > - * @state
> > > * @queue_buf: Keeps track of buffers given to HW slot
> > > * @buf_list: list of queued buffers
> > > * @sequence: V4L2 buffers sequence number
> > > - * @state: keeps track of operation state
> > > *
> > > * @format: active V4L2 pixel format
> > > */
> > >
> > > --
> > > 2.54.0.1099.g489fc7bff1-goog
> > >
>
>
>
> --
> Ricardo Ribalda
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 2/3] media: rzg2l-cru: Remove unused kerneldoc description
2026-06-10 16:20 ` [PATCH 2/3] media: rzg2l-cru: " Ricardo Ribalda
2026-06-10 16:22 ` Dan Scally
2026-06-10 16:30 ` Jacopo Mondi
@ 2026-06-10 20:21 ` Laurent Pinchart
2026-06-10 22:14 ` Ricardo Ribalda
2026-06-16 9:15 ` Lad, Prabhakar
3 siblings, 1 reply; 16+ messages in thread
From: Laurent Pinchart @ 2026-06-10 20:21 UTC (permalink / raw)
To: Ricardo Ribalda
Cc: Dave Stevenson, Sakari Ailus, Mauro Carvalho Chehab,
Xiaolei Wang, Tarang Raval, Lad Prabhakar, Jacopo Mondi,
Daniel Scally, Hans Verkuil, Mauro Carvalho Chehab, linux-media,
linux-kernel, Jacopo Mondi, linux-renesas-soc
On Wed, Jun 10, 2026 at 04:20:07PM +0000, Ricardo Ribalda wrote:
> The variable has been previously removed but not its kerneldoc.
>
> Also remove the leftover reference to state in the description of qlock.
>
> This patch fixes the following warning:
>
> Warning: drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h:164
> Excess struct member 'state' description in 'rzg2l_cru_dev'
>
> Fixes: 85d8820d4869 ("media: rzg2l-cru: Remove the 'state' variable")
Does it mean that this patch was merged without going through CI ? Is
there something we need to improve in the process ?
> Signed-off-by: Ricardo Ribalda <ribalda@chromium.org>
Reviewed-by: Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
> ---
> drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h | 2 --
> 1 file changed, 2 deletions(-)
>
> diff --git a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> index 5bf334e173d2..b426bc7898bf 100644
> --- a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> +++ b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> @@ -116,11 +116,9 @@ struct rzg2l_cru_info {
> * @scratch_phys: physical address of the scratch buffer
> *
> * @qlock: protects @queue_buf, @buf_list, @sequence
> - * @state
> * @queue_buf: Keeps track of buffers given to HW slot
> * @buf_list: list of queued buffers
> * @sequence: V4L2 buffers sequence number
> - * @state: keeps track of operation state
> *
> * @format: active V4L2 pixel format
> */
>
--
Regards,
Laurent Pinchart
^ permalink raw reply [flat|nested] 16+ messages in thread* Re: [PATCH 2/3] media: rzg2l-cru: Remove unused kerneldoc description
2026-06-10 20:21 ` Laurent Pinchart
@ 2026-06-10 22:14 ` Ricardo Ribalda
0 siblings, 0 replies; 16+ messages in thread
From: Ricardo Ribalda @ 2026-06-10 22:14 UTC (permalink / raw)
To: Laurent Pinchart
Cc: Dave Stevenson, Sakari Ailus, Mauro Carvalho Chehab,
Xiaolei Wang, Tarang Raval, Lad Prabhakar, Jacopo Mondi,
Daniel Scally, Hans Verkuil, Mauro Carvalho Chehab, linux-media,
linux-kernel, Jacopo Mondi, linux-renesas-soc
Hi Laurent
On Wed, 10 Jun 2026 at 22:21, Laurent Pinchart
<laurent.pinchart@ideasonboard.com> wrote:
>
> On Wed, Jun 10, 2026 at 04:20:07PM +0000, Ricardo Ribalda wrote:
> > The variable has been previously removed but not its kerneldoc.
> >
> > Also remove the leftover reference to state in the description of qlock.
> >
> > This patch fixes the following warning:
> >
> > Warning: drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h:164
> > Excess struct member 'state' description in 'rzg2l_cru_dev'
> >
> > Fixes: 85d8820d4869 ("media: rzg2l-cru: Remove the 'state' variable")
>
> Does it mean that this patch was merged without going through CI ? Is
> there something we need to improve in the process ?
Something has changed in the kenel-doc script. If you run this in
media-commiters/next:
scripts/kernel-doc -none -Wall
drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
There is no error.
>
> > Signed-off-by: Ricardo Ribalda <ribalda@chromium.org>
>
> Reviewed-by: Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
>
> > ---
> > drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h | 2 --
> > 1 file changed, 2 deletions(-)
> >
> > diff --git a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> > index 5bf334e173d2..b426bc7898bf 100644
> > --- a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> > +++ b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> > @@ -116,11 +116,9 @@ struct rzg2l_cru_info {
> > * @scratch_phys: physical address of the scratch buffer
> > *
> > * @qlock: protects @queue_buf, @buf_list, @sequence
> > - * @state
> > * @queue_buf: Keeps track of buffers given to HW slot
> > * @buf_list: list of queued buffers
> > * @sequence: V4L2 buffers sequence number
> > - * @state: keeps track of operation state
> > *
> > * @format: active V4L2 pixel format
> > */
> >
>
> --
> Regards,
>
> Laurent Pinchart
--
Ricardo Ribalda
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 2/3] media: rzg2l-cru: Remove unused kerneldoc description
2026-06-10 16:20 ` [PATCH 2/3] media: rzg2l-cru: " Ricardo Ribalda
` (2 preceding siblings ...)
2026-06-10 20:21 ` Laurent Pinchart
@ 2026-06-16 9:15 ` Lad, Prabhakar
3 siblings, 0 replies; 16+ messages in thread
From: Lad, Prabhakar @ 2026-06-16 9:15 UTC (permalink / raw)
To: Ricardo Ribalda
Cc: Dave Stevenson, Sakari Ailus, Mauro Carvalho Chehab,
Xiaolei Wang, Tarang Raval, Lad Prabhakar, Jacopo Mondi,
Daniel Scally, Hans Verkuil, Laurent Pinchart,
Mauro Carvalho Chehab, linux-media, linux-kernel, Jacopo Mondi,
linux-renesas-soc
On Wed, Jun 10, 2026 at 5:28 PM Ricardo Ribalda <ribalda@chromium.org> wrote:
>
> The variable has been previously removed but not its kerneldoc.
>
> Also remove the leftover reference to state in the description of qlock.
>
> This patch fixes the following warning:
>
> Warning: drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h:164
> Excess struct member 'state' description in 'rzg2l_cru_dev'
>
> Fixes: 85d8820d4869 ("media: rzg2l-cru: Remove the 'state' variable")
> Signed-off-by: Ricardo Ribalda <ribalda@chromium.org>
> ---
> drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h | 2 --
> 1 file changed, 2 deletions(-)
>
Reviewed-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
Cheers,
Prabhakar
> diff --git a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> index 5bf334e173d2..b426bc7898bf 100644
> --- a/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> +++ b/drivers/media/platform/renesas/rzg2l-cru/rzg2l-cru.h
> @@ -116,11 +116,9 @@ struct rzg2l_cru_info {
> * @scratch_phys: physical address of the scratch buffer
> *
> * @qlock: protects @queue_buf, @buf_list, @sequence
> - * @state
> * @queue_buf: Keeps track of buffers given to HW slot
> * @buf_list: list of queued buffers
> * @sequence: V4L2 buffers sequence number
> - * @state: keeps track of operation state
> *
> * @format: active V4L2 pixel format
> */
>
> --
> 2.54.0.1099.g489fc7bff1-goog
>
>
^ permalink raw reply [flat|nested] 16+ messages in thread