Re: Several doubtful points on the manual

Hello, thank you for the response ..

> It is subject to escaping *if* you use #escape.
Did you mean the function's result ? That's why i was doubtful, because it
says in the manual 'subject to --automatic-- xml escaping.

> Not so for macro calls.
Did you mean macro calls will result in escaped content automatically ?

> Exactly, this allows you to add newlines in the template without breaking
the layout. Hence it improves readability.
Ah, makes sense ! But in the context of 'library' template with only macros
only, i imagine we can add newlines also without strip_text, and not
breaking anything, because the what is important is the macros, not the
newlines or any other texts outside the macros, am i correct ?


On Sat, Mar 9, 2013 at 9:14 PM, Denis Bredelet <[email protected]> wrote:

>
> On 9 Mar 2013, at 13:17, Albert Kam <[email protected]> wrote:
>
> 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 ?
>
>
> It is subject to escaping *if* you use #escape. Not so for macro calls.
>
> 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 ?
>
>
> Yes.
>
>
> (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 ?
>
>
> Technically dates are usually time stamps since the epoch, but I agree
> with you.
>
>
> (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 ?
>
>
> Exactly, this allows you to add newlines in the template without breaking
> the layout. Hence it improves readability.
>
>
> 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
>
>
>
> ------------------------------------------------------------------------------
> 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
>
>


-- 
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