[PATCH v2] media: dt-bindings: renesas,rzg2l-cru: Improve documentation

[PATCH v2] media: dt-bindings: renesas,rzg2l-cru: Improve documentation

[Biju]

From: Biju Das <biju.das.jz@bp.renesas.com>

Drop CRU prefix from clocks and interrupts description.

Signed-off-by: Biju Das <biju.das.jz@bp.renesas.com>
---
Ref: https://lore.kernel.org/all/20240909143358.GA2013-robh@kernel.org/
v1->v2:
 * Updated commit description
 * Dropped CRU prefixes from clocks and interrupts description.
---
 .../bindings/media/renesas,rzg2l-cru.yaml     | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/Documentation/devicetree/bindings/media/renesas,rzg2l-cru.yaml b/Documentation/devicetree/bindings/media/renesas,rzg2l-cru.yaml
index 47e18690fa57..0a57b9d15318 100644
--- a/Documentation/devicetree/bindings/media/renesas,rzg2l-cru.yaml
+++ b/Documentation/devicetree/bindings/media/renesas,rzg2l-cru.yaml
@@ -32,15 +32,15 @@ properties:
   interrupts:
     oneOf:
       - items:
-          - description: CRU Interrupt for image_conv
-          - description: CRU Interrupt for image_conv_err
-          - description: CRU AXI master error interrupt
+          - description: Interrupt for image_conv
+          - description: Interrupt for image_conv_err
+          - description: AXI master error interrupt
       - items:
-          - description: CRU Interrupt for image_conv
-          - description: CRU AXI master error interrupt
-          - description: CRU Video Data AXI Master Address 0 Write End interrupt
-          - description: CRU Statistics data AXI master addr 0 write end interrupt
-          - description: CRU Video statistics data AXI master addr 0 write end interrupt
+          - description: Interrupt for image_conv
+          - description: AXI master error interrupt
+          - description: Video Data AXI Master Address 0 Write End interrupt
+          - description: Statistics data AXI master addr 0 write end interrupt
+          - description: Video statistics data AXI master addr 0 write end interrupt
 
   interrupt-names:
     oneOf:
@@ -57,9 +57,9 @@ properties:
 
   clocks:
     items:
-      - description: CRU Main clock
-      - description: CRU Register access clock
-      - description: CRU image transfer clock
+      - description: Main clock
+      - description: Register access clock
+      - description: Image transfer clock
 
   clock-names:
     items:
-- 
2.43.0

Re: [PATCH v2] media: dt-bindings: renesas,rzg2l-cru: Improve documentation

[Lad, Prabhakar]

On Tue, Aug 19, 2025 at 8:49 AM Biju <biju.das.au@gmail.com> wrote:
>
> From: Biju Das <biju.das.jz@bp.renesas.com>
>
> Drop CRU prefix from clocks and interrupts description.
>
> Signed-off-by: Biju Das <biju.das.jz@bp.renesas.com>
> ---
> Ref: https://lore.kernel.org/all/20240909143358.GA2013-robh@kernel.org/
> v1->v2:
>  * Updated commit description
>  * Dropped CRU prefixes from clocks and interrupts description.
> ---
>  .../bindings/media/renesas,rzg2l-cru.yaml     | 22 +++++++++----------
>  1 file changed, 11 insertions(+), 11 deletions(-)
>
Reviewed-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>

Cheers,
Prabhakar

> diff --git a/Documentation/devicetree/bindings/media/renesas,rzg2l-cru.yaml b/Documentation/devicetree/bindings/media/renesas,rzg2l-cru.yaml
> index 47e18690fa57..0a57b9d15318 100644
> --- a/Documentation/devicetree/bindings/media/renesas,rzg2l-cru.yaml
> +++ b/Documentation/devicetree/bindings/media/renesas,rzg2l-cru.yaml
> @@ -32,15 +32,15 @@ properties:
>    interrupts:
>      oneOf:
>        - items:
> -          - description: CRU Interrupt for image_conv
> -          - description: CRU Interrupt for image_conv_err
> -          - description: CRU AXI master error interrupt
> +          - description: Interrupt for image_conv
> +          - description: Interrupt for image_conv_err
> +          - description: AXI master error interrupt
>        - items:
> -          - description: CRU Interrupt for image_conv
> -          - description: CRU AXI master error interrupt
> -          - description: CRU Video Data AXI Master Address 0 Write End interrupt
> -          - description: CRU Statistics data AXI master addr 0 write end interrupt
> -          - description: CRU Video statistics data AXI master addr 0 write end interrupt
> +          - description: Interrupt for image_conv
> +          - description: AXI master error interrupt
> +          - description: Video Data AXI Master Address 0 Write End interrupt
> +          - description: Statistics data AXI master addr 0 write end interrupt
> +          - description: Video statistics data AXI master addr 0 write end interrupt
>
>    interrupt-names:
>      oneOf:
> @@ -57,9 +57,9 @@ properties:
>
>    clocks:
>      items:
> -      - description: CRU Main clock
> -      - description: CRU Register access clock
> -      - description: CRU image transfer clock
> +      - description: Main clock
> +      - description: Register access clock
> +      - description: Image transfer clock
>
>    clock-names:
>      items:
> --
> 2.43.0
>
>

Re: [PATCH v2] media: dt-bindings: renesas,rzg2l-cru: Improve documentation

[Rob Herring (Arm)]

On Tue, 19 Aug 2025 08:48:42 +0100, Biju wrote:
> From: Biju Das <biju.das.jz@bp.renesas.com>
> 
> Drop CRU prefix from clocks and interrupts description.
> 
> Signed-off-by: Biju Das <biju.das.jz@bp.renesas.com>
> ---
> Ref: https://lore.kernel.org/all/20240909143358.GA2013-robh@kernel.org/
> v1->v2:
>  * Updated commit description
>  * Dropped CRU prefixes from clocks and interrupts description.
> ---
>  .../bindings/media/renesas,rzg2l-cru.yaml     | 22 +++++++++----------
>  1 file changed, 11 insertions(+), 11 deletions(-)
> 

My bot found errors running 'make dt_binding_check' on your patch:

yamllint warnings/errors:

dtschema/dtc warnings/errors:


doc reference errors (make refcheckdocs):

See https://patchwork.ozlabs.org/project/devicetree-bindings/patch/20250819074849.18696-1-biju.das.jz@bp.renesas.com

The base for the series is generally the latest rc1. A different dependency
should be noted in *this* patch.

If you already ran 'make dt_binding_check' and didn't see the above
error(s), then make sure 'yamllint' is installed and dt-schema is up to
date:

pip3 install dtschema --upgrade

Please check and re-submit after running the above command yourself. Note
that DT_SCHEMA_FILES can be set to your schema file to speed up checking
your schema. However, it must be unset to test all examples with your schema.

Re: [PATCH v2] media: dt-bindings: renesas,rzg2l-cru: Improve documentation

[Rob Herring (Arm)]

On Tue, 19 Aug 2025 08:48:42 +0100, Biju wrote:
> From: Biju Das <biju.das.jz@bp.renesas.com>
> 
> Drop CRU prefix from clocks and interrupts description.
> 
> Signed-off-by: Biju Das <biju.das.jz@bp.renesas.com>
> ---
> Ref: https://lore.kernel.org/all/20240909143358.GA2013-robh@kernel.org/
> v1->v2:
>  * Updated commit description
>  * Dropped CRU prefixes from clocks and interrupts description.
> ---
>  .../bindings/media/renesas,rzg2l-cru.yaml     | 22 +++++++++----------
>  1 file changed, 11 insertions(+), 11 deletions(-)
> 

Acked-by: Rob Herring (Arm) <robh@kernel.org>