Commit 527bb3a7 authored by David Heidelberg's avatar David Heidelberg Committed by Rob Herring (Arm)
Browse files

docs: dt-bindings: Extend the ordering list with a blank newline before status 



For better readability, it is recommended to insert a newline before the
'status' property. Adjust the examples accordingly.

Signed-off-by: default avatarDavid Heidelberg <david@ixit.cz>
Reviewed-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://patch.msgid.link/20251023-docs-dt-newline-v1-1-1bf5e0040c0b@ixit.cz


Signed-off-by: default avatarRob Herring (Arm) <robh@kernel.org>
parent 0b233318

Documentation/devicetree/bindings/dts-coding-style.rst

+4 −1
Original line number Diff line number Diff line
@@ -120,7 +120,8 @@ The following order of properties in device nodes is preferred: 
4. Standard/common properties (defined by common bindings, e.g. without

   vendor-prefixes)

5. Vendor-specific properties

6. "status" (if applicable)

6. "status" (if applicable), preceded by a blank line if there is content

   before the property

7. Child nodes, where each node is preceded with a blank line



The "status" property is by default "okay", thus it can be omitted.
@@ -150,6 +151,7 @@ Example:: 
		#address-cells = <1>;

		#size-cells = <1>;

		vendor,custom-property = <2>;



		status = "disabled";



		child_node: child-class@100 {
@@ -165,6 +167,7 @@ Example:: 
		vdd-1v8-supply = <&board_vreg4>;

		vdd-3v3-supply = <&board_vreg2>;

		vdd-12v-supply = <&board_vreg3>;



		status = "okay";

	}