[Openmp-commits] [clang] [clang-tools-extra] [flang] [libc] [libcxx] [libunwind] [lld] [lldb] [llvm] [openmp] [polly] [3/4]: [docs] Create utils/docs (PR #203962)

[Scott Linder via Openmp-commits]

slinder1 wrote:

<details>
<summary>🛠️ Changes since last push (click to expand):</summary>

```diff
diff --git b/bolt/docs/conf.py a/bolt/docs/conf.py
@@ -13,8 +13,7 @@
 import sys, os
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.NEVER))
 
diff --git b/clang-tools-extra/docs/conf.py a/clang-tools-extra/docs/conf.py
@@ -14,8 +14,7 @@
 import sys, os
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.EXCEPT_MAN))
 
diff --git b/clang/docs/conf.py a/clang/docs/conf.py
@@ -15,8 +15,7 @@ from __future__ import absolute_import, division, print_function
 import sys, os
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.EXCEPT_MAN))
 
diff --git b/flang/docs/conf.py a/flang/docs/conf.py
@@ -11,8 +11,7 @@
 
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags))
 
diff --git b/libc/docs/conf.py a/libc/docs/conf.py
@@ -13,8 +13,7 @@
 import sys, os
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.EXCEPT_MAN))
 
diff --git b/libcxx/docs/conf.py a/libcxx/docs/conf.py
@@ -13,8 +13,7 @@
 import sys, os
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.NEVER))
 
diff --git b/libunwind/docs/conf.py a/libunwind/docs/conf.py
@@ -13,8 +13,7 @@
 import sys, os
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.NEVER))
 
diff --git b/lld/docs/conf.py a/lld/docs/conf.py
@@ -13,8 +13,7 @@
 import sys, os
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.EXCEPT_MAN))
 
diff --git b/lldb/docs/conf.py a/lldb/docs/conf.py
@@ -14,8 +14,7 @@ import sys, os, re, shutil
 from datetime import date
 from pathlib import Path
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.EXCEPT_MAN))
 
diff --git b/llvm/docs/conf.py a/llvm/docs/conf.py
@@ -14,8 +14,7 @@ from __future__ import print_function
 import sys, os, re
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.EXCEPT_MAN))
 
@@ -25,6 +24,15 @@ globals().update(common_conf(tags, markdown=Markdown.EXCEPT_MAN))
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions += ["sphinx.ext.intersphinx", "sphinx.ext.todo"]
 
+myst_enable_extensions += ["deflist"]
+myst_url_schemes = {
+    "http": None,
+    "https": None,
+    "mailto": None,
+    "ftp": None,
+    "doxygen": {"url": "/doxygen/{{path}}"},
+}
+
 import sphinx
 
 project = "LLVM"
diff --git b/openmp/docs/conf.py a/openmp/docs/conf.py
@@ -14,8 +14,7 @@
 import sys, os
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags))
 
diff --git b/orc-rt/docs/conf.py a/orc-rt/docs/conf.py
@@ -11,8 +11,7 @@
 
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.EXCEPT_MAN))
 
diff --git b/polly/docs/conf.py a/polly/docs/conf.py
@@ -14,8 +14,7 @@
 import sys, os
 from datetime import date
 
-# see llvm-project/utils/docs/llvm_sphinx
-from llvm_sphinx import *
+from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
 globals().update(common_conf(tags, markdown=Markdown.NEVER))
 
diff --git b/utils/docs/llvm_sphinx/__init__.py a/utils/docs/llvm_sphinx/__init__.py
@@ -6,8 +6,7 @@ Every sphinx `conf.py` in llvm-project is intended to use `common_conf` as a
 baseline configuration. The sphinx module-as-conf model means the easiest
 way to achieve this is by updating `globals()` directly, as in:
 
-    # see llvm-project/utils/docs/llvm_sphinx
-    from llvm_sphinx import *
+    from llvm_sphinx import * # see llvm-project/utils/docs/README.md
 
     globals().update(common_conf(tags))
 

```
</details>

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