[llvm-branch-commits] [llvm] [docs] Rewrite LangRef.md as Markdown (PR #201975)

James Y Knight via llvm-branch-commits llvm-branch-commits at lists.llvm.org
Thu Jun 11 10:47:20 PDT 2026


jyknight wrote:

A couple specific comments:

1. Can we use "markdown syntax tables" in the conversion (quite similar to the tables syntax used in rST format), instead of "list tables" (terminology from https://myst-parser.readthedocs.io/en/latest/syntax/tables.html#markdown-syntax)?

2. Can we avoid the line rewrapping that seems to happen if the original had a linebreak within backticks? e.g. this example (there's plenty other similar):
```
-optional :ref:`linkage type <linkage>`, an optional :ref:`runtime preemption
-specifier <runtime_preemption_model>`,  an optional :ref:`visibility
-style <visibility>`, an optional :ref:`DLL storage class <dllstorageclass>`,
+optional {ref}`linkage type <linkage>`, an optional {ref}`runtime preemption specifier <runtime_preemption_model>`,  an optional {ref}`visibility style <visibility>`, an optional {ref}`DLL storage class <dllstorageclass>`,
```


https://github.com/llvm/llvm-project/pull/201975


More information about the llvm-branch-commits mailing list