Re: [PATCH v4 0/2] Documentation: Restore device-ID documentation

[Jonathan Corbet <corbet@lwn.net>]

Karl Mehltretter <kmehltretter@gmail.com> writes:

> 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@gmail.com/
> - 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@kernel.org/
> - 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@trenco.lwn.net/
>
> 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(-)

Applied, thanks.

jon