[all-commits] [llvm/llvm-project] a97b2a: [docs] Prefer portable Markdown documentation links

Reid Kleckner via All-commits all-commits at lists.llvm.org
Tue Sep 15 14:16:45 PDT 2026


  Branch: refs/heads/users/rnk/clang/abs-doclink-fix
  Home:   https://github.com/llvm/llvm-project
  Commit: a97b2abf03fd701edca3549979b25ee38b8decf4
      https://github.com/llvm/llvm-project/commit/a97b2abf03fd701edca3549979b25ee38b8decf4
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-09-15 (Tue, 15 Sep 2026)

  Changed paths:
    M llvm/docs/AIToolPolicy.md
    M llvm/docs/AdminTasks.md
    M llvm/docs/CodingStandards.md
    M llvm/docs/CommandGuide/llvm-remarkutil.md
    M llvm/docs/CompileCudaWithLLVM.md
    M llvm/docs/ExtendingLLVM.md
    M llvm/docs/GettingStarted.md
    M llvm/docs/GitHub.md
    M llvm/docs/GitRepositoryPolicy.md
    M llvm/docs/HowToBuildWithPGO.md
    M llvm/docs/HowToCrossCompileLLVM.md
    M llvm/docs/InstrRefDebugInfo.md
    M llvm/docs/LoopTerminology.md
    M llvm/docs/MIRLangRef.md
    M llvm/docs/MarkdownQuickstartTemplate.md
    M llvm/docs/MemProf.md
    M llvm/docs/MergeFunctions.md
    M llvm/docs/NVPTXUsage.md
    M llvm/docs/OpaquePointers.md
    M llvm/docs/RemoveDIsDebugInfo.md
    M llvm/docs/SandboxIR.md
    M llvm/docs/SecurityTransparencyReports.rst
    M llvm/docs/SphinxQuickstartTemplate.md
    M llvm/docs/tutorial/BuildingAJIT1.md
    M utils/docs/llvm_sphinx/ext/absolute_links.py
    M utils/docs/llvm_sphinx/ext/absolute_links_test/conf.py
    M utils/docs/llvm_sphinx/ext/absolute_links_test/markdown.md
    A utils/docs/llvm_sphinx/ext/absolute_links_test/static.html

  Log Message:
  -----------
  [docs] Prefer portable Markdown documentation links

Document and enforce source-relative Markdown links for documents and
generated heading anchors. Diagnose nonportable project: and generated HTML
links, and convert the existing LLVM Markdown links to the preferred form.


  Commit: 87b9f5c7cd00d6d596eb3c914b39f6b400e75c49
      https://github.com/llvm/llvm-project/commit/87b9f5c7cd00d6d596eb3c914b39f6b400e75c49
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-09-15 (Tue, 15 Sep 2026)

  Changed paths:
    M llvm/docs/AIToolPolicy.md
    M llvm/docs/AdminTasks.md
    M llvm/docs/CodingStandards.md
    M llvm/docs/CommandGuide/llvm-remarkutil.md
    M llvm/docs/CompileCudaWithLLVM.md
    M llvm/docs/ExtendingLLVM.md
    M llvm/docs/GettingStarted.md
    M llvm/docs/GitHub.md
    M llvm/docs/GitRepositoryPolicy.md
    M llvm/docs/HowToBuildWithPGO.md
    M llvm/docs/HowToCrossCompileLLVM.md
    M llvm/docs/InstrRefDebugInfo.md
    M llvm/docs/LoopTerminology.md
    M llvm/docs/MIRLangRef.md
    M llvm/docs/MarkdownQuickstartTemplate.md
    M llvm/docs/MemProf.md
    M llvm/docs/MergeFunctions.md
    M llvm/docs/NVPTXUsage.md
    M llvm/docs/OpaquePointers.md
    M llvm/docs/RemoveDIsDebugInfo.md
    M llvm/docs/SandboxIR.md
    M llvm/docs/SecurityTransparencyReports.rst
    M llvm/docs/SphinxQuickstartTemplate.md
    M llvm/docs/tutorial/BuildingAJIT1.md
    M utils/docs/llvm_sphinx/ext/absolute_links.py
    M utils/docs/llvm_sphinx/ext/absolute_links_test/conf.py
    M utils/docs/llvm_sphinx/ext/absolute_links_test/markdown.md
    A utils/docs/llvm_sphinx/ext/absolute_links_test/static.html

  Log Message:
  -----------
  Merge cascade


  Commit: ac740986c37af7a5bd26d68608509a79736ea9eb
      https://github.com/llvm/llvm-project/commit/ac740986c37af7a5bd26d68608509a79736ea9eb
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-09-15 (Tue, 15 Sep 2026)

  Changed paths:
    M clang/docs/AllocToken.md
    M clang/docs/ClangOffloadBundler.md
    M clang/docs/ControlFlowIntegrityDesign.md
    M clang/docs/IntroductionToTheClangAST.md
    M clang/docs/LanguageExtensions.md
    M clang/docs/LifetimeSafety.md
    M clang/docs/SafeBuffers.md
    M clang/docs/ScalableStaticAnalysis/user-docs/SummaryExtraction.md
    M clang/docs/WarningSuppressionMappings.md
    M clang/docs/analyzer/checkers.md
    M clang/docs/analyzer/user-docs/Annotations.md
    M clang/docs/conf.py
    M llvm/docs/SphinxQuickstartTemplate.md
    M utils/docs/llvm_sphinx/ext/absolute_links.py
    M utils/docs/llvm_sphinx/ext/absolute_links_test/markdown.md

  Log Message:
  -----------
  [docs] Prefer portable Clang documentation links

Enable the absolute-link checker for Clang and replace nonportable project:
links with relative source paths. This preserves MyST link validation while
making the links work when browsing sources on GitHub.

Also correct the stale RAVFrontendAction suffix and cover links to reST sources
and links inside colon-fenced Markdown directive content.


Compare: https://github.com/llvm/llvm-project/compare/4e48dec13848...ac740986c37a

To unsubscribe from these emails, change your notification settings at https://github.com/llvm/llvm-project/settings/notifications


More information about the All-commits mailing list