On Wed, Jun 03, 2026 at 03:42:17PM -0500, Akash Sukhavasi wrote:
Several .txt files under Documentation/devicetree/bindings/ contain
only a redirect notice pointing to a .yaml schema with the same base
filename in the same directory. These stubs were useful during the
.txt to .yaml transition but are now redundant, since the .yaml is
discoverable by name. Meanwhile, other documentation still references
some of these stubs, forcing readers through an unnecessary extra hop
to reach the actual schema.
This series removes four such stubs and updates all remaining
cross-references to point directly to the .yaml schemas.
Other redirect stubs in the tree were evaluated and intentionally
kept:
- Stubs pointing to .yaml files with different names (e.g.,
spi-bus.txt -> spi-controller.yaml) serve as breadcrumbs for
the renamed schema.
- Stubs pointing to multiple .yaml files (e.g., nvmem.txt ->
nvmem.yaml and nvmem-consumer.yaml) convey that the content
was split.
- Stubs pointing to .yaml files in a different directory (e.g.,
reset/st,stm32-rcc.txt -> clock/st,stm32-rcc.yaml) serve as
cross-directory pointers.
Two additional same-name, same-directory stubs (leds/common.txt,
regulator/regulator.txt) have significantly more cross references
and will be addressed in a follow-up series.
v2:
- Patch 4/4: corrected commit message (eight references in six files, not
eight files), Sashiko review.
https://sashiko.dev/#/patchset/20260529052246.4934-1-akash.sukhavasi@gmail.com?part=4
v1: https://lore.kernel.org/all/20260529052246.4934-1-akash.sukhavasi@gmail.com/ (local)
Patch 1 supersedes my earlier standalone submission:
https://lore.kernel.org/all/20260523004223.3045-1-akash.sukhavasi@gmail.com/ (local)
Signed-off-by: Akash Sukhavasi <redacted>
---
Akash Sukhavasi (4):
dt-bindings: net: remove obsolete mdio.txt
dt-bindings: media: remove obsolete rc.txt
dt-bindings: net: dsa: remove obsolete dsa.txt
dt-bindings: input: remove obsolete matrix-keymap.txt
This goes to 3 different subsystems, so it should be 3 different series.
No need to resend just for that.
Rob