* [PATCH 1/2] dt-bindings: clock: Drop incorrect usage of double '::' @ 2026-06-22 10:16 Krzysztof Kozlowski 2026-06-22 10:16 ` [PATCH 2/2] dt-bindings: " Krzysztof Kozlowski 2026-06-22 16:50 ` [PATCH 1/2] dt-bindings: clock: " Conor Dooley 0 siblings, 2 replies; 10+ messages in thread From: Krzysztof Kozlowski @ 2026-06-22 10:16 UTC (permalink / raw) To: Bjorn Andersson, Konrad Dybcio, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Peter Griffin, Alim Akhtar, Michael Turquette, Stephen Boyd, Brian Masney, Sylwester Nawrocki, Chanwoo Choi, Sam Protsenko, Rob Clark, Dmitry Baryshkov, Abhinav Kumar, Jessica Zhang, Sean Paul, Marijn Suijten, David Airlie, Simona Vetter, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, Inki Dae, Seung-Woo Kim, Kyungmin Park, Andi Shyti, Georgi Djakov, Lee Jones, Pavel Machek, Hans Verkuil, Mauro Carvalho Chehab, Ulf Hansson, Peter Rosin, Vinod Koul, Neil Armstrong, Linus Walleij, Geert Uytterhoeven, Magnus Damm, Sebastian Reichel, Javier Martinez Canillas, Liam Girdwood, Mark Brown, Greg Kroah-Hartman, Jiri Slaby, Srinivas Kandagatla, Bartlomiej Zolnierkiewicz, Rafael J. Wysocki, Daniel Lezcano, Zhang Rui, Lukasz Luba, Jonathan Marek, Taniya Das, Robert Marko, Christian Marangi, Stephan Gerhold, Adam Skladowski, Sireesh Kodali, Barnabas Czeman, Imran Shaik, Sricharan Ramabadhran, Anusha Rao, Luo Jie, Tomasz Figa, Chanho Park, Sunyeal Hong, Shin Son, Krishna Manikandan, Jacek Anaszewski, Jaehoon Chung, Marek Szyprowski, Alina Yu, Andy Gross, Niklas Söderlund, Wesley Cheng, linux-arm-msm, devicetree, linux-kernel, linux-arm-kernel, linux-samsung-soc, linux-clk, dri-devel, freedreno, linux-i2c, linux-pm, linux-leds, linux-media, linux-mmc, linux-phy, linux-gpio, linux-renesas-soc, linux-serial, linux-sound, linux-usb Cc: Krzysztof Kozlowski There is no use of double colon '::' in YAML. OTOH, the literal style block, e.g. using '|' treats all characters as content [1] therefore single use of ':' in descriptions is perfectly fine, whenever '|' is used. Cleanup existing code, so the confusing style won't be re-used in new contributions. Link: https://yaml.org/spec/1.2.2/#literal-style [1] Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> --- I split the patches to avoid bounces from mailing list due to email size. This can go via clock tree (no dependencies)... or both could go via Rob's tree. --- .../devicetree/bindings/clock/qcom,dispcc-sm8x50.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-apq8064.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-apq8084.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-ipq6018.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-ipq8064.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-mdm9607.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-mdm9615.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-msm8660.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-msm8909.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-msm8916.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-msm8953.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-msm8974.yaml | 2 +- .../devicetree/bindings/clock/qcom,gcc-sdm660.yaml | 2 +- Documentation/devicetree/bindings/clock/qcom,gpucc.yaml | 2 +- .../devicetree/bindings/clock/qcom,ipq5018-gcc.yaml | 2 +- .../devicetree/bindings/clock/qcom,ipq9574-gcc.yaml | 2 +- .../devicetree/bindings/clock/qcom,qca8k-nsscc.yaml | 2 +- .../devicetree/bindings/clock/qcom,qcm2290-gpucc.yaml | 2 +- Documentation/devicetree/bindings/clock/qcom,rpmcc.yaml | 2 +- .../devicetree/bindings/clock/qcom,sc7280-lpasscorecc.yaml | 2 +- .../devicetree/bindings/clock/qcom,sc8280xp-lpasscc.yaml | 2 +- .../devicetree/bindings/clock/qcom,sm6115-lpasscc.yaml | 2 +- .../devicetree/bindings/clock/qcom,sm8350-videocc.yaml | 2 +- Documentation/devicetree/bindings/clock/qcom,videocc.yaml | 2 +- .../devicetree/bindings/clock/samsung,exynos5260-clock.yaml | 6 +++--- .../devicetree/bindings/clock/samsung,exynos5410-clock.yaml | 2 +- .../devicetree/bindings/clock/samsung,exynos5433-clock.yaml | 2 +- .../devicetree/bindings/clock/samsung,exynos7-clock.yaml | 2 +- .../devicetree/bindings/clock/samsung,exynos850-clock.yaml | 2 +- .../bindings/clock/samsung,exynosautov9-clock.yaml | 2 +- .../bindings/clock/samsung,exynosautov920-clock.yaml | 2 +- .../devicetree/bindings/clock/samsung,s5pv210-clock.yaml | 2 +- 32 files changed, 34 insertions(+), 34 deletions(-) diff --git a/Documentation/devicetree/bindings/clock/qcom,dispcc-sm8x50.yaml b/Documentation/devicetree/bindings/clock/qcom,dispcc-sm8x50.yaml index 53a5ab319159..6863db9bd092 100644 --- a/Documentation/devicetree/bindings/clock/qcom,dispcc-sm8x50.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,dispcc-sm8x50.yaml @@ -13,7 +13,7 @@ description: | Qualcomm display clock control module provides the clocks, resets and power domains on SM8150/SM8250/SM8350. - See also:: + See also: include/dt-bindings/clock/qcom,dispcc-sm8150.h include/dt-bindings/clock/qcom,dispcc-sm8250.h include/dt-bindings/clock/qcom,dispcc-sm8350.h diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-apq8064.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-apq8064.yaml index 27df7e3e5bf3..68532244901e 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-apq8064.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-apq8064.yaml @@ -14,7 +14,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on APQ8064. - See also:: + See also: include/dt-bindings/clock/qcom,gcc-msm8960.h include/dt-bindings/reset/qcom,gcc-msm8960.h diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-apq8084.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-apq8084.yaml index 0a0a26d9beab..1c022e75fd71 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-apq8084.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-apq8084.yaml @@ -14,7 +14,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on APQ8084. - See also:: + See also: include/dt-bindings/clock/qcom,gcc-apq8084.h include/dt-bindings/reset/qcom,gcc-apq8084.h diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-ipq6018.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-ipq6018.yaml index 4d2614d4f368..c7fb84438db7 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-ipq6018.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-ipq6018.yaml @@ -15,7 +15,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on IPQ6018. - See also:: + See also: include/dt-bindings/clock/qcom,gcc-ipq6018.h include/dt-bindings/reset/qcom,gcc-ipq6018.h diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-ipq8064.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-ipq8064.yaml index a71557395c01..b4d3175780bc 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-ipq8064.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-ipq8064.yaml @@ -13,7 +13,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on IPQ8064. - See also:: + See also: include/dt-bindings/clock/qcom,gcc-ipq806x.h (qcom,gcc-ipq8064) include/dt-bindings/reset/qcom,gcc-ipq806x.h (qcom,gcc-ipq8064) diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-mdm9607.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-mdm9607.yaml index d7da30b0e7ee..0a7be7583bdd 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-mdm9607.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-mdm9607.yaml @@ -14,7 +14,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains. - See also:: + See also: include/dt-bindings/clock/qcom,gcc-mdm9607.h allOf: diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-mdm9615.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-mdm9615.yaml index 418dea31eb62..0656d5ee448d 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-mdm9615.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-mdm9615.yaml @@ -14,7 +14,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains. - See also:: + See also: include/dt-bindings/clock/qcom,gcc-mdm9615.h allOf: diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8660.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8660.yaml index e03b6d0acdb6..70c9da1f35c2 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8660.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8660.yaml @@ -14,7 +14,7 @@ description: | Qualcomm global clock control module provides the clocks and resets on MSM8660 - See also:: + See also: include/dt-bindings/clock/qcom,gcc-msm8660.h include/dt-bindings/reset/qcom,gcc-msm8660.h diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8909.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8909.yaml index ce1f5a60bd8c..2edb6c251d99 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8909.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8909.yaml @@ -13,7 +13,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on MSM8909, MSM8917 or QM215. - See also:: + See also: include/dt-bindings/clock/qcom,gcc-msm8909.h include/dt-bindings/clock/qcom,gcc-msm8917.h diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8916.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8916.yaml index 258b6b93deca..af4b639ea8c3 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8916.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8916.yaml @@ -14,7 +14,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on MSM8916 or MSM8939. - See also:: + See also: include/dt-bindings/clock/qcom,gcc-msm8916.h include/dt-bindings/clock/qcom,gcc-msm8939.h include/dt-bindings/reset/qcom,gcc-msm8916.h diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8953.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8953.yaml index ced3118c8580..fc0360554f68 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8953.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8953.yaml @@ -15,7 +15,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on MSM8937, MSM8940, MSM8953 or SDM439. - See also:: + See also: include/dt-bindings/clock/qcom,gcc-msm8917.h include/dt-bindings/clock/qcom,gcc-msm8953.h diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8974.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8974.yaml index 929fafc84c19..378dfe7854ac 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-msm8974.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-msm8974.yaml @@ -15,7 +15,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on MSM8974 (all variants) and MSM8226. - See also:: + See also: include/dt-bindings/clock/qcom,gcc-msm8974.h (qcom,gcc-msm8226 and qcom,gcc-msm8974) include/dt-bindings/reset/qcom,gcc-msm8974.h (qcom,gcc-msm8226 and qcom,gcc-msm8974) diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc-sdm660.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc-sdm660.yaml index 724ce0491118..72aaf699cf70 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gcc-sdm660.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gcc-sdm660.yaml @@ -14,7 +14,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on SDM630, SDM636 and SDM660 - See also:: + See also: include/dt-bindings/clock/qcom,gcc-sdm660.h (qcom,gcc-sdm630 and qcom,gcc-sdm660) $ref: qcom,gcc.yaml# diff --git a/Documentation/devicetree/bindings/clock/qcom,gpucc.yaml b/Documentation/devicetree/bindings/clock/qcom,gpucc.yaml index 4cdff6161bf0..3ac4419009a9 100644 --- a/Documentation/devicetree/bindings/clock/qcom,gpucc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,gpucc.yaml @@ -14,7 +14,7 @@ description: | Qualcomm graphics clock control module provides the clocks, resets and power domains on Qualcomm SoCs. - See also:: + See also: include/dt-bindings/clock/qcom,gpucc-sdm845.h include/dt-bindings/clock/qcom,gpucc-sa8775p.h include/dt-bindings/clock/qcom,gpucc-sc7180.h diff --git a/Documentation/devicetree/bindings/clock/qcom,ipq5018-gcc.yaml b/Documentation/devicetree/bindings/clock/qcom,ipq5018-gcc.yaml index 489d0fc5607c..9925b931ecad 100644 --- a/Documentation/devicetree/bindings/clock/qcom,ipq5018-gcc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,ipq5018-gcc.yaml @@ -13,7 +13,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on IPQ5018 - See also:: + See also: include/dt-bindings/clock/qcom,ipq5018-gcc.h include/dt-bindings/reset/qcom,ipq5018-gcc.h diff --git a/Documentation/devicetree/bindings/clock/qcom,ipq9574-gcc.yaml b/Documentation/devicetree/bindings/clock/qcom,ipq9574-gcc.yaml index 27ae9938febc..5b128fa841aa 100644 --- a/Documentation/devicetree/bindings/clock/qcom,ipq9574-gcc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,ipq9574-gcc.yaml @@ -14,7 +14,7 @@ description: | Qualcomm global clock control module provides the clocks, resets and power domains on IPQ9574 - See also:: + See also: include/dt-bindings/clock/qcom,ipq9574-gcc.h include/dt-bindings/reset/qcom,ipq9574-gcc.h diff --git a/Documentation/devicetree/bindings/clock/qcom,qca8k-nsscc.yaml b/Documentation/devicetree/bindings/clock/qcom,qca8k-nsscc.yaml index 61473385da2d..3da10c364a85 100644 --- a/Documentation/devicetree/bindings/clock/qcom,qca8k-nsscc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,qca8k-nsscc.yaml @@ -14,7 +14,7 @@ description: | Qualcomm NSS clock control module provides the clocks and resets on QCA8386(switch mode)/QCA8084(PHY mode) - See also:: + See also: include/dt-bindings/clock/qcom,qca8k-nsscc.h include/dt-bindings/reset/qcom,qca8k-nsscc.h diff --git a/Documentation/devicetree/bindings/clock/qcom,qcm2290-gpucc.yaml b/Documentation/devicetree/bindings/clock/qcom,qcm2290-gpucc.yaml index 734880805c1b..bedbdabef672 100644 --- a/Documentation/devicetree/bindings/clock/qcom,qcm2290-gpucc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,qcm2290-gpucc.yaml @@ -13,7 +13,7 @@ description: | Qualcomm graphics clock control module provides the clocks, resets and power domains on Qualcomm SoCs. - See also:: + See also: include/dt-bindings/clock/qcom,qcm2290-gpucc.h properties: diff --git a/Documentation/devicetree/bindings/clock/qcom,rpmcc.yaml b/Documentation/devicetree/bindings/clock/qcom,rpmcc.yaml index ab97d4b7dba8..b6c835bfd0d9 100644 --- a/Documentation/devicetree/bindings/clock/qcom,rpmcc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,rpmcc.yaml @@ -12,7 +12,7 @@ maintainers: description: | The clock enumerators are defined in <dt-bindings/clock/qcom,rpmcc.h> and - come in pairs:: FOO_CLK followed by FOO_A_CLK. The latter clock is + come in pairs: FOO_CLK followed by FOO_A_CLK. The latter clock is an "active" clock, which means that the consumer only care that the clock is available when the apps CPU subsystem is active, i.e. not suspended or in deep idle. If it is important that the clock keeps running during system diff --git a/Documentation/devicetree/bindings/clock/qcom,sc7280-lpasscorecc.yaml b/Documentation/devicetree/bindings/clock/qcom,sc7280-lpasscorecc.yaml index 99ab9106009f..fd06ac9bceb9 100644 --- a/Documentation/devicetree/bindings/clock/qcom,sc7280-lpasscorecc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,sc7280-lpasscorecc.yaml @@ -13,7 +13,7 @@ description: | Qualcomm LPASS core and audio clock control module provides the clocks and power domains on SC7280. - See also:: + See also: include/dt-bindings/clock/qcom,lpasscorecc-sc7280.h include/dt-bindings/clock/qcom,lpassaudiocc-sc7280.h diff --git a/Documentation/devicetree/bindings/clock/qcom,sc8280xp-lpasscc.yaml b/Documentation/devicetree/bindings/clock/qcom,sc8280xp-lpasscc.yaml index 273d66e245c5..f235b4e24cc7 100644 --- a/Documentation/devicetree/bindings/clock/qcom,sc8280xp-lpasscc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,sc8280xp-lpasscc.yaml @@ -13,7 +13,7 @@ description: | Qualcomm LPASS core and audio clock control module provides the clocks, and reset on SC8280XP. - See also:: + See also: include/dt-bindings/clock/qcom,lpasscc-sc8280xp.h properties: diff --git a/Documentation/devicetree/bindings/clock/qcom,sm6115-lpasscc.yaml b/Documentation/devicetree/bindings/clock/qcom,sm6115-lpasscc.yaml index 8cbab3fbb660..d7e1938b5e1b 100644 --- a/Documentation/devicetree/bindings/clock/qcom,sm6115-lpasscc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,sm6115-lpasscc.yaml @@ -14,7 +14,7 @@ description: | Qualcomm LPASS core and audio clock controllers provide audio-related resets on SM6115 and its derivatives. - See also:: + See also: include/dt-bindings/clock/qcom,sm6115-lpasscc.h properties: diff --git a/Documentation/devicetree/bindings/clock/qcom,sm8350-videocc.yaml b/Documentation/devicetree/bindings/clock/qcom,sm8350-videocc.yaml index 5c2ecec0624e..a986ab4ce7c7 100644 --- a/Documentation/devicetree/bindings/clock/qcom,sm8350-videocc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,sm8350-videocc.yaml @@ -13,7 +13,7 @@ description: | Qualcomm video clock control module provides the clocks, resets and power domains on Qualcomm SoCs. - See also:: + See also: include/dt-bindings/clock/qcom,videocc-sm8350.h include/dt-bindings/reset/qcom,videocc-sm8350.h diff --git a/Documentation/devicetree/bindings/clock/qcom,videocc.yaml b/Documentation/devicetree/bindings/clock/qcom,videocc.yaml index f4ff9acef9d5..124d259fc85e 100644 --- a/Documentation/devicetree/bindings/clock/qcom,videocc.yaml +++ b/Documentation/devicetree/bindings/clock/qcom,videocc.yaml @@ -13,7 +13,7 @@ description: | Qualcomm video clock control module provides the clocks, resets and power domains on Qualcomm SoCs. - See also:: + See also: include/dt-bindings/clock/qcom,sm6350-videocc.h include/dt-bindings/clock/qcom,videocc-sc7180.h include/dt-bindings/clock/qcom,videocc-sc7280.h diff --git a/Documentation/devicetree/bindings/clock/samsung,exynos5260-clock.yaml b/Documentation/devicetree/bindings/clock/samsung,exynos5260-clock.yaml index b05f83533e3d..56ab972c3da5 100644 --- a/Documentation/devicetree/bindings/clock/samsung,exynos5260-clock.yaml +++ b/Documentation/devicetree/bindings/clock/samsung,exynos5260-clock.yaml @@ -14,17 +14,17 @@ maintainers: description: | Expected external clocks, defined in DTS as fixed-rate clocks with a matching - name:: + name: - "fin_pll" - PLL input clock from XXTI - "xrtcxti" - input clock from XRTCXTI - "ioclk_pcm_extclk" - pcm external operation clock - "ioclk_spdif_extclk" - spdif external operation clock - "ioclk_i2s_cdclk" - i2s0 codec clock - Phy clocks:: + Phy clocks: There are several clocks which are generated by specific PHYs. These clocks are fed into the clock controller and then routed to the hardware blocks. - These clocks are defined as fixed clocks in the driver with following names:: + These clocks are defined as fixed clocks in the driver with following names: - "phyclk_dptx_phy_ch3_txd_clk" - dp phy clock for channel 3 - "phyclk_dptx_phy_ch2_txd_clk" - dp phy clock for channel 2 - "phyclk_dptx_phy_ch1_txd_clk" - dp phy clock for channel 1 diff --git a/Documentation/devicetree/bindings/clock/samsung,exynos5410-clock.yaml b/Documentation/devicetree/bindings/clock/samsung,exynos5410-clock.yaml index b737c9d35a1c..1d907dd8fbf1 100644 --- a/Documentation/devicetree/bindings/clock/samsung,exynos5410-clock.yaml +++ b/Documentation/devicetree/bindings/clock/samsung,exynos5410-clock.yaml @@ -14,7 +14,7 @@ maintainers: description: | Expected external clocks, defined in DTS as fixed-rate clocks with a matching - name:: + name: - "fin_pll" - PLL input clock from XXTI All available clocks are defined as preprocessor macros in diff --git a/Documentation/devicetree/bindings/clock/samsung,exynos5433-clock.yaml b/Documentation/devicetree/bindings/clock/samsung,exynos5433-clock.yaml index 3f9326e09f79..8a289f1e2ace 100644 --- a/Documentation/devicetree/bindings/clock/samsung,exynos5433-clock.yaml +++ b/Documentation/devicetree/bindings/clock/samsung,exynos5433-clock.yaml @@ -14,7 +14,7 @@ maintainers: description: | Expected external clocks, defined in DTS as fixed-rate clocks with a matching - name:: + name: - "oscclk" - PLL input clock from XXTI All available clocks are defined as preprocessor macros in diff --git a/Documentation/devicetree/bindings/clock/samsung,exynos7-clock.yaml b/Documentation/devicetree/bindings/clock/samsung,exynos7-clock.yaml index c137c6744ef9..a51cd4fafb41 100644 --- a/Documentation/devicetree/bindings/clock/samsung,exynos7-clock.yaml +++ b/Documentation/devicetree/bindings/clock/samsung,exynos7-clock.yaml @@ -14,7 +14,7 @@ maintainers: description: | Expected external clocks, defined in DTS as fixed-rate clocks with a matching - name:: + name: - "fin_pll" - PLL input clock from XXTI All available clocks are defined as preprocessor macros in diff --git a/Documentation/devicetree/bindings/clock/samsung,exynos850-clock.yaml b/Documentation/devicetree/bindings/clock/samsung,exynos850-clock.yaml index cdc5ded59fe5..68c2fd318765 100644 --- a/Documentation/devicetree/bindings/clock/samsung,exynos850-clock.yaml +++ b/Documentation/devicetree/bindings/clock/samsung,exynos850-clock.yaml @@ -17,7 +17,7 @@ description: | Exynos850 clock controller is comprised of several CMU units, generating clocks for different domains. Those CMU units are modeled as separate device tree nodes, and might depend on each other. Root clocks in that clock tree are - two external clocks:: OSCCLK (26 MHz) and RTCCLK (32768 Hz). Those external + two external clocks: OSCCLK (26 MHz) and RTCCLK (32768 Hz). Those external clocks must be defined as fixed-rate clocks in dts. CMU_TOP is a top-level CMU, where all base clocks are prepared using PLLs and diff --git a/Documentation/devicetree/bindings/clock/samsung,exynosautov9-clock.yaml b/Documentation/devicetree/bindings/clock/samsung,exynosautov9-clock.yaml index 32f39e543b36..e9d17d48b4f3 100644 --- a/Documentation/devicetree/bindings/clock/samsung,exynosautov9-clock.yaml +++ b/Documentation/devicetree/bindings/clock/samsung,exynosautov9-clock.yaml @@ -17,7 +17,7 @@ description: | Exynos Auto v9 clock controller is comprised of several CMU units, generating clocks for different domains. Those CMU units are modeled as separate device tree nodes, and might depend on each other. Root clocks in that clock tree are - two external clocks:: OSCCLK/XTCXO (26 MHz) and RTCCLK/XrtcXTI (32768 Hz). + two external clocks: OSCCLK/XTCXO (26 MHz) and RTCCLK/XrtcXTI (32768 Hz). The external OSCCLK must be defined as fixed-rate clock in dts. CMU_TOP is a top-level CMU, where all base clocks are prepared using PLLs and diff --git a/Documentation/devicetree/bindings/clock/samsung,exynosautov920-clock.yaml b/Documentation/devicetree/bindings/clock/samsung,exynosautov920-clock.yaml index 6b1fc61a2ff9..475db824d4d3 100644 --- a/Documentation/devicetree/bindings/clock/samsung,exynosautov920-clock.yaml +++ b/Documentation/devicetree/bindings/clock/samsung,exynosautov920-clock.yaml @@ -17,7 +17,7 @@ description: | ExynosAuto v920 clock controller is comprised of several CMU units, generating clocks for different domains. Those CMU units are modeled as separate device tree nodes, and might depend on each other. Root clocks in that clock tree are - two external clocks:: OSCCLK/XTCXO (38.4 MHz) and RTCCLK/XrtcXTI (32768 Hz). + two external clocks: OSCCLK/XTCXO (38.4 MHz) and RTCCLK/XrtcXTI (32768 Hz). The external OSCCLK must be defined as fixed-rate clock in dts. CMU_TOP is a top-level CMU, where all base clocks are prepared using PLLs and diff --git a/Documentation/devicetree/bindings/clock/samsung,s5pv210-clock.yaml b/Documentation/devicetree/bindings/clock/samsung,s5pv210-clock.yaml index 67a33665cf00..b1617d96d3fb 100644 --- a/Documentation/devicetree/bindings/clock/samsung,s5pv210-clock.yaml +++ b/Documentation/devicetree/bindings/clock/samsung,s5pv210-clock.yaml @@ -14,7 +14,7 @@ maintainers: description: | Expected external clocks, defined in DTS as fixed-rate clocks with a matching - name:: + name: - "xxti" - external crystal oscillator connected to XXTI and XXTO pins of the SoC, - "xusbxti" - external crystal oscillator connected to XUSBXTI and XUSBXTO -- 2.53.0 ^ permalink raw reply related [flat|nested] 10+ messages in thread
* [PATCH 2/2] dt-bindings: Drop incorrect usage of double '::' 2026-06-22 10:16 [PATCH 1/2] dt-bindings: clock: Drop incorrect usage of double '::' Krzysztof Kozlowski @ 2026-06-22 10:16 ` Krzysztof Kozlowski 2026-06-22 10:19 ` sashiko-bot ` (4 more replies) 2026-06-22 16:50 ` [PATCH 1/2] dt-bindings: clock: " Conor Dooley 1 sibling, 5 replies; 10+ messages in thread From: Krzysztof Kozlowski @ 2026-06-22 10:16 UTC (permalink / raw) To: Bjorn Andersson, Konrad Dybcio, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Peter Griffin, Alim Akhtar, Michael Turquette, Stephen Boyd, Brian Masney, Sylwester Nawrocki, Chanwoo Choi, Sam Protsenko, Rob Clark, Dmitry Baryshkov, Abhinav Kumar, Jessica Zhang, Sean Paul, Marijn Suijten, David Airlie, Simona Vetter, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, Inki Dae, Seung-Woo Kim, Kyungmin Park, Andi Shyti, Georgi Djakov, Lee Jones, Pavel Machek, Hans Verkuil, Mauro Carvalho Chehab, Ulf Hansson, Peter Rosin, Vinod Koul, Neil Armstrong, Linus Walleij, Geert Uytterhoeven, Magnus Damm, Sebastian Reichel, Javier Martinez Canillas, Liam Girdwood, Mark Brown, Greg Kroah-Hartman, Jiri Slaby, Srinivas Kandagatla, Bartlomiej Zolnierkiewicz, Rafael J. Wysocki, Daniel Lezcano, Zhang Rui, Lukasz Luba, Jonathan Marek, Taniya Das, Robert Marko, Christian Marangi, Stephan Gerhold, Adam Skladowski, Sireesh Kodali, Barnabas Czeman, Imran Shaik, Sricharan Ramabadhran, Anusha Rao, Luo Jie, Tomasz Figa, Chanho Park, Sunyeal Hong, Shin Son, Krishna Manikandan, Jacek Anaszewski, Jaehoon Chung, Marek Szyprowski, Alina Yu, Andy Gross, Niklas Söderlund, Wesley Cheng, linux-arm-msm, devicetree, linux-kernel, linux-arm-kernel, linux-samsung-soc, linux-clk, dri-devel, freedreno, linux-i2c, linux-pm, linux-leds, linux-media, linux-mmc, linux-phy, linux-gpio, linux-renesas-soc, linux-serial, linux-sound, linux-usb Cc: Krzysztof Kozlowski There is no use of double colon '::' in YAML. OTOH, the literal style block, e.g. using '|' treats all characters as content [1] therefore single use of ':' in descriptions is perfectly fine, whenever '|' is used. Cleanup existing code, so the confusing style won't be re-used in new contributions. Link: https://yaml.org/spec/1.2.2/#literal-style [1] Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> --- Intention for this patch is to go via Rob's tree. --- .../devicetree/bindings/arm/qcom-soc.yaml | 4 ++-- .../devicetree/bindings/arm/qcom.yaml | 4 ++-- .../bindings/arm/samsung/samsung-soc.yaml | 4 ++-- .../display/msm/dsi-controller-main.yaml | 20 +++++++++---------- .../display/samsung/samsung,fimd.yaml | 4 ++-- .../bindings/i2c/samsung,s3c2410-i2c.yaml | 2 +- .../interconnect/qcom,msm8998-bwmon.yaml | 2 +- .../interconnect/samsung,exynos-bus.yaml | 14 ++++++------- .../bindings/leds/qcom,pm8058-led.yaml | 4 ++-- .../bindings/leds/skyworks,aat1290.yaml | 6 +++--- .../bindings/media/cec/cec-gpio.yaml | 2 +- .../bindings/mmc/samsung,exynos-dw-mshc.yaml | 2 +- .../devicetree/bindings/mux/mux-consumer.yaml | 4 ++-- .../bindings/phy/samsung,mipi-video-phy.yaml | 4 ++-- .../bindings/phy/samsung,usb2-phy.yaml | 2 +- .../bindings/phy/samsung,usb3-drd-phy.yaml | 2 +- .../bindings/pinctrl/samsung,pinctrl.yaml | 2 +- .../bindings/power/renesas,rcar-sysc.yaml | 2 +- .../bindings/power/reset/restart-handler.yaml | 8 ++++---- .../bindings/regulator/maxim,max77802.yaml | 4 ++-- .../bindings/regulator/richtek,rtq2208.yaml | 2 +- .../bindings/serial/qcom,msm-uartdm.yaml | 2 +- .../devicetree/bindings/slimbus/slimbus.yaml | 4 ++-- .../bindings/soc/qcom/qcom,apr-services.yaml | 2 +- .../bindings/soc/qcom/qcom,rpmh-rsc.yaml | 8 ++++---- .../bindings/soc/qcom/qcom,wcnss.yaml | 2 +- .../bindings/soc/renesas/renesas-soc.yaml | 4 ++-- .../bindings/sound/qcom,q6asm-dais.yaml | 2 +- .../thermal/samsung,exynos-thermal.yaml | 4 ++-- .../devicetree/bindings/usb/qcom,dwc3.yaml | 12 +++++------ .../bindings/usb/qcom,snps-dwc3.yaml | 12 +++++------ 31 files changed, 75 insertions(+), 75 deletions(-) diff --git a/Documentation/devicetree/bindings/arm/qcom-soc.yaml b/Documentation/devicetree/bindings/arm/qcom-soc.yaml index 27261039d56f..37fdd5a080b7 100644 --- a/Documentation/devicetree/bindings/arm/qcom-soc.yaml +++ b/Documentation/devicetree/bindings/arm/qcom-soc.yaml @@ -11,10 +11,10 @@ maintainers: description: | Guidelines for new compatibles for SoC blocks/components. - When adding new compatibles in new bindings, use the format:: + When adding new compatibles in new bindings, use the format: qcom,SoC-IP - For example:: + For example: qcom,sdm845-llcc-bwmon When adding new compatibles to existing bindings, use the format in the diff --git a/Documentation/devicetree/bindings/arm/qcom.yaml b/Documentation/devicetree/bindings/arm/qcom.yaml index 50cc18a6ec5e..667607ae2c32 100644 --- a/Documentation/devicetree/bindings/arm/qcom.yaml +++ b/Documentation/devicetree/bindings/arm/qcom.yaml @@ -1215,7 +1215,7 @@ properties: items: items: - description: | - MSM chipset ID - an exact match value consisting of two bitfields:: + MSM chipset ID - an exact match value consisting of two bitfields: - bits 0-15 - The unique MSM chipset ID - bits 16-31 - Reserved; should be 0 - description: | @@ -1241,7 +1241,7 @@ properties: - items: - items: - description: | - Board ID consisting of three bitfields:: + Board ID consisting of three bitfields: - bits 31-24 - Unused - bits 23-16 - Platform Version Major - bits 15-8 - Platform Version Minor diff --git a/Documentation/devicetree/bindings/arm/samsung/samsung-soc.yaml b/Documentation/devicetree/bindings/arm/samsung/samsung-soc.yaml index 653f85997643..ab000befe76d 100644 --- a/Documentation/devicetree/bindings/arm/samsung/samsung-soc.yaml +++ b/Documentation/devicetree/bindings/arm/samsung/samsung-soc.yaml @@ -11,10 +11,10 @@ maintainers: description: | Guidelines for new compatibles for SoC blocks/components. - When adding new compatibles in new bindings, use the format:: + When adding new compatibles in new bindings, use the format: samsung,SoC-IP - For example:: + For example: samsung,exynos5433-cmu-isp select: diff --git a/Documentation/devicetree/bindings/display/msm/dsi-controller-main.yaml b/Documentation/devicetree/bindings/display/msm/dsi-controller-main.yaml index dbc0613e427e..395425a70db8 100644 --- a/Documentation/devicetree/bindings/display/msm/dsi-controller-main.yaml +++ b/Documentation/devicetree/bindings/display/msm/dsi-controller-main.yaml @@ -73,16 +73,16 @@ properties: clocks: description: | - Several clocks are used, depending on the variant. Typical ones are:: - - bus:: Display AHB clock. - - byte:: Display byte clock. - - byte_intf:: Display byte interface clock. - - core:: Display core clock. - - core_mss:: Core MultiMedia SubSystem clock. - - iface:: Display AXI clock. - - mdp_core:: MDP Core clock. - - mnoc:: MNOC clock - - pixel:: Display pixel clock. + Several clocks are used, depending on the variant. Typical ones are: + - bus: Display AHB clock. + - byte: Display byte clock. + - byte_intf: Display byte interface clock. + - core: Display core clock. + - core_mss: Core MultiMedia SubSystem clock. + - iface: Display AXI clock. + - mdp_core: MDP Core clock. + - mnoc: MNOC clock + - pixel: Display pixel clock. minItems: 3 maxItems: 12 diff --git a/Documentation/devicetree/bindings/display/samsung/samsung,fimd.yaml b/Documentation/devicetree/bindings/display/samsung/samsung,fimd.yaml index ff685031bb2c..729705f419bb 100644 --- a/Documentation/devicetree/bindings/display/samsung/samsung,fimd.yaml +++ b/Documentation/devicetree/bindings/display/samsung/samsung,fimd.yaml @@ -41,7 +41,7 @@ properties: additionalProperties: false description: | Timing configuration for lcd i80 interface support. - The parameters are defined as:: + The parameters are defined as: VCLK(internal) __|??????|_____|??????|_____|??????|_____|??????|_____|?? : : : : : Address Output --:<XXXXXXXXXXX:XXXXXXXXXXXX:XXXXXXXXXXXX:XXXXXXXXXXXX:XX @@ -132,7 +132,7 @@ patternProperties: "^port@[0-4]+$": $ref: /schemas/graph.yaml#/properties/port description: | - Contains ports with port with index:: + Contains ports with port with index: 0 - for CAMIF0 input, 1 - for CAMIF1 input, 2 - for CAMIF2 input, diff --git a/Documentation/devicetree/bindings/i2c/samsung,s3c2410-i2c.yaml b/Documentation/devicetree/bindings/i2c/samsung,s3c2410-i2c.yaml index a2ddc6803617..07600b49f2f9 100644 --- a/Documentation/devicetree/bindings/i2c/samsung,s3c2410-i2c.yaml +++ b/Documentation/devicetree/bindings/i2c/samsung,s3c2410-i2c.yaml @@ -35,7 +35,7 @@ properties: gpios: description: | - The order of the GPIOs should be the following:: <SDA, SCL>. The GPIO + The order of the GPIOs should be the following: <SDA, SCL>. The GPIO specifier depends on the gpio controller. Required in all cases except for "samsung,s3c2440-hdmiphy-i2c" whose input/output lines are permanently wired to the respective client. diff --git a/Documentation/devicetree/bindings/interconnect/qcom,msm8998-bwmon.yaml b/Documentation/devicetree/bindings/interconnect/qcom,msm8998-bwmon.yaml index ff64225e8281..e002e70580f9 100644 --- a/Documentation/devicetree/bindings/interconnect/qcom,msm8998-bwmon.yaml +++ b/Documentation/devicetree/bindings/interconnect/qcom,msm8998-bwmon.yaml @@ -13,7 +13,7 @@ description: | Bandwidth Monitor measures current throughput on buses between various NoC fabrics and provides information when it crosses configured thresholds. - Certain SoCs might have more than one Bandwidth Monitors, for example on SDM845:: + Certain SoCs might have more than one Bandwidth Monitors, for example on SDM845: - Measuring the bandwidth between CPUs and Last Level Cache Controller - called just BWMON, - Measuring the bandwidth between Last Level Cache Controller and memory diff --git a/Documentation/devicetree/bindings/interconnect/samsung,exynos-bus.yaml b/Documentation/devicetree/bindings/interconnect/samsung,exynos-bus.yaml index 5e26e48c7217..0203959c8995 100644 --- a/Documentation/devicetree/bindings/interconnect/samsung,exynos-bus.yaml +++ b/Documentation/devicetree/bindings/interconnect/samsung,exynos-bus.yaml @@ -23,7 +23,7 @@ description: | The each AXI bus has the owned source clock but, has not the only owned power line. The power line might be shared among one more sub-blocks. So, we can divide into two type of device as the role of each sub-block. There are two - type of bus devices as following:: + type of bus devices as following: - parent bus device - passive bus device @@ -44,8 +44,8 @@ description: | able to support the bus frequency for all Exynos SoCs. Detailed correlation between sub-blocks and power line according - to Exynos SoC:: - - In case of Exynos3250, there are two power line as following:: + to Exynos SoC: + - In case of Exynos3250, there are two power line as following: VDD_MIF |--- DMC (Dynamic Memory Controller) VDD_INT |--- LEFTBUS (parent device) @@ -89,7 +89,7 @@ description: | |L5 |200000 |200000 |400000 |300000 | ||1000000 | ---------------------------------------------------------- - - In case of Exynos4210, there is one power line as following:: + - In case of Exynos4210, there is one power line as following: VDD_INT |--- DMC (parent device, Dynamic Memory Controller) |--- LEFTBUS |--- PERIL @@ -106,7 +106,7 @@ description: | |--- LCD0 |--- LCD1 - - In case of Exynos4x12, there are two power line as following:: + - In case of Exynos4x12, there are two power line as following: VDD_MIF |--- DMC (Dynamic Memory Controller) VDD_INT |--- LEFTBUS (parent device) @@ -124,7 +124,7 @@ description: | |--- LCD0 |--- ISP - - In case of Exynos5422, there are two power line as following:: + - In case of Exynos5422, there are two power line as following: VDD_MIF |--- DREX 0 (parent device, DRAM EXpress controller) |--- DREX 1 @@ -143,7 +143,7 @@ description: | |--- FSYS |--- FSYS2 - - In case of Exynos5433, there is VDD_INT power line as following:: + - In case of Exynos5433, there is VDD_INT power line as following: VDD_INT |--- G2D (parent device) |--- MSCL |--- GSCL diff --git a/Documentation/devicetree/bindings/leds/qcom,pm8058-led.yaml b/Documentation/devicetree/bindings/leds/qcom,pm8058-led.yaml index b409b2a8b5c5..5165bfddcd54 100644 --- a/Documentation/devicetree/bindings/leds/qcom,pm8058-led.yaml +++ b/Documentation/devicetree/bindings/leds/qcom,pm8058-led.yaml @@ -10,10 +10,10 @@ maintainers: - Krzysztof Kozlowski <krzk@kernel.org> description: | - The Qualcomm PM8058 contains an LED block for up to six LEDs:: three normal + The Qualcomm PM8058 contains an LED block for up to six LEDs: three normal LEDs, two "flash" LEDs and one "keypad backlight" LED. The names are quoted because sometimes these LED drivers are used for wildly different things than - flash or keypad backlight:: their names are more of a suggestion than a + flash or keypad backlight: their names are more of a suggestion than a hard-wired usecase. Hardware-wise the different LEDs support slightly different output currents. diff --git a/Documentation/devicetree/bindings/leds/skyworks,aat1290.yaml b/Documentation/devicetree/bindings/leds/skyworks,aat1290.yaml index a6aaa92dbccd..65576dfdca11 100644 --- a/Documentation/devicetree/bindings/leds/skyworks,aat1290.yaml +++ b/Documentation/devicetree/bindings/leds/skyworks,aat1290.yaml @@ -11,7 +11,7 @@ maintainers: - Krzysztof Kozlowski <krzk@kernel.org> description: | - The device is controlled through two pins:: FL_EN and EN_SET. The pins when, + The device is controlled through two pins: FL_EN and EN_SET. The pins when, asserted high, enable flash strobe and movie mode (max 1/2 of flash current) respectively. In order to add a capability of selecting the strobe signal source (e.g. CPU or camera sensor) there is an additional switch required, @@ -39,11 +39,11 @@ properties: flash-max-microamp: description: | Maximum flash LED supply current can be calculated using following - formula:: I = 1A * 162 kOhm / Rset. + formula: I = 1A * 162 kOhm / Rset. flash-max-timeout-us: description: | - Maximum flash timeout can be calculated using following formula:: + Maximum flash timeout can be calculated using following formula: T = 8.82 * 10^9 * Ct. required: diff --git a/Documentation/devicetree/bindings/media/cec/cec-gpio.yaml b/Documentation/devicetree/bindings/media/cec/cec-gpio.yaml index 582c6c9cae48..21118e4bae0f 100644 --- a/Documentation/devicetree/bindings/media/cec/cec-gpio.yaml +++ b/Documentation/devicetree/bindings/media/cec/cec-gpio.yaml @@ -14,7 +14,7 @@ description: | hooked up to a pull-up GPIO line and - optionally - the HPD line is hooked up to another GPIO line. - Please note:: the maximum voltage for the CEC line is 3.63V, for the HPD and + Please note: the maximum voltage for the CEC line is 3.63V, for the HPD and 5V lines it is 5.3V. So you may need some sort of level conversion circuitry when connecting them to a GPIO line. diff --git a/Documentation/devicetree/bindings/mmc/samsung,exynos-dw-mshc.yaml b/Documentation/devicetree/bindings/mmc/samsung,exynos-dw-mshc.yaml index 27c4060f2f91..223fcc9f651f 100644 --- a/Documentation/devicetree/bindings/mmc/samsung,exynos-dw-mshc.yaml +++ b/Documentation/devicetree/bindings/mmc/samsung,exynos-dw-mshc.yaml @@ -85,7 +85,7 @@ properties: description: | The value of CIU TX and RX clock phase shift value for HS400 mode operation. - Valid values for SDR and DDR CIU clock timing:: + Valid values for SDR and DDR CIU clock timing: - valid value for tx phase shift and rx phase shift is 0 to 7. - when CIU clock divider value is set to 3, all possible 8 phase shift values can be used. diff --git a/Documentation/devicetree/bindings/mux/mux-consumer.yaml b/Documentation/devicetree/bindings/mux/mux-consumer.yaml index 9e2d78a78e40..769243a2bf04 100644 --- a/Documentation/devicetree/bindings/mux/mux-consumer.yaml +++ b/Documentation/devicetree/bindings/mux/mux-consumer.yaml @@ -13,8 +13,8 @@ description: | Mux controller consumers should specify a list of mux controllers that they want to use with a property containing a 'mux-ctrl-list': - mux-ctrl-list ::= <single-mux-ctrl> [mux-ctrl-list] - single-mux-ctrl ::= <mux-ctrl-phandle> [mux-ctrl-specifier] + mux-ctrl-list := <single-mux-ctrl> [mux-ctrl-list] + single-mux-ctrl := <mux-ctrl-phandle> [mux-ctrl-specifier] mux-ctrl-phandle : phandle to mux controller node mux-ctrl-specifier : array of #mux-control-cells specifying the given mux controller (controller specific) diff --git a/Documentation/devicetree/bindings/phy/samsung,mipi-video-phy.yaml b/Documentation/devicetree/bindings/phy/samsung,mipi-video-phy.yaml index 16967ef8e9ec..87b6a35b2626 100644 --- a/Documentation/devicetree/bindings/phy/samsung,mipi-video-phy.yaml +++ b/Documentation/devicetree/bindings/phy/samsung,mipi-video-phy.yaml @@ -13,14 +13,14 @@ maintainers: description: | For samsung,s5pv210-mipi-video-phy compatible PHYs the second cell in the - PHY specifier identifies the PHY and its meaning is as follows:: + PHY specifier identifies the PHY and its meaning is as follows: 0 - MIPI CSIS 0, 1 - MIPI DSIM 0, 2 - MIPI CSIS 1, 3 - MIPI DSIM 1. samsung,exynos5420-mipi-video-phy and samsung,exynos5433-mipi-video-phy - support additional fifth PHY:: + support additional fifth PHY: 4 - MIPI CSIS 2. properties: diff --git a/Documentation/devicetree/bindings/phy/samsung,usb2-phy.yaml b/Documentation/devicetree/bindings/phy/samsung,usb2-phy.yaml index d9f22a801cbf..7db7605a82e2 100644 --- a/Documentation/devicetree/bindings/phy/samsung,usb2-phy.yaml +++ b/Documentation/devicetree/bindings/phy/samsung,usb2-phy.yaml @@ -14,7 +14,7 @@ maintainers: description: | The first phandle argument in the PHY specifier identifies the PHY, its meaning is compatible dependent. For the currently supported SoCs (Exynos4210 - and Exynos4212) it is as follows:: + and Exynos4212) it is as follows: 0 - USB device ("device"), 1 - USB host ("host"), 2 - HSIC0 ("hsic0"), diff --git a/Documentation/devicetree/bindings/phy/samsung,usb3-drd-phy.yaml b/Documentation/devicetree/bindings/phy/samsung,usb3-drd-phy.yaml index 4562e0468f4f..a1b3d9e6a094 100644 --- a/Documentation/devicetree/bindings/phy/samsung,usb3-drd-phy.yaml +++ b/Documentation/devicetree/bindings/phy/samsung,usb3-drd-phy.yaml @@ -14,7 +14,7 @@ maintainers: description: | For samsung,exynos5250-usbdrd-phy and samsung,exynos5420-usbdrd-phy compatible PHYs, the second cell in the PHY specifier identifies the - PHY id, which is interpreted as follows:: + PHY id, which is interpreted as follows: 0 - UTMI+ type phy, 1 - PIPE3 type phy. diff --git a/Documentation/devicetree/bindings/pinctrl/samsung,pinctrl.yaml b/Documentation/devicetree/bindings/pinctrl/samsung,pinctrl.yaml index 7b006009ca0e..5e35686eeed3 100644 --- a/Documentation/devicetree/bindings/pinctrl/samsung,pinctrl.yaml +++ b/Documentation/devicetree/bindings/pinctrl/samsung,pinctrl.yaml @@ -18,7 +18,7 @@ description: | All the pin controller nodes should be represented in the aliases node using the following format 'pinctrl{n}' where n is a unique number for the alias. - The controller supports three types of interrupts:: + The controller supports three types of interrupts: - External GPIO interrupts (see interrupts property in pin controller node); - External wake-up interrupts - multiplexed (capable of waking up the system diff --git a/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml b/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml index 347571e2545a..b67aa170b2c1 100644 --- a/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml +++ b/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml @@ -13,7 +13,7 @@ maintainers: description: | The R-Car (RZ/G) System Controller provides power management for the CPU cores and various coprocessors. - The power domain IDs for consumers are defined in header files:: + The power domain IDs for consumers are defined in header files: include/dt-bindings/power/r8*-sysc.h properties: diff --git a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml index 965a834a3dbe..00c00ec5ec81 100644 --- a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml +++ b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml @@ -18,12 +18,12 @@ properties: priority: $ref: /schemas/types.yaml#/definitions/uint32 description: | - A priority ranging from 0 to 255 according to the following guidelines:: - 0:: Restart handler of last resort, with limited restart capabilities. - 128:: Typical, default restart handler; use if no other restart handler + A priority ranging from 0 to 255 according to the following guidelines: + 0: Restart handler of last resort, with limited restart capabilities. + 128: Typical, default restart handler; use if no other restart handler is expected to be available, and/or if restart functionality is sufficient to restart the entire system. - 255:: Highest priority restart handler, will preempt all other restart handlers. + 255: Highest priority restart handler, will preempt all other restart handlers. minimum: 0 maximum: 255 diff --git a/Documentation/devicetree/bindings/regulator/maxim,max77802.yaml b/Documentation/devicetree/bindings/regulator/maxim,max77802.yaml index b704f05ea454..b886495c1396 100644 --- a/Documentation/devicetree/bindings/regulator/maxim,max77802.yaml +++ b/Documentation/devicetree/bindings/regulator/maxim,max77802.yaml @@ -22,13 +22,13 @@ description: | Certain regulators support "regulator-initial-mode" and "regulator-mode". The valid modes list is defined in the dt-bindings/regulator/maxim,max77802.h - and their meaning is:: + and their meaning is: 1 - Normal regulator voltage output mode. 3 - Low Power which reduces the quiescent current down to only 1uA The standard "regulator-mode" property can only be used for regulators that support changing their mode to Low Power Mode during suspend. These - regulators are:: bucks 2-4 and LDOs 1-35. Also, it only takes effect if the + regulators are: bucks 2-4 and LDOs 1-35. Also, it only takes effect if the regulator has been enabled for the given suspend state using "regulator-on-in-suspend" and has not been disabled for that state using "regulator-off-in-suspend". diff --git a/Documentation/devicetree/bindings/regulator/richtek,rtq2208.yaml b/Documentation/devicetree/bindings/regulator/richtek,rtq2208.yaml index 022c1f197364..b0aa38edf8c2 100644 --- a/Documentation/devicetree/bindings/regulator/richtek,rtq2208.yaml +++ b/Documentation/devicetree/bindings/regulator/richtek,rtq2208.yaml @@ -21,7 +21,7 @@ description: | conduction mode (FCCM). The definition of modes is in the datasheet which is available in below link - and their meaning is:: + and their meaning is: 0 - Auto mode for power saving, which reducing the switching frequency at light load condition to maintain high frequency. 1 - FCCM to meet the strict voltage regulation accuracy, which keeping constant switching frequency. diff --git a/Documentation/devicetree/bindings/serial/qcom,msm-uartdm.yaml b/Documentation/devicetree/bindings/serial/qcom,msm-uartdm.yaml index 788ef5c1c446..bc967ead2350 100644 --- a/Documentation/devicetree/bindings/serial/qcom,msm-uartdm.yaml +++ b/Documentation/devicetree/bindings/serial/qcom,msm-uartdm.yaml @@ -17,7 +17,7 @@ description: | software perspective it's mostly compatible with the MSM serial UART except that it supports reading and writing multiple characters at a time. - Note:: Aliases may be defined to ensure the correct ordering of the UARTs. + Note: Aliases may be defined to ensure the correct ordering of the UARTs. The alias serialN will result in the UART being assigned port N. If any serialN alias exists, then an alias must exist for each enabled UART. The serialN aliases should be in a .dts file instead of in a .dtsi file. diff --git a/Documentation/devicetree/bindings/slimbus/slimbus.yaml b/Documentation/devicetree/bindings/slimbus/slimbus.yaml index 5a941610ce4e..3910327c8ded 100644 --- a/Documentation/devicetree/bindings/slimbus/slimbus.yaml +++ b/Documentation/devicetree/bindings/slimbus/slimbus.yaml @@ -29,7 +29,7 @@ patternProperties: description: | Every SLIMbus controller node can contain zero or more child nodes representing slave devices on the bus. Every SLIMbus slave device is - uniquely determined by the enumeration address containing 4 fields:: + uniquely determined by the enumeration address containing 4 fields: Manufacturer ID, Product code, Device index, and Instance value for the device. @@ -48,7 +48,7 @@ patternProperties: reg: maxItems: 1 description: | - Pair of (device index, instande ID), where:: + Pair of (device index, instande ID), where: - Device index, which uniquely identifies multiple devices within a single component. - Instance ID, can be used for the cases where multiple devices of diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,apr-services.yaml b/Documentation/devicetree/bindings/soc/qcom/qcom,apr-services.yaml index bdf482db32aa..b663be3ea5a1 100644 --- a/Documentation/devicetree/bindings/soc/qcom/qcom,apr-services.yaml +++ b/Documentation/devicetree/bindings/soc/qcom/qcom,apr-services.yaml @@ -40,7 +40,7 @@ properties: $ref: /schemas/types.yaml#/definitions/string-array description: | Protection domain service name and path for APR service (if supported). - Possible values are:: + Possible values are: "avs/audio", "msm/adsp/audio_pd". "kernel/elf_loader", "msm/modem/wlan_pd". "tms/servreg", "msm/adsp/audio_pd". diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,rpmh-rsc.yaml b/Documentation/devicetree/bindings/soc/qcom/qcom,rpmh-rsc.yaml index 26d9bc773ec5..1889139a3f7a 100644 --- a/Documentation/devicetree/bindings/soc/qcom/qcom,rpmh-rsc.yaml +++ b/Documentation/devicetree/bindings/soc/qcom/qcom,rpmh-rsc.yaml @@ -23,7 +23,7 @@ description: | with a few variations that are captured by the properties here. A TCS may be triggered from Linux or triggered by the F/W after all the CPUs - have powered off to facilitate idle power saving. TCS could be classified as:: + have powered off to facilitate idle power saving. TCS could be classified as: ACTIVE - Triggered by Linux SLEEP - Triggered by F/W WAKE - Triggered by F/W @@ -76,7 +76,7 @@ properties: items: items: - description: | - TCS type:: + TCS type: - ACTIVE_TCS - SLEEP_TCS - WAKE_TCS @@ -152,7 +152,7 @@ examples: - | // For a TCS whose RSC base address is 0x179C0000 and is at a DRV id of // 2, the register offsets for DRV2 start at 0D00, the register - // calculations are like this:: + // calculations are like this: // DRV0: 0x179C0000 // DRV2: 0x179C0000 + 0x10000 = 0x179D0000 // DRV2: 0x179C0000 + 0x10000 * 2 = 0x179E0000 @@ -182,7 +182,7 @@ examples: - | // For a TCS whose RSC base address is 0xAF20000 and is at DRV id of 0, the // register offsets for DRV0 start at 01C00, the register calculations are - // like this:: + // like this: // DRV0: 0xAF20000 // TCS-OFFSET: 0x1C00 #include <dt-bindings/interrupt-controller/arm-gic.h> diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.yaml b/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.yaml index 4fcae6bedfff..72a7f8cb09ba 100644 --- a/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.yaml +++ b/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.yaml @@ -28,7 +28,7 @@ properties: $ref: /schemas/types.yaml#/definitions/phandle description: | Reference to a node specifying the wcnss "ccu" and "dxe" register blocks. - The node must be compatible with one of the following:: + The node must be compatible with one of the following: - qcom,riva" - qcom,pronto" diff --git a/Documentation/devicetree/bindings/soc/renesas/renesas-soc.yaml b/Documentation/devicetree/bindings/soc/renesas/renesas-soc.yaml index 5ddd31f30f26..57c9d3c57021 100644 --- a/Documentation/devicetree/bindings/soc/renesas/renesas-soc.yaml +++ b/Documentation/devicetree/bindings/soc/renesas/renesas-soc.yaml @@ -12,10 +12,10 @@ maintainers: description: | Guidelines for new compatibles for SoC blocks/components. - When adding new compatibles in new bindings, use the format:: + When adding new compatibles in new bindings, use the format: renesas,SoC-IP - For example:: + For example: renesas,r8a77965-csi2 When adding new compatibles to existing bindings, use the format in the diff --git a/Documentation/devicetree/bindings/sound/qcom,q6asm-dais.yaml b/Documentation/devicetree/bindings/sound/qcom,q6asm-dais.yaml index 47a105a97ecf..bc8c8ba24f9c 100644 --- a/Documentation/devicetree/bindings/sound/qcom,q6asm-dais.yaml +++ b/Documentation/devicetree/bindings/sound/qcom,q6asm-dais.yaml @@ -45,7 +45,7 @@ patternProperties: $ref: /schemas/types.yaml#/definitions/uint32 enum: [0, 1, 2] description: | - The direction of the dai stream:: + The direction of the dai stream: - Q6ASM_DAI_TX_RX (0) for both tx and rx - Q6ASM_DAI_TX (1) for only tx (Capture/Encode) - Q6ASM_DAI_RX (2) for only rx (Playback/Decode) diff --git a/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml b/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml index 29a08b0729ee..3f333db72a71 100644 --- a/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml +++ b/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml @@ -40,7 +40,7 @@ properties: description: | The Exynos TMU supports generating interrupts when reaching given temperature thresholds. Number of supported thermal trip points depends - on the SoC (only first trip points defined in DT will be configured):: + on the SoC (only first trip points defined in DT will be configured): - most of SoC: 4 - samsung,exynos5433-tmu: 8 - samsung,exynos7-tmu: 8 @@ -52,7 +52,7 @@ properties: - description: | Shared TMU registers. - Note:: On Exynos5420, the TRIMINFO register is misplaced for TMU + Note: On Exynos5420, the TRIMINFO register is misplaced for TMU channels 2, 3 and 4 Use "samsung,exynos5420-tmu-ext-triminfo" in cases, there is a misplaced register, also provide clock to access that base. diff --git a/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml b/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml index a7f58114c02e..90daee616880 100644 --- a/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml +++ b/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml @@ -92,14 +92,14 @@ properties: clocks: description: | - Several clocks are used, depending on the variant. Typical ones are:: - - cfg_noc:: System Config NOC clock. - - core:: Master/Core clock, has to be >= 125 MHz for SS operation and >= + Several clocks are used, depending on the variant. Typical ones are: + - cfg_noc: System Config NOC clock. + - core: Master/Core clock, has to be >= 125 MHz for SS operation and >= 60MHz for HS operation. - - iface:: System bus AXI clock. - - sleep:: Sleep clock, used for wakeup when USB3 core goes into low + - iface: System bus AXI clock. + - sleep: Sleep clock, used for wakeup when USB3 core goes into low power mode (U3). - - mock_utmi:: Mock utmi clock needed for ITP/SOF generation in host + - mock_utmi: Mock utmi clock needed for ITP/SOF generation in host mode. Its frequency should be 19.2MHz. minItems: 1 maxItems: 9 diff --git a/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml b/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml index 8201656b41ed..d99af9f413d0 100644 --- a/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml +++ b/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml @@ -87,14 +87,14 @@ properties: clocks: description: | - Several clocks are used, depending on the variant. Typical ones are:: - - cfg_noc:: System Config NOC clock. - - core:: Master/Core clock, has to be >= 125 MHz for SS operation and >= + Several clocks are used, depending on the variant. Typical ones are: + - cfg_noc: System Config NOC clock. + - core: Master/Core clock, has to be >= 125 MHz for SS operation and >= 60MHz for HS operation. - - iface:: System bus AXI clock. - - sleep:: Sleep clock, used for wakeup when USB3 core goes into low + - iface: System bus AXI clock. + - sleep: Sleep clock, used for wakeup when USB3 core goes into low power mode (U3). - - mock_utmi:: Mock utmi clock needed for ITP/SOF generation in host + - mock_utmi: Mock utmi clock needed for ITP/SOF generation in host mode. Its frequency should be 19.2MHz. minItems: 1 maxItems: 9 -- 2.53.0 ^ permalink raw reply related [flat|nested] 10+ messages in thread
* Re: [PATCH 2/2] dt-bindings: Drop incorrect usage of double '::' 2026-06-22 10:16 ` [PATCH 2/2] dt-bindings: " Krzysztof Kozlowski @ 2026-06-22 10:19 ` sashiko-bot 2026-06-22 13:23 ` Krzysztof Kozlowski 2026-06-22 10:32 ` Geert Uytterhoeven ` (3 subsequent siblings) 4 siblings, 1 reply; 10+ messages in thread From: sashiko-bot @ 2026-06-22 10:19 UTC (permalink / raw) To: Krzysztof Kozlowski Cc: neil.armstrong, vkoul, dri-devel, robh, conor+dt, linux-phy, olteanv, devicetree, wsa+renesas Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider: - [Low] Unintended replacement of BNF notation `::=` with `:=`. -- commit a9fdd0b065eb5b6394a9c33ffba0fd5194e80115 Author: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> dt-bindings: Drop incorrect usage of double '::' This commit cleans up device tree binding schemas by removing the redundant double colons at the end of descriptions inside YAML literal style blocks. Link: https://yaml.org/spec/1.2.2/#literal-style [1] > diff --git a/Documentation/devicetree/bindings/mux/mux-consumer.yaml b/Documentation/devicetree/bindings/mux/mux-consumer.yaml > index 9e2d78a78e409..769243a2bf046 100644 > --- a/Documentation/devicetree/bindings/mux/mux-consumer.yaml > +++ b/Documentation/devicetree/bindings/mux/mux-consumer.yaml > @@ -13,8 +13,8 @@ description: | > Mux controller consumers should specify a list of mux controllers that they > want to use with a property containing a 'mux-ctrl-list': > > - mux-ctrl-list ::= <single-mux-ctrl> [mux-ctrl-list] > - single-mux-ctrl ::= <mux-ctrl-phandle> [mux-ctrl-specifier] > + mux-ctrl-list := <single-mux-ctrl> [mux-ctrl-list] > + single-mux-ctrl := <mux-ctrl-phandle> [mux-ctrl-specifier] [Severity: Low] Does this unintentionally change the standard Backus-Naur Form (BNF) ::= operator to :=? It looks like a global search-and-replace for :: might have accidentally caught these BNF production rules. -- Sashiko AI review · https://sashiko.dev/#/patchset/20260622101606.485961-3-krzysztof.kozlowski@oss.qualcomm.com?part=2 ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH 2/2] dt-bindings: Drop incorrect usage of double '::' 2026-06-22 10:19 ` sashiko-bot @ 2026-06-22 13:23 ` Krzysztof Kozlowski 2026-06-22 16:53 ` Conor Dooley 0 siblings, 1 reply; 10+ messages in thread From: Krzysztof Kozlowski @ 2026-06-22 13:23 UTC (permalink / raw) To: sashiko-reviews Cc: neil.armstrong, vkoul, dri-devel, robh, conor+dt, linux-phy, olteanv, devicetree, wsa+renesas On 22/06/2026 12:19, sashiko-bot@kernel.org wrote: > Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider: > - [Low] Unintended replacement of BNF notation `::=` with `:=`. > -- > > commit a9fdd0b065eb5b6394a9c33ffba0fd5194e80115 > Author: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> > > dt-bindings: Drop incorrect usage of double '::' > > This commit cleans up device tree binding schemas by removing the redundant > double colons at the end of descriptions inside YAML literal style blocks. > > Link: https://yaml.org/spec/1.2.2/#literal-style [1] > >> diff --git a/Documentation/devicetree/bindings/mux/mux-consumer.yaml b/Documentation/devicetree/bindings/mux/mux-consumer.yaml >> index 9e2d78a78e409..769243a2bf046 100644 >> --- a/Documentation/devicetree/bindings/mux/mux-consumer.yaml >> +++ b/Documentation/devicetree/bindings/mux/mux-consumer.yaml >> @@ -13,8 +13,8 @@ description: | >> Mux controller consumers should specify a list of mux controllers that they >> want to use with a property containing a 'mux-ctrl-list': >> >> - mux-ctrl-list ::= <single-mux-ctrl> [mux-ctrl-list] >> - single-mux-ctrl ::= <mux-ctrl-phandle> [mux-ctrl-specifier] >> + mux-ctrl-list := <single-mux-ctrl> [mux-ctrl-list] >> + single-mux-ctrl := <mux-ctrl-phandle> [mux-ctrl-specifier] > > [Severity: Low] > Does this unintentionally change the standard Backus-Naur Form (BNF) ::= > operator to :=? It looks like a global search-and-replace for :: might I wasn't sure about that... and indeed this should not be changed. I will send a v2. Best regards, Krzysztof ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH 2/2] dt-bindings: Drop incorrect usage of double '::' 2026-06-22 13:23 ` Krzysztof Kozlowski @ 2026-06-22 16:53 ` Conor Dooley 0 siblings, 0 replies; 10+ messages in thread From: Conor Dooley @ 2026-06-22 16:53 UTC (permalink / raw) To: Krzysztof Kozlowski Cc: sashiko-reviews, neil.armstrong, vkoul, dri-devel, robh, conor+dt, linux-phy, olteanv, devicetree, wsa+renesas [-- Attachment #1: Type: text/plain, Size: 2123 bytes --] On Mon, Jun 22, 2026 at 03:23:05PM +0200, Krzysztof Kozlowski wrote: > On 22/06/2026 12:19, sashiko-bot@kernel.org wrote: > > Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider: > > - [Low] Unintended replacement of BNF notation `::=` with `:=`. > > -- > > > > commit a9fdd0b065eb5b6394a9c33ffba0fd5194e80115 > > Author: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> > > > > dt-bindings: Drop incorrect usage of double '::' > > > > This commit cleans up device tree binding schemas by removing the redundant > > double colons at the end of descriptions inside YAML literal style blocks. > > > > Link: https://yaml.org/spec/1.2.2/#literal-style [1] > > > >> diff --git a/Documentation/devicetree/bindings/mux/mux-consumer.yaml b/Documentation/devicetree/bindings/mux/mux-consumer.yaml > >> index 9e2d78a78e409..769243a2bf046 100644 > >> --- a/Documentation/devicetree/bindings/mux/mux-consumer.yaml > >> +++ b/Documentation/devicetree/bindings/mux/mux-consumer.yaml > >> @@ -13,8 +13,8 @@ description: | > >> Mux controller consumers should specify a list of mux controllers that they > >> want to use with a property containing a 'mux-ctrl-list': > >> > >> - mux-ctrl-list ::= <single-mux-ctrl> [mux-ctrl-list] > >> - single-mux-ctrl ::= <mux-ctrl-phandle> [mux-ctrl-specifier] > >> + mux-ctrl-list := <single-mux-ctrl> [mux-ctrl-list] > >> + single-mux-ctrl := <mux-ctrl-phandle> [mux-ctrl-specifier] > > > > [Severity: Low] > > Does this unintentionally change the standard Backus-Naur Form (BNF) ::= > > operator to :=? It looks like a global search-and-replace for :: might > > > I wasn't sure about that... and indeed this should not be changed. I > will send a v2. Other than this one that I agree shouldn't be changed to a single :, Acked-by: Conor Dooley <conor.dooley@microchip.com> (Although I find the syntax used here to be really confusing and a good example in the text would be a lot clearer. OTOH, how to write consumers is, I think, well understood, since they all work the same.) [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 228 bytes --] ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH 2/2] dt-bindings: Drop incorrect usage of double '::' 2026-06-22 10:16 ` [PATCH 2/2] dt-bindings: " Krzysztof Kozlowski 2026-06-22 10:19 ` sashiko-bot @ 2026-06-22 10:32 ` Geert Uytterhoeven 2026-06-22 10:48 ` Mark Brown ` (2 subsequent siblings) 4 siblings, 0 replies; 10+ messages in thread From: Geert Uytterhoeven @ 2026-06-22 10:32 UTC (permalink / raw) To: Krzysztof Kozlowski Cc: Bjorn Andersson, Konrad Dybcio, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Peter Griffin, Alim Akhtar, Michael Turquette, Stephen Boyd, Brian Masney, Sylwester Nawrocki, Chanwoo Choi, Sam Protsenko, Rob Clark, Dmitry Baryshkov, Abhinav Kumar, Jessica Zhang, Sean Paul, Marijn Suijten, David Airlie, Simona Vetter, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, Inki Dae, Seung-Woo Kim, Kyungmin Park, Andi Shyti, Georgi Djakov, Lee Jones, Pavel Machek, Hans Verkuil, Mauro Carvalho Chehab, Ulf Hansson, Peter Rosin, Vinod Koul, Neil Armstrong, Linus Walleij, Geert Uytterhoeven, Magnus Damm, Sebastian Reichel, Javier Martinez Canillas, Liam Girdwood, Mark Brown, Greg Kroah-Hartman, Jiri Slaby, Srinivas Kandagatla, Bartlomiej Zolnierkiewicz, Rafael J. Wysocki, Daniel Lezcano, Zhang Rui, Lukasz Luba, Jonathan Marek, Taniya Das, Robert Marko, Christian Marangi, Stephan Gerhold, Adam Skladowski, Sireesh Kodali, Barnabas Czeman, Imran Shaik, Sricharan Ramabadhran, Anusha Rao, Luo Jie, Tomasz Figa, Chanho Park, Sunyeal Hong, Shin Son, Krishna Manikandan, Jacek Anaszewski, Jaehoon Chung, Marek Szyprowski, Alina Yu, Andy Gross, Niklas Söderlund, Wesley Cheng, linux-arm-msm, devicetree, linux-kernel, linux-arm-kernel, linux-samsung-soc, linux-clk, dri-devel, freedreno, linux-i2c, linux-pm, linux-leds, linux-media, linux-mmc, linux-phy, linux-gpio, linux-renesas-soc, linux-serial, linux-sound, linux-usb On Mon, 22 Jun 2026 at 12:16, Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> wrote: > There is no use of double colon '::' in YAML. OTOH, the literal style > block, e.g. using '|' treats all characters as content [1] therefore > single use of ':' in descriptions is perfectly fine, whenever '|' is > used. > > Cleanup existing code, so the confusing style won't be re-used in new > contributions. > > Link: https://yaml.org/spec/1.2.2/#literal-style [1] > Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> > > --- > > Intention for this patch is to go via Rob's tree. > .../bindings/power/renesas,rcar-sysc.yaml | 2 +- > .../bindings/soc/renesas/renesas-soc.yaml | 4 ++-- Acked-by: Geert Uytterhoeven <geert+renesas@glider.be> # renesas Gr{oetje,eeting}s, Geert -- Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@linux-m68k.org In personal conversations with technical people, I call myself a hacker. But when I'm talking to journalists I just say "programmer" or something like that. -- Linus Torvalds ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH 2/2] dt-bindings: Drop incorrect usage of double '::' 2026-06-22 10:16 ` [PATCH 2/2] dt-bindings: " Krzysztof Kozlowski 2026-06-22 10:19 ` sashiko-bot 2026-06-22 10:32 ` Geert Uytterhoeven @ 2026-06-22 10:48 ` Mark Brown 2026-06-22 11:08 ` Niklas Söderlund 2026-06-22 20:37 ` Sebastian Reichel 4 siblings, 0 replies; 10+ messages in thread From: Mark Brown @ 2026-06-22 10:48 UTC (permalink / raw) To: Krzysztof Kozlowski Cc: Bjorn Andersson, Konrad Dybcio, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Peter Griffin, Alim Akhtar, Michael Turquette, Stephen Boyd, Brian Masney, Sylwester Nawrocki, Chanwoo Choi, Sam Protsenko, Rob Clark, Dmitry Baryshkov, Abhinav Kumar, Jessica Zhang, Sean Paul, Marijn Suijten, David Airlie, Simona Vetter, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, Inki Dae, Seung-Woo Kim, Kyungmin Park, Andi Shyti, Georgi Djakov, Lee Jones, Pavel Machek, Hans Verkuil, Mauro Carvalho Chehab, Ulf Hansson, Peter Rosin, Vinod Koul, Neil Armstrong, Linus Walleij, Geert Uytterhoeven, Magnus Damm, Sebastian Reichel, Javier Martinez Canillas, Liam Girdwood, Greg Kroah-Hartman, Jiri Slaby, Srinivas Kandagatla, Bartlomiej Zolnierkiewicz, Rafael J. Wysocki, Daniel Lezcano, Zhang Rui, Lukasz Luba, Jonathan Marek, Taniya Das, Robert Marko, Christian Marangi, Stephan Gerhold, Adam Skladowski, Sireesh Kodali, Barnabas Czeman, Imran Shaik, Sricharan Ramabadhran, Anusha Rao, Luo Jie, Tomasz Figa, Chanho Park, Sunyeal Hong, Shin Son, Krishna Manikandan, Jacek Anaszewski, Jaehoon Chung, Marek Szyprowski, Alina Yu, Andy Gross, Niklas Söderlund, Wesley Cheng, linux-arm-msm, devicetree, linux-kernel, linux-arm-kernel, linux-samsung-soc, linux-clk, dri-devel, freedreno, linux-i2c, linux-pm, linux-leds, linux-media, linux-mmc, linux-phy, linux-gpio, linux-renesas-soc, linux-serial, linux-sound, linux-usb [-- Attachment #1: Type: text/plain, Size: 334 bytes --] On Mon, Jun 22, 2026 at 12:16:08PM +0200, Krzysztof Kozlowski wrote: > There is no use of double colon '::' in YAML. OTOH, the literal style > block, e.g. using '|' treats all characters as content [1] therefore > single use of ':' in descriptions is perfectly fine, whenever '|' is > used. Acked-by: Mark Brown <broonie@kernel.org> [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 488 bytes --] ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH 2/2] dt-bindings: Drop incorrect usage of double '::' 2026-06-22 10:16 ` [PATCH 2/2] dt-bindings: " Krzysztof Kozlowski ` (2 preceding siblings ...) 2026-06-22 10:48 ` Mark Brown @ 2026-06-22 11:08 ` Niklas Söderlund 2026-06-22 20:37 ` Sebastian Reichel 4 siblings, 0 replies; 10+ messages in thread From: Niklas Söderlund @ 2026-06-22 11:08 UTC (permalink / raw) To: Krzysztof Kozlowski Cc: Bjorn Andersson, Konrad Dybcio, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Peter Griffin, Alim Akhtar, Michael Turquette, Stephen Boyd, Brian Masney, Sylwester Nawrocki, Chanwoo Choi, Sam Protsenko, Rob Clark, Dmitry Baryshkov, Abhinav Kumar, Jessica Zhang, Sean Paul, Marijn Suijten, David Airlie, Simona Vetter, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, Inki Dae, Seung-Woo Kim, Kyungmin Park, Andi Shyti, Georgi Djakov, Lee Jones, Pavel Machek, Hans Verkuil, Mauro Carvalho Chehab, Ulf Hansson, Peter Rosin, Vinod Koul, Neil Armstrong, Linus Walleij, Geert Uytterhoeven, Magnus Damm, Sebastian Reichel, Javier Martinez Canillas, Liam Girdwood, Mark Brown, Greg Kroah-Hartman, Jiri Slaby, Srinivas Kandagatla, Bartlomiej Zolnierkiewicz, Rafael J. Wysocki, Daniel Lezcano, Zhang Rui, Lukasz Luba, Jonathan Marek, Taniya Das, Robert Marko, Christian Marangi, Stephan Gerhold, Adam Skladowski, Sireesh Kodali, Barnabas Czeman, Imran Shaik, Sricharan Ramabadhran, Anusha Rao, Luo Jie, Tomasz Figa, Chanho Park, Sunyeal Hong, Shin Son, Krishna Manikandan, Jacek Anaszewski, Jaehoon Chung, Marek Szyprowski, Alina Yu, Andy Gross, Wesley Cheng, linux-arm-msm, devicetree, linux-kernel, linux-arm-kernel, linux-samsung-soc, linux-clk, dri-devel, freedreno, linux-i2c, linux-pm, linux-leds, linux-media, linux-mmc, linux-phy, linux-gpio, linux-renesas-soc, linux-serial, linux-sound, linux-usb Hi Krzysztof, Thanks for your work. On 2026-06-22 12:16:08 +0200, Krzysztof Kozlowski wrote: > There is no use of double colon '::' in YAML. OTOH, the literal style > block, e.g. using '|' treats all characters as content [1] therefore > single use of ':' in descriptions is perfectly fine, whenever '|' is > used. > > Cleanup existing code, so the confusing style won't be re-used in new > contributions. > > Link: https://yaml.org/spec/1.2.2/#literal-style [1] > Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> For the two Renesas bindings, Reviewed-by: Niklas Söderlund <niklas.soderlund+renesas@ragnatech.se> > > --- > > Intention for this patch is to go via Rob's tree. > --- > .../devicetree/bindings/arm/qcom-soc.yaml | 4 ++-- > .../devicetree/bindings/arm/qcom.yaml | 4 ++-- > .../bindings/arm/samsung/samsung-soc.yaml | 4 ++-- > .../display/msm/dsi-controller-main.yaml | 20 +++++++++---------- > .../display/samsung/samsung,fimd.yaml | 4 ++-- > .../bindings/i2c/samsung,s3c2410-i2c.yaml | 2 +- > .../interconnect/qcom,msm8998-bwmon.yaml | 2 +- > .../interconnect/samsung,exynos-bus.yaml | 14 ++++++------- > .../bindings/leds/qcom,pm8058-led.yaml | 4 ++-- > .../bindings/leds/skyworks,aat1290.yaml | 6 +++--- > .../bindings/media/cec/cec-gpio.yaml | 2 +- > .../bindings/mmc/samsung,exynos-dw-mshc.yaml | 2 +- > .../devicetree/bindings/mux/mux-consumer.yaml | 4 ++-- > .../bindings/phy/samsung,mipi-video-phy.yaml | 4 ++-- > .../bindings/phy/samsung,usb2-phy.yaml | 2 +- > .../bindings/phy/samsung,usb3-drd-phy.yaml | 2 +- > .../bindings/pinctrl/samsung,pinctrl.yaml | 2 +- > .../bindings/power/renesas,rcar-sysc.yaml | 2 +- > .../bindings/power/reset/restart-handler.yaml | 8 ++++---- > .../bindings/regulator/maxim,max77802.yaml | 4 ++-- > .../bindings/regulator/richtek,rtq2208.yaml | 2 +- > .../bindings/serial/qcom,msm-uartdm.yaml | 2 +- > .../devicetree/bindings/slimbus/slimbus.yaml | 4 ++-- > .../bindings/soc/qcom/qcom,apr-services.yaml | 2 +- > .../bindings/soc/qcom/qcom,rpmh-rsc.yaml | 8 ++++---- > .../bindings/soc/qcom/qcom,wcnss.yaml | 2 +- > .../bindings/soc/renesas/renesas-soc.yaml | 4 ++-- > .../bindings/sound/qcom,q6asm-dais.yaml | 2 +- > .../thermal/samsung,exynos-thermal.yaml | 4 ++-- > .../devicetree/bindings/usb/qcom,dwc3.yaml | 12 +++++------ > .../bindings/usb/qcom,snps-dwc3.yaml | 12 +++++------ > 31 files changed, 75 insertions(+), 75 deletions(-) > > diff --git a/Documentation/devicetree/bindings/arm/qcom-soc.yaml b/Documentation/devicetree/bindings/arm/qcom-soc.yaml > index 27261039d56f..37fdd5a080b7 100644 > --- a/Documentation/devicetree/bindings/arm/qcom-soc.yaml > +++ b/Documentation/devicetree/bindings/arm/qcom-soc.yaml > @@ -11,10 +11,10 @@ maintainers: > > description: | > Guidelines for new compatibles for SoC blocks/components. > - When adding new compatibles in new bindings, use the format:: > + When adding new compatibles in new bindings, use the format: > qcom,SoC-IP > > - For example:: > + For example: > qcom,sdm845-llcc-bwmon > > When adding new compatibles to existing bindings, use the format in the > diff --git a/Documentation/devicetree/bindings/arm/qcom.yaml b/Documentation/devicetree/bindings/arm/qcom.yaml > index 50cc18a6ec5e..667607ae2c32 100644 > --- a/Documentation/devicetree/bindings/arm/qcom.yaml > +++ b/Documentation/devicetree/bindings/arm/qcom.yaml > @@ -1215,7 +1215,7 @@ properties: > items: > items: > - description: | > - MSM chipset ID - an exact match value consisting of two bitfields:: > + MSM chipset ID - an exact match value consisting of two bitfields: > - bits 0-15 - The unique MSM chipset ID > - bits 16-31 - Reserved; should be 0 > - description: | > @@ -1241,7 +1241,7 @@ properties: > - items: > - items: > - description: | > - Board ID consisting of three bitfields:: > + Board ID consisting of three bitfields: > - bits 31-24 - Unused > - bits 23-16 - Platform Version Major > - bits 15-8 - Platform Version Minor > diff --git a/Documentation/devicetree/bindings/arm/samsung/samsung-soc.yaml b/Documentation/devicetree/bindings/arm/samsung/samsung-soc.yaml > index 653f85997643..ab000befe76d 100644 > --- a/Documentation/devicetree/bindings/arm/samsung/samsung-soc.yaml > +++ b/Documentation/devicetree/bindings/arm/samsung/samsung-soc.yaml > @@ -11,10 +11,10 @@ maintainers: > > description: | > Guidelines for new compatibles for SoC blocks/components. > - When adding new compatibles in new bindings, use the format:: > + When adding new compatibles in new bindings, use the format: > samsung,SoC-IP > > - For example:: > + For example: > samsung,exynos5433-cmu-isp > > select: > diff --git a/Documentation/devicetree/bindings/display/msm/dsi-controller-main.yaml b/Documentation/devicetree/bindings/display/msm/dsi-controller-main.yaml > index dbc0613e427e..395425a70db8 100644 > --- a/Documentation/devicetree/bindings/display/msm/dsi-controller-main.yaml > +++ b/Documentation/devicetree/bindings/display/msm/dsi-controller-main.yaml > @@ -73,16 +73,16 @@ properties: > > clocks: > description: | > - Several clocks are used, depending on the variant. Typical ones are:: > - - bus:: Display AHB clock. > - - byte:: Display byte clock. > - - byte_intf:: Display byte interface clock. > - - core:: Display core clock. > - - core_mss:: Core MultiMedia SubSystem clock. > - - iface:: Display AXI clock. > - - mdp_core:: MDP Core clock. > - - mnoc:: MNOC clock > - - pixel:: Display pixel clock. > + Several clocks are used, depending on the variant. Typical ones are: > + - bus: Display AHB clock. > + - byte: Display byte clock. > + - byte_intf: Display byte interface clock. > + - core: Display core clock. > + - core_mss: Core MultiMedia SubSystem clock. > + - iface: Display AXI clock. > + - mdp_core: MDP Core clock. > + - mnoc: MNOC clock > + - pixel: Display pixel clock. > minItems: 3 > maxItems: 12 > > diff --git a/Documentation/devicetree/bindings/display/samsung/samsung,fimd.yaml b/Documentation/devicetree/bindings/display/samsung/samsung,fimd.yaml > index ff685031bb2c..729705f419bb 100644 > --- a/Documentation/devicetree/bindings/display/samsung/samsung,fimd.yaml > +++ b/Documentation/devicetree/bindings/display/samsung/samsung,fimd.yaml > @@ -41,7 +41,7 @@ properties: > additionalProperties: false > description: | > Timing configuration for lcd i80 interface support. > - The parameters are defined as:: > + The parameters are defined as: > VCLK(internal) __|??????|_____|??????|_____|??????|_____|??????|_____|?? > : : : : : > Address Output --:<XXXXXXXXXXX:XXXXXXXXXXXX:XXXXXXXXXXXX:XXXXXXXXXXXX:XX > @@ -132,7 +132,7 @@ patternProperties: > "^port@[0-4]+$": > $ref: /schemas/graph.yaml#/properties/port > description: | > - Contains ports with port with index:: > + Contains ports with port with index: > 0 - for CAMIF0 input, > 1 - for CAMIF1 input, > 2 - for CAMIF2 input, > diff --git a/Documentation/devicetree/bindings/i2c/samsung,s3c2410-i2c.yaml b/Documentation/devicetree/bindings/i2c/samsung,s3c2410-i2c.yaml > index a2ddc6803617..07600b49f2f9 100644 > --- a/Documentation/devicetree/bindings/i2c/samsung,s3c2410-i2c.yaml > +++ b/Documentation/devicetree/bindings/i2c/samsung,s3c2410-i2c.yaml > @@ -35,7 +35,7 @@ properties: > > gpios: > description: | > - The order of the GPIOs should be the following:: <SDA, SCL>. The GPIO > + The order of the GPIOs should be the following: <SDA, SCL>. The GPIO > specifier depends on the gpio controller. Required in all cases except > for "samsung,s3c2440-hdmiphy-i2c" whose input/output lines are > permanently wired to the respective client. > diff --git a/Documentation/devicetree/bindings/interconnect/qcom,msm8998-bwmon.yaml b/Documentation/devicetree/bindings/interconnect/qcom,msm8998-bwmon.yaml > index ff64225e8281..e002e70580f9 100644 > --- a/Documentation/devicetree/bindings/interconnect/qcom,msm8998-bwmon.yaml > +++ b/Documentation/devicetree/bindings/interconnect/qcom,msm8998-bwmon.yaml > @@ -13,7 +13,7 @@ description: | > Bandwidth Monitor measures current throughput on buses between various NoC > fabrics and provides information when it crosses configured thresholds. > > - Certain SoCs might have more than one Bandwidth Monitors, for example on SDM845:: > + Certain SoCs might have more than one Bandwidth Monitors, for example on SDM845: > - Measuring the bandwidth between CPUs and Last Level Cache Controller - > called just BWMON, > - Measuring the bandwidth between Last Level Cache Controller and memory > diff --git a/Documentation/devicetree/bindings/interconnect/samsung,exynos-bus.yaml b/Documentation/devicetree/bindings/interconnect/samsung,exynos-bus.yaml > index 5e26e48c7217..0203959c8995 100644 > --- a/Documentation/devicetree/bindings/interconnect/samsung,exynos-bus.yaml > +++ b/Documentation/devicetree/bindings/interconnect/samsung,exynos-bus.yaml > @@ -23,7 +23,7 @@ description: | > The each AXI bus has the owned source clock but, has not the only owned power > line. The power line might be shared among one more sub-blocks. So, we can > divide into two type of device as the role of each sub-block. There are two > - type of bus devices as following:: > + type of bus devices as following: > - parent bus device > - passive bus device > > @@ -44,8 +44,8 @@ description: | > able to support the bus frequency for all Exynos SoCs. > > Detailed correlation between sub-blocks and power line according > - to Exynos SoC:: > - - In case of Exynos3250, there are two power line as following:: > + to Exynos SoC: > + - In case of Exynos3250, there are two power line as following: > VDD_MIF |--- DMC (Dynamic Memory Controller) > > VDD_INT |--- LEFTBUS (parent device) > @@ -89,7 +89,7 @@ description: | > |L5 |200000 |200000 |400000 |300000 | ||1000000 | > ---------------------------------------------------------- > > - - In case of Exynos4210, there is one power line as following:: > + - In case of Exynos4210, there is one power line as following: > VDD_INT |--- DMC (parent device, Dynamic Memory Controller) > |--- LEFTBUS > |--- PERIL > @@ -106,7 +106,7 @@ description: | > |--- LCD0 > |--- LCD1 > > - - In case of Exynos4x12, there are two power line as following:: > + - In case of Exynos4x12, there are two power line as following: > VDD_MIF |--- DMC (Dynamic Memory Controller) > > VDD_INT |--- LEFTBUS (parent device) > @@ -124,7 +124,7 @@ description: | > |--- LCD0 > |--- ISP > > - - In case of Exynos5422, there are two power line as following:: > + - In case of Exynos5422, there are two power line as following: > VDD_MIF |--- DREX 0 (parent device, DRAM EXpress controller) > |--- DREX 1 > > @@ -143,7 +143,7 @@ description: | > |--- FSYS > |--- FSYS2 > > - - In case of Exynos5433, there is VDD_INT power line as following:: > + - In case of Exynos5433, there is VDD_INT power line as following: > VDD_INT |--- G2D (parent device) > |--- MSCL > |--- GSCL > diff --git a/Documentation/devicetree/bindings/leds/qcom,pm8058-led.yaml b/Documentation/devicetree/bindings/leds/qcom,pm8058-led.yaml > index b409b2a8b5c5..5165bfddcd54 100644 > --- a/Documentation/devicetree/bindings/leds/qcom,pm8058-led.yaml > +++ b/Documentation/devicetree/bindings/leds/qcom,pm8058-led.yaml > @@ -10,10 +10,10 @@ maintainers: > - Krzysztof Kozlowski <krzk@kernel.org> > > description: | > - The Qualcomm PM8058 contains an LED block for up to six LEDs:: three normal > + The Qualcomm PM8058 contains an LED block for up to six LEDs: three normal > LEDs, two "flash" LEDs and one "keypad backlight" LED. The names are quoted > because sometimes these LED drivers are used for wildly different things than > - flash or keypad backlight:: their names are more of a suggestion than a > + flash or keypad backlight: their names are more of a suggestion than a > hard-wired usecase. > > Hardware-wise the different LEDs support slightly different output currents. > diff --git a/Documentation/devicetree/bindings/leds/skyworks,aat1290.yaml b/Documentation/devicetree/bindings/leds/skyworks,aat1290.yaml > index a6aaa92dbccd..65576dfdca11 100644 > --- a/Documentation/devicetree/bindings/leds/skyworks,aat1290.yaml > +++ b/Documentation/devicetree/bindings/leds/skyworks,aat1290.yaml > @@ -11,7 +11,7 @@ maintainers: > - Krzysztof Kozlowski <krzk@kernel.org> > > description: | > - The device is controlled through two pins:: FL_EN and EN_SET. The pins when, > + The device is controlled through two pins: FL_EN and EN_SET. The pins when, > asserted high, enable flash strobe and movie mode (max 1/2 of flash current) > respectively. In order to add a capability of selecting the strobe signal > source (e.g. CPU or camera sensor) there is an additional switch required, > @@ -39,11 +39,11 @@ properties: > flash-max-microamp: > description: | > Maximum flash LED supply current can be calculated using following > - formula:: I = 1A * 162 kOhm / Rset. > + formula: I = 1A * 162 kOhm / Rset. > > flash-max-timeout-us: > description: | > - Maximum flash timeout can be calculated using following formula:: > + Maximum flash timeout can be calculated using following formula: > T = 8.82 * 10^9 * Ct. > > required: > diff --git a/Documentation/devicetree/bindings/media/cec/cec-gpio.yaml b/Documentation/devicetree/bindings/media/cec/cec-gpio.yaml > index 582c6c9cae48..21118e4bae0f 100644 > --- a/Documentation/devicetree/bindings/media/cec/cec-gpio.yaml > +++ b/Documentation/devicetree/bindings/media/cec/cec-gpio.yaml > @@ -14,7 +14,7 @@ description: | > hooked up to a pull-up GPIO line and - optionally - the HPD line is hooked up > to another GPIO line. > > - Please note:: the maximum voltage for the CEC line is 3.63V, for the HPD and > + Please note: the maximum voltage for the CEC line is 3.63V, for the HPD and > 5V lines it is 5.3V. So you may need some sort of level conversion > circuitry when connecting them to a GPIO line. > > diff --git a/Documentation/devicetree/bindings/mmc/samsung,exynos-dw-mshc.yaml b/Documentation/devicetree/bindings/mmc/samsung,exynos-dw-mshc.yaml > index 27c4060f2f91..223fcc9f651f 100644 > --- a/Documentation/devicetree/bindings/mmc/samsung,exynos-dw-mshc.yaml > +++ b/Documentation/devicetree/bindings/mmc/samsung,exynos-dw-mshc.yaml > @@ -85,7 +85,7 @@ properties: > description: | > The value of CIU TX and RX clock phase shift value for HS400 mode > operation. > - Valid values for SDR and DDR CIU clock timing:: > + Valid values for SDR and DDR CIU clock timing: > - valid value for tx phase shift and rx phase shift is 0 to 7. > - when CIU clock divider value is set to 3, all possible 8 phase shift > values can be used. > diff --git a/Documentation/devicetree/bindings/mux/mux-consumer.yaml b/Documentation/devicetree/bindings/mux/mux-consumer.yaml > index 9e2d78a78e40..769243a2bf04 100644 > --- a/Documentation/devicetree/bindings/mux/mux-consumer.yaml > +++ b/Documentation/devicetree/bindings/mux/mux-consumer.yaml > @@ -13,8 +13,8 @@ description: | > Mux controller consumers should specify a list of mux controllers that they > want to use with a property containing a 'mux-ctrl-list': > > - mux-ctrl-list ::= <single-mux-ctrl> [mux-ctrl-list] > - single-mux-ctrl ::= <mux-ctrl-phandle> [mux-ctrl-specifier] > + mux-ctrl-list := <single-mux-ctrl> [mux-ctrl-list] > + single-mux-ctrl := <mux-ctrl-phandle> [mux-ctrl-specifier] > mux-ctrl-phandle : phandle to mux controller node > mux-ctrl-specifier : array of #mux-control-cells specifying the > given mux controller (controller specific) > diff --git a/Documentation/devicetree/bindings/phy/samsung,mipi-video-phy.yaml b/Documentation/devicetree/bindings/phy/samsung,mipi-video-phy.yaml > index 16967ef8e9ec..87b6a35b2626 100644 > --- a/Documentation/devicetree/bindings/phy/samsung,mipi-video-phy.yaml > +++ b/Documentation/devicetree/bindings/phy/samsung,mipi-video-phy.yaml > @@ -13,14 +13,14 @@ maintainers: > > description: | > For samsung,s5pv210-mipi-video-phy compatible PHYs the second cell in the > - PHY specifier identifies the PHY and its meaning is as follows:: > + PHY specifier identifies the PHY and its meaning is as follows: > 0 - MIPI CSIS 0, > 1 - MIPI DSIM 0, > 2 - MIPI CSIS 1, > 3 - MIPI DSIM 1. > > samsung,exynos5420-mipi-video-phy and samsung,exynos5433-mipi-video-phy > - support additional fifth PHY:: > + support additional fifth PHY: > 4 - MIPI CSIS 2. > > properties: > diff --git a/Documentation/devicetree/bindings/phy/samsung,usb2-phy.yaml b/Documentation/devicetree/bindings/phy/samsung,usb2-phy.yaml > index d9f22a801cbf..7db7605a82e2 100644 > --- a/Documentation/devicetree/bindings/phy/samsung,usb2-phy.yaml > +++ b/Documentation/devicetree/bindings/phy/samsung,usb2-phy.yaml > @@ -14,7 +14,7 @@ maintainers: > description: | > The first phandle argument in the PHY specifier identifies the PHY, its > meaning is compatible dependent. For the currently supported SoCs (Exynos4210 > - and Exynos4212) it is as follows:: > + and Exynos4212) it is as follows: > 0 - USB device ("device"), > 1 - USB host ("host"), > 2 - HSIC0 ("hsic0"), > diff --git a/Documentation/devicetree/bindings/phy/samsung,usb3-drd-phy.yaml b/Documentation/devicetree/bindings/phy/samsung,usb3-drd-phy.yaml > index 4562e0468f4f..a1b3d9e6a094 100644 > --- a/Documentation/devicetree/bindings/phy/samsung,usb3-drd-phy.yaml > +++ b/Documentation/devicetree/bindings/phy/samsung,usb3-drd-phy.yaml > @@ -14,7 +14,7 @@ maintainers: > description: | > For samsung,exynos5250-usbdrd-phy and samsung,exynos5420-usbdrd-phy > compatible PHYs, the second cell in the PHY specifier identifies the > - PHY id, which is interpreted as follows:: > + PHY id, which is interpreted as follows: > 0 - UTMI+ type phy, > 1 - PIPE3 type phy. > > diff --git a/Documentation/devicetree/bindings/pinctrl/samsung,pinctrl.yaml b/Documentation/devicetree/bindings/pinctrl/samsung,pinctrl.yaml > index 7b006009ca0e..5e35686eeed3 100644 > --- a/Documentation/devicetree/bindings/pinctrl/samsung,pinctrl.yaml > +++ b/Documentation/devicetree/bindings/pinctrl/samsung,pinctrl.yaml > @@ -18,7 +18,7 @@ description: | > All the pin controller nodes should be represented in the aliases node using > the following format 'pinctrl{n}' where n is a unique number for the alias. > > - The controller supports three types of interrupts:: > + The controller supports three types of interrupts: > - External GPIO interrupts (see interrupts property in pin controller node); > > - External wake-up interrupts - multiplexed (capable of waking up the system > diff --git a/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml b/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml > index 347571e2545a..b67aa170b2c1 100644 > --- a/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml > +++ b/Documentation/devicetree/bindings/power/renesas,rcar-sysc.yaml > @@ -13,7 +13,7 @@ maintainers: > description: | > The R-Car (RZ/G) System Controller provides power management for the CPU > cores and various coprocessors. > - The power domain IDs for consumers are defined in header files:: > + The power domain IDs for consumers are defined in header files: > include/dt-bindings/power/r8*-sysc.h > > properties: > diff --git a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml > index 965a834a3dbe..00c00ec5ec81 100644 > --- a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml > +++ b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml > @@ -18,12 +18,12 @@ properties: > priority: > $ref: /schemas/types.yaml#/definitions/uint32 > description: | > - A priority ranging from 0 to 255 according to the following guidelines:: > - 0:: Restart handler of last resort, with limited restart capabilities. > - 128:: Typical, default restart handler; use if no other restart handler > + A priority ranging from 0 to 255 according to the following guidelines: > + 0: Restart handler of last resort, with limited restart capabilities. > + 128: Typical, default restart handler; use if no other restart handler > is expected to be available, and/or if restart functionality is > sufficient to restart the entire system. > - 255:: Highest priority restart handler, will preempt all other restart handlers. > + 255: Highest priority restart handler, will preempt all other restart handlers. > minimum: 0 > maximum: 255 > > diff --git a/Documentation/devicetree/bindings/regulator/maxim,max77802.yaml b/Documentation/devicetree/bindings/regulator/maxim,max77802.yaml > index b704f05ea454..b886495c1396 100644 > --- a/Documentation/devicetree/bindings/regulator/maxim,max77802.yaml > +++ b/Documentation/devicetree/bindings/regulator/maxim,max77802.yaml > @@ -22,13 +22,13 @@ description: | > > Certain regulators support "regulator-initial-mode" and "regulator-mode". > The valid modes list is defined in the dt-bindings/regulator/maxim,max77802.h > - and their meaning is:: > + and their meaning is: > 1 - Normal regulator voltage output mode. > 3 - Low Power which reduces the quiescent current down to only 1uA > > The standard "regulator-mode" property can only be used for regulators that > support changing their mode to Low Power Mode during suspend. These > - regulators are:: bucks 2-4 and LDOs 1-35. Also, it only takes effect if the > + regulators are: bucks 2-4 and LDOs 1-35. Also, it only takes effect if the > regulator has been enabled for the given suspend state using > "regulator-on-in-suspend" and has not been disabled for that state using > "regulator-off-in-suspend". > diff --git a/Documentation/devicetree/bindings/regulator/richtek,rtq2208.yaml b/Documentation/devicetree/bindings/regulator/richtek,rtq2208.yaml > index 022c1f197364..b0aa38edf8c2 100644 > --- a/Documentation/devicetree/bindings/regulator/richtek,rtq2208.yaml > +++ b/Documentation/devicetree/bindings/regulator/richtek,rtq2208.yaml > @@ -21,7 +21,7 @@ description: | > conduction mode (FCCM). > > The definition of modes is in the datasheet which is available in below link > - and their meaning is:: > + and their meaning is: > 0 - Auto mode for power saving, which reducing the switching frequency at light load condition > to maintain high frequency. > 1 - FCCM to meet the strict voltage regulation accuracy, which keeping constant switching frequency. > diff --git a/Documentation/devicetree/bindings/serial/qcom,msm-uartdm.yaml b/Documentation/devicetree/bindings/serial/qcom,msm-uartdm.yaml > index 788ef5c1c446..bc967ead2350 100644 > --- a/Documentation/devicetree/bindings/serial/qcom,msm-uartdm.yaml > +++ b/Documentation/devicetree/bindings/serial/qcom,msm-uartdm.yaml > @@ -17,7 +17,7 @@ description: | > software perspective it's mostly compatible with the MSM serial UART except > that it supports reading and writing multiple characters at a time. > > - Note:: Aliases may be defined to ensure the correct ordering of the UARTs. > + Note: Aliases may be defined to ensure the correct ordering of the UARTs. > The alias serialN will result in the UART being assigned port N. If any > serialN alias exists, then an alias must exist for each enabled UART. The > serialN aliases should be in a .dts file instead of in a .dtsi file. > diff --git a/Documentation/devicetree/bindings/slimbus/slimbus.yaml b/Documentation/devicetree/bindings/slimbus/slimbus.yaml > index 5a941610ce4e..3910327c8ded 100644 > --- a/Documentation/devicetree/bindings/slimbus/slimbus.yaml > +++ b/Documentation/devicetree/bindings/slimbus/slimbus.yaml > @@ -29,7 +29,7 @@ patternProperties: > description: | > Every SLIMbus controller node can contain zero or more child nodes > representing slave devices on the bus. Every SLIMbus slave device is > - uniquely determined by the enumeration address containing 4 fields:: > + uniquely determined by the enumeration address containing 4 fields: > Manufacturer ID, Product code, Device index, and Instance value for the > device. > > @@ -48,7 +48,7 @@ patternProperties: > reg: > maxItems: 1 > description: | > - Pair of (device index, instande ID), where:: > + Pair of (device index, instande ID), where: > - Device index, which uniquely identifies multiple devices within a > single component. > - Instance ID, can be used for the cases where multiple devices of > diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,apr-services.yaml b/Documentation/devicetree/bindings/soc/qcom/qcom,apr-services.yaml > index bdf482db32aa..b663be3ea5a1 100644 > --- a/Documentation/devicetree/bindings/soc/qcom/qcom,apr-services.yaml > +++ b/Documentation/devicetree/bindings/soc/qcom/qcom,apr-services.yaml > @@ -40,7 +40,7 @@ properties: > $ref: /schemas/types.yaml#/definitions/string-array > description: | > Protection domain service name and path for APR service (if supported). > - Possible values are:: > + Possible values are: > "avs/audio", "msm/adsp/audio_pd". > "kernel/elf_loader", "msm/modem/wlan_pd". > "tms/servreg", "msm/adsp/audio_pd". > diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,rpmh-rsc.yaml b/Documentation/devicetree/bindings/soc/qcom/qcom,rpmh-rsc.yaml > index 26d9bc773ec5..1889139a3f7a 100644 > --- a/Documentation/devicetree/bindings/soc/qcom/qcom,rpmh-rsc.yaml > +++ b/Documentation/devicetree/bindings/soc/qcom/qcom,rpmh-rsc.yaml > @@ -23,7 +23,7 @@ description: | > with a few variations that are captured by the properties here. > > A TCS may be triggered from Linux or triggered by the F/W after all the CPUs > - have powered off to facilitate idle power saving. TCS could be classified as:: > + have powered off to facilitate idle power saving. TCS could be classified as: > ACTIVE - Triggered by Linux > SLEEP - Triggered by F/W > WAKE - Triggered by F/W > @@ -76,7 +76,7 @@ properties: > items: > items: > - description: | > - TCS type:: > + TCS type: > - ACTIVE_TCS > - SLEEP_TCS > - WAKE_TCS > @@ -152,7 +152,7 @@ examples: > - | > // For a TCS whose RSC base address is 0x179C0000 and is at a DRV id of > // 2, the register offsets for DRV2 start at 0D00, the register > - // calculations are like this:: > + // calculations are like this: > // DRV0: 0x179C0000 > // DRV2: 0x179C0000 + 0x10000 = 0x179D0000 > // DRV2: 0x179C0000 + 0x10000 * 2 = 0x179E0000 > @@ -182,7 +182,7 @@ examples: > - | > // For a TCS whose RSC base address is 0xAF20000 and is at DRV id of 0, the > // register offsets for DRV0 start at 01C00, the register calculations are > - // like this:: > + // like this: > // DRV0: 0xAF20000 > // TCS-OFFSET: 0x1C00 > #include <dt-bindings/interrupt-controller/arm-gic.h> > diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.yaml b/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.yaml > index 4fcae6bedfff..72a7f8cb09ba 100644 > --- a/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.yaml > +++ b/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.yaml > @@ -28,7 +28,7 @@ properties: > $ref: /schemas/types.yaml#/definitions/phandle > description: | > Reference to a node specifying the wcnss "ccu" and "dxe" register blocks. > - The node must be compatible with one of the following:: > + The node must be compatible with one of the following: > - qcom,riva" > - qcom,pronto" > > diff --git a/Documentation/devicetree/bindings/soc/renesas/renesas-soc.yaml b/Documentation/devicetree/bindings/soc/renesas/renesas-soc.yaml > index 5ddd31f30f26..57c9d3c57021 100644 > --- a/Documentation/devicetree/bindings/soc/renesas/renesas-soc.yaml > +++ b/Documentation/devicetree/bindings/soc/renesas/renesas-soc.yaml > @@ -12,10 +12,10 @@ maintainers: > > description: | > Guidelines for new compatibles for SoC blocks/components. > - When adding new compatibles in new bindings, use the format:: > + When adding new compatibles in new bindings, use the format: > renesas,SoC-IP > > - For example:: > + For example: > renesas,r8a77965-csi2 > > When adding new compatibles to existing bindings, use the format in the > diff --git a/Documentation/devicetree/bindings/sound/qcom,q6asm-dais.yaml b/Documentation/devicetree/bindings/sound/qcom,q6asm-dais.yaml > index 47a105a97ecf..bc8c8ba24f9c 100644 > --- a/Documentation/devicetree/bindings/sound/qcom,q6asm-dais.yaml > +++ b/Documentation/devicetree/bindings/sound/qcom,q6asm-dais.yaml > @@ -45,7 +45,7 @@ patternProperties: > $ref: /schemas/types.yaml#/definitions/uint32 > enum: [0, 1, 2] > description: | > - The direction of the dai stream:: > + The direction of the dai stream: > - Q6ASM_DAI_TX_RX (0) for both tx and rx > - Q6ASM_DAI_TX (1) for only tx (Capture/Encode) > - Q6ASM_DAI_RX (2) for only rx (Playback/Decode) > diff --git a/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml b/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml > index 29a08b0729ee..3f333db72a71 100644 > --- a/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml > +++ b/Documentation/devicetree/bindings/thermal/samsung,exynos-thermal.yaml > @@ -40,7 +40,7 @@ properties: > description: | > The Exynos TMU supports generating interrupts when reaching given > temperature thresholds. Number of supported thermal trip points depends > - on the SoC (only first trip points defined in DT will be configured):: > + on the SoC (only first trip points defined in DT will be configured): > - most of SoC: 4 > - samsung,exynos5433-tmu: 8 > - samsung,exynos7-tmu: 8 > @@ -52,7 +52,7 @@ properties: > - description: | > Shared TMU registers. > > - Note:: On Exynos5420, the TRIMINFO register is misplaced for TMU > + Note: On Exynos5420, the TRIMINFO register is misplaced for TMU > channels 2, 3 and 4 Use "samsung,exynos5420-tmu-ext-triminfo" in > cases, there is a misplaced register, also provide clock to access > that base. > diff --git a/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml b/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml > index a7f58114c02e..90daee616880 100644 > --- a/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml > +++ b/Documentation/devicetree/bindings/usb/qcom,dwc3.yaml > @@ -92,14 +92,14 @@ properties: > > clocks: > description: | > - Several clocks are used, depending on the variant. Typical ones are:: > - - cfg_noc:: System Config NOC clock. > - - core:: Master/Core clock, has to be >= 125 MHz for SS operation and >= > + Several clocks are used, depending on the variant. Typical ones are: > + - cfg_noc: System Config NOC clock. > + - core: Master/Core clock, has to be >= 125 MHz for SS operation and >= > 60MHz for HS operation. > - - iface:: System bus AXI clock. > - - sleep:: Sleep clock, used for wakeup when USB3 core goes into low > + - iface: System bus AXI clock. > + - sleep: Sleep clock, used for wakeup when USB3 core goes into low > power mode (U3). > - - mock_utmi:: Mock utmi clock needed for ITP/SOF generation in host > + - mock_utmi: Mock utmi clock needed for ITP/SOF generation in host > mode. Its frequency should be 19.2MHz. > minItems: 1 > maxItems: 9 > diff --git a/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml b/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml > index 8201656b41ed..d99af9f413d0 100644 > --- a/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml > +++ b/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml > @@ -87,14 +87,14 @@ properties: > > clocks: > description: | > - Several clocks are used, depending on the variant. Typical ones are:: > - - cfg_noc:: System Config NOC clock. > - - core:: Master/Core clock, has to be >= 125 MHz for SS operation and >= > + Several clocks are used, depending on the variant. Typical ones are: > + - cfg_noc: System Config NOC clock. > + - core: Master/Core clock, has to be >= 125 MHz for SS operation and >= > 60MHz for HS operation. > - - iface:: System bus AXI clock. > - - sleep:: Sleep clock, used for wakeup when USB3 core goes into low > + - iface: System bus AXI clock. > + - sleep: Sleep clock, used for wakeup when USB3 core goes into low > power mode (U3). > - - mock_utmi:: Mock utmi clock needed for ITP/SOF generation in host > + - mock_utmi: Mock utmi clock needed for ITP/SOF generation in host > mode. Its frequency should be 19.2MHz. > minItems: 1 > maxItems: 9 > -- > 2.53.0 > -- Kind Regards, Niklas Söderlund ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH 2/2] dt-bindings: Drop incorrect usage of double '::' 2026-06-22 10:16 ` [PATCH 2/2] dt-bindings: " Krzysztof Kozlowski ` (3 preceding siblings ...) 2026-06-22 11:08 ` Niklas Söderlund @ 2026-06-22 20:37 ` Sebastian Reichel 4 siblings, 0 replies; 10+ messages in thread From: Sebastian Reichel @ 2026-06-22 20:37 UTC (permalink / raw) To: Krzysztof Kozlowski Cc: Bjorn Andersson, Konrad Dybcio, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Peter Griffin, Alim Akhtar, Michael Turquette, Stephen Boyd, Brian Masney, Sylwester Nawrocki, Chanwoo Choi, Sam Protsenko, Rob Clark, Dmitry Baryshkov, Abhinav Kumar, Jessica Zhang, Sean Paul, Marijn Suijten, David Airlie, Simona Vetter, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, Inki Dae, Seung-Woo Kim, Kyungmin Park, Andi Shyti, Georgi Djakov, Lee Jones, Pavel Machek, Hans Verkuil, Mauro Carvalho Chehab, Ulf Hansson, Peter Rosin, Vinod Koul, Neil Armstrong, Linus Walleij, Geert Uytterhoeven, Magnus Damm, Javier Martinez Canillas, Liam Girdwood, Mark Brown, Greg Kroah-Hartman, Jiri Slaby, Srinivas Kandagatla, Bartlomiej Zolnierkiewicz, Rafael J. Wysocki, Daniel Lezcano, Zhang Rui, Lukasz Luba, Jonathan Marek, Taniya Das, Robert Marko, Christian Marangi, Stephan Gerhold, Adam Skladowski, Sireesh Kodali, Barnabas Czeman, Imran Shaik, Sricharan Ramabadhran, Anusha Rao, Luo Jie, Tomasz Figa, Chanho Park, Sunyeal Hong, Shin Son, Krishna Manikandan, Jacek Anaszewski, Jaehoon Chung, Marek Szyprowski, Alina Yu, Andy Gross, Niklas Söderlund, Wesley Cheng, linux-arm-msm, devicetree, linux-kernel, linux-arm-kernel, linux-samsung-soc, linux-clk, dri-devel, freedreno, linux-i2c, linux-pm, linux-leds, linux-media, linux-mmc, linux-phy, linux-gpio, linux-renesas-soc, linux-serial, linux-sound, linux-usb [-- Attachment #1: Type: text/plain, Size: 789 bytes --] Hi, On Mon, Jun 22, 2026 at 12:16:08PM +0200, Krzysztof Kozlowski wrote: > There is no use of double colon '::' in YAML. OTOH, the literal style > block, e.g. using '|' treats all characters as content [1] therefore > single use of ':' in descriptions is perfectly fine, whenever '|' is > used. > > Cleanup existing code, so the confusing style won't be re-used in new > contributions. > > Link: https://yaml.org/spec/1.2.2/#literal-style [1] > Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> > > --- > > Intention for this patch is to go via Rob's tree. > --- [...] > .../bindings/power/reset/restart-handler.yaml | 8 ++++---- Acked-by: Sebastian Reichel <sebastian.reichel@collabora.com> [...] Greetings, -- Sebastian [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH 1/2] dt-bindings: clock: Drop incorrect usage of double '::' 2026-06-22 10:16 [PATCH 1/2] dt-bindings: clock: Drop incorrect usage of double '::' Krzysztof Kozlowski 2026-06-22 10:16 ` [PATCH 2/2] dt-bindings: " Krzysztof Kozlowski @ 2026-06-22 16:50 ` Conor Dooley 1 sibling, 0 replies; 10+ messages in thread From: Conor Dooley @ 2026-06-22 16:50 UTC (permalink / raw) To: Krzysztof Kozlowski Cc: Bjorn Andersson, Konrad Dybcio, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Peter Griffin, Alim Akhtar, Michael Turquette, Stephen Boyd, Brian Masney, Sylwester Nawrocki, Chanwoo Choi, Sam Protsenko, Rob Clark, Dmitry Baryshkov, Abhinav Kumar, Jessica Zhang, Sean Paul, Marijn Suijten, David Airlie, Simona Vetter, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, Inki Dae, Seung-Woo Kim, Kyungmin Park, Andi Shyti, Georgi Djakov, Lee Jones, Pavel Machek, Hans Verkuil, Mauro Carvalho Chehab, Ulf Hansson, Peter Rosin, Vinod Koul, Neil Armstrong, Linus Walleij, Geert Uytterhoeven, Magnus Damm, Sebastian Reichel, Javier Martinez Canillas, Liam Girdwood, Mark Brown, Greg Kroah-Hartman, Jiri Slaby, Srinivas Kandagatla, Bartlomiej Zolnierkiewicz, Rafael J. Wysocki, Daniel Lezcano, Zhang Rui, Lukasz Luba, Jonathan Marek, Taniya Das, Robert Marko, Christian Marangi, Stephan Gerhold, Adam Skladowski, Sireesh Kodali, Barnabas Czeman, Imran Shaik, Sricharan Ramabadhran, Anusha Rao, Luo Jie, Tomasz Figa, Chanho Park, Sunyeal Hong, Shin Son, Krishna Manikandan, Jacek Anaszewski, Jaehoon Chung, Marek Szyprowski, Alina Yu, Andy Gross, Niklas Söderlund, Wesley Cheng, linux-arm-msm, devicetree, linux-kernel, linux-arm-kernel, linux-samsung-soc, linux-clk, dri-devel, freedreno, linux-i2c, linux-pm, linux-leds, linux-media, linux-mmc, linux-phy, linux-gpio, linux-renesas-soc, linux-serial, linux-sound, linux-usb [-- Attachment #1: Type: text/plain, Size: 583 bytes --] On Mon, Jun 22, 2026 at 12:16:07PM +0200, Krzysztof Kozlowski wrote: > There is no use of double colon '::' in YAML. OTOH, the literal style > block, e.g. using '|' treats all characters as content [1] therefore > single use of ':' in descriptions is perfectly fine, whenever '|' is > used. > > Cleanup existing code, so the confusing style won't be re-used in new > contributions. > > Link: https://yaml.org/spec/1.2.2/#literal-style [1] > Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com> Acked-by: Conor Dooley <conor.dooley@microchip.com> [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 228 bytes --] ^ permalink raw reply [flat|nested] 10+ messages in thread
end of thread, other threads:[~2026-06-22 20:38 UTC | newest] Thread overview: 10+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2026-06-22 10:16 [PATCH 1/2] dt-bindings: clock: Drop incorrect usage of double '::' Krzysztof Kozlowski 2026-06-22 10:16 ` [PATCH 2/2] dt-bindings: " Krzysztof Kozlowski 2026-06-22 10:19 ` sashiko-bot 2026-06-22 13:23 ` Krzysztof Kozlowski 2026-06-22 16:53 ` Conor Dooley 2026-06-22 10:32 ` Geert Uytterhoeven 2026-06-22 10:48 ` Mark Brown 2026-06-22 11:08 ` Niklas Söderlund 2026-06-22 20:37 ` Sebastian Reichel 2026-06-22 16:50 ` [PATCH 1/2] dt-bindings: clock: " Conor Dooley
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox