Netdev List
 help / color / mirror / Atom feed
* [PATCH v2 0/4] dt-bindings: remove redundant .txt redirect stubs
@ 2026-06-03 20:42 Akash Sukhavasi
  2026-06-03 20:42 ` [PATCH v2 1/4] dt-bindings: net: remove obsolete mdio.txt Akash Sukhavasi
                   ` (4 more replies)
  0 siblings, 5 replies; 10+ messages in thread
From: Akash Sukhavasi @ 2026-06-03 20:42 UTC (permalink / raw)
  To: Andrew Lunn, Heiner Kallweit, Russell King, David S. Miller,
	Eric Dumazet, Jakub Kicinski, Paolo Abeni, Rob Herring,
	Krzysztof Kozlowski, Conor Dooley, Mauro Carvalho Chehab,
	Vladimir Oltean, Simon Horman, Jonathan Corbet, Shuah Khan,
	Dmitry Torokhov, Thierry Reding, Jonathan Hunter, Lee Jones
  Cc: netdev, devicetree, linux-kernel, linux-media, linux-doc,
	linux-input, linux-tegra, Akash Sukhavasi

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/

Patch 1 supersedes my earlier standalone submission:
https://lore.kernel.org/all/20260523004223.3045-1-akash.sukhavasi@gmail.com/

Signed-off-by: Akash Sukhavasi <akash.sukhavasi@gmail.com>
---
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

 Documentation/devicetree/bindings/input/brcm,bcm-keypad.txt    | 2 +-
 Documentation/devicetree/bindings/input/clps711x-keypad.txt    | 2 +-
 Documentation/devicetree/bindings/input/matrix-keymap.txt      | 1 -
 Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.txt | 2 +-
 Documentation/devicetree/bindings/input/pxa27x-keypad.txt      | 2 +-
 Documentation/devicetree/bindings/input/st-keyscan.txt         | 2 +-
 Documentation/devicetree/bindings/media/hix5hd2-ir.txt         | 2 +-
 Documentation/devicetree/bindings/media/rc.txt                 | 1 -
 Documentation/devicetree/bindings/mfd/tc3589x.txt              | 6 +++---
 Documentation/devicetree/bindings/net/dsa/dsa.txt              | 4 ----
 Documentation/devicetree/bindings/net/dsa/lan9303.txt          | 2 +-
 Documentation/devicetree/bindings/net/mdio.txt                 | 1 -
 Documentation/networking/dsa/dsa.rst                           | 2 +-
 13 files changed, 11 insertions(+), 18 deletions(-)
---
base-commit: b7bee4ca5688e30ca50fbc87b1b8f7eed7006c17
change-id: 20260603-b4-remove-redirect-stubs-899afc8fa7d6

Best regards,
-- 
Akash Sukhavasi <akash.sukhavasi@gmail.com>


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

end of thread, other threads:[~2026-06-03 22:26 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-06-03 20:42 [PATCH v2 0/4] dt-bindings: remove redundant .txt redirect stubs Akash Sukhavasi
2026-06-03 20:42 ` [PATCH v2 1/4] dt-bindings: net: remove obsolete mdio.txt Akash Sukhavasi
2026-06-03 22:19   ` Rob Herring (Arm)
2026-06-03 20:42 ` [PATCH v2 2/4] dt-bindings: media: remove obsolete rc.txt Akash Sukhavasi
2026-06-03 22:20   ` Rob Herring (Arm)
2026-06-03 20:42 ` [PATCH v2 3/4] dt-bindings: net: dsa: remove obsolete dsa.txt Akash Sukhavasi
2026-06-03 22:20   ` Rob Herring (Arm)
2026-06-03 20:42 ` [PATCH v2 4/4] dt-bindings: input: remove obsolete matrix-keymap.txt Akash Sukhavasi
2026-06-03 22:26   ` Rob Herring (Arm)
2026-06-03 22:21 ` [PATCH v2 0/4] dt-bindings: remove redundant .txt redirect stubs Rob Herring

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox