From notifications-return-5377-archive-asf-public=cust-asf.ponee.io@freemarker.apache.org Fri Mar 30 22:50:34 2018 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx-eu-01.ponee.io (Postfix) with SMTP id 9B6AC1807BA for ; Fri, 30 Mar 2018 22:50:31 +0200 (CEST) Received: (qmail 86697 invoked by uid 500); 30 Mar 2018 20:50:30 -0000 Mailing-List: contact notifications-help@freemarker.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@freemarker.apache.org Delivered-To: mailing list notifications@freemarker.apache.org Received: (qmail 86540 invoked by uid 99); 30 Mar 2018 20:50:30 -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; Fri, 30 Mar 2018 20:50:30 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id E6A3AF6A8E; Fri, 30 Mar 2018 20:50:29 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: ddekany@apache.org To: notifications@freemarker.apache.org Date: Fri, 30 Mar 2018 20:50:43 -0000 Message-Id: <567e75e02fe94a62af6012c408a43e3e@git.apache.org> In-Reply-To: References: X-Mailer: ASF-Git Admin Mailer Subject: [15/16] freemarker git commit: Manual: Minor version history fixes Manual: Minor version history fixes Project: http://git-wip-us.apache.org/repos/asf/freemarker/repo Commit: http://git-wip-us.apache.org/repos/asf/freemarker/commit/e6ba498a Tree: http://git-wip-us.apache.org/repos/asf/freemarker/tree/e6ba498a Diff: http://git-wip-us.apache.org/repos/asf/freemarker/diff/e6ba498a Branch: refs/heads/2.3 Commit: e6ba498a2d31bdb26081393cfb09e88dde784361 Parents: b6a3ffe Author: ddekany Authored: Fri Mar 30 22:45:42 2018 +0200 Committer: ddekany Committed: Fri Mar 30 22:45:42 2018 +0200 ---------------------------------------------------------------------- src/manual/en_US/book.xml | 78 ++++++++++++++++++------------------------ 1 file changed, 34 insertions(+), 44 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/freemarker/blob/e6ba498a/src/manual/en_US/book.xml ---------------------------------------------------------------------- diff --git a/src/manual/en_US/book.xml b/src/manual/en_US/book.xml index 5ab63c3..f59d2eb 100644 --- a/src/manual/en_US/book.xml +++ b/src/manual/en_US/book.xml @@ -27616,7 +27616,7 @@ TemplateModel x = env.getVariable("x"); // get variable x
2.3.28 - Release date: [FIXME] + Release date: 2018-03-30 + release process
Changes on the FTL side @@ -27654,8 +27654,10 @@ TemplateModel x = env.getVariable("x"); // get variable x - Added new built-ins: sequence?min and - sequence?max (Added new built-ins: + sequence?min and + sequence?max + (FREEMARKER-86), which return the smallest and greatest item from a list of numbers or date/time/date-times. When specifying the output_format - configuration settings with + configuration setting with String-String key-value pairs (like with Configuration.setSetting(String, String) or in a .properties file), - it's now possible to specify the standard output formats by name - rather than by class name (like - output_format=HTML). (Custom formats still - has to be referred by class name, as FreeMarker can't discover - what their names are, since it's not aware of the custom - classes.) + it's now possible to specify the standard output formats by + short name (like output_format=HTML) rather + than by class name. (Custom formats still has to be referred by + class name, as FreeMarker can't discover what their names are, + since it's not aware of the custom classes.) @@ -27783,7 +27784,7 @@ TemplateModel x = env.getVariable("x"); // get variable x Configuration.removeTemplateFromCache overload that has a Object customLookupCondition parameter. This is useful to - manually evacuate a template from the cache that was get via a + manually evacuate a template from the cache that was get with a non-null custom lookup condition. @@ -27862,16 +27863,16 @@ TemplateModel x = env.getVariable("x"); // get variable x The default arithmetic engine (ArithmeticEngine.BIGDECIMAL_ENGINE) can now compare infinite (both positive and negative) to any other - standard type. Earlier, since BigDecimal - can't represent infinite, it was only working in certain special - cases. Also did some performance optimizations to slightly - decrease the impact and number of conversions to - BigDecimal. + standard numerical type. Earlier, since + BigDecimal can't represent infinite, it was + only working in certain special cases. Also there were some + performance optimizations to slightly decrease the impact and + number of conversions to BigDecimal. Avoided possible performance bottleneck when executing - templates on many threads, caused be that + templates on many threads, caused by that java.beans.PropertyDescriptor.getReadMethod() is synchronized (FREEMARKER-80). @@ -27906,28 +27907,29 @@ TemplateModel x = env.getVariable("x"); // get variable x When the incompatible_improvements - setting is set to 2.3.28 (or greater), fixed legacy + setting is set to 2.3.28 (or greater): Fixed legacy parser glitch where a tag can be closed with an illegal ] (when it's not part of an expression) despite that the tag syntax is set to angle brackets. For example <#if x] worked just like - <#if x>. Note that it doesn't affect - the legal usage of ], like <#if - x[0]> works correctly without this fix as - well. + <#if x>. Note that this legacy glitch + didn't affect the legal usage of ], like + <#if x[0]> has always worked + correctly. Fixed parser bug that disallowed using - > at the top-level inside an interpolation - (${...}). It had the same reason why - <#if x > y> doesn't work as naively - expected, but there's no real ambiguity in ${x > - y}, so now it's allowed. Note that ${(x > - y)?c} and ${(x > y)?string('y', - 'n')}, which are how booleans are commonly printed, - have always worked, as the > operation is - not on the top-level inside the interpolation. + > as the top-level expression inside an + interpolation (${...}). It had the same + reason why <#if x > y> doesn't work + as naively expected, but there's no real ambiguity in + ${x > y}, so now it's allowed. Note that + ${(x > y)?c} and ${(x > + y)?string('y', 'n')}, which are how booleans are + commonly printed, have always worked, as the + > operation is not on the top-level inside + the interpolation. @@ -27945,7 +27947,7 @@ TemplateModel x = env.getVariable("x"); // get variable x FreeMarker has graduated from the Apache Incubator (as of - 2018-03-31), and now is a normal top-level project at Apache. + 2018-03-21), and now is a normal top-level project at Apache. Therefore, the version number doesn't contain -incubating anymore. @@ -28786,18 +28788,6 @@ TemplateModel x = env.getVariable("x"); // get variable x The license is still Apache License Version 2.0, just like earlier, but the owner is different. The official full product name has changed to Apache FreeMarker. - - Disclaimer: Apache - FreeMarker is an effort undergoing incubation at The Apache Software - Foundation (ASF), sponsored by the Apache Incubator. - Incubation is required of all newly accepted projects until a - further review indicates that the infrastructure, communications, - and decision making process have stabilized in a manner consistent - with other successful ASF projects. While incubation status is not - necessarily a reflection of the completeness or stability of the - code, it does indicate that the project has yet to be fully endorsed - by the ASF.