linux-can.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [RFC PATCH 0/9] dt-bindings: cleanup titles
@ 2022-11-17 12:38 Krzysztof Kozlowski
  2022-11-17 12:38 ` [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Krzysztof Kozlowski
                   ` (8 more replies)
  0 siblings, 9 replies; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 12:38 UTC (permalink / raw)
  To: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog
  Cc: Krzysztof Kozlowski

RFC and merging
===============
Intention is to regenerate the commits with commands at the end of merge
window.  This should go then via Rob's tree.

Description
===========
The Devicetree bindings document does not have to say in the title that it is a
"Devicetree binding", but instead just describe the hardware.  We have several
of such patterns, so when people copy existing bindings into new ones, they
also make similar mistake.

Clean this stuff:
1. Automated with find+sed commands,
2. Manual to have something meaningful.

Best regards,
Krzysztof

Krzysztof Kozlowski (9):
  dt-bindings: drop redundant part of title of shared bindings
  dt-bindings: memory-controllers: ti,gpmc-child: drop redundant part of
    title
  dt-bindings: clock: st,stm32mp1-rcc: add proper title
  dt-bindings: drop redundant part of title (end)
  dt-bindings: drop redundant part of title (end, part two)
  dt-bindings: drop redundant part of title (end, part three)
  dt-bindings: drop redundant part of title (beginning)
  dt-bindings: clock: drop redundant part of title
  dt-bindings: drop redundant part of title (manual)

 Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml        | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml  | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml  | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml  | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml   | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml    | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml    | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml       | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml       | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml       | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml  | 2 +-
 .../devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml          | 2 +-
 Documentation/devicetree/bindings/arm/cci-control-port.yaml   | 2 +-
 Documentation/devicetree/bindings/arm/cpus.yaml               | 2 +-
 .../devicetree/bindings/arm/firmware/linaro,optee-tz.yaml     | 2 +-
 .../devicetree/bindings/arm/hisilicon/hisilicon.yaml          | 2 +-
 .../devicetree/bindings/arm/keystone/ti,k3-sci-common.yaml    | 2 +-
 Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml    | 2 +-
 .../devicetree/bindings/arm/marvell/armada-7k-8k.yaml         | 2 +-
 Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml          | 2 +-
 Documentation/devicetree/bindings/arm/mstar/mstar.yaml        | 2 +-
 Documentation/devicetree/bindings/arm/npcm/npcm.yaml          | 2 +-
 Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml        | 2 +-
 Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml | 2 +-
 Documentation/devicetree/bindings/arm/socionext/uniphier.yaml | 2 +-
 Documentation/devicetree/bindings/arm/sp810.yaml              | 2 +-
 Documentation/devicetree/bindings/arm/sprd/sprd.yaml          | 2 +-
 Documentation/devicetree/bindings/arm/stm32/st,mlahb.yaml     | 2 +-
 .../devicetree/bindings/arm/stm32/st,stm32-syscon.yaml        | 2 +-
 Documentation/devicetree/bindings/arm/stm32/stm32.yaml        | 2 +-
 .../bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml     | 2 +-
 .../bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml          | 2 +-
 .../bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml       | 2 +-
 .../devicetree/bindings/arm/tegra/nvidia,tegra194-cbb.yaml    | 2 +-
 .../devicetree/bindings/arm/tegra/nvidia,tegra234-cbb.yaml    | 2 +-
 Documentation/devicetree/bindings/arm/ti/k3.yaml              | 2 +-
 Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml      | 2 +-
 Documentation/devicetree/bindings/arm/vexpress-config.yaml    | 2 +-
 Documentation/devicetree/bindings/arm/vexpress-sysreg.yaml    | 2 +-
 .../devicetree/bindings/ata/allwinner,sun4i-a10-ahci.yaml     | 2 +-
 .../devicetree/bindings/ata/allwinner,sun8i-r40-ahci.yaml     | 2 +-
 Documentation/devicetree/bindings/bus/ti-sysc.yaml            | 2 +-
 Documentation/devicetree/bindings/clock/adi,axi-clkgen.yaml   | 2 +-
 Documentation/devicetree/bindings/clock/calxeda.yaml          | 2 +-
 Documentation/devicetree/bindings/clock/cirrus,cs2000-cp.yaml | 2 +-
 Documentation/devicetree/bindings/clock/fixed-clock.yaml      | 2 +-
 .../devicetree/bindings/clock/fixed-factor-clock.yaml         | 2 +-
 Documentation/devicetree/bindings/clock/fixed-mmio-clock.yaml | 2 +-
 Documentation/devicetree/bindings/clock/fsl,plldig.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/fsl,sai-clock.yaml    | 2 +-
 Documentation/devicetree/bindings/clock/fsl,scu-clk.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/idt,versaclock5.yaml  | 2 +-
 Documentation/devicetree/bindings/clock/imx1-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx21-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx23-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx25-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx27-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx28-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx31-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx35-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx5-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx6q-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx6sl-clock.yaml     | 2 +-
 Documentation/devicetree/bindings/clock/imx6sll-clock.yaml    | 2 +-
 Documentation/devicetree/bindings/clock/imx6sx-clock.yaml     | 2 +-
 Documentation/devicetree/bindings/clock/imx6ul-clock.yaml     | 2 +-
 Documentation/devicetree/bindings/clock/imx7d-clock.yaml      | 2 +-
 .../devicetree/bindings/clock/imx7ulp-pcc-clock.yaml          | 2 +-
 .../devicetree/bindings/clock/imx7ulp-scg-clock.yaml          | 2 +-
 Documentation/devicetree/bindings/clock/imx8m-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx8qxp-lpcg.yaml     | 2 +-
 .../devicetree/bindings/clock/imx8ulp-cgc-clock.yaml          | 2 +-
 .../devicetree/bindings/clock/imx8ulp-pcc-clock.yaml          | 2 +-
 Documentation/devicetree/bindings/clock/imx93-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imxrt1050-clock.yaml  | 2 +-
 Documentation/devicetree/bindings/clock/ingenic,cgu.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/intel,agilex.yaml     | 2 +-
 Documentation/devicetree/bindings/clock/intel,cgu-lgm.yaml    | 2 +-
 Documentation/devicetree/bindings/clock/intel,easic-n5x.yaml  | 2 +-
 Documentation/devicetree/bindings/clock/intel,stratix10.yaml  | 2 +-
 .../devicetree/bindings/clock/microchip,mpfs-clkcfg.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/milbeaut-clock.yaml   | 2 +-
 .../devicetree/bindings/clock/nuvoton,npcm845-clk.yaml        | 2 +-
 .../devicetree/bindings/clock/qcom,dispcc-sc8280xp.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/qcom,gcc.yaml         | 2 +-
 Documentation/devicetree/bindings/clock/qcom,rpmhcc.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/renesas,9series.yaml  | 2 +-
 .../devicetree/bindings/clock/renesas,versaclock7.yaml        | 2 +-
 .../devicetree/bindings/clock/rockchip,rk3568-cru.yaml        | 2 +-
 Documentation/devicetree/bindings/clock/st,stm32mp1-rcc.yaml  | 2 +-
 Documentation/devicetree/bindings/clock/ti,lmk04832.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/ti,sci-clk.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/ti/ti,clksel.yaml     | 2 +-
 Documentation/devicetree/bindings/cpu/idle-states.yaml        | 2 +-
 .../devicetree/bindings/cpufreq/cpufreq-mediatek-hw.yaml      | 2 +-
 .../devicetree/bindings/cpufreq/qcom-cpufreq-nvmem.yaml       | 2 +-
 Documentation/devicetree/bindings/crypto/st,stm32-crc.yaml    | 2 +-
 Documentation/devicetree/bindings/crypto/st,stm32-cryp.yaml   | 2 +-
 Documentation/devicetree/bindings/crypto/st,stm32-hash.yaml   | 2 +-
 Documentation/devicetree/bindings/display/arm,hdlcd.yaml      | 2 +-
 Documentation/devicetree/bindings/display/arm,malidp.yaml     | 2 +-
 Documentation/devicetree/bindings/display/bridge/anx6345.yaml | 2 +-
 .../devicetree/bindings/display/bridge/chrontel,ch7033.yaml   | 2 +-
 .../bindings/display/bridge/ingenic,jz4780-hdmi.yaml          | 2 +-
 .../devicetree/bindings/display/bridge/intel,keembay-dsi.yaml | 2 +-
 .../devicetree/bindings/display/bridge/ite,it6505.yaml        | 2 +-
 .../devicetree/bindings/display/bridge/ite,it66121.yaml       | 2 +-
 Documentation/devicetree/bindings/display/bridge/ps8640.yaml  | 2 +-
 .../devicetree/bindings/display/bridge/toshiba,tc358767.yaml  | 2 +-
 .../devicetree/bindings/display/bridge/toshiba,tc358775.yaml  | 2 +-
 Documentation/devicetree/bindings/display/ingenic,ipu.yaml    | 2 +-
 Documentation/devicetree/bindings/display/ingenic,lcd.yaml    | 2 +-
 .../devicetree/bindings/display/intel,keembay-display.yaml    | 2 +-
 .../devicetree/bindings/display/intel,keembay-msscam.yaml     | 2 +-
 .../devicetree/bindings/display/mediatek/mediatek,cec.yaml    | 2 +-
 .../devicetree/bindings/display/mediatek/mediatek,dsi.yaml    | 2 +-
 .../bindings/display/mediatek/mediatek,hdmi-ddc.yaml          | 2 +-
 .../devicetree/bindings/display/mediatek/mediatek,hdmi.yaml   | 2 +-
 Documentation/devicetree/bindings/display/msm/gmu.yaml        | 2 +-
 Documentation/devicetree/bindings/display/msm/gpu.yaml        | 2 +-
 .../devicetree/bindings/display/panel/display-timings.yaml    | 2 +-
 .../devicetree/bindings/display/panel/ilitek,ili9163.yaml     | 2 +-
 .../bindings/display/panel/olimex,lcd-olinuxino.yaml          | 2 +-
 .../devicetree/bindings/display/panel/panel-lvds.yaml         | 2 +-
 .../devicetree/bindings/display/panel/panel-timing.yaml       | 2 +-
 .../devicetree/bindings/display/panel/visionox,rm69299.yaml   | 2 +-
 Documentation/devicetree/bindings/dma/dma-common.yaml         | 2 +-
 Documentation/devicetree/bindings/dma/dma-controller.yaml     | 4 ++--
 Documentation/devicetree/bindings/dma/dma-router.yaml         | 4 ++--
 Documentation/devicetree/bindings/dma/ingenic,dma.yaml        | 2 +-
 Documentation/devicetree/bindings/dma/st,stm32-dma.yaml       | 2 +-
 Documentation/devicetree/bindings/dma/st,stm32-dmamux.yaml    | 2 +-
 Documentation/devicetree/bindings/dma/st,stm32-mdma.yaml      | 2 +-
 Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml        | 2 +-
 Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml       | 2 +-
 Documentation/devicetree/bindings/dma/ti/k3-udma.yaml         | 2 +-
 .../devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml     | 2 +-
 Documentation/devicetree/bindings/edac/dmc-520.yaml           | 2 +-
 .../devicetree/bindings/eeprom/microchip,93lc46b.yaml         | 2 +-
 Documentation/devicetree/bindings/firmware/arm,scmi.yaml      | 2 +-
 Documentation/devicetree/bindings/firmware/arm,scpi.yaml      | 2 +-
 .../devicetree/bindings/firmware/qemu,fw-cfg-mmio.yaml        | 2 +-
 Documentation/devicetree/bindings/gpio/gpio-tpic2810.yaml     | 2 +-
 Documentation/devicetree/bindings/gpio/ti,omap-gpio.yaml      | 2 +-
 Documentation/devicetree/bindings/gpu/brcm,bcm-v3d.yaml       | 2 +-
 .../devicetree/bindings/gpu/host1x/nvidia,tegra210-nvdec.yaml | 2 +-
 .../devicetree/bindings/gpu/host1x/nvidia,tegra210-nvenc.yaml | 2 +-
 .../devicetree/bindings/gpu/host1x/nvidia,tegra210-nvjpg.yaml | 2 +-
 .../devicetree/bindings/gpu/host1x/nvidia,tegra234-nvdec.yaml | 2 +-
 Documentation/devicetree/bindings/gpu/vivante,gc.yaml         | 2 +-
 .../devicetree/bindings/hwlock/st,stm32-hwspinlock.yaml       | 2 +-
 Documentation/devicetree/bindings/hwmon/moortec,mr75203.yaml  | 2 +-
 Documentation/devicetree/bindings/i2c/i2c-gpio.yaml           | 2 +-
 Documentation/devicetree/bindings/i2c/i2c-pxa.yaml            | 2 +-
 Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml        | 2 +-
 Documentation/devicetree/bindings/i2c/st,nomadik-i2c.yaml     | 2 +-
 Documentation/devicetree/bindings/i2c/ti,omap4-i2c.yaml       | 2 +-
 Documentation/devicetree/bindings/i3c/i3c.yaml                | 2 +-
 Documentation/devicetree/bindings/iio/adc/adc.yaml            | 2 +-
 .../devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml  | 2 +-
 Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml    | 2 +-
 .../devicetree/bindings/iio/adc/motorola,cpcap-adc.yaml       | 2 +-
 .../devicetree/bindings/iio/adc/nxp,imx8qxp-adc.yaml          | 2 +-
 .../devicetree/bindings/iio/adc/nxp,lpc1850-adc.yaml          | 2 +-
 .../devicetree/bindings/iio/adc/sigma-delta-modulator.yaml    | 2 +-
 .../devicetree/bindings/iio/adc/sprd,sc2720-adc.yaml          | 2 +-
 Documentation/devicetree/bindings/iio/adc/st,stm32-adc.yaml   | 2 +-
 .../devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml          | 2 +-
 .../devicetree/bindings/iio/adc/x-powers,axp209-adc.yaml      | 2 +-
 .../devicetree/bindings/iio/dac/nxp,lpc1850-dac.yaml          | 2 +-
 Documentation/devicetree/bindings/iio/dac/st,stm32-dac.yaml   | 2 +-
 .../devicetree/bindings/iio/multiplexer/io-channel-mux.yaml   | 2 +-
 Documentation/devicetree/bindings/input/fsl,scu-key.yaml      | 2 +-
 Documentation/devicetree/bindings/input/gpio-keys.yaml        | 2 +-
 Documentation/devicetree/bindings/input/input.yaml            | 2 +-
 Documentation/devicetree/bindings/input/matrix-keymap.yaml    | 2 +-
 .../devicetree/bindings/input/microchip,cap11xx.yaml          | 2 +-
 .../devicetree/bindings/input/pine64,pinephone-keyboard.yaml  | 2 +-
 .../bindings/input/touchscreen/chipone,icn8318.yaml           | 2 +-
 .../bindings/input/touchscreen/cypress,cy8ctma140.yaml        | 2 +-
 .../bindings/input/touchscreen/cypress,cy8ctma340.yaml        | 2 +-
 .../devicetree/bindings/input/touchscreen/edt-ft5x06.yaml     | 2 +-
 .../devicetree/bindings/input/touchscreen/goodix.yaml         | 2 +-
 .../devicetree/bindings/input/touchscreen/himax,hx83112b.yaml | 2 +-
 .../devicetree/bindings/input/touchscreen/hycon,hy46xx.yaml   | 2 +-
 .../bindings/input/touchscreen/imagis,ist3038c.yaml           | 2 +-
 .../devicetree/bindings/input/touchscreen/melfas,mms114.yaml  | 2 +-
 .../devicetree/bindings/input/touchscreen/mstar,msg2638.yaml  | 2 +-
 .../bindings/input/touchscreen/pixcir,pixcir_ts.yaml          | 2 +-
 .../devicetree/bindings/input/touchscreen/silead,gsl1680.yaml | 2 +-
 .../devicetree/bindings/input/touchscreen/ti,tsc2005.yaml     | 2 +-
 .../devicetree/bindings/input/touchscreen/touchscreen.yaml    | 2 +-
 .../devicetree/bindings/input/touchscreen/zinitix,bt400.yaml  | 2 +-
 .../bindings/interrupt-controller/ingenic,intc.yaml           | 2 +-
 .../devicetree/bindings/interrupt-controller/mrvl,intc.yaml   | 2 +-
 .../bindings/interrupt-controller/nuvoton,wpcm450-aic.yaml    | 2 +-
 .../bindings/interrupt-controller/realtek,rtl-intc.yaml       | 2 +-
 .../bindings/interrupt-controller/renesas,irqc.yaml           | 2 +-
 Documentation/devicetree/bindings/ipmi/ipmi-ipmb.yaml         | 2 +-
 Documentation/devicetree/bindings/ipmi/ipmi-smic.yaml         | 2 +-
 .../devicetree/bindings/leds/backlight/gpio-backlight.yaml    | 2 +-
 .../devicetree/bindings/leds/backlight/led-backlight.yaml     | 2 +-
 .../devicetree/bindings/leds/backlight/pwm-backlight.yaml     | 2 +-
 .../devicetree/bindings/leds/backlight/qcom-wled.yaml         | 2 +-
 Documentation/devicetree/bindings/leds/issi,is31fl319x.yaml   | 2 +-
 Documentation/devicetree/bindings/leds/register-bit-led.yaml  | 2 +-
 Documentation/devicetree/bindings/leds/regulator-led.yaml     | 2 +-
 .../devicetree/bindings/mailbox/qcom,apcs-kpss-global.yaml    | 2 +-
 Documentation/devicetree/bindings/mailbox/sprd-mailbox.yaml   | 2 +-
 Documentation/devicetree/bindings/mailbox/st,stm32-ipcc.yaml  | 2 +-
 .../devicetree/bindings/media/i2c/dongwoon,dw9768.yaml        | 2 +-
 Documentation/devicetree/bindings/media/i2c/ov8856.yaml       | 2 +-
 Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml | 2 +-
 Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml  | 2 +-
 Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml  | 2 +-
 Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml  | 2 +-
 Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml | 2 +-
 .../devicetree/bindings/media/marvell,mmp2-ccic.yaml          | 2 +-
 Documentation/devicetree/bindings/media/renesas,ceu.yaml      | 2 +-
 Documentation/devicetree/bindings/media/st,stm32-cec.yaml     | 2 +-
 Documentation/devicetree/bindings/media/st,stm32-dcmi.yaml    | 2 +-
 Documentation/devicetree/bindings/media/st,stm32-dma2d.yaml   | 2 +-
 .../devicetree/bindings/media/video-interface-devices.yaml    | 2 +-
 Documentation/devicetree/bindings/media/video-interfaces.yaml | 2 +-
 .../bindings/memory-controllers/calxeda-ddr-ctrlr.yaml        | 2 +-
 .../bindings/memory-controllers/ingenic,nemc-peripherals.yaml | 2 +-
 .../devicetree/bindings/memory-controllers/ingenic,nemc.yaml  | 2 +-
 .../bindings/memory-controllers/st,stm32-fmc2-ebi.yaml        | 2 +-
 .../devicetree/bindings/memory-controllers/ti,gpmc-child.yaml | 2 +-
 .../devicetree/bindings/memory-controllers/ti,gpmc.yaml       | 2 +-
 Documentation/devicetree/bindings/mfd/actions,atc260x.yaml    | 2 +-
 Documentation/devicetree/bindings/mfd/ene-kb3930.yaml         | 2 +-
 Documentation/devicetree/bindings/mfd/ene-kb930.yaml          | 2 +-
 Documentation/devicetree/bindings/mfd/fsl,imx8qxp-csr.yaml    | 2 +-
 Documentation/devicetree/bindings/mfd/qcom,pm8008.yaml        | 2 +-
 Documentation/devicetree/bindings/mfd/rohm,bd71815-pmic.yaml  | 2 +-
 Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml  | 2 +-
 Documentation/devicetree/bindings/mfd/rohm,bd71837-pmic.yaml  | 2 +-
 Documentation/devicetree/bindings/mfd/rohm,bd71847-pmic.yaml  | 2 +-
 Documentation/devicetree/bindings/mfd/rohm,bd9576-pmic.yaml   | 2 +-
 Documentation/devicetree/bindings/mfd/st,stm32-lptimer.yaml   | 2 +-
 Documentation/devicetree/bindings/mfd/st,stm32-timers.yaml    | 2 +-
 Documentation/devicetree/bindings/mfd/st,stmfx.yaml           | 2 +-
 Documentation/devicetree/bindings/mfd/st,stpmic1.yaml         | 2 +-
 Documentation/devicetree/bindings/mips/ingenic/devices.yaml   | 2 +-
 .../devicetree/bindings/mips/ingenic/ingenic,cpu.yaml         | 2 +-
 .../devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml      | 2 +-
 Documentation/devicetree/bindings/mips/loongson/devices.yaml  | 2 +-
 Documentation/devicetree/bindings/misc/olpc,xo1.75-ec.yaml    | 2 +-
 Documentation/devicetree/bindings/mmc/arasan,sdhci.yaml       | 2 +-
 Documentation/devicetree/bindings/mmc/brcm,sdhci-brcmstb.yaml | 2 +-
 Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml        | 2 +-
 .../devicetree/bindings/mmc/microchip,dw-sparx5-sdhci.yaml    | 2 +-
 Documentation/devicetree/bindings/mmc/mmc-controller.yaml     | 2 +-
 Documentation/devicetree/bindings/mmc/mmc-pwrseq-emmc.yaml    | 2 +-
 Documentation/devicetree/bindings/mmc/mmc-pwrseq-sd8787.yaml  | 2 +-
 Documentation/devicetree/bindings/mmc/mmc-pwrseq-simple.yaml  | 2 +-
 Documentation/devicetree/bindings/mmc/mtk-sd.yaml             | 2 +-
 Documentation/devicetree/bindings/mmc/sdhci-pxa.yaml          | 2 +-
 Documentation/devicetree/bindings/mmc/snps,dwcmshc-sdhci.yaml | 2 +-
 Documentation/devicetree/bindings/mmc/synopsys-dw-mshc.yaml   | 2 +-
 Documentation/devicetree/bindings/mtd/gpmi-nand.yaml          | 2 +-
 Documentation/devicetree/bindings/mtd/ingenic,nand.yaml       | 2 +-
 .../devicetree/bindings/mtd/microchip,mchp48l640.yaml         | 2 +-
 Documentation/devicetree/bindings/mtd/mxc-nand.yaml           | 2 +-
 Documentation/devicetree/bindings/mtd/nand-chip.yaml          | 2 +-
 Documentation/devicetree/bindings/mtd/nand-controller.yaml    | 2 +-
 .../devicetree/bindings/mtd/partitions/qcom,smem-part.yaml    | 2 +-
 Documentation/devicetree/bindings/mtd/st,stm32-fmc2-nand.yaml | 2 +-
 Documentation/devicetree/bindings/mux/gpio-mux.yaml           | 2 +-
 Documentation/devicetree/bindings/mux/mux-consumer.yaml       | 2 +-
 Documentation/devicetree/bindings/mux/mux-controller.yaml     | 2 +-
 Documentation/devicetree/bindings/mux/reg-mux.yaml            | 2 +-
 Documentation/devicetree/bindings/net/asix,ax88178.yaml       | 2 +-
 .../bindings/net/bluetooth/bluetooth-controller.yaml          | 2 +-
 Documentation/devicetree/bindings/net/brcm,bcmgenet.yaml      | 2 +-
 .../devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml  | 2 +-
 Documentation/devicetree/bindings/net/can/bosch,c_can.yaml    | 2 +-
 Documentation/devicetree/bindings/net/can/bosch,m_can.yaml    | 2 +-
 Documentation/devicetree/bindings/net/can/can-controller.yaml | 2 +-
 .../devicetree/bindings/net/can/can-transceiver.yaml          | 2 +-
 Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml   | 2 +-
 Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml  | 2 +-
 Documentation/devicetree/bindings/net/dsa/dsa-port.yaml       | 2 +-
 Documentation/devicetree/bindings/net/dsa/dsa.yaml            | 2 +-
 .../devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml     | 2 +-
 .../devicetree/bindings/net/dsa/microchip,lan937x.yaml        | 2 +-
 Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml    | 2 +-
 Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml    | 2 +-
 Documentation/devicetree/bindings/net/engleder,tsnep.yaml     | 2 +-
 .../devicetree/bindings/net/ethernet-controller.yaml          | 2 +-
 Documentation/devicetree/bindings/net/ethernet-phy.yaml       | 2 +-
 Documentation/devicetree/bindings/net/fsl,qoriq-mc-dpmac.yaml | 2 +-
 Documentation/devicetree/bindings/net/ingenic,mac.yaml        | 2 +-
 .../devicetree/bindings/net/mctp-i2c-controller.yaml          | 2 +-
 Documentation/devicetree/bindings/net/mdio.yaml               | 2 +-
 Documentation/devicetree/bindings/net/microchip,lan95xx.yaml  | 2 +-
 .../devicetree/bindings/net/wireless/esp,esp8089.yaml         | 2 +-
 Documentation/devicetree/bindings/net/wireless/ieee80211.yaml | 2 +-
 .../devicetree/bindings/net/wireless/mediatek,mt76.yaml       | 2 +-
 .../devicetree/bindings/net/wireless/microchip,wilc1000.yaml  | 2 +-
 Documentation/devicetree/bindings/net/wireless/qca,ath9k.yaml | 2 +-
 .../devicetree/bindings/net/wireless/qcom,ath11k.yaml         | 2 +-
 .../devicetree/bindings/net/wireless/silabs,wfx.yaml          | 2 +-
 Documentation/devicetree/bindings/nvmem/fsl,scu-ocotp.yaml    | 2 +-
 .../devicetree/bindings/nvmem/ingenic,jz4780-efuse.yaml       | 2 +-
 Documentation/devicetree/bindings/nvmem/qcom,qfprom.yaml      | 2 +-
 Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml   | 2 +-
 .../devicetree/bindings/nvmem/socionext,uniphier-efuse.yaml   | 2 +-
 Documentation/devicetree/bindings/nvmem/st,stm32-romem.yaml   | 2 +-
 Documentation/devicetree/bindings/opp/opp-v1.yaml             | 2 +-
 Documentation/devicetree/bindings/opp/opp-v2-base.yaml        | 2 +-
 Documentation/devicetree/bindings/opp/opp-v2-kryo-cpu.yaml    | 2 +-
 Documentation/devicetree/bindings/opp/opp-v2-qcom-level.yaml  | 2 +-
 Documentation/devicetree/bindings/opp/opp-v2.yaml             | 2 +-
 Documentation/devicetree/bindings/pci/qcom,pcie-ep.yaml       | 2 +-
 Documentation/devicetree/bindings/phy/brcm,ns2-pcie-phy.yaml  | 2 +-
 Documentation/devicetree/bindings/phy/calxeda-combophy.yaml   | 2 +-
 Documentation/devicetree/bindings/phy/fsl,imx8mq-usb-phy.yaml | 2 +-
 Documentation/devicetree/bindings/phy/fsl,lynx-28g.yaml       | 2 +-
 Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml    | 2 +-
 .../devicetree/bindings/phy/intel,keembay-phy-usb.yaml        | 2 +-
 .../devicetree/bindings/phy/intel,phy-thunderbay-emmc.yaml    | 2 +-
 .../devicetree/bindings/phy/marvell,mmp3-usb-phy.yaml         | 2 +-
 Documentation/devicetree/bindings/phy/mediatek,dsi-phy.yaml   | 2 +-
 Documentation/devicetree/bindings/phy/mediatek,hdmi-phy.yaml  | 2 +-
 Documentation/devicetree/bindings/phy/mediatek,ufs-phy.yaml   | 2 +-
 Documentation/devicetree/bindings/phy/phy-cadence-sierra.yaml | 2 +-
 .../devicetree/bindings/phy/phy-cadence-torrent.yaml          | 2 +-
 Documentation/devicetree/bindings/phy/phy-stm32-usbphyc.yaml  | 2 +-
 Documentation/devicetree/bindings/phy/phy-tegra194-p2u.yaml   | 2 +-
 Documentation/devicetree/bindings/phy/qcom,usb-hs-phy.yaml    | 2 +-
 .../devicetree/bindings/phy/ti,phy-am654-serdes.yaml          | 2 +-
 Documentation/devicetree/bindings/phy/ti,phy-gmii-sel.yaml    | 2 +-
 Documentation/devicetree/bindings/phy/transmit-amplitude.yaml | 2 +-
 .../devicetree/bindings/pinctrl/fsl,scu-pinctrl.yaml          | 2 +-
 .../devicetree/bindings/pinctrl/ingenic,pinctrl.yaml          | 2 +-
 Documentation/devicetree/bindings/pinctrl/intel,lgm-io.yaml   | 2 +-
 Documentation/devicetree/bindings/power/avs/qcom,cpr.yaml     | 2 +-
 .../devicetree/bindings/power/domain-idle-state.yaml          | 2 +-
 Documentation/devicetree/bindings/power/fsl,scu-pd.yaml       | 2 +-
 .../devicetree/bindings/power/reset/restart-handler.yaml      | 2 +-
 .../devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml    | 2 +-
 Documentation/devicetree/bindings/power/supply/bq2415x.yaml   | 2 +-
 Documentation/devicetree/bindings/power/supply/bq24190.yaml   | 2 +-
 Documentation/devicetree/bindings/power/supply/bq24257.yaml   | 2 +-
 Documentation/devicetree/bindings/power/supply/bq24735.yaml   | 2 +-
 Documentation/devicetree/bindings/power/supply/bq25890.yaml   | 2 +-
 .../devicetree/bindings/power/supply/dlg,da9150-charger.yaml  | 2 +-
 .../bindings/power/supply/dlg,da9150-fuel-gauge.yaml          | 2 +-
 .../devicetree/bindings/power/supply/ingenic,battery.yaml     | 2 +-
 Documentation/devicetree/bindings/power/supply/isp1704.yaml   | 2 +-
 .../devicetree/bindings/power/supply/lltc,lt3651-charger.yaml | 2 +-
 .../devicetree/bindings/power/supply/lltc,ltc294x.yaml        | 2 +-
 .../devicetree/bindings/power/supply/maxim,ds2760.yaml        | 2 +-
 .../devicetree/bindings/power/supply/maxim,max14656.yaml      | 2 +-
 .../devicetree/bindings/power/supply/richtek,rt9455.yaml      | 2 +-
 .../devicetree/bindings/power/supply/sc2731-charger.yaml      | 2 +-
 Documentation/devicetree/bindings/power/supply/sc27xx-fg.yaml | 2 +-
 Documentation/devicetree/bindings/power/supply/ti,lp8727.yaml | 2 +-
 Documentation/devicetree/bindings/pwm/microchip,corepwm.yaml  | 2 +-
 .../devicetree/bindings/regulator/pwm-regulator.yaml          | 2 +-
 .../devicetree/bindings/regulator/st,stm32-booster.yaml       | 2 +-
 .../devicetree/bindings/regulator/st,stm32-vrefbuf.yaml       | 2 +-
 .../bindings/remoteproc/amlogic,meson-mx-ao-arc.yaml          | 2 +-
 .../devicetree/bindings/remoteproc/fsl,imx-rproc.yaml         | 2 +-
 Documentation/devicetree/bindings/remoteproc/ingenic,vpu.yaml | 2 +-
 Documentation/devicetree/bindings/remoteproc/mtk,scp.yaml     | 2 +-
 Documentation/devicetree/bindings/remoteproc/qcom,adsp.yaml   | 2 +-
 .../devicetree/bindings/remoteproc/qcom,pil-info.yaml         | 2 +-
 .../devicetree/bindings/remoteproc/renesas,rcar-rproc.yaml    | 2 +-
 .../devicetree/bindings/remoteproc/st,stm32-rproc.yaml        | 2 +-
 .../devicetree/bindings/reserved-memory/shared-dma-pool.yaml  | 2 +-
 Documentation/devicetree/bindings/reset/ti,sci-reset.yaml     | 2 +-
 Documentation/devicetree/bindings/reset/ti,tps380x-reset.yaml | 2 +-
 Documentation/devicetree/bindings/riscv/cpus.yaml             | 2 +-
 Documentation/devicetree/bindings/rng/ingenic,rng.yaml        | 2 +-
 Documentation/devicetree/bindings/rng/ingenic,trng.yaml       | 2 +-
 Documentation/devicetree/bindings/rng/intel,ixp46x-rng.yaml   | 2 +-
 .../devicetree/bindings/rng/silex-insight,ba431-rng.yaml      | 2 +-
 Documentation/devicetree/bindings/rng/st,stm32-rng.yaml       | 2 +-
 .../devicetree/bindings/rng/xiphera,xip8001b-trng.yaml        | 2 +-
 Documentation/devicetree/bindings/rtc/epson,rx8900.yaml       | 2 +-
 Documentation/devicetree/bindings/rtc/fsl,scu-rtc.yaml        | 2 +-
 Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml        | 2 +-
 Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml   | 2 +-
 Documentation/devicetree/bindings/rtc/rtc.yaml                | 2 +-
 Documentation/devicetree/bindings/rtc/sa1100-rtc.yaml         | 2 +-
 Documentation/devicetree/bindings/rtc/st,stm32-rtc.yaml       | 2 +-
 Documentation/devicetree/bindings/serial/8250.yaml            | 2 +-
 Documentation/devicetree/bindings/serial/8250_omap.yaml       | 2 +-
 .../devicetree/bindings/serial/brcm,bcm7271-uart.yaml         | 2 +-
 Documentation/devicetree/bindings/serial/ingenic,uart.yaml    | 2 +-
 Documentation/devicetree/bindings/serial/rs485.yaml           | 2 +-
 Documentation/devicetree/bindings/serial/serial.yaml          | 2 +-
 Documentation/devicetree/bindings/serial/st,stm32-uart.yaml   | 2 +-
 Documentation/devicetree/bindings/serio/ps2-gpio.yaml         | 2 +-
 Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml   | 2 +-
 Documentation/devicetree/bindings/soc/qcom/qcom,aoss-qmp.yaml | 2 +-
 Documentation/devicetree/bindings/soc/qcom/qcom,apr.yaml      | 2 +-
 Documentation/devicetree/bindings/soc/qcom/qcom,smem.yaml     | 2 +-
 Documentation/devicetree/bindings/soc/qcom/qcom,spm.yaml      | 2 +-
 Documentation/devicetree/bindings/soc/qcom/qcom-stats.yaml    | 2 +-
 Documentation/devicetree/bindings/soc/samsung/exynos-usi.yaml | 2 +-
 Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml   | 2 +-
 Documentation/devicetree/bindings/sound/audio-graph-port.yaml | 2 +-
 Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml   | 2 +-
 Documentation/devicetree/bindings/sound/ingenic,aic.yaml      | 2 +-
 Documentation/devicetree/bindings/sound/ingenic,codec.yaml    | 2 +-
 Documentation/devicetree/bindings/sound/marvell,mmp-sspa.yaml | 2 +-
 Documentation/devicetree/bindings/sound/qcom,lpass-cpu.yaml   | 2 +-
 .../devicetree/bindings/sound/qcom,lpass-rx-macro.yaml        | 2 +-
 .../devicetree/bindings/sound/qcom,lpass-tx-macro.yaml        | 2 +-
 .../devicetree/bindings/sound/qcom,lpass-va-macro.yaml        | 2 +-
 .../devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml       | 2 +-
 Documentation/devicetree/bindings/sound/qcom,q6apm-dai.yaml   | 2 +-
 .../devicetree/bindings/sound/qcom,q6dsp-lpass-clocks.yaml    | 2 +-
 .../devicetree/bindings/sound/qcom,q6dsp-lpass-ports.yaml     | 2 +-
 Documentation/devicetree/bindings/sound/qcom,wcd934x.yaml     | 2 +-
 Documentation/devicetree/bindings/sound/qcom,wcd938x-sdw.yaml | 2 +-
 Documentation/devicetree/bindings/sound/qcom,wcd938x.yaml     | 2 +-
 Documentation/devicetree/bindings/sound/qcom,wsa881x.yaml     | 2 +-
 Documentation/devicetree/bindings/sound/qcom,wsa883x.yaml     | 2 +-
 Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml  | 2 +-
 Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml  | 2 +-
 Documentation/devicetree/bindings/sound/ti,src4xxx.yaml       | 2 +-
 .../devicetree/bindings/soundwire/soundwire-controller.yaml   | 2 +-
 Documentation/devicetree/bindings/spi/aspeed,ast2600-fmc.yaml | 2 +-
 Documentation/devicetree/bindings/spi/ingenic,spi.yaml        | 2 +-
 Documentation/devicetree/bindings/spi/marvell,mmp2-ssp.yaml   | 2 +-
 Documentation/devicetree/bindings/spi/omap-spi.yaml           | 2 +-
 Documentation/devicetree/bindings/spi/spi-controller.yaml     | 2 +-
 Documentation/devicetree/bindings/spi/spi-gpio.yaml           | 2 +-
 Documentation/devicetree/bindings/spi/st,stm32-qspi.yaml      | 2 +-
 Documentation/devicetree/bindings/spi/st,stm32-spi.yaml       | 2 +-
 .../devicetree/bindings/thermal/fsl,scu-thermal.yaml          | 2 +-
 Documentation/devicetree/bindings/thermal/imx-thermal.yaml    | 2 +-
 Documentation/devicetree/bindings/thermal/imx8mm-thermal.yaml | 2 +-
 Documentation/devicetree/bindings/thermal/sprd-thermal.yaml   | 2 +-
 .../devicetree/bindings/thermal/st,stm32-thermal.yaml         | 2 +-
 .../devicetree/bindings/thermal/thermal-cooling-devices.yaml  | 2 +-
 Documentation/devicetree/bindings/thermal/thermal-idle.yaml   | 2 +-
 Documentation/devicetree/bindings/thermal/thermal-sensor.yaml | 2 +-
 Documentation/devicetree/bindings/thermal/thermal-zones.yaml  | 2 +-
 .../devicetree/bindings/thermal/ti,am654-thermal.yaml         | 2 +-
 .../devicetree/bindings/thermal/ti,j72xx-thermal.yaml         | 2 +-
 Documentation/devicetree/bindings/timer/ingenic,sysost.yaml   | 2 +-
 Documentation/devicetree/bindings/timer/ingenic,tcu.yaml      | 2 +-
 Documentation/devicetree/bindings/timer/mrvl,mmp-timer.yaml   | 2 +-
 Documentation/devicetree/bindings/timer/st,stm32-timer.yaml   | 2 +-
 Documentation/devicetree/bindings/usb/analogix,anx7411.yaml   | 2 +-
 Documentation/devicetree/bindings/usb/cdns,usb3.yaml          | 2 +-
 Documentation/devicetree/bindings/usb/dwc2.yaml               | 2 +-
 Documentation/devicetree/bindings/usb/faraday,fotg210.yaml    | 2 +-
 Documentation/devicetree/bindings/usb/ingenic,musb.yaml       | 2 +-
 .../devicetree/bindings/usb/marvell,pxau2o-ehci.yaml          | 2 +-
 Documentation/devicetree/bindings/usb/maxim,max33359.yaml     | 2 +-
 .../devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml         | 2 +-
 Documentation/devicetree/bindings/usb/nvidia,tegra-xudc.yaml  | 2 +-
 Documentation/devicetree/bindings/usb/nxp,isp1760.yaml        | 2 +-
 Documentation/devicetree/bindings/usb/realtek,rts5411.yaml    | 2 +-
 Documentation/devicetree/bindings/usb/richtek,rt1719.yaml     | 2 +-
 Documentation/devicetree/bindings/usb/st,stusb160x.yaml       | 2 +-
 Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml       | 2 +-
 Documentation/devicetree/bindings/usb/ti,tps6598x.yaml        | 2 +-
 Documentation/devicetree/bindings/usb/ti,usb8041.yaml         | 2 +-
 Documentation/devicetree/bindings/usb/usb-device.yaml         | 2 +-
 Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml  | 2 +-
 Documentation/devicetree/bindings/virtio/virtio-device.yaml   | 2 +-
 Documentation/devicetree/bindings/watchdog/fsl,scu-wdt.yaml   | 2 +-
 Documentation/devicetree/bindings/watchdog/st,stm32-iwdg.yaml | 2 +-
 Documentation/devicetree/bindings/watchdog/watchdog.yaml      | 2 +-
 472 files changed, 474 insertions(+), 474 deletions(-)

-- 
2.34.1


^ permalink raw reply	[flat|nested] 26+ messages in thread

* [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 12:38 [RFC PATCH 0/9] dt-bindings: cleanup titles Krzysztof Kozlowski
@ 2022-11-17 12:38 ` Krzysztof Kozlowski
  2022-11-17 13:23   ` Andrew Lunn
                     ` (5 more replies)
  2022-11-17 12:38 ` [RFC PATCH 2/9] dt-bindings: memory-controllers: ti,gpmc-child: drop redundant part of title Krzysztof Kozlowski
                   ` (7 subsequent siblings)
  8 siblings, 6 replies; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 12:38 UTC (permalink / raw)
  To: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog
  Cc: Krzysztof Kozlowski

The Devicetree bindings document does not have to say in the title that
it is a "binding", but instead just describe the hardware.  For shared
(re-usable) schemas, name them all as "common properties".

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
 Documentation/devicetree/bindings/clock/qcom,gcc.yaml         | 2 +-
 Documentation/devicetree/bindings/dma/dma-common.yaml         | 2 +-
 Documentation/devicetree/bindings/dma/dma-controller.yaml     | 4 ++--
 Documentation/devicetree/bindings/dma/dma-router.yaml         | 4 ++--
 Documentation/devicetree/bindings/iio/adc/adc.yaml            | 2 +-
 .../devicetree/bindings/media/video-interface-devices.yaml    | 2 +-
 Documentation/devicetree/bindings/media/video-interfaces.yaml | 2 +-
 Documentation/devicetree/bindings/mmc/mmc-controller.yaml     | 2 +-
 Documentation/devicetree/bindings/mtd/nand-chip.yaml          | 2 +-
 Documentation/devicetree/bindings/mtd/nand-controller.yaml    | 2 +-
 .../bindings/net/bluetooth/bluetooth-controller.yaml          | 2 +-
 Documentation/devicetree/bindings/net/can/can-controller.yaml | 2 +-
 .../devicetree/bindings/net/ethernet-controller.yaml          | 2 +-
 Documentation/devicetree/bindings/net/ethernet-phy.yaml       | 2 +-
 Documentation/devicetree/bindings/net/mdio.yaml               | 2 +-
 Documentation/devicetree/bindings/opp/opp-v2-base.yaml        | 2 +-
 .../devicetree/bindings/power/reset/restart-handler.yaml      | 2 +-
 Documentation/devicetree/bindings/rtc/rtc.yaml                | 2 +-
 .../devicetree/bindings/soundwire/soundwire-controller.yaml   | 2 +-
 Documentation/devicetree/bindings/spi/spi-controller.yaml     | 2 +-
 Documentation/devicetree/bindings/watchdog/watchdog.yaml      | 2 +-
 21 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
index 1ab416c83c8d..d2de3d128b73 100644
--- a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
+++ b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/qcom,gcc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Qualcomm Global Clock & Reset Controller Common Bindings
+title: Qualcomm Global Clock & Reset Controller common parts
 
 maintainers:
   - Stephen Boyd <sboyd@kernel.org>
diff --git a/Documentation/devicetree/bindings/dma/dma-common.yaml b/Documentation/devicetree/bindings/dma/dma-common.yaml
index ad06d36af208..9b7b94fdbb0b 100644
--- a/Documentation/devicetree/bindings/dma/dma-common.yaml
+++ b/Documentation/devicetree/bindings/dma/dma-common.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/dma/dma-common.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: DMA Engine Generic Binding
+title: DMA Engine common properties
 
 maintainers:
   - Vinod Koul <vkoul@kernel.org>
diff --git a/Documentation/devicetree/bindings/dma/dma-controller.yaml b/Documentation/devicetree/bindings/dma/dma-controller.yaml
index 6d3727267fa8..225a141c7b5c 100644
--- a/Documentation/devicetree/bindings/dma/dma-controller.yaml
+++ b/Documentation/devicetree/bindings/dma/dma-controller.yaml
@@ -4,13 +4,13 @@
 $id: http://devicetree.org/schemas/dma/dma-controller.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: DMA Controller Generic Binding
+title: DMA Controller common properties
 
 maintainers:
   - Vinod Koul <vkoul@kernel.org>
 
 allOf:
-  - $ref: "dma-common.yaml#"
+  - $ref: dma-common.yaml#
 
 # Everything else is described in the common file
 properties:
diff --git a/Documentation/devicetree/bindings/dma/dma-router.yaml b/Documentation/devicetree/bindings/dma/dma-router.yaml
index 4b817f5dc30e..0ebd7bc6232b 100644
--- a/Documentation/devicetree/bindings/dma/dma-router.yaml
+++ b/Documentation/devicetree/bindings/dma/dma-router.yaml
@@ -4,13 +4,13 @@
 $id: http://devicetree.org/schemas/dma/dma-router.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: DMA Router Generic Binding
+title: DMA Router common properties
 
 maintainers:
   - Vinod Koul <vkoul@kernel.org>
 
 allOf:
-  - $ref: "dma-common.yaml#"
+  - $ref: dma-common.yaml#
 
 description:
   DMA routers are transparent IP blocks used to route DMA request
diff --git a/Documentation/devicetree/bindings/iio/adc/adc.yaml b/Documentation/devicetree/bindings/iio/adc/adc.yaml
index db348fcbb52c..bd0f5fae256e 100644
--- a/Documentation/devicetree/bindings/iio/adc/adc.yaml
+++ b/Documentation/devicetree/bindings/iio/adc/adc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/iio/adc/adc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Generic IIO bindings for ADC channels
+title: IIO common properties for ADC channels
 
 maintainers:
   - Jonathan Cameron <jic23@kernel.org>
diff --git a/Documentation/devicetree/bindings/media/video-interface-devices.yaml b/Documentation/devicetree/bindings/media/video-interface-devices.yaml
index 4527f56a5a6e..bd719cb1813e 100644
--- a/Documentation/devicetree/bindings/media/video-interface-devices.yaml
+++ b/Documentation/devicetree/bindings/media/video-interface-devices.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/media/video-interface-devices.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Common bindings for video receiver and transmitter devices
+title: Common properties for video receiver and transmitter devices
 
 maintainers:
   - Jacopo Mondi <jacopo@jmondi.org>
diff --git a/Documentation/devicetree/bindings/media/video-interfaces.yaml b/Documentation/devicetree/bindings/media/video-interfaces.yaml
index 68c3b9871cf3..e8cf73794772 100644
--- a/Documentation/devicetree/bindings/media/video-interfaces.yaml
+++ b/Documentation/devicetree/bindings/media/video-interfaces.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/media/video-interfaces.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Common bindings for video receiver and transmitter interface endpoints
+title: Common properties for video receiver and transmitter interface endpoints
 
 maintainers:
   - Sakari Ailus <sakari.ailus@linux.intel.com>
diff --git a/Documentation/devicetree/bindings/mmc/mmc-controller.yaml b/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
index 802e3ca8be4d..a17f49738abd 100644
--- a/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
+++ b/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/mmc/mmc-controller.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: MMC Controller Generic Binding
+title: MMC Controller common properties
 
 maintainers:
   - Ulf Hansson <ulf.hansson@linaro.org>
diff --git a/Documentation/devicetree/bindings/mtd/nand-chip.yaml b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
index 97ac3a3fbb52..20b195ef9b70 100644
--- a/Documentation/devicetree/bindings/mtd/nand-chip.yaml
+++ b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/mtd/nand-chip.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: NAND Chip and NAND Controller Generic Binding
+title: NAND Chip and NAND Controller common properties
 
 maintainers:
   - Miquel Raynal <miquel.raynal@bootlin.com>
diff --git a/Documentation/devicetree/bindings/mtd/nand-controller.yaml b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
index 359a015d4e5a..a004efc42842 100644
--- a/Documentation/devicetree/bindings/mtd/nand-controller.yaml
+++ b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/mtd/nand-controller.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: NAND Chip and NAND Controller Generic Binding
+title: NAND Chip and NAND Controller common properties
 
 maintainers:
   - Miquel Raynal <miquel.raynal@bootlin.com>
diff --git a/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml b/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
index 9309dc40f54f..8715adff5eaf 100644
--- a/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
+++ b/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/bluetooth/bluetooth-controller.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bluetooth Controller Generic Binding
+title: Bluetooth Controller common properties
 
 maintainers:
   - Marcel Holtmann <marcel@holtmann.org>
diff --git a/Documentation/devicetree/bindings/net/can/can-controller.yaml b/Documentation/devicetree/bindings/net/can/can-controller.yaml
index 1f0e98051074..3747b46cf9b6 100644
--- a/Documentation/devicetree/bindings/net/can/can-controller.yaml
+++ b/Documentation/devicetree/bindings/net/can/can-controller.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/can/can-controller.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: CAN Controller Generic Binding
+title: CAN Controller common properties
 
 maintainers:
   - Marc Kleine-Budde <mkl@pengutronix.de>
diff --git a/Documentation/devicetree/bindings/net/ethernet-controller.yaml b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
index 3aef506fa158..26502c0f2aff 100644
--- a/Documentation/devicetree/bindings/net/ethernet-controller.yaml
+++ b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/ethernet-controller.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ethernet Controller Generic Binding
+title: Ethernet Controller common properties
 
 maintainers:
   - David S. Miller <davem@davemloft.net>
diff --git a/Documentation/devicetree/bindings/net/ethernet-phy.yaml b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
index ad808e9ce5b9..0aa1b60e78cc 100644
--- a/Documentation/devicetree/bindings/net/ethernet-phy.yaml
+++ b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/ethernet-phy.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ethernet PHY Generic Binding
+title: Ethernet PHY common properties
 
 maintainers:
   - Andrew Lunn <andrew@lunn.ch>
diff --git a/Documentation/devicetree/bindings/net/mdio.yaml b/Documentation/devicetree/bindings/net/mdio.yaml
index b5706d4e7e38..b184689dd6b2 100644
--- a/Documentation/devicetree/bindings/net/mdio.yaml
+++ b/Documentation/devicetree/bindings/net/mdio.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/mdio.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: MDIO Bus Generic Binding
+title: MDIO Bus common properties
 
 maintainers:
   - Andrew Lunn <andrew@lunn.ch>
diff --git a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
index cf9c2f7bddc2..20ac432dc683 100644
--- a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
+++ b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/opp/opp-v2-base.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Generic OPP (Operating Performance Points) Common Binding
+title: Generic OPP (Operating Performance Points) common parts
 
 maintainers:
   - Viresh Kumar <viresh.kumar@linaro.org>
diff --git a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
index 1f9a2aac53c0..8b52fd156d4c 100644
--- a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
+++ b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/power/reset/restart-handler.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Restart and shutdown handler generic binding
+title: Restart and shutdown handler common properties
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/rtc/rtc.yaml b/Documentation/devicetree/bindings/rtc/rtc.yaml
index 0ec3551f12dd..00848a5a409e 100644
--- a/Documentation/devicetree/bindings/rtc/rtc.yaml
+++ b/Documentation/devicetree/bindings/rtc/rtc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/rtc/rtc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: RTC Generic Binding
+title: Real Time Clock common properties
 
 maintainers:
   - Alexandre Belloni <alexandre.belloni@bootlin.com>
diff --git a/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml b/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
index 4aad121eff3f..2176033850dc 100644
--- a/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
+++ b/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/soundwire/soundwire-controller.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: SoundWire Controller Generic Binding
+title: SoundWire Controller common properties
 
 maintainers:
   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
diff --git a/Documentation/devicetree/bindings/spi/spi-controller.yaml b/Documentation/devicetree/bindings/spi/spi-controller.yaml
index 01042a7f382e..6bbe073f894b 100644
--- a/Documentation/devicetree/bindings/spi/spi-controller.yaml
+++ b/Documentation/devicetree/bindings/spi/spi-controller.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/spi/spi-controller.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: SPI Controller Generic Binding
+title: SPI Controller common properties
 
 maintainers:
   - Mark Brown <broonie@kernel.org>
diff --git a/Documentation/devicetree/bindings/watchdog/watchdog.yaml b/Documentation/devicetree/bindings/watchdog/watchdog.yaml
index e3dfb02f0ca5..6875cf1c3159 100644
--- a/Documentation/devicetree/bindings/watchdog/watchdog.yaml
+++ b/Documentation/devicetree/bindings/watchdog/watchdog.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/watchdog/watchdog.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Watchdog Generic Bindings
+title: Watchdog common properties
 
 maintainers:
   - Guenter Roeck <linux@roeck-us.net>
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 26+ messages in thread

* [RFC PATCH 2/9] dt-bindings: memory-controllers: ti,gpmc-child: drop redundant part of title
  2022-11-17 12:38 [RFC PATCH 0/9] dt-bindings: cleanup titles Krzysztof Kozlowski
  2022-11-17 12:38 ` [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Krzysztof Kozlowski
@ 2022-11-17 12:38 ` Krzysztof Kozlowski
  2022-11-17 12:38 ` [RFC PATCH 3/9] dt-bindings: clock: st,stm32mp1-rcc: add proper title Krzysztof Kozlowski
                   ` (6 subsequent siblings)
  8 siblings, 0 replies; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 12:38 UTC (permalink / raw)
  To: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog
  Cc: Krzysztof Kozlowski

The Devicetree bindings document does not have to say in the title that
it is a "Devicetree binding", but instead just describe the hardware.

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
 .../devicetree/bindings/memory-controllers/ti,gpmc-child.yaml   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/devicetree/bindings/memory-controllers/ti,gpmc-child.yaml b/Documentation/devicetree/bindings/memory-controllers/ti,gpmc-child.yaml
index 4a257fac577e..532a91d6c564 100644
--- a/Documentation/devicetree/bindings/memory-controllers/ti,gpmc-child.yaml
+++ b/Documentation/devicetree/bindings/memory-controllers/ti,gpmc-child.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/memory-controllers/ti,gpmc-child.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: device tree bindings for children of the Texas Instruments GPMC
+title: Texas Instruments GPMC bus child nodes
 
 maintainers:
   - Tony Lindgren <tony@atomide.com>
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 26+ messages in thread

* [RFC PATCH 3/9] dt-bindings: clock: st,stm32mp1-rcc: add proper title
  2022-11-17 12:38 [RFC PATCH 0/9] dt-bindings: cleanup titles Krzysztof Kozlowski
  2022-11-17 12:38 ` [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Krzysztof Kozlowski
  2022-11-17 12:38 ` [RFC PATCH 2/9] dt-bindings: memory-controllers: ti,gpmc-child: drop redundant part of title Krzysztof Kozlowski
@ 2022-11-17 12:38 ` Krzysztof Kozlowski
  2022-11-17 12:38 ` [RFC PATCH 4/9] dt-bindings: drop redundant part of title (end) Krzysztof Kozlowski
                   ` (5 subsequent siblings)
  8 siblings, 0 replies; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 12:38 UTC (permalink / raw)
  To: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog
  Cc: Krzysztof Kozlowski

Add device name in the title, because "Reset Clock Controller" sounds
too generic.

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
 Documentation/devicetree/bindings/clock/st,stm32mp1-rcc.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/devicetree/bindings/clock/st,stm32mp1-rcc.yaml b/Documentation/devicetree/bindings/clock/st,stm32mp1-rcc.yaml
index 242fe922b035..5194be0b410e 100644
--- a/Documentation/devicetree/bindings/clock/st,stm32mp1-rcc.yaml
+++ b/Documentation/devicetree/bindings/clock/st,stm32mp1-rcc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/st,stm32mp1-rcc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Reset Clock Controller Binding
+title: STMicroelectronics STM32MP1 Reset Clock Controller
 
 maintainers:
   - Gabriel Fernandez <gabriel.fernandez@foss.st.com>
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 26+ messages in thread

* [RFC PATCH 4/9] dt-bindings: drop redundant part of title (end)
  2022-11-17 12:38 [RFC PATCH 0/9] dt-bindings: cleanup titles Krzysztof Kozlowski
                   ` (2 preceding siblings ...)
  2022-11-17 12:38 ` [RFC PATCH 3/9] dt-bindings: clock: st,stm32mp1-rcc: add proper title Krzysztof Kozlowski
@ 2022-11-17 12:38 ` Krzysztof Kozlowski
  2022-11-17 15:18   ` Jonathan Cameron
  2022-11-17 15:37   ` Jonathan Cameron
  2022-11-17 12:38 ` [RFC PATCH 5/9] dt-bindings: drop redundant part of title (end, part two) Krzysztof Kozlowski
                   ` (4 subsequent siblings)
  8 siblings, 2 replies; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 12:38 UTC (permalink / raw)
  To: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog
  Cc: Krzysztof Kozlowski

The Devicetree bindings document does not have to say in the title that
it is a "Devicetree binding", but instead just describe the hardware.

Drop trailing "Devicetree bindings" in various forms (also with
trailling full stop):

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -not -name 'trivial-devices.yaml' \
    -exec sed -i -e 's/^title: \(.*\) [dD]evice[ -]\?[tT]ree [bB]indings\?\.\?$/title: \1/' {} \;

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -not -name 'trivial-devices.yaml' \
    -exec sed -i -e 's/^title: \(.*\) [dD]evice[ -]\?[nN]ode [bB]indings\?\.\?$/title: \1/' {} \;

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -not -name 'trivial-devices.yaml' \
    -exec sed -i -e 's/^title: \(.*\) [dD][tT] [bB]indings\?\.\?$/title: \1/' {} \;

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
 Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml          | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml    | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml    | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml    | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml     | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml      | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml      | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml         | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml         | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml         | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml    | 2 +-
 Documentation/devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml  | 2 +-
 .../devicetree/bindings/arm/firmware/linaro,optee-tz.yaml       | 2 +-
 Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml  | 2 +-
 Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml      | 2 +-
 Documentation/devicetree/bindings/arm/marvell/armada-7k-8k.yaml | 2 +-
 Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml            | 2 +-
 Documentation/devicetree/bindings/arm/mstar/mstar.yaml          | 2 +-
 Documentation/devicetree/bindings/arm/npcm/npcm.yaml            | 2 +-
 Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml          | 2 +-
 Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml   | 2 +-
 Documentation/devicetree/bindings/arm/socionext/uniphier.yaml   | 2 +-
 Documentation/devicetree/bindings/arm/sprd/sprd.yaml            | 2 +-
 Documentation/devicetree/bindings/arm/stm32/stm32.yaml          | 2 +-
 .../bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml       | 2 +-
 .../devicetree/bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml | 2 +-
 .../bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml         | 2 +-
 Documentation/devicetree/bindings/arm/ti/k3.yaml                | 2 +-
 Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml        | 2 +-
 Documentation/devicetree/bindings/clock/ingenic,cgu.yaml        | 2 +-
 .../devicetree/bindings/clock/renesas,versaclock7.yaml          | 2 +-
 Documentation/devicetree/bindings/display/bridge/anx6345.yaml   | 2 +-
 .../devicetree/bindings/display/bridge/chrontel,ch7033.yaml     | 2 +-
 .../devicetree/bindings/display/bridge/ite,it6505.yaml          | 2 +-
 .../devicetree/bindings/display/bridge/ite,it66121.yaml         | 2 +-
 Documentation/devicetree/bindings/display/bridge/ps8640.yaml    | 2 +-
 Documentation/devicetree/bindings/display/ingenic,ipu.yaml      | 2 +-
 Documentation/devicetree/bindings/display/ingenic,lcd.yaml      | 2 +-
 .../devicetree/bindings/display/mediatek/mediatek,cec.yaml      | 2 +-
 .../devicetree/bindings/display/mediatek/mediatek,dsi.yaml      | 2 +-
 .../devicetree/bindings/display/mediatek/mediatek,hdmi-ddc.yaml | 2 +-
 .../devicetree/bindings/display/mediatek/mediatek,hdmi.yaml     | 2 +-
 .../devicetree/bindings/display/panel/ilitek,ili9163.yaml       | 2 +-
 Documentation/devicetree/bindings/display/panel/panel-lvds.yaml | 2 +-
 .../devicetree/bindings/display/panel/visionox,rm69299.yaml     | 2 +-
 Documentation/devicetree/bindings/dma/ingenic,dma.yaml          | 2 +-
 Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml          | 2 +-
 Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml         | 2 +-
 Documentation/devicetree/bindings/dma/ti/k3-udma.yaml           | 2 +-
 .../devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml       | 2 +-
 Documentation/devicetree/bindings/eeprom/microchip,93lc46b.yaml | 2 +-
 Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml          | 2 +-
 .../devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml    | 2 +-
 Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml  | 2 +-
 .../devicetree/bindings/input/pine64,pinephone-keyboard.yaml    | 2 +-
 .../devicetree/bindings/input/touchscreen/chipone,icn8318.yaml  | 2 +-
 .../devicetree/bindings/input/touchscreen/pixcir,pixcir_ts.yaml | 2 +-
 .../devicetree/bindings/input/touchscreen/silead,gsl1680.yaml   | 2 +-
 .../devicetree/bindings/interrupt-controller/ingenic,intc.yaml  | 2 +-
 .../bindings/interrupt-controller/realtek,rtl-intc.yaml         | 2 +-
 .../devicetree/bindings/media/i2c/dongwoon,dw9768.yaml          | 2 +-
 Documentation/devicetree/bindings/media/i2c/ov8856.yaml         | 2 +-
 Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml   | 2 +-
 Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml    | 2 +-
 Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml    | 2 +-
 Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml    | 2 +-
 Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml   | 2 +-
 .../bindings/memory-controllers/ingenic,nemc-peripherals.yaml   | 2 +-
 .../devicetree/bindings/memory-controllers/ingenic,nemc.yaml    | 2 +-
 .../devicetree/bindings/memory-controllers/ti,gpmc.yaml         | 2 +-
 Documentation/devicetree/bindings/mips/ingenic/devices.yaml     | 2 +-
 .../devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml        | 2 +-
 Documentation/devicetree/bindings/mips/loongson/devices.yaml    | 2 +-
 Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml          | 2 +-
 Documentation/devicetree/bindings/mtd/ingenic,nand.yaml         | 2 +-
 .../devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml    | 2 +-
 Documentation/devicetree/bindings/net/can/bosch,c_can.yaml      | 2 +-
 Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml     | 2 +-
 Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml    | 2 +-
 Documentation/devicetree/bindings/net/dsa/dsa-port.yaml         | 2 +-
 Documentation/devicetree/bindings/net/dsa/dsa.yaml              | 2 +-
 .../devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml       | 2 +-
 Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml      | 2 +-
 Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml      | 2 +-
 Documentation/devicetree/bindings/net/wireless/esp,esp8089.yaml | 2 +-
 .../devicetree/bindings/net/wireless/microchip,wilc1000.yaml    | 2 +-
 Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml  | 2 +-
 Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml     | 2 +-
 Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml      | 2 +-
 Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml  | 2 +-
 .../devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml      | 2 +-
 .../devicetree/bindings/power/supply/maxim,ds2760.yaml          | 2 +-
 .../devicetree/bindings/power/supply/maxim,max14656.yaml        | 2 +-
 Documentation/devicetree/bindings/rtc/epson,rx8900.yaml         | 2 +-
 Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml          | 2 +-
 Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml     | 2 +-
 Documentation/devicetree/bindings/serial/brcm,bcm7271-uart.yaml | 2 +-
 Documentation/devicetree/bindings/serial/ingenic,uart.yaml      | 2 +-
 Documentation/devicetree/bindings/serial/serial.yaml            | 2 +-
 Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml     | 2 +-
 Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml     | 2 +-
 Documentation/devicetree/bindings/sound/ingenic,aic.yaml        | 2 +-
 Documentation/devicetree/bindings/sound/ingenic,codec.yaml      | 2 +-
 .../devicetree/bindings/sound/qcom,lpass-rx-macro.yaml          | 2 +-
 .../devicetree/bindings/sound/qcom,lpass-tx-macro.yaml          | 2 +-
 .../devicetree/bindings/sound/qcom,lpass-va-macro.yaml          | 2 +-
 .../devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml         | 2 +-
 Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml    | 2 +-
 Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml    | 2 +-
 Documentation/devicetree/bindings/sound/ti,src4xxx.yaml         | 2 +-
 Documentation/devicetree/bindings/spi/ingenic,spi.yaml          | 2 +-
 Documentation/devicetree/bindings/spi/spi-gpio.yaml             | 2 +-
 Documentation/devicetree/bindings/timer/ingenic,tcu.yaml        | 2 +-
 Documentation/devicetree/bindings/usb/ingenic,musb.yaml         | 2 +-
 Documentation/devicetree/bindings/usb/maxim,max33359.yaml       | 2 +-
 Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml | 2 +-
 Documentation/devicetree/bindings/usb/ti,tps6598x.yaml          | 2 +-
 Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml    | 2 +-
 118 files changed, 118 insertions(+), 118 deletions(-)

diff --git a/Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml b/Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml
index 8051a75c2c79..162a39dab218 100644
--- a/Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/bcm2835.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom BCM2711/BCM2835 Platforms Device Tree Bindings
+title: Broadcom BCM2711/BCM2835 Platforms
 
 maintainers:
   - Eric Anholt <eric@anholt.net>
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml
index c60324357435..f2bcac0096b7 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,bcm11351.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom BCM11351 device tree bindings
+title: Broadcom BCM11351
 
 maintainers:
   - Florian Fainelli <f.fainelli@gmail.com>
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml
index b3020757380f..cf4e254e32f1 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,bcm21664.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom BCM21664 device tree bindings
+title: Broadcom BCM21664
 
 maintainers:
   - Florian Fainelli <f.fainelli@gmail.com>
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml
index 37f3a6fcde76..eafec29ba7ab 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,bcm23550.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom BCM23550 device tree bindings
+title: Broadcom BCM23550
 
 maintainers:
   - Florian Fainelli <f.fainelli@gmail.com>
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml
index 52b575c40599..454b0e93245d 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,bcm4708.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom BCM4708 device tree bindings
+title: Broadcom BCM4708
 
 description:
   Broadcom BCM4708/47081/4709/47094/53012 Wi-Fi/network SoCs based
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml
index 84866e29cab0..07892cbdd23c 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,bcmbca.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom Broadband SoC device tree bindings
+title: Broadcom Broadband SoC
 
 description:
   Broadcom Broadband SoCs include family of high performance DSL/PON/Wireless
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml
index 432ccf990f9e..a0a3f32db54e 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,cygnus.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom Cygnus device tree bindings
+title: Broadcom Cygnus
 
 maintainers:
   - Ray Jui <rjui@broadcom.com>
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml
index 294948399f82..cc6add0e933a 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,hr2.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom Hurricane 2 device tree bindings
+title: Broadcom Hurricane 2
 
 description:
   Broadcom Hurricane 2 family of SoCs are used for switching control. These SoCs
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml
index c4847abbecd8..6696598eca0e 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,ns2.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom North Star 2 (NS2) device tree bindings
+title: Broadcom North Star 2 (NS2)
 
 maintainers:
   - Ray Jui <rjui@broadcom.com>
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml
index 7d184ba7d180..a43b2d4d936b 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,nsp.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom Northstar Plus device tree bindings
+title: Broadcom Northstar Plus
 
 description:
   Broadcom Northstar Plus family of SoCs are used for switching control
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml
index c638e04ebae0..c6ccb78aab0a 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,stingray.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom Stingray device tree bindings
+title: Broadcom Stingray
 
 maintainers:
   - Ray Jui <rjui@broadcom.com>
diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml
index 4eba182abd53..3f441352fbf0 100644
--- a/Documentation/devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml
+++ b/Documentation/devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/bcm/brcm,vulcan-soc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom Vulcan device tree bindings
+title: Broadcom Vulcan
 
 maintainers:
   - Robert Richter <rrichter@marvell.com>
diff --git a/Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.yaml b/Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.yaml
index 9a426110a14a..d4dc0749f9fd 100644
--- a/Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.yaml
+++ b/Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/firmware/linaro,optee-tz.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: OP-TEE Device Tree Bindings
+title: OP-TEE
 
 maintainers:
   - Jens Wiklander <jens.wiklander@linaro.org>
diff --git a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml
index b38458022946..540876322040 100644
--- a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml
+++ b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/hisilicon/hisilicon.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Hisilicon Platforms Device Tree Bindings
+title: Hisilicon Platforms
 
 maintainers:
   - Wei Xu <xuwei5@hisilicon.com>
diff --git a/Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml b/Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml
index 34f5f877d444..91b96065f7df 100644
--- a/Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml
+++ b/Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/keystone/ti,sci.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: TI-SCI controller device node bindings
+title: TI-SCI controller
 
 maintainers:
   - Nishanth Menon <nm@ti.com>
diff --git a/Documentation/devicetree/bindings/arm/marvell/armada-7k-8k.yaml b/Documentation/devicetree/bindings/arm/marvell/armada-7k-8k.yaml
index e9bf3054529f..52d78521e412 100644
--- a/Documentation/devicetree/bindings/arm/marvell/armada-7k-8k.yaml
+++ b/Documentation/devicetree/bindings/arm/marvell/armada-7k-8k.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/marvell/armada-7k-8k.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Marvell Armada 7K/8K Platforms Device Tree Bindings
+title: Marvell Armada 7K/8K Platforms
 
 maintainers:
   - Gregory CLEMENT <gregory.clement@bootlin.com>
diff --git a/Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml b/Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml
index d58116136154..4c43eaf3632e 100644
--- a/Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml
+++ b/Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/mrvl/mrvl.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Marvell Platforms Device Tree Bindings
+title: Marvell Platforms
 
 maintainers:
   - Lubomir Rintel <lkundrak@v3.sk>
diff --git a/Documentation/devicetree/bindings/arm/mstar/mstar.yaml b/Documentation/devicetree/bindings/arm/mstar/mstar.yaml
index 8892eb6bd3ef..937059fcc7b3 100644
--- a/Documentation/devicetree/bindings/arm/mstar/mstar.yaml
+++ b/Documentation/devicetree/bindings/arm/mstar/mstar.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/mstar/mstar.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: MStar platforms device tree bindings
+title: MStar platforms
 
 maintainers:
   - Daniel Palmer <daniel@thingy.jp>
diff --git a/Documentation/devicetree/bindings/arm/npcm/npcm.yaml b/Documentation/devicetree/bindings/arm/npcm/npcm.yaml
index 43409e5721d5..6871483947c5 100644
--- a/Documentation/devicetree/bindings/arm/npcm/npcm.yaml
+++ b/Documentation/devicetree/bindings/arm/npcm/npcm.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/npcm/npcm.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: NPCM Platforms Device Tree Bindings
+title: NPCM Platforms
 
 maintainers:
   - Jonathan Neuschäfer <j.neuschaefer@gmx.net>
diff --git a/Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml b/Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml
index 214c97bc3063..f1bd6f50e726 100644
--- a/Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml
+++ b/Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/nxp/lpc32xx.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: NXP LPC32xx Platforms Device Tree Bindings
+title: NXP LPC32xx Platforms
 
 maintainers:
   - Roland Stigge <stigge@antcom.de>
diff --git a/Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml b/Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml
index aa1d4afbc510..5a428a885760 100644
--- a/Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml
+++ b/Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/socionext/milbeaut.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Milbeaut platforms device tree bindings
+title: Milbeaut platforms
 
 maintainers:
   - Taichi Sugaya <sugaya.taichi@socionext.com>
diff --git a/Documentation/devicetree/bindings/arm/socionext/uniphier.yaml b/Documentation/devicetree/bindings/arm/socionext/uniphier.yaml
index 8c0e91658474..a141da880469 100644
--- a/Documentation/devicetree/bindings/arm/socionext/uniphier.yaml
+++ b/Documentation/devicetree/bindings/arm/socionext/uniphier.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/socionext/uniphier.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Socionext UniPhier platform device tree bindings
+title: Socionext UniPhier platform
 
 maintainers:
   - Masahiro Yamada <yamada.masahiro@socionext.com>
diff --git a/Documentation/devicetree/bindings/arm/sprd/sprd.yaml b/Documentation/devicetree/bindings/arm/sprd/sprd.yaml
index 2c12e571394b..eaa67b8e0d6c 100644
--- a/Documentation/devicetree/bindings/arm/sprd/sprd.yaml
+++ b/Documentation/devicetree/bindings/arm/sprd/sprd.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/arm/sprd/sprd.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Unisoc platforms device tree bindings
+title: Unisoc platforms
 
 maintainers:
   - Orson Zhai <orsonzhai@gmail.com>
diff --git a/Documentation/devicetree/bindings/arm/stm32/stm32.yaml b/Documentation/devicetree/bindings/arm/stm32/stm32.yaml
index 44f5c5855af8..13e34241145b 100644
--- a/Documentation/devicetree/bindings/arm/stm32/stm32.yaml
+++ b/Documentation/devicetree/bindings/arm/stm32/stm32.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/stm32/stm32.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: STMicroelectronics STM32 Platforms Device Tree Bindings
+title: STMicroelectronics STM32 Platforms
 
 maintainers:
   - Alexandre Torgue <alexandre.torgue@foss.st.com>
diff --git a/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml b/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml
index f3878e0b3cc4..d805c4508b4e 100644
--- a/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml
+++ b/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Allwinner CPU Configuration Controller Device Tree Bindings
+title: Allwinner CPU Configuration Controller
 
 maintainers:
   - Chen-Yu Tsai <wens@csie.org>
diff --git a/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml b/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml
index 668aadbfe4c0..644f391afb32 100644
--- a/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml
+++ b/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/sunxi/allwinner,sun9i-a80-prcm.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Allwinner A80 PRCM Device Tree Bindings
+title: Allwinner A80 PRCM
 
 maintainers:
   - Chen-Yu Tsai <wens@csie.org>
diff --git a/Documentation/devicetree/bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml b/Documentation/devicetree/bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml
index 869c266e7ebc..6089a96eae4f 100644
--- a/Documentation/devicetree/bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml
+++ b/Documentation/devicetree/bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/arm/tegra/nvidia,tegra-ccplex-cluster.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: NVIDIA Tegra CPU COMPLEX CLUSTER area device tree bindings
+title: NVIDIA Tegra CPU COMPLEX CLUSTER area
 
 maintainers:
   - Sumit Gupta <sumitg@nvidia.com>
diff --git a/Documentation/devicetree/bindings/arm/ti/k3.yaml b/Documentation/devicetree/bindings/arm/ti/k3.yaml
index 28b8232e1c5b..49718804fd43 100644
--- a/Documentation/devicetree/bindings/arm/ti/k3.yaml
+++ b/Documentation/devicetree/bindings/arm/ti/k3.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/ti/k3.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Texas Instruments K3 Multicore SoC architecture device tree bindings
+title: Texas Instruments K3 Multicore SoC architecture
 
 maintainers:
   - Nishanth Menon <nm@ti.com>
diff --git a/Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml b/Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml
index c022d325fc08..1656d1a4476f 100644
--- a/Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml
+++ b/Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/arm/ti/ti,davinci.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Texas Instruments DaVinci Platforms Device Tree Bindings
+title: Texas Instruments DaVinci Platforms
 
 maintainers:
   - Sekhar Nori <nsekhar@ti.com>
diff --git a/Documentation/devicetree/bindings/clock/ingenic,cgu.yaml b/Documentation/devicetree/bindings/clock/ingenic,cgu.yaml
index df256ebcd366..9e733b10c392 100644
--- a/Documentation/devicetree/bindings/clock/ingenic,cgu.yaml
+++ b/Documentation/devicetree/bindings/clock/ingenic,cgu.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/ingenic,cgu.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs CGU devicetree bindings
+title: Ingenic SoCs CGU
 
 description: |
   The CGU in an Ingenic SoC provides all the clocks generated on-chip. It
diff --git a/Documentation/devicetree/bindings/clock/renesas,versaclock7.yaml b/Documentation/devicetree/bindings/clock/renesas,versaclock7.yaml
index 8d4eb4475fc8..b339f1f9f072 100644
--- a/Documentation/devicetree/bindings/clock/renesas,versaclock7.yaml
+++ b/Documentation/devicetree/bindings/clock/renesas,versaclock7.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/renesas,versaclock7.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Renesas Versaclock7 Programmable Clock Device Tree Bindings
+title: Renesas Versaclock7 Programmable Clock
 
 maintainers:
   - Alex Helms <alexander.helms.jy@renesas.com>
diff --git a/Documentation/devicetree/bindings/display/bridge/anx6345.yaml b/Documentation/devicetree/bindings/display/bridge/anx6345.yaml
index 1c0406c38fe5..9bf2cbcea69f 100644
--- a/Documentation/devicetree/bindings/display/bridge/anx6345.yaml
+++ b/Documentation/devicetree/bindings/display/bridge/anx6345.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/bridge/anx6345.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Analogix ANX6345 eDP Transmitter Device Tree Bindings
+title: Analogix ANX6345 eDP Transmitter
 
 maintainers:
   - Torsten Duwe <duwe@lst.de>
diff --git a/Documentation/devicetree/bindings/display/bridge/chrontel,ch7033.yaml b/Documentation/devicetree/bindings/display/bridge/chrontel,ch7033.yaml
index bb6289c7d375..b0589fa16736 100644
--- a/Documentation/devicetree/bindings/display/bridge/chrontel,ch7033.yaml
+++ b/Documentation/devicetree/bindings/display/bridge/chrontel,ch7033.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/display/bridge/chrontel,ch7033.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Chrontel CH7033 Video Encoder Device Tree Bindings
+title: Chrontel CH7033 Video Encoder
 
 maintainers:
   - Lubomir Rintel <lkundrak@v3.sk>
diff --git a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
index 833d11b2303a..b697c42399ea 100644
--- a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
+++ b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/bridge/ite,it6505.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: ITE it6505 Device Tree Bindings
+title: ITE it6505
 
 maintainers:
   - Allen Chen <allen.chen@ite.com.tw>
diff --git a/Documentation/devicetree/bindings/display/bridge/ite,it66121.yaml b/Documentation/devicetree/bindings/display/bridge/ite,it66121.yaml
index 1b2185be92cd..d3454da1247a 100644
--- a/Documentation/devicetree/bindings/display/bridge/ite,it66121.yaml
+++ b/Documentation/devicetree/bindings/display/bridge/ite,it66121.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/bridge/ite,it66121.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: ITE it66121 HDMI bridge Device Tree Bindings
+title: ITE it66121 HDMI bridge
 
 maintainers:
   - Phong LE <ple@baylibre.com>
diff --git a/Documentation/devicetree/bindings/display/bridge/ps8640.yaml b/Documentation/devicetree/bindings/display/bridge/ps8640.yaml
index 8ab156e0a8cf..28811aff2c5a 100644
--- a/Documentation/devicetree/bindings/display/bridge/ps8640.yaml
+++ b/Documentation/devicetree/bindings/display/bridge/ps8640.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/bridge/ps8640.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: MIPI DSI to eDP Video Format Converter Device Tree Bindings
+title: MIPI DSI to eDP Video Format Converter
 
 maintainers:
   - Nicolas Boichat <drinkcat@chromium.org>
diff --git a/Documentation/devicetree/bindings/display/ingenic,ipu.yaml b/Documentation/devicetree/bindings/display/ingenic,ipu.yaml
index 3f93def2c5a2..319bd7c88fe3 100644
--- a/Documentation/devicetree/bindings/display/ingenic,ipu.yaml
+++ b/Documentation/devicetree/bindings/display/ingenic,ipu.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/ingenic,ipu.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs Image Processing Unit (IPU) devicetree bindings
+title: Ingenic SoCs Image Processing Unit (IPU)
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/display/ingenic,lcd.yaml b/Documentation/devicetree/bindings/display/ingenic,lcd.yaml
index c0bb02fb49f4..6d4c00f3fcc8 100644
--- a/Documentation/devicetree/bindings/display/ingenic,lcd.yaml
+++ b/Documentation/devicetree/bindings/display/ingenic,lcd.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/ingenic,lcd.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs LCD controller devicetree bindings
+title: Ingenic SoCs LCD controller
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/display/mediatek/mediatek,cec.yaml b/Documentation/devicetree/bindings/display/mediatek/mediatek,cec.yaml
index 66288b9f0aa6..080cf321209e 100644
--- a/Documentation/devicetree/bindings/display/mediatek/mediatek,cec.yaml
+++ b/Documentation/devicetree/bindings/display/mediatek/mediatek,cec.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/mediatek/mediatek,cec.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Mediatek HDMI CEC Controller Device Tree Bindings
+title: Mediatek HDMI CEC Controller
 
 maintainers:
   - CK Hu <ck.hu@mediatek.com>
diff --git a/Documentation/devicetree/bindings/display/mediatek/mediatek,dsi.yaml b/Documentation/devicetree/bindings/display/mediatek/mediatek,dsi.yaml
index b18d6a57c6e1..4707b60238b0 100644
--- a/Documentation/devicetree/bindings/display/mediatek/mediatek,dsi.yaml
+++ b/Documentation/devicetree/bindings/display/mediatek/mediatek,dsi.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/mediatek/mediatek,dsi.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: MediaTek DSI Controller Device Tree Bindings
+title: MediaTek DSI Controller
 
 maintainers:
   - Chun-Kuang Hu <chunkuang.hu@kernel.org>
diff --git a/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi-ddc.yaml b/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi-ddc.yaml
index b6fcdfb99ab2..bd8f7b8ae0ff 100644
--- a/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi-ddc.yaml
+++ b/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi-ddc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/mediatek/mediatek,hdmi-ddc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Mediatek HDMI DDC Device Tree Bindings
+title: Mediatek HDMI DDC
 
 maintainers:
   - CK Hu <ck.hu@mediatek.com>
diff --git a/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi.yaml b/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi.yaml
index bdaf0b51e68c..8afdd67d6780 100644
--- a/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi.yaml
+++ b/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/mediatek/mediatek,hdmi.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Mediatek HDMI Encoder Device Tree Bindings
+title: Mediatek HDMI Encoder
 
 maintainers:
   - CK Hu <ck.hu@mediatek.com>
diff --git a/Documentation/devicetree/bindings/display/panel/ilitek,ili9163.yaml b/Documentation/devicetree/bindings/display/panel/ilitek,ili9163.yaml
index a4154b51043e..90e323e19edb 100644
--- a/Documentation/devicetree/bindings/display/panel/ilitek,ili9163.yaml
+++ b/Documentation/devicetree/bindings/display/panel/ilitek,ili9163.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/panel/ilitek,ili9163.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ilitek ILI9163 display panels device tree bindings
+title: Ilitek ILI9163 display panels
 
 maintainers:
   - Daniel Mack <daniel@zonque.org>
diff --git a/Documentation/devicetree/bindings/display/panel/panel-lvds.yaml b/Documentation/devicetree/bindings/display/panel/panel-lvds.yaml
index fcc50db6a812..c77ee034310a 100644
--- a/Documentation/devicetree/bindings/display/panel/panel-lvds.yaml
+++ b/Documentation/devicetree/bindings/display/panel/panel-lvds.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/panel/panel-lvds.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Generic LVDS Display Panel Device Tree Bindings
+title: Generic LVDS Display Panel
 
 maintainers:
   - Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
diff --git a/Documentation/devicetree/bindings/display/panel/visionox,rm69299.yaml b/Documentation/devicetree/bindings/display/panel/visionox,rm69299.yaml
index 076b057b4af5..481ef051df1e 100644
--- a/Documentation/devicetree/bindings/display/panel/visionox,rm69299.yaml
+++ b/Documentation/devicetree/bindings/display/panel/visionox,rm69299.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/panel/visionox,rm69299.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Visionox model RM69299 Panels Device Tree Bindings.
+title: Visionox model RM69299 Panels
 
 maintainers:
   - Harigovindan P <harigovi@codeaurora.org>
diff --git a/Documentation/devicetree/bindings/dma/ingenic,dma.yaml b/Documentation/devicetree/bindings/dma/ingenic,dma.yaml
index e42b8ce948db..fd5b0a8eaed8 100644
--- a/Documentation/devicetree/bindings/dma/ingenic,dma.yaml
+++ b/Documentation/devicetree/bindings/dma/ingenic,dma.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/dma/ingenic,dma.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs DMA Controller DT bindings
+title: Ingenic SoCs DMA Controller
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml b/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml
index 08627d91e607..a702d2c2ff8d 100644
--- a/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml
+++ b/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml
@@ -6,7 +6,7 @@
 $id: http://devicetree.org/schemas/dma/ti/k3-bcdma.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Texas Instruments K3 DMSS BCDMA Device Tree Bindings
+title: Texas Instruments K3 DMSS BCDMA
 
 maintainers:
   - Peter Ujfalusi <peter.ujfalusi@gmail.com>
diff --git a/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml b/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml
index 507d16d84ade..a69f62f854d8 100644
--- a/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml
+++ b/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml
@@ -6,7 +6,7 @@
 $id: http://devicetree.org/schemas/dma/ti/k3-pktdma.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Texas Instruments K3 DMSS PKTDMA Device Tree Bindings
+title: Texas Instruments K3 DMSS PKTDMA
 
 maintainers:
   - Peter Ujfalusi <peter.ujfalusi@gmail.com>
diff --git a/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml b/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml
index 6a09bbf83d46..7ff428ad3aae 100644
--- a/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml
+++ b/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml
@@ -6,7 +6,7 @@
 $id: http://devicetree.org/schemas/dma/ti/k3-udma.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Texas Instruments K3 NAVSS Unified DMA Device Tree Bindings
+title: Texas Instruments K3 NAVSS Unified DMA
 
 maintainers:
   - Peter Ujfalusi <peter.ujfalusi@gmail.com>
diff --git a/Documentation/devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml b/Documentation/devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml
index 2a595b18ff6c..825294e3f0e8 100644
--- a/Documentation/devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml
+++ b/Documentation/devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/dma/xilinx/xlnx,zynqmp-dpdma.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Xilinx ZynqMP DisplayPort DMA Controller Device Tree Bindings
+title: Xilinx ZynqMP DisplayPort DMA Controller
 
 description: |
   These bindings describe the DMA engine included in the Xilinx ZynqMP
diff --git a/Documentation/devicetree/bindings/eeprom/microchip,93lc46b.yaml b/Documentation/devicetree/bindings/eeprom/microchip,93lc46b.yaml
index 0c2f5ddb79c5..5476bed79f16 100644
--- a/Documentation/devicetree/bindings/eeprom/microchip,93lc46b.yaml
+++ b/Documentation/devicetree/bindings/eeprom/microchip,93lc46b.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/eeprom/microchip,93lc46b.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Microchip 93xx46 SPI compatible EEPROM family dt bindings
+title: Microchip 93xx46 SPI compatible EEPROM family
 
 maintainers:
   - Cory Tusar <cory.tusar@pid1solutions.com>
diff --git a/Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml b/Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml
index af6d64a6da6e..b61fdc9548d8 100644
--- a/Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml
+++ b/Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/i2c/ingenic,i2c.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs I2C controller devicetree bindings
+title: Ingenic SoCs I2C controller
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml b/Documentation/devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml
index 15c514b83583..a73a355fc665 100644
--- a/Documentation/devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml
+++ b/Documentation/devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/iio/adc/allwinner,sun8i-a33-ths.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Allwinner A33 Thermal Sensor Device Tree Bindings
+title: Allwinner A33 Thermal Sensor
 
 maintainers:
   - Chen-Yu Tsai <wens@csie.org>
diff --git a/Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml b/Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml
index 57a31356082e..720c16a108d4 100644
--- a/Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml
+++ b/Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/iio/adc/ti,palmas-gpadc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Palmas general purpose ADC IP block devicetree bindings
+title: Palmas general purpose ADC IP block
 
 maintainers:
   - Tony Lindgren <tony@atomide.com>
diff --git a/Documentation/devicetree/bindings/input/pine64,pinephone-keyboard.yaml b/Documentation/devicetree/bindings/input/pine64,pinephone-keyboard.yaml
index e4a0ac0fff9a..490f6c3d9e4b 100644
--- a/Documentation/devicetree/bindings/input/pine64,pinephone-keyboard.yaml
+++ b/Documentation/devicetree/bindings/input/pine64,pinephone-keyboard.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/input/pine64,pinephone-keyboard.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Pine64 PinePhone keyboard device tree bindings
+title: Pine64 PinePhone keyboard
 
 maintainers:
   - Samuel Holland <samuel@sholland.org>
diff --git a/Documentation/devicetree/bindings/input/touchscreen/chipone,icn8318.yaml b/Documentation/devicetree/bindings/input/touchscreen/chipone,icn8318.yaml
index 9df685bdc5db..74a8a01e0745 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/chipone,icn8318.yaml
+++ b/Documentation/devicetree/bindings/input/touchscreen/chipone,icn8318.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/input/touchscreen/chipone,icn8318.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: ChipOne ICN8318 Touchscreen Controller Device Tree Bindings
+title: ChipOne ICN8318 Touchscreen Controller
 
 maintainers:
   - Dmitry Torokhov <dmitry.torokhov@gmail.com>
diff --git a/Documentation/devicetree/bindings/input/touchscreen/pixcir,pixcir_ts.yaml b/Documentation/devicetree/bindings/input/touchscreen/pixcir,pixcir_ts.yaml
index f9998edbff70..3305eda5ed88 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/pixcir,pixcir_ts.yaml
+++ b/Documentation/devicetree/bindings/input/touchscreen/pixcir,pixcir_ts.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/input/touchscreen/pixcir,pixcir_ts.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Pixcir Touchscreen Controller Device Tree Bindings
+title: Pixcir Touchscreen Controller
 
 maintainers:
   - Dmitry Torokhov <dmitry.torokhov@gmail.com>
diff --git a/Documentation/devicetree/bindings/input/touchscreen/silead,gsl1680.yaml b/Documentation/devicetree/bindings/input/touchscreen/silead,gsl1680.yaml
index eec6f7f6f0a3..95b554be25b4 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/silead,gsl1680.yaml
+++ b/Documentation/devicetree/bindings/input/touchscreen/silead,gsl1680.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/input/touchscreen/silead,gsl1680.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Silead GSL1680 Touchscreen Controller Device Tree Bindings
+title: Silead GSL1680 Touchscreen Controller
 
 maintainers:
   - Dmitry Torokhov <dmitry.torokhov@gmail.com>
diff --git a/Documentation/devicetree/bindings/interrupt-controller/ingenic,intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/ingenic,intc.yaml
index 0358a7739c8e..609308a5f91d 100644
--- a/Documentation/devicetree/bindings/interrupt-controller/ingenic,intc.yaml
+++ b/Documentation/devicetree/bindings/interrupt-controller/ingenic,intc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/interrupt-controller/ingenic,intc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs interrupt controller devicetree bindings
+title: Ingenic SoCs interrupt controller
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/interrupt-controller/realtek,rtl-intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/realtek,rtl-intc.yaml
index 13a893b18fb6..fb5593724059 100644
--- a/Documentation/devicetree/bindings/interrupt-controller/realtek,rtl-intc.yaml
+++ b/Documentation/devicetree/bindings/interrupt-controller/realtek,rtl-intc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/interrupt-controller/realtek,rtl-intc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Realtek RTL SoC interrupt controller devicetree bindings
+title: Realtek RTL SoC interrupt controller
 
 description:
   Interrupt controller and router for Realtek MIPS SoCs, allowing each SoC
diff --git a/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9768.yaml b/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9768.yaml
index 21864ab86ec4..82d3d18c16a1 100644
--- a/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9768.yaml
+++ b/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9768.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/media/i2c/dongwoon,dw9768.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Dongwoon Anatech DW9768 Voice Coil Motor (VCM) Lens Device Tree Bindings
+title: Dongwoon Anatech DW9768 Voice Coil Motor (VCM) Lens
 
 maintainers:
   - Dongchun Zhu <dongchun.zhu@mediatek.com>
diff --git a/Documentation/devicetree/bindings/media/i2c/ov8856.yaml b/Documentation/devicetree/bindings/media/i2c/ov8856.yaml
index baf92aaaf049..e17288d57981 100644
--- a/Documentation/devicetree/bindings/media/i2c/ov8856.yaml
+++ b/Documentation/devicetree/bindings/media/i2c/ov8856.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/media/i2c/ov8856.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Omnivision OV8856 CMOS Sensor Device Tree Bindings
+title: Omnivision OV8856 CMOS Sensor
 
 maintainers:
   - Dongchun Zhu <dongchun.zhu@mediatek.com>
diff --git a/Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml b/Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml
index 63a040944f3d..54df9d73dc86 100644
--- a/Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml
+++ b/Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/media/i2c/ovti,ov02a10.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Omnivision OV02A10 CMOS Sensor Device Tree Bindings
+title: Omnivision OV02A10 CMOS Sensor
 
 maintainers:
   - Dongchun Zhu <dongchun.zhu@mediatek.com>
diff --git a/Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml b/Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml
index 540fd69ac39f..a621032f9bd0 100644
--- a/Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml
+++ b/Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/media/i2c/ovti,ov5640.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: OmniVision OV5640 Image Sensor Device Tree Bindings
+title: OmniVision OV5640 Image Sensor
 
 maintainers:
   - Steve Longerbeam <slongerbeam@gmail.com>
diff --git a/Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml b/Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml
index 246dc5fec716..61e4e9cf8783 100644
--- a/Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml
+++ b/Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/media/i2c/ovti,ov5648.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: OmniVision OV5648 Image Sensor Device Tree Bindings
+title: OmniVision OV5648 Image Sensor
 
 maintainers:
   - Paul Kocialkowski <paul.kocialkowski@bootlin.com>
diff --git a/Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml b/Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml
index b962863e4f65..6bac326dceaf 100644
--- a/Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml
+++ b/Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/media/i2c/ovti,ov8865.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: OmniVision OV8865 Image Sensor Device Tree Bindings
+title: OmniVision OV8865 Image Sensor
 
 maintainers:
   - Paul Kocialkowski <paul.kocialkowski@bootlin.com>
diff --git a/Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml b/Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml
index 6597e1d0e65f..8c28848b226a 100644
--- a/Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml
+++ b/Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/media/i2c/st,st-vgxy61.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: STMicroelectronics VGxy61 HDR Global Shutter Sensor Family Device Tree Bindings
+title: STMicroelectronics VGxy61 HDR Global Shutter Sensor Family
 
 maintainers:
   - Benjamin Mugnier <benjamin.mugnier@foss.st.com>
diff --git a/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc-peripherals.yaml b/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc-peripherals.yaml
index b8ed52a44d57..89ebe3979012 100644
--- a/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc-peripherals.yaml
+++ b/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc-peripherals.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/memory-controllers/ingenic,nemc-peripherals.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs NAND / External Memory Controller (NEMC) devicetree bindings
+title: Ingenic SoCs NAND / External Memory Controller (NEMC)
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc.yaml b/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc.yaml
index dd13a5106d6c..a02724221ff3 100644
--- a/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc.yaml
+++ b/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/memory-controllers/ingenic,nemc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs NAND / External Memory Controller (NEMC) devicetree bindings
+title: Ingenic SoCs NAND / External Memory Controller (NEMC)
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/memory-controllers/ti,gpmc.yaml b/Documentation/devicetree/bindings/memory-controllers/ti,gpmc.yaml
index e188a4bf755c..4f30173ad747 100644
--- a/Documentation/devicetree/bindings/memory-controllers/ti,gpmc.yaml
+++ b/Documentation/devicetree/bindings/memory-controllers/ti,gpmc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/memory-controllers/ti,gpmc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Texas Instruments GPMC Memory Controller device-tree bindings
+title: Texas Instruments GPMC Memory Controller
 
 maintainers:
   - Tony Lindgren <tony@atomide.com>
diff --git a/Documentation/devicetree/bindings/mips/ingenic/devices.yaml b/Documentation/devicetree/bindings/mips/ingenic/devices.yaml
index ee00d414df10..f2e822afe7fb 100644
--- a/Documentation/devicetree/bindings/mips/ingenic/devices.yaml
+++ b/Documentation/devicetree/bindings/mips/ingenic/devices.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/mips/ingenic/devices.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic XBurst based Platforms Device Tree Bindings
+title: Ingenic XBurst based Platforms
 
 maintainers:
   - 周琰杰 (Zhou Yanjie) <zhouyanjie@wanyeetech.com>
diff --git a/Documentation/devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml b/Documentation/devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml
index 40130fefa2b4..15d41bdbdc26 100644
--- a/Documentation/devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml
+++ b/Documentation/devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/mips/lantiq/lantiq,dma-xway.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Lantiq Xway SoCs DMA Controller DT bindings
+title: Lantiq Xway SoCs DMA Controller
 
 maintainers:
   - John Crispin <john@phrozen.org>
diff --git a/Documentation/devicetree/bindings/mips/loongson/devices.yaml b/Documentation/devicetree/bindings/mips/loongson/devices.yaml
index 9fee6708e6f5..f13ce386f42c 100644
--- a/Documentation/devicetree/bindings/mips/loongson/devices.yaml
+++ b/Documentation/devicetree/bindings/mips/loongson/devices.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/mips/loongson/devices.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Loongson based Platforms Device Tree Bindings
+title: Loongson based Platforms
 
 maintainers:
   - Jiaxun Yang <jiaxun.yang@flygoat.com>
diff --git a/Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml b/Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml
index 2d10aedf2e00..bb4e0be0c893 100644
--- a/Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml
+++ b/Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/mmc/ingenic,mmc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs MMC Controller DT bindings
+title: Ingenic SoCs MMC Controller
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/mtd/ingenic,nand.yaml b/Documentation/devicetree/bindings/mtd/ingenic,nand.yaml
index 8c272c842bfd..cd1aa91d4b2b 100644
--- a/Documentation/devicetree/bindings/mtd/ingenic,nand.yaml
+++ b/Documentation/devicetree/bindings/mtd/ingenic,nand.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/mtd/ingenic,nand.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs NAND controller devicetree bindings
+title: Ingenic SoCs NAND controller
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml b/Documentation/devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml
index 3c51b2d02957..9c494957a07a 100644
--- a/Documentation/devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml
+++ b/Documentation/devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/can/allwinner,sun4i-a10-can.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Allwinner A10 CAN Controller Device Tree Bindings
+title: Allwinner A10 CAN Controller
 
 maintainers:
   - Chen-Yu Tsai <wens@csie.org>
diff --git a/Documentation/devicetree/bindings/net/can/bosch,c_can.yaml b/Documentation/devicetree/bindings/net/can/bosch,c_can.yaml
index 51aa89ac7e85..4d7d67ee175a 100644
--- a/Documentation/devicetree/bindings/net/can/bosch,c_can.yaml
+++ b/Documentation/devicetree/bindings/net/can/bosch,c_can.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/can/bosch,c_can.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bosch C_CAN/D_CAN controller Device Tree Bindings
+title: Bosch C_CAN/D_CAN controller
 
 description: Bosch C_CAN/D_CAN controller for CAN bus
 
diff --git a/Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml b/Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml
index 4635cb96fc64..a009a4402938 100644
--- a/Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml
+++ b/Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/can/ctu,ctucanfd.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: CTU CAN FD Open-source IP Core Device Tree Bindings
+title: CTU CAN FD Open-source IP Core
 
 description: |
   Open-source CAN FD IP core developed at the Czech Technical University in Prague
diff --git a/Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml b/Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml
index 259a0c6547f3..2a6d126606ca 100644
--- a/Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml
+++ b/Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/dsa/arrow,xrs700x.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Arrow SpeedChips XRS7000 Series Switch Device Tree Bindings
+title: Arrow SpeedChips XRS7000 Series Switch
 
 allOf:
   - $ref: dsa.yaml#
diff --git a/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml b/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml
index 9abb8eba5fad..b173fceb8998 100644
--- a/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml
+++ b/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/dsa/dsa-port.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ethernet Switch port Device Tree Bindings
+title: Ethernet Switch port
 
 maintainers:
   - Andrew Lunn <andrew@lunn.ch>
diff --git a/Documentation/devicetree/bindings/net/dsa/dsa.yaml b/Documentation/devicetree/bindings/net/dsa/dsa.yaml
index b9d48e357e77..5469ae8a4389 100644
--- a/Documentation/devicetree/bindings/net/dsa/dsa.yaml
+++ b/Documentation/devicetree/bindings/net/dsa/dsa.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/dsa/dsa.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ethernet Switch Device Tree Bindings
+title: Ethernet Switch
 
 maintainers:
   - Andrew Lunn <andrew@lunn.ch>
diff --git a/Documentation/devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml b/Documentation/devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml
index 73b774eadd0b..b0869df3059c 100644
--- a/Documentation/devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml
+++ b/Documentation/devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/dsa/hirschmann,hellcreek.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Hirschmann Hellcreek TSN Switch Device Tree Bindings
+title: Hirschmann Hellcreek TSN Switch
 
 allOf:
   - $ref: dsa.yaml#
diff --git a/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml b/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml
index 8d93ed9c172c..347a0e1b3d3f 100644
--- a/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml
+++ b/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/dsa/mscc,ocelot.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Microchip Ocelot Switch Family Device Tree Bindings
+title: Microchip Ocelot Switch Family
 
 maintainers:
   - Vladimir Oltean <vladimir.oltean@nxp.com>
diff --git a/Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml b/Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml
index 1e26d876d146..df98a16e4e75 100644
--- a/Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml
+++ b/Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/dsa/nxp,sja1105.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: NXP SJA1105 Automotive Ethernet Switch Family Device Tree Bindings
+title: NXP SJA1105 Automotive Ethernet Switch Family
 
 description:
   The SJA1105 SPI interface requires a CS-to-CLK time (t2 in UM10944.pdf) of at
diff --git a/Documentation/devicetree/bindings/net/wireless/esp,esp8089.yaml b/Documentation/devicetree/bindings/net/wireless/esp,esp8089.yaml
index 284ef45add99..5557676e9d4b 100644
--- a/Documentation/devicetree/bindings/net/wireless/esp,esp8089.yaml
+++ b/Documentation/devicetree/bindings/net/wireless/esp,esp8089.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/wireless/esp,esp8089.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Espressif ESP8089 Device Tree Bindings
+title: Espressif ESP8089
 
 maintainers:
   - Hans de Goede <hdegoede@redhat.com>
diff --git a/Documentation/devicetree/bindings/net/wireless/microchip,wilc1000.yaml b/Documentation/devicetree/bindings/net/wireless/microchip,wilc1000.yaml
index b3405f284580..2460ccc08237 100644
--- a/Documentation/devicetree/bindings/net/wireless/microchip,wilc1000.yaml
+++ b/Documentation/devicetree/bindings/net/wireless/microchip,wilc1000.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/wireless/microchip,wilc1000.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Microchip WILC wireless devicetree bindings
+title: Microchip WILC wireless
 
 maintainers:
   - Adham Abozaeid <adham.abozaeid@microchip.com>
diff --git a/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml b/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml
index b35d2f3ad1ad..583db5d42226 100644
--- a/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml
+++ b/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml
@@ -6,7 +6,7 @@
 $id: http://devicetree.org/schemas/net/wireless/silabs,wfx.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Silicon Labs WFxxx devicetree bindings
+title: Silicon Labs WFxxx
 
 maintainers:
   - Jérôme Pouiller <jerome.pouiller@silabs.com>
diff --git a/Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml b/Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml
index ee79e13b5fe0..e08504ef3b6e 100644
--- a/Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml
+++ b/Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/nvmem/qcom,spmi-sdam.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Qualcomm Technologies, Inc. SPMI SDAM DT bindings
+title: Qualcomm Technologies, Inc. SPMI SDAM
 
 maintainers:
   - Shyam Kumar Thella <sthella@codeaurora.org>
diff --git a/Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml b/Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml
index 5cab21648632..30b42008db06 100644
--- a/Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml
+++ b/Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/phy/ingenic,phy-usb.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs USB PHY devicetree bindings
+title: Ingenic SoCs USB PHY
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml b/Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml
index c2c370448b81..a4397930e0e8 100644
--- a/Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml
+++ b/Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/pinctrl/ingenic,pinctrl.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs pin controller devicetree bindings
+title: Ingenic SoCs pin controller
 
 description: >
   Please refer to pinctrl-bindings.txt in this directory for details of the
diff --git a/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml b/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml
index 46de35861738..11f1f98c1cdc 100644
--- a/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml
+++ b/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/power/reset/xlnx,zynqmp-power.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Xilinx Zynq MPSoC Power Management Device Tree Bindings
+title: Xilinx Zynq MPSoC Power Management
 
 maintainers:
   - Michal Simek <michal.simek@xilinx.com>
diff --git a/Documentation/devicetree/bindings/power/supply/maxim,ds2760.yaml b/Documentation/devicetree/bindings/power/supply/maxim,ds2760.yaml
index c838efcf7e16..5faa2418fe2f 100644
--- a/Documentation/devicetree/bindings/power/supply/maxim,ds2760.yaml
+++ b/Documentation/devicetree/bindings/power/supply/maxim,ds2760.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/power/supply/maxim,ds2760.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Maxim DS2760 DT bindings
+title: Maxim DS2760
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/power/supply/maxim,max14656.yaml b/Documentation/devicetree/bindings/power/supply/maxim,max14656.yaml
index 070ef6f96e60..711066b8cdb9 100644
--- a/Documentation/devicetree/bindings/power/supply/maxim,max14656.yaml
+++ b/Documentation/devicetree/bindings/power/supply/maxim,max14656.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/power/supply/maxim,max14656.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Maxim MAX14656 DT bindings
+title: Maxim MAX14656
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/rtc/epson,rx8900.yaml b/Documentation/devicetree/bindings/rtc/epson,rx8900.yaml
index d12855e7ffd7..1df7c45d95c1 100644
--- a/Documentation/devicetree/bindings/rtc/epson,rx8900.yaml
+++ b/Documentation/devicetree/bindings/rtc/epson,rx8900.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/rtc/epson,rx8900.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: EPSON RX8900 / Microcrystal RV8803 Real-Time Clock DT bindings
+title: EPSON RX8900 / Microcrystal RV8803 Real-Time Clock
 
 maintainers:
   - Marek Vasut <marex@denx.de>
diff --git a/Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml b/Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml
index b235b2441997..af78b67b3da4 100644
--- a/Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml
+++ b/Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/rtc/ingenic,rtc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs Real-Time Clock DT bindings
+title: Ingenic SoCs Real-Time Clock
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml b/Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml
index 2d4741f51663..f6e0c613af67 100644
--- a/Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml
+++ b/Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/rtc/renesas,rzn1-rtc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Renesas RZ/N1 SoCs Real-Time Clock DT bindings
+title: Renesas RZ/N1 SoCs Real-Time Clock
 
 maintainers:
   - Miquel Raynal <miquel.raynal@bootlin.com>
diff --git a/Documentation/devicetree/bindings/serial/brcm,bcm7271-uart.yaml b/Documentation/devicetree/bindings/serial/brcm,bcm7271-uart.yaml
index 6d176588df47..89c462653e2d 100644
--- a/Documentation/devicetree/bindings/serial/brcm,bcm7271-uart.yaml
+++ b/Documentation/devicetree/bindings/serial/brcm,bcm7271-uart.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom 8250 based serial port devicetree bindings
+title: Broadcom 8250 based serial port
 
 maintainers:
   - Al Cooper <alcooperx@gmail.com>
diff --git a/Documentation/devicetree/bindings/serial/ingenic,uart.yaml b/Documentation/devicetree/bindings/serial/ingenic,uart.yaml
index 315ceb722e19..d5f153bdeb0d 100644
--- a/Documentation/devicetree/bindings/serial/ingenic,uart.yaml
+++ b/Documentation/devicetree/bindings/serial/ingenic,uart.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/serial/ingenic,uart.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs UART controller devicetree bindings
+title: Ingenic SoCs UART controller
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/serial/serial.yaml b/Documentation/devicetree/bindings/serial/serial.yaml
index c75ba3fb6465..11e822bf09e2 100644
--- a/Documentation/devicetree/bindings/serial/serial.yaml
+++ b/Documentation/devicetree/bindings/serial/serial.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/serial/serial.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Serial Interface Generic DT Bindings
+title: Serial Interface Generic
 
 maintainers:
   - Rob Herring <robh@kernel.org>
diff --git a/Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml b/Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml
index d911fa2d40ef..f21eb907ee90 100644
--- a/Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml
+++ b/Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/soc/mediatek/mtk-svs.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: MediaTek Smart Voltage Scaling (SVS) Device Tree Bindings
+title: MediaTek Smart Voltage Scaling (SVS)
 
 maintainers:
   - Roger Lu <roger.lu@mediatek.com>
diff --git a/Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml b/Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml
index 963a871e74da..1a4e00a8c5ca 100644
--- a/Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml
+++ b/Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/cirrus,cs42l51.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: CS42L51 audio codec DT bindings
+title: CS42L51 audio codec
 
 maintainers:
   - Olivier Moysan <olivier.moysan@foss.st.com>
diff --git a/Documentation/devicetree/bindings/sound/ingenic,aic.yaml b/Documentation/devicetree/bindings/sound/ingenic,aic.yaml
index c4f9b3c2bde5..a96cc2098539 100644
--- a/Documentation/devicetree/bindings/sound/ingenic,aic.yaml
+++ b/Documentation/devicetree/bindings/sound/ingenic,aic.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/ingenic,aic.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs AC97 / I2S Controller (AIC) DT bindings
+title: Ingenic SoCs AC97 / I2S Controller (AIC)
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/sound/ingenic,codec.yaml b/Documentation/devicetree/bindings/sound/ingenic,codec.yaml
index 48aae54dd643..23a606931347 100644
--- a/Documentation/devicetree/bindings/sound/ingenic,codec.yaml
+++ b/Documentation/devicetree/bindings/sound/ingenic,codec.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/ingenic,codec.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic JZ47xx internal codec DT bindings
+title: Ingenic JZ47xx internal codec
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/sound/qcom,lpass-rx-macro.yaml b/Documentation/devicetree/bindings/sound/qcom,lpass-rx-macro.yaml
index 14016671f32b..42facaba3f83 100644
--- a/Documentation/devicetree/bindings/sound/qcom,lpass-rx-macro.yaml
+++ b/Documentation/devicetree/bindings/sound/qcom,lpass-rx-macro.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/qcom,lpass-rx-macro.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: LPASS(Low Power Audio Subsystem) RX Macro audio codec DT bindings
+title: LPASS(Low Power Audio Subsystem) RX Macro audio codec
 
 maintainers:
   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
diff --git a/Documentation/devicetree/bindings/sound/qcom,lpass-tx-macro.yaml b/Documentation/devicetree/bindings/sound/qcom,lpass-tx-macro.yaml
index e647ba392a0f..a2afa85c1b2f 100644
--- a/Documentation/devicetree/bindings/sound/qcom,lpass-tx-macro.yaml
+++ b/Documentation/devicetree/bindings/sound/qcom,lpass-tx-macro.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/qcom,lpass-tx-macro.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: LPASS(Low Power Audio Subsystem) TX Macro audio codec DT bindings
+title: LPASS(Low Power Audio Subsystem) TX Macro audio codec
 
 maintainers:
   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
diff --git a/Documentation/devicetree/bindings/sound/qcom,lpass-va-macro.yaml b/Documentation/devicetree/bindings/sound/qcom,lpass-va-macro.yaml
index c36caf90b837..625be7e5aaf7 100644
--- a/Documentation/devicetree/bindings/sound/qcom,lpass-va-macro.yaml
+++ b/Documentation/devicetree/bindings/sound/qcom,lpass-va-macro.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/qcom,lpass-va-macro.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: LPASS(Low Power Audio Subsystem) VA Macro audio codec DT bindings
+title: LPASS(Low Power Audio Subsystem) VA Macro audio codec
 
 maintainers:
   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
diff --git a/Documentation/devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml b/Documentation/devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml
index 155c7344412a..09f541887423 100644
--- a/Documentation/devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml
+++ b/Documentation/devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/qcom,lpass-wsa-macro.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: LPASS(Low Power Audio Subsystem) VA Macro audio codec DT bindings
+title: LPASS(Low Power Audio Subsystem) VA Macro audio codec
 
 maintainers:
   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
diff --git a/Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml b/Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml
index ea7d4900ee4a..7dac9e6f7f08 100644
--- a/Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml
+++ b/Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/realtek,rt1015p.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Realtek rt1015p codec devicetree bindings
+title: Realtek rt1015p codec
 
 maintainers:
   - Tzung-Bi Shih <tzungbi@kernel.org>
diff --git a/Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml b/Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml
index dc418652f241..73a4a509fd86 100644
--- a/Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml
+++ b/Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/realtek,rt5682s.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Realtek rt5682s codec devicetree bindings
+title: Realtek rt5682s codec
 
 maintainers:
   - Derek Fang <derek.fang@realtek.com>
diff --git a/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml b/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml
index 9681b72b4918..d5e3cbe9b935 100644
--- a/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml
+++ b/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/ti,src4xxx.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Texas Instruments SRC4392 Device Tree Bindings
+title: Texas Instruments SRC4392
 
 description: |
   The SRC4392 is a digital audio codec that can be connected via
diff --git a/Documentation/devicetree/bindings/spi/ingenic,spi.yaml b/Documentation/devicetree/bindings/spi/ingenic,spi.yaml
index 360f76c226d9..c08d55b900bb 100644
--- a/Documentation/devicetree/bindings/spi/ingenic,spi.yaml
+++ b/Documentation/devicetree/bindings/spi/ingenic,spi.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/spi/ingenic,spi.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs SPI controller devicetree bindings
+title: Ingenic SoCs SPI controller
 
 maintainers:
   - Artur Rojek <contact@artur-rojek.eu>
diff --git a/Documentation/devicetree/bindings/spi/spi-gpio.yaml b/Documentation/devicetree/bindings/spi/spi-gpio.yaml
index 0d0b6d9dad1c..f29b89076c99 100644
--- a/Documentation/devicetree/bindings/spi/spi-gpio.yaml
+++ b/Documentation/devicetree/bindings/spi/spi-gpio.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/spi/spi-gpio.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: SPI-GPIO devicetree bindings
+title: SPI-GPIO
 
 maintainers:
   - Rob Herring <robh@kernel.org>
diff --git a/Documentation/devicetree/bindings/timer/ingenic,tcu.yaml b/Documentation/devicetree/bindings/timer/ingenic,tcu.yaml
index a84fef0fe628..2d14610888a7 100644
--- a/Documentation/devicetree/bindings/timer/ingenic,tcu.yaml
+++ b/Documentation/devicetree/bindings/timer/ingenic,tcu.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/timer/ingenic,tcu.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic SoCs Timer/Counter Unit (TCU) devicetree bindings
+title: Ingenic SoCs Timer/Counter Unit (TCU)
 
 description: |
   For a description of the TCU hardware and drivers, have a look at
diff --git a/Documentation/devicetree/bindings/usb/ingenic,musb.yaml b/Documentation/devicetree/bindings/usb/ingenic,musb.yaml
index 59212358fcce..4cc1496a913c 100644
--- a/Documentation/devicetree/bindings/usb/ingenic,musb.yaml
+++ b/Documentation/devicetree/bindings/usb/ingenic,musb.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/usb/ingenic,musb.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Ingenic JZ47xx USB IP DT bindings
+title: Ingenic JZ47xx USB IP
 
 maintainers:
   - Paul Cercueil <paul@crapouillou.net>
diff --git a/Documentation/devicetree/bindings/usb/maxim,max33359.yaml b/Documentation/devicetree/bindings/usb/maxim,max33359.yaml
index 93a19eda610b..8e513a6af378 100644
--- a/Documentation/devicetree/bindings/usb/maxim,max33359.yaml
+++ b/Documentation/devicetree/bindings/usb/maxim,max33359.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/usb/maxim,max33359.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Maxim TCPCI Type-C PD controller DT bindings
+title: Maxim TCPCI Type-C PD controller
 
 maintainers:
   - Badhri Jagan Sridharan <badhri@google.com>
diff --git a/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml b/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
index 8db1f8b597c3..c72257c19220 100644
--- a/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
+++ b/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/usb/mediatek,mt6360-tcpc.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Mediatek MT6360 Type-C Port Switch and Power Delivery controller DT bindings
+title: Mediatek MT6360 Type-C Port Switch and Power Delivery controller
 
 maintainers:
   - ChiYuan Huang <cy_huang@richtek.com>
diff --git a/Documentation/devicetree/bindings/usb/ti,tps6598x.yaml b/Documentation/devicetree/bindings/usb/ti,tps6598x.yaml
index a4c53b1f1af3..fef4acdc4773 100644
--- a/Documentation/devicetree/bindings/usb/ti,tps6598x.yaml
+++ b/Documentation/devicetree/bindings/usb/ti,tps6598x.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/usb/ti,tps6598x.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Texas Instruments 6598x Type-C Port Switch and Power Delivery controller DT bindings
+title: Texas Instruments 6598x Type-C Port Switch and Power Delivery controller
 
 maintainers:
   - Bryan O'Donoghue <bryan.odonoghue@linaro.org>
diff --git a/Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml b/Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml
index 5aa4ffd67119..937670de01cc 100644
--- a/Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml
+++ b/Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/usb/willsemi,wusb3801.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: WUSB3801 Type-C port controller DT bindings
+title: WUSB3801 Type-C port controller
 
 description:
   The Will Semiconductor WUSB3801 is a USB Type-C port controller which
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 26+ messages in thread

* [RFC PATCH 5/9] dt-bindings: drop redundant part of title (end, part two)
  2022-11-17 12:38 [RFC PATCH 0/9] dt-bindings: cleanup titles Krzysztof Kozlowski
                   ` (3 preceding siblings ...)
  2022-11-17 12:38 ` [RFC PATCH 4/9] dt-bindings: drop redundant part of title (end) Krzysztof Kozlowski
@ 2022-11-17 12:38 ` Krzysztof Kozlowski
  2022-11-17 15:58   ` Jonathan Cameron
  2022-11-17 12:38 ` [RFC PATCH 7/9] dt-bindings: drop redundant part of title (beginning) Krzysztof Kozlowski
                   ` (3 subsequent siblings)
  8 siblings, 1 reply; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 12:38 UTC (permalink / raw)
  To: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog
  Cc: Krzysztof Kozlowski

The Devicetree bindings document does not have to say in the title that
it is a "binding", but instead just describe the hardware.

Drop trailing "Node|Tree|Generic bindings" in various forms (also with
trailling full stop):

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -not -name 'trivial-devices.yaml' \
    -exec sed -i -e 's/^title: \(.*\) [nN]ode [bB]indings\?\.\?$/title: \1/' {} \;

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -not -name 'trivial-devices.yaml' \
    -exec sed -i -e 's/^title: \(.*\) [tT]ree [bB]indings\?\.\?$/title: \1/' {} \;

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -not -name 'trivial-devices.yaml' \
    -exec sed -i -e 's/^title: \(.*\) [gG]eneric [bB]indings\?\.\?$/title: \1/' {} \;

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -not -name 'trivial-devices.yaml' \
    -exec sed -i -e 's/^title: \(.*\) [bB]indings\? description\.\?$/title: \1/' {} \;

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -not -name 'trivial-devices.yaml' \
    -exec sed -i -e 's/^title: \(.*\) [bB]indings\? document\.\?$/title: \1/' {} \;

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
 Documentation/devicetree/bindings/clock/ti,sci-clk.yaml         | 2 +-
 Documentation/devicetree/bindings/cpu/idle-states.yaml          | 2 +-
 .../devicetree/bindings/net/dsa/microchip,lan937x.yaml          | 2 +-
 .../devicetree/bindings/net/wireless/mediatek,mt76.yaml         | 2 +-
 Documentation/devicetree/bindings/net/wireless/qca,ath9k.yaml   | 2 +-
 Documentation/devicetree/bindings/net/wireless/qcom,ath11k.yaml | 2 +-
 Documentation/devicetree/bindings/phy/brcm,ns2-pcie-phy.yaml    | 2 +-
 Documentation/devicetree/bindings/phy/qcom,usb-hs-phy.yaml      | 2 +-
 Documentation/devicetree/bindings/phy/ti,phy-gmii-sel.yaml      | 2 +-
 Documentation/devicetree/bindings/power/domain-idle-state.yaml  | 2 +-
 .../devicetree/bindings/reserved-memory/shared-dma-pool.yaml    | 2 +-
 Documentation/devicetree/bindings/reset/ti,sci-reset.yaml       | 2 +-
 Documentation/devicetree/bindings/reset/ti,tps380x-reset.yaml   | 2 +-
 Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml     | 2 +-
 Documentation/devicetree/bindings/sound/audio-graph-port.yaml   | 2 +-
 15 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/Documentation/devicetree/bindings/clock/ti,sci-clk.yaml b/Documentation/devicetree/bindings/clock/ti,sci-clk.yaml
index 0e370289a053..63d976341696 100644
--- a/Documentation/devicetree/bindings/clock/ti,sci-clk.yaml
+++ b/Documentation/devicetree/bindings/clock/ti,sci-clk.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/ti,sci-clk.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: TI-SCI clock controller node bindings
+title: TI-SCI clock controller
 
 maintainers:
   - Nishanth Menon <nm@ti.com>
diff --git a/Documentation/devicetree/bindings/cpu/idle-states.yaml b/Documentation/devicetree/bindings/cpu/idle-states.yaml
index fa4d4142ac93..b8cc826c9501 100644
--- a/Documentation/devicetree/bindings/cpu/idle-states.yaml
+++ b/Documentation/devicetree/bindings/cpu/idle-states.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/cpu/idle-states.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Idle states binding description
+title: Idle states
 
 maintainers:
   - Lorenzo Pieralisi <lorenzo.pieralisi@arm.com>
diff --git a/Documentation/devicetree/bindings/net/dsa/microchip,lan937x.yaml b/Documentation/devicetree/bindings/net/dsa/microchip,lan937x.yaml
index 630bf0f8294b..b34de303966b 100644
--- a/Documentation/devicetree/bindings/net/dsa/microchip,lan937x.yaml
+++ b/Documentation/devicetree/bindings/net/dsa/microchip,lan937x.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/dsa/microchip,lan937x.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: LAN937x Ethernet Switch Series Tree Bindings
+title: LAN937x Ethernet Switch Series
 
 maintainers:
   - UNGLinuxDriver@microchip.com
diff --git a/Documentation/devicetree/bindings/net/wireless/mediatek,mt76.yaml b/Documentation/devicetree/bindings/net/wireless/mediatek,mt76.yaml
index 70e328589cfb..f0c78f994491 100644
--- a/Documentation/devicetree/bindings/net/wireless/mediatek,mt76.yaml
+++ b/Documentation/devicetree/bindings/net/wireless/mediatek,mt76.yaml
@@ -6,7 +6,7 @@
 $id: http://devicetree.org/schemas/net/wireless/mediatek,mt76.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: MediaTek mt76 wireless devices Generic Binding
+title: MediaTek mt76 wireless devices
 
 maintainers:
   - Felix Fietkau <nbd@nbd.name>
diff --git a/Documentation/devicetree/bindings/net/wireless/qca,ath9k.yaml b/Documentation/devicetree/bindings/net/wireless/qca,ath9k.yaml
index 7029cb1f38ff..0e5412cff2bc 100644
--- a/Documentation/devicetree/bindings/net/wireless/qca,ath9k.yaml
+++ b/Documentation/devicetree/bindings/net/wireless/qca,ath9k.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/wireless/qca,ath9k.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Qualcomm Atheros ath9k wireless devices Generic Binding
+title: Qualcomm Atheros ath9k wireless devices
 
 maintainers:
   - Toke Høiland-Jørgensen <toke@toke.dk>
diff --git a/Documentation/devicetree/bindings/net/wireless/qcom,ath11k.yaml b/Documentation/devicetree/bindings/net/wireless/qcom,ath11k.yaml
index f7cf135aa37f..556eb523606a 100644
--- a/Documentation/devicetree/bindings/net/wireless/qcom,ath11k.yaml
+++ b/Documentation/devicetree/bindings/net/wireless/qcom,ath11k.yaml
@@ -6,7 +6,7 @@
 $id: http://devicetree.org/schemas/net/wireless/qcom,ath11k.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Qualcomm Technologies ath11k wireless devices Generic Binding
+title: Qualcomm Technologies ath11k wireless devices
 
 maintainers:
   - Kalle Valo <kvalo@kernel.org>
diff --git a/Documentation/devicetree/bindings/phy/brcm,ns2-pcie-phy.yaml b/Documentation/devicetree/bindings/phy/brcm,ns2-pcie-phy.yaml
index 70eb48b391c9..527010702f5e 100644
--- a/Documentation/devicetree/bindings/phy/brcm,ns2-pcie-phy.yaml
+++ b/Documentation/devicetree/bindings/phy/brcm,ns2-pcie-phy.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/phy/brcm,ns2-pcie-phy.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Broadcom NS2 PCIe PHY binding document
+title: Broadcom NS2 PCIe PHY
 
 maintainers:
   - Ray Jui <ray.jui@broadcom.com>
diff --git a/Documentation/devicetree/bindings/phy/qcom,usb-hs-phy.yaml b/Documentation/devicetree/bindings/phy/qcom,usb-hs-phy.yaml
index 0655e485b260..aa97478dd016 100644
--- a/Documentation/devicetree/bindings/phy/qcom,usb-hs-phy.yaml
+++ b/Documentation/devicetree/bindings/phy/qcom,usb-hs-phy.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/phy/qcom,usb-hs-phy.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Qualcomm's USB HS PHY binding description
+title: Qualcomm's USB HS PHY
 
 maintainers:
   - Bjorn Andersson <bjorn.andersson@linaro.org>
diff --git a/Documentation/devicetree/bindings/phy/ti,phy-gmii-sel.yaml b/Documentation/devicetree/bindings/phy/ti,phy-gmii-sel.yaml
index 3a6d686383cf..6d46f57fa1b4 100644
--- a/Documentation/devicetree/bindings/phy/ti,phy-gmii-sel.yaml
+++ b/Documentation/devicetree/bindings/phy/ti,phy-gmii-sel.yaml
@@ -5,7 +5,7 @@
 $id: "http://devicetree.org/schemas/phy/ti,phy-gmii-sel.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: CPSW Port's Interface Mode Selection PHY Tree Bindings
+title: CPSW Port's Interface Mode Selection PHY
 
 maintainers:
   - Kishon Vijay Abraham I <kishon@ti.com>
diff --git a/Documentation/devicetree/bindings/power/domain-idle-state.yaml b/Documentation/devicetree/bindings/power/domain-idle-state.yaml
index 4ee920a1de69..ec1f6f669e50 100644
--- a/Documentation/devicetree/bindings/power/domain-idle-state.yaml
+++ b/Documentation/devicetree/bindings/power/domain-idle-state.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/power/domain-idle-state.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: PM Domain Idle States binding description
+title: PM Domain Idle States
 
 maintainers:
   - Ulf Hansson <ulf.hansson@linaro.org>
diff --git a/Documentation/devicetree/bindings/reserved-memory/shared-dma-pool.yaml b/Documentation/devicetree/bindings/reserved-memory/shared-dma-pool.yaml
index 618105f079be..47696073b665 100644
--- a/Documentation/devicetree/bindings/reserved-memory/shared-dma-pool.yaml
+++ b/Documentation/devicetree/bindings/reserved-memory/shared-dma-pool.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/reserved-memory/shared-dma-pool.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: /reserved-memory DMA pool node bindings
+title: /reserved-memory DMA pool
 
 maintainers:
   - devicetree-spec@vger.kernel.org
diff --git a/Documentation/devicetree/bindings/reset/ti,sci-reset.yaml b/Documentation/devicetree/bindings/reset/ti,sci-reset.yaml
index 4639d2cec557..dcf9206e12be 100644
--- a/Documentation/devicetree/bindings/reset/ti,sci-reset.yaml
+++ b/Documentation/devicetree/bindings/reset/ti,sci-reset.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/reset/ti,sci-reset.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: TI-SCI reset controller node bindings
+title: TI-SCI reset controller
 
 maintainers:
   - Nishanth Menon <nm@ti.com>
diff --git a/Documentation/devicetree/bindings/reset/ti,tps380x-reset.yaml b/Documentation/devicetree/bindings/reset/ti,tps380x-reset.yaml
index afc835eda0ef..f436f2cf1df7 100644
--- a/Documentation/devicetree/bindings/reset/ti,tps380x-reset.yaml
+++ b/Documentation/devicetree/bindings/reset/ti,tps380x-reset.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/reset/ti,tps380x-reset.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: TI TPS380x reset controller node bindings
+title: TI TPS380x reset controller
 
 maintainers:
   - Marco Felsch <kernel@pengutronix.de>
diff --git a/Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml b/Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml
index 9e6cb4ee9755..5df7688a1e1c 100644
--- a/Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml
+++ b/Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/soc/ti/sci-pm-domain.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: TI-SCI generic power domain node bindings
+title: TI-SCI generic power domain
 
 maintainers:
   - Nishanth Menon <nm@ti.com>
diff --git a/Documentation/devicetree/bindings/sound/audio-graph-port.yaml b/Documentation/devicetree/bindings/sound/audio-graph-port.yaml
index 64654ceef208..f5b8b6d13077 100644
--- a/Documentation/devicetree/bindings/sound/audio-graph-port.yaml
+++ b/Documentation/devicetree/bindings/sound/audio-graph-port.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/audio-graph-port.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Audio Graph Card 'port' Node Bindings
+title: Audio Graph Card 'port'
 
 maintainers:
   - Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 26+ messages in thread

* [RFC PATCH 7/9] dt-bindings: drop redundant part of title (beginning)
  2022-11-17 12:38 [RFC PATCH 0/9] dt-bindings: cleanup titles Krzysztof Kozlowski
                   ` (4 preceding siblings ...)
  2022-11-17 12:38 ` [RFC PATCH 5/9] dt-bindings: drop redundant part of title (end, part two) Krzysztof Kozlowski
@ 2022-11-17 12:38 ` Krzysztof Kozlowski
  2022-11-17 16:01   ` Jonathan Cameron
  2022-11-17 12:38 ` [RFC PATCH 8/9] dt-bindings: clock: drop redundant part of title Krzysztof Kozlowski
                   ` (2 subsequent siblings)
  8 siblings, 1 reply; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 12:38 UTC (permalink / raw)
  To: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog
  Cc: Krzysztof Kozlowski

The Devicetree bindings document does not have to say in the title that
it is a "Devicetree binding", but instead just describe the hardware.

Drop beginning "Devicetree bindings" in various forms:

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -exec sed -i -e 's/^title: [dD]evice[ -]\?[tT]ree [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2/' {} \;

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -exec sed -i -e 's/^title: [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2/' {} \;

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -exec sed -i -e 's/^title: [dD][tT] [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2/' {} \;

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
 Documentation/devicetree/bindings/clock/adi,axi-clkgen.yaml     | 2 +-
 Documentation/devicetree/bindings/clock/fixed-clock.yaml        | 2 +-
 Documentation/devicetree/bindings/clock/fixed-factor-clock.yaml | 2 +-
 Documentation/devicetree/bindings/clock/fixed-mmio-clock.yaml   | 2 +-
 Documentation/devicetree/bindings/clock/idt,versaclock5.yaml    | 2 +-
 Documentation/devicetree/bindings/clock/renesas,9series.yaml    | 2 +-
 Documentation/devicetree/bindings/clock/ti/ti,clksel.yaml       | 2 +-
 .../devicetree/bindings/display/bridge/ingenic,jz4780-hdmi.yaml | 2 +-
 .../devicetree/bindings/display/bridge/intel,keembay-dsi.yaml   | 2 +-
 .../devicetree/bindings/display/intel,keembay-display.yaml      | 2 +-
 .../devicetree/bindings/display/intel,keembay-msscam.yaml       | 2 +-
 Documentation/devicetree/bindings/display/msm/gmu.yaml          | 2 +-
 Documentation/devicetree/bindings/display/msm/gpu.yaml          | 2 +-
 .../devicetree/bindings/display/panel/olimex,lcd-olinuxino.yaml | 2 +-
 .../devicetree/bindings/gpu/host1x/nvidia,tegra210-nvdec.yaml   | 2 +-
 .../devicetree/bindings/gpu/host1x/nvidia,tegra210-nvenc.yaml   | 2 +-
 .../devicetree/bindings/gpu/host1x/nvidia,tegra210-nvjpg.yaml   | 2 +-
 .../devicetree/bindings/gpu/host1x/nvidia,tegra234-nvdec.yaml   | 2 +-
 Documentation/devicetree/bindings/i2c/i2c-gpio.yaml             | 2 +-
 Documentation/devicetree/bindings/i2c/ti,omap4-i2c.yaml         | 2 +-
 .../devicetree/bindings/iio/adc/sigma-delta-modulator.yaml      | 2 +-
 Documentation/devicetree/bindings/input/gpio-keys.yaml          | 2 +-
 Documentation/devicetree/bindings/input/microchip,cap11xx.yaml  | 2 +-
 .../devicetree/bindings/interrupt-controller/renesas,irqc.yaml  | 2 +-
 Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml | 2 +-
 Documentation/devicetree/bindings/leds/register-bit-led.yaml    | 2 +-
 Documentation/devicetree/bindings/leds/regulator-led.yaml       | 2 +-
 Documentation/devicetree/bindings/mips/ingenic/ingenic,cpu.yaml | 2 +-
 Documentation/devicetree/bindings/mmc/arasan,sdhci.yaml         | 2 +-
 Documentation/devicetree/bindings/net/ingenic,mac.yaml          | 2 +-
 Documentation/devicetree/bindings/power/supply/bq2415x.yaml     | 2 +-
 Documentation/devicetree/bindings/power/supply/bq24190.yaml     | 2 +-
 Documentation/devicetree/bindings/power/supply/bq24257.yaml     | 2 +-
 Documentation/devicetree/bindings/power/supply/bq24735.yaml     | 2 +-
 Documentation/devicetree/bindings/power/supply/bq25890.yaml     | 2 +-
 Documentation/devicetree/bindings/power/supply/isp1704.yaml     | 2 +-
 .../devicetree/bindings/power/supply/lltc,ltc294x.yaml          | 2 +-
 .../devicetree/bindings/power/supply/richtek,rt9455.yaml        | 2 +-
 Documentation/devicetree/bindings/power/supply/ti,lp8727.yaml   | 2 +-
 Documentation/devicetree/bindings/regulator/pwm-regulator.yaml  | 2 +-
 Documentation/devicetree/bindings/rng/ingenic,rng.yaml          | 2 +-
 Documentation/devicetree/bindings/rng/ingenic,trng.yaml         | 2 +-
 Documentation/devicetree/bindings/serial/8250_omap.yaml         | 2 +-
 Documentation/devicetree/bindings/serio/ps2-gpio.yaml           | 2 +-
 Documentation/devicetree/bindings/sound/qcom,wcd934x.yaml       | 2 +-
 Documentation/devicetree/bindings/sound/qcom,wcd938x-sdw.yaml   | 2 +-
 Documentation/devicetree/bindings/sound/qcom,wcd938x.yaml       | 2 +-
 Documentation/devicetree/bindings/sound/qcom,wsa881x.yaml       | 2 +-
 Documentation/devicetree/bindings/sound/qcom,wsa883x.yaml       | 2 +-
 Documentation/devicetree/bindings/timer/ingenic,sysost.yaml     | 2 +-
 Documentation/devicetree/bindings/usb/nvidia,tegra-xudc.yaml    | 2 +-
 Documentation/devicetree/bindings/usb/realtek,rts5411.yaml      | 2 +-
 Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml         | 2 +-
 Documentation/devicetree/bindings/usb/ti,usb8041.yaml           | 2 +-
 54 files changed, 54 insertions(+), 54 deletions(-)

diff --git a/Documentation/devicetree/bindings/clock/adi,axi-clkgen.yaml b/Documentation/devicetree/bindings/clock/adi,axi-clkgen.yaml
index 983033fe5b17..5e942bccf277 100644
--- a/Documentation/devicetree/bindings/clock/adi,axi-clkgen.yaml
+++ b/Documentation/devicetree/bindings/clock/adi,axi-clkgen.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/adi,axi-clkgen.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for Analog Devices AXI clkgen pcore clock generator
+title: Analog Devices AXI clkgen pcore clock generator
 
 maintainers:
   - Lars-Peter Clausen <lars@metafoo.de>
diff --git a/Documentation/devicetree/bindings/clock/fixed-clock.yaml b/Documentation/devicetree/bindings/clock/fixed-clock.yaml
index b657ecd0ef1c..b0a4fb8256e2 100644
--- a/Documentation/devicetree/bindings/clock/fixed-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/fixed-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/fixed-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for simple fixed-rate clock sources
+title: Simple fixed-rate clock sources
 
 maintainers:
   - Michael Turquette <mturquette@baylibre.com>
diff --git a/Documentation/devicetree/bindings/clock/fixed-factor-clock.yaml b/Documentation/devicetree/bindings/clock/fixed-factor-clock.yaml
index 0b02378a3a0c..8f71ab300470 100644
--- a/Documentation/devicetree/bindings/clock/fixed-factor-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/fixed-factor-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/fixed-factor-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for simple fixed factor rate clock sources
+title: Simple fixed factor rate clock sources
 
 maintainers:
   - Michael Turquette <mturquette@baylibre.com>
diff --git a/Documentation/devicetree/bindings/clock/fixed-mmio-clock.yaml b/Documentation/devicetree/bindings/clock/fixed-mmio-clock.yaml
index 1453ac849a65..e22fc272d023 100644
--- a/Documentation/devicetree/bindings/clock/fixed-mmio-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/fixed-mmio-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/fixed-mmio-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for simple memory mapped IO fixed-rate clock sources
+title: Simple memory mapped IO fixed-rate clock sources
 
 description:
   This binding describes a fixed-rate clock for which the frequency can
diff --git a/Documentation/devicetree/bindings/clock/idt,versaclock5.yaml b/Documentation/devicetree/bindings/clock/idt,versaclock5.yaml
index f9ba9864d8b5..61b246cf5e72 100644
--- a/Documentation/devicetree/bindings/clock/idt,versaclock5.yaml
+++ b/Documentation/devicetree/bindings/clock/idt,versaclock5.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/idt,versaclock5.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for IDT VersaClock 5 and 6 programmable I2C clock generators
+title: IDT VersaClock 5 and 6 programmable I2C clock generators
 
 description: |
   The IDT VersaClock 5 and VersaClock 6 are programmable I2C
diff --git a/Documentation/devicetree/bindings/clock/renesas,9series.yaml b/Documentation/devicetree/bindings/clock/renesas,9series.yaml
index 102eb95cb3fc..6b6cec3fba52 100644
--- a/Documentation/devicetree/bindings/clock/renesas,9series.yaml
+++ b/Documentation/devicetree/bindings/clock/renesas,9series.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/renesas,9series.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for Renesas 9-series I2C PCIe clock generators
+title: Renesas 9-series I2C PCIe clock generators
 
 description: |
   The Renesas 9-series are I2C PCIe clock generators providing
diff --git a/Documentation/devicetree/bindings/clock/ti/ti,clksel.yaml b/Documentation/devicetree/bindings/clock/ti/ti,clksel.yaml
index c56f911fff47..d525f96cf244 100644
--- a/Documentation/devicetree/bindings/clock/ti/ti,clksel.yaml
+++ b/Documentation/devicetree/bindings/clock/ti/ti,clksel.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/ti/ti,clksel.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for TI clksel clock
+title: TI clksel clock
 
 maintainers:
   - Tony Lindgren <tony@atomide.com>
diff --git a/Documentation/devicetree/bindings/display/bridge/ingenic,jz4780-hdmi.yaml b/Documentation/devicetree/bindings/display/bridge/ingenic,jz4780-hdmi.yaml
index 89490fdffeb0..0b27df429bdc 100644
--- a/Documentation/devicetree/bindings/display/bridge/ingenic,jz4780-hdmi.yaml
+++ b/Documentation/devicetree/bindings/display/bridge/ingenic,jz4780-hdmi.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/bridge/ingenic,jz4780-hdmi.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for Ingenic JZ4780 HDMI Transmitter
+title: Ingenic JZ4780 HDMI Transmitter
 
 maintainers:
   - H. Nikolaus Schaller <hns@goldelico.com>
diff --git a/Documentation/devicetree/bindings/display/bridge/intel,keembay-dsi.yaml b/Documentation/devicetree/bindings/display/bridge/intel,keembay-dsi.yaml
index dcb1336ee2a5..958a073f4ff7 100644
--- a/Documentation/devicetree/bindings/display/bridge/intel,keembay-dsi.yaml
+++ b/Documentation/devicetree/bindings/display/bridge/intel,keembay-dsi.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/bridge/intel,keembay-dsi.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Devicetree bindings for Intel Keem Bay mipi dsi controller
+title: Intel Keem Bay mipi dsi controller
 
 maintainers:
   - Anitha Chrisanthus <anitha.chrisanthus@intel.com>
diff --git a/Documentation/devicetree/bindings/display/intel,keembay-display.yaml b/Documentation/devicetree/bindings/display/intel,keembay-display.yaml
index bc6622b010ca..2cf54ecc707a 100644
--- a/Documentation/devicetree/bindings/display/intel,keembay-display.yaml
+++ b/Documentation/devicetree/bindings/display/intel,keembay-display.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/intel,keembay-display.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Devicetree bindings for Intel Keem Bay display controller
+title: Intel Keem Bay display controller
 
 maintainers:
   - Anitha Chrisanthus <anitha.chrisanthus@intel.com>
diff --git a/Documentation/devicetree/bindings/display/intel,keembay-msscam.yaml b/Documentation/devicetree/bindings/display/intel,keembay-msscam.yaml
index a222b52d8b8f..cc7e1f318fe4 100644
--- a/Documentation/devicetree/bindings/display/intel,keembay-msscam.yaml
+++ b/Documentation/devicetree/bindings/display/intel,keembay-msscam.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/intel,keembay-msscam.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Devicetree bindings for Intel Keem Bay MSSCAM
+title: Intel Keem Bay MSSCAM
 
 maintainers:
   - Anitha Chrisanthus <anitha.chrisanthus@intel.com>
diff --git a/Documentation/devicetree/bindings/display/msm/gmu.yaml b/Documentation/devicetree/bindings/display/msm/gmu.yaml
index 67fdeeabae0c..ab14e81cb050 100644
--- a/Documentation/devicetree/bindings/display/msm/gmu.yaml
+++ b/Documentation/devicetree/bindings/display/msm/gmu.yaml
@@ -6,7 +6,7 @@
 $id: "http://devicetree.org/schemas/display/msm/gmu.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Devicetree bindings for the GMU attached to certain Adreno GPUs
+title: GMU attached to certain Adreno GPUs
 
 maintainers:
   - Rob Clark <robdclark@gmail.com>
diff --git a/Documentation/devicetree/bindings/display/msm/gpu.yaml b/Documentation/devicetree/bindings/display/msm/gpu.yaml
index ec4b1a75f46a..c5f49842dc7b 100644
--- a/Documentation/devicetree/bindings/display/msm/gpu.yaml
+++ b/Documentation/devicetree/bindings/display/msm/gpu.yaml
@@ -5,7 +5,7 @@
 $id: "http://devicetree.org/schemas/display/msm/gpu.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Devicetree bindings for the Adreno or Snapdragon GPUs
+title: Adreno or Snapdragon GPUs
 
 maintainers:
   - Rob Clark <robdclark@gmail.com>
diff --git a/Documentation/devicetree/bindings/display/panel/olimex,lcd-olinuxino.yaml b/Documentation/devicetree/bindings/display/panel/olimex,lcd-olinuxino.yaml
index 2329d9610f83..9f97598efdfa 100644
--- a/Documentation/devicetree/bindings/display/panel/olimex,lcd-olinuxino.yaml
+++ b/Documentation/devicetree/bindings/display/panel/olimex,lcd-olinuxino.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/display/panel/olimex,lcd-olinuxino.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for Olimex Ltd. LCD-OLinuXino bridge panel.
+title: Olimex Ltd. LCD-OLinuXino bridge panel.
 
 maintainers:
   - Stefan Mavrodiev <stefan@olimex.com>
diff --git a/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvdec.yaml b/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvdec.yaml
index 3cf862976448..ed9554c837ef 100644
--- a/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvdec.yaml
+++ b/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvdec.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/gpu/host1x/nvidia,tegra210-nvdec.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Device tree binding for NVIDIA Tegra NVDEC
+title: NVIDIA Tegra NVDEC
 
 description: |
   NVDEC is the hardware video decoder present on NVIDIA Tegra210
diff --git a/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvenc.yaml b/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvenc.yaml
index e63ae1a00818..8199e5fa8211 100644
--- a/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvenc.yaml
+++ b/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvenc.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/gpu/host1x/nvidia,tegra210-nvenc.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Device tree binding for NVIDIA Tegra NVENC
+title: NVIDIA Tegra NVENC
 
 description: |
   NVENC is the hardware video encoder present on NVIDIA Tegra210
diff --git a/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvjpg.yaml b/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvjpg.yaml
index 8647404d67e4..895fb346ac72 100644
--- a/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvjpg.yaml
+++ b/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra210-nvjpg.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/gpu/host1x/nvidia,tegra210-nvjpg.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Device tree binding for NVIDIA Tegra NVJPG
+title: NVIDIA Tegra NVJPG
 
 description: |
   NVJPG is the hardware JPEG decoder and encoder present on NVIDIA Tegra210
diff --git a/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra234-nvdec.yaml b/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra234-nvdec.yaml
index 7cc2dd525a96..4bdc19a2bccf 100644
--- a/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra234-nvdec.yaml
+++ b/Documentation/devicetree/bindings/gpu/host1x/nvidia,tegra234-nvdec.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/gpu/host1x/nvidia,tegra234-nvdec.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Device tree binding for NVIDIA Tegra234 NVDEC
+title: NVIDIA Tegra234 NVDEC
 
 description: |
   NVDEC is the hardware video decoder present on NVIDIA Tegra210
diff --git a/Documentation/devicetree/bindings/i2c/i2c-gpio.yaml b/Documentation/devicetree/bindings/i2c/i2c-gpio.yaml
index fd040284561f..e0d76d5eb103 100644
--- a/Documentation/devicetree/bindings/i2c/i2c-gpio.yaml
+++ b/Documentation/devicetree/bindings/i2c/i2c-gpio.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/i2c/i2c-gpio.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for GPIO bitbanged I2C
+title: GPIO bitbanged I2C
 
 maintainers:
   - Wolfram Sang <wsa@kernel.org>
diff --git a/Documentation/devicetree/bindings/i2c/ti,omap4-i2c.yaml b/Documentation/devicetree/bindings/i2c/ti,omap4-i2c.yaml
index db0843be91c5..781108ae1ce3 100644
--- a/Documentation/devicetree/bindings/i2c/ti,omap4-i2c.yaml
+++ b/Documentation/devicetree/bindings/i2c/ti,omap4-i2c.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/i2c/ti,omap4-i2c.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for I2C controllers on TI's OMAP and K3 SoCs
+title: I2C controllers on TI's OMAP and K3 SoCs
 
 maintainers:
   - Vignesh Raghavendra <vigneshr@ti.com>
diff --git a/Documentation/devicetree/bindings/iio/adc/sigma-delta-modulator.yaml b/Documentation/devicetree/bindings/iio/adc/sigma-delta-modulator.yaml
index 2287697f1f61..cab0d425eaa4 100644
--- a/Documentation/devicetree/bindings/iio/adc/sigma-delta-modulator.yaml
+++ b/Documentation/devicetree/bindings/iio/adc/sigma-delta-modulator.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/iio/adc/sigma-delta-modulator.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Device-Tree bindings for sigma delta modulator
+title: Sigma delta modulator
 
 maintainers:
   - Arnaud Pouliquen <arnaud.pouliquen@foss.st.com>
diff --git a/Documentation/devicetree/bindings/input/gpio-keys.yaml b/Documentation/devicetree/bindings/input/gpio-keys.yaml
index 17ac9dff7972..159cd9d9fe57 100644
--- a/Documentation/devicetree/bindings/input/gpio-keys.yaml
+++ b/Documentation/devicetree/bindings/input/gpio-keys.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/input/gpio-keys.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Device-Tree bindings for GPIO attached keys
+title: GPIO attached keys
 
 maintainers:
   - Rob Herring <robh@kernel.org>
diff --git a/Documentation/devicetree/bindings/input/microchip,cap11xx.yaml b/Documentation/devicetree/bindings/input/microchip,cap11xx.yaml
index 96358b12f9b2..67d4d8f86a2d 100644
--- a/Documentation/devicetree/bindings/input/microchip,cap11xx.yaml
+++ b/Documentation/devicetree/bindings/input/microchip,cap11xx.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/input/microchip,cap11xx.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Device tree bindings for Microchip CAP11xx based capacitive touch sensors
+title: Microchip CAP11xx based capacitive touch sensors
 
 description: |
   The Microchip CAP1xxx Family of RightTouchTM multiple-channel capacitive
diff --git a/Documentation/devicetree/bindings/interrupt-controller/renesas,irqc.yaml b/Documentation/devicetree/bindings/interrupt-controller/renesas,irqc.yaml
index 62fd47c88275..95033cb514fb 100644
--- a/Documentation/devicetree/bindings/interrupt-controller/renesas,irqc.yaml
+++ b/Documentation/devicetree/bindings/interrupt-controller/renesas,irqc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/interrupt-controller/renesas,irqc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: DT bindings for the R-Mobile/R-Car/RZ/G interrupt controller
+title: R-Mobile/R-Car/RZ/G interrupt controller
 
 maintainers:
   - Geert Uytterhoeven <geert+renesas@glider.be>
diff --git a/Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml b/Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml
index 5ac8605a53b1..5f1849bdabba 100644
--- a/Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml
+++ b/Documentation/devicetree/bindings/leds/backlight/qcom-wled.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/leds/backlight/qcom-wled.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for Qualcomm Technologies, Inc. WLED driver
+title: Qualcomm Technologies, Inc. WLED driver
 
 maintainers:
   - Bjorn Andersson <bjorn.andersson@linaro.org>
diff --git a/Documentation/devicetree/bindings/leds/register-bit-led.yaml b/Documentation/devicetree/bindings/leds/register-bit-led.yaml
index 79b8fc0f9d23..ed26ec19ecbd 100644
--- a/Documentation/devicetree/bindings/leds/register-bit-led.yaml
+++ b/Documentation/devicetree/bindings/leds/register-bit-led.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/leds/register-bit-led.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Device Tree Bindings for Register Bit LEDs
+title: Register Bit LEDs
 
 maintainers:
   - Linus Walleij <linus.walleij@linaro.org>
diff --git a/Documentation/devicetree/bindings/leds/regulator-led.yaml b/Documentation/devicetree/bindings/leds/regulator-led.yaml
index 3e020d700c00..4ef7b96e9a08 100644
--- a/Documentation/devicetree/bindings/leds/regulator-led.yaml
+++ b/Documentation/devicetree/bindings/leds/regulator-led.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/leds/regulator-led.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Device Tree Bindings for Regulator LEDs
+title: Regulator LEDs
 
 maintainers:
   - Linus Walleij <linus.walleij@linaro.org>
diff --git a/Documentation/devicetree/bindings/mips/ingenic/ingenic,cpu.yaml b/Documentation/devicetree/bindings/mips/ingenic/ingenic,cpu.yaml
index b7e7fa715437..9265a27037cb 100644
--- a/Documentation/devicetree/bindings/mips/ingenic/ingenic,cpu.yaml
+++ b/Documentation/devicetree/bindings/mips/ingenic/ingenic,cpu.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/mips/ingenic/ingenic,cpu.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for Ingenic XBurst family CPUs
+title: Ingenic XBurst family CPUs
 
 maintainers:
   - 周琰杰 (Zhou Yanjie) <zhouyanjie@wanyeetech.com>
diff --git a/Documentation/devicetree/bindings/mmc/arasan,sdhci.yaml b/Documentation/devicetree/bindings/mmc/arasan,sdhci.yaml
index 83be9e93d221..4053de758db6 100644
--- a/Documentation/devicetree/bindings/mmc/arasan,sdhci.yaml
+++ b/Documentation/devicetree/bindings/mmc/arasan,sdhci.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/mmc/arasan,sdhci.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Device Tree Bindings for the Arasan SDHCI Controller
+title: Arasan SDHCI Controller
 
 maintainers:
   - Adrian Hunter <adrian.hunter@intel.com>
diff --git a/Documentation/devicetree/bindings/net/ingenic,mac.yaml b/Documentation/devicetree/bindings/net/ingenic,mac.yaml
index 93b3e991d209..bdea101c2f75 100644
--- a/Documentation/devicetree/bindings/net/ingenic,mac.yaml
+++ b/Documentation/devicetree/bindings/net/ingenic,mac.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/ingenic,mac.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for MAC in Ingenic SoCs
+title: MAC in Ingenic SoCs
 
 maintainers:
   - 周琰杰 (Zhou Yanjie) <zhouyanjie@wanyeetech.com>
diff --git a/Documentation/devicetree/bindings/power/supply/bq2415x.yaml b/Documentation/devicetree/bindings/power/supply/bq2415x.yaml
index a3c00e078918..f7287ffd4b12 100644
--- a/Documentation/devicetree/bindings/power/supply/bq2415x.yaml
+++ b/Documentation/devicetree/bindings/power/supply/bq2415x.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/power/supply/bq2415x.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for TI bq2415x Li-Ion Charger
+title: TI bq2415x Li-Ion Charger
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/power/supply/bq24190.yaml b/Documentation/devicetree/bindings/power/supply/bq24190.yaml
index 4884ec90e2b8..001c0ffb408d 100644
--- a/Documentation/devicetree/bindings/power/supply/bq24190.yaml
+++ b/Documentation/devicetree/bindings/power/supply/bq24190.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/power/supply/bq24190.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for TI BQ2419x Li-Ion Battery Charger
+title: TI BQ2419x Li-Ion Battery Charger
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/power/supply/bq24257.yaml b/Documentation/devicetree/bindings/power/supply/bq24257.yaml
index c7406bef0fa8..cc45939d385b 100644
--- a/Documentation/devicetree/bindings/power/supply/bq24257.yaml
+++ b/Documentation/devicetree/bindings/power/supply/bq24257.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/power/supply/bq24257.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for bq24250, bq24251 and bq24257 Li-Ion Charger
+title: Bq24250, bq24251 and bq24257 Li-Ion Charger
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/power/supply/bq24735.yaml b/Documentation/devicetree/bindings/power/supply/bq24735.yaml
index dd9176ce71b3..388ee16f8a1e 100644
--- a/Documentation/devicetree/bindings/power/supply/bq24735.yaml
+++ b/Documentation/devicetree/bindings/power/supply/bq24735.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/power/supply/bq24735.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for TI BQ24735 Li-Ion Battery Charger
+title: TI BQ24735 Li-Ion Battery Charger
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/power/supply/bq25890.yaml b/Documentation/devicetree/bindings/power/supply/bq25890.yaml
index ee51b6335e72..dae27e93af09 100644
--- a/Documentation/devicetree/bindings/power/supply/bq25890.yaml
+++ b/Documentation/devicetree/bindings/power/supply/bq25890.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/power/supply/bq25890.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for bq25890, bq25892, bq25895 and bq25896 Li-Ion Charger
+title: Bq25890, bq25892, bq25895 and bq25896 Li-Ion Charger
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/power/supply/isp1704.yaml b/Documentation/devicetree/bindings/power/supply/isp1704.yaml
index 7e3449ed70d4..fb3a812aa5a9 100644
--- a/Documentation/devicetree/bindings/power/supply/isp1704.yaml
+++ b/Documentation/devicetree/bindings/power/supply/isp1704.yaml
@@ -5,7 +5,7 @@
 $id: http://devicetree.org/schemas/power/supply/isp1704.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for NXP ISP1704 USB Charger Detection
+title: NXP ISP1704 USB Charger Detection
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/power/supply/lltc,ltc294x.yaml b/Documentation/devicetree/bindings/power/supply/lltc,ltc294x.yaml
index 109b41a0d56c..774582cd3a2c 100644
--- a/Documentation/devicetree/bindings/power/supply/lltc,ltc294x.yaml
+++ b/Documentation/devicetree/bindings/power/supply/lltc,ltc294x.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/power/supply/lltc,ltc294x.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for LTC2941, LTC2942, LTC2943 and LTC2944 battery fuel gauges
+title: LTC2941, LTC2942, LTC2943 and LTC2944 battery fuel gauges
 
 description: |
   All chips measure battery capacity.
diff --git a/Documentation/devicetree/bindings/power/supply/richtek,rt9455.yaml b/Documentation/devicetree/bindings/power/supply/richtek,rt9455.yaml
index bce15101318e..27bebc1757ba 100644
--- a/Documentation/devicetree/bindings/power/supply/richtek,rt9455.yaml
+++ b/Documentation/devicetree/bindings/power/supply/richtek,rt9455.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/power/supply/richtek,rt9455.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for Richtek rt9455 battery charger
+title: Richtek rt9455 battery charger
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/power/supply/ti,lp8727.yaml b/Documentation/devicetree/bindings/power/supply/ti,lp8727.yaml
index 93654e732cda..ce6fbdba8f6b 100644
--- a/Documentation/devicetree/bindings/power/supply/ti,lp8727.yaml
+++ b/Documentation/devicetree/bindings/power/supply/ti,lp8727.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/power/supply/ti,lp8727.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for TI/National Semiconductor LP8727 Charger
+title: TI/National Semiconductor LP8727 Charger
 
 maintainers:
   - Sebastian Reichel <sre@kernel.org>
diff --git a/Documentation/devicetree/bindings/regulator/pwm-regulator.yaml b/Documentation/devicetree/bindings/regulator/pwm-regulator.yaml
index 82b6f2fde422..7e58471097f8 100644
--- a/Documentation/devicetree/bindings/regulator/pwm-regulator.yaml
+++ b/Documentation/devicetree/bindings/regulator/pwm-regulator.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/regulator/pwm-regulator.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for the Generic PWM Regulator
+title: Generic PWM Regulator
 
 maintainers:
   - Brian Norris <briannorris@chromium.org>
diff --git a/Documentation/devicetree/bindings/rng/ingenic,rng.yaml b/Documentation/devicetree/bindings/rng/ingenic,rng.yaml
index b2e4a6a7f93a..79a023cbfdba 100644
--- a/Documentation/devicetree/bindings/rng/ingenic,rng.yaml
+++ b/Documentation/devicetree/bindings/rng/ingenic,rng.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/rng/ingenic,rng.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for RNG in Ingenic SoCs
+title: RNG in Ingenic SoCs
 
 maintainers:
   - 周琰杰 (Zhou Yanjie) <zhouyanjie@wanyeetech.com>
diff --git a/Documentation/devicetree/bindings/rng/ingenic,trng.yaml b/Documentation/devicetree/bindings/rng/ingenic,trng.yaml
index 044d9a065650..acaeb63caf24 100644
--- a/Documentation/devicetree/bindings/rng/ingenic,trng.yaml
+++ b/Documentation/devicetree/bindings/rng/ingenic,trng.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/rng/ingenic,trng.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for DTRNG in Ingenic SoCs
+title: DTRNG in Ingenic SoCs
 
 maintainers:
   - 周琰杰 (Zhou Yanjie) <zhouyanjie@wanyeetech.com>
diff --git a/Documentation/devicetree/bindings/serial/8250_omap.yaml b/Documentation/devicetree/bindings/serial/8250_omap.yaml
index 7b34ec8fa90e..53dc1212ad2e 100644
--- a/Documentation/devicetree/bindings/serial/8250_omap.yaml
+++ b/Documentation/devicetree/bindings/serial/8250_omap.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/serial/8250_omap.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for 8250 compliant UARTs on TI's OMAP2+ and K3 SoCs
+title: 8250 compliant UARTs on TI's OMAP2+ and K3 SoCs
 
 maintainers:
   - Vignesh Raghavendra <vigneshr@ti.com>
diff --git a/Documentation/devicetree/bindings/serio/ps2-gpio.yaml b/Documentation/devicetree/bindings/serio/ps2-gpio.yaml
index a63d9172346f..99848bc34f6e 100644
--- a/Documentation/devicetree/bindings/serio/ps2-gpio.yaml
+++ b/Documentation/devicetree/bindings/serio/ps2-gpio.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/serio/ps2-gpio.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for GPIO based PS/2
+title: GPIO based PS/2
 
 maintainers:
   - Danilo Krummrich <danilokrummrich@dk-develop.de>
diff --git a/Documentation/devicetree/bindings/sound/qcom,wcd934x.yaml b/Documentation/devicetree/bindings/sound/qcom,wcd934x.yaml
index 8ca19f2b0b3d..184e8ccbdd13 100644
--- a/Documentation/devicetree/bindings/sound/qcom,wcd934x.yaml
+++ b/Documentation/devicetree/bindings/sound/qcom,wcd934x.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/qcom,wcd934x.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for Qualcomm WCD9340/WCD9341 Audio Codec
+title: Qualcomm WCD9340/WCD9341 Audio Codec
 
 maintainers:
   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
diff --git a/Documentation/devicetree/bindings/sound/qcom,wcd938x-sdw.yaml b/Documentation/devicetree/bindings/sound/qcom,wcd938x-sdw.yaml
index 49a267b306f6..b430dd3e1841 100644
--- a/Documentation/devicetree/bindings/sound/qcom,wcd938x-sdw.yaml
+++ b/Documentation/devicetree/bindings/sound/qcom,wcd938x-sdw.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/qcom,wcd938x-sdw.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for Qualcomm SoundWire Slave devices on WCD9380/WCD9385
+title: Qualcomm SoundWire Slave devices on WCD9380/WCD9385
 
 maintainers:
   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
diff --git a/Documentation/devicetree/bindings/sound/qcom,wcd938x.yaml b/Documentation/devicetree/bindings/sound/qcom,wcd938x.yaml
index 51547190f709..cfb4b800789d 100644
--- a/Documentation/devicetree/bindings/sound/qcom,wcd938x.yaml
+++ b/Documentation/devicetree/bindings/sound/qcom,wcd938x.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/qcom,wcd938x.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for Qualcomm WCD9380/WCD9385 Audio Codec
+title: Qualcomm WCD9380/WCD9385 Audio Codec
 
 maintainers:
   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
diff --git a/Documentation/devicetree/bindings/sound/qcom,wsa881x.yaml b/Documentation/devicetree/bindings/sound/qcom,wsa881x.yaml
index ea44d03e58ca..d702b489320f 100644
--- a/Documentation/devicetree/bindings/sound/qcom,wsa881x.yaml
+++ b/Documentation/devicetree/bindings/sound/qcom,wsa881x.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/qcom,wsa881x.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for Qualcomm WSA8810/WSA8815 Class-D Smart Speaker Amplifier
+title: Qualcomm WSA8810/WSA8815 Class-D Smart Speaker Amplifier
 
 maintainers:
   - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
diff --git a/Documentation/devicetree/bindings/sound/qcom,wsa883x.yaml b/Documentation/devicetree/bindings/sound/qcom,wsa883x.yaml
index 99f9c10bbc83..3a29f822132d 100644
--- a/Documentation/devicetree/bindings/sound/qcom,wsa883x.yaml
+++ b/Documentation/devicetree/bindings/sound/qcom,wsa883x.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/sound/qcom,wsa883x.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for The Qualcomm WSA8830/WSA8832/WSA8835
+title: Qualcomm WSA8830/WSA8832/WSA8835
   smart speaker amplifier
 
 maintainers:
diff --git a/Documentation/devicetree/bindings/timer/ingenic,sysost.yaml b/Documentation/devicetree/bindings/timer/ingenic,sysost.yaml
index 98648bf9e151..bdc82d8bce0e 100644
--- a/Documentation/devicetree/bindings/timer/ingenic,sysost.yaml
+++ b/Documentation/devicetree/bindings/timer/ingenic,sysost.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/timer/ingenic,sysost.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Bindings for SYSOST in Ingenic XBurst family SoCs
+title: SYSOST in Ingenic XBurst family SoCs
 
 maintainers:
   - 周琰杰 (Zhou Yanjie) <zhouyanjie@wanyeetech.com>
diff --git a/Documentation/devicetree/bindings/usb/nvidia,tegra-xudc.yaml b/Documentation/devicetree/bindings/usb/nvidia,tegra-xudc.yaml
index fd6e7c81426e..f6cb19efd98b 100644
--- a/Documentation/devicetree/bindings/usb/nvidia,tegra-xudc.yaml
+++ b/Documentation/devicetree/bindings/usb/nvidia,tegra-xudc.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/usb/nvidia,tegra-xudc.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Device tree binding for NVIDIA Tegra XUSB device mode controller (XUDC)
+title: NVIDIA Tegra XUSB device mode controller (XUDC)
 
 description:
   The Tegra XUDC controller supports both USB 2.0 HighSpeed/FullSpeed and
diff --git a/Documentation/devicetree/bindings/usb/realtek,rts5411.yaml b/Documentation/devicetree/bindings/usb/realtek,rts5411.yaml
index 50f2b505bdeb..623d04a88a81 100644
--- a/Documentation/devicetree/bindings/usb/realtek,rts5411.yaml
+++ b/Documentation/devicetree/bindings/usb/realtek,rts5411.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/usb/realtek,rts5411.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for the Realtek RTS5411 USB 3.0 hub controller
+title: Realtek RTS5411 USB 3.0 hub controller
 
 maintainers:
   - Matthias Kaehlcke <mka@chromium.org>
diff --git a/Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml b/Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml
index eedde385d299..f81ba3e90297 100644
--- a/Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml
+++ b/Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml
@@ -4,7 +4,7 @@
 $id: "http://devicetree.org/schemas/usb/ti,j721e-usb.yaml#"
 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
 
-title: Bindings for the TI wrapper module for the Cadence USBSS-DRD controller
+title: TI wrapper module for the Cadence USBSS-DRD controller
 
 maintainers:
   - Roger Quadros <rogerq@kernel.org>
diff --git a/Documentation/devicetree/bindings/usb/ti,usb8041.yaml b/Documentation/devicetree/bindings/usb/ti,usb8041.yaml
index e04fbd8ab0b7..88ea6c952c66 100644
--- a/Documentation/devicetree/bindings/usb/ti,usb8041.yaml
+++ b/Documentation/devicetree/bindings/usb/ti,usb8041.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/usb/ti,usb8041.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding for the TI USB8041 USB 3.0 hub controller
+title: TI USB8041 USB 3.0 hub controller
 
 maintainers:
   - Alexander Stein <alexander.stein@ew.tq-group.com>
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 26+ messages in thread

* [RFC PATCH 8/9] dt-bindings: clock: drop redundant part of title
  2022-11-17 12:38 [RFC PATCH 0/9] dt-bindings: cleanup titles Krzysztof Kozlowski
                   ` (5 preceding siblings ...)
  2022-11-17 12:38 ` [RFC PATCH 7/9] dt-bindings: drop redundant part of title (beginning) Krzysztof Kozlowski
@ 2022-11-17 12:38 ` Krzysztof Kozlowski
  2022-11-17 16:03   ` Jonathan Cameron
  2022-11-17 12:38 ` [RFC PATCH 9/9] dt-bindings: drop redundant part of title (manual) Krzysztof Kozlowski
  2022-11-17 16:13 ` [RFC PATCH 0/9] dt-bindings: cleanup titles Alexandre Belloni
  8 siblings, 1 reply; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 12:38 UTC (permalink / raw)
  To: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog
  Cc: Krzysztof Kozlowski

The Devicetree bindings document does not have to say in the title that
it is a "Devicetree binding", but instead just describe the hardware.

Drop "Devicetree bindings" in various forms:

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -exec sed -i -e 's/^title: [dD]evice[ -]\?[tT]ree [cC]lock [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2 Clock Controller/' {} \;

  find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
    -exec sed -i -e 's/^title: [cC]lock [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2 Clock Controller/' {} \;

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
 Documentation/devicetree/bindings/clock/calxeda.yaml           | 2 +-
 Documentation/devicetree/bindings/clock/imx1-clock.yaml        | 2 +-
 Documentation/devicetree/bindings/clock/imx21-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx23-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx25-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx27-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx28-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx31-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx35-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx5-clock.yaml        | 2 +-
 Documentation/devicetree/bindings/clock/imx6q-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx6sl-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx6sll-clock.yaml     | 2 +-
 Documentation/devicetree/bindings/clock/imx6sx-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx6ul-clock.yaml      | 2 +-
 Documentation/devicetree/bindings/clock/imx7d-clock.yaml       | 2 +-
 Documentation/devicetree/bindings/clock/imx7ulp-pcc-clock.yaml | 2 +-
 Documentation/devicetree/bindings/clock/imx7ulp-scg-clock.yaml | 2 +-
 Documentation/devicetree/bindings/clock/imxrt1050-clock.yaml   | 2 +-
 Documentation/devicetree/bindings/clock/ti,lmk04832.yaml       | 2 +-
 20 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/Documentation/devicetree/bindings/clock/calxeda.yaml b/Documentation/devicetree/bindings/clock/calxeda.yaml
index a34cbf3c9aaf..a88fbe20fef1 100644
--- a/Documentation/devicetree/bindings/clock/calxeda.yaml
+++ b/Documentation/devicetree/bindings/clock/calxeda.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/calxeda.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Device Tree Clock bindings for Calxeda highbank platform
+title: Calxeda highbank platform Clock Controller
 
 description: |
   This binding covers the Calxeda SoC internal peripheral and bus clocks
diff --git a/Documentation/devicetree/bindings/clock/imx1-clock.yaml b/Documentation/devicetree/bindings/clock/imx1-clock.yaml
index 56f524780b1a..7ade4c32aff3 100644
--- a/Documentation/devicetree/bindings/clock/imx1-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx1-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx1-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX1 CPUs
+title: Freescale i.MX1 CPUs Clock Controller
 
 maintainers:
   - Alexander Shiyan <shc_work@mail.ru>
diff --git a/Documentation/devicetree/bindings/clock/imx21-clock.yaml b/Documentation/devicetree/bindings/clock/imx21-clock.yaml
index e2d50544700a..79cc843703ec 100644
--- a/Documentation/devicetree/bindings/clock/imx21-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx21-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx21-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX21
+title: Freescale i.MX21 Clock Controller
 
 maintainers:
   - Alexander Shiyan <shc_work@mail.ru>
diff --git a/Documentation/devicetree/bindings/clock/imx23-clock.yaml b/Documentation/devicetree/bindings/clock/imx23-clock.yaml
index 7e890ab9c77d..5e71c9219500 100644
--- a/Documentation/devicetree/bindings/clock/imx23-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx23-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx23-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX23
+title: Freescale i.MX23 Clock Controller
 
 maintainers:
   - Shawn Guo <shawnguo@kernel.org>
diff --git a/Documentation/devicetree/bindings/clock/imx25-clock.yaml b/Documentation/devicetree/bindings/clock/imx25-clock.yaml
index 1792e138984b..c626a158590e 100644
--- a/Documentation/devicetree/bindings/clock/imx25-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx25-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx25-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX25
+title: Freescale i.MX25 Clock Controller
 
 maintainers:
   - Sascha Hauer <s.hauer@pengutronix.de>
diff --git a/Documentation/devicetree/bindings/clock/imx27-clock.yaml b/Documentation/devicetree/bindings/clock/imx27-clock.yaml
index 99925aa22a4c..71d78a0b551f 100644
--- a/Documentation/devicetree/bindings/clock/imx27-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx27-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx27-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX27
+title: Freescale i.MX27 Clock Controller
 
 maintainers:
   - Fabio Estevam <festevam@gmail.com>
diff --git a/Documentation/devicetree/bindings/clock/imx28-clock.yaml b/Documentation/devicetree/bindings/clock/imx28-clock.yaml
index a542d680b1ca..4aaad7b9c66e 100644
--- a/Documentation/devicetree/bindings/clock/imx28-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx28-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx28-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX28
+title: Freescale i.MX28 Clock Controller
 
 maintainers:
   - Shawn Guo <shawnguo@kernel.org>
diff --git a/Documentation/devicetree/bindings/clock/imx31-clock.yaml b/Documentation/devicetree/bindings/clock/imx31-clock.yaml
index 168c8ada5e81..50a8498eef8a 100644
--- a/Documentation/devicetree/bindings/clock/imx31-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx31-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx31-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX31
+title: Freescale i.MX31 Clock Controller
 
 maintainers:
   - Fabio Estevam <festevam@gmail.com>
diff --git a/Documentation/devicetree/bindings/clock/imx35-clock.yaml b/Documentation/devicetree/bindings/clock/imx35-clock.yaml
index 6415bb6a8d04..c063369de3ec 100644
--- a/Documentation/devicetree/bindings/clock/imx35-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx35-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx35-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX35
+title: Freescale i.MX35 Clock Controller
 
 maintainers:
   - Steffen Trumtrar <s.trumtrar@pengutronix.de>
diff --git a/Documentation/devicetree/bindings/clock/imx5-clock.yaml b/Documentation/devicetree/bindings/clock/imx5-clock.yaml
index c0e19ff92c76..423c0142c1d3 100644
--- a/Documentation/devicetree/bindings/clock/imx5-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx5-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx5-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX5
+title: Freescale i.MX5 Clock Controller
 
 maintainers:
   - Fabio Estevam <festevam@gmail.com>
diff --git a/Documentation/devicetree/bindings/clock/imx6q-clock.yaml b/Documentation/devicetree/bindings/clock/imx6q-clock.yaml
index 4f4637eddb8b..bae4fcb3aacc 100644
--- a/Documentation/devicetree/bindings/clock/imx6q-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx6q-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx6q-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX6 Quad
+title: Freescale i.MX6 Quad Clock Controller
 
 maintainers:
   - Anson Huang <Anson.Huang@nxp.com>
diff --git a/Documentation/devicetree/bindings/clock/imx6sl-clock.yaml b/Documentation/devicetree/bindings/clock/imx6sl-clock.yaml
index b83c8f43d664..c85ff6ea3d24 100644
--- a/Documentation/devicetree/bindings/clock/imx6sl-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx6sl-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx6sl-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX6 SoloLite
+title: Freescale i.MX6 SoloLite Clock Controller
 
 maintainers:
   - Anson Huang <Anson.Huang@nxp.com>
diff --git a/Documentation/devicetree/bindings/clock/imx6sll-clock.yaml b/Documentation/devicetree/bindings/clock/imx6sll-clock.yaml
index 484894a4b23f..6b549ed1493c 100644
--- a/Documentation/devicetree/bindings/clock/imx6sll-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx6sll-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx6sll-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX6 SLL
+title: Freescale i.MX6 SLL Clock Controller
 
 maintainers:
   - Anson Huang <Anson.Huang@nxp.com>
diff --git a/Documentation/devicetree/bindings/clock/imx6sx-clock.yaml b/Documentation/devicetree/bindings/clock/imx6sx-clock.yaml
index e6c795657c24..55dcad18b7c6 100644
--- a/Documentation/devicetree/bindings/clock/imx6sx-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx6sx-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx6sx-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX6 SoloX
+title: Freescale i.MX6 SoloX Clock Controller
 
 maintainers:
   - Anson Huang <Anson.Huang@nxp.com>
diff --git a/Documentation/devicetree/bindings/clock/imx6ul-clock.yaml b/Documentation/devicetree/bindings/clock/imx6ul-clock.yaml
index 6a51a3f51cd9..be54d4df5afa 100644
--- a/Documentation/devicetree/bindings/clock/imx6ul-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx6ul-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx6ul-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX6 UltraLite
+title: Freescale i.MX6 UltraLite Clock Controller
 
 maintainers:
   - Anson Huang <Anson.Huang@nxp.com>
diff --git a/Documentation/devicetree/bindings/clock/imx7d-clock.yaml b/Documentation/devicetree/bindings/clock/imx7d-clock.yaml
index cefb61db01a8..e7d8427e4957 100644
--- a/Documentation/devicetree/bindings/clock/imx7d-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx7d-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx7d-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX7 Dual
+title: Freescale i.MX7 Dual Clock Controller
 
 maintainers:
   - Frank Li <Frank.Li@nxp.com>
diff --git a/Documentation/devicetree/bindings/clock/imx7ulp-pcc-clock.yaml b/Documentation/devicetree/bindings/clock/imx7ulp-pcc-clock.yaml
index 739c3378f8c8..76842038f52e 100644
--- a/Documentation/devicetree/bindings/clock/imx7ulp-pcc-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx7ulp-pcc-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx7ulp-pcc-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX7ULP Peripheral Clock Control (PCC) modules
+title: Freescale i.MX7ULP Peripheral Clock Control (PCC) modules Clock Controller
 
 maintainers:
   - A.s. Dong <aisheng.dong@nxp.com>
diff --git a/Documentation/devicetree/bindings/clock/imx7ulp-scg-clock.yaml b/Documentation/devicetree/bindings/clock/imx7ulp-scg-clock.yaml
index d06344d7e34f..5e25bc6d1372 100644
--- a/Documentation/devicetree/bindings/clock/imx7ulp-scg-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imx7ulp-scg-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imx7ulp-scg-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MX7ULP System Clock Generation (SCG) modules
+title: Freescale i.MX7ULP System Clock Generation (SCG) modules Clock Controller
 
 maintainers:
   - A.s. Dong <aisheng.dong@nxp.com>
diff --git a/Documentation/devicetree/bindings/clock/imxrt1050-clock.yaml b/Documentation/devicetree/bindings/clock/imxrt1050-clock.yaml
index 03fc5c1a2939..777af4aad4b2 100644
--- a/Documentation/devicetree/bindings/clock/imxrt1050-clock.yaml
+++ b/Documentation/devicetree/bindings/clock/imxrt1050-clock.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/imxrt1050-clock.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for Freescale i.MXRT
+title: Freescale i.MXRT Clock Controller
 
 maintainers:
   - Giulio Benetti <giulio.benetti@benettiengineering.com>
diff --git a/Documentation/devicetree/bindings/clock/ti,lmk04832.yaml b/Documentation/devicetree/bindings/clock/ti,lmk04832.yaml
index bd8173848253..73d17830f165 100644
--- a/Documentation/devicetree/bindings/clock/ti,lmk04832.yaml
+++ b/Documentation/devicetree/bindings/clock/ti,lmk04832.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/ti,lmk04832.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Clock bindings for the Texas Instruments LMK04832
+title: Texas Instruments LMK04832 Clock Controller
 
 maintainers:
   - Liam Beguin <liambeguin@gmail.com>
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 26+ messages in thread

* [RFC PATCH 9/9] dt-bindings: drop redundant part of title (manual)
  2022-11-17 12:38 [RFC PATCH 0/9] dt-bindings: cleanup titles Krzysztof Kozlowski
                   ` (6 preceding siblings ...)
  2022-11-17 12:38 ` [RFC PATCH 8/9] dt-bindings: clock: drop redundant part of title Krzysztof Kozlowski
@ 2022-11-17 12:38 ` Krzysztof Kozlowski
  2022-11-17 16:05   ` Jonathan Cameron
  2022-11-17 16:13 ` [RFC PATCH 0/9] dt-bindings: cleanup titles Alexandre Belloni
  8 siblings, 1 reply; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 12:38 UTC (permalink / raw)
  To: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog
  Cc: Krzysztof Kozlowski

The Devicetree bindings document does not have to say in the title that
it is a "Devicetree binding", but instead just describe the hardware.

Manual updates to various binding titles.

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
 Documentation/devicetree/bindings/clock/cirrus,cs2000-cp.yaml   | 2 +-
 Documentation/devicetree/bindings/clock/fsl,scu-clk.yaml        | 2 +-
 .../devicetree/bindings/clock/qcom,dispcc-sc8280xp.yaml         | 2 +-
 Documentation/devicetree/bindings/input/fsl,scu-key.yaml        | 2 +-
 Documentation/devicetree/bindings/input/matrix-keymap.yaml      | 2 +-
 Documentation/devicetree/bindings/leds/issi,is31fl319x.yaml     | 2 +-
 Documentation/devicetree/bindings/net/asix,ax88178.yaml         | 2 +-
 Documentation/devicetree/bindings/net/microchip,lan95xx.yaml    | 2 +-
 Documentation/devicetree/bindings/nvmem/fsl,scu-ocotp.yaml      | 2 +-
 Documentation/devicetree/bindings/opp/opp-v2-qcom-level.yaml    | 2 +-
 Documentation/devicetree/bindings/phy/calxeda-combophy.yaml     | 2 +-
 Documentation/devicetree/bindings/pinctrl/fsl,scu-pinctrl.yaml  | 2 +-
 Documentation/devicetree/bindings/power/fsl,scu-pd.yaml         | 2 +-
 Documentation/devicetree/bindings/riscv/cpus.yaml               | 2 +-
 Documentation/devicetree/bindings/rtc/fsl,scu-rtc.yaml          | 2 +-
 Documentation/devicetree/bindings/spi/omap-spi.yaml             | 2 +-
 Documentation/devicetree/bindings/thermal/fsl,scu-thermal.yaml  | 2 +-
 Documentation/devicetree/bindings/usb/usb-device.yaml           | 2 +-
 Documentation/devicetree/bindings/watchdog/fsl,scu-wdt.yaml     | 2 +-
 19 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/Documentation/devicetree/bindings/clock/cirrus,cs2000-cp.yaml b/Documentation/devicetree/bindings/clock/cirrus,cs2000-cp.yaml
index 82836086cac1..d416c374e853 100644
--- a/Documentation/devicetree/bindings/clock/cirrus,cs2000-cp.yaml
+++ b/Documentation/devicetree/bindings/clock/cirrus,cs2000-cp.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/cirrus,cs2000-cp.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Binding CIRRUS LOGIC Fractional-N Clock Synthesizer & Clock Multiplier
+title: CIRRUS LOGIC Fractional-N Clock Synthesizer & Clock Multiplier
 
 maintainers:
   - Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
diff --git a/Documentation/devicetree/bindings/clock/fsl,scu-clk.yaml b/Documentation/devicetree/bindings/clock/fsl,scu-clk.yaml
index f2c48460a399..e617b6835bd0 100644
--- a/Documentation/devicetree/bindings/clock/fsl,scu-clk.yaml
+++ b/Documentation/devicetree/bindings/clock/fsl,scu-clk.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/fsl,scu-clk.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: i.MX SCU Client Device Node - Clock bindings based on SCU Message Protocol
+title: i.MX SCU Client Device Node - Clock Controller based on SCU Message Protocol
 
 maintainers:
   - Abel Vesa <abel.vesa@nxp.com>
diff --git a/Documentation/devicetree/bindings/clock/qcom,dispcc-sc8280xp.yaml b/Documentation/devicetree/bindings/clock/qcom,dispcc-sc8280xp.yaml
index 28c13237059f..3cb996b2c9d5 100644
--- a/Documentation/devicetree/bindings/clock/qcom,dispcc-sc8280xp.yaml
+++ b/Documentation/devicetree/bindings/clock/qcom,dispcc-sc8280xp.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/clock/qcom,dispcc-sc8280xp.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Qualcomm Display Clock & Reset Controller Binding for SC8280XP
+title: Qualcomm Display Clock & Reset Controller on SC8280XP
 
 maintainers:
   - Bjorn Andersson <bjorn.andersson@linaro.org>
diff --git a/Documentation/devicetree/bindings/input/fsl,scu-key.yaml b/Documentation/devicetree/bindings/input/fsl,scu-key.yaml
index e6266d188266..67cf76bf554b 100644
--- a/Documentation/devicetree/bindings/input/fsl,scu-key.yaml
+++ b/Documentation/devicetree/bindings/input/fsl,scu-key.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/input/fsl,scu-key.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: i.MX SCU Client Device Node - SCU key bindings based on SCU Message Protocol
+title: i.MX SCU Client Device Node - SCU key based on SCU Message Protocol
 
 maintainers:
   - Dong Aisheng <aisheng.dong@nxp.com>
diff --git a/Documentation/devicetree/bindings/input/matrix-keymap.yaml b/Documentation/devicetree/bindings/input/matrix-keymap.yaml
index 6699d5e32dca..05d447e57384 100644
--- a/Documentation/devicetree/bindings/input/matrix-keymap.yaml
+++ b/Documentation/devicetree/bindings/input/matrix-keymap.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/input/matrix-keymap.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Common key matrices binding for matrix-connected key boards
+title: Common key matrices on matrix-connected key boards
 
 maintainers:
   - Olof Johansson <olof@lixom.net>
diff --git a/Documentation/devicetree/bindings/leds/issi,is31fl319x.yaml b/Documentation/devicetree/bindings/leds/issi,is31fl319x.yaml
index 940333f2d69c..66e2c3617d68 100644
--- a/Documentation/devicetree/bindings/leds/issi,is31fl319x.yaml
+++ b/Documentation/devicetree/bindings/leds/issi,is31fl319x.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/leds/issi,is31fl319x.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: ISSI LED controllers bindings for IS31FL319{0,1,3,6,9}
+title: ISSI LED controllers for IS31FL319{0,1,3,6,9}
 
 maintainers:
   - Vincent Knecht <vincent.knecht@mailoo.org>
diff --git a/Documentation/devicetree/bindings/net/asix,ax88178.yaml b/Documentation/devicetree/bindings/net/asix,ax88178.yaml
index a81dbc4792f6..2e74bdb74208 100644
--- a/Documentation/devicetree/bindings/net/asix,ax88178.yaml
+++ b/Documentation/devicetree/bindings/net/asix,ax88178.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/asix,ax88178.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: The device tree bindings for the USB Ethernet controllers
+title: ASIX AX88172/AX88772 USB Ethernet controllers
 
 maintainers:
   - Oleksij Rempel <o.rempel@pengutronix.de>
diff --git a/Documentation/devicetree/bindings/net/microchip,lan95xx.yaml b/Documentation/devicetree/bindings/net/microchip,lan95xx.yaml
index 3715c5f8f0e0..da2065d6c37e 100644
--- a/Documentation/devicetree/bindings/net/microchip,lan95xx.yaml
+++ b/Documentation/devicetree/bindings/net/microchip,lan95xx.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/net/microchip,lan95xx.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: The device tree bindings for the USB Ethernet controllers
+title: Microchip SMSC9500/LAN9530/LAN9730 USB Ethernet controllers
 
 maintainers:
   - Oleksij Rempel <o.rempel@pengutronix.de>
diff --git a/Documentation/devicetree/bindings/nvmem/fsl,scu-ocotp.yaml b/Documentation/devicetree/bindings/nvmem/fsl,scu-ocotp.yaml
index 682688299b26..b443b5228470 100644
--- a/Documentation/devicetree/bindings/nvmem/fsl,scu-ocotp.yaml
+++ b/Documentation/devicetree/bindings/nvmem/fsl,scu-ocotp.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/nvmem/fsl,scu-ocotp.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: i.MX SCU Client Device Node - OCOTP bindings based on SCU Message Protocol
+title: i.MX SCU Client Device Node - OCOTP based on SCU Message Protocol
 
 maintainers:
   - Dong Aisheng <aisheng.dong@nxp.com>
diff --git a/Documentation/devicetree/bindings/opp/opp-v2-qcom-level.yaml b/Documentation/devicetree/bindings/opp/opp-v2-qcom-level.yaml
index df8442fb11f0..b9ce2e099ce9 100644
--- a/Documentation/devicetree/bindings/opp/opp-v2-qcom-level.yaml
+++ b/Documentation/devicetree/bindings/opp/opp-v2-qcom-level.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/opp/opp-v2-qcom-level.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Qualcomm OPP bindings to describe OPP nodes.
+title: Qualcomm OPP
 
 maintainers:
   - Niklas Cassel <nks@flawful.org>
diff --git a/Documentation/devicetree/bindings/phy/calxeda-combophy.yaml b/Documentation/devicetree/bindings/phy/calxeda-combophy.yaml
index 41ee16e21f8d..d05a7c793035 100644
--- a/Documentation/devicetree/bindings/phy/calxeda-combophy.yaml
+++ b/Documentation/devicetree/bindings/phy/calxeda-combophy.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/phy/calxeda-combophy.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: Calxeda Highbank Combination PHYs binding for SATA
+title: Calxeda Highbank Combination PHYs for SATA
 
 description: |
   The Calxeda Combination PHYs connect the SoC to the internal fabric
diff --git a/Documentation/devicetree/bindings/pinctrl/fsl,scu-pinctrl.yaml b/Documentation/devicetree/bindings/pinctrl/fsl,scu-pinctrl.yaml
index 45ea565ce238..297af8350299 100644
--- a/Documentation/devicetree/bindings/pinctrl/fsl,scu-pinctrl.yaml
+++ b/Documentation/devicetree/bindings/pinctrl/fsl,scu-pinctrl.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/pinctrl/fsl,scu-pinctrl.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: i.MX SCU Client Device Node - Pinctrl bindings based on SCU Message Protocol
+title: i.MX SCU Client Device Node - Pinctrl based on SCU Message Protocol
 
 maintainers:
   - Dong Aisheng <aisheng.dong@nxp.com>
diff --git a/Documentation/devicetree/bindings/power/fsl,scu-pd.yaml b/Documentation/devicetree/bindings/power/fsl,scu-pd.yaml
index 1f72b18ca0fc..6bcd39f93268 100644
--- a/Documentation/devicetree/bindings/power/fsl,scu-pd.yaml
+++ b/Documentation/devicetree/bindings/power/fsl,scu-pd.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/power/fsl,scu-pd.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: i.MX SCU Client Device Node - Power domain bindings based on SCU Message Protocol
+title: i.MX SCU Client Device Node - Power domain based on SCU Message Protocol
 
 maintainers:
   - Dong Aisheng <aisheng.dong@nxp.com>
diff --git a/Documentation/devicetree/bindings/riscv/cpus.yaml b/Documentation/devicetree/bindings/riscv/cpus.yaml
index 2bf91829c8de..37de07c8291f 100644
--- a/Documentation/devicetree/bindings/riscv/cpus.yaml
+++ b/Documentation/devicetree/bindings/riscv/cpus.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/riscv/cpus.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: RISC-V bindings for 'cpus' DT nodes
+title: RISC-V CPUs
 
 maintainers:
   - Paul Walmsley <paul.walmsley@sifive.com>
diff --git a/Documentation/devicetree/bindings/rtc/fsl,scu-rtc.yaml b/Documentation/devicetree/bindings/rtc/fsl,scu-rtc.yaml
index 8c102b70d735..00f7b12e2899 100644
--- a/Documentation/devicetree/bindings/rtc/fsl,scu-rtc.yaml
+++ b/Documentation/devicetree/bindings/rtc/fsl,scu-rtc.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/rtc/fsl,scu-rtc.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: i.MX SCU Client Device Node - RTC bindings based on SCU Message Protocol
+title: i.MX SCU Client Device Node - RTC based on SCU Message Protocol
 
 maintainers:
   - Dong Aisheng <aisheng.dong@nxp.com>
diff --git a/Documentation/devicetree/bindings/spi/omap-spi.yaml b/Documentation/devicetree/bindings/spi/omap-spi.yaml
index 9952199cae11..e0fd744e809b 100644
--- a/Documentation/devicetree/bindings/spi/omap-spi.yaml
+++ b/Documentation/devicetree/bindings/spi/omap-spi.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/spi/omap-spi.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: SPI controller bindings for OMAP and K3 SoCs
+title: SPI controller on OMAP and K3 SoCs
 
 maintainers:
   - Aswath Govindraju <a-govindraju@ti.com>
diff --git a/Documentation/devicetree/bindings/thermal/fsl,scu-thermal.yaml b/Documentation/devicetree/bindings/thermal/fsl,scu-thermal.yaml
index f9e4b3c8d0ee..d574a0c649f5 100644
--- a/Documentation/devicetree/bindings/thermal/fsl,scu-thermal.yaml
+++ b/Documentation/devicetree/bindings/thermal/fsl,scu-thermal.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/thermal/fsl,scu-thermal.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: i.MX SCU Client Device Node - Thermal bindings based on SCU Message Protocol
+title: i.MX SCU Client Device Node - Thermal based on SCU Message Protocol
 
 maintainers:
   - Dong Aisheng <aisheng.dong@nxp.com>
diff --git a/Documentation/devicetree/bindings/usb/usb-device.yaml b/Documentation/devicetree/bindings/usb/usb-device.yaml
index b77960a7a37b..7a771125ec76 100644
--- a/Documentation/devicetree/bindings/usb/usb-device.yaml
+++ b/Documentation/devicetree/bindings/usb/usb-device.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/usb/usb-device.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: The device tree bindings for the Generic USB Device
+title: Generic USB Device
 
 maintainers:
   - Greg Kroah-Hartman <gregkh@linuxfoundation.org>
diff --git a/Documentation/devicetree/bindings/watchdog/fsl,scu-wdt.yaml b/Documentation/devicetree/bindings/watchdog/fsl,scu-wdt.yaml
index f84c45d687d7..092e258544ec 100644
--- a/Documentation/devicetree/bindings/watchdog/fsl,scu-wdt.yaml
+++ b/Documentation/devicetree/bindings/watchdog/fsl,scu-wdt.yaml
@@ -4,7 +4,7 @@
 $id: http://devicetree.org/schemas/watchdog/fsl,scu-wdt.yaml#
 $schema: http://devicetree.org/meta-schemas/core.yaml#
 
-title: i.MX SCU Client Device Node - Watchdog bindings based on SCU Message Protocol
+title: i.MX SCU Client Device Node - Watchdog based on SCU Message Protocol
 
 maintainers:
   - Dong Aisheng <aisheng.dong@nxp.com>
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 12:38 ` [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Krzysztof Kozlowski
@ 2022-11-17 13:23   ` Andrew Lunn
  2022-11-17 14:58     ` Krzysztof Kozlowski
  2022-11-17 14:33   ` Guenter Roeck
                     ` (4 subsequent siblings)
  5 siblings, 1 reply; 26+ messages in thread
From: Andrew Lunn @ 2022-11-17 13:23 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, devicetree, linux-arm-kernel,
	linux-kernel, linux-clk, linux-riscv, linux-arm-msm, linux-pm,
	linux-gpio, linux-iio, linux-input, linux-leds, linux-media,
	linux-mips, linux-mmc, linux-mtd, netdev, linux-can, linux-pci,
	linux-pwm, linux-rtc, linux-serial, alsa-devel, linux-spi,
	linux-usb, virtualization, linux-watchdog

>  allOf:
> -  - $ref: "dma-common.yaml#"
> +  - $ref: dma-common.yaml#
>  
>  
>  allOf:
> -  - $ref: "dma-common.yaml#"
> +  - $ref: dma-common.yaml#

Looks like some other automated change made its way into this patch.

      Andrew

^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 12:38 ` [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Krzysztof Kozlowski
  2022-11-17 13:23   ` Andrew Lunn
@ 2022-11-17 14:33   ` Guenter Roeck
  2022-11-17 15:17   ` Jonathan Cameron
                     ` (3 subsequent siblings)
  5 siblings, 0 replies; 26+ messages in thread
From: Guenter Roeck @ 2022-11-17 14:33 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On Thu, Nov 17, 2022 at 01:38:42PM +0100, Krzysztof Kozlowski wrote:
> The Devicetree bindings document does not have to say in the title that
> it is a "binding", but instead just describe the hardware.  For shared
> (re-usable) schemas, name them all as "common properties".
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> ---
>  Documentation/devicetree/bindings/clock/qcom,gcc.yaml         | 2 +-
>  Documentation/devicetree/bindings/dma/dma-common.yaml         | 2 +-
>  Documentation/devicetree/bindings/dma/dma-controller.yaml     | 4 ++--
>  Documentation/devicetree/bindings/dma/dma-router.yaml         | 4 ++--
>  Documentation/devicetree/bindings/iio/adc/adc.yaml            | 2 +-
>  .../devicetree/bindings/media/video-interface-devices.yaml    | 2 +-
>  Documentation/devicetree/bindings/media/video-interfaces.yaml | 2 +-
>  Documentation/devicetree/bindings/mmc/mmc-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/mtd/nand-chip.yaml          | 2 +-
>  Documentation/devicetree/bindings/mtd/nand-controller.yaml    | 2 +-
>  .../bindings/net/bluetooth/bluetooth-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/can/can-controller.yaml | 2 +-
>  .../devicetree/bindings/net/ethernet-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/ethernet-phy.yaml       | 2 +-
>  Documentation/devicetree/bindings/net/mdio.yaml               | 2 +-
>  Documentation/devicetree/bindings/opp/opp-v2-base.yaml        | 2 +-
>  .../devicetree/bindings/power/reset/restart-handler.yaml      | 2 +-
>  Documentation/devicetree/bindings/rtc/rtc.yaml                | 2 +-
>  .../devicetree/bindings/soundwire/soundwire-controller.yaml   | 2 +-
>  Documentation/devicetree/bindings/spi/spi-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/watchdog/watchdog.yaml      | 2 +-

For watchdog:

Acked-by: Guenter Roeck <linux@roeck-us.net>

>  21 files changed, 23 insertions(+), 23 deletions(-)
> 
> diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> index 1ab416c83c8d..d2de3d128b73 100644
> --- a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> +++ b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/clock/qcom,gcc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Qualcomm Global Clock & Reset Controller Common Bindings
> +title: Qualcomm Global Clock & Reset Controller common parts
>  
>  maintainers:
>    - Stephen Boyd <sboyd@kernel.org>
> diff --git a/Documentation/devicetree/bindings/dma/dma-common.yaml b/Documentation/devicetree/bindings/dma/dma-common.yaml
> index ad06d36af208..9b7b94fdbb0b 100644
> --- a/Documentation/devicetree/bindings/dma/dma-common.yaml
> +++ b/Documentation/devicetree/bindings/dma/dma-common.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/dma/dma-common.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: DMA Engine Generic Binding
> +title: DMA Engine common properties
>  
>  maintainers:
>    - Vinod Koul <vkoul@kernel.org>
> diff --git a/Documentation/devicetree/bindings/dma/dma-controller.yaml b/Documentation/devicetree/bindings/dma/dma-controller.yaml
> index 6d3727267fa8..225a141c7b5c 100644
> --- a/Documentation/devicetree/bindings/dma/dma-controller.yaml
> +++ b/Documentation/devicetree/bindings/dma/dma-controller.yaml
> @@ -4,13 +4,13 @@
>  $id: http://devicetree.org/schemas/dma/dma-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: DMA Controller Generic Binding
> +title: DMA Controller common properties
>  
>  maintainers:
>    - Vinod Koul <vkoul@kernel.org>
>  
>  allOf:
> -  - $ref: "dma-common.yaml#"
> +  - $ref: dma-common.yaml#
>  
>  # Everything else is described in the common file
>  properties:
> diff --git a/Documentation/devicetree/bindings/dma/dma-router.yaml b/Documentation/devicetree/bindings/dma/dma-router.yaml
> index 4b817f5dc30e..0ebd7bc6232b 100644
> --- a/Documentation/devicetree/bindings/dma/dma-router.yaml
> +++ b/Documentation/devicetree/bindings/dma/dma-router.yaml
> @@ -4,13 +4,13 @@
>  $id: http://devicetree.org/schemas/dma/dma-router.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: DMA Router Generic Binding
> +title: DMA Router common properties
>  
>  maintainers:
>    - Vinod Koul <vkoul@kernel.org>
>  
>  allOf:
> -  - $ref: "dma-common.yaml#"
> +  - $ref: dma-common.yaml#
>  
>  description:
>    DMA routers are transparent IP blocks used to route DMA request
> diff --git a/Documentation/devicetree/bindings/iio/adc/adc.yaml b/Documentation/devicetree/bindings/iio/adc/adc.yaml
> index db348fcbb52c..bd0f5fae256e 100644
> --- a/Documentation/devicetree/bindings/iio/adc/adc.yaml
> +++ b/Documentation/devicetree/bindings/iio/adc/adc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/iio/adc/adc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Generic IIO bindings for ADC channels
> +title: IIO common properties for ADC channels
>  
>  maintainers:
>    - Jonathan Cameron <jic23@kernel.org>
> diff --git a/Documentation/devicetree/bindings/media/video-interface-devices.yaml b/Documentation/devicetree/bindings/media/video-interface-devices.yaml
> index 4527f56a5a6e..bd719cb1813e 100644
> --- a/Documentation/devicetree/bindings/media/video-interface-devices.yaml
> +++ b/Documentation/devicetree/bindings/media/video-interface-devices.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/media/video-interface-devices.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Common bindings for video receiver and transmitter devices
> +title: Common properties for video receiver and transmitter devices
>  
>  maintainers:
>    - Jacopo Mondi <jacopo@jmondi.org>
> diff --git a/Documentation/devicetree/bindings/media/video-interfaces.yaml b/Documentation/devicetree/bindings/media/video-interfaces.yaml
> index 68c3b9871cf3..e8cf73794772 100644
> --- a/Documentation/devicetree/bindings/media/video-interfaces.yaml
> +++ b/Documentation/devicetree/bindings/media/video-interfaces.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/media/video-interfaces.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Common bindings for video receiver and transmitter interface endpoints
> +title: Common properties for video receiver and transmitter interface endpoints
>  
>  maintainers:
>    - Sakari Ailus <sakari.ailus@linux.intel.com>
> diff --git a/Documentation/devicetree/bindings/mmc/mmc-controller.yaml b/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
> index 802e3ca8be4d..a17f49738abd 100644
> --- a/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
> +++ b/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mmc/mmc-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: MMC Controller Generic Binding
> +title: MMC Controller common properties
>  
>  maintainers:
>    - Ulf Hansson <ulf.hansson@linaro.org>
> diff --git a/Documentation/devicetree/bindings/mtd/nand-chip.yaml b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> index 97ac3a3fbb52..20b195ef9b70 100644
> --- a/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> +++ b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mtd/nand-chip.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NAND Chip and NAND Controller Generic Binding
> +title: NAND Chip and NAND Controller common properties
>  
>  maintainers:
>    - Miquel Raynal <miquel.raynal@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/mtd/nand-controller.yaml b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> index 359a015d4e5a..a004efc42842 100644
> --- a/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> +++ b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mtd/nand-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NAND Chip and NAND Controller Generic Binding
> +title: NAND Chip and NAND Controller common properties
>  
>  maintainers:
>    - Miquel Raynal <miquel.raynal@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml b/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
> index 9309dc40f54f..8715adff5eaf 100644
> --- a/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
> +++ b/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/bluetooth/bluetooth-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Bluetooth Controller Generic Binding
> +title: Bluetooth Controller common properties
>  
>  maintainers:
>    - Marcel Holtmann <marcel@holtmann.org>
> diff --git a/Documentation/devicetree/bindings/net/can/can-controller.yaml b/Documentation/devicetree/bindings/net/can/can-controller.yaml
> index 1f0e98051074..3747b46cf9b6 100644
> --- a/Documentation/devicetree/bindings/net/can/can-controller.yaml
> +++ b/Documentation/devicetree/bindings/net/can/can-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/can/can-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: CAN Controller Generic Binding
> +title: CAN Controller common properties
>  
>  maintainers:
>    - Marc Kleine-Budde <mkl@pengutronix.de>
> diff --git a/Documentation/devicetree/bindings/net/ethernet-controller.yaml b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
> index 3aef506fa158..26502c0f2aff 100644
> --- a/Documentation/devicetree/bindings/net/ethernet-controller.yaml
> +++ b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/ethernet-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ethernet Controller Generic Binding
> +title: Ethernet Controller common properties
>  
>  maintainers:
>    - David S. Miller <davem@davemloft.net>
> diff --git a/Documentation/devicetree/bindings/net/ethernet-phy.yaml b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> index ad808e9ce5b9..0aa1b60e78cc 100644
> --- a/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> +++ b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/ethernet-phy.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ethernet PHY Generic Binding
> +title: Ethernet PHY common properties
>  
>  maintainers:
>    - Andrew Lunn <andrew@lunn.ch>
> diff --git a/Documentation/devicetree/bindings/net/mdio.yaml b/Documentation/devicetree/bindings/net/mdio.yaml
> index b5706d4e7e38..b184689dd6b2 100644
> --- a/Documentation/devicetree/bindings/net/mdio.yaml
> +++ b/Documentation/devicetree/bindings/net/mdio.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/mdio.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: MDIO Bus Generic Binding
> +title: MDIO Bus common properties
>  
>  maintainers:
>    - Andrew Lunn <andrew@lunn.ch>
> diff --git a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> index cf9c2f7bddc2..20ac432dc683 100644
> --- a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> +++ b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/opp/opp-v2-base.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Generic OPP (Operating Performance Points) Common Binding
> +title: Generic OPP (Operating Performance Points) common parts
>  
>  maintainers:
>    - Viresh Kumar <viresh.kumar@linaro.org>
> diff --git a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
> index 1f9a2aac53c0..8b52fd156d4c 100644
> --- a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
> +++ b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/power/reset/restart-handler.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Restart and shutdown handler generic binding
> +title: Restart and shutdown handler common properties
>  
>  maintainers:
>    - Sebastian Reichel <sre@kernel.org>
> diff --git a/Documentation/devicetree/bindings/rtc/rtc.yaml b/Documentation/devicetree/bindings/rtc/rtc.yaml
> index 0ec3551f12dd..00848a5a409e 100644
> --- a/Documentation/devicetree/bindings/rtc/rtc.yaml
> +++ b/Documentation/devicetree/bindings/rtc/rtc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/rtc/rtc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: RTC Generic Binding
> +title: Real Time Clock common properties
>  
>  maintainers:
>    - Alexandre Belloni <alexandre.belloni@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml b/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
> index 4aad121eff3f..2176033850dc 100644
> --- a/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
> +++ b/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/soundwire/soundwire-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: SoundWire Controller Generic Binding
> +title: SoundWire Controller common properties
>  
>  maintainers:
>    - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
> diff --git a/Documentation/devicetree/bindings/spi/spi-controller.yaml b/Documentation/devicetree/bindings/spi/spi-controller.yaml
> index 01042a7f382e..6bbe073f894b 100644
> --- a/Documentation/devicetree/bindings/spi/spi-controller.yaml
> +++ b/Documentation/devicetree/bindings/spi/spi-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/spi/spi-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: SPI Controller Generic Binding
> +title: SPI Controller common properties
>  
>  maintainers:
>    - Mark Brown <broonie@kernel.org>
> diff --git a/Documentation/devicetree/bindings/watchdog/watchdog.yaml b/Documentation/devicetree/bindings/watchdog/watchdog.yaml
> index e3dfb02f0ca5..6875cf1c3159 100644
> --- a/Documentation/devicetree/bindings/watchdog/watchdog.yaml
> +++ b/Documentation/devicetree/bindings/watchdog/watchdog.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/watchdog/watchdog.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Watchdog Generic Bindings
> +title: Watchdog common properties
>  
>  maintainers:
>    - Guenter Roeck <linux@roeck-us.net>
> -- 
> 2.34.1
> 

^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 13:23   ` Andrew Lunn
@ 2022-11-17 14:58     ` Krzysztof Kozlowski
  0 siblings, 0 replies; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 14:58 UTC (permalink / raw)
  To: Andrew Lunn
  Cc: Rob Herring, Krzysztof Kozlowski, devicetree, linux-arm-kernel,
	linux-kernel, linux-clk, linux-riscv, linux-arm-msm, linux-pm,
	linux-gpio, linux-iio, linux-input, linux-leds, linux-media,
	linux-mips, linux-mmc, linux-mtd, netdev, linux-can, linux-pci,
	linux-pwm, linux-rtc, linux-serial, alsa-devel, linux-spi,
	linux-usb, virtualization, linux-watchdog

On 17/11/2022 14:23, Andrew Lunn wrote:
>>  allOf:
>> -  - $ref: "dma-common.yaml#"
>> +  - $ref: dma-common.yaml#
>>  
>>  
>>  allOf:
>> -  - $ref: "dma-common.yaml#"
>> +  - $ref: dma-common.yaml#
> 
> Looks like some other automated change made its way into this patch.

I forgot to mention in commit msg, but maybe better to drop it to reduce
noise.

Best regards,
Krzysztof


^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 12:38 ` [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Krzysztof Kozlowski
  2022-11-17 13:23   ` Andrew Lunn
  2022-11-17 14:33   ` Guenter Roeck
@ 2022-11-17 15:17   ` Jonathan Cameron
  2022-11-17 17:19   ` Rob Herring
                     ` (2 subsequent siblings)
  5 siblings, 0 replies; 26+ messages in thread
From: Jonathan Cameron @ 2022-11-17 15:17 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On Thu, 17 Nov 2022 13:38:42 +0100
Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> wrote:

> The Devicetree bindings document does not have to say in the title that
> it is a "binding", but instead just describe the hardware.  For shared
> (re-usable) schemas, name them all as "common properties".
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for IIO.

Looked briefly at the rest and only found the issue Andrew Lunn pointed out.
Otherwise all seem fine to me.

Jonathan


> ---
>  Documentation/devicetree/bindings/clock/qcom,gcc.yaml         | 2 +-
>  Documentation/devicetree/bindings/dma/dma-common.yaml         | 2 +-
>  Documentation/devicetree/bindings/dma/dma-controller.yaml     | 4 ++--
>  Documentation/devicetree/bindings/dma/dma-router.yaml         | 4 ++--
>  Documentation/devicetree/bindings/iio/adc/adc.yaml            | 2 +-
>  .../devicetree/bindings/media/video-interface-devices.yaml    | 2 +-
>  Documentation/devicetree/bindings/media/video-interfaces.yaml | 2 +-
>  Documentation/devicetree/bindings/mmc/mmc-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/mtd/nand-chip.yaml          | 2 +-
>  Documentation/devicetree/bindings/mtd/nand-controller.yaml    | 2 +-
>  .../bindings/net/bluetooth/bluetooth-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/can/can-controller.yaml | 2 +-
>  .../devicetree/bindings/net/ethernet-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/ethernet-phy.yaml       | 2 +-
>  Documentation/devicetree/bindings/net/mdio.yaml               | 2 +-
>  Documentation/devicetree/bindings/opp/opp-v2-base.yaml        | 2 +-
>  .../devicetree/bindings/power/reset/restart-handler.yaml      | 2 +-
>  Documentation/devicetree/bindings/rtc/rtc.yaml                | 2 +-
>  .../devicetree/bindings/soundwire/soundwire-controller.yaml   | 2 +-
>  Documentation/devicetree/bindings/spi/spi-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/watchdog/watchdog.yaml      | 2 +-
>  21 files changed, 23 insertions(+), 23 deletions(-)
> 
> diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> index 1ab416c83c8d..d2de3d128b73 100644
> --- a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> +++ b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/clock/qcom,gcc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Qualcomm Global Clock & Reset Controller Common Bindings
> +title: Qualcomm Global Clock & Reset Controller common parts
>  
>  maintainers:
>    - Stephen Boyd <sboyd@kernel.org>
> diff --git a/Documentation/devicetree/bindings/dma/dma-common.yaml b/Documentation/devicetree/bindings/dma/dma-common.yaml
> index ad06d36af208..9b7b94fdbb0b 100644
> --- a/Documentation/devicetree/bindings/dma/dma-common.yaml
> +++ b/Documentation/devicetree/bindings/dma/dma-common.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/dma/dma-common.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: DMA Engine Generic Binding
> +title: DMA Engine common properties
>  
>  maintainers:
>    - Vinod Koul <vkoul@kernel.org>
> diff --git a/Documentation/devicetree/bindings/dma/dma-controller.yaml b/Documentation/devicetree/bindings/dma/dma-controller.yaml
> index 6d3727267fa8..225a141c7b5c 100644
> --- a/Documentation/devicetree/bindings/dma/dma-controller.yaml
> +++ b/Documentation/devicetree/bindings/dma/dma-controller.yaml
> @@ -4,13 +4,13 @@
>  $id: http://devicetree.org/schemas/dma/dma-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: DMA Controller Generic Binding
> +title: DMA Controller common properties
>  
>  maintainers:
>    - Vinod Koul <vkoul@kernel.org>
>  
>  allOf:
> -  - $ref: "dma-common.yaml#"
> +  - $ref: dma-common.yaml#
>  
>  # Everything else is described in the common file
>  properties:
> diff --git a/Documentation/devicetree/bindings/dma/dma-router.yaml b/Documentation/devicetree/bindings/dma/dma-router.yaml
> index 4b817f5dc30e..0ebd7bc6232b 100644
> --- a/Documentation/devicetree/bindings/dma/dma-router.yaml
> +++ b/Documentation/devicetree/bindings/dma/dma-router.yaml
> @@ -4,13 +4,13 @@
>  $id: http://devicetree.org/schemas/dma/dma-router.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: DMA Router Generic Binding
> +title: DMA Router common properties
>  
>  maintainers:
>    - Vinod Koul <vkoul@kernel.org>
>  
>  allOf:
> -  - $ref: "dma-common.yaml#"
> +  - $ref: dma-common.yaml#
>  
>  description:
>    DMA routers are transparent IP blocks used to route DMA request
> diff --git a/Documentation/devicetree/bindings/iio/adc/adc.yaml b/Documentation/devicetree/bindings/iio/adc/adc.yaml
> index db348fcbb52c..bd0f5fae256e 100644
> --- a/Documentation/devicetree/bindings/iio/adc/adc.yaml
> +++ b/Documentation/devicetree/bindings/iio/adc/adc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/iio/adc/adc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Generic IIO bindings for ADC channels
> +title: IIO common properties for ADC channels
>  
>  maintainers:
>    - Jonathan Cameron <jic23@kernel.org>
> diff --git a/Documentation/devicetree/bindings/media/video-interface-devices.yaml b/Documentation/devicetree/bindings/media/video-interface-devices.yaml
> index 4527f56a5a6e..bd719cb1813e 100644
> --- a/Documentation/devicetree/bindings/media/video-interface-devices.yaml
> +++ b/Documentation/devicetree/bindings/media/video-interface-devices.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/media/video-interface-devices.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Common bindings for video receiver and transmitter devices
> +title: Common properties for video receiver and transmitter devices
>  
>  maintainers:
>    - Jacopo Mondi <jacopo@jmondi.org>
> diff --git a/Documentation/devicetree/bindings/media/video-interfaces.yaml b/Documentation/devicetree/bindings/media/video-interfaces.yaml
> index 68c3b9871cf3..e8cf73794772 100644
> --- a/Documentation/devicetree/bindings/media/video-interfaces.yaml
> +++ b/Documentation/devicetree/bindings/media/video-interfaces.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/media/video-interfaces.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Common bindings for video receiver and transmitter interface endpoints
> +title: Common properties for video receiver and transmitter interface endpoints
>  
>  maintainers:
>    - Sakari Ailus <sakari.ailus@linux.intel.com>
> diff --git a/Documentation/devicetree/bindings/mmc/mmc-controller.yaml b/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
> index 802e3ca8be4d..a17f49738abd 100644
> --- a/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
> +++ b/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mmc/mmc-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: MMC Controller Generic Binding
> +title: MMC Controller common properties
>  
>  maintainers:
>    - Ulf Hansson <ulf.hansson@linaro.org>
> diff --git a/Documentation/devicetree/bindings/mtd/nand-chip.yaml b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> index 97ac3a3fbb52..20b195ef9b70 100644
> --- a/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> +++ b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mtd/nand-chip.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NAND Chip and NAND Controller Generic Binding
> +title: NAND Chip and NAND Controller common properties
>  
>  maintainers:
>    - Miquel Raynal <miquel.raynal@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/mtd/nand-controller.yaml b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> index 359a015d4e5a..a004efc42842 100644
> --- a/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> +++ b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mtd/nand-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NAND Chip and NAND Controller Generic Binding
> +title: NAND Chip and NAND Controller common properties
>  
>  maintainers:
>    - Miquel Raynal <miquel.raynal@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml b/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
> index 9309dc40f54f..8715adff5eaf 100644
> --- a/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
> +++ b/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/bluetooth/bluetooth-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Bluetooth Controller Generic Binding
> +title: Bluetooth Controller common properties
>  
>  maintainers:
>    - Marcel Holtmann <marcel@holtmann.org>
> diff --git a/Documentation/devicetree/bindings/net/can/can-controller.yaml b/Documentation/devicetree/bindings/net/can/can-controller.yaml
> index 1f0e98051074..3747b46cf9b6 100644
> --- a/Documentation/devicetree/bindings/net/can/can-controller.yaml
> +++ b/Documentation/devicetree/bindings/net/can/can-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/can/can-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: CAN Controller Generic Binding
> +title: CAN Controller common properties
>  
>  maintainers:
>    - Marc Kleine-Budde <mkl@pengutronix.de>
> diff --git a/Documentation/devicetree/bindings/net/ethernet-controller.yaml b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
> index 3aef506fa158..26502c0f2aff 100644
> --- a/Documentation/devicetree/bindings/net/ethernet-controller.yaml
> +++ b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/ethernet-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ethernet Controller Generic Binding
> +title: Ethernet Controller common properties
>  
>  maintainers:
>    - David S. Miller <davem@davemloft.net>
> diff --git a/Documentation/devicetree/bindings/net/ethernet-phy.yaml b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> index ad808e9ce5b9..0aa1b60e78cc 100644
> --- a/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> +++ b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/ethernet-phy.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ethernet PHY Generic Binding
> +title: Ethernet PHY common properties
>  
>  maintainers:
>    - Andrew Lunn <andrew@lunn.ch>
> diff --git a/Documentation/devicetree/bindings/net/mdio.yaml b/Documentation/devicetree/bindings/net/mdio.yaml
> index b5706d4e7e38..b184689dd6b2 100644
> --- a/Documentation/devicetree/bindings/net/mdio.yaml
> +++ b/Documentation/devicetree/bindings/net/mdio.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/mdio.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: MDIO Bus Generic Binding
> +title: MDIO Bus common properties
>  
>  maintainers:
>    - Andrew Lunn <andrew@lunn.ch>
> diff --git a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> index cf9c2f7bddc2..20ac432dc683 100644
> --- a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> +++ b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/opp/opp-v2-base.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Generic OPP (Operating Performance Points) Common Binding
> +title: Generic OPP (Operating Performance Points) common parts
>  
>  maintainers:
>    - Viresh Kumar <viresh.kumar@linaro.org>
> diff --git a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
> index 1f9a2aac53c0..8b52fd156d4c 100644
> --- a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
> +++ b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/power/reset/restart-handler.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Restart and shutdown handler generic binding
> +title: Restart and shutdown handler common properties
>  
>  maintainers:
>    - Sebastian Reichel <sre@kernel.org>
> diff --git a/Documentation/devicetree/bindings/rtc/rtc.yaml b/Documentation/devicetree/bindings/rtc/rtc.yaml
> index 0ec3551f12dd..00848a5a409e 100644
> --- a/Documentation/devicetree/bindings/rtc/rtc.yaml
> +++ b/Documentation/devicetree/bindings/rtc/rtc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/rtc/rtc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: RTC Generic Binding
> +title: Real Time Clock common properties
>  
>  maintainers:
>    - Alexandre Belloni <alexandre.belloni@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml b/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
> index 4aad121eff3f..2176033850dc 100644
> --- a/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
> +++ b/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/soundwire/soundwire-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: SoundWire Controller Generic Binding
> +title: SoundWire Controller common properties
>  
>  maintainers:
>    - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
> diff --git a/Documentation/devicetree/bindings/spi/spi-controller.yaml b/Documentation/devicetree/bindings/spi/spi-controller.yaml
> index 01042a7f382e..6bbe073f894b 100644
> --- a/Documentation/devicetree/bindings/spi/spi-controller.yaml
> +++ b/Documentation/devicetree/bindings/spi/spi-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/spi/spi-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: SPI Controller Generic Binding
> +title: SPI Controller common properties
>  
>  maintainers:
>    - Mark Brown <broonie@kernel.org>
> diff --git a/Documentation/devicetree/bindings/watchdog/watchdog.yaml b/Documentation/devicetree/bindings/watchdog/watchdog.yaml
> index e3dfb02f0ca5..6875cf1c3159 100644
> --- a/Documentation/devicetree/bindings/watchdog/watchdog.yaml
> +++ b/Documentation/devicetree/bindings/watchdog/watchdog.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/watchdog/watchdog.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Watchdog Generic Bindings
> +title: Watchdog common properties
>  
>  maintainers:
>    - Guenter Roeck <linux@roeck-us.net>


^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 4/9] dt-bindings: drop redundant part of title (end)
  2022-11-17 12:38 ` [RFC PATCH 4/9] dt-bindings: drop redundant part of title (end) Krzysztof Kozlowski
@ 2022-11-17 15:18   ` Jonathan Cameron
  2022-11-17 15:37   ` Jonathan Cameron
  1 sibling, 0 replies; 26+ messages in thread
From: Jonathan Cameron @ 2022-11-17 15:18 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On Thu, 17 Nov 2022 13:38:45 +0100
Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> wrote:

> The Devicetree bindings document does not have to say in the title that
> it is a "Devicetree binding", but instead just describe the hardware.
> 
> Drop trailing "Devicetree bindings" in various forms (also with
> trailling full stop):
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [dD]evice[ -]\?[tT]ree [bB]indings\?\.\?$/title: \1/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [dD]evice[ -]\?[nN]ode [bB]indings\?\.\?$/title: \1/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [dD][tT] [bB]indings\?\.\?$/title: \1/' {} \;
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>

Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for iio
> ---
>  Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml          | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml    | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml    | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml    | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml     | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml      | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml      | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml         | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml         | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml         | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml    | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml  | 2 +-
>  .../devicetree/bindings/arm/firmware/linaro,optee-tz.yaml       | 2 +-
>  Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml  | 2 +-
>  Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml      | 2 +-
>  Documentation/devicetree/bindings/arm/marvell/armada-7k-8k.yaml | 2 +-
>  Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml            | 2 +-
>  Documentation/devicetree/bindings/arm/mstar/mstar.yaml          | 2 +-
>  Documentation/devicetree/bindings/arm/npcm/npcm.yaml            | 2 +-
>  Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml          | 2 +-
>  Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml   | 2 +-
>  Documentation/devicetree/bindings/arm/socionext/uniphier.yaml   | 2 +-
>  Documentation/devicetree/bindings/arm/sprd/sprd.yaml            | 2 +-
>  Documentation/devicetree/bindings/arm/stm32/stm32.yaml          | 2 +-
>  .../bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml       | 2 +-
>  .../devicetree/bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml | 2 +-
>  .../bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml         | 2 +-
>  Documentation/devicetree/bindings/arm/ti/k3.yaml                | 2 +-
>  Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml        | 2 +-
>  Documentation/devicetree/bindings/clock/ingenic,cgu.yaml        | 2 +-
>  .../devicetree/bindings/clock/renesas,versaclock7.yaml          | 2 +-
>  Documentation/devicetree/bindings/display/bridge/anx6345.yaml   | 2 +-
>  .../devicetree/bindings/display/bridge/chrontel,ch7033.yaml     | 2 +-
>  .../devicetree/bindings/display/bridge/ite,it6505.yaml          | 2 +-
>  .../devicetree/bindings/display/bridge/ite,it66121.yaml         | 2 +-
>  Documentation/devicetree/bindings/display/bridge/ps8640.yaml    | 2 +-
>  Documentation/devicetree/bindings/display/ingenic,ipu.yaml      | 2 +-
>  Documentation/devicetree/bindings/display/ingenic,lcd.yaml      | 2 +-
>  .../devicetree/bindings/display/mediatek/mediatek,cec.yaml      | 2 +-
>  .../devicetree/bindings/display/mediatek/mediatek,dsi.yaml      | 2 +-
>  .../devicetree/bindings/display/mediatek/mediatek,hdmi-ddc.yaml | 2 +-
>  .../devicetree/bindings/display/mediatek/mediatek,hdmi.yaml     | 2 +-
>  .../devicetree/bindings/display/panel/ilitek,ili9163.yaml       | 2 +-
>  Documentation/devicetree/bindings/display/panel/panel-lvds.yaml | 2 +-
>  .../devicetree/bindings/display/panel/visionox,rm69299.yaml     | 2 +-
>  Documentation/devicetree/bindings/dma/ingenic,dma.yaml          | 2 +-
>  Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml          | 2 +-
>  Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml         | 2 +-
>  Documentation/devicetree/bindings/dma/ti/k3-udma.yaml           | 2 +-
>  .../devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml       | 2 +-
>  Documentation/devicetree/bindings/eeprom/microchip,93lc46b.yaml | 2 +-
>  Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml          | 2 +-
>  .../devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml    | 2 +-
>  Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml  | 2 +-
>  .../devicetree/bindings/input/pine64,pinephone-keyboard.yaml    | 2 +-
>  .../devicetree/bindings/input/touchscreen/chipone,icn8318.yaml  | 2 +-
>  .../devicetree/bindings/input/touchscreen/pixcir,pixcir_ts.yaml | 2 +-
>  .../devicetree/bindings/input/touchscreen/silead,gsl1680.yaml   | 2 +-
>  .../devicetree/bindings/interrupt-controller/ingenic,intc.yaml  | 2 +-
>  .../bindings/interrupt-controller/realtek,rtl-intc.yaml         | 2 +-
>  .../devicetree/bindings/media/i2c/dongwoon,dw9768.yaml          | 2 +-
>  Documentation/devicetree/bindings/media/i2c/ov8856.yaml         | 2 +-
>  Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml   | 2 +-
>  Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml    | 2 +-
>  Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml    | 2 +-
>  Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml    | 2 +-
>  Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml   | 2 +-
>  .../bindings/memory-controllers/ingenic,nemc-peripherals.yaml   | 2 +-
>  .../devicetree/bindings/memory-controllers/ingenic,nemc.yaml    | 2 +-
>  .../devicetree/bindings/memory-controllers/ti,gpmc.yaml         | 2 +-
>  Documentation/devicetree/bindings/mips/ingenic/devices.yaml     | 2 +-
>  .../devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml        | 2 +-
>  Documentation/devicetree/bindings/mips/loongson/devices.yaml    | 2 +-
>  Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml          | 2 +-
>  Documentation/devicetree/bindings/mtd/ingenic,nand.yaml         | 2 +-
>  .../devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml    | 2 +-
>  Documentation/devicetree/bindings/net/can/bosch,c_can.yaml      | 2 +-
>  Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml     | 2 +-
>  Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml    | 2 +-
>  Documentation/devicetree/bindings/net/dsa/dsa-port.yaml         | 2 +-
>  Documentation/devicetree/bindings/net/dsa/dsa.yaml              | 2 +-
>  .../devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml       | 2 +-
>  Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml      | 2 +-
>  Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml      | 2 +-
>  Documentation/devicetree/bindings/net/wireless/esp,esp8089.yaml | 2 +-
>  .../devicetree/bindings/net/wireless/microchip,wilc1000.yaml    | 2 +-
>  Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml  | 2 +-
>  Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml     | 2 +-
>  Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml      | 2 +-
>  Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml  | 2 +-
>  .../devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml      | 2 +-
>  .../devicetree/bindings/power/supply/maxim,ds2760.yaml          | 2 +-
>  .../devicetree/bindings/power/supply/maxim,max14656.yaml        | 2 +-
>  Documentation/devicetree/bindings/rtc/epson,rx8900.yaml         | 2 +-
>  Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml          | 2 +-
>  Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml     | 2 +-
>  Documentation/devicetree/bindings/serial/brcm,bcm7271-uart.yaml | 2 +-
>  Documentation/devicetree/bindings/serial/ingenic,uart.yaml      | 2 +-
>  Documentation/devicetree/bindings/serial/serial.yaml            | 2 +-
>  Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml     | 2 +-
>  Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml     | 2 +-
>  Documentation/devicetree/bindings/sound/ingenic,aic.yaml        | 2 +-
>  Documentation/devicetree/bindings/sound/ingenic,codec.yaml      | 2 +-
>  .../devicetree/bindings/sound/qcom,lpass-rx-macro.yaml          | 2 +-
>  .../devicetree/bindings/sound/qcom,lpass-tx-macro.yaml          | 2 +-
>  .../devicetree/bindings/sound/qcom,lpass-va-macro.yaml          | 2 +-
>  .../devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml         | 2 +-
>  Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml    | 2 +-
>  Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml    | 2 +-
>  Documentation/devicetree/bindings/sound/ti,src4xxx.yaml         | 2 +-
>  Documentation/devicetree/bindings/spi/ingenic,spi.yaml          | 2 +-
>  Documentation/devicetree/bindings/spi/spi-gpio.yaml             | 2 +-
>  Documentation/devicetree/bindings/timer/ingenic,tcu.yaml        | 2 +-
>  Documentation/devicetree/bindings/usb/ingenic,musb.yaml         | 2 +-
>  Documentation/devicetree/bindings/usb/maxim,max33359.yaml       | 2 +-
>  Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml | 2 +-
>  Documentation/devicetree/bindings/usb/ti,tps6598x.yaml          | 2 +-
>  Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml    | 2 +-
>  118 files changed, 118 insertions(+), 118 deletions(-)
> 
> diff --git a/Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml b/Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml
> index 8051a75c2c79..162a39dab218 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/bcm2835.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom BCM2711/BCM2835 Platforms Device Tree Bindings
> +title: Broadcom BCM2711/BCM2835 Platforms
>  
>  maintainers:
>    - Eric Anholt <eric@anholt.net>
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml
> index c60324357435..f2bcac0096b7 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,bcm11351.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom BCM11351 device tree bindings
> +title: Broadcom BCM11351
>  
>  maintainers:
>    - Florian Fainelli <f.fainelli@gmail.com>
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml
> index b3020757380f..cf4e254e32f1 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,bcm21664.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom BCM21664 device tree bindings
> +title: Broadcom BCM21664
>  
>  maintainers:
>    - Florian Fainelli <f.fainelli@gmail.com>
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml
> index 37f3a6fcde76..eafec29ba7ab 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,bcm23550.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom BCM23550 device tree bindings
> +title: Broadcom BCM23550
>  
>  maintainers:
>    - Florian Fainelli <f.fainelli@gmail.com>
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml
> index 52b575c40599..454b0e93245d 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,bcm4708.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom BCM4708 device tree bindings
> +title: Broadcom BCM4708
>  
>  description:
>    Broadcom BCM4708/47081/4709/47094/53012 Wi-Fi/network SoCs based
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml
> index 84866e29cab0..07892cbdd23c 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,bcmbca.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom Broadband SoC device tree bindings
> +title: Broadcom Broadband SoC
>  
>  description:
>    Broadcom Broadband SoCs include family of high performance DSL/PON/Wireless
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml
> index 432ccf990f9e..a0a3f32db54e 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,cygnus.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom Cygnus device tree bindings
> +title: Broadcom Cygnus
>  
>  maintainers:
>    - Ray Jui <rjui@broadcom.com>
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml
> index 294948399f82..cc6add0e933a 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,hr2.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom Hurricane 2 device tree bindings
> +title: Broadcom Hurricane 2
>  
>  description:
>    Broadcom Hurricane 2 family of SoCs are used for switching control. These SoCs
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml
> index c4847abbecd8..6696598eca0e 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,ns2.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom North Star 2 (NS2) device tree bindings
> +title: Broadcom North Star 2 (NS2)
>  
>  maintainers:
>    - Ray Jui <rjui@broadcom.com>
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml
> index 7d184ba7d180..a43b2d4d936b 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,nsp.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom Northstar Plus device tree bindings
> +title: Broadcom Northstar Plus
>  
>  description:
>    Broadcom Northstar Plus family of SoCs are used for switching control
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml
> index c638e04ebae0..c6ccb78aab0a 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,stingray.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom Stingray device tree bindings
> +title: Broadcom Stingray
>  
>  maintainers:
>    - Ray Jui <rjui@broadcom.com>
> diff --git a/Documentation/devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml b/Documentation/devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml
> index 4eba182abd53..3f441352fbf0 100644
> --- a/Documentation/devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml
> +++ b/Documentation/devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/bcm/brcm,vulcan-soc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom Vulcan device tree bindings
> +title: Broadcom Vulcan
>  
>  maintainers:
>    - Robert Richter <rrichter@marvell.com>
> diff --git a/Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.yaml b/Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.yaml
> index 9a426110a14a..d4dc0749f9fd 100644
> --- a/Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.yaml
> +++ b/Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/firmware/linaro,optee-tz.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: OP-TEE Device Tree Bindings
> +title: OP-TEE
>  
>  maintainers:
>    - Jens Wiklander <jens.wiklander@linaro.org>
> diff --git a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml
> index b38458022946..540876322040 100644
> --- a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml
> +++ b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/hisilicon/hisilicon.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Hisilicon Platforms Device Tree Bindings
> +title: Hisilicon Platforms
>  
>  maintainers:
>    - Wei Xu <xuwei5@hisilicon.com>
> diff --git a/Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml b/Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml
> index 34f5f877d444..91b96065f7df 100644
> --- a/Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml
> +++ b/Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/keystone/ti,sci.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: TI-SCI controller device node bindings
> +title: TI-SCI controller
>  
>  maintainers:
>    - Nishanth Menon <nm@ti.com>
> diff --git a/Documentation/devicetree/bindings/arm/marvell/armada-7k-8k.yaml b/Documentation/devicetree/bindings/arm/marvell/armada-7k-8k.yaml
> index e9bf3054529f..52d78521e412 100644
> --- a/Documentation/devicetree/bindings/arm/marvell/armada-7k-8k.yaml
> +++ b/Documentation/devicetree/bindings/arm/marvell/armada-7k-8k.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/marvell/armada-7k-8k.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Marvell Armada 7K/8K Platforms Device Tree Bindings
> +title: Marvell Armada 7K/8K Platforms
>  
>  maintainers:
>    - Gregory CLEMENT <gregory.clement@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml b/Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml
> index d58116136154..4c43eaf3632e 100644
> --- a/Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml
> +++ b/Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/mrvl/mrvl.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Marvell Platforms Device Tree Bindings
> +title: Marvell Platforms
>  
>  maintainers:
>    - Lubomir Rintel <lkundrak@v3.sk>
> diff --git a/Documentation/devicetree/bindings/arm/mstar/mstar.yaml b/Documentation/devicetree/bindings/arm/mstar/mstar.yaml
> index 8892eb6bd3ef..937059fcc7b3 100644
> --- a/Documentation/devicetree/bindings/arm/mstar/mstar.yaml
> +++ b/Documentation/devicetree/bindings/arm/mstar/mstar.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/mstar/mstar.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: MStar platforms device tree bindings
> +title: MStar platforms
>  
>  maintainers:
>    - Daniel Palmer <daniel@thingy.jp>
> diff --git a/Documentation/devicetree/bindings/arm/npcm/npcm.yaml b/Documentation/devicetree/bindings/arm/npcm/npcm.yaml
> index 43409e5721d5..6871483947c5 100644
> --- a/Documentation/devicetree/bindings/arm/npcm/npcm.yaml
> +++ b/Documentation/devicetree/bindings/arm/npcm/npcm.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/npcm/npcm.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NPCM Platforms Device Tree Bindings
> +title: NPCM Platforms
>  
>  maintainers:
>    - Jonathan Neuschäfer <j.neuschaefer@gmx.net>
> diff --git a/Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml b/Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml
> index 214c97bc3063..f1bd6f50e726 100644
> --- a/Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml
> +++ b/Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/nxp/lpc32xx.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NXP LPC32xx Platforms Device Tree Bindings
> +title: NXP LPC32xx Platforms
>  
>  maintainers:
>    - Roland Stigge <stigge@antcom.de>
> diff --git a/Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml b/Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml
> index aa1d4afbc510..5a428a885760 100644
> --- a/Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml
> +++ b/Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/socionext/milbeaut.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Milbeaut platforms device tree bindings
> +title: Milbeaut platforms
>  
>  maintainers:
>    - Taichi Sugaya <sugaya.taichi@socionext.com>
> diff --git a/Documentation/devicetree/bindings/arm/socionext/uniphier.yaml b/Documentation/devicetree/bindings/arm/socionext/uniphier.yaml
> index 8c0e91658474..a141da880469 100644
> --- a/Documentation/devicetree/bindings/arm/socionext/uniphier.yaml
> +++ b/Documentation/devicetree/bindings/arm/socionext/uniphier.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/socionext/uniphier.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Socionext UniPhier platform device tree bindings
> +title: Socionext UniPhier platform
>  
>  maintainers:
>    - Masahiro Yamada <yamada.masahiro@socionext.com>
> diff --git a/Documentation/devicetree/bindings/arm/sprd/sprd.yaml b/Documentation/devicetree/bindings/arm/sprd/sprd.yaml
> index 2c12e571394b..eaa67b8e0d6c 100644
> --- a/Documentation/devicetree/bindings/arm/sprd/sprd.yaml
> +++ b/Documentation/devicetree/bindings/arm/sprd/sprd.yaml
> @@ -5,7 +5,7 @@
>  $id: http://devicetree.org/schemas/arm/sprd/sprd.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Unisoc platforms device tree bindings
> +title: Unisoc platforms
>  
>  maintainers:
>    - Orson Zhai <orsonzhai@gmail.com>
> diff --git a/Documentation/devicetree/bindings/arm/stm32/stm32.yaml b/Documentation/devicetree/bindings/arm/stm32/stm32.yaml
> index 44f5c5855af8..13e34241145b 100644
> --- a/Documentation/devicetree/bindings/arm/stm32/stm32.yaml
> +++ b/Documentation/devicetree/bindings/arm/stm32/stm32.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/stm32/stm32.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: STMicroelectronics STM32 Platforms Device Tree Bindings
> +title: STMicroelectronics STM32 Platforms
>  
>  maintainers:
>    - Alexandre Torgue <alexandre.torgue@foss.st.com>
> diff --git a/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml b/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml
> index f3878e0b3cc4..d805c4508b4e 100644
> --- a/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml
> +++ b/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Allwinner CPU Configuration Controller Device Tree Bindings
> +title: Allwinner CPU Configuration Controller
>  
>  maintainers:
>    - Chen-Yu Tsai <wens@csie.org>
> diff --git a/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml b/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml
> index 668aadbfe4c0..644f391afb32 100644
> --- a/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml
> +++ b/Documentation/devicetree/bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/sunxi/allwinner,sun9i-a80-prcm.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Allwinner A80 PRCM Device Tree Bindings
> +title: Allwinner A80 PRCM
>  
>  maintainers:
>    - Chen-Yu Tsai <wens@csie.org>
> diff --git a/Documentation/devicetree/bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml b/Documentation/devicetree/bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml
> index 869c266e7ebc..6089a96eae4f 100644
> --- a/Documentation/devicetree/bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml
> +++ b/Documentation/devicetree/bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml
> @@ -4,7 +4,7 @@
>  $id: "http://devicetree.org/schemas/arm/tegra/nvidia,tegra-ccplex-cluster.yaml#"
>  $schema: "http://devicetree.org/meta-schemas/core.yaml#"
>  
> -title: NVIDIA Tegra CPU COMPLEX CLUSTER area device tree bindings
> +title: NVIDIA Tegra CPU COMPLEX CLUSTER area
>  
>  maintainers:
>    - Sumit Gupta <sumitg@nvidia.com>
> diff --git a/Documentation/devicetree/bindings/arm/ti/k3.yaml b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> index 28b8232e1c5b..49718804fd43 100644
> --- a/Documentation/devicetree/bindings/arm/ti/k3.yaml
> +++ b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/ti/k3.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Texas Instruments K3 Multicore SoC architecture device tree bindings
> +title: Texas Instruments K3 Multicore SoC architecture
>  
>  maintainers:
>    - Nishanth Menon <nm@ti.com>
> diff --git a/Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml b/Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml
> index c022d325fc08..1656d1a4476f 100644
> --- a/Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml
> +++ b/Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/arm/ti/ti,davinci.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Texas Instruments DaVinci Platforms Device Tree Bindings
> +title: Texas Instruments DaVinci Platforms
>  
>  maintainers:
>    - Sekhar Nori <nsekhar@ti.com>
> diff --git a/Documentation/devicetree/bindings/clock/ingenic,cgu.yaml b/Documentation/devicetree/bindings/clock/ingenic,cgu.yaml
> index df256ebcd366..9e733b10c392 100644
> --- a/Documentation/devicetree/bindings/clock/ingenic,cgu.yaml
> +++ b/Documentation/devicetree/bindings/clock/ingenic,cgu.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/clock/ingenic,cgu.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs CGU devicetree bindings
> +title: Ingenic SoCs CGU
>  
>  description: |
>    The CGU in an Ingenic SoC provides all the clocks generated on-chip. It
> diff --git a/Documentation/devicetree/bindings/clock/renesas,versaclock7.yaml b/Documentation/devicetree/bindings/clock/renesas,versaclock7.yaml
> index 8d4eb4475fc8..b339f1f9f072 100644
> --- a/Documentation/devicetree/bindings/clock/renesas,versaclock7.yaml
> +++ b/Documentation/devicetree/bindings/clock/renesas,versaclock7.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/clock/renesas,versaclock7.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Renesas Versaclock7 Programmable Clock Device Tree Bindings
> +title: Renesas Versaclock7 Programmable Clock
>  
>  maintainers:
>    - Alex Helms <alexander.helms.jy@renesas.com>
> diff --git a/Documentation/devicetree/bindings/display/bridge/anx6345.yaml b/Documentation/devicetree/bindings/display/bridge/anx6345.yaml
> index 1c0406c38fe5..9bf2cbcea69f 100644
> --- a/Documentation/devicetree/bindings/display/bridge/anx6345.yaml
> +++ b/Documentation/devicetree/bindings/display/bridge/anx6345.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/bridge/anx6345.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Analogix ANX6345 eDP Transmitter Device Tree Bindings
> +title: Analogix ANX6345 eDP Transmitter
>  
>  maintainers:
>    - Torsten Duwe <duwe@lst.de>
> diff --git a/Documentation/devicetree/bindings/display/bridge/chrontel,ch7033.yaml b/Documentation/devicetree/bindings/display/bridge/chrontel,ch7033.yaml
> index bb6289c7d375..b0589fa16736 100644
> --- a/Documentation/devicetree/bindings/display/bridge/chrontel,ch7033.yaml
> +++ b/Documentation/devicetree/bindings/display/bridge/chrontel,ch7033.yaml
> @@ -5,7 +5,7 @@
>  $id: http://devicetree.org/schemas/display/bridge/chrontel,ch7033.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Chrontel CH7033 Video Encoder Device Tree Bindings
> +title: Chrontel CH7033 Video Encoder
>  
>  maintainers:
>    - Lubomir Rintel <lkundrak@v3.sk>
> diff --git a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> index 833d11b2303a..b697c42399ea 100644
> --- a/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> +++ b/Documentation/devicetree/bindings/display/bridge/ite,it6505.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/bridge/ite,it6505.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: ITE it6505 Device Tree Bindings
> +title: ITE it6505
>  
>  maintainers:
>    - Allen Chen <allen.chen@ite.com.tw>
> diff --git a/Documentation/devicetree/bindings/display/bridge/ite,it66121.yaml b/Documentation/devicetree/bindings/display/bridge/ite,it66121.yaml
> index 1b2185be92cd..d3454da1247a 100644
> --- a/Documentation/devicetree/bindings/display/bridge/ite,it66121.yaml
> +++ b/Documentation/devicetree/bindings/display/bridge/ite,it66121.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/bridge/ite,it66121.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: ITE it66121 HDMI bridge Device Tree Bindings
> +title: ITE it66121 HDMI bridge
>  
>  maintainers:
>    - Phong LE <ple@baylibre.com>
> diff --git a/Documentation/devicetree/bindings/display/bridge/ps8640.yaml b/Documentation/devicetree/bindings/display/bridge/ps8640.yaml
> index 8ab156e0a8cf..28811aff2c5a 100644
> --- a/Documentation/devicetree/bindings/display/bridge/ps8640.yaml
> +++ b/Documentation/devicetree/bindings/display/bridge/ps8640.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/bridge/ps8640.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: MIPI DSI to eDP Video Format Converter Device Tree Bindings
> +title: MIPI DSI to eDP Video Format Converter
>  
>  maintainers:
>    - Nicolas Boichat <drinkcat@chromium.org>
> diff --git a/Documentation/devicetree/bindings/display/ingenic,ipu.yaml b/Documentation/devicetree/bindings/display/ingenic,ipu.yaml
> index 3f93def2c5a2..319bd7c88fe3 100644
> --- a/Documentation/devicetree/bindings/display/ingenic,ipu.yaml
> +++ b/Documentation/devicetree/bindings/display/ingenic,ipu.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/ingenic,ipu.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs Image Processing Unit (IPU) devicetree bindings
> +title: Ingenic SoCs Image Processing Unit (IPU)
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/display/ingenic,lcd.yaml b/Documentation/devicetree/bindings/display/ingenic,lcd.yaml
> index c0bb02fb49f4..6d4c00f3fcc8 100644
> --- a/Documentation/devicetree/bindings/display/ingenic,lcd.yaml
> +++ b/Documentation/devicetree/bindings/display/ingenic,lcd.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/ingenic,lcd.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs LCD controller devicetree bindings
> +title: Ingenic SoCs LCD controller
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/display/mediatek/mediatek,cec.yaml b/Documentation/devicetree/bindings/display/mediatek/mediatek,cec.yaml
> index 66288b9f0aa6..080cf321209e 100644
> --- a/Documentation/devicetree/bindings/display/mediatek/mediatek,cec.yaml
> +++ b/Documentation/devicetree/bindings/display/mediatek/mediatek,cec.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/mediatek/mediatek,cec.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Mediatek HDMI CEC Controller Device Tree Bindings
> +title: Mediatek HDMI CEC Controller
>  
>  maintainers:
>    - CK Hu <ck.hu@mediatek.com>
> diff --git a/Documentation/devicetree/bindings/display/mediatek/mediatek,dsi.yaml b/Documentation/devicetree/bindings/display/mediatek/mediatek,dsi.yaml
> index b18d6a57c6e1..4707b60238b0 100644
> --- a/Documentation/devicetree/bindings/display/mediatek/mediatek,dsi.yaml
> +++ b/Documentation/devicetree/bindings/display/mediatek/mediatek,dsi.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/mediatek/mediatek,dsi.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: MediaTek DSI Controller Device Tree Bindings
> +title: MediaTek DSI Controller
>  
>  maintainers:
>    - Chun-Kuang Hu <chunkuang.hu@kernel.org>
> diff --git a/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi-ddc.yaml b/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi-ddc.yaml
> index b6fcdfb99ab2..bd8f7b8ae0ff 100644
> --- a/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi-ddc.yaml
> +++ b/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi-ddc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/mediatek/mediatek,hdmi-ddc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Mediatek HDMI DDC Device Tree Bindings
> +title: Mediatek HDMI DDC
>  
>  maintainers:
>    - CK Hu <ck.hu@mediatek.com>
> diff --git a/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi.yaml b/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi.yaml
> index bdaf0b51e68c..8afdd67d6780 100644
> --- a/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi.yaml
> +++ b/Documentation/devicetree/bindings/display/mediatek/mediatek,hdmi.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/mediatek/mediatek,hdmi.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Mediatek HDMI Encoder Device Tree Bindings
> +title: Mediatek HDMI Encoder
>  
>  maintainers:
>    - CK Hu <ck.hu@mediatek.com>
> diff --git a/Documentation/devicetree/bindings/display/panel/ilitek,ili9163.yaml b/Documentation/devicetree/bindings/display/panel/ilitek,ili9163.yaml
> index a4154b51043e..90e323e19edb 100644
> --- a/Documentation/devicetree/bindings/display/panel/ilitek,ili9163.yaml
> +++ b/Documentation/devicetree/bindings/display/panel/ilitek,ili9163.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/panel/ilitek,ili9163.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ilitek ILI9163 display panels device tree bindings
> +title: Ilitek ILI9163 display panels
>  
>  maintainers:
>    - Daniel Mack <daniel@zonque.org>
> diff --git a/Documentation/devicetree/bindings/display/panel/panel-lvds.yaml b/Documentation/devicetree/bindings/display/panel/panel-lvds.yaml
> index fcc50db6a812..c77ee034310a 100644
> --- a/Documentation/devicetree/bindings/display/panel/panel-lvds.yaml
> +++ b/Documentation/devicetree/bindings/display/panel/panel-lvds.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/panel/panel-lvds.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Generic LVDS Display Panel Device Tree Bindings
> +title: Generic LVDS Display Panel
>  
>  maintainers:
>    - Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
> diff --git a/Documentation/devicetree/bindings/display/panel/visionox,rm69299.yaml b/Documentation/devicetree/bindings/display/panel/visionox,rm69299.yaml
> index 076b057b4af5..481ef051df1e 100644
> --- a/Documentation/devicetree/bindings/display/panel/visionox,rm69299.yaml
> +++ b/Documentation/devicetree/bindings/display/panel/visionox,rm69299.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/display/panel/visionox,rm69299.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Visionox model RM69299 Panels Device Tree Bindings.
> +title: Visionox model RM69299 Panels
>  
>  maintainers:
>    - Harigovindan P <harigovi@codeaurora.org>
> diff --git a/Documentation/devicetree/bindings/dma/ingenic,dma.yaml b/Documentation/devicetree/bindings/dma/ingenic,dma.yaml
> index e42b8ce948db..fd5b0a8eaed8 100644
> --- a/Documentation/devicetree/bindings/dma/ingenic,dma.yaml
> +++ b/Documentation/devicetree/bindings/dma/ingenic,dma.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/dma/ingenic,dma.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs DMA Controller DT bindings
> +title: Ingenic SoCs DMA Controller
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml b/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml
> index 08627d91e607..a702d2c2ff8d 100644
> --- a/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml
> +++ b/Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml
> @@ -6,7 +6,7 @@
>  $id: http://devicetree.org/schemas/dma/ti/k3-bcdma.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Texas Instruments K3 DMSS BCDMA Device Tree Bindings
> +title: Texas Instruments K3 DMSS BCDMA
>  
>  maintainers:
>    - Peter Ujfalusi <peter.ujfalusi@gmail.com>
> diff --git a/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml b/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml
> index 507d16d84ade..a69f62f854d8 100644
> --- a/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml
> +++ b/Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml
> @@ -6,7 +6,7 @@
>  $id: http://devicetree.org/schemas/dma/ti/k3-pktdma.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Texas Instruments K3 DMSS PKTDMA Device Tree Bindings
> +title: Texas Instruments K3 DMSS PKTDMA
>  
>  maintainers:
>    - Peter Ujfalusi <peter.ujfalusi@gmail.com>
> diff --git a/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml b/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml
> index 6a09bbf83d46..7ff428ad3aae 100644
> --- a/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml
> +++ b/Documentation/devicetree/bindings/dma/ti/k3-udma.yaml
> @@ -6,7 +6,7 @@
>  $id: http://devicetree.org/schemas/dma/ti/k3-udma.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Texas Instruments K3 NAVSS Unified DMA Device Tree Bindings
> +title: Texas Instruments K3 NAVSS Unified DMA
>  
>  maintainers:
>    - Peter Ujfalusi <peter.ujfalusi@gmail.com>
> diff --git a/Documentation/devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml b/Documentation/devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml
> index 2a595b18ff6c..825294e3f0e8 100644
> --- a/Documentation/devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml
> +++ b/Documentation/devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/dma/xilinx/xlnx,zynqmp-dpdma.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Xilinx ZynqMP DisplayPort DMA Controller Device Tree Bindings
> +title: Xilinx ZynqMP DisplayPort DMA Controller
>  
>  description: |
>    These bindings describe the DMA engine included in the Xilinx ZynqMP
> diff --git a/Documentation/devicetree/bindings/eeprom/microchip,93lc46b.yaml b/Documentation/devicetree/bindings/eeprom/microchip,93lc46b.yaml
> index 0c2f5ddb79c5..5476bed79f16 100644
> --- a/Documentation/devicetree/bindings/eeprom/microchip,93lc46b.yaml
> +++ b/Documentation/devicetree/bindings/eeprom/microchip,93lc46b.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/eeprom/microchip,93lc46b.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Microchip 93xx46 SPI compatible EEPROM family dt bindings
> +title: Microchip 93xx46 SPI compatible EEPROM family
>  
>  maintainers:
>    - Cory Tusar <cory.tusar@pid1solutions.com>
> diff --git a/Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml b/Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml
> index af6d64a6da6e..b61fdc9548d8 100644
> --- a/Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml
> +++ b/Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/i2c/ingenic,i2c.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs I2C controller devicetree bindings
> +title: Ingenic SoCs I2C controller
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml b/Documentation/devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml
> index 15c514b83583..a73a355fc665 100644
> --- a/Documentation/devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml
> +++ b/Documentation/devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/iio/adc/allwinner,sun8i-a33-ths.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Allwinner A33 Thermal Sensor Device Tree Bindings
> +title: Allwinner A33 Thermal Sensor
>  
>  maintainers:
>    - Chen-Yu Tsai <wens@csie.org>
> diff --git a/Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml b/Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml
> index 57a31356082e..720c16a108d4 100644
> --- a/Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml
> +++ b/Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/iio/adc/ti,palmas-gpadc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Palmas general purpose ADC IP block devicetree bindings
> +title: Palmas general purpose ADC IP block
>  
>  maintainers:
>    - Tony Lindgren <tony@atomide.com>
> diff --git a/Documentation/devicetree/bindings/input/pine64,pinephone-keyboard.yaml b/Documentation/devicetree/bindings/input/pine64,pinephone-keyboard.yaml
> index e4a0ac0fff9a..490f6c3d9e4b 100644
> --- a/Documentation/devicetree/bindings/input/pine64,pinephone-keyboard.yaml
> +++ b/Documentation/devicetree/bindings/input/pine64,pinephone-keyboard.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/input/pine64,pinephone-keyboard.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Pine64 PinePhone keyboard device tree bindings
> +title: Pine64 PinePhone keyboard
>  
>  maintainers:
>    - Samuel Holland <samuel@sholland.org>
> diff --git a/Documentation/devicetree/bindings/input/touchscreen/chipone,icn8318.yaml b/Documentation/devicetree/bindings/input/touchscreen/chipone,icn8318.yaml
> index 9df685bdc5db..74a8a01e0745 100644
> --- a/Documentation/devicetree/bindings/input/touchscreen/chipone,icn8318.yaml
> +++ b/Documentation/devicetree/bindings/input/touchscreen/chipone,icn8318.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/input/touchscreen/chipone,icn8318.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: ChipOne ICN8318 Touchscreen Controller Device Tree Bindings
> +title: ChipOne ICN8318 Touchscreen Controller
>  
>  maintainers:
>    - Dmitry Torokhov <dmitry.torokhov@gmail.com>
> diff --git a/Documentation/devicetree/bindings/input/touchscreen/pixcir,pixcir_ts.yaml b/Documentation/devicetree/bindings/input/touchscreen/pixcir,pixcir_ts.yaml
> index f9998edbff70..3305eda5ed88 100644
> --- a/Documentation/devicetree/bindings/input/touchscreen/pixcir,pixcir_ts.yaml
> +++ b/Documentation/devicetree/bindings/input/touchscreen/pixcir,pixcir_ts.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/input/touchscreen/pixcir,pixcir_ts.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Pixcir Touchscreen Controller Device Tree Bindings
> +title: Pixcir Touchscreen Controller
>  
>  maintainers:
>    - Dmitry Torokhov <dmitry.torokhov@gmail.com>
> diff --git a/Documentation/devicetree/bindings/input/touchscreen/silead,gsl1680.yaml b/Documentation/devicetree/bindings/input/touchscreen/silead,gsl1680.yaml
> index eec6f7f6f0a3..95b554be25b4 100644
> --- a/Documentation/devicetree/bindings/input/touchscreen/silead,gsl1680.yaml
> +++ b/Documentation/devicetree/bindings/input/touchscreen/silead,gsl1680.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/input/touchscreen/silead,gsl1680.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Silead GSL1680 Touchscreen Controller Device Tree Bindings
> +title: Silead GSL1680 Touchscreen Controller
>  
>  maintainers:
>    - Dmitry Torokhov <dmitry.torokhov@gmail.com>
> diff --git a/Documentation/devicetree/bindings/interrupt-controller/ingenic,intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/ingenic,intc.yaml
> index 0358a7739c8e..609308a5f91d 100644
> --- a/Documentation/devicetree/bindings/interrupt-controller/ingenic,intc.yaml
> +++ b/Documentation/devicetree/bindings/interrupt-controller/ingenic,intc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/interrupt-controller/ingenic,intc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs interrupt controller devicetree bindings
> +title: Ingenic SoCs interrupt controller
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/interrupt-controller/realtek,rtl-intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/realtek,rtl-intc.yaml
> index 13a893b18fb6..fb5593724059 100644
> --- a/Documentation/devicetree/bindings/interrupt-controller/realtek,rtl-intc.yaml
> +++ b/Documentation/devicetree/bindings/interrupt-controller/realtek,rtl-intc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/interrupt-controller/realtek,rtl-intc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Realtek RTL SoC interrupt controller devicetree bindings
> +title: Realtek RTL SoC interrupt controller
>  
>  description:
>    Interrupt controller and router for Realtek MIPS SoCs, allowing each SoC
> diff --git a/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9768.yaml b/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9768.yaml
> index 21864ab86ec4..82d3d18c16a1 100644
> --- a/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9768.yaml
> +++ b/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9768.yaml
> @@ -5,7 +5,7 @@
>  $id: http://devicetree.org/schemas/media/i2c/dongwoon,dw9768.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Dongwoon Anatech DW9768 Voice Coil Motor (VCM) Lens Device Tree Bindings
> +title: Dongwoon Anatech DW9768 Voice Coil Motor (VCM) Lens
>  
>  maintainers:
>    - Dongchun Zhu <dongchun.zhu@mediatek.com>
> diff --git a/Documentation/devicetree/bindings/media/i2c/ov8856.yaml b/Documentation/devicetree/bindings/media/i2c/ov8856.yaml
> index baf92aaaf049..e17288d57981 100644
> --- a/Documentation/devicetree/bindings/media/i2c/ov8856.yaml
> +++ b/Documentation/devicetree/bindings/media/i2c/ov8856.yaml
> @@ -5,7 +5,7 @@
>  $id: http://devicetree.org/schemas/media/i2c/ov8856.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Omnivision OV8856 CMOS Sensor Device Tree Bindings
> +title: Omnivision OV8856 CMOS Sensor
>  
>  maintainers:
>    - Dongchun Zhu <dongchun.zhu@mediatek.com>
> diff --git a/Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml b/Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml
> index 63a040944f3d..54df9d73dc86 100644
> --- a/Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml
> +++ b/Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml
> @@ -5,7 +5,7 @@
>  $id: http://devicetree.org/schemas/media/i2c/ovti,ov02a10.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Omnivision OV02A10 CMOS Sensor Device Tree Bindings
> +title: Omnivision OV02A10 CMOS Sensor
>  
>  maintainers:
>    - Dongchun Zhu <dongchun.zhu@mediatek.com>
> diff --git a/Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml b/Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml
> index 540fd69ac39f..a621032f9bd0 100644
> --- a/Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml
> +++ b/Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/media/i2c/ovti,ov5640.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: OmniVision OV5640 Image Sensor Device Tree Bindings
> +title: OmniVision OV5640 Image Sensor
>  
>  maintainers:
>    - Steve Longerbeam <slongerbeam@gmail.com>
> diff --git a/Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml b/Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml
> index 246dc5fec716..61e4e9cf8783 100644
> --- a/Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml
> +++ b/Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/media/i2c/ovti,ov5648.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: OmniVision OV5648 Image Sensor Device Tree Bindings
> +title: OmniVision OV5648 Image Sensor
>  
>  maintainers:
>    - Paul Kocialkowski <paul.kocialkowski@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml b/Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml
> index b962863e4f65..6bac326dceaf 100644
> --- a/Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml
> +++ b/Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/media/i2c/ovti,ov8865.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: OmniVision OV8865 Image Sensor Device Tree Bindings
> +title: OmniVision OV8865 Image Sensor
>  
>  maintainers:
>    - Paul Kocialkowski <paul.kocialkowski@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml b/Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml
> index 6597e1d0e65f..8c28848b226a 100644
> --- a/Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml
> +++ b/Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml
> @@ -5,7 +5,7 @@
>  $id: http://devicetree.org/schemas/media/i2c/st,st-vgxy61.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: STMicroelectronics VGxy61 HDR Global Shutter Sensor Family Device Tree Bindings
> +title: STMicroelectronics VGxy61 HDR Global Shutter Sensor Family
>  
>  maintainers:
>    - Benjamin Mugnier <benjamin.mugnier@foss.st.com>
> diff --git a/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc-peripherals.yaml b/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc-peripherals.yaml
> index b8ed52a44d57..89ebe3979012 100644
> --- a/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc-peripherals.yaml
> +++ b/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc-peripherals.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/memory-controllers/ingenic,nemc-peripherals.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs NAND / External Memory Controller (NEMC) devicetree bindings
> +title: Ingenic SoCs NAND / External Memory Controller (NEMC)
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc.yaml b/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc.yaml
> index dd13a5106d6c..a02724221ff3 100644
> --- a/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc.yaml
> +++ b/Documentation/devicetree/bindings/memory-controllers/ingenic,nemc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/memory-controllers/ingenic,nemc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs NAND / External Memory Controller (NEMC) devicetree bindings
> +title: Ingenic SoCs NAND / External Memory Controller (NEMC)
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/memory-controllers/ti,gpmc.yaml b/Documentation/devicetree/bindings/memory-controllers/ti,gpmc.yaml
> index e188a4bf755c..4f30173ad747 100644
> --- a/Documentation/devicetree/bindings/memory-controllers/ti,gpmc.yaml
> +++ b/Documentation/devicetree/bindings/memory-controllers/ti,gpmc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/memory-controllers/ti,gpmc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Texas Instruments GPMC Memory Controller device-tree bindings
> +title: Texas Instruments GPMC Memory Controller
>  
>  maintainers:
>    - Tony Lindgren <tony@atomide.com>
> diff --git a/Documentation/devicetree/bindings/mips/ingenic/devices.yaml b/Documentation/devicetree/bindings/mips/ingenic/devices.yaml
> index ee00d414df10..f2e822afe7fb 100644
> --- a/Documentation/devicetree/bindings/mips/ingenic/devices.yaml
> +++ b/Documentation/devicetree/bindings/mips/ingenic/devices.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mips/ingenic/devices.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic XBurst based Platforms Device Tree Bindings
> +title: Ingenic XBurst based Platforms
>  
>  maintainers:
>    - 周琰杰 (Zhou Yanjie) <zhouyanjie@wanyeetech.com>
> diff --git a/Documentation/devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml b/Documentation/devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml
> index 40130fefa2b4..15d41bdbdc26 100644
> --- a/Documentation/devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml
> +++ b/Documentation/devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mips/lantiq/lantiq,dma-xway.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Lantiq Xway SoCs DMA Controller DT bindings
> +title: Lantiq Xway SoCs DMA Controller
>  
>  maintainers:
>    - John Crispin <john@phrozen.org>
> diff --git a/Documentation/devicetree/bindings/mips/loongson/devices.yaml b/Documentation/devicetree/bindings/mips/loongson/devices.yaml
> index 9fee6708e6f5..f13ce386f42c 100644
> --- a/Documentation/devicetree/bindings/mips/loongson/devices.yaml
> +++ b/Documentation/devicetree/bindings/mips/loongson/devices.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mips/loongson/devices.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Loongson based Platforms Device Tree Bindings
> +title: Loongson based Platforms
>  
>  maintainers:
>    - Jiaxun Yang <jiaxun.yang@flygoat.com>
> diff --git a/Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml b/Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml
> index 2d10aedf2e00..bb4e0be0c893 100644
> --- a/Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml
> +++ b/Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mmc/ingenic,mmc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs MMC Controller DT bindings
> +title: Ingenic SoCs MMC Controller
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/mtd/ingenic,nand.yaml b/Documentation/devicetree/bindings/mtd/ingenic,nand.yaml
> index 8c272c842bfd..cd1aa91d4b2b 100644
> --- a/Documentation/devicetree/bindings/mtd/ingenic,nand.yaml
> +++ b/Documentation/devicetree/bindings/mtd/ingenic,nand.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mtd/ingenic,nand.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs NAND controller devicetree bindings
> +title: Ingenic SoCs NAND controller
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml b/Documentation/devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml
> index 3c51b2d02957..9c494957a07a 100644
> --- a/Documentation/devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml
> +++ b/Documentation/devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/can/allwinner,sun4i-a10-can.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Allwinner A10 CAN Controller Device Tree Bindings
> +title: Allwinner A10 CAN Controller
>  
>  maintainers:
>    - Chen-Yu Tsai <wens@csie.org>
> diff --git a/Documentation/devicetree/bindings/net/can/bosch,c_can.yaml b/Documentation/devicetree/bindings/net/can/bosch,c_can.yaml
> index 51aa89ac7e85..4d7d67ee175a 100644
> --- a/Documentation/devicetree/bindings/net/can/bosch,c_can.yaml
> +++ b/Documentation/devicetree/bindings/net/can/bosch,c_can.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/can/bosch,c_can.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Bosch C_CAN/D_CAN controller Device Tree Bindings
> +title: Bosch C_CAN/D_CAN controller
>  
>  description: Bosch C_CAN/D_CAN controller for CAN bus
>  
> diff --git a/Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml b/Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml
> index 4635cb96fc64..a009a4402938 100644
> --- a/Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml
> +++ b/Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/can/ctu,ctucanfd.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: CTU CAN FD Open-source IP Core Device Tree Bindings
> +title: CTU CAN FD Open-source IP Core
>  
>  description: |
>    Open-source CAN FD IP core developed at the Czech Technical University in Prague
> diff --git a/Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml b/Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml
> index 259a0c6547f3..2a6d126606ca 100644
> --- a/Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml
> +++ b/Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/dsa/arrow,xrs700x.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Arrow SpeedChips XRS7000 Series Switch Device Tree Bindings
> +title: Arrow SpeedChips XRS7000 Series Switch
>  
>  allOf:
>    - $ref: dsa.yaml#
> diff --git a/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml b/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml
> index 9abb8eba5fad..b173fceb8998 100644
> --- a/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml
> +++ b/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/dsa/dsa-port.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ethernet Switch port Device Tree Bindings
> +title: Ethernet Switch port
>  
>  maintainers:
>    - Andrew Lunn <andrew@lunn.ch>
> diff --git a/Documentation/devicetree/bindings/net/dsa/dsa.yaml b/Documentation/devicetree/bindings/net/dsa/dsa.yaml
> index b9d48e357e77..5469ae8a4389 100644
> --- a/Documentation/devicetree/bindings/net/dsa/dsa.yaml
> +++ b/Documentation/devicetree/bindings/net/dsa/dsa.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/dsa/dsa.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ethernet Switch Device Tree Bindings
> +title: Ethernet Switch
>  
>  maintainers:
>    - Andrew Lunn <andrew@lunn.ch>
> diff --git a/Documentation/devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml b/Documentation/devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml
> index 73b774eadd0b..b0869df3059c 100644
> --- a/Documentation/devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml
> +++ b/Documentation/devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/dsa/hirschmann,hellcreek.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Hirschmann Hellcreek TSN Switch Device Tree Bindings
> +title: Hirschmann Hellcreek TSN Switch
>  
>  allOf:
>    - $ref: dsa.yaml#
> diff --git a/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml b/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml
> index 8d93ed9c172c..347a0e1b3d3f 100644
> --- a/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml
> +++ b/Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/dsa/mscc,ocelot.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Microchip Ocelot Switch Family Device Tree Bindings
> +title: Microchip Ocelot Switch Family
>  
>  maintainers:
>    - Vladimir Oltean <vladimir.oltean@nxp.com>
> diff --git a/Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml b/Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml
> index 1e26d876d146..df98a16e4e75 100644
> --- a/Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml
> +++ b/Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/dsa/nxp,sja1105.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NXP SJA1105 Automotive Ethernet Switch Family Device Tree Bindings
> +title: NXP SJA1105 Automotive Ethernet Switch Family
>  
>  description:
>    The SJA1105 SPI interface requires a CS-to-CLK time (t2 in UM10944.pdf) of at
> diff --git a/Documentation/devicetree/bindings/net/wireless/esp,esp8089.yaml b/Documentation/devicetree/bindings/net/wireless/esp,esp8089.yaml
> index 284ef45add99..5557676e9d4b 100644
> --- a/Documentation/devicetree/bindings/net/wireless/esp,esp8089.yaml
> +++ b/Documentation/devicetree/bindings/net/wireless/esp,esp8089.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/wireless/esp,esp8089.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Espressif ESP8089 Device Tree Bindings
> +title: Espressif ESP8089
>  
>  maintainers:
>    - Hans de Goede <hdegoede@redhat.com>
> diff --git a/Documentation/devicetree/bindings/net/wireless/microchip,wilc1000.yaml b/Documentation/devicetree/bindings/net/wireless/microchip,wilc1000.yaml
> index b3405f284580..2460ccc08237 100644
> --- a/Documentation/devicetree/bindings/net/wireless/microchip,wilc1000.yaml
> +++ b/Documentation/devicetree/bindings/net/wireless/microchip,wilc1000.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/wireless/microchip,wilc1000.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Microchip WILC wireless devicetree bindings
> +title: Microchip WILC wireless
>  
>  maintainers:
>    - Adham Abozaeid <adham.abozaeid@microchip.com>
> diff --git a/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml b/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml
> index b35d2f3ad1ad..583db5d42226 100644
> --- a/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml
> +++ b/Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml
> @@ -6,7 +6,7 @@
>  $id: http://devicetree.org/schemas/net/wireless/silabs,wfx.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Silicon Labs WFxxx devicetree bindings
> +title: Silicon Labs WFxxx
>  
>  maintainers:
>    - Jérôme Pouiller <jerome.pouiller@silabs.com>
> diff --git a/Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml b/Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml
> index ee79e13b5fe0..e08504ef3b6e 100644
> --- a/Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml
> +++ b/Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/nvmem/qcom,spmi-sdam.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Qualcomm Technologies, Inc. SPMI SDAM DT bindings
> +title: Qualcomm Technologies, Inc. SPMI SDAM
>  
>  maintainers:
>    - Shyam Kumar Thella <sthella@codeaurora.org>
> diff --git a/Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml b/Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml
> index 5cab21648632..30b42008db06 100644
> --- a/Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml
> +++ b/Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/phy/ingenic,phy-usb.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs USB PHY devicetree bindings
> +title: Ingenic SoCs USB PHY
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml b/Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml
> index c2c370448b81..a4397930e0e8 100644
> --- a/Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml
> +++ b/Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/pinctrl/ingenic,pinctrl.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs pin controller devicetree bindings
> +title: Ingenic SoCs pin controller
>  
>  description: >
>    Please refer to pinctrl-bindings.txt in this directory for details of the
> diff --git a/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml b/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml
> index 46de35861738..11f1f98c1cdc 100644
> --- a/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml
> +++ b/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/power/reset/xlnx,zynqmp-power.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Xilinx Zynq MPSoC Power Management Device Tree Bindings
> +title: Xilinx Zynq MPSoC Power Management
>  
>  maintainers:
>    - Michal Simek <michal.simek@xilinx.com>
> diff --git a/Documentation/devicetree/bindings/power/supply/maxim,ds2760.yaml b/Documentation/devicetree/bindings/power/supply/maxim,ds2760.yaml
> index c838efcf7e16..5faa2418fe2f 100644
> --- a/Documentation/devicetree/bindings/power/supply/maxim,ds2760.yaml
> +++ b/Documentation/devicetree/bindings/power/supply/maxim,ds2760.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/power/supply/maxim,ds2760.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Maxim DS2760 DT bindings
> +title: Maxim DS2760
>  
>  maintainers:
>    - Sebastian Reichel <sre@kernel.org>
> diff --git a/Documentation/devicetree/bindings/power/supply/maxim,max14656.yaml b/Documentation/devicetree/bindings/power/supply/maxim,max14656.yaml
> index 070ef6f96e60..711066b8cdb9 100644
> --- a/Documentation/devicetree/bindings/power/supply/maxim,max14656.yaml
> +++ b/Documentation/devicetree/bindings/power/supply/maxim,max14656.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/power/supply/maxim,max14656.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Maxim MAX14656 DT bindings
> +title: Maxim MAX14656
>  
>  maintainers:
>    - Sebastian Reichel <sre@kernel.org>
> diff --git a/Documentation/devicetree/bindings/rtc/epson,rx8900.yaml b/Documentation/devicetree/bindings/rtc/epson,rx8900.yaml
> index d12855e7ffd7..1df7c45d95c1 100644
> --- a/Documentation/devicetree/bindings/rtc/epson,rx8900.yaml
> +++ b/Documentation/devicetree/bindings/rtc/epson,rx8900.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/rtc/epson,rx8900.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: EPSON RX8900 / Microcrystal RV8803 Real-Time Clock DT bindings
> +title: EPSON RX8900 / Microcrystal RV8803 Real-Time Clock
>  
>  maintainers:
>    - Marek Vasut <marex@denx.de>
> diff --git a/Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml b/Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml
> index b235b2441997..af78b67b3da4 100644
> --- a/Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml
> +++ b/Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/rtc/ingenic,rtc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs Real-Time Clock DT bindings
> +title: Ingenic SoCs Real-Time Clock
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml b/Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml
> index 2d4741f51663..f6e0c613af67 100644
> --- a/Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml
> +++ b/Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/rtc/renesas,rzn1-rtc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Renesas RZ/N1 SoCs Real-Time Clock DT bindings
> +title: Renesas RZ/N1 SoCs Real-Time Clock
>  
>  maintainers:
>    - Miquel Raynal <miquel.raynal@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/serial/brcm,bcm7271-uart.yaml b/Documentation/devicetree/bindings/serial/brcm,bcm7271-uart.yaml
> index 6d176588df47..89c462653e2d 100644
> --- a/Documentation/devicetree/bindings/serial/brcm,bcm7271-uart.yaml
> +++ b/Documentation/devicetree/bindings/serial/brcm,bcm7271-uart.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Broadcom 8250 based serial port devicetree bindings
> +title: Broadcom 8250 based serial port
>  
>  maintainers:
>    - Al Cooper <alcooperx@gmail.com>
> diff --git a/Documentation/devicetree/bindings/serial/ingenic,uart.yaml b/Documentation/devicetree/bindings/serial/ingenic,uart.yaml
> index 315ceb722e19..d5f153bdeb0d 100644
> --- a/Documentation/devicetree/bindings/serial/ingenic,uart.yaml
> +++ b/Documentation/devicetree/bindings/serial/ingenic,uart.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/serial/ingenic,uart.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs UART controller devicetree bindings
> +title: Ingenic SoCs UART controller
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/serial/serial.yaml b/Documentation/devicetree/bindings/serial/serial.yaml
> index c75ba3fb6465..11e822bf09e2 100644
> --- a/Documentation/devicetree/bindings/serial/serial.yaml
> +++ b/Documentation/devicetree/bindings/serial/serial.yaml
> @@ -4,7 +4,7 @@
>  $id: "http://devicetree.org/schemas/serial/serial.yaml#"
>  $schema: "http://devicetree.org/meta-schemas/core.yaml#"
>  
> -title: Serial Interface Generic DT Bindings
> +title: Serial Interface Generic
>  
>  maintainers:
>    - Rob Herring <robh@kernel.org>
> diff --git a/Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml b/Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml
> index d911fa2d40ef..f21eb907ee90 100644
> --- a/Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml
> +++ b/Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/soc/mediatek/mtk-svs.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: MediaTek Smart Voltage Scaling (SVS) Device Tree Bindings
> +title: MediaTek Smart Voltage Scaling (SVS)
>  
>  maintainers:
>    - Roger Lu <roger.lu@mediatek.com>
> diff --git a/Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml b/Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml
> index 963a871e74da..1a4e00a8c5ca 100644
> --- a/Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml
> +++ b/Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/sound/cirrus,cs42l51.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: CS42L51 audio codec DT bindings
> +title: CS42L51 audio codec
>  
>  maintainers:
>    - Olivier Moysan <olivier.moysan@foss.st.com>
> diff --git a/Documentation/devicetree/bindings/sound/ingenic,aic.yaml b/Documentation/devicetree/bindings/sound/ingenic,aic.yaml
> index c4f9b3c2bde5..a96cc2098539 100644
> --- a/Documentation/devicetree/bindings/sound/ingenic,aic.yaml
> +++ b/Documentation/devicetree/bindings/sound/ingenic,aic.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/sound/ingenic,aic.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs AC97 / I2S Controller (AIC) DT bindings
> +title: Ingenic SoCs AC97 / I2S Controller (AIC)
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/sound/ingenic,codec.yaml b/Documentation/devicetree/bindings/sound/ingenic,codec.yaml
> index 48aae54dd643..23a606931347 100644
> --- a/Documentation/devicetree/bindings/sound/ingenic,codec.yaml
> +++ b/Documentation/devicetree/bindings/sound/ingenic,codec.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/sound/ingenic,codec.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic JZ47xx internal codec DT bindings
> +title: Ingenic JZ47xx internal codec
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/sound/qcom,lpass-rx-macro.yaml b/Documentation/devicetree/bindings/sound/qcom,lpass-rx-macro.yaml
> index 14016671f32b..42facaba3f83 100644
> --- a/Documentation/devicetree/bindings/sound/qcom,lpass-rx-macro.yaml
> +++ b/Documentation/devicetree/bindings/sound/qcom,lpass-rx-macro.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/sound/qcom,lpass-rx-macro.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: LPASS(Low Power Audio Subsystem) RX Macro audio codec DT bindings
> +title: LPASS(Low Power Audio Subsystem) RX Macro audio codec
>  
>  maintainers:
>    - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
> diff --git a/Documentation/devicetree/bindings/sound/qcom,lpass-tx-macro.yaml b/Documentation/devicetree/bindings/sound/qcom,lpass-tx-macro.yaml
> index e647ba392a0f..a2afa85c1b2f 100644
> --- a/Documentation/devicetree/bindings/sound/qcom,lpass-tx-macro.yaml
> +++ b/Documentation/devicetree/bindings/sound/qcom,lpass-tx-macro.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/sound/qcom,lpass-tx-macro.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: LPASS(Low Power Audio Subsystem) TX Macro audio codec DT bindings
> +title: LPASS(Low Power Audio Subsystem) TX Macro audio codec
>  
>  maintainers:
>    - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
> diff --git a/Documentation/devicetree/bindings/sound/qcom,lpass-va-macro.yaml b/Documentation/devicetree/bindings/sound/qcom,lpass-va-macro.yaml
> index c36caf90b837..625be7e5aaf7 100644
> --- a/Documentation/devicetree/bindings/sound/qcom,lpass-va-macro.yaml
> +++ b/Documentation/devicetree/bindings/sound/qcom,lpass-va-macro.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/sound/qcom,lpass-va-macro.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: LPASS(Low Power Audio Subsystem) VA Macro audio codec DT bindings
> +title: LPASS(Low Power Audio Subsystem) VA Macro audio codec
>  
>  maintainers:
>    - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
> diff --git a/Documentation/devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml b/Documentation/devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml
> index 155c7344412a..09f541887423 100644
> --- a/Documentation/devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml
> +++ b/Documentation/devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/sound/qcom,lpass-wsa-macro.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: LPASS(Low Power Audio Subsystem) VA Macro audio codec DT bindings
> +title: LPASS(Low Power Audio Subsystem) VA Macro audio codec
>  
>  maintainers:
>    - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
> diff --git a/Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml b/Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml
> index ea7d4900ee4a..7dac9e6f7f08 100644
> --- a/Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml
> +++ b/Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/sound/realtek,rt1015p.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Realtek rt1015p codec devicetree bindings
> +title: Realtek rt1015p codec
>  
>  maintainers:
>    - Tzung-Bi Shih <tzungbi@kernel.org>
> diff --git a/Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml b/Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml
> index dc418652f241..73a4a509fd86 100644
> --- a/Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml
> +++ b/Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/sound/realtek,rt5682s.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Realtek rt5682s codec devicetree bindings
> +title: Realtek rt5682s codec
>  
>  maintainers:
>    - Derek Fang <derek.fang@realtek.com>
> diff --git a/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml b/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml
> index 9681b72b4918..d5e3cbe9b935 100644
> --- a/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml
> +++ b/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/sound/ti,src4xxx.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Texas Instruments SRC4392 Device Tree Bindings
> +title: Texas Instruments SRC4392
>  
>  description: |
>    The SRC4392 is a digital audio codec that can be connected via
> diff --git a/Documentation/devicetree/bindings/spi/ingenic,spi.yaml b/Documentation/devicetree/bindings/spi/ingenic,spi.yaml
> index 360f76c226d9..c08d55b900bb 100644
> --- a/Documentation/devicetree/bindings/spi/ingenic,spi.yaml
> +++ b/Documentation/devicetree/bindings/spi/ingenic,spi.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/spi/ingenic,spi.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs SPI controller devicetree bindings
> +title: Ingenic SoCs SPI controller
>  
>  maintainers:
>    - Artur Rojek <contact@artur-rojek.eu>
> diff --git a/Documentation/devicetree/bindings/spi/spi-gpio.yaml b/Documentation/devicetree/bindings/spi/spi-gpio.yaml
> index 0d0b6d9dad1c..f29b89076c99 100644
> --- a/Documentation/devicetree/bindings/spi/spi-gpio.yaml
> +++ b/Documentation/devicetree/bindings/spi/spi-gpio.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/spi/spi-gpio.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: SPI-GPIO devicetree bindings
> +title: SPI-GPIO
>  
>  maintainers:
>    - Rob Herring <robh@kernel.org>
> diff --git a/Documentation/devicetree/bindings/timer/ingenic,tcu.yaml b/Documentation/devicetree/bindings/timer/ingenic,tcu.yaml
> index a84fef0fe628..2d14610888a7 100644
> --- a/Documentation/devicetree/bindings/timer/ingenic,tcu.yaml
> +++ b/Documentation/devicetree/bindings/timer/ingenic,tcu.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/timer/ingenic,tcu.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic SoCs Timer/Counter Unit (TCU) devicetree bindings
> +title: Ingenic SoCs Timer/Counter Unit (TCU)
>  
>  description: |
>    For a description of the TCU hardware and drivers, have a look at
> diff --git a/Documentation/devicetree/bindings/usb/ingenic,musb.yaml b/Documentation/devicetree/bindings/usb/ingenic,musb.yaml
> index 59212358fcce..4cc1496a913c 100644
> --- a/Documentation/devicetree/bindings/usb/ingenic,musb.yaml
> +++ b/Documentation/devicetree/bindings/usb/ingenic,musb.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/usb/ingenic,musb.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ingenic JZ47xx USB IP DT bindings
> +title: Ingenic JZ47xx USB IP
>  
>  maintainers:
>    - Paul Cercueil <paul@crapouillou.net>
> diff --git a/Documentation/devicetree/bindings/usb/maxim,max33359.yaml b/Documentation/devicetree/bindings/usb/maxim,max33359.yaml
> index 93a19eda610b..8e513a6af378 100644
> --- a/Documentation/devicetree/bindings/usb/maxim,max33359.yaml
> +++ b/Documentation/devicetree/bindings/usb/maxim,max33359.yaml
> @@ -4,7 +4,7 @@
>  $id: "http://devicetree.org/schemas/usb/maxim,max33359.yaml#"
>  $schema: "http://devicetree.org/meta-schemas/core.yaml#"
>  
> -title: Maxim TCPCI Type-C PD controller DT bindings
> +title: Maxim TCPCI Type-C PD controller
>  
>  maintainers:
>    - Badhri Jagan Sridharan <badhri@google.com>
> diff --git a/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml b/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
> index 8db1f8b597c3..c72257c19220 100644
> --- a/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
> +++ b/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
> @@ -4,7 +4,7 @@
>  $id: "http://devicetree.org/schemas/usb/mediatek,mt6360-tcpc.yaml#"
>  $schema: "http://devicetree.org/meta-schemas/core.yaml#"
>  
> -title: Mediatek MT6360 Type-C Port Switch and Power Delivery controller DT bindings
> +title: Mediatek MT6360 Type-C Port Switch and Power Delivery controller
>  
>  maintainers:
>    - ChiYuan Huang <cy_huang@richtek.com>
> diff --git a/Documentation/devicetree/bindings/usb/ti,tps6598x.yaml b/Documentation/devicetree/bindings/usb/ti,tps6598x.yaml
> index a4c53b1f1af3..fef4acdc4773 100644
> --- a/Documentation/devicetree/bindings/usb/ti,tps6598x.yaml
> +++ b/Documentation/devicetree/bindings/usb/ti,tps6598x.yaml
> @@ -4,7 +4,7 @@
>  $id: "http://devicetree.org/schemas/usb/ti,tps6598x.yaml#"
>  $schema: "http://devicetree.org/meta-schemas/core.yaml#"
>  
> -title: Texas Instruments 6598x Type-C Port Switch and Power Delivery controller DT bindings
> +title: Texas Instruments 6598x Type-C Port Switch and Power Delivery controller
>  
>  maintainers:
>    - Bryan O'Donoghue <bryan.odonoghue@linaro.org>
> diff --git a/Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml b/Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml
> index 5aa4ffd67119..937670de01cc 100644
> --- a/Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml
> +++ b/Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/usb/willsemi,wusb3801.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: WUSB3801 Type-C port controller DT bindings
> +title: WUSB3801 Type-C port controller
>  
>  description:
>    The Will Semiconductor WUSB3801 is a USB Type-C port controller which


^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 4/9] dt-bindings: drop redundant part of title (end)
  2022-11-17 12:38 ` [RFC PATCH 4/9] dt-bindings: drop redundant part of title (end) Krzysztof Kozlowski
  2022-11-17 15:18   ` Jonathan Cameron
@ 2022-11-17 15:37   ` Jonathan Cameron
  1 sibling, 0 replies; 26+ messages in thread
From: Jonathan Cameron @ 2022-11-17 15:37 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On Thu, 17 Nov 2022 13:38:45 +0100
Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> wrote:

> The Devicetree bindings document does not have to say in the title that
> it is a "Devicetree binding", but instead just describe the hardware.
> 
> Drop trailing "Devicetree bindings" in various forms (also with
> trailling full stop):
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [dD]evice[ -]\?[tT]ree [bB]indings\?\.\?$/title: \1/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [dD]evice[ -]\?[nN]ode [bB]indings\?\.\?$/title: \1/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [dD][tT] [bB]indings\?\.\?$/title: \1/' {} \;
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> ---
I eyeballed the lot and all seem fine to me so
Reviewed-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>

^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 5/9] dt-bindings: drop redundant part of title (end, part two)
  2022-11-17 12:38 ` [RFC PATCH 5/9] dt-bindings: drop redundant part of title (end, part two) Krzysztof Kozlowski
@ 2022-11-17 15:58   ` Jonathan Cameron
  0 siblings, 0 replies; 26+ messages in thread
From: Jonathan Cameron @ 2022-11-17 15:58 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On Thu, 17 Nov 2022 13:38:46 +0100
Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> wrote:

> The Devicetree bindings document does not have to say in the title that
> it is a "binding", but instead just describe the hardware.
> 
> Drop trailing "Node|Tree|Generic bindings" in various forms (also with
> trailling full stop):
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [nN]ode [bB]indings\?\.\?$/title: \1/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [tT]ree [bB]indings\?\.\?$/title: \1/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [gG]eneric [bB]indings\?\.\?$/title: \1/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [bB]indings\? description\.\?$/title: \1/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -not -name 'trivial-devices.yaml' \
>     -exec sed -i -e 's/^title: \(.*\) [bB]indings\? document\.\?$/title: \1/' {} \;
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>

FWIW eyeballed these as well and all look good to me.

Reviewed-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>



^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 7/9] dt-bindings: drop redundant part of title (beginning)
  2022-11-17 12:38 ` [RFC PATCH 7/9] dt-bindings: drop redundant part of title (beginning) Krzysztof Kozlowski
@ 2022-11-17 16:01   ` Jonathan Cameron
  0 siblings, 0 replies; 26+ messages in thread
From: Jonathan Cameron @ 2022-11-17 16:01 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On Thu, 17 Nov 2022 13:38:48 +0100
Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> wrote:

> The Devicetree bindings document does not have to say in the title that
> it is a "Devicetree binding", but instead just describe the hardware.
> 
> Drop beginning "Devicetree bindings" in various forms:
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -exec sed -i -e 's/^title: [dD]evice[ -]\?[tT]ree [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -exec sed -i -e 's/^title: [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -exec sed -i -e 's/^title: [dD][tT] [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2/' {} \;
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
LGTM

Reviewed-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>

Oh for consistent capitalization though ;)



^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 8/9] dt-bindings: clock: drop redundant part of title
  2022-11-17 12:38 ` [RFC PATCH 8/9] dt-bindings: clock: drop redundant part of title Krzysztof Kozlowski
@ 2022-11-17 16:03   ` Jonathan Cameron
  0 siblings, 0 replies; 26+ messages in thread
From: Jonathan Cameron @ 2022-11-17 16:03 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On Thu, 17 Nov 2022 13:38:49 +0100
Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> wrote:

> The Devicetree bindings document does not have to say in the title that
> it is a "Devicetree binding", but instead just describe the hardware.
> 
> Drop "Devicetree bindings" in various forms:
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -exec sed -i -e 's/^title: [dD]evice[ -]\?[tT]ree [cC]lock [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2 Clock Controller/' {} \;
> 
>   find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
>     -exec sed -i -e 's/^title: [cC]lock [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2 Clock Controller/' {} \;
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
LGTM
Reviewed-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>

^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 9/9] dt-bindings: drop redundant part of title (manual)
  2022-11-17 12:38 ` [RFC PATCH 9/9] dt-bindings: drop redundant part of title (manual) Krzysztof Kozlowski
@ 2022-11-17 16:05   ` Jonathan Cameron
  0 siblings, 0 replies; 26+ messages in thread
From: Jonathan Cameron @ 2022-11-17 16:05 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On Thu, 17 Nov 2022 13:38:50 +0100
Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> wrote:

> The Devicetree bindings document does not have to say in the title that
> it is a "Devicetree binding", but instead just describe the hardware.
> 
> Manual updates to various binding titles.
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>

FWIW looked at this one for completeness sake.

Reviewed-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>


^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 0/9] dt-bindings: cleanup titles
  2022-11-17 12:38 [RFC PATCH 0/9] dt-bindings: cleanup titles Krzysztof Kozlowski
                   ` (7 preceding siblings ...)
  2022-11-17 12:38 ` [RFC PATCH 9/9] dt-bindings: drop redundant part of title (manual) Krzysztof Kozlowski
@ 2022-11-17 16:13 ` Alexandre Belloni
  8 siblings, 0 replies; 26+ messages in thread
From: Alexandre Belloni @ 2022-11-17 16:13 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On 17/11/2022 13:38:41+0100, Krzysztof Kozlowski wrote:
> RFC and merging
> ===============
> Intention is to regenerate the commits with commands at the end of merge
> window.  This should go then via Rob's tree.
> 
> Description
> ===========
> The Devicetree bindings document does not have to say in the title that it is a
> "Devicetree binding", but instead just describe the hardware.  We have several
> of such patterns, so when people copy existing bindings into new ones, they
> also make similar mistake.
> 
> Clean this stuff:
> 1. Automated with find+sed commands,
> 2. Manual to have something meaningful.
> 
> Best regards,
> Krzysztof
> 
> Krzysztof Kozlowski (9):
>   dt-bindings: drop redundant part of title of shared bindings
>   dt-bindings: memory-controllers: ti,gpmc-child: drop redundant part of
>     title
>   dt-bindings: clock: st,stm32mp1-rcc: add proper title
>   dt-bindings: drop redundant part of title (end)
>   dt-bindings: drop redundant part of title (end, part two)
>   dt-bindings: drop redundant part of title (end, part three)
>   dt-bindings: drop redundant part of title (beginning)
>   dt-bindings: clock: drop redundant part of title
>   dt-bindings: drop redundant part of title (manual)
> 

I'm fine with the whole series:
Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com>


>  Documentation/devicetree/bindings/arm/bcm/bcm2835.yaml        | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,bcm11351.yaml  | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,bcm21664.yaml  | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,bcm23550.yaml  | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,bcm4708.yaml   | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,bcmbca.yaml    | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,cygnus.yaml    | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,hr2.yaml       | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,ns2.yaml       | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,nsp.yaml       | 2 +-
>  Documentation/devicetree/bindings/arm/bcm/brcm,stingray.yaml  | 2 +-
>  .../devicetree/bindings/arm/bcm/brcm,vulcan-soc.yaml          | 2 +-
>  Documentation/devicetree/bindings/arm/cci-control-port.yaml   | 2 +-
>  Documentation/devicetree/bindings/arm/cpus.yaml               | 2 +-
>  .../devicetree/bindings/arm/firmware/linaro,optee-tz.yaml     | 2 +-
>  .../devicetree/bindings/arm/hisilicon/hisilicon.yaml          | 2 +-
>  .../devicetree/bindings/arm/keystone/ti,k3-sci-common.yaml    | 2 +-
>  Documentation/devicetree/bindings/arm/keystone/ti,sci.yaml    | 2 +-
>  .../devicetree/bindings/arm/marvell/armada-7k-8k.yaml         | 2 +-
>  Documentation/devicetree/bindings/arm/mrvl/mrvl.yaml          | 2 +-
>  Documentation/devicetree/bindings/arm/mstar/mstar.yaml        | 2 +-
>  Documentation/devicetree/bindings/arm/npcm/npcm.yaml          | 2 +-
>  Documentation/devicetree/bindings/arm/nxp/lpc32xx.yaml        | 2 +-
>  Documentation/devicetree/bindings/arm/socionext/milbeaut.yaml | 2 +-
>  Documentation/devicetree/bindings/arm/socionext/uniphier.yaml | 2 +-
>  Documentation/devicetree/bindings/arm/sp810.yaml              | 2 +-
>  Documentation/devicetree/bindings/arm/sprd/sprd.yaml          | 2 +-
>  Documentation/devicetree/bindings/arm/stm32/st,mlahb.yaml     | 2 +-
>  .../devicetree/bindings/arm/stm32/st,stm32-syscon.yaml        | 2 +-
>  Documentation/devicetree/bindings/arm/stm32/stm32.yaml        | 2 +-
>  .../bindings/arm/sunxi/allwinner,sun6i-a31-cpuconfig.yaml     | 2 +-
>  .../bindings/arm/sunxi/allwinner,sun9i-a80-prcm.yaml          | 2 +-
>  .../bindings/arm/tegra/nvidia,tegra-ccplex-cluster.yaml       | 2 +-
>  .../devicetree/bindings/arm/tegra/nvidia,tegra194-cbb.yaml    | 2 +-
>  .../devicetree/bindings/arm/tegra/nvidia,tegra234-cbb.yaml    | 2 +-
>  Documentation/devicetree/bindings/arm/ti/k3.yaml              | 2 +-
>  Documentation/devicetree/bindings/arm/ti/ti,davinci.yaml      | 2 +-
>  Documentation/devicetree/bindings/arm/vexpress-config.yaml    | 2 +-
>  Documentation/devicetree/bindings/arm/vexpress-sysreg.yaml    | 2 +-
>  .../devicetree/bindings/ata/allwinner,sun4i-a10-ahci.yaml     | 2 +-
>  .../devicetree/bindings/ata/allwinner,sun8i-r40-ahci.yaml     | 2 +-
>  Documentation/devicetree/bindings/bus/ti-sysc.yaml            | 2 +-
>  Documentation/devicetree/bindings/clock/adi,axi-clkgen.yaml   | 2 +-
>  Documentation/devicetree/bindings/clock/calxeda.yaml          | 2 +-
>  Documentation/devicetree/bindings/clock/cirrus,cs2000-cp.yaml | 2 +-
>  Documentation/devicetree/bindings/clock/fixed-clock.yaml      | 2 +-
>  .../devicetree/bindings/clock/fixed-factor-clock.yaml         | 2 +-
>  Documentation/devicetree/bindings/clock/fixed-mmio-clock.yaml | 2 +-
>  Documentation/devicetree/bindings/clock/fsl,plldig.yaml       | 2 +-
>  Documentation/devicetree/bindings/clock/fsl,sai-clock.yaml    | 2 +-
>  Documentation/devicetree/bindings/clock/fsl,scu-clk.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/idt,versaclock5.yaml  | 2 +-
>  Documentation/devicetree/bindings/clock/imx1-clock.yaml       | 2 +-
>  Documentation/devicetree/bindings/clock/imx21-clock.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/imx23-clock.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/imx25-clock.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/imx27-clock.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/imx28-clock.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/imx31-clock.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/imx35-clock.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/imx5-clock.yaml       | 2 +-
>  Documentation/devicetree/bindings/clock/imx6q-clock.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/imx6sl-clock.yaml     | 2 +-
>  Documentation/devicetree/bindings/clock/imx6sll-clock.yaml    | 2 +-
>  Documentation/devicetree/bindings/clock/imx6sx-clock.yaml     | 2 +-
>  Documentation/devicetree/bindings/clock/imx6ul-clock.yaml     | 2 +-
>  Documentation/devicetree/bindings/clock/imx7d-clock.yaml      | 2 +-
>  .../devicetree/bindings/clock/imx7ulp-pcc-clock.yaml          | 2 +-
>  .../devicetree/bindings/clock/imx7ulp-scg-clock.yaml          | 2 +-
>  Documentation/devicetree/bindings/clock/imx8m-clock.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/imx8qxp-lpcg.yaml     | 2 +-
>  .../devicetree/bindings/clock/imx8ulp-cgc-clock.yaml          | 2 +-
>  .../devicetree/bindings/clock/imx8ulp-pcc-clock.yaml          | 2 +-
>  Documentation/devicetree/bindings/clock/imx93-clock.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/imxrt1050-clock.yaml  | 2 +-
>  Documentation/devicetree/bindings/clock/ingenic,cgu.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/intel,agilex.yaml     | 2 +-
>  Documentation/devicetree/bindings/clock/intel,cgu-lgm.yaml    | 2 +-
>  Documentation/devicetree/bindings/clock/intel,easic-n5x.yaml  | 2 +-
>  Documentation/devicetree/bindings/clock/intel,stratix10.yaml  | 2 +-
>  .../devicetree/bindings/clock/microchip,mpfs-clkcfg.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/milbeaut-clock.yaml   | 2 +-
>  .../devicetree/bindings/clock/nuvoton,npcm845-clk.yaml        | 2 +-
>  .../devicetree/bindings/clock/qcom,dispcc-sc8280xp.yaml       | 2 +-
>  Documentation/devicetree/bindings/clock/qcom,gcc.yaml         | 2 +-
>  Documentation/devicetree/bindings/clock/qcom,rpmhcc.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/renesas,9series.yaml  | 2 +-
>  .../devicetree/bindings/clock/renesas,versaclock7.yaml        | 2 +-
>  .../devicetree/bindings/clock/rockchip,rk3568-cru.yaml        | 2 +-
>  Documentation/devicetree/bindings/clock/st,stm32mp1-rcc.yaml  | 2 +-
>  Documentation/devicetree/bindings/clock/ti,lmk04832.yaml      | 2 +-
>  Documentation/devicetree/bindings/clock/ti,sci-clk.yaml       | 2 +-
>  Documentation/devicetree/bindings/clock/ti/ti,clksel.yaml     | 2 +-
>  Documentation/devicetree/bindings/cpu/idle-states.yaml        | 2 +-
>  .../devicetree/bindings/cpufreq/cpufreq-mediatek-hw.yaml      | 2 +-
>  .../devicetree/bindings/cpufreq/qcom-cpufreq-nvmem.yaml       | 2 +-
>  Documentation/devicetree/bindings/crypto/st,stm32-crc.yaml    | 2 +-
>  Documentation/devicetree/bindings/crypto/st,stm32-cryp.yaml   | 2 +-
>  Documentation/devicetree/bindings/crypto/st,stm32-hash.yaml   | 2 +-
>  Documentation/devicetree/bindings/display/arm,hdlcd.yaml      | 2 +-
>  Documentation/devicetree/bindings/display/arm,malidp.yaml     | 2 +-
>  Documentation/devicetree/bindings/display/bridge/anx6345.yaml | 2 +-
>  .../devicetree/bindings/display/bridge/chrontel,ch7033.yaml   | 2 +-
>  .../bindings/display/bridge/ingenic,jz4780-hdmi.yaml          | 2 +-
>  .../devicetree/bindings/display/bridge/intel,keembay-dsi.yaml | 2 +-
>  .../devicetree/bindings/display/bridge/ite,it6505.yaml        | 2 +-
>  .../devicetree/bindings/display/bridge/ite,it66121.yaml       | 2 +-
>  Documentation/devicetree/bindings/display/bridge/ps8640.yaml  | 2 +-
>  .../devicetree/bindings/display/bridge/toshiba,tc358767.yaml  | 2 +-
>  .../devicetree/bindings/display/bridge/toshiba,tc358775.yaml  | 2 +-
>  Documentation/devicetree/bindings/display/ingenic,ipu.yaml    | 2 +-
>  Documentation/devicetree/bindings/display/ingenic,lcd.yaml    | 2 +-
>  .../devicetree/bindings/display/intel,keembay-display.yaml    | 2 +-
>  .../devicetree/bindings/display/intel,keembay-msscam.yaml     | 2 +-
>  .../devicetree/bindings/display/mediatek/mediatek,cec.yaml    | 2 +-
>  .../devicetree/bindings/display/mediatek/mediatek,dsi.yaml    | 2 +-
>  .../bindings/display/mediatek/mediatek,hdmi-ddc.yaml          | 2 +-
>  .../devicetree/bindings/display/mediatek/mediatek,hdmi.yaml   | 2 +-
>  Documentation/devicetree/bindings/display/msm/gmu.yaml        | 2 +-
>  Documentation/devicetree/bindings/display/msm/gpu.yaml        | 2 +-
>  .../devicetree/bindings/display/panel/display-timings.yaml    | 2 +-
>  .../devicetree/bindings/display/panel/ilitek,ili9163.yaml     | 2 +-
>  .../bindings/display/panel/olimex,lcd-olinuxino.yaml          | 2 +-
>  .../devicetree/bindings/display/panel/panel-lvds.yaml         | 2 +-
>  .../devicetree/bindings/display/panel/panel-timing.yaml       | 2 +-
>  .../devicetree/bindings/display/panel/visionox,rm69299.yaml   | 2 +-
>  Documentation/devicetree/bindings/dma/dma-common.yaml         | 2 +-
>  Documentation/devicetree/bindings/dma/dma-controller.yaml     | 4 ++--
>  Documentation/devicetree/bindings/dma/dma-router.yaml         | 4 ++--
>  Documentation/devicetree/bindings/dma/ingenic,dma.yaml        | 2 +-
>  Documentation/devicetree/bindings/dma/st,stm32-dma.yaml       | 2 +-
>  Documentation/devicetree/bindings/dma/st,stm32-dmamux.yaml    | 2 +-
>  Documentation/devicetree/bindings/dma/st,stm32-mdma.yaml      | 2 +-
>  Documentation/devicetree/bindings/dma/ti/k3-bcdma.yaml        | 2 +-
>  Documentation/devicetree/bindings/dma/ti/k3-pktdma.yaml       | 2 +-
>  Documentation/devicetree/bindings/dma/ti/k3-udma.yaml         | 2 +-
>  .../devicetree/bindings/dma/xilinx/xlnx,zynqmp-dpdma.yaml     | 2 +-
>  Documentation/devicetree/bindings/edac/dmc-520.yaml           | 2 +-
>  .../devicetree/bindings/eeprom/microchip,93lc46b.yaml         | 2 +-
>  Documentation/devicetree/bindings/firmware/arm,scmi.yaml      | 2 +-
>  Documentation/devicetree/bindings/firmware/arm,scpi.yaml      | 2 +-
>  .../devicetree/bindings/firmware/qemu,fw-cfg-mmio.yaml        | 2 +-
>  Documentation/devicetree/bindings/gpio/gpio-tpic2810.yaml     | 2 +-
>  Documentation/devicetree/bindings/gpio/ti,omap-gpio.yaml      | 2 +-
>  Documentation/devicetree/bindings/gpu/brcm,bcm-v3d.yaml       | 2 +-
>  .../devicetree/bindings/gpu/host1x/nvidia,tegra210-nvdec.yaml | 2 +-
>  .../devicetree/bindings/gpu/host1x/nvidia,tegra210-nvenc.yaml | 2 +-
>  .../devicetree/bindings/gpu/host1x/nvidia,tegra210-nvjpg.yaml | 2 +-
>  .../devicetree/bindings/gpu/host1x/nvidia,tegra234-nvdec.yaml | 2 +-
>  Documentation/devicetree/bindings/gpu/vivante,gc.yaml         | 2 +-
>  .../devicetree/bindings/hwlock/st,stm32-hwspinlock.yaml       | 2 +-
>  Documentation/devicetree/bindings/hwmon/moortec,mr75203.yaml  | 2 +-
>  Documentation/devicetree/bindings/i2c/i2c-gpio.yaml           | 2 +-
>  Documentation/devicetree/bindings/i2c/i2c-pxa.yaml            | 2 +-
>  Documentation/devicetree/bindings/i2c/ingenic,i2c.yaml        | 2 +-
>  Documentation/devicetree/bindings/i2c/st,nomadik-i2c.yaml     | 2 +-
>  Documentation/devicetree/bindings/i2c/ti,omap4-i2c.yaml       | 2 +-
>  Documentation/devicetree/bindings/i3c/i3c.yaml                | 2 +-
>  Documentation/devicetree/bindings/iio/adc/adc.yaml            | 2 +-
>  .../devicetree/bindings/iio/adc/allwinner,sun8i-a33-ths.yaml  | 2 +-
>  Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml    | 2 +-
>  .../devicetree/bindings/iio/adc/motorola,cpcap-adc.yaml       | 2 +-
>  .../devicetree/bindings/iio/adc/nxp,imx8qxp-adc.yaml          | 2 +-
>  .../devicetree/bindings/iio/adc/nxp,lpc1850-adc.yaml          | 2 +-
>  .../devicetree/bindings/iio/adc/sigma-delta-modulator.yaml    | 2 +-
>  .../devicetree/bindings/iio/adc/sprd,sc2720-adc.yaml          | 2 +-
>  Documentation/devicetree/bindings/iio/adc/st,stm32-adc.yaml   | 2 +-
>  .../devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml          | 2 +-
>  .../devicetree/bindings/iio/adc/x-powers,axp209-adc.yaml      | 2 +-
>  .../devicetree/bindings/iio/dac/nxp,lpc1850-dac.yaml          | 2 +-
>  Documentation/devicetree/bindings/iio/dac/st,stm32-dac.yaml   | 2 +-
>  .../devicetree/bindings/iio/multiplexer/io-channel-mux.yaml   | 2 +-
>  Documentation/devicetree/bindings/input/fsl,scu-key.yaml      | 2 +-
>  Documentation/devicetree/bindings/input/gpio-keys.yaml        | 2 +-
>  Documentation/devicetree/bindings/input/input.yaml            | 2 +-
>  Documentation/devicetree/bindings/input/matrix-keymap.yaml    | 2 +-
>  .../devicetree/bindings/input/microchip,cap11xx.yaml          | 2 +-
>  .../devicetree/bindings/input/pine64,pinephone-keyboard.yaml  | 2 +-
>  .../bindings/input/touchscreen/chipone,icn8318.yaml           | 2 +-
>  .../bindings/input/touchscreen/cypress,cy8ctma140.yaml        | 2 +-
>  .../bindings/input/touchscreen/cypress,cy8ctma340.yaml        | 2 +-
>  .../devicetree/bindings/input/touchscreen/edt-ft5x06.yaml     | 2 +-
>  .../devicetree/bindings/input/touchscreen/goodix.yaml         | 2 +-
>  .../devicetree/bindings/input/touchscreen/himax,hx83112b.yaml | 2 +-
>  .../devicetree/bindings/input/touchscreen/hycon,hy46xx.yaml   | 2 +-
>  .../bindings/input/touchscreen/imagis,ist3038c.yaml           | 2 +-
>  .../devicetree/bindings/input/touchscreen/melfas,mms114.yaml  | 2 +-
>  .../devicetree/bindings/input/touchscreen/mstar,msg2638.yaml  | 2 +-
>  .../bindings/input/touchscreen/pixcir,pixcir_ts.yaml          | 2 +-
>  .../devicetree/bindings/input/touchscreen/silead,gsl1680.yaml | 2 +-
>  .../devicetree/bindings/input/touchscreen/ti,tsc2005.yaml     | 2 +-
>  .../devicetree/bindings/input/touchscreen/touchscreen.yaml    | 2 +-
>  .../devicetree/bindings/input/touchscreen/zinitix,bt400.yaml  | 2 +-
>  .../bindings/interrupt-controller/ingenic,intc.yaml           | 2 +-
>  .../devicetree/bindings/interrupt-controller/mrvl,intc.yaml   | 2 +-
>  .../bindings/interrupt-controller/nuvoton,wpcm450-aic.yaml    | 2 +-
>  .../bindings/interrupt-controller/realtek,rtl-intc.yaml       | 2 +-
>  .../bindings/interrupt-controller/renesas,irqc.yaml           | 2 +-
>  Documentation/devicetree/bindings/ipmi/ipmi-ipmb.yaml         | 2 +-
>  Documentation/devicetree/bindings/ipmi/ipmi-smic.yaml         | 2 +-
>  .../devicetree/bindings/leds/backlight/gpio-backlight.yaml    | 2 +-
>  .../devicetree/bindings/leds/backlight/led-backlight.yaml     | 2 +-
>  .../devicetree/bindings/leds/backlight/pwm-backlight.yaml     | 2 +-
>  .../devicetree/bindings/leds/backlight/qcom-wled.yaml         | 2 +-
>  Documentation/devicetree/bindings/leds/issi,is31fl319x.yaml   | 2 +-
>  Documentation/devicetree/bindings/leds/register-bit-led.yaml  | 2 +-
>  Documentation/devicetree/bindings/leds/regulator-led.yaml     | 2 +-
>  .../devicetree/bindings/mailbox/qcom,apcs-kpss-global.yaml    | 2 +-
>  Documentation/devicetree/bindings/mailbox/sprd-mailbox.yaml   | 2 +-
>  Documentation/devicetree/bindings/mailbox/st,stm32-ipcc.yaml  | 2 +-
>  .../devicetree/bindings/media/i2c/dongwoon,dw9768.yaml        | 2 +-
>  Documentation/devicetree/bindings/media/i2c/ov8856.yaml       | 2 +-
>  Documentation/devicetree/bindings/media/i2c/ovti,ov02a10.yaml | 2 +-
>  Documentation/devicetree/bindings/media/i2c/ovti,ov5640.yaml  | 2 +-
>  Documentation/devicetree/bindings/media/i2c/ovti,ov5648.yaml  | 2 +-
>  Documentation/devicetree/bindings/media/i2c/ovti,ov8865.yaml  | 2 +-
>  Documentation/devicetree/bindings/media/i2c/st,st-vgxy61.yaml | 2 +-
>  .../devicetree/bindings/media/marvell,mmp2-ccic.yaml          | 2 +-
>  Documentation/devicetree/bindings/media/renesas,ceu.yaml      | 2 +-
>  Documentation/devicetree/bindings/media/st,stm32-cec.yaml     | 2 +-
>  Documentation/devicetree/bindings/media/st,stm32-dcmi.yaml    | 2 +-
>  Documentation/devicetree/bindings/media/st,stm32-dma2d.yaml   | 2 +-
>  .../devicetree/bindings/media/video-interface-devices.yaml    | 2 +-
>  Documentation/devicetree/bindings/media/video-interfaces.yaml | 2 +-
>  .../bindings/memory-controllers/calxeda-ddr-ctrlr.yaml        | 2 +-
>  .../bindings/memory-controllers/ingenic,nemc-peripherals.yaml | 2 +-
>  .../devicetree/bindings/memory-controllers/ingenic,nemc.yaml  | 2 +-
>  .../bindings/memory-controllers/st,stm32-fmc2-ebi.yaml        | 2 +-
>  .../devicetree/bindings/memory-controllers/ti,gpmc-child.yaml | 2 +-
>  .../devicetree/bindings/memory-controllers/ti,gpmc.yaml       | 2 +-
>  Documentation/devicetree/bindings/mfd/actions,atc260x.yaml    | 2 +-
>  Documentation/devicetree/bindings/mfd/ene-kb3930.yaml         | 2 +-
>  Documentation/devicetree/bindings/mfd/ene-kb930.yaml          | 2 +-
>  Documentation/devicetree/bindings/mfd/fsl,imx8qxp-csr.yaml    | 2 +-
>  Documentation/devicetree/bindings/mfd/qcom,pm8008.yaml        | 2 +-
>  Documentation/devicetree/bindings/mfd/rohm,bd71815-pmic.yaml  | 2 +-
>  Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml  | 2 +-
>  Documentation/devicetree/bindings/mfd/rohm,bd71837-pmic.yaml  | 2 +-
>  Documentation/devicetree/bindings/mfd/rohm,bd71847-pmic.yaml  | 2 +-
>  Documentation/devicetree/bindings/mfd/rohm,bd9576-pmic.yaml   | 2 +-
>  Documentation/devicetree/bindings/mfd/st,stm32-lptimer.yaml   | 2 +-
>  Documentation/devicetree/bindings/mfd/st,stm32-timers.yaml    | 2 +-
>  Documentation/devicetree/bindings/mfd/st,stmfx.yaml           | 2 +-
>  Documentation/devicetree/bindings/mfd/st,stpmic1.yaml         | 2 +-
>  Documentation/devicetree/bindings/mips/ingenic/devices.yaml   | 2 +-
>  .../devicetree/bindings/mips/ingenic/ingenic,cpu.yaml         | 2 +-
>  .../devicetree/bindings/mips/lantiq/lantiq,dma-xway.yaml      | 2 +-
>  Documentation/devicetree/bindings/mips/loongson/devices.yaml  | 2 +-
>  Documentation/devicetree/bindings/misc/olpc,xo1.75-ec.yaml    | 2 +-
>  Documentation/devicetree/bindings/mmc/arasan,sdhci.yaml       | 2 +-
>  Documentation/devicetree/bindings/mmc/brcm,sdhci-brcmstb.yaml | 2 +-
>  Documentation/devicetree/bindings/mmc/ingenic,mmc.yaml        | 2 +-
>  .../devicetree/bindings/mmc/microchip,dw-sparx5-sdhci.yaml    | 2 +-
>  Documentation/devicetree/bindings/mmc/mmc-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/mmc/mmc-pwrseq-emmc.yaml    | 2 +-
>  Documentation/devicetree/bindings/mmc/mmc-pwrseq-sd8787.yaml  | 2 +-
>  Documentation/devicetree/bindings/mmc/mmc-pwrseq-simple.yaml  | 2 +-
>  Documentation/devicetree/bindings/mmc/mtk-sd.yaml             | 2 +-
>  Documentation/devicetree/bindings/mmc/sdhci-pxa.yaml          | 2 +-
>  Documentation/devicetree/bindings/mmc/snps,dwcmshc-sdhci.yaml | 2 +-
>  Documentation/devicetree/bindings/mmc/synopsys-dw-mshc.yaml   | 2 +-
>  Documentation/devicetree/bindings/mtd/gpmi-nand.yaml          | 2 +-
>  Documentation/devicetree/bindings/mtd/ingenic,nand.yaml       | 2 +-
>  .../devicetree/bindings/mtd/microchip,mchp48l640.yaml         | 2 +-
>  Documentation/devicetree/bindings/mtd/mxc-nand.yaml           | 2 +-
>  Documentation/devicetree/bindings/mtd/nand-chip.yaml          | 2 +-
>  Documentation/devicetree/bindings/mtd/nand-controller.yaml    | 2 +-
>  .../devicetree/bindings/mtd/partitions/qcom,smem-part.yaml    | 2 +-
>  Documentation/devicetree/bindings/mtd/st,stm32-fmc2-nand.yaml | 2 +-
>  Documentation/devicetree/bindings/mux/gpio-mux.yaml           | 2 +-
>  Documentation/devicetree/bindings/mux/mux-consumer.yaml       | 2 +-
>  Documentation/devicetree/bindings/mux/mux-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/mux/reg-mux.yaml            | 2 +-
>  Documentation/devicetree/bindings/net/asix,ax88178.yaml       | 2 +-
>  .../bindings/net/bluetooth/bluetooth-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/brcm,bcmgenet.yaml      | 2 +-
>  .../devicetree/bindings/net/can/allwinner,sun4i-a10-can.yaml  | 2 +-
>  Documentation/devicetree/bindings/net/can/bosch,c_can.yaml    | 2 +-
>  Documentation/devicetree/bindings/net/can/bosch,m_can.yaml    | 2 +-
>  Documentation/devicetree/bindings/net/can/can-controller.yaml | 2 +-
>  .../devicetree/bindings/net/can/can-transceiver.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/can/ctu,ctucanfd.yaml   | 2 +-
>  Documentation/devicetree/bindings/net/dsa/arrow,xrs700x.yaml  | 2 +-
>  Documentation/devicetree/bindings/net/dsa/dsa-port.yaml       | 2 +-
>  Documentation/devicetree/bindings/net/dsa/dsa.yaml            | 2 +-
>  .../devicetree/bindings/net/dsa/hirschmann,hellcreek.yaml     | 2 +-
>  .../devicetree/bindings/net/dsa/microchip,lan937x.yaml        | 2 +-
>  Documentation/devicetree/bindings/net/dsa/mscc,ocelot.yaml    | 2 +-
>  Documentation/devicetree/bindings/net/dsa/nxp,sja1105.yaml    | 2 +-
>  Documentation/devicetree/bindings/net/engleder,tsnep.yaml     | 2 +-
>  .../devicetree/bindings/net/ethernet-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/ethernet-phy.yaml       | 2 +-
>  Documentation/devicetree/bindings/net/fsl,qoriq-mc-dpmac.yaml | 2 +-
>  Documentation/devicetree/bindings/net/ingenic,mac.yaml        | 2 +-
>  .../devicetree/bindings/net/mctp-i2c-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/mdio.yaml               | 2 +-
>  Documentation/devicetree/bindings/net/microchip,lan95xx.yaml  | 2 +-
>  .../devicetree/bindings/net/wireless/esp,esp8089.yaml         | 2 +-
>  Documentation/devicetree/bindings/net/wireless/ieee80211.yaml | 2 +-
>  .../devicetree/bindings/net/wireless/mediatek,mt76.yaml       | 2 +-
>  .../devicetree/bindings/net/wireless/microchip,wilc1000.yaml  | 2 +-
>  Documentation/devicetree/bindings/net/wireless/qca,ath9k.yaml | 2 +-
>  .../devicetree/bindings/net/wireless/qcom,ath11k.yaml         | 2 +-
>  .../devicetree/bindings/net/wireless/silabs,wfx.yaml          | 2 +-
>  Documentation/devicetree/bindings/nvmem/fsl,scu-ocotp.yaml    | 2 +-
>  .../devicetree/bindings/nvmem/ingenic,jz4780-efuse.yaml       | 2 +-
>  Documentation/devicetree/bindings/nvmem/qcom,qfprom.yaml      | 2 +-
>  Documentation/devicetree/bindings/nvmem/qcom,spmi-sdam.yaml   | 2 +-
>  .../devicetree/bindings/nvmem/socionext,uniphier-efuse.yaml   | 2 +-
>  Documentation/devicetree/bindings/nvmem/st,stm32-romem.yaml   | 2 +-
>  Documentation/devicetree/bindings/opp/opp-v1.yaml             | 2 +-
>  Documentation/devicetree/bindings/opp/opp-v2-base.yaml        | 2 +-
>  Documentation/devicetree/bindings/opp/opp-v2-kryo-cpu.yaml    | 2 +-
>  Documentation/devicetree/bindings/opp/opp-v2-qcom-level.yaml  | 2 +-
>  Documentation/devicetree/bindings/opp/opp-v2.yaml             | 2 +-
>  Documentation/devicetree/bindings/pci/qcom,pcie-ep.yaml       | 2 +-
>  Documentation/devicetree/bindings/phy/brcm,ns2-pcie-phy.yaml  | 2 +-
>  Documentation/devicetree/bindings/phy/calxeda-combophy.yaml   | 2 +-
>  Documentation/devicetree/bindings/phy/fsl,imx8mq-usb-phy.yaml | 2 +-
>  Documentation/devicetree/bindings/phy/fsl,lynx-28g.yaml       | 2 +-
>  Documentation/devicetree/bindings/phy/ingenic,phy-usb.yaml    | 2 +-
>  .../devicetree/bindings/phy/intel,keembay-phy-usb.yaml        | 2 +-
>  .../devicetree/bindings/phy/intel,phy-thunderbay-emmc.yaml    | 2 +-
>  .../devicetree/bindings/phy/marvell,mmp3-usb-phy.yaml         | 2 +-
>  Documentation/devicetree/bindings/phy/mediatek,dsi-phy.yaml   | 2 +-
>  Documentation/devicetree/bindings/phy/mediatek,hdmi-phy.yaml  | 2 +-
>  Documentation/devicetree/bindings/phy/mediatek,ufs-phy.yaml   | 2 +-
>  Documentation/devicetree/bindings/phy/phy-cadence-sierra.yaml | 2 +-
>  .../devicetree/bindings/phy/phy-cadence-torrent.yaml          | 2 +-
>  Documentation/devicetree/bindings/phy/phy-stm32-usbphyc.yaml  | 2 +-
>  Documentation/devicetree/bindings/phy/phy-tegra194-p2u.yaml   | 2 +-
>  Documentation/devicetree/bindings/phy/qcom,usb-hs-phy.yaml    | 2 +-
>  .../devicetree/bindings/phy/ti,phy-am654-serdes.yaml          | 2 +-
>  Documentation/devicetree/bindings/phy/ti,phy-gmii-sel.yaml    | 2 +-
>  Documentation/devicetree/bindings/phy/transmit-amplitude.yaml | 2 +-
>  .../devicetree/bindings/pinctrl/fsl,scu-pinctrl.yaml          | 2 +-
>  .../devicetree/bindings/pinctrl/ingenic,pinctrl.yaml          | 2 +-
>  Documentation/devicetree/bindings/pinctrl/intel,lgm-io.yaml   | 2 +-
>  Documentation/devicetree/bindings/power/avs/qcom,cpr.yaml     | 2 +-
>  .../devicetree/bindings/power/domain-idle-state.yaml          | 2 +-
>  Documentation/devicetree/bindings/power/fsl,scu-pd.yaml       | 2 +-
>  .../devicetree/bindings/power/reset/restart-handler.yaml      | 2 +-
>  .../devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml    | 2 +-
>  Documentation/devicetree/bindings/power/supply/bq2415x.yaml   | 2 +-
>  Documentation/devicetree/bindings/power/supply/bq24190.yaml   | 2 +-
>  Documentation/devicetree/bindings/power/supply/bq24257.yaml   | 2 +-
>  Documentation/devicetree/bindings/power/supply/bq24735.yaml   | 2 +-
>  Documentation/devicetree/bindings/power/supply/bq25890.yaml   | 2 +-
>  .../devicetree/bindings/power/supply/dlg,da9150-charger.yaml  | 2 +-
>  .../bindings/power/supply/dlg,da9150-fuel-gauge.yaml          | 2 +-
>  .../devicetree/bindings/power/supply/ingenic,battery.yaml     | 2 +-
>  Documentation/devicetree/bindings/power/supply/isp1704.yaml   | 2 +-
>  .../devicetree/bindings/power/supply/lltc,lt3651-charger.yaml | 2 +-
>  .../devicetree/bindings/power/supply/lltc,ltc294x.yaml        | 2 +-
>  .../devicetree/bindings/power/supply/maxim,ds2760.yaml        | 2 +-
>  .../devicetree/bindings/power/supply/maxim,max14656.yaml      | 2 +-
>  .../devicetree/bindings/power/supply/richtek,rt9455.yaml      | 2 +-
>  .../devicetree/bindings/power/supply/sc2731-charger.yaml      | 2 +-
>  Documentation/devicetree/bindings/power/supply/sc27xx-fg.yaml | 2 +-
>  Documentation/devicetree/bindings/power/supply/ti,lp8727.yaml | 2 +-
>  Documentation/devicetree/bindings/pwm/microchip,corepwm.yaml  | 2 +-
>  .../devicetree/bindings/regulator/pwm-regulator.yaml          | 2 +-
>  .../devicetree/bindings/regulator/st,stm32-booster.yaml       | 2 +-
>  .../devicetree/bindings/regulator/st,stm32-vrefbuf.yaml       | 2 +-
>  .../bindings/remoteproc/amlogic,meson-mx-ao-arc.yaml          | 2 +-
>  .../devicetree/bindings/remoteproc/fsl,imx-rproc.yaml         | 2 +-
>  Documentation/devicetree/bindings/remoteproc/ingenic,vpu.yaml | 2 +-
>  Documentation/devicetree/bindings/remoteproc/mtk,scp.yaml     | 2 +-
>  Documentation/devicetree/bindings/remoteproc/qcom,adsp.yaml   | 2 +-
>  .../devicetree/bindings/remoteproc/qcom,pil-info.yaml         | 2 +-
>  .../devicetree/bindings/remoteproc/renesas,rcar-rproc.yaml    | 2 +-
>  .../devicetree/bindings/remoteproc/st,stm32-rproc.yaml        | 2 +-
>  .../devicetree/bindings/reserved-memory/shared-dma-pool.yaml  | 2 +-
>  Documentation/devicetree/bindings/reset/ti,sci-reset.yaml     | 2 +-
>  Documentation/devicetree/bindings/reset/ti,tps380x-reset.yaml | 2 +-
>  Documentation/devicetree/bindings/riscv/cpus.yaml             | 2 +-
>  Documentation/devicetree/bindings/rng/ingenic,rng.yaml        | 2 +-
>  Documentation/devicetree/bindings/rng/ingenic,trng.yaml       | 2 +-
>  Documentation/devicetree/bindings/rng/intel,ixp46x-rng.yaml   | 2 +-
>  .../devicetree/bindings/rng/silex-insight,ba431-rng.yaml      | 2 +-
>  Documentation/devicetree/bindings/rng/st,stm32-rng.yaml       | 2 +-
>  .../devicetree/bindings/rng/xiphera,xip8001b-trng.yaml        | 2 +-
>  Documentation/devicetree/bindings/rtc/epson,rx8900.yaml       | 2 +-
>  Documentation/devicetree/bindings/rtc/fsl,scu-rtc.yaml        | 2 +-
>  Documentation/devicetree/bindings/rtc/ingenic,rtc.yaml        | 2 +-
>  Documentation/devicetree/bindings/rtc/renesas,rzn1-rtc.yaml   | 2 +-
>  Documentation/devicetree/bindings/rtc/rtc.yaml                | 2 +-
>  Documentation/devicetree/bindings/rtc/sa1100-rtc.yaml         | 2 +-
>  Documentation/devicetree/bindings/rtc/st,stm32-rtc.yaml       | 2 +-
>  Documentation/devicetree/bindings/serial/8250.yaml            | 2 +-
>  Documentation/devicetree/bindings/serial/8250_omap.yaml       | 2 +-
>  .../devicetree/bindings/serial/brcm,bcm7271-uart.yaml         | 2 +-
>  Documentation/devicetree/bindings/serial/ingenic,uart.yaml    | 2 +-
>  Documentation/devicetree/bindings/serial/rs485.yaml           | 2 +-
>  Documentation/devicetree/bindings/serial/serial.yaml          | 2 +-
>  Documentation/devicetree/bindings/serial/st,stm32-uart.yaml   | 2 +-
>  Documentation/devicetree/bindings/serio/ps2-gpio.yaml         | 2 +-
>  Documentation/devicetree/bindings/soc/mediatek/mtk-svs.yaml   | 2 +-
>  Documentation/devicetree/bindings/soc/qcom/qcom,aoss-qmp.yaml | 2 +-
>  Documentation/devicetree/bindings/soc/qcom/qcom,apr.yaml      | 2 +-
>  Documentation/devicetree/bindings/soc/qcom/qcom,smem.yaml     | 2 +-
>  Documentation/devicetree/bindings/soc/qcom/qcom,spm.yaml      | 2 +-
>  Documentation/devicetree/bindings/soc/qcom/qcom-stats.yaml    | 2 +-
>  Documentation/devicetree/bindings/soc/samsung/exynos-usi.yaml | 2 +-
>  Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml   | 2 +-
>  Documentation/devicetree/bindings/sound/audio-graph-port.yaml | 2 +-
>  Documentation/devicetree/bindings/sound/cirrus,cs42l51.yaml   | 2 +-
>  Documentation/devicetree/bindings/sound/ingenic,aic.yaml      | 2 +-
>  Documentation/devicetree/bindings/sound/ingenic,codec.yaml    | 2 +-
>  Documentation/devicetree/bindings/sound/marvell,mmp-sspa.yaml | 2 +-
>  Documentation/devicetree/bindings/sound/qcom,lpass-cpu.yaml   | 2 +-
>  .../devicetree/bindings/sound/qcom,lpass-rx-macro.yaml        | 2 +-
>  .../devicetree/bindings/sound/qcom,lpass-tx-macro.yaml        | 2 +-
>  .../devicetree/bindings/sound/qcom,lpass-va-macro.yaml        | 2 +-
>  .../devicetree/bindings/sound/qcom,lpass-wsa-macro.yaml       | 2 +-
>  Documentation/devicetree/bindings/sound/qcom,q6apm-dai.yaml   | 2 +-
>  .../devicetree/bindings/sound/qcom,q6dsp-lpass-clocks.yaml    | 2 +-
>  .../devicetree/bindings/sound/qcom,q6dsp-lpass-ports.yaml     | 2 +-
>  Documentation/devicetree/bindings/sound/qcom,wcd934x.yaml     | 2 +-
>  Documentation/devicetree/bindings/sound/qcom,wcd938x-sdw.yaml | 2 +-
>  Documentation/devicetree/bindings/sound/qcom,wcd938x.yaml     | 2 +-
>  Documentation/devicetree/bindings/sound/qcom,wsa881x.yaml     | 2 +-
>  Documentation/devicetree/bindings/sound/qcom,wsa883x.yaml     | 2 +-
>  Documentation/devicetree/bindings/sound/realtek,rt1015p.yaml  | 2 +-
>  Documentation/devicetree/bindings/sound/realtek,rt5682s.yaml  | 2 +-
>  Documentation/devicetree/bindings/sound/ti,src4xxx.yaml       | 2 +-
>  .../devicetree/bindings/soundwire/soundwire-controller.yaml   | 2 +-
>  Documentation/devicetree/bindings/spi/aspeed,ast2600-fmc.yaml | 2 +-
>  Documentation/devicetree/bindings/spi/ingenic,spi.yaml        | 2 +-
>  Documentation/devicetree/bindings/spi/marvell,mmp2-ssp.yaml   | 2 +-
>  Documentation/devicetree/bindings/spi/omap-spi.yaml           | 2 +-
>  Documentation/devicetree/bindings/spi/spi-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/spi/spi-gpio.yaml           | 2 +-
>  Documentation/devicetree/bindings/spi/st,stm32-qspi.yaml      | 2 +-
>  Documentation/devicetree/bindings/spi/st,stm32-spi.yaml       | 2 +-
>  .../devicetree/bindings/thermal/fsl,scu-thermal.yaml          | 2 +-
>  Documentation/devicetree/bindings/thermal/imx-thermal.yaml    | 2 +-
>  Documentation/devicetree/bindings/thermal/imx8mm-thermal.yaml | 2 +-
>  Documentation/devicetree/bindings/thermal/sprd-thermal.yaml   | 2 +-
>  .../devicetree/bindings/thermal/st,stm32-thermal.yaml         | 2 +-
>  .../devicetree/bindings/thermal/thermal-cooling-devices.yaml  | 2 +-
>  Documentation/devicetree/bindings/thermal/thermal-idle.yaml   | 2 +-
>  Documentation/devicetree/bindings/thermal/thermal-sensor.yaml | 2 +-
>  Documentation/devicetree/bindings/thermal/thermal-zones.yaml  | 2 +-
>  .../devicetree/bindings/thermal/ti,am654-thermal.yaml         | 2 +-
>  .../devicetree/bindings/thermal/ti,j72xx-thermal.yaml         | 2 +-
>  Documentation/devicetree/bindings/timer/ingenic,sysost.yaml   | 2 +-
>  Documentation/devicetree/bindings/timer/ingenic,tcu.yaml      | 2 +-
>  Documentation/devicetree/bindings/timer/mrvl,mmp-timer.yaml   | 2 +-
>  Documentation/devicetree/bindings/timer/st,stm32-timer.yaml   | 2 +-
>  Documentation/devicetree/bindings/usb/analogix,anx7411.yaml   | 2 +-
>  Documentation/devicetree/bindings/usb/cdns,usb3.yaml          | 2 +-
>  Documentation/devicetree/bindings/usb/dwc2.yaml               | 2 +-
>  Documentation/devicetree/bindings/usb/faraday,fotg210.yaml    | 2 +-
>  Documentation/devicetree/bindings/usb/ingenic,musb.yaml       | 2 +-
>  .../devicetree/bindings/usb/marvell,pxau2o-ehci.yaml          | 2 +-
>  Documentation/devicetree/bindings/usb/maxim,max33359.yaml     | 2 +-
>  .../devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml         | 2 +-
>  Documentation/devicetree/bindings/usb/nvidia,tegra-xudc.yaml  | 2 +-
>  Documentation/devicetree/bindings/usb/nxp,isp1760.yaml        | 2 +-
>  Documentation/devicetree/bindings/usb/realtek,rts5411.yaml    | 2 +-
>  Documentation/devicetree/bindings/usb/richtek,rt1719.yaml     | 2 +-
>  Documentation/devicetree/bindings/usb/st,stusb160x.yaml       | 2 +-
>  Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml       | 2 +-
>  Documentation/devicetree/bindings/usb/ti,tps6598x.yaml        | 2 +-
>  Documentation/devicetree/bindings/usb/ti,usb8041.yaml         | 2 +-
>  Documentation/devicetree/bindings/usb/usb-device.yaml         | 2 +-
>  Documentation/devicetree/bindings/usb/willsemi,wusb3801.yaml  | 2 +-
>  Documentation/devicetree/bindings/virtio/virtio-device.yaml   | 2 +-
>  Documentation/devicetree/bindings/watchdog/fsl,scu-wdt.yaml   | 2 +-
>  Documentation/devicetree/bindings/watchdog/st,stm32-iwdg.yaml | 2 +-
>  Documentation/devicetree/bindings/watchdog/watchdog.yaml      | 2 +-
>  472 files changed, 474 insertions(+), 474 deletions(-)
> 
> -- 
> 2.34.1
> 

-- 
Alexandre Belloni, co-owner and COO, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 12:38 ` [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Krzysztof Kozlowski
                     ` (2 preceding siblings ...)
  2022-11-17 15:17   ` Jonathan Cameron
@ 2022-11-17 17:19   ` Rob Herring
  2022-11-17 17:38     ` Krzysztof Kozlowski
  2022-11-17 17:52   ` Conor Dooley
  2022-11-17 21:07   ` Miquel Raynal
  5 siblings, 1 reply; 26+ messages in thread
From: Rob Herring @ 2022-11-17 17:19 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Krzysztof Kozlowski, Andrew Lunn, devicetree, linux-arm-kernel,
	linux-kernel, linux-clk, linux-riscv, linux-arm-msm, linux-pm,
	linux-gpio, linux-iio, linux-input, linux-leds, linux-media,
	linux-mips, linux-mmc, linux-mtd, netdev, linux-can, linux-pci,
	linux-pwm, linux-rtc, linux-serial, alsa-devel, linux-spi,
	linux-usb, virtualization, linux-watchdog

On Thu, Nov 17, 2022 at 01:38:42PM +0100, Krzysztof Kozlowski wrote:
> The Devicetree bindings document does not have to say in the title that
> it is a "binding", but instead just describe the hardware.  For shared
> (re-usable) schemas, name them all as "common properties".

It's titles, so capitalize 'Common Properties'. Someday we may generate 
a document from all the schemas.

> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> ---
>  Documentation/devicetree/bindings/clock/qcom,gcc.yaml         | 2 +-
>  Documentation/devicetree/bindings/dma/dma-common.yaml         | 2 +-
>  Documentation/devicetree/bindings/dma/dma-controller.yaml     | 4 ++--
>  Documentation/devicetree/bindings/dma/dma-router.yaml         | 4 ++--
>  Documentation/devicetree/bindings/iio/adc/adc.yaml            | 2 +-
>  .../devicetree/bindings/media/video-interface-devices.yaml    | 2 +-
>  Documentation/devicetree/bindings/media/video-interfaces.yaml | 2 +-
>  Documentation/devicetree/bindings/mmc/mmc-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/mtd/nand-chip.yaml          | 2 +-
>  Documentation/devicetree/bindings/mtd/nand-controller.yaml    | 2 +-
>  .../bindings/net/bluetooth/bluetooth-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/can/can-controller.yaml | 2 +-
>  .../devicetree/bindings/net/ethernet-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/ethernet-phy.yaml       | 2 +-
>  Documentation/devicetree/bindings/net/mdio.yaml               | 2 +-
>  Documentation/devicetree/bindings/opp/opp-v2-base.yaml        | 2 +-
>  .../devicetree/bindings/power/reset/restart-handler.yaml      | 2 +-
>  Documentation/devicetree/bindings/rtc/rtc.yaml                | 2 +-
>  .../devicetree/bindings/soundwire/soundwire-controller.yaml   | 2 +-
>  Documentation/devicetree/bindings/spi/spi-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/watchdog/watchdog.yaml      | 2 +-
>  21 files changed, 23 insertions(+), 23 deletions(-)
> 
> diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> index 1ab416c83c8d..d2de3d128b73 100644
> --- a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> +++ b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/clock/qcom,gcc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Qualcomm Global Clock & Reset Controller Common Bindings
> +title: Qualcomm Global Clock & Reset Controller common parts
>  
>  maintainers:
>    - Stephen Boyd <sboyd@kernel.org>
> diff --git a/Documentation/devicetree/bindings/dma/dma-common.yaml b/Documentation/devicetree/bindings/dma/dma-common.yaml
> index ad06d36af208..9b7b94fdbb0b 100644
> --- a/Documentation/devicetree/bindings/dma/dma-common.yaml
> +++ b/Documentation/devicetree/bindings/dma/dma-common.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/dma/dma-common.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: DMA Engine Generic Binding
> +title: DMA Engine common properties
>  
>  maintainers:
>    - Vinod Koul <vkoul@kernel.org>
> diff --git a/Documentation/devicetree/bindings/dma/dma-controller.yaml b/Documentation/devicetree/bindings/dma/dma-controller.yaml
> index 6d3727267fa8..225a141c7b5c 100644
> --- a/Documentation/devicetree/bindings/dma/dma-controller.yaml
> +++ b/Documentation/devicetree/bindings/dma/dma-controller.yaml
> @@ -4,13 +4,13 @@
>  $id: http://devicetree.org/schemas/dma/dma-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: DMA Controller Generic Binding
> +title: DMA Controller common properties
>  
>  maintainers:
>    - Vinod Koul <vkoul@kernel.org>
>  
>  allOf:
> -  - $ref: "dma-common.yaml#"
> +  - $ref: dma-common.yaml#
>  
>  # Everything else is described in the common file
>  properties:
> diff --git a/Documentation/devicetree/bindings/dma/dma-router.yaml b/Documentation/devicetree/bindings/dma/dma-router.yaml
> index 4b817f5dc30e..0ebd7bc6232b 100644
> --- a/Documentation/devicetree/bindings/dma/dma-router.yaml
> +++ b/Documentation/devicetree/bindings/dma/dma-router.yaml
> @@ -4,13 +4,13 @@
>  $id: http://devicetree.org/schemas/dma/dma-router.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: DMA Router Generic Binding
> +title: DMA Router common properties
>  
>  maintainers:
>    - Vinod Koul <vkoul@kernel.org>
>  
>  allOf:
> -  - $ref: "dma-common.yaml#"
> +  - $ref: dma-common.yaml#
>  
>  description:
>    DMA routers are transparent IP blocks used to route DMA request
> diff --git a/Documentation/devicetree/bindings/iio/adc/adc.yaml b/Documentation/devicetree/bindings/iio/adc/adc.yaml
> index db348fcbb52c..bd0f5fae256e 100644
> --- a/Documentation/devicetree/bindings/iio/adc/adc.yaml
> +++ b/Documentation/devicetree/bindings/iio/adc/adc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/iio/adc/adc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Generic IIO bindings for ADC channels
> +title: IIO common properties for ADC channels
>  
>  maintainers:
>    - Jonathan Cameron <jic23@kernel.org>
> diff --git a/Documentation/devicetree/bindings/media/video-interface-devices.yaml b/Documentation/devicetree/bindings/media/video-interface-devices.yaml
> index 4527f56a5a6e..bd719cb1813e 100644
> --- a/Documentation/devicetree/bindings/media/video-interface-devices.yaml
> +++ b/Documentation/devicetree/bindings/media/video-interface-devices.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/media/video-interface-devices.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Common bindings for video receiver and transmitter devices
> +title: Common properties for video receiver and transmitter devices
>  
>  maintainers:
>    - Jacopo Mondi <jacopo@jmondi.org>
> diff --git a/Documentation/devicetree/bindings/media/video-interfaces.yaml b/Documentation/devicetree/bindings/media/video-interfaces.yaml
> index 68c3b9871cf3..e8cf73794772 100644
> --- a/Documentation/devicetree/bindings/media/video-interfaces.yaml
> +++ b/Documentation/devicetree/bindings/media/video-interfaces.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/media/video-interfaces.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Common bindings for video receiver and transmitter interface endpoints
> +title: Common properties for video receiver and transmitter interface endpoints
>  
>  maintainers:
>    - Sakari Ailus <sakari.ailus@linux.intel.com>
> diff --git a/Documentation/devicetree/bindings/mmc/mmc-controller.yaml b/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
> index 802e3ca8be4d..a17f49738abd 100644
> --- a/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
> +++ b/Documentation/devicetree/bindings/mmc/mmc-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mmc/mmc-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: MMC Controller Generic Binding
> +title: MMC Controller common properties
>  
>  maintainers:
>    - Ulf Hansson <ulf.hansson@linaro.org>
> diff --git a/Documentation/devicetree/bindings/mtd/nand-chip.yaml b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> index 97ac3a3fbb52..20b195ef9b70 100644
> --- a/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> +++ b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mtd/nand-chip.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NAND Chip and NAND Controller Generic Binding
> +title: NAND Chip and NAND Controller common properties
>  
>  maintainers:
>    - Miquel Raynal <miquel.raynal@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/mtd/nand-controller.yaml b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> index 359a015d4e5a..a004efc42842 100644
> --- a/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> +++ b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mtd/nand-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NAND Chip and NAND Controller Generic Binding
> +title: NAND Chip and NAND Controller common properties
>  
>  maintainers:
>    - Miquel Raynal <miquel.raynal@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml b/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
> index 9309dc40f54f..8715adff5eaf 100644
> --- a/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
> +++ b/Documentation/devicetree/bindings/net/bluetooth/bluetooth-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/bluetooth/bluetooth-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Bluetooth Controller Generic Binding
> +title: Bluetooth Controller common properties
>  
>  maintainers:
>    - Marcel Holtmann <marcel@holtmann.org>
> diff --git a/Documentation/devicetree/bindings/net/can/can-controller.yaml b/Documentation/devicetree/bindings/net/can/can-controller.yaml
> index 1f0e98051074..3747b46cf9b6 100644
> --- a/Documentation/devicetree/bindings/net/can/can-controller.yaml
> +++ b/Documentation/devicetree/bindings/net/can/can-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/can/can-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: CAN Controller Generic Binding
> +title: CAN Controller common properties
>  
>  maintainers:
>    - Marc Kleine-Budde <mkl@pengutronix.de>
> diff --git a/Documentation/devicetree/bindings/net/ethernet-controller.yaml b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
> index 3aef506fa158..26502c0f2aff 100644
> --- a/Documentation/devicetree/bindings/net/ethernet-controller.yaml
> +++ b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/ethernet-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ethernet Controller Generic Binding
> +title: Ethernet Controller common properties
>  
>  maintainers:
>    - David S. Miller <davem@davemloft.net>
> diff --git a/Documentation/devicetree/bindings/net/ethernet-phy.yaml b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> index ad808e9ce5b9..0aa1b60e78cc 100644
> --- a/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> +++ b/Documentation/devicetree/bindings/net/ethernet-phy.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/ethernet-phy.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Ethernet PHY Generic Binding
> +title: Ethernet PHY common properties
>  
>  maintainers:
>    - Andrew Lunn <andrew@lunn.ch>
> diff --git a/Documentation/devicetree/bindings/net/mdio.yaml b/Documentation/devicetree/bindings/net/mdio.yaml
> index b5706d4e7e38..b184689dd6b2 100644
> --- a/Documentation/devicetree/bindings/net/mdio.yaml
> +++ b/Documentation/devicetree/bindings/net/mdio.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/net/mdio.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: MDIO Bus Generic Binding
> +title: MDIO Bus common properties
>  
>  maintainers:
>    - Andrew Lunn <andrew@lunn.ch>
> diff --git a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> index cf9c2f7bddc2..20ac432dc683 100644
> --- a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> +++ b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/opp/opp-v2-base.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Generic OPP (Operating Performance Points) Common Binding
> +title: Generic OPP (Operating Performance Points) common parts
>  
>  maintainers:
>    - Viresh Kumar <viresh.kumar@linaro.org>
> diff --git a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
> index 1f9a2aac53c0..8b52fd156d4c 100644
> --- a/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
> +++ b/Documentation/devicetree/bindings/power/reset/restart-handler.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/power/reset/restart-handler.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Restart and shutdown handler generic binding
> +title: Restart and shutdown handler common properties
>  
>  maintainers:
>    - Sebastian Reichel <sre@kernel.org>
> diff --git a/Documentation/devicetree/bindings/rtc/rtc.yaml b/Documentation/devicetree/bindings/rtc/rtc.yaml
> index 0ec3551f12dd..00848a5a409e 100644
> --- a/Documentation/devicetree/bindings/rtc/rtc.yaml
> +++ b/Documentation/devicetree/bindings/rtc/rtc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/rtc/rtc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: RTC Generic Binding
> +title: Real Time Clock common properties
>  
>  maintainers:
>    - Alexandre Belloni <alexandre.belloni@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml b/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
> index 4aad121eff3f..2176033850dc 100644
> --- a/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
> +++ b/Documentation/devicetree/bindings/soundwire/soundwire-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/soundwire/soundwire-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: SoundWire Controller Generic Binding
> +title: SoundWire Controller common properties
>  
>  maintainers:
>    - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
> diff --git a/Documentation/devicetree/bindings/spi/spi-controller.yaml b/Documentation/devicetree/bindings/spi/spi-controller.yaml
> index 01042a7f382e..6bbe073f894b 100644
> --- a/Documentation/devicetree/bindings/spi/spi-controller.yaml
> +++ b/Documentation/devicetree/bindings/spi/spi-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/spi/spi-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: SPI Controller Generic Binding
> +title: SPI Controller common properties
>  
>  maintainers:
>    - Mark Brown <broonie@kernel.org>
> diff --git a/Documentation/devicetree/bindings/watchdog/watchdog.yaml b/Documentation/devicetree/bindings/watchdog/watchdog.yaml
> index e3dfb02f0ca5..6875cf1c3159 100644
> --- a/Documentation/devicetree/bindings/watchdog/watchdog.yaml
> +++ b/Documentation/devicetree/bindings/watchdog/watchdog.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/watchdog/watchdog.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Watchdog Generic Bindings
> +title: Watchdog common properties
>  
>  maintainers:
>    - Guenter Roeck <linux@roeck-us.net>
> -- 
> 2.34.1
> 
> 

^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 17:19   ` Rob Herring
@ 2022-11-17 17:38     ` Krzysztof Kozlowski
  0 siblings, 0 replies; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-17 17:38 UTC (permalink / raw)
  To: Rob Herring
  Cc: Krzysztof Kozlowski, Andrew Lunn, devicetree, linux-arm-kernel,
	linux-kernel, linux-clk, linux-riscv, linux-arm-msm, linux-pm,
	linux-gpio, linux-iio, linux-input, linux-leds, linux-media,
	linux-mips, linux-mmc, linux-mtd, netdev, linux-can, linux-pci,
	linux-pwm, linux-rtc, linux-serial, alsa-devel, linux-spi,
	linux-usb, virtualization, linux-watchdog

On 17/11/2022 18:19, Rob Herring wrote:
> On Thu, Nov 17, 2022 at 01:38:42PM +0100, Krzysztof Kozlowski wrote:
>> The Devicetree bindings document does not have to say in the title that
>> it is a "binding", but instead just describe the hardware.  For shared
>> (re-usable) schemas, name them all as "common properties".
> 
> It's titles, so capitalize 'Common Properties'. Someday we may generate 
> a document from all the schemas.
> 

Ack.

Best regards,
Krzysztof


^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 12:38 ` [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Krzysztof Kozlowski
                     ` (3 preceding siblings ...)
  2022-11-17 17:19   ` Rob Herring
@ 2022-11-17 17:52   ` Conor Dooley
  2022-11-18  8:27     ` Krzysztof Kozlowski
  2022-11-17 21:07   ` Miquel Raynal
  5 siblings, 1 reply; 26+ messages in thread
From: Conor Dooley @ 2022-11-17 17:52 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On Thu, Nov 17, 2022 at 01:38:42PM +0100, Krzysztof Kozlowski wrote:
> The Devicetree bindings document does not have to say in the title that
> it is a "binding", but instead just describe the hardware.  For shared
> (re-usable) schemas, name them all as "common properties".


> diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> index 1ab416c83c8d..d2de3d128b73 100644
> --- a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> +++ b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/clock/qcom,gcc.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Qualcomm Global Clock & Reset Controller Common Bindings
> +title: Qualcomm Global Clock & Reset Controller common parts
>  
>  maintainers:
>    - Stephen Boyd <sboyd@kernel.org>


> diff --git a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> index cf9c2f7bddc2..20ac432dc683 100644
> --- a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> +++ b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/opp/opp-v2-base.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: Generic OPP (Operating Performance Points) Common Binding
> +title: Generic OPP (Operating Performance Points) common parts
>  
>  maintainers:
>    - Viresh Kumar <viresh.kumar@linaro.org>

Hey Krzysztof,

Hopefully I've not overlooked something obvious, but it wasnt noted in
the commit message - how come these two are "parts" rather than
"properties"? The opp one at least don't seem to have much more than
properties and patterProperties in it.

Thanks,
Conor.


^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 12:38 ` [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Krzysztof Kozlowski
                     ` (4 preceding siblings ...)
  2022-11-17 17:52   ` Conor Dooley
@ 2022-11-17 21:07   ` Miquel Raynal
  2022-11-18  8:28     ` Krzysztof Kozlowski
  5 siblings, 1 reply; 26+ messages in thread
From: Miquel Raynal @ 2022-11-17 21:07 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

Hi Krzysztof,

krzysztof.kozlowski@linaro.org wrote on Thu, 17 Nov 2022 13:38:42 +0100:

> The Devicetree bindings document does not have to say in the title that
> it is a "binding", but instead just describe the hardware.  For shared
> (re-usable) schemas, name them all as "common properties".
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> ---
>  Documentation/devicetree/bindings/clock/qcom,gcc.yaml         | 2 +-
>  Documentation/devicetree/bindings/dma/dma-common.yaml         | 2 +-
>  Documentation/devicetree/bindings/dma/dma-controller.yaml     | 4 ++--
>  Documentation/devicetree/bindings/dma/dma-router.yaml         | 4 ++--
>  Documentation/devicetree/bindings/iio/adc/adc.yaml            | 2 +-
>  .../devicetree/bindings/media/video-interface-devices.yaml    | 2 +-
>  Documentation/devicetree/bindings/media/video-interfaces.yaml | 2 +-
>  Documentation/devicetree/bindings/mmc/mmc-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/mtd/nand-chip.yaml          | 2 +-
>  Documentation/devicetree/bindings/mtd/nand-controller.yaml    | 2 +-
>  .../bindings/net/bluetooth/bluetooth-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/can/can-controller.yaml | 2 +-
>  .../devicetree/bindings/net/ethernet-controller.yaml          | 2 +-
>  Documentation/devicetree/bindings/net/ethernet-phy.yaml       | 2 +-
>  Documentation/devicetree/bindings/net/mdio.yaml               | 2 +-
>  Documentation/devicetree/bindings/opp/opp-v2-base.yaml        | 2 +-
>  .../devicetree/bindings/power/reset/restart-handler.yaml      | 2 +-
>  Documentation/devicetree/bindings/rtc/rtc.yaml                | 2 +-
>  .../devicetree/bindings/soundwire/soundwire-controller.yaml   | 2 +-
>  Documentation/devicetree/bindings/spi/spi-controller.yaml     | 2 +-
>  Documentation/devicetree/bindings/watchdog/watchdog.yaml      | 2 +-
>  21 files changed, 23 insertions(+), 23 deletions(-)
> 

[...]

> diff --git a/Documentation/devicetree/bindings/mtd/nand-chip.yaml b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> index 97ac3a3fbb52..20b195ef9b70 100644
> --- a/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> +++ b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mtd/nand-chip.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NAND Chip and NAND Controller Generic Binding
> +title: NAND Chip and NAND Controller common properties

I only see this now but the title should be

	"NAND chip common properties"

>  
>  maintainers:
>    - Miquel Raynal <miquel.raynal@bootlin.com>
> diff --git a/Documentation/devicetree/bindings/mtd/nand-controller.yaml b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> index 359a015d4e5a..a004efc42842 100644
> --- a/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> +++ b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
> @@ -4,7 +4,7 @@
>  $id: http://devicetree.org/schemas/mtd/nand-controller.yaml#
>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>  
> -title: NAND Chip and NAND Controller Generic Binding
> +title: NAND Chip and NAND Controller common properties

And here just "NAND controller..."

Of course the original purpose of your series is more to clean those
titles rather than fixing them and if you disagree I am fine doing it
myself aside, but if you could at the same time make the title more
accurate that would be perfect.

Either ways:

Acked-by: Miquel Raynal <miquel.raynal@bootlin.com>

Cheers,
Miquèl

^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 17:52   ` Conor Dooley
@ 2022-11-18  8:27     ` Krzysztof Kozlowski
  0 siblings, 0 replies; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-18  8:27 UTC (permalink / raw)
  To: Conor Dooley
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On 17/11/2022 18:52, Conor Dooley wrote:
> On Thu, Nov 17, 2022 at 01:38:42PM +0100, Krzysztof Kozlowski wrote:
>> The Devicetree bindings document does not have to say in the title that
>> it is a "binding", but instead just describe the hardware.  For shared
>> (re-usable) schemas, name them all as "common properties".
> 
> 
>> diff --git a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
>> index 1ab416c83c8d..d2de3d128b73 100644
>> --- a/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
>> +++ b/Documentation/devicetree/bindings/clock/qcom,gcc.yaml
>> @@ -4,7 +4,7 @@
>>  $id: http://devicetree.org/schemas/clock/qcom,gcc.yaml#
>>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>>  
>> -title: Qualcomm Global Clock & Reset Controller Common Bindings
>> +title: Qualcomm Global Clock & Reset Controller common parts
>>  
>>  maintainers:
>>    - Stephen Boyd <sboyd@kernel.org>
> 
> 
>> diff --git a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
>> index cf9c2f7bddc2..20ac432dc683 100644
>> --- a/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
>> +++ b/Documentation/devicetree/bindings/opp/opp-v2-base.yaml
>> @@ -4,7 +4,7 @@
>>  $id: http://devicetree.org/schemas/opp/opp-v2-base.yaml#
>>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>>  
>> -title: Generic OPP (Operating Performance Points) Common Binding
>> +title: Generic OPP (Operating Performance Points) common parts
>>  
>>  maintainers:
>>    - Viresh Kumar <viresh.kumar@linaro.org>
> 
> Hey Krzysztof,
> 
> Hopefully I've not overlooked something obvious, but it wasnt noted in
> the commit message - how come these two are "parts" rather than
> "properties"? The opp one at least don't seem to have much more than
> properties and patterProperties in it.

They should be properties, will fix in v2.


Best regards,
Krzysztof


^ permalink raw reply	[flat|nested] 26+ messages in thread

* Re: [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings
  2022-11-17 21:07   ` Miquel Raynal
@ 2022-11-18  8:28     ` Krzysztof Kozlowski
  0 siblings, 0 replies; 26+ messages in thread
From: Krzysztof Kozlowski @ 2022-11-18  8:28 UTC (permalink / raw)
  To: Miquel Raynal
  Cc: Rob Herring, Krzysztof Kozlowski, Andrew Lunn, devicetree,
	linux-arm-kernel, linux-kernel, linux-clk, linux-riscv,
	linux-arm-msm, linux-pm, linux-gpio, linux-iio, linux-input,
	linux-leds, linux-media, linux-mips, linux-mmc, linux-mtd,
	netdev, linux-can, linux-pci, linux-pwm, linux-rtc, linux-serial,
	alsa-devel, linux-spi, linux-usb, virtualization, linux-watchdog

On 17/11/2022 22:07, Miquel Raynal wrote:
> Hi Krzysztof,
> 
> krzysztof.kozlowski@linaro.org wrote on Thu, 17 Nov 2022 13:38:42 +0100:
> 
>> The Devicetree bindings document does not have to say in the title that
>> it is a "binding", but instead just describe the hardware.  For shared
>> (re-usable) schemas, name them all as "common properties".
>>
>> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
>> ---
>>  Documentation/devicetree/bindings/clock/qcom,gcc.yaml         | 2 +-
>>  Documentation/devicetree/bindings/dma/dma-common.yaml         | 2 +-
>>  Documentation/devicetree/bindings/dma/dma-controller.yaml     | 4 ++--
>>  Documentation/devicetree/bindings/dma/dma-router.yaml         | 4 ++--
>>  Documentation/devicetree/bindings/iio/adc/adc.yaml            | 2 +-
>>  .../devicetree/bindings/media/video-interface-devices.yaml    | 2 +-
>>  Documentation/devicetree/bindings/media/video-interfaces.yaml | 2 +-
>>  Documentation/devicetree/bindings/mmc/mmc-controller.yaml     | 2 +-
>>  Documentation/devicetree/bindings/mtd/nand-chip.yaml          | 2 +-
>>  Documentation/devicetree/bindings/mtd/nand-controller.yaml    | 2 +-
>>  .../bindings/net/bluetooth/bluetooth-controller.yaml          | 2 +-
>>  Documentation/devicetree/bindings/net/can/can-controller.yaml | 2 +-
>>  .../devicetree/bindings/net/ethernet-controller.yaml          | 2 +-
>>  Documentation/devicetree/bindings/net/ethernet-phy.yaml       | 2 +-
>>  Documentation/devicetree/bindings/net/mdio.yaml               | 2 +-
>>  Documentation/devicetree/bindings/opp/opp-v2-base.yaml        | 2 +-
>>  .../devicetree/bindings/power/reset/restart-handler.yaml      | 2 +-
>>  Documentation/devicetree/bindings/rtc/rtc.yaml                | 2 +-
>>  .../devicetree/bindings/soundwire/soundwire-controller.yaml   | 2 +-
>>  Documentation/devicetree/bindings/spi/spi-controller.yaml     | 2 +-
>>  Documentation/devicetree/bindings/watchdog/watchdog.yaml      | 2 +-
>>  21 files changed, 23 insertions(+), 23 deletions(-)
>>
> 
> [...]
> 
>> diff --git a/Documentation/devicetree/bindings/mtd/nand-chip.yaml b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
>> index 97ac3a3fbb52..20b195ef9b70 100644
>> --- a/Documentation/devicetree/bindings/mtd/nand-chip.yaml
>> +++ b/Documentation/devicetree/bindings/mtd/nand-chip.yaml
>> @@ -4,7 +4,7 @@
>>  $id: http://devicetree.org/schemas/mtd/nand-chip.yaml#
>>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>>  
>> -title: NAND Chip and NAND Controller Generic Binding
>> +title: NAND Chip and NAND Controller common properties
> 
> I only see this now but the title should be
> 
> 	"NAND chip common properties"
> 
>>  
>>  maintainers:
>>    - Miquel Raynal <miquel.raynal@bootlin.com>
>> diff --git a/Documentation/devicetree/bindings/mtd/nand-controller.yaml b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
>> index 359a015d4e5a..a004efc42842 100644
>> --- a/Documentation/devicetree/bindings/mtd/nand-controller.yaml
>> +++ b/Documentation/devicetree/bindings/mtd/nand-controller.yaml
>> @@ -4,7 +4,7 @@
>>  $id: http://devicetree.org/schemas/mtd/nand-controller.yaml#
>>  $schema: http://devicetree.org/meta-schemas/core.yaml#
>>  
>> -title: NAND Chip and NAND Controller Generic Binding
>> +title: NAND Chip and NAND Controller common properties
> 
> And here just "NAND controller..."
> 
> Of course the original purpose of your series is more to clean those
> titles rather than fixing them and if you disagree I am fine doing it
> myself aside, but if you could at the same time make the title more
> accurate that would be perfect.
> 
> Either ways:
> 
> Acked-by: Miquel Raynal <miquel.raynal@bootlin.com>

Thanks, I update these manually, so I can correct the names to ones you
mentioned. Thanks.

Best regards,
Krzysztof


^ permalink raw reply	[flat|nested] 26+ messages in thread

end of thread, other threads:[~2022-11-18  8:29 UTC | newest]

Thread overview: 26+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-11-17 12:38 [RFC PATCH 0/9] dt-bindings: cleanup titles Krzysztof Kozlowski
2022-11-17 12:38 ` [RFC PATCH 1/9] dt-bindings: drop redundant part of title of shared bindings Krzysztof Kozlowski
2022-11-17 13:23   ` Andrew Lunn
2022-11-17 14:58     ` Krzysztof Kozlowski
2022-11-17 14:33   ` Guenter Roeck
2022-11-17 15:17   ` Jonathan Cameron
2022-11-17 17:19   ` Rob Herring
2022-11-17 17:38     ` Krzysztof Kozlowski
2022-11-17 17:52   ` Conor Dooley
2022-11-18  8:27     ` Krzysztof Kozlowski
2022-11-17 21:07   ` Miquel Raynal
2022-11-18  8:28     ` Krzysztof Kozlowski
2022-11-17 12:38 ` [RFC PATCH 2/9] dt-bindings: memory-controllers: ti,gpmc-child: drop redundant part of title Krzysztof Kozlowski
2022-11-17 12:38 ` [RFC PATCH 3/9] dt-bindings: clock: st,stm32mp1-rcc: add proper title Krzysztof Kozlowski
2022-11-17 12:38 ` [RFC PATCH 4/9] dt-bindings: drop redundant part of title (end) Krzysztof Kozlowski
2022-11-17 15:18   ` Jonathan Cameron
2022-11-17 15:37   ` Jonathan Cameron
2022-11-17 12:38 ` [RFC PATCH 5/9] dt-bindings: drop redundant part of title (end, part two) Krzysztof Kozlowski
2022-11-17 15:58   ` Jonathan Cameron
2022-11-17 12:38 ` [RFC PATCH 7/9] dt-bindings: drop redundant part of title (beginning) Krzysztof Kozlowski
2022-11-17 16:01   ` Jonathan Cameron
2022-11-17 12:38 ` [RFC PATCH 8/9] dt-bindings: clock: drop redundant part of title Krzysztof Kozlowski
2022-11-17 16:03   ` Jonathan Cameron
2022-11-17 12:38 ` [RFC PATCH 9/9] dt-bindings: drop redundant part of title (manual) Krzysztof Kozlowski
2022-11-17 16:05   ` Jonathan Cameron
2022-11-17 16:13 ` [RFC PATCH 0/9] dt-bindings: cleanup titles Alexandre Belloni

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).