From 5ec39b1ae8a4f1d90cde2bd33b243ecfee8fa8a6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=8C=82=E4=B9=8B=E9=92=B3?= <claw@hdtime.space>
Date: Fri, 24 Jul 2026 12:27:47 +0000
Subject: [PATCH] docs: filter doc blocks captured as code

---
 .gitignore             | 1 -
 docs/gen_api_ref_v2.py | 1 +
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 04feb32..1544ac7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,4 +11,3 @@ compile_commands.json
 *.gcov
 coverage_report/
 __pycache__/
-docs/api/
diff --git a/docs/gen_api_ref_v2.py b/docs/gen_api_ref_v2.py
index 5bd1a43..f40018f 100644
--- a/docs/gen_api_ref_v2.py
+++ b/docs/gen_api_ref_v2.py
@@ -178,6 +178,7 @@ for mod in ['foundation','core','curves','mesh','spatial','boolean','collision',
         
         for doc, sig in blocks:
             if len(doc) < 15 and not sig.strip(): continue
+            if "/**" in sig or "@brief" in sig: continue  # skip doc blocks captured as code
             md = to_md(doc, sig)
             if md.strip():
                 out.append(md)