emphasize difference between eval and interpret built-ins in the documentation
Project: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/commit/90fc6874 Tree: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/tree/90fc6874 Diff: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/diff/90fc6874 Branch: refs/heads/2.3 Commit: 90fc6874c878e1970dcd4f3c1641fd18fe7a27b7 Parents: 7a94e59 Author: Florian van der Wielen <fvanderwie...@gmail.com> Authored: Wed Jan 24 13:12:38 2018 +0100 Committer: Florian van der Wielen <fvanderwie...@gmail.com> Committed: Wed Jan 24 13:12:38 2018 +0100 ---------------------------------------------------------------------- src/manual/en_US/book.xml | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/90fc6874/src/manual/en_US/book.xml ---------------------------------------------------------------------- diff --git a/src/manual/en_US/book.xml b/src/manual/en_US/book.xml index c61f02e..171257b 100644 --- a/src/manual/en_US/book.xml +++ b/src/manual/en_US/book.xml @@ -18030,7 +18030,7 @@ Sorted by name.last: <primary>evaluate string</primary> </indexterm> - <para>This built-in evaluates a string as an FTL expression. For + <para>This built-in evaluates a string as an FTL <emphasis>expression</emphasis>. For example <literal>"1+2"?eval</literal> returns number 3.</para> <para>The evaluated expression sees the same variables (such as @@ -18041,7 +18041,11 @@ Sorted by name.last: <literal><replaceable>s</replaceable></literal> there. Except, it can't use <link linkend="ref_builtins_loop_var">loop variable built-ins</link> that refer to a loop variable that was created - outside <literal><replaceable>s</replaceable></literal>.</para> + outside <literal><replaceable>s</replaceable></literal>. + Please note that the string accepts an expression, if you want to + render out a full-fledged template, please use the + <link linkend="ref_builtin_interpret"><literal>interpret</literal> + built-in.</para> <para>Regarding the configuration settings that affect the parsing (like syntax) and evaluation the rules are the same as with the