Re: [PATCH] dt-bindings: mtd: mxc-nand: Drop undocumented properties from example

From: Uwe Kleine-König
Date: Fri May 27 2022 - 05:57:27 EST


On Wed, May 25, 2022 at 03:59:46PM -0500, Rob Herring wrote:
> With unevaluatedProperties issues fixed, 'nand-bus-width' and
> 'nand-ecc-mode' are flagged as undocumented. Removing them from the example
> is the easiest solution to silence the warnings.

It's not clear to me, what has to be done to see this warning. Can you
tell me how to reproduce?

My current WIP patch is:

diff --git a/Documentation/devicetree/bindings/mtd/mxc-nand.yaml b/Documentation/devicetree/bindings/mtd/mxc-nand.yaml
index 73b86f2226c7..6e3e346e4448 100644
--- a/Documentation/devicetree/bindings/mtd/mxc-nand.yaml
+++ b/Documentation/devicetree/bindings/mtd/mxc-nand.yaml
@@ -14,7 +14,18 @@ allOf:

properties:
compatible:
- const: fsl,imx27-nand
+ oneOf:
+ - const: fsl,imx21-nand
+ - const: fsl,imx25-nand
+ - const: fsl,imx27-nand
+ - items:
+ - const: fsl,imx31-nand
+ - const: fsl,imx27-nand
+ - items:
+ - const: fsl,imx35-nand
+ - const: fsl,imx27-nand
+ - const: fsl,imx51-nand
+ - const: fsl,imx53-nand

reg:
maxItems: 1

which I think is right, but obviously doesn't fix the problem you
pointed out :-)

> Signed-off-by: Rob Herring <robh@xxxxxxxxxx>
> ---
> These properties may be deprecated, but they are still widely used in
> bindings. They either need to be documented (and marked deprecated) or
> removed from current users (i.e. dts files).

Or documented and not marked deprecated?

Best regards
Uwe

> diff --git a/Documentation/devicetree/bindings/mtd/mxc-nand.yaml b/Documentation/devicetree/bindings/mtd/mxc-nand.yaml
> index 73b86f2226c7..66da1b476ab7 100644
> --- a/Documentation/devicetree/bindings/mtd/mxc-nand.yaml
> +++ b/Documentation/devicetree/bindings/mtd/mxc-nand.yaml
> @@ -37,6 +37,4 @@ examples:
> compatible = "fsl,imx27-nand";
> reg = <0xd8000000 0x1000>;
> interrupts = <29>;
> - nand-bus-width = <8>;
> - nand-ecc-mode = "hw";
> };

--
Pengutronix e.K. | Uwe Kleine-König |
Industrial Linux Solutions | https://www.pengutronix.de/ |

Attachment: signature.asc
Description: PGP signature