From 25f511b3463aae7bc6dfa561d2ce5982ef300909 Mon Sep 17 00:00:00 2001
From: Lina Wolf <48202465+linawolf@users.noreply.github.com>
Date: Sat, 14 Sep 2024 08:25:33 +0200
Subject: [PATCH] [FEATURE] Raise Fluid Standalone to 4.0 (#4758)

Resolves: https://github.com/TYPO3-Documentation/Changelog-To-Doc/issues/1027
Releases: main
---
 Documentation/ApiOverview/Fluid/Syntax.rst | 46 ++++++++++++++++++++--
 1 file changed, 43 insertions(+), 3 deletions(-)

diff --git a/Documentation/ApiOverview/Fluid/Syntax.rst b/Documentation/ApiOverview/Fluid/Syntax.rst
index 78e2d229e4..9720af736e 100644
--- a/Documentation/ApiOverview/Fluid/Syntax.rst
+++ b/Documentation/ApiOverview/Fluid/Syntax.rst
@@ -36,10 +36,10 @@ braces to output it.
 Reserved variables in Fluid
 ---------------------------
 
-..  deprecated:: Fluid 2.15 / TYPO3 v12.4
+..  versionchanged:: Fluid 4.0 / TYPO3 v13.3
     Assigning variables of names `true`, `false` or `null` will throw
-    an exception in Fluid v4. In preparation of this change, Fluid v2.15 logs a
-    deprecation level error message if any of these variable names are used.
+    an exception in Fluid v4.
+
     See also :ref:`fluid-variables-reserved-migration`.
 
 The following variable names are reserved and may not be used:
@@ -60,6 +60,46 @@ Migration
 ..  literalinclude:: _Syntax/_MyTemplate.diff
     :caption: EXT:my_extension/Resources/Private/Templates/MyTemplate.html (diff)
 
+..  _fluid-boolean:
+
+Boolean values
+--------------
+
+..  versionadded:: Fluid 4.0 / TYPO3 v13.3
+    The boolean literals `{true}` and `{false}` have been introduced.
+
+You can use the boolean literals `{true}` and `{false}` to enable or disable
+properties of tag-based ViewHelpers:
+
+..  code-block:: html
+
+    <my:viewhelper async="{true}" />
+    Result: <tag async="async" />
+
+    <my:viewhelper async="{false}" />
+    Result: <tag />
+
+Of course, any variable containing a boolean can be supplied as well:
+
+..  code-block:: html
+
+    <my:viewhelper async="{isAsync}" />
+
+It is also possible to cast a string to a boolean
+
+..  code-block:: html
+
+    <my:viewhelper async="{myString as boolean}" />
+
+For compatibility reasons empty strings still lead to the attribute
+being omitted from the tag.
+
+..  code-block:: html
+
+    <f:variable name="myEmptyString"></f:variable>
+    <my:viewhelper async="{myEmptyString}" />
+    Result: <tag />
+
 ..  _fluid-arrays:
 
 Arrays and objects