Several doubtful points on the manual

I have several points to ask based on the manual, please share your views :

(1) http://freemarker.sourceforge.net/docs/dgui_datamodel_types.html
> The main reason is that the result of functions are subject to automatic
XML-escaping (due to the nature of ${...}),
Is it true that the function return value and the result of interpolation
are automatically escaped ?
I tried this :
<#assign myvar="hello&world">

<#function hello>
<#return "<inside&function">
</#function>

${myvar}
${hello()}

with this result :
hello&world
<inside&function

> while the output of user-defined directives are not (due to the nature of
<@...>; its output is assumed to be markup, and hence already escaped).
Is it true that user defined directives are automatically escaped also ?
But i think not, since we have the ?html and #escape for this, am i right ?

(2) http://freemarker.org/docs/dgui_misc_userdefdir.html
> also you can use complex expression on the left side of = (e.g.
someParam=(price + 50)*1.25)
Should be on the --right-- side instead of the --left-- side ?

(3) http://freemarker.org/docs/dgui_template_valueinsertion.html
> Guide for inserting date/time values
> If the expression evaluates to a date then the numerical value will be
transformed to a text according to a default format.
Should be the --date-- value instead of --numerical-- value ?

(4) http://freemarker.sourceforge.net/docs/dgui_misc_whitespace.html
> It is useful for templates that contain macro definitions only (and some
other non-outputting directives), because it removes the line-breaks that
you use between the macro definitions and between the other top-level
directives to improve the readability of the template
How is it improving the readability of the 'library' template when what the
developer see is always the unparsed version ?

Regards from Jakarta,
Albert
-- 
Do not pursue the past. Do not lose yourself in the future.
The past no longer is. The future has not yet come.
Looking deeply at life as it is in the very here and now,
the practitioner dwells in stability and freedom.
(Thich Nhat Hanh)

------------------------------------------------------------------------------
Symantec Endpoint Protection 12 positioned as A LEADER in The Forrester  
Wave(TM): Endpoint Security, Q1 2013 and "remains a good choice" in the  
endpoint security space. For insight on selecting the right partner to 
tackle endpoint security challenges, access the full report. 
http://p.sf.net/sfu/symantec-dev2dev

_______________________________________________
FreeMarker-user mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/freemarker-user