Document that overriding MacroNode::compile() is not supported anymore

2026-09-01 13:07:22 +00:00 · 2026-08-27 13:07:26 +02:00
parent 7bd052dd91
commit 1205b8b6ca
1 changed files with 4 additions and 1 deletions
@@ -12,7 +12,10 @@ Classes
  final in Twig 4.0. Use ``Twig\Markup`` directly instead of extending it.

 * The ``Twig\Node\MacroNode`` class is considered final as of Twig 3.29 and
-  will be final in Twig 4.0.
+  will be final in Twig 4.0. Note that macros are compiled as closures stored
+  in a per-template registry as of Twig 3.29, so overriding
+  ``MacroNode::compile()`` based on the previous contract (emitting a
+  ``macro_``-prefixed method) is not supported anymore.

 Functions
 ---------