Hi Rob,
With one comment below, Acked-by: Sam Ravnborg sam@ravnborg.org
diff --git a/Documentation/devicetree/bindings/usb/renesas,usbhs.yaml b/Documentation/devicetree/bindings/usb/renesas,usbhs.yaml index 737c1f47b7de..54c361d4a7af 100644 --- a/Documentation/devicetree/bindings/usb/renesas,usbhs.yaml +++ b/Documentation/devicetree/bindings/usb/renesas,usbhs.yaml @@ -74,11 +74,8 @@ properties:
phys: maxItems: 1
- items:
- description: phandle + phy specifier pair.The description may help some people, so keeping the description and deleting maxItems would maybe be better.
Do we really want to describe 'phys' hundreds of times? No.
Agree, for common properties we as a minimum want a phy-common.yaml or some such - and have the description exactly once.
The question I ask on the descriptions is could it be generated instead.
That could also be an idea, but assuming most people look at the source then the same "most people" would miss the generated descriptions.
But to be clear - I see that phys: is a commonly used property so no problem to have the description dropped here. Ack still stands.
Sam