From c97b0084b78781446d293d240c8c691a3ce32104 Mon Sep 17 00:00:00 2001
From: Krystine Sherwin <93062060+KrystalDelusion@users.noreply.github.com>
Date: Mon, 21 Jul 2025 10:34:55 +1200
Subject: [PATCH] Docs: Show warning on experimental cmds

---
 docs/util/newcmdref.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/util/newcmdref.py b/docs/util/newcmdref.py
index e014c03e5..07c93c0d1 100644
--- a/docs/util/newcmdref.py
+++ b/docs/util/newcmdref.py
@@ -340,6 +340,10 @@ class YosysCmdDocumenter(YosysCmdGroupDocumenter):
         source_name = self.object.source_file
         source_line = self.object.source_line
 
+        if self.object.experimental_flag:
+            self.add_line(f'.. warning:: This command is experimental', source_name, source_line)
+            self.add_line('\n', source_name)
+
         def render(content_list: YosysCmdContentListing, indent: int=0):
             content_source = content_list.source_file or source_name
             indent_str = '   '*indent