Merge branch 'mauro' into docs-next

Mauro sez: Patches 1 to 5 contain changes to the documentation toolset: - The first 3 patches help to reduce a lot the number of reported kernel-doc issues, by making the tool more smart. - Patches 4 and 5 are meant to partially address the PDF build, with now requires Sphinx version 2.4 or upper. The remaining patches fix broken references detected by this tool: ./scripts/documentation-file-ref-check and address other random errors due to tags being mis-interpreted or mis-used. They are independent each other, but some may depend on the kernel-doc improvements.
2026-10-16 22:39:48 +00:00 · 2020-04-20 16:58:17 -06:00 · 2020-04-20 16:58:17 -06:00 · 3f11de39c4
commit 3f11de39c4
parent 2f9c502552 4642289b5f
104 changed files with 1681 additions and 1667 deletions
--- a/Documentation/ABI/stable/sysfs-devices-node
+++ b/Documentation/ABI/stable/sysfs-devices-node
--- a/Documentation/ABI/testing/procfs-smaps_rollup
+++ b/Documentation/ABI/testing/procfs-smaps_rollup
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
--- a/Documentation/PCI/boot-interrupts.rst
+++ b/Documentation/PCI/boot-interrupts.rst
--- a/Documentation/admin-guide/cpu-load.rst
+++ b/Documentation/admin-guide/cpu-load.rst
--- a/Documentation/admin-guide/mm/userfaultfd.rst
+++ b/Documentation/admin-guide/mm/userfaultfd.rst
--- a/Documentation/admin-guide/nfs/nfsroot.rst
+++ b/Documentation/admin-guide/nfs/nfsroot.rst
--- a/Documentation/admin-guide/ras.rst
+++ b/Documentation/admin-guide/ras.rst
--- a/Documentation/arm64/amu.rst
+++ b/Documentation/arm64/amu.rst
--- a/Documentation/arm64/booting.rst
+++ b/Documentation/arm64/booting.rst
--- a/Documentation/conf.py
+++ b/Documentation/conf.py
--- a/Documentation/devicetree/bindings/net/qualcomm-bluetooth.txt
+++ b/Documentation/devicetree/bindings/net/qualcomm-bluetooth.txt
--- a/Documentation/devicetree/bindings/phy/ti,phy-j721e-wiz.yaml
+++ b/Documentation/devicetree/bindings/phy/ti,phy-j721e-wiz.yaml
--- a/Documentation/devicetree/bindings/usb/qcom,dwc3.txt
+++ b/Documentation/devicetree/bindings/usb/qcom,dwc3.txt
--- a/Documentation/devicetree/bindings/usb/rockchip,dwc3.txt
+++ b/Documentation/devicetree/bindings/usb/rockchip,dwc3.txt
--- a/Documentation/doc-guide/maintainer-profile.rst
+++ b/Documentation/doc-guide/maintainer-profile.rst
--- a/Documentation/driver-api/driver-model/device.rst
+++ b/Documentation/driver-api/driver-model/device.rst
--- a/Documentation/driver-api/driver-model/overview.rst
+++ b/Documentation/driver-api/driver-model/overview.rst
--- a/Documentation/filesystems/dax.txt
+++ b/Documentation/filesystems/dax.txt
--- a/Documentation/filesystems/dnotify.txt
+++ b/Documentation/filesystems/dnotify.txt
--- a/Documentation/filesystems/ramfs-rootfs-initramfs.rst
+++ b/Documentation/filesystems/ramfs-rootfs-initramfs.rst
--- a/Documentation/filesystems/sysfs.rst
+++ b/Documentation/filesystems/sysfs.rst
--- a/Documentation/i2c/i2c_bus.svg
+++ b/Documentation/i2c/i2c_bus.svg
--- a/Documentation/i2c/summary.rst
+++ b/Documentation/i2c/summary.rst
--- a/Documentation/memory-barriers.txt
+++ b/Documentation/memory-barriers.txt
--- a/Documentation/powerpc/cxl.rst
+++ b/Documentation/powerpc/cxl.rst
--- a/Documentation/powerpc/firmware-assisted-dump.rst
+++ b/Documentation/powerpc/firmware-assisted-dump.rst
--- a/Documentation/process/adding-syscalls.rst
+++ b/Documentation/process/adding-syscalls.rst
--- a/Documentation/process/submit-checklist.rst
+++ b/Documentation/process/submit-checklist.rst
--- a/Documentation/sphinx/requirements.txt
+++ b/Documentation/sphinx/requirements.txt
--- a/Documentation/translations/it_IT/process/adding-syscalls.rst
+++ b/Documentation/translations/it_IT/process/adding-syscalls.rst
--- a/Documentation/translations/it_IT/process/submit-checklist.rst
+++ b/Documentation/translations/it_IT/process/submit-checklist.rst
--- a/Documentation/translations/ko_KR/memory-barriers.txt
+++ b/Documentation/translations/ko_KR/memory-barriers.txt
--- a/Documentation/translations/zh_CN/filesystems/sysfs.txt
+++ b/Documentation/translations/zh_CN/filesystems/sysfs.txt
--- a/Documentation/translations/zh_CN/process/submit-checklist.rst
+++ b/Documentation/translations/zh_CN/process/submit-checklist.rst
--- a/Documentation/virt/kvm/arm/pvtime.rst
+++ b/Documentation/virt/kvm/arm/pvtime.rst
--- a/Documentation/virt/kvm/devices/vcpu.rst
+++ b/Documentation/virt/kvm/devices/vcpu.rst
--- a/Documentation/virt/kvm/hypercalls.rst
+++ b/Documentation/virt/kvm/hypercalls.rst
--- a/Documentation/virt/kvm/mmu.rst
+++ b/Documentation/virt/kvm/mmu.rst
--- a/Documentation/virt/kvm/review-checklist.rst
+++ b/Documentation/virt/kvm/review-checklist.rst
--- a/Documentation/vm/index.rst
+++ b/Documentation/vm/index.rst
--- a/7
+++ b/7
--- a/arch/powerpc/include/uapi/asm/kvm_para.h
+++ b/arch/powerpc/include/uapi/asm/kvm_para.h
--- a/arch/x86/kvm/mmu/mmu.c
+++ b/arch/x86/kvm/mmu/mmu.c
--- a/drivers/ata/libata-core.c
+++ b/drivers/ata/libata-core.c
--- a/drivers/base/core.c
+++ b/drivers/base/core.c
--- a/drivers/base/platform.c
+++ b/drivers/base/platform.c
--- a/drivers/crypto/allwinner/sun8i-ce/sun8i-ce-cipher.c
+++ b/drivers/crypto/allwinner/sun8i-ce/sun8i-ce-cipher.c
--- a/drivers/crypto/allwinner/sun8i-ce/sun8i-ce-core.c
+++ b/drivers/crypto/allwinner/sun8i-ce/sun8i-ce-core.c
--- a/drivers/crypto/allwinner/sun8i-ss/sun8i-ss-cipher.c
+++ b/drivers/crypto/allwinner/sun8i-ss/sun8i-ss-cipher.c
--- a/drivers/crypto/allwinner/sun8i-ss/sun8i-ss-core.c
+++ b/drivers/crypto/allwinner/sun8i-ss/sun8i-ss-core.c
--- a/drivers/gpu/drm/Kconfig
+++ b/drivers/gpu/drm/Kconfig
--- a/drivers/gpu/drm/drm_ioctl.c
+++ b/drivers/gpu/drm/drm_ioctl.c
--- a/drivers/gpu/drm/msm/disp/dpu1/dpu_kms.h
+++ b/drivers/gpu/drm/msm/disp/dpu1/dpu_kms.h
--- a/drivers/hwtracing/coresight/Kconfig
+++ b/drivers/hwtracing/coresight/Kconfig
--- a/drivers/media/v4l2-core/v4l2-fwnode.c
+++ b/drivers/media/v4l2-core/v4l2-fwnode.c
--- a/fs/Kconfig
+++ b/fs/Kconfig
--- a/fs/Kconfig.binfmt
+++ b/fs/Kconfig.binfmt
--- a/fs/adfs/Kconfig
+++ b/fs/adfs/Kconfig
--- a/fs/affs/Kconfig
+++ b/fs/affs/Kconfig
--- a/fs/afs/Kconfig
+++ b/fs/afs/Kconfig
--- a/fs/bfs/Kconfig
+++ b/fs/bfs/Kconfig
--- a/fs/cramfs/Kconfig
+++ b/fs/cramfs/Kconfig
--- a/fs/ecryptfs/Kconfig
+++ b/fs/ecryptfs/Kconfig
--- a/fs/fat/Kconfig
+++ b/fs/fat/Kconfig
--- a/fs/fuse/Kconfig
+++ b/fs/fuse/Kconfig
--- a/fs/fuse/dev.c
+++ b/fs/fuse/dev.c
--- a/fs/hfs/Kconfig
+++ b/fs/hfs/Kconfig
--- a/fs/hpfs/Kconfig
+++ b/fs/hpfs/Kconfig
--- a/fs/inode.c
+++ b/fs/inode.c
--- a/fs/isofs/Kconfig
+++ b/fs/isofs/Kconfig
--- a/fs/namespace.c
+++ b/fs/namespace.c
--- a/fs/notify/inotify/Kconfig
+++ b/fs/notify/inotify/Kconfig
--- a/fs/ntfs/Kconfig
+++ b/fs/ntfs/Kconfig
--- a/fs/ocfs2/Kconfig
+++ b/fs/ocfs2/Kconfig
--- a/fs/overlayfs/Kconfig
+++ b/fs/overlayfs/Kconfig
--- a/fs/proc/Kconfig
+++ b/fs/proc/Kconfig
--- a/fs/romfs/Kconfig
+++ b/fs/romfs/Kconfig
--- a/fs/sysfs/dir.c
+++ b/fs/sysfs/dir.c
--- a/fs/sysfs/file.c
+++ b/fs/sysfs/file.c
--- a/fs/sysfs/mount.c
+++ b/fs/sysfs/mount.c
--- a/fs/sysfs/symlink.c
+++ b/fs/sysfs/symlink.c
--- a/fs/sysv/Kconfig
+++ b/fs/sysv/Kconfig
--- a/fs/udf/Kconfig
+++ b/fs/udf/Kconfig
--- a/include/linux/kobject.h
+++ b/include/linux/kobject.h
--- a/include/linux/kobject_ns.h
+++ b/include/linux/kobject_ns.h
--- a/include/linux/mm.h
+++ b/include/linux/mm.h
--- a/include/linux/relay.h
+++ b/include/linux/relay.h
--- a/include/linux/spi/spi.h
+++ b/include/linux/spi/spi.h
--- a/include/linux/sysfs.h
+++ b/include/linux/sysfs.h
--- a/include/uapi/linux/ethtool_netlink.h
+++ b/include/uapi/linux/ethtool_netlink.h
--- a/include/uapi/linux/firewire-cdev.h
+++ b/include/uapi/linux/firewire-cdev.h
--- a/include/uapi/linux/kvm.h
+++ b/include/uapi/linux/kvm.h
--- a/include/uapi/rdma/rdma_user_ioctl_cmds.h
+++ b/include/uapi/rdma/rdma_user_ioctl_cmds.h
--- a/kernel/futex.c
+++ b/kernel/futex.c
--- a/kernel/relay.c
+++ b/kernel/relay.c
--- a/lib/bitmap.c
+++ b/lib/bitmap.c
--- a/lib/kobject.c
+++ b/lib/kobject.c
--- a/mm/gup.c
+++ b/mm/gup.c
--- a/scripts/kernel-doc
+++ b/scripts/kernel-doc
--- a/Show more
+++ b/Show more