changeset 725:11e24e1bbf20

Docs: Introduce the new nested interpolation with filters
author Franz Glasner <f.glasner@feldmann-mg.com>
date Wed, 16 Aug 2023 17:33:11 +0200
parents ef7bee8b54e1
children 9b0dc1d57a9f
files docs/introduction.rst
diffstat 1 files changed, 6 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- 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.