[all-commits] [llvm/llvm-project] 3da4c5: [docs] Rewrite LangRef.md as Markdown

[Reid Kleckner via All-commits]

  Branch: refs/heads/users/rnk/llvm-md-langref
  Home:   https://github.com/llvm/llvm-project
  Commit: 3da4c5724227f6c7434ab483bcd0772ab1af70f5
      https://github.com/llvm/llvm-project/commit/3da4c5724227f6c7434ab483bcd0772ab1af70f5
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-06-06 (Sat, 06 Jun 2026)

  Changed paths:
    M llvm/docs/LangRef.md
    M llvm/docs/conf.py

  Log Message:
  -----------
  [docs] Rewrite LangRef.md as Markdown

Tracking issue: #201242

This change migrates LangRef by itself, since it is quite a large
document with many idiosyncracies.

LangRef makes extensive use of definition lists, which apparently
require enabling the deflist MyST extension in Sphinx conf.py. In part
because definition list boundaries are controlled by indentation,
several of them required manual fixups to get the nesting right. Some of
the issues were pre-existing broken indentation, but this should now be
much better.

I have a verification script that tracks all anchors and ensures that
all previous anchors are carried over to the new document, so no
mid-document links are broken.



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