Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 7C2BC200C16 for ; Thu, 26 Jan 2017 00:23:56 +0100 (CET) Received: by cust-asf.ponee.io (Postfix) id 7A8D8160B4E; Wed, 25 Jan 2017 23:23:56 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 37EDC160B5A for ; Thu, 26 Jan 2017 00:23:54 +0100 (CET) Received: (qmail 32319 invoked by uid 500); 25 Jan 2017 23:23:53 -0000 Mailing-List: contact notifications-help@freemarker.incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@freemarker.incubator.apache.org Delivered-To: mailing list notifications@freemarker.incubator.apache.org Received: (qmail 32310 invoked by uid 99); 25 Jan 2017 23:23:53 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd2-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 25 Jan 2017 23:23:53 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd2-us-west.apache.org (ASF Mail Server at spamd2-us-west.apache.org) with ESMTP id CC40D1A0461 for ; Wed, 25 Jan 2017 23:23:52 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd2-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -6.219 X-Spam-Level: X-Spam-Status: No, score=-6.219 tagged_above=-999 required=6.31 tests=[KAM_ASCII_DIVIDERS=0.8, KAM_LAZY_DOMAIN_SECURITY=1, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, RP_MATCHES_RCVD=-2.999] autolearn=disabled Received: from mx1-lw-eu.apache.org ([10.40.0.8]) by localhost (spamd2-us-west.apache.org [10.40.0.9]) (amavisd-new, port 10024) with ESMTP id T35jA3yxS_j5 for ; Wed, 25 Jan 2017 23:23:34 +0000 (UTC) Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx1-lw-eu.apache.org (ASF Mail Server at mx1-lw-eu.apache.org) with SMTP id 18D425FDB9 for ; Wed, 25 Jan 2017 23:23:18 +0000 (UTC) Received: (qmail 30535 invoked by uid 99); 25 Jan 2017 23:23:18 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 25 Jan 2017 23:23:18 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 01E67F16B7; Wed, 25 Jan 2017 23:23:17 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: ddekany@apache.org To: notifications@freemarker.incubator.apache.org Date: Wed, 25 Jan 2017 23:23:26 -0000 Message-Id: <67e3c6b4a79b4e42b7ff10f6aca6d5f3@git.apache.org> In-Reply-To: <96380a8be6df4ca39af9b96930efd092@git.apache.org> References: <96380a8be6df4ca39af9b96930efd092@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [10/19] incubator-freemarker-site git commit: Updated Manual with the improvements from the 2.3.26 branch. archived-at: Wed, 25 Jan 2017 23:23:56 -0000 http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/975692b4/docs/ref_builtins_node.html ---------------------------------------------------------------------- diff --git a/docs/ref_builtins_node.html b/docs/ref_builtins_node.html index bae42b3..4e8410c 100644 --- a/docs/ref_builtins_node.html +++ b/docs/ref_builtins_node.html @@ -14,7 +14,7 @@ - + - - + +

Built-ins for nodes (for XML)

@@ -95,8 +95,8 @@ ga('send', 'pageview');

Returns the string that is used to determine what user-defined - directive to invoke to handle this node when it is ``visited''. See: - the visit and recurse directives.

+ directive to invoke to handle this node when it is + "visited". See: the visit and recurse directives.

XML: If the node is an element or attribute, then the string will be the local (prefix free) name of the element or attribute. @@ -140,10 +140,10 @@ ga('send', 'pageview'); -

A string that describes the type of node this is. FreeMarker - does not define the exact meaning of node type; it depends on what - your variables are modeling. It's possible that a node doesn't - support node type at all. In this case, the built-in evaluates to an +

A string that describes the type of the node. FreeMarker does + not define the exact meaning of node type; it depends on what your + variables are modeling. It's possible that a node doesn't support + node type at all. In this case, the built-in evaluates to an undefined value, so you can't use the returned value. (You can still check if a node supports the type property with node?node_type??.)

@@ -167,18 +167,20 @@ ga('send', 'pageview'); -

The node that is this node's immediate parent in the node - tree. The root node has no parent node, so for the root node, the - expression +

Returns the node that is this node's immediate parent in the + node tree. The root node has no parent node, so for the root node, + the expression node?parent?? evaluates to false.

XML: Note that the value returned by this built-in is also a sequence (same as the result of XPath expression .., when you write - someNode[".."]). Also note that for attribute - nodes, it returns the element the attribute belongs to, despite that - attribute nodes are not counted as children of the element.

+ someNode[".."]), however if there's no parent, + the result is a missing value (null) instead of an empty sequence. + Also note that for attribute nodes, it returns the element the + attribute belongs to, despite that attribute nodes are not counted + as children of the element.

@@ -195,17 +197,19 @@ ga('send', 'pageview');

XML: According to W3C, the root of an XML document is not the topmost element node, but the document itself, which is the parent of the topmost element. For example, if you want to get the topmost - element of the XML (the so called ``document - element''; do not mix it with the ``document''), which is called - foo, then you have to write - someNode?root.foo. If you write just - someNode?root, then you get the document itself, - and not the document element.

+ element of the XML (the so called + "document element"; do not mix it with the + "document"), which is called foo, + then you have to write someNode?root.foo. If you + write just someNode?root, then you get the + document itself, and not the document element.

-

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

Generated for: Freemarker 2.3.25 Last generated: -

-© 1999–2016 -The Apache Software Foundation. All rights reserved.

+

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

+Last generated: +, for Freemarker 2.3.25

+

+© 1999–2017 +The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/975692b4/docs/ref_builtins_number.html ---------------------------------------------------------------------- diff --git a/docs/ref_builtins_number.html b/docs/ref_builtins_number.html index 8514ddd..4efdc92 100644 --- a/docs/ref_builtins_number.html +++ b/docs/ref_builtins_number.html @@ -14,7 +14,7 @@ - + - - + +

Built-ins for numbers

@@ -111,8 +111,8 @@ ga('send', 'pageview'); ${x}), or else the output will be possibly broken depending on the current number formatting settings and locale (like the decimal point is not dot, but comma in many countries) and the - value of the number (like big numbers are possibly ``damaged'' by - grouping separators).

+ value of the number (like big numbers are possibly + "damaged" by grouping separators).

If the incompatible_imporvements FreeMarker configuration setting is set to 2.3.24 or higher (also if it's set @@ -787,9 +787,11 @@ Extended decimal format: 10_003

"AA", "AB", etc.

-

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

Generated for: Freemarker 2.3.25 Last generated: -

-© 1999–2016 -The Apache Software Foundation. All rights reserved.

+

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

+Last generated: +, for Freemarker 2.3.25

+

+© 1999–2017 +The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/975692b4/docs/ref_builtins_sequence.html ---------------------------------------------------------------------- diff --git a/docs/ref_builtins_sequence.html b/docs/ref_builtins_sequence.html index d4499ea..c315611 100644 --- a/docs/ref_builtins_sequence.html +++ b/docs/ref_builtins_sequence.html @@ -14,7 +14,7 @@ - + - - + +

Built-ins for sequences

@@ -101,8 +101,8 @@ ga('send', 'pageview');

This built in is mostly for outputting sequnces in tabular/columnar format. When used with HTML tables, the 2nd parameter is often "\xA0" (that is the code of - the no-break space character, also known as ``nbsp''), so the border - of the empty TD-s will not be missing.

+ the no-break space character, also known as "nbsp"), so + the border of the empty TD-s will not be missing.

The 1st parameter must be a number that is at least 1. If the number is not integer, it will be silently rounded down to integer @@ -118,8 +118,19 @@ ga('send', 'pageview'); -

The first subvariable of the sequence. Template processing - will die with error if the sequence is empty.

+

Returns the first item of the sequence. Thus + value?first is the + same as value[0], + except that, since FreeMarker 2.3.26, + value?first also works + if value doesn't + support getting items with numerical index, but still supports to be + listed (i.e., with FTL collection values).

+ +

If the sequence or collection is empty, the result will be a + missing value (as in + empty?first!'No item was + found').

@@ -556,9 +567,11 @@ Sorted by name.last: - Smith, Joe: 40 years old
-

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

Generated for: Freemarker 2.3.25 Last generated: -

-© 1999–2016 -The Apache Software Foundation. All rights reserved.

+

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

+Last generated: +, for Freemarker 2.3.25

+

+© 1999–2017 +The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/975692b4/docs/ref_builtins_string.html ---------------------------------------------------------------------- diff --git a/docs/ref_builtins_string.html b/docs/ref_builtins_string.html index 32a6596..1c73813 100644 --- a/docs/ref_builtins_string.html +++ b/docs/ref_builtins_string.html @@ -14,7 +14,7 @@ - + - - + +

Built-ins for strings

@@ -86,7 +86,7 @@ ga('send', 'pageview');

The string with the very first word of the string capitalized. - For the precise meaning of ``word'' see the word_list built-in. + For the precise meaning of "word" see the word_list built-in. Example:

@@ -116,8 +116,8 @@ GreEN mouse

The string with all words capitalized. For the precise meaning - of ``word'' see the word_list - built-in. Example:

+ of "word" see the word_list built-in. + Example:

@@ -1029,8 +1029,8 @@ String BEAN_NAME = "${beanName?j_string}";
-

This is a ``power user'' built-in. Ignore it if you don't know - regular +

This is a "power user" built-in. Ignore it if you + don't know regular expressions.

This built-in determines if the string exactly matches the @@ -2015,11 +2015,11 @@ ${x?url}

Many string built-ins accept an optional string parameter, the - so called ``flags''. In this string, each letter influences a - certain aspect of the behavior of the built-in. For example, letter - i means that the built-in should not - differentiate the lower and upper-case variation of the same letter. - The order of the letters in the flags string is not + so called "flags". In this string, each letter + influences a certain aspect of the behavior of the built-in. For + example, letter i means that the built-in should + not differentiate the lower and upper-case variation of the same + letter. The order of the letters in the flags string is not significant.

This is the complete list of letters (flags):

@@ -2325,9 +2325,11 @@ rif: foo XYr baar
-

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

Generated for: Freemarker 2.3.25 Last generated: -

-© 1999–2016 -The Apache Software Foundation. All rights reserved.

+

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

+Last generated: +, for Freemarker 2.3.25

+

+© 1999–2017 +The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/975692b4/docs/ref_builtins_type_independent.html ---------------------------------------------------------------------- diff --git a/docs/ref_builtins_type_independent.html b/docs/ref_builtins_type_independent.html index 7a87d1f..18c6b80 100644 --- a/docs/ref_builtins_type_independent.html +++ b/docs/ref_builtins_type_independent.html @@ -14,7 +14,7 @@ - + - - + +

Type independent built-ins

@@ -200,9 +200,11 @@ ga('send', 'pageview');
-

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

Generated for: Freemarker 2.3.25 Last generated: -

-© 1999–2016 -The Apache Software Foundation. All rights reserved.

+

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

+Last generated: +, for Freemarker 2.3.25

+

+© 1999–2017 +The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/975692b4/docs/ref_depr_builtin.html ---------------------------------------------------------------------- diff --git a/docs/ref_depr_builtin.html b/docs/ref_depr_builtin.html index bc49e6a..6bc6831 100644 --- a/docs/ref_depr_builtin.html +++ b/docs/ref_depr_builtin.html @@ -14,7 +14,7 @@ - + - - + +

List of deprecated built-ins

@@ -95,9 +95,11 @@ ga('send', 'pageview');
-

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

Generated for: Freemarker 2.3.25 Last generated: -

-© 1999–2016 -The Apache Software Foundation. All rights reserved.

+

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

+Last generated: +, for Freemarker 2.3.25

+

+© 1999–2017 +The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/975692b4/docs/ref_depr_directive.html ---------------------------------------------------------------------- diff --git a/docs/ref_depr_directive.html b/docs/ref_depr_directive.html index 265bf1f..0ae4e96 100644 --- a/docs/ref_depr_directive.html +++ b/docs/ref_depr_directive.html @@ -14,7 +14,7 @@ - + - - + +

List of deprecated directives

@@ -81,9 +81,11 @@ ga('send', 'pageview');
-

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

Generated for: Freemarker 2.3.25 Last generated: -

-© 1999–2016 -The Apache Software Foundation. All rights reserved.

+

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

+Last generated: +, for Freemarker 2.3.25

+

+© 1999–2017 +The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/975692b4/docs/ref_depr_numerical_interpolation.html ---------------------------------------------------------------------- diff --git a/docs/ref_depr_numerical_interpolation.html b/docs/ref_depr_numerical_interpolation.html index 72962fb..4449b11 100644 --- a/docs/ref_depr_numerical_interpolation.html +++ b/docs/ref_depr_numerical_interpolation.html @@ -14,7 +14,7 @@ - + - - + +

#{...}: Numerical interpolation

@@ -125,9 +125,11 @@ or #{y; m1M2} <#-- 4.0 -->
-

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

Generated for: Freemarker 2.3.25 Last generated: -

-© 1999–2016 -The Apache Software Foundation. All rights reserved.

+

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

+Last generated: +, for Freemarker 2.3.25

+

+© 1999–2017 +The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/975692b4/docs/ref_depr_oldmacro.html ---------------------------------------------------------------------- diff --git a/docs/ref_depr_oldmacro.html b/docs/ref_depr_oldmacro.html index 15b373a..f4cfaab 100644 --- a/docs/ref_depr_oldmacro.html +++ b/docs/ref_depr_oldmacro.html @@ -14,7 +14,7 @@ - + - - + +

Old-style macro and call directives

@@ -188,9 +188,11 @@ ga('send', 'pageview'); return directive.

-

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

Generated for: Freemarker 2.3.25 Last generated: -

-© 1999–2016 -The Apache Software Foundation. All rights reserved.

+

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

+Last generated: +, for Freemarker 2.3.25

+

+© 1999–2017 +The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/975692b4/docs/ref_depr_oldsyntax.html ---------------------------------------------------------------------- diff --git a/docs/ref_depr_oldsyntax.html b/docs/ref_depr_oldsyntax.html index a35e353..b3b367b 100644 --- a/docs/ref_depr_oldsyntax.html +++ b/docs/ref_depr_oldsyntax.html @@ -14,7 +14,7 @@ - + - - + +

Old FTL syntax

@@ -60,12 +60,13 @@ ga('send', 'pageview'); </body> </html>

While the #-less syntax was more natural for HTML authors, it had too many drawbacks, so finally we have decided to - deprecate it. With the newer syntax (a.k.a ``strict syntax''), the - # is strictly required. That is, things like - <include "common_footer.html"> will go to the - output as is, since they are not considered as FTL tags. Note that - user-defined directives use @ instead - of #.

However, to give users time to prepare for this change, in + deprecate it. With the newer syntax (a.k.a "strict + syntax"), the # is strictly required. That + is, things like <include + "common_footer.html"> will go to the output as is, since + they are not considered as FTL tags. Note that user-defined directives + use @ instead of + #.

However, to give users time to prepare for this change, in FreeMarker 2.1 and 2.2 the usage of # is optional, unless the programmer enables strict syntax mode in the FreeMarker configuration by calling setStrictSyntaxMode(true) @@ -74,8 +75,8 @@ ga('send', 'pageview'); will be initially set to true. Also, you can specify if you want to use strict syntax or old syntax in the template files with the ftl - directive.

The advantages of ``strict syntax'' over the legacy FTL syntax - are:

    + directive.

    The advantages of "strict syntax" over the legacy + FTL syntax are:

    • Since all <#...> and @@ -120,9 +121,11 @@ ga('send', 'pageview');

-

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

Generated for: Freemarker 2.3.25 Last generated: -

-© 1999–2016 -The Apache Software Foundation. All rights reserved.

+

Overview

Handy stuff

Community

Edited with XMLMind XML Editor

+Last generated: +, for Freemarker 2.3.25

+

+© 1999–2017 +The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.