Cross-references to other docs (so-called internal links) are typically done following Documentation/doc-guide/sphinx.rst: either simply write the target docs (preferred) or use :doc: or :ref: reST directives (for use-cases like having anchor text or cross-referencing sections). In some places, however, links to https://www.kernel.org/doc are used instead (outgoing, external links), owing inconsistency as these requires Internet connection only to see docs that otherwise can be accessed locally (after building with ``make htmldocs``).
Convert such external links to internal links, while keeping the original anchor texts using :doc: directive. Note that this does not cover docs.kernel.org links nor touching Documentation/tools (as docs containing external links are in manpages). This series is based on docs-next tree. Maintainers can feel free to apply any of patches in this series to their own tree. Changes since v1 [1]: * Apply review tags * Drop patch [12/14] as it has been applied to sound tree [1]: https://lore.kernel.org/linux-doc/20250829075524.45635-1-bagasdo...@gmail.com/ Bagas Sanjaya (13): Documentation: hw-vuln: l1tf: Convert kernel docs external links Documentation: damon: reclaim: Convert "Free Page Reporting" citation link Documentation: perf-security: Convert security credentials bibliography link Documentation: amd-pstate: Use internal link to kselftest Documentation: blk-mq: Convert block layer docs external links Documentation: bpf: Convert external kernel docs link Documentation: kasan: Use internal link to kunit Documentation: gpu: Use internal link to kunit Documentation: filesystems: Fix stale reference to device-mapper docs Documentation: smb: smbdirect: Convert KSMBD docs link Documentation: net: Convert external kernel networking docs nitro_enclaves: Use internal cross-reference for kernel docs links Documentation: checkpatch: Convert kernel docs references Documentation/admin-guide/hw-vuln/l1tf.rst | 9 +- .../admin-guide/mm/damon/reclaim.rst | 2 +- Documentation/admin-guide/perf-security.rst | 2 +- Documentation/admin-guide/pm/amd-pstate.rst | 3 +- Documentation/block/blk-mq.rst | 23 ++-- Documentation/bpf/bpf_iterators.rst | 3 +- Documentation/bpf/map_xskmap.rst | 5 +- Documentation/dev-tools/checkpatch.rst | 121 ++++++++++++------ Documentation/dev-tools/kasan.rst | 6 +- .../bindings/submitting-patches.rst | 2 + .../driver-api/driver-model/device.rst | 2 + Documentation/filesystems/fsverity.rst | 11 +- Documentation/filesystems/smb/smbdirect.rst | 4 +- Documentation/filesystems/sysfs.rst | 2 + .../filesystems/ubifs-authentication.rst | 4 +- Documentation/gpu/todo.rst | 6 +- Documentation/kbuild/reproducible-builds.rst | 2 + Documentation/locking/lockdep-design.rst | 2 + .../can/ctu/ctucanfd-driver.rst | 3 +- .../device_drivers/ethernet/amazon/ena.rst | 4 +- Documentation/networking/ethtool-netlink.rst | 3 +- Documentation/networking/snmp_counter.rst | 12 +- Documentation/process/coding-style.rst | 15 +++ Documentation/process/deprecated.rst | 4 + Documentation/process/submitting-patches.rst | 4 + Documentation/virt/ne_overview.rst | 10 +- 26 files changed, 161 insertions(+), 103 deletions(-) base-commit: f44a29784f685804d9970cfb0d3439c9e30981d7 -- An old man doll... just what I always wanted! - Clara
