[PATCH v4 0/2] Documentation: Restore device-ID documentation
From: Karl Mehltretter
Date: Wed Oct 28 2026 - 21:40:30 EST
This v4 addresses the duplicate PCI declaration warnings Jonathan
reported on v3.
Patch 1 retains Uwe's device-ID documentation restoration. Patch 2
corrects the Chinese PCI header path and preserves its existing plain
references. The kernel-doc blocks added in v3 are dropped, with generated
API documentation deferred to a separate change.
A focused Sphinx 8.2.3 build with -W includes the complete English and
Chinese PCI pages together. It reproduces both warnings with v3 and
passes without warnings after each v4 patch.
Changes since v3:
https://lore.kernel.org/r/20260908070031.32833-1-kmehltretter@xxxxxxxxx/
- Move the Chinese PCI changes to patch 2. The five files in patch 1 are
unchanged from v3.
- Clarify the ACPI exclusion in patch 1's commit message using Uwe's
explanation to Andy. Only ACPI_DEVICE_CLASS() has kernel-doc in that
header.
- Retain Randy's review and test tags from v2 on patch 1.
Changes since v2:
https://lore.kernel.org/r/ede7ce64f20e10660ebf6bc1b41836dad750ae3b.1783349758.git.ukleinek@xxxxxxxxxx/
- Use the :file: role in pcmcia/driver.rst (Randy) and explain why acpi.h
is excluded.
Documenting struct mei_cl_driver in include/linux/mei_cl_bus.h remains
a separate follow-up.
Report: https://lore.kernel.org/r/87h5jq8gia.fsf@xxxxxxxxxxxxxx/
Karl Mehltretter (1):
docs/zh_CN: PCI: Update the pci_device_id header reference
Uwe Kleine-König (The Capable Hub) (1):
Documentation: Update after split of <linux/mod_devicetable.h>
Documentation/PCI/pci.rst | 2 +-
Documentation/driver-api/basics.rst | 31 +++++++++++++++++--
.../driver-api/mei/mei-client-bus.rst | 12 ++-----
Documentation/pcmcia/driver.rst | 2 +-
Documentation/staging/rpmsg.rst | 2 +-
Documentation/translations/zh_CN/PCI/pci.rst | 2 +-
6 files changed, 36 insertions(+), 15 deletions(-)
base-commit: 5b0764a53235d3c77e1ed674e836e1b3fe1a4b1f