stated the limitation

juiwenchen · juiwenchen · commit ac18c77e99fb · 2025-08-12T10:12:03.000+02:00
diff --git a/docs/source/components/directive.rst b/docs/source/components/directive.rst
@@ -3,6 +3,8 @@
 Directive
 =========
 
+.. Note:: ``src-trace`` directive currently only supports :ref:`one-line need definition <oneline>`.
+
 ``CodeLinks`` provides ``src-trace`` directive and it can be used in the following ways:
 
 .. code-block:: rst
