lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening PHC | |
Open Source and information security mailing list archives
| ||
|
Date: Tue, 21 Nov 2023 08:47:45 +0100 From: Krzysztof Kozlowski <krzysztof.kozlowski@...aro.org> To: Andrew Lunn <andrew@...n.ch> Cc: Rob Herring <robh+dt@...nel.org>, Krzysztof Kozlowski <krzysztof.kozlowski+dt@...aro.org>, Conor Dooley <conor+dt@...nel.org>, Matthias Brugger <matthias.bgg@...il.com>, AngeloGioacchino Del Regno <angelogioacchino.delregno@...labora.com>, devicetree@...r.kernel.org, linux-kernel@...r.kernel.org, linux-arm-kernel@...ts.infradead.org, linux-mediatek@...ts.infradead.org, Andrew Davis <afd@...com>, Arnd Bergmann <arnd@...db.de>, Bjorn Andersson <andersson@...nel.org>, Geert Uytterhoeven <geert+renesas@...der.be>, Heiko Stuebner <heiko@...ech.de>, Konrad Dybcio <konrad.dybcio@...aro.org>, Michal Simek <michal.simek@....com>, Neil Armstrong <neil.armstrong@...aro.org>, Nishanth Menon <nm@...com>, Olof Johansson <olof@...om.net>, linux-rockchip@...ts.infradead.org, linux-samsung-soc@...r.kernel.org, linux-amlogic@...ts.infradead.org, linux-arm-msm@...r.kernel.org Subject: Re: [PATCH v2] docs: dt-bindings: add DTS Coding Style document On 20/11/2023 21:15, Andrew Lunn wrote: >> +Naming and Valid Characters >> +--------------------------- >> + >> +1. Node and property names are allowed to use only: >> + >> + * lowercase characters: [a-z] >> + * digits: [0-9] >> + * dash: - >> + >> +2. Labels are allowed to use only: >> + >> + * lowercase characters: [a-z] >> + * digits: [0-9] >> + * underscore: _ >> + >> +3. Unit addresses should use lowercase hex, without leading zeros (padding). >> + >> +4. Hex values in properties, e.g. "reg", should use lowercase hex. The address >> + part can be padded with leading zeros. >> + >> +Example:: >> + >> + gpi_dma2: dma-controller@...000 { >> + compatible = "qcom,sm8550-gpi-dma", "qcom,sm6350-gpi-dma"; >> + reg = <0x0 0x00800000 0x0 0x60000>; >> + } > > Hi Krzysztof > > What i like about the Linux Coding Style is that most sections have a > Rationale. I like the way it explains the 'Why?'. It makes it feel > less arbitrary. When it does not seem arbitrary, but reasoned, i find > it easier to follow. > > Could you add rationale like the Coding Style? I did not do it on purpose because it would grow too much. Best regards, Krzysztof
Powered by blists - more mailing lists