From fb997111f46c069ee140829a220bb3b69b34969b Mon Sep 17 00:00:00 2001
From: Simon Wisselink <s.wisselink@iwink.nl>
Date: Fri, 27 Dec 2024 23:08:17 +0100
Subject: [PATCH] Add note to docs about plugins that expect parameters by
 reference

---
 docs/upgrading.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/upgrading.md b/docs/upgrading.md
index ef9cc4c9..2bb36fe5 100644
--- a/docs/upgrading.md
+++ b/docs/upgrading.md
@@ -49,6 +49,11 @@ $smarty->registerPlugin('modifier', 'my_special_func', 'my_special_func');
 
 But you may want to consider writing a proper [extension](api/extending/extensions.md).
 
+#### Passing parameters by reference
+You cannot use plugins that expect a parameter by reference anymore. PHP-function such as `reset()`, `prev()`, 
+`next()` and `end()` can be registered as plugin, but they won't work because they expect a parameter by 
+reference and Smarty will try to pass it by value.
+
 ### Removed undocumented tags
 
 Smarty 4 still supported some tags that have been carried over from previous version, but have never been documented.