Skip to content

Commit 527bb3a

Browse files
okiasrobherring
authored andcommitted
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: David Heidelberg <david@ixit.cz> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Link: https://patch.msgid.link/20251023-docs-dt-newline-v1-1-1bf5e0040c0b@ixit.cz Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
1 parent 0b23331 commit 527bb3a

1 file changed

Lines changed: 4 additions & 1 deletion

File tree

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

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,8 @@ The following order of properties in device nodes is preferred:
120120
4. Standard/common properties (defined by common bindings, e.g. without
121121
vendor-prefixes)
122122
5. Vendor-specific properties
123-
6. "status" (if applicable)
123+
6. "status" (if applicable), preceded by a blank line if there is content
124+
before the property
124125
7. Child nodes, where each node is preceded with a blank line
125126

126127
The "status" property is by default "okay", thus it can be omitted.
@@ -150,6 +151,7 @@ Example::
150151
#address-cells = <1>;
151152
#size-cells = <1>;
152153
vendor,custom-property = <2>;
154+
153155
status = "disabled";
154156

155157
child_node: child-class@100 {
@@ -165,6 +167,7 @@ Example::
165167
vdd-1v8-supply = <&board_vreg4>;
166168
vdd-3v3-supply = <&board_vreg2>;
167169
vdd-12v-supply = <&board_vreg3>;
170+
168171
status = "okay";
169172
}
170173

0 commit comments

Comments
 (0)