# HG changeset patch
# User Franz Glasner <f.glasner@feldmann-mg.com>
# Date 1692199991 -7200
# Node ID 11e24e1bbf2091f48c18d051e6d3334822bac934
# Parent  ef7bee8b54e14030759cffabbfa91109c09e9ff6
Docs: Introduce the new nested interpolation with filters

diff -r ef7bee8b54e1 -r 11e24e1bbf20 docs/introduction.rst
--- a/docs/introduction.rst	Wed Aug 16 17:17:27 2023 +0200
+++ b/docs/introduction.rst	Wed Aug 16 17:33:11 2023 +0200
@@ -535,9 +535,13 @@
 
 With the syntax::
 
-      {{|<expression with variables>|filter1[,filter2...]|}}
+  {{|<expression with variables (including filters)>|filter1[,filter2...]|}}
 
-The expression above can be expressed as
+The ``<expression with variables (including filers)`` is interpolated
+first, and the complete result is feeded into the filter chain,
+beginning with ``filter1``.
+
+With this, the non-working example above can be expressed as
 ``{{|{{path-variable|Empty}}/subdir|normpath|}}``
 and yields the expected result -- with `normpath` applied to the now
 interpolated expression.