diff options
author | Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> | 2023-06-12 12:26:11 +0300 |
---|---|---|
committer | Rob Herring <robh@kernel.org> | 2023-06-15 20:25:44 +0300 |
commit | 9e654c047061016cb4a07f5c4f3b1596eb481fa6 (patch) | |
tree | 0be970085243e809f42bf3ab92ae2ec5aee90283 | |
parent | 0f8e5651095bcf6e60330c8d558fd1227e0d71b3 (diff) | |
download | linux-9e654c047061016cb4a07f5c4f3b1596eb481fa6.tar.xz |
dt-bindings: example-schema: don't use enum as fallback, explain clock-names
Compatibles with multiple entries should have usually only one fallback
compatible thus enum followed by enum is not a common case. Use 'const'
as second compatible to show the recommended approach.
Explain also when clock-names are not really necessary.
Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20230612092611.12385-1-krzysztof.kozlowski@linaro.org
Signed-off-by: Rob Herring <robh@kernel.org>
-rw-r--r-- | Documentation/devicetree/bindings/example-schema.yaml | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/Documentation/devicetree/bindings/example-schema.yaml b/Documentation/devicetree/bindings/example-schema.yaml index f4eec4c42fb3..a41f9b9a196b 100644 --- a/Documentation/devicetree/bindings/example-schema.yaml +++ b/Documentation/devicetree/bindings/example-schema.yaml @@ -52,8 +52,7 @@ properties: - vendor,soc4-ip - vendor,soc3-ip - vendor,soc2-ip - - enum: - - vendor,soc1-ip + - const: vendor,soc1-ip # additionalItems being false is implied # minItems/maxItems equal to 2 is implied - items: @@ -85,6 +84,9 @@ properties: discouraged. clock-names: + # For single-entry lists in clocks, resets etc., the xxx-names often do not + # bring any value, especially if they copy the IP block name. In such case + # just skip the xxx-names. items: - const: bus |