[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