http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/52c070a9/builds/2.3.26-nightly/versions_2_2.html ---------------------------------------------------------------------- diff --git a/builds/2.3.26-nightly/versions_2_2.html b/builds/2.3.26-nightly/versions_2_2.html new file mode 100644 index 0000000..a4854d3 --- /dev/null +++ b/builds/2.3.26-nightly/versions_2_2.html @@ -0,0 +1,1107 @@ +<!doctype html> +<!-- Generated by FreeMarker/Docgen from DocBook --> +<html lang="en" class="page-type-section"> +<head prefix="og: http://ogp.me/ns#";> +<meta charset="utf-8"> +<title>2.2 - Apache FreeMarker Manual</title> +<meta http-equiv="X-UA-Compatible" content="IE=edge"> +<meta name="viewport" content="width=device-width,initial-scale=1"> +<meta name="format-detection" content="telephone=no"> +<meta property="og:site_name" content="Apache FreeMarker Manual"> +<meta property="og:title" content="2.2"> +<meta property="og:locale" content="en_US"> +<meta property="og:url" content="http://freemarker.org/docs/versions_2_2.html";> +<link rel="canonical" href="http://freemarker.org/docs/versions_2_2.html";> +<link rel="icon" href="favicon.png" type="image/png"> +<link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono"> +<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1489402528979"> +<script> +(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ +(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), +m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) +})(window,document,'script','//www.google-analytics.com/analytics.js','ga'); +ga('create', 'UA-55420501-1', 'auto'); +ga('send', 'pageview'); +</script> +</head> +<body itemscope itemtype="https://schema.org/Code";> + <meta itemprop="url" content="http://freemarker.org/docs/";> + <meta itemprop="name" content="Apache FreeMarker Manual"> + + <!--[if lte IE 9]> + <div style="background-color: #C00; color: #fff; padding: 12px 24px;">Please use a modern browser to view this website.</div> + <![endif]--><div class="header-top-bg"><div class="site-width header-top"><a class="logo" href="http://freemarker.org"; role="banner"> <img itemprop="image" src="logo.png" alt="FreeMarker"> +</a><ul class="tabs"><li><a href="http://freemarker.org/";>Home</a></li><li class="current"><a href="index.html">Manual</a></li><li><a class="external" href="api/index.html">Java API</a></li></ul><ul class="secondary-tabs"><li><a class="tab icon-heart" href="http://freemarker.org/contribute.html"; title="Contribute"><span>Contribute</span></a></li><li><a class="tab icon-bug" href="https://issues.apache.org/jira/browse/FREEMARKER/"; title="Report a Bug"><span>Report a Bug</span></a></li><li><a class="tab icon-download" href="http://freemarker.org/freemarkerdownload.html"; title="Download"><span>Download</span></a></li></ul></div></div><div class="header-bottom-bg"><div class="site-width search-row"><a href="index.html" class="navigation-header">Manual</a><div class="navigation-header"></div><form method="get" class="search-form" action="search-results.html"><fieldset><legend class="sr-only">Search form</legend><label for="search-field" class="sr-only">Search query</label><input id="searc h-field" name="q" type="search" class="search-input" placeholder="Search" spellcheck="false" autocorrect="off" autocomplete="off"><button type="submit" class="search-btn"><span class="sr-only">Search</span></button></fieldset></form></div><div class="site-width breadcrumb-row"><ul class="breadcrumb" itemscope itemtype="http://schema.org/BreadcrumbList";><li class="step-0" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="index.html"><span itemprop="name">Apache FreeMarker Manual</span></a></li><li class="step-1" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="app.html"><span itemprop="name">Appendixes</span></a></li><li class="step-2" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="app_versions.html"><span itemprop="name">Version history</span></a></li><li class="step-3" itemprop="itemListEl ement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="versions_2_2.html"><span itemprop="name">2.2</span></a></li></ul><div class="bookmarks" title="Bookmarks"><span class="sr-only">Bookmarks:</span><ul class="bookmark-list"><li><a href="alphaidx.html">Alpha. index</a></li><li><a href="gloss.html">Glossary</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions</a></li><li><a href="ref_builtins_alphaidx.html">?builtins</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_specvar.html">.spec_vars</a></li><li><a href="app_faq.html">FAQ</a></li></ul></div></div></div> <div class="main-content site-width"> + <div class="content-wrapper"> + <div id="table-of-contents-wrapper" class="col-left"> + <script>var breadcrumb = ["Apache FreeMarker Manual","Appendixes","Version history","2.2"];</script> + <script src="toc.js?1489402528979"></script> + <script src="docgen-resources/main.min.js?1489402528979"></script> + </div> +<div class="col-right"><div class="page-content"><div class="page-title"><div class="pagers top"><a class="paging-arrow previous" href="versions_2_2_1.html"><span>Previous</span></a><a class="paging-arrow next" href="versions_2_1_5.html"><span>Next</span></a></div><div class="title-wrapper"> +<h1 class="content-header header-section1" id="versions_2_2" itemprop="headline">2.2</h1> +</div></div><div class="page-menu"> +<div class="page-menu-title">Page Contents</div> +<ul><li><a class="page-menu-link" href="#autoid_260" data-menu-target="autoid_260">Non backward-compatible changes!</a></li><li><a class="page-menu-link" href="#autoid_261" data-menu-target="autoid_261">Changes in FTL (FreeMarker Template Language)</a></li><li><a class="page-menu-link" href="#autoid_262" data-menu-target="autoid_262">Changes on the Java side</a></li><li><a class="page-menu-link" href="#autoid_263" data-menu-target="autoid_263">Other changes</a></li><li><a class="page-menu-link" href="#autoid_264" data-menu-target="autoid_264">The history of the releases before the final version</a><ul><li><a class="page-menu-link" href="#autoid_265" data-menu-target="autoid_265">Differences between the final and RC2 releases</a></li><li><a class="page-menu-link" href="#autoid_266" data-menu-target="autoid_266">Differences between the RC2 and RC1 releases</a></li><li><a class="page-menu-link" href="#autoid_267" data-menu-target="autoid_267">Differences between the Preview 2 and RC1 r eleases</a></li><li><a class="page-menu-link" href="#autoid_268" data-menu-target="autoid_268">Differences between the Preview 1 and Preview 2 +releases</a></li></ul></li></ul> </div><p>Date of release: 2003-03-27</p><p>This release introduces some really important new features. + Unfortunately, evolution was painful again; we have a few non-backward + compatible changes (see below). Also, for those of you awaiting + desired native date/time type, sorry, it is still not here (because of + some internal chaos in the team... stand by, it's coming).</p> + + + + +<h2 class="content-header header-section2" id="autoid_260">Non backward-compatible changes!</h2> + + + <ul> + <li> + <p>Macros are now plain variables. This means that if you are + unlucky and you have both a macro and another variable with the + same name, now the variable will overwrite the macro, so your + old template will malfunction. If you have a collection of + common macros, you should use the new <a href="dgui_misc_namespace.html">namespace feature</a> to + prevent accidental clashes with the variables used in the + templates.</p> + </li> + + <li> + <p>With the introduction of the new <a href="dgui_misc_namespace.html">namespace support</a>, + <code class="inline-code">global</code> and <code class="inline-code">assign</code> + directives are no longer synonyms. <code class="inline-code">assign</code> + creates a variable in the current <code class="inline-code">namespace</code>, + while <code class="inline-code">global</code> creates variable that is visible + from all namespaces (as if the variable would be in the + data-model). Thus, the variable created with + <code class="inline-code">assign</code> is more specific, and hides the + variable of the same name created with + <code class="inline-code">global</code>. As a result, if you use both + <code class="inline-code">global</code> and <code class="inline-code">assign</code> mixed + for the same variable in your templates, now they will + malfunction. The solution is to search-and-replace all + <code class="inline-code">global</code>s in your old templates with + <code class="inline-code">assign</code>.</p> + </li> + + <li> + <p>The reserved hash <code class="inline-code">root</code> no longer exists + as a predefined variable (we no longer have reserved variables). + Use <a href="dgui_template_exp.html#dgui_template_exp_var_special">special + variable expressions</a> to achieve similar effects. However, + we have no equivalent replacement for <code class="inline-code">root</code> + because of the changes in the variable scopes caused by the + introduction of namespaces. You may should use + <code class="inline-code">.globals</code> or + <code class="inline-code">.namespace</code>.</p> + </li> + + <li> + <p>The <code class="inline-code">BeansWrapper</code> no longer exposes + native Java arrays, booleans, numbers, enumerations, iterators, + and resource bundles as <code class="inline-code">TemplateScalarModel</code>. + This way, number objects wrapped through + <code class="inline-code">BeansWrapper</code> are subject to FreeMarker's + number formatting machinery. Also, booleans can be formatted + using the <code class="inline-code">?string</code> built-in.</p> + </li> + + <li> + <p>The signature of + <code class="inline-code">Configuration.setServletContextForTemplateLoading</code> + has been changed: the first parameter is now + <code class="inline-code">Object</code> instead of + <code class="inline-code">javax.servlet.ServletContext</code>. Thus, you have + to recompile your classes that call this method. The change was + required to prevent class-loading failure when + <code class="inline-code">javax.servlet</code> classes are not available and + you would not call this method.</p> + </li> + + <li> + <p>This release introduces a <a href="dgui_misc_whitespace.html">parse-time white-space + remover</a> that strips some of the typical superfluous + white-space around FreeMarker tags and comments. <em>This + feature is on by default!</em> Most probably this will not + cause problems if you generate white-space neutral output like + HTML. But if it does cause undesirable reformatting in output + you generate, you can disable it with + <code class="inline-code">config.setWhitespaceStripping(false)</code>. Also, + you can enable/disable it on a per-template basis with the new + <a href="ref_directive_ftl.html#ref.directive.ftl"><code>ftl</code></a> + directive.</p> + </li> + + <li> + <p>Some new directives were introduced: + <code class="inline-code">nested</code>, <code class="inline-code">import</code>, + <code class="inline-code">escape</code>, <code class="inline-code">noescape</code>, + <code class="inline-code">t</code>, <code class="inline-code">rt</code>, + <code class="inline-code">lt</code>. This means that if you are unlucky and + the text of your template contains something like + <code class="inline-code"><nested></code>, then that will be + misinterpreted as a directive. To prevent this kind of problem + in the future, we recommend everybody to switch from the old + syntax to the new syntax ("strict syntax"). The + strict syntax will be the the default syntax starting from some + of the later releases anyway. We plan to release a conversion + tool for converting old templates. For more information please + read: <a href="ref_depr_oldsyntax.html">Template Language Reference/Deprecated FTL constructs/Old FTL syntax</a></p> + </li> + + <li> + <p>The data-model created by the + <code class="inline-code">FreemarkerServlet</code> now uses automatic scope + discovery, so writing + <code class="inline-code">Application.<em class="code-color">attrName</em></code>, + <code class="inline-code">Session.<em class="code-color">attrName</em></code>, + <code class="inline-code">Request.<em class="code-color">attrName</em></code> + is no longer mandatory; it's enough to write + <code class="inline-code"><em class="code-color">attrName</em></code> (for more + information <a href="pgui_misc_servlet.html#topic.servlet.scopeAttr">read + this</a>). This may break an old template if that rely on the + non-existence of certain top-level variables.</p> + </li> + + <li> + <p><code class="inline-code">FreemarkerServlet</code> now uses the encoding + of the template file for the output, unless you specify the + encoding in the <code class="inline-code">ContentType</code> init-param, such + as <code class="inline-code">text/html; charset=UTF-8</code>.</p> + </li> + + <li> + <p>The format of template paths is now more restricted than + before. The path must not use <code class="inline-code">/</code>, + <code class="inline-code">./</code> and <code class="inline-code">../</code> and + <code class="inline-code">://</code> with other meaning as they have in URL + paths (or in UN*X paths). The characters <code class="inline-code">*</code> + and <code class="inline-code">?</code> are reserved. Also, the template loader + must not want paths starting with <code class="inline-code">/</code>. For more + information please read: <a href="pgui_config_templateloading.html">Programmer's Guide/The Configuration/Template loading</a></p> + </li> + + <li> + <p>Till now + <code class="inline-code">TemplateTransformModel.getWriter</code> has received + null as parameter map if the transform was called without + parameters. From now, it will receive an empty Map instead. Note + that the previous API documentation didn't state that it always + receives null if there are no parameters, so hopelessly only + very few classes exploit this design mistake.</p> + </li> + </ul> + + + + + +<h2 class="content-header header-section2" id="autoid_261">Changes in FTL (FreeMarker Template Language)</h2> + + + <ul> + <li> + <p>User-defined directives: Transform and macro call syntax + has been unified; they can be called in the same way, as + user-defined directives. This also means that macros support + named parameters and nested content (like the -- now deprecated + -- <code class="inline-code">transform</code> directive did). For example, if + you have a macro called <code class="inline-code">sect</code>, you may call it + via <code class="inline-code"><@sect title="Blah" style="modern">Blah + blah...</@sect></code>. For more information read: + <a href="dgui_misc_userdefdir.html">Template Author's Guide/Miscellaneous/Defining your own directives</a></p> + </li> + + <li> + <p>Macros are now plain variables. This significantly + simplifies FreeMarker semantics, while providing more + flexibility; for example you can pass macros as parameters to + other macros and transforms. As for the problem of clashing + commonly-used-macro and variable names, we provide a more + powerful solution: namespaces.</p> + </li> + + <li> + <p>Namespaces: Names-spaces are invaluable if you want to + assemble collections ("libraries") of macros and + transforms (and other variables), and then use them in any + template without worrying about accidental name clashes with the + application specific and temporary variables, or with the + variables of other collections you want to use in the same + template. This is extremely important if FreeMarker users want + to share their macro/transform collections. For more information + read: <a href="dgui_misc_namespace.html">Template Author's Guide/Miscellaneous/Namespaces</a></p> + </li> + + <li> + <p>With the introduction of namespaces our variable related + terminology changed. As a result, <code class="inline-code">assign</code> is + no longer synonymous with <code class="inline-code">global</code>. The + <code class="inline-code">assign</code> directive has been undeprecated, and + should be used instead of <code class="inline-code">global</code> almost + everywhere. In the new approach <code class="inline-code">assign</code> + creates variables in the current namespace, while + <code class="inline-code">global</code> creates a variable that is visible + from all namespaces (as if the variable were in the root of the + data-model). A variable created with <code class="inline-code">assign</code> + in the current namespace hides the variable of the same name + that was created with <code class="inline-code">global</code>.</p> + </li> + + <li> + <p><code class="inline-code">ftl</code> directive: With this directive you + can give information about the template for FreeMarker, like the + encoding (charset) of the template, the used FTL syntax variant, + etc. Also, this directive helps you to write templates that are + less dependent on FreeMarker configuration settings, also it + helps third-party tools to identify and correctly parse + FreeMarker templates. For more information see: <a href="ref_directive_ftl.html#ref.directive.ftl"><code>ftl</code> + directive</a></p> + </li> + + <li> + <p>White-space stripping: FreeMarker now automatically + removes some of the typical superfluous white-spaces around + FreeMarker tags and comments, like the indentation spaces + before- and line-break after <code class="inline-code"><#if ...></code> + tags. For more information read: <a href="dgui_misc_whitespace.html#dgui_misc_whitespace_stripping">Template Author's Guide/Miscellaneous/White-space handling/White-space stripping</a></p> + </li> + + <li> + <p>New directive to apply a common ("escaping") expression to + all interpolations in a block: <a href="ref_directive_escape.html#ref.directive.escape"><code>escape</code></a>. + The name comes from the common usage of this directive for + automatic HTML-escaping of interpolations.</p> + </li> + + <li> + <p>The new and preferred way of number formatting with + <code class="inline-code">string</code> built-in is + <code class="inline-code">foo?string(format)</code>, instead of the less + natural <code class="inline-code">foo?string[format]</code>.</p> + </li> + + <li> + <p>The <code class="inline-code">string</code> built-in works for boolean + values. For example: <code class="inline-code">${spamFilter?string("enabled", + "disabled")}</code>. For more information <a href="ref_builtins_boolean.html#ref_builtin_string_for_boolean">read the + reference</a>.</p> + </li> + + <li> + <p>The default strings for outputting boolean value using the + <code class="inline-code">string</code> built-in can be set using the + <code class="inline-code">boolean_format</code> setting.</p> + </li> + + <li> + <p>Comments can be placed inside FTL tags and interpolations. + For example: <code class="inline-code"><#assign <#-- a comment --> x = + 3></code></p> + </li> + + <li> + <p>All letters and numbers are enabled in variable names, + also <code class="inline-code">$</code> is allowed (as in Java programming + language). Thus you can use accents, Arabic letters, Chinese + letters, etc.</p> + </li> + + <li> + <p>String literals can be quoted with apostrophe-quote. + <code class="inline-code">"foo"</code> and <code class="inline-code">'foo'</code> are + equivalent.</p> + </li> + + <li> + <p>New <a href="ref_builtins_string.html">string + built-ins</a>: <code class="inline-code">index_of</code>, + <code class="inline-code">last_index_of</code>, + <code class="inline-code">starts_with</code>, <code class="inline-code">ends_with</code>, + <code class="inline-code">replace</code>, <code class="inline-code">split</code>, + <code class="inline-code">chop_linebreak</code>, + <code class="inline-code">uncap_first</code>.</p> + </li> + + <li> + <p>New <a href="ref_builtins_sequence.html">sequence + built-ins</a>: <code class="inline-code">sort</code>, + <code class="inline-code">sort_by</code>.</p> + </li> + + <li> + <p>New built-ins for experts to check the type of a variable. + See: <a href="ref_builtins_expert.html#ref_builtin_isType"><code>is_<em>...</em></code> + built-ins</a></p> + </li> + + <li> + <p>New built-in for experts to create a variable of certain + Java <code class="inline-code">TemplateModel</code> implementation. See: <a href="ref_builtins_expert.html#ref_builtin_new"><code>new</code> + built-in</a></p> + </li> + + <li> + <p>New built-in, <a href="ref_builtins_expert.html#ref_builtin_namespace"><code>namespace</code></a>, + to get the namespace of a macro.</p> + </li> + + <li> + <p>New expression type: special variable expression. To + prevent backward compatibility problems when we introduce new + predefined variables, from now <a href="dgui_template_exp.html#dgui_template_exp_var_special">special variable + expressions</a> are used to access them.</p> + </li> + + <li> + <p>New directives: <code class="inline-code">t</code>, + <code class="inline-code">rt</code> and <code class="inline-code">lt</code> directives allow + you to do explicit white-space removal in extreme FTL + applications. For more information read <a href="ref_directive_t.html#ref.directive.t">the reference</a>.</p> + </li> + + <li> + <p><code class="inline-code">assign</code>, <code class="inline-code">local</code> and + <code class="inline-code">global</code> now can capture the output generated + be the nested template fragment into the variable. This + deprecates <code class="inline-code">capture_output</code> transform. More + information: <a href="ref_directive_assign.html#ref.directive.assign">assign + directive reference</a></p> + </li> + + <li> + <p>Bulk assignments (as <code class="inline-code"><#assign x=1, y=2, + z=3></code>) no longer need colon to separate the + assignments (as <code class="inline-code"><#assign x=1 y=2 z=3></code>), + although it is still allowed to preserve backward + compatibility.</p> + </li> + + <li> + <p>Path that contains <code class="inline-code">//:</code> is considered as + absolute path.</p> + </li> + + <li> + <p><code class="inline-code">include</code> and + <code class="inline-code">transform</code> directives no longer need a + semicolon to separate the template or transform name from the + parameter list, although it is still allowed to preserve + backward compatibility.</p> + </li> + + <li> + <p><code class="inline-code">#</code>-less tag syntax is deprecated (but + still working). That is, you should write + <code class="inline-code"><#<em class="code-color">directive + ...</em>></code> instead of + <code class="inline-code"><<em class="code-color">directive + ...</em>></code>, and + <code class="inline-code"></#<em class="code-color">directive + ...</em>></code> instead of + <code class="inline-code"></<em class="code-color">directive + ...</em>></code>. For more info read: <a href="ref_depr_oldsyntax.html">Template Language Reference/Deprecated FTL constructs/Old FTL syntax</a></p> + </li> + + <li> + <p><code class="inline-code">foreach</code> is depreciated (but still + working). Use <a href="ref_directive_list.html#ref.directive.list"><code>list</code></a> + instead.</p> + </li> + + <li> + <p>Bugfix: Undefined variables in hash and sequence + constructors (as <code class="inline-code">[a, b, c]</code>) didn't caused + errors.</p> + </li> + + <li> + <p>Bugfix: String concatenation had performance problem if + there was multiple concatenations chained, as: + <code class="inline-code">"a"+x+"a"+x+"a"+x+"a"+x+"a"+x</code>.</p> + </li> + </ul> + + + + + +<h2 class="content-header header-section2" id="autoid_262">Changes on the Java side</h2> + + + <ul> + <li> + <p>Arbitrary JSP custom tags can be used as FreeMarker + transforms in <code class="inline-code">FreemarkerServlet</code>-driven + templates. More information: <a href="pgui_misc_servlet.html">Programmer's Guide/Miscellaneous/Using FreeMarker with servlets</a></p> + </li> + + <li> + <p>Various improvements for + <code class="inline-code">BeansWrapper</code>:</p> + + <ul> + <li> + <p>The <code class="inline-code">BeansWrapper</code> no longer exposes + arbitrary objects as + <code class="inline-code">TemplateScalarModel</code>s, only + <code class="inline-code">java.lang.String</code> and + <code class="inline-code">Character</code> objects. This way, number + objects wrapped through <code class="inline-code">BeansWrapper</code> are + subject to FreeMarker's number formatting machinery. As a + side effect, non-string and non-number objects that were + previously accepted in equality and inequality operations + (because they had a string representation) will now cause + the engine to throw exception on comparison attempt.</p> + </li> + + <li> + <p><code class="inline-code">java.lang.Character</code> objects are + exposed as scalars through + <code class="inline-code">BeansWrapper</code>.</p> + </li> + + <li> + <p>Experimental feature: With the + <code class="inline-code">setSimpleMapWrapper</code> method of + <code class="inline-code">BeansWrapper</code> you can configure it to wrap + <code class="inline-code">java.util.Map</code>-s as + <code class="inline-code">TemplateHashModelEx</code>-s, and do not expose + the methods of the object.</p> + </li> + </ul> + </li> + + <li> + <p><code class="inline-code">TransformControl</code> interface (was + experimental earlier): If the <code class="inline-code">Writer</code> returned + by <code class="inline-code">TemplateTransformModel.getWriter</code> + implements this interface, it can instruct the engine to skip or + to repeat evaluation of the nested content, and gets notified + about exceptions that are thrown during the nested content + evaluation. Note that the <code class="inline-code">onStart</code> and + <code class="inline-code">afterBody</code> methods now are allowed to throw + <code class="inline-code">IOException</code>. For more information please read + the API documentation.</p> + </li> + + <li> + <p>Localized lookup can be disabled with the new + <code class="inline-code">Configuration</code> methods: + <code class="inline-code">set/getLocalizedLookup</code>, + <code class="inline-code">clearTemplateCache</code></p> + </li> + + <li> + <p>The new interface + <code class="inline-code">freemarker.cache.CacheStorage</code> allows users to + plug custom template caching strategies with the + <code class="inline-code">cache_storage</code> setting. The core package now + ships with two implementations: + <code class="inline-code">SoftCacheStorage</code> and + <code class="inline-code">StrongCacheStorage</code>. For more information + read: <a href="pgui_config_templateloading.html">Programmer's Guide/The Configuration/Template loading</a></p> + </li> + + <li> + <p>You can set settings with string name and string value + with the new <code class="inline-code">setSetting(String key, String + value)</code> method of <code class="inline-code">Configurable</code> + super-classes (as <code class="inline-code">Configuration</code>). Also you + can load settings from <code class="inline-code">.properties</code> file with + the <code class="inline-code">setSettings</code> method.</p> + </li> + + <li> + <p>Other new <code class="inline-code">Configuration</code> methods: + <code class="inline-code">clearTemplateCache</code>, + <code class="inline-code">clearSharedVariables</code>, + <code class="inline-code">getTemplateLoader</code>, and + <code class="inline-code">clone</code>.</p> + </li> + + <li> + <p>Changes to <code class="inline-code">TemplateTransformModel</code> + interface: <code class="inline-code">getWriter</code> can throw + <code class="inline-code">IOException</code>, and can return + <code class="inline-code">null</code> if the transform does not support body + content.</p> + </li> + + <li> + <p>Till now + <code class="inline-code">TemplateTransformModel.getWriter</code> has received + null as parameter map if the transform was called without + parameters. From now, it will receive an empty Map instead. Note + that the previous API documentation didn't state that it always + receives null if there are no parameters, so hopelessly only + very few classes exploit this design mistake.</p> + </li> + + <li> + <p>Various improvements for + <code class="inline-code">FreemarkerServlet</code>:</p> + + <ul> + <li> + <p>The data-model now uses automatic scope discovery, so + writing + <code class="inline-code">Application.<em class="code-color">attrName</em></code>, + <code class="inline-code">Session.<em class="code-color">attrName</em></code>, + <code class="inline-code">Request.<em class="code-color">attrName</em></code> + is no longer mandatory; it's enough to write + <code class="inline-code"><em class="code-color">attrName</em></code>. For + more information <a href="pgui_misc_servlet.html#topic.servlet.scopeAttr">read this</a>.</p> + </li> + + <li> + <p><code class="inline-code">FreemarkerServlet</code> now uses the + encoding of the template file for the output, unless you + specify the encoding in the <code class="inline-code">ContentType</code> + init-param, such as <code class="inline-code">text/html; + charset=UTF-8</code>.</p> + </li> + + <li> + <p>All <code class="inline-code">Configuration</code> level settings + can by set with Servlet init-params + (<code class="inline-code">template_exception_handler</code>, + <code class="inline-code">locale</code>, <code class="inline-code">number_format</code>, + etc.).</p> + </li> + + <li> + <p>The object wrapper the servlet internally uses is now + set as the default object wrapper for its + <code class="inline-code">Configuration</code> instance.</p> + </li> + + <li> + <p>It no longer forces session creation for requests that + don't belong to an existing session, improving + scalability.</p> + </li> + </ul> + </li> + + <li> + <p>JDOM independent XML-wrapping: + <code class="inline-code">freemarker.ext.xml.NodeListModel</code> is a + re-implementation of + <code class="inline-code">freemarker.ext.jdom.NodeListModel</code> that does + not rely on JDOM; you don't need JDOM .jar anymore. The new + <code class="inline-code">NodeListModel</code> automatically uses W3C DOM, + dom4j, or JDOM, depending on which library is available (that + is, depending on what object do you pass to its + constructor).</p> + </li> + + <li> + <p>Bugfix: <code class="inline-code">WebappTemplateLoader</code>: Template + updating didn't worked correctly with Tomcat due the caching of + resources. Now <code class="inline-code">WebappTemplateLoader</code> tries to + access the resources directly as <code class="inline-code">File</code>, if it + is possible, thus bypasses the caching.</p> + </li> + + <li> + <p>Various bug-fixes for + <code class="inline-code">FreemarkerServlet</code>:</p> + + <ul> + <li> + <p>The servlet now loads the correct template if it was + called through + <code class="inline-code">RequestDispatcher.include</code>.</p> + </li> + + <li> + <p>The caching of <code class="inline-code">HttpServletRequest</code> + objects is now compliant with the servlet + specification.</p> + </li> + + <li> + <p><code class="inline-code">TemplateException</code>s was suppressed + in certain situations resulting in half-rendered pages + without error message.</p> + </li> + </ul> + </li> + + <li> + <p>Bugfix: FreeMarker didn't work if the + <code class="inline-code">javax.servlet</code> classes was not available, + because <code class="inline-code">Configuration</code> explicitly referred to + <code class="inline-code">javax.servlet.ServletContext</code>.</p> + </li> + + <li> + <p>Bugfix: classes may were not found if they was available + only in the <code class="inline-code">WEB-INF</code>, and FreeMarker tried to + load the class dynamically.</p> + </li> + + <li> + <p>Bugfix: the <code class="inline-code">Template</code> constructor (and + thus <code class="inline-code">Configuration.getTemplate</code>) sometimes + threw <code class="inline-code">TokenMgrError</code> (a non-checked exception) + instead of <code class="inline-code">ParseException</code>.</p> + </li> + </ul> + + + + + +<h2 class="content-header header-section2" id="autoid_263">Other changes</h2> + + + <ul> + <li> + <p>The Web application related examples has been + replaced.</p> + </li> + </ul> + + + + + +<h2 class="content-header header-section2" id="autoid_264">The history of the releases before the final version</h2> + + + + + + + +<h3 class="content-header header-section3" id="autoid_265">Differences between the final and RC2 releases</h3> + + + <ul> + <li> + <p>You can load settings from + <code class="inline-code">.properties</code> file with the + <code class="inline-code">setSettings</code> method of + <code class="inline-code">Configuration</code> and other + <code class="inline-code">Configurable</code> subclasses.</p> + </li> + + <li> + <p>New string built-in: + <code class="inline-code">uncap_first</code></p> + </li> + + <li> + <p>Bugfix: When exposing an XML document to a template and + accessing it with XPath using Jaxen a + <code class="inline-code">ClassCastException</code> has occurred.</p> + </li> + + <li> + <p>Bugfix: The template cache has loaded templates with bad + <code class="inline-code">Configuration</code> instance in certain + situations if you use not the static default + <code class="inline-code">Configuration</code> instance.</p> + </li> + </ul> + + + + + + + +<h3 class="content-header header-section3" id="autoid_266">Differences between the RC2 and RC1 releases</h3> + + + <ul> + <li> + <p>Non backward compatible change!: + <code class="inline-code">FreemarkerServlet</code> now uses the encoding of + the template file for the output, unless you specify the + encoding in the <code class="inline-code">ContentType</code> init-param, + such as <code class="inline-code">text/html; charset=UTF-8</code>.</p> + </li> + + <li> + <p>Non backward compatible change compared to RC1!: The + <code class="inline-code">capture_output</code> transform creates variable + in the current namespace (as <code class="inline-code">assign</code> + directive) with the <code class="inline-code">var</code> parameter, not a + global variable.</p> + </li> + + <li> + <p>The new and preferred way of number formatting with + <code class="inline-code">string</code> built-in is + <code class="inline-code">foo?string(format)</code>, instead of the less + natural <code class="inline-code">foo?string[format]</code>.</p> + </li> + + <li> + <p>The <code class="inline-code">string</code> built-in works for boolean + values. For example: <code class="inline-code">${spamFilter?string("enabled", + "disabled")}</code>. For more information <a href="ref_builtins_boolean.html#ref_builtin_string_for_boolean">read the + reference</a>.</p> + </li> + + <li> + <p>The default strings for outputting boolean value using + the <code class="inline-code">string</code> built-in can be set using the + <code class="inline-code">boolean_format</code> setting.</p> + </li> + + <li> + <p>String literals can be quoted with apostrophe-quote. + <code class="inline-code">"foo"</code> and <code class="inline-code">'foo'</code> are + equivalent.</p> + </li> + + <li> + <p>The new interface + <code class="inline-code">freemarker.cache.CacheStorage</code> allows users + to plug custom template caching strategies with the + <code class="inline-code">cache_storage</code> setting. The core package now + ships with two implementations: + <code class="inline-code">SoftCacheStorage</code> and + <code class="inline-code">StrongCacheStorage</code>. For more information + read: <a href="pgui_config_templateloading.html">Programmer's Guide/The Configuration/Template loading</a></p> + </li> + + <li> + <p>You can set settings with string name and string value + with the new <code class="inline-code">setSetting(String key, String + value)</code> method of <code class="inline-code">Configurable</code> + super-classes (as <code class="inline-code">Configuration</code>).</p> + </li> + + <li> + <p>Other new <code class="inline-code">Configuration</code> methods: + <code class="inline-code">getTemplateLoader</code>, + <code class="inline-code">clone</code>.</p> + </li> + + <li> + <p><code class="inline-code">assign</code>, <code class="inline-code">local</code> and + <code class="inline-code">global</code> now can capture the output generated + be the nested template fragment into the variable. This + deprecates <code class="inline-code">capture_output</code> transform. More + information: <a href="ref_directive_assign.html#ref.directive.assign">assign + directive reference</a></p> + </li> + + <li> + <p>Other new <code class="inline-code">Configuration</code> methods: + <code class="inline-code">getTemplateLoader</code>, + <code class="inline-code">clone</code>.</p> + </li> + + <li> + <p>Changes to <code class="inline-code">TemplateTransformModel</code> + interface: <code class="inline-code">getWriter</code> can throw + <code class="inline-code">IOException</code>, and can return + <code class="inline-code">null</code> if the transform does not support body + content.</p> + </li> + + <li> + <p>Till now + <code class="inline-code">TemplateTransformModel.getWriter</code> has + received null as parameter map if the transform was called + without parameters. From now, it will receive an empty Map + instead. Note that the previous API documentation didn't state + that it always receives null if there are no parameters, so + hopelessly only very few classes exploit this design + mistake.</p> + </li> + + <li> + <p>Changes to <code class="inline-code">TemplateControl</code> interface: + <code class="inline-code">onStart</code> and <code class="inline-code">afterBody</code> + methods are now allowed to throw + <code class="inline-code">IOException</code>.</p> + </li> + + <li> + <p>Path that contains <code class="inline-code">//:</code> is considered + as absolute path.</p> + </li> + + <li> + <p>New <a href="ref_builtins_string.html">string + built-ins</a>: <code class="inline-code">index_of</code>, + <code class="inline-code">last_index_of</code>, + <code class="inline-code">starts_with</code>, <code class="inline-code">ends_with</code>, + <code class="inline-code">replace</code>, <code class="inline-code">split</code>, + <code class="inline-code">chop_linebreak</code>.</p> + </li> + + <li> + <p>New <a href="ref_builtins_sequence.html">sequence + built-ins</a>: <code class="inline-code">sort</code>, + <code class="inline-code">sort_by</code>.</p> + </li> + + <li> + <p>All <code class="inline-code">Configuration</code> level settings can + by set with Servlet init-params + (<code class="inline-code">template_exception_handler</code>, + <code class="inline-code">locale</code>, <code class="inline-code">number_format</code>, + etc.).</p> + </li> + + <li> + <p>Bugfix: classes may were not found if they was available + only in the <code class="inline-code">WEB-INF</code>, and FreeMarker tried + to load the class dynamically.</p> + </li> + + <li> + <p>Bugfix: <code class="inline-code">setLocalizedLookup(false)</code> of + <code class="inline-code">Configuration</code> was overridden when you have + called <code class="inline-code">setTemplateLoader</code>.</p> + </li> + + <li> + <p>Bugfix: String concatenation had performance problem if + there was multiple concatenations chained, as: + <code class="inline-code">"a"+x+"a"+x+"a"+x+"a"+x+"a"+x</code>.</p> + </li> + + <li> + <p>Bugfix: white-space stripping was not worked with tags + spanning over multiple lines.</p> + </li> + + <li> + <p>Bugfix: Removing several dependencies on JDK 1.3, so + FreeMarker can be build for JDK 1.2.2.</p> + </li> + </ul> + + + + + + + +<h3 class="content-header header-section3" id="autoid_267">Differences between the Preview 2 and RC1 releases</h3> + + + <ul> + <li> + <p><code class="inline-code">ftl</code> is now stricter, and does not + allow custom parameters. To associate custom attributes to + templates, we may add a new directive later, if there is a + demand for it.</p> + </li> + + <li> + <p><code class="inline-code">escape</code> directive does not affect + numerical interpolations + (<code class="inline-code">#{<em class="code-color">...</em>}</code>) + anymore, as it has caused errors with string escapes as + <code class="inline-code">?html</code>.</p> + </li> + + <li> + <p>The <code class="inline-code">normalizeName</code> method of + <code class="inline-code">freemarker.cache.TemplateLoader</code> has been + removed, because it has caused too many complications. + Instead, normalization happens on a single point in the + <code class="inline-code">TempateCache</code>. In consequence, FreeMarker is + now stricter about the format of template paths, as things + like <code class="inline-code">/../</code> are interpreted by the + core.</p> + </li> + + <li> + <p>Experimental feature: With the + <code class="inline-code">setSimpleMapWrapper</code> method of + <code class="inline-code">BeansWrapper</code> you can configure it to wrap + <code class="inline-code">java.util.Map</code>-s as + <code class="inline-code">TemplateHashModelEx</code>-s, and do not expose + the methods of the object.</p> + </li> + + <li> + <p>New <code class="inline-code">Configuration</code> methods: + <code class="inline-code">set/getLocalizedLookup</code>, + <code class="inline-code">clearTemplateCache</code>, + <code class="inline-code">clearSharedVariables</code>.</p> + </li> + + <li> + <p>More cleanups in the <code class="inline-code">Environment</code> + API.</p> + </li> + + <li> + <p>Better JSP standard compliance: JSP page-scope variables + are the global variables that were created in the template + (not the variables of the data-model).</p> + </li> + + <li> + <p>JDOM independent XML-wrapping: + <code class="inline-code">freemarker.ext.xml.NodeListModel</code> is a + re-implementation of + <code class="inline-code">freemarker.ext.jdom.NodeListModel</code> that does + not rely on JDOM; you don't need JDOM .jar anymore. The new + <code class="inline-code">NodeListModel</code> automatically uses W3C DOM, + dom4j, or JDOM, depending on which library is available (that + is, depending on what object do you pass to its + constructor).</p> + </li> + + <li> + <p>Bugfix: <code class="inline-code">WebappTemplateLoader</code>: + Template updating didn't worked correctly with Tomcat due the + caching of resources. Now + <code class="inline-code">WebappTemplateLoader</code> tries to access the + resources directly as <code class="inline-code">File</code>, if it is + possible, thus bypasses the caching.</p> + </li> + + <li> + <p>Bugfix: Templates loaded with + <code class="inline-code">MultiTemplateLoader</code> subclasses was removed + from the template cache after the template update delay has + elapsed (5 seconds by default) even if the template file was + unchanged. This can cause lot of extra load for a high-traffic + server if you have many templates or if the template update + delay was set to 0 second.</p> + </li> + + <li> + <p>Bugfix: Undefined variables in hash and sequence + constructors (as <code class="inline-code">[a, b, c]</code>) didn't caused + errors.</p> + </li> + </ul> + + + + + + + +<h3 class="content-header header-section3" id="autoid_268">Differences between the Preview 1 and Preview 2 + releases</h3> + + + <ul> + <li> + <p>All 16-bit Unicode letters and numbers are allowed in + identifiers, as well as the <code class="inline-code">$</code> character (as + in Java programming language). Thus you can use accented + letters, Arabic letters, Chinese letters, etc. as identifiers + in templates</p> + </li> + + <li> + <p>Macros now can create loop variables for the nested + content. For more information <a href="dgui_misc_userdefdir.html#dgui_misc_userdefdir_loopvar">read + this</a>.</p> + </li> + + <li> + <p>New directives: <code class="inline-code">t</code>, + <code class="inline-code">rt</code> and <code class="inline-code">lt</code> directives + allow you to do explicit white-space removal in extreme FTL + applications. For more information read <a href="ref_directive_t.html#ref.directive.t">the reference</a>.</p> + </li> + + <li> + <p>The syntax of assignment-with-namespace has changed from + <code class="inline-code"><#assign foo=123 namespace=myLib></code>) to + <code class="inline-code"><#assign foo=123 in myLib></code>, since the + previous syntax was confusing because its similarity to a + bulk-assignment.</p> + </li> + + <li> + <p>Bulk assignments (as <code class="inline-code"><#assign x=1, y=2, + z=3></code>) no longer need colon to separate the + assignments (as <code class="inline-code"><#assign x=1 y=2 + z=3></code>), although it is still allowed to preserve + backward compatibility.</p> + </li> + + <li> + <p>Positional parameter passing is supported for macro + calls as shorthand form of normal named parameter passing. For + more details read <a href="ref_directive_userDefined.html#ref_directive_userDefined_positionalParam">read the + reference</a>.</p> + </li> + + <li> + <p>New built-in, <code class="inline-code">namespace</code>, to get the + namespace of the currently executing macro.</p> + </li> + + <li> + <p><code class="inline-code">TransformControl</code> interface (was + experimental earlier): If the <code class="inline-code">Writer</code> + returned by + <code class="inline-code">TemplateTransformModel.getWriter</code> implements + this interface, it can instruct the engine to skip or to + repeat evaluation of the nested content, and gets notified + about exceptions that are thrown during the nested content + evaluation. For more information please read the API + documentation.</p> + </li> + + <li> + <p>Jython wrapper can now wrap arbitrary Java objects, not + only <code class="inline-code">PyObject</code>-s. If an object is passed to + the wrapper that is neither a + <code class="inline-code">TemplateModel</code>, nor a + <code class="inline-code">PyObject</code>, it is first coerced into a + <code class="inline-code">PyObject</code> using Jython's own wrapping + machinery, and then wrapped into a + <code class="inline-code">TemplateModel</code> as any other + <code class="inline-code">PyObject</code>.</p> + </li> + + <li> + <p>Some cleanups in the <code class="inline-code">Environment</code> + API.</p> + </li> + + <li> + <p>The Web application related examples has been + replaced.</p> + </li> + + <li> + <p>Bugfix: Templates loaded with + <code class="inline-code">URLTemplateLoader</code> subclasses was removed + from the template cache after the template update delay has + elapsed (5 seconds by default) even if the template file was + unchanged. This can cause lot of extra load for a high-traffic + server if you have many templates or if the template update + delay was set to 0 second.</p> + </li> + + <li> + <p>Bugfix: <code class="inline-code">FreeMarkerServlet</code> has thrown + <code class="inline-code">ServletException</code> even if a debug + <code class="inline-code">TemplateException</code> handler was in use (so + you may got Error 500 page instead of debug + information).</p> + </li> + </ul> + + <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="versions_2_2_1.html"><span>Previous</span></a><a class="paging-arrow next" href="versions_2_1_5.html"><span>Next</span></a></div></div></div></div> </div> + </div> +<div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="http://freemarker.org/";>What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html";>Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.org/history.html";>About us</a></li><li><a itemprop="license" href="app_license.html">License</a></li></ul></div><div class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a href="http://freemarker-online.kenshoo.com/";>Try template online</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions cheatsheet</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a href="ref_specvar.html">.special_vars</a></li></ul></div><div class="column"><h3 class="column-header">Community</h3><ul><li><a href ="https://github.com/freemarker/freemarker";>FreeMarker on Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on Twitter</a></li><li><a href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker";>Ask a question</a></li><li><a href="http://freemarker.org/mailing-lists.html";>Mailing lists</a></li></ul></div></div><div class="col-right"><ul class="social-icons"><li><a class="github" href="https://github.com/freemarker/freemarker";>Github</a></li><li><a class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a class="stack-overflow" href="http://stackoverflow.com/questions/ask?tags=freemarker";>Stack Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind XML Editor</span></a></div></div><div class="footer-bottom"> <p class="last-generated"> +Last generated: +<time itemprop="dateModified" datetime="2017-03-13T10:55:28Z" title="Monday, March 13, 2017 10:55:28 AM GMT">2017-03-13 10:55:28 GMT</time>, for Freemarker 2.3.26 </p> +<p class="copyright"> +© <span itemprop="copyrightYear">1999</span>â2017 +<a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" href="http://apache.org/";>The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. </p> +</div></div></div></body> +</html>
http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/52c070a9/builds/2.3.26-nightly/versions_2_2_1.html ---------------------------------------------------------------------- diff --git a/builds/2.3.26-nightly/versions_2_2_1.html b/builds/2.3.26-nightly/versions_2_2_1.html new file mode 100644 index 0000000..02c3c3d --- /dev/null +++ b/builds/2.3.26-nightly/versions_2_2_1.html @@ -0,0 +1,126 @@ +<!doctype html> +<!-- Generated by FreeMarker/Docgen from DocBook --> +<html lang="en" class="page-type-section"> +<head prefix="og: http://ogp.me/ns#";> +<meta charset="utf-8"> +<title>2.2.1 - Apache FreeMarker Manual</title> +<meta http-equiv="X-UA-Compatible" content="IE=edge"> +<meta name="viewport" content="width=device-width,initial-scale=1"> +<meta name="format-detection" content="telephone=no"> +<meta property="og:site_name" content="Apache FreeMarker Manual"> +<meta property="og:title" content="2.2.1"> +<meta property="og:locale" content="en_US"> +<meta property="og:url" content="http://freemarker.org/docs/versions_2_2_1.html";> +<link rel="canonical" href="http://freemarker.org/docs/versions_2_2_1.html";> +<link rel="icon" href="favicon.png" type="image/png"> +<link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono"> +<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1489402528979"> +<script> +(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ +(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), +m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) +})(window,document,'script','//www.google-analytics.com/analytics.js','ga'); +ga('create', 'UA-55420501-1', 'auto'); +ga('send', 'pageview'); +</script> +</head> +<body itemscope itemtype="https://schema.org/Code";> + <meta itemprop="url" content="http://freemarker.org/docs/";> + <meta itemprop="name" content="Apache FreeMarker Manual"> + + <!--[if lte IE 9]> + <div style="background-color: #C00; color: #fff; padding: 12px 24px;">Please use a modern browser to view this website.</div> + <![endif]--><div class="header-top-bg"><div class="site-width header-top"><a class="logo" href="http://freemarker.org"; role="banner"> <img itemprop="image" src="logo.png" alt="FreeMarker"> +</a><ul class="tabs"><li><a href="http://freemarker.org/";>Home</a></li><li class="current"><a href="index.html">Manual</a></li><li><a class="external" href="api/index.html">Java API</a></li></ul><ul class="secondary-tabs"><li><a class="tab icon-heart" href="http://freemarker.org/contribute.html"; title="Contribute"><span>Contribute</span></a></li><li><a class="tab icon-bug" href="https://issues.apache.org/jira/browse/FREEMARKER/"; title="Report a Bug"><span>Report a Bug</span></a></li><li><a class="tab icon-download" href="http://freemarker.org/freemarkerdownload.html"; title="Download"><span>Download</span></a></li></ul></div></div><div class="header-bottom-bg"><div class="site-width search-row"><a href="index.html" class="navigation-header">Manual</a><div class="navigation-header"></div><form method="get" class="search-form" action="search-results.html"><fieldset><legend class="sr-only">Search form</legend><label for="search-field" class="sr-only">Search query</label><input id="searc h-field" name="q" type="search" class="search-input" placeholder="Search" spellcheck="false" autocorrect="off" autocomplete="off"><button type="submit" class="search-btn"><span class="sr-only">Search</span></button></fieldset></form></div><div class="site-width breadcrumb-row"><ul class="breadcrumb" itemscope itemtype="http://schema.org/BreadcrumbList";><li class="step-0" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="index.html"><span itemprop="name">Apache FreeMarker Manual</span></a></li><li class="step-1" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="app.html"><span itemprop="name">Appendixes</span></a></li><li class="step-2" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="app_versions.html"><span itemprop="name">Version history</span></a></li><li class="step-3" itemprop="itemListEl ement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="versions_2_2_1.html"><span itemprop="name">2.2.1</span></a></li></ul><div class="bookmarks" title="Bookmarks"><span class="sr-only">Bookmarks:</span><ul class="bookmark-list"><li><a href="alphaidx.html">Alpha. index</a></li><li><a href="gloss.html">Glossary</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions</a></li><li><a href="ref_builtins_alphaidx.html">?builtins</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_specvar.html">.spec_vars</a></li><li><a href="app_faq.html">FAQ</a></li></ul></div></div></div> <div class="main-content site-width"> + <div class="content-wrapper"> + <div id="table-of-contents-wrapper" class="col-left"> + <script>var breadcrumb = ["Apache FreeMarker Manual","Appendixes","Version history","2.2.1"];</script> + <script src="toc.js?1489402528979"></script> + <script src="docgen-resources/main.min.js?1489402528979"></script> + </div> +<div class="col-right"><div class="page-content"><div class="page-title"><div class="pagers top"><a class="paging-arrow previous" href="versions_2_2_2.html"><span>Previous</span></a><a class="paging-arrow next" href="versions_2_2.html"><span>Next</span></a></div><div class="title-wrapper"> +<h1 class="content-header header-section1" id="versions_2_2_1" itemprop="headline">2.2.1</h1> +</div></div><div class="page-menu"> +<div class="page-menu-title">Page Contents</div> +<ul><li><a class="page-menu-link" href="#autoid_258" data-menu-target="autoid_258">Changes on the FTL side</a></li><li><a class="page-menu-link" href="#autoid_259" data-menu-target="autoid_259">Changes on the Java side</a></li></ul> </div><p>Date of release: 2003-04-11</p><p>This version introduces important new features, such as the + native FTL date/time type, and the auto-include and auto-import + settings.</p><p>The date/time support is experimental, but we hope it will not + substantially change. We would like to label it as final ASAP, so we + urge everybody to send feedback on this topic to the mailing + lists.</p> + + + + +<h2 class="content-header header-section2" id="autoid_258">Changes on the FTL side</h2> + + + <ul> + <li> + <p>New scalar type: date. For more information read: <a href="dgui_datamodel_types.html#dgui_datamodel_scalar">Template Author's Guide/Values, Types/The types/Scalars</a>, <a href="dgui_datamodel_types.html#dgui_datamodel_scalar">Template Author's Guide/Values, Types/The types/Scalars</a>, <a href="dgui_template_valueinsertion.html#dgui_template_valueinserion_universal_date">interpolation</a>, + <a href="ref_builtins_date.html#ref_builtin_string_for_date">?string built-in for + dates</a></p> + </li> + </ul> + + + + + +<h2 class="content-header header-section2" id="autoid_259">Changes on the Java side</h2> + + + <ul> + <li> + <p>New <code class="inline-code">TemplateModel</code> subinterface: + <code class="inline-code">TemplateDateModel</code>. For more information read + <a href="pgui_datamodel_scalar.html">Programmer's Guide/The Data Model/Scalars</a></p> + </li> + + <li> + <p>auto-include and auto-import: With these new configuration + level settings, you can include and import commonly used + templates (usually collection of macro definitions) at the top + of all templates, without actually typing <code class="inline-code"><#include + <em class="code-color">...</em>></code> or + <code class="inline-code"><#import + <em class="code-color">...</em>></code> into the templates + again and again. For more information please read the Java API + documentation of <code class="inline-code">Configuration</code></p> + </li> + + <li> + <p>New template method: + <code class="inline-code">createProcessingEnvironment</code>. This method + makes it possible for you to do some special initialization on + the <a href="gloss.html#gloss.environment"><code>Environment</code></a> + before template processing, or to read the environment after + template processing. For more information please read the Java + API documentation.</p> + </li> + + <li> + <p>Changes to <code class="inline-code">freemarker.ext.beans</code> + package: <code class="inline-code">BeanModel</code>, + <code class="inline-code">MapModel</code>, and + <code class="inline-code">ResourceModel</code> now implement + <code class="inline-code">TemplateHashModelEx</code>.</p> + </li> + + <li> + <p>Bugfix: + <code class="inline-code">Configurable.setSettings(Properties)</code> didn't + removed redundant spaces/tabs at the end of property + values.</p> + </li> + </ul> + <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="versions_2_2_2.html"><span>Previous</span></a><a class="paging-arrow next" href="versions_2_2.html"><span>Next</span></a></div></div></div></div> </div> + </div> +<div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="http://freemarker.org/";>What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html";>Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.org/history.html";>About us</a></li><li><a itemprop="license" href="app_license.html">License</a></li></ul></div><div class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a href="http://freemarker-online.kenshoo.com/";>Try template online</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions cheatsheet</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a href="ref_specvar.html">.special_vars</a></li></ul></div><div class="column"><h3 class="column-header">Community</h3><ul><li><a href ="https://github.com/freemarker/freemarker";>FreeMarker on Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on Twitter</a></li><li><a href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker";>Ask a question</a></li><li><a href="http://freemarker.org/mailing-lists.html";>Mailing lists</a></li></ul></div></div><div class="col-right"><ul class="social-icons"><li><a class="github" href="https://github.com/freemarker/freemarker";>Github</a></li><li><a class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a class="stack-overflow" href="http://stackoverflow.com/questions/ask?tags=freemarker";>Stack Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind XML Editor</span></a></div></div><div class="footer-bottom"> <p class="last-generated"> +Last generated: +<time itemprop="dateModified" datetime="2017-03-13T10:55:28Z" title="Monday, March 13, 2017 10:55:28 AM GMT">2017-03-13 10:55:28 GMT</time>, for Freemarker 2.3.26 </p> +<p class="copyright"> +© <span itemprop="copyrightYear">1999</span>â2017 +<a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" href="http://apache.org/";>The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. </p> +</div></div></div></body> +</html> http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/52c070a9/builds/2.3.26-nightly/versions_2_2_2.html ---------------------------------------------------------------------- diff --git a/builds/2.3.26-nightly/versions_2_2_2.html b/builds/2.3.26-nightly/versions_2_2_2.html new file mode 100644 index 0000000..395c9e8 --- /dev/null +++ b/builds/2.3.26-nightly/versions_2_2_2.html @@ -0,0 +1,74 @@ +<!doctype html> +<!-- Generated by FreeMarker/Docgen from DocBook --> +<html lang="en" class="page-type-section"> +<head prefix="og: http://ogp.me/ns#";> +<meta charset="utf-8"> +<title>2.2.2 - Apache FreeMarker Manual</title> +<meta http-equiv="X-UA-Compatible" content="IE=edge"> +<meta name="viewport" content="width=device-width,initial-scale=1"> +<meta name="format-detection" content="telephone=no"> +<meta property="og:site_name" content="Apache FreeMarker Manual"> +<meta property="og:title" content="2.2.2"> +<meta property="og:locale" content="en_US"> +<meta property="og:url" content="http://freemarker.org/docs/versions_2_2_2.html";> +<link rel="canonical" href="http://freemarker.org/docs/versions_2_2_2.html";> +<link rel="icon" href="favicon.png" type="image/png"> +<link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono"> +<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1489402528979"> +<script> +(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ +(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), +m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) +})(window,document,'script','//www.google-analytics.com/analytics.js','ga'); +ga('create', 'UA-55420501-1', 'auto'); +ga('send', 'pageview'); +</script> +</head> +<body itemscope itemtype="https://schema.org/Code";> + <meta itemprop="url" content="http://freemarker.org/docs/";> + <meta itemprop="name" content="Apache FreeMarker Manual"> + + <!--[if lte IE 9]> + <div style="background-color: #C00; color: #fff; padding: 12px 24px;">Please use a modern browser to view this website.</div> + <![endif]--><div class="header-top-bg"><div class="site-width header-top"><a class="logo" href="http://freemarker.org"; role="banner"> <img itemprop="image" src="logo.png" alt="FreeMarker"> +</a><ul class="tabs"><li><a href="http://freemarker.org/";>Home</a></li><li class="current"><a href="index.html">Manual</a></li><li><a class="external" href="api/index.html">Java API</a></li></ul><ul class="secondary-tabs"><li><a class="tab icon-heart" href="http://freemarker.org/contribute.html"; title="Contribute"><span>Contribute</span></a></li><li><a class="tab icon-bug" href="https://issues.apache.org/jira/browse/FREEMARKER/"; title="Report a Bug"><span>Report a Bug</span></a></li><li><a class="tab icon-download" href="http://freemarker.org/freemarkerdownload.html"; title="Download"><span>Download</span></a></li></ul></div></div><div class="header-bottom-bg"><div class="site-width search-row"><a href="index.html" class="navigation-header">Manual</a><div class="navigation-header"></div><form method="get" class="search-form" action="search-results.html"><fieldset><legend class="sr-only">Search form</legend><label for="search-field" class="sr-only">Search query</label><input id="searc h-field" name="q" type="search" class="search-input" placeholder="Search" spellcheck="false" autocorrect="off" autocomplete="off"><button type="submit" class="search-btn"><span class="sr-only">Search</span></button></fieldset></form></div><div class="site-width breadcrumb-row"><ul class="breadcrumb" itemscope itemtype="http://schema.org/BreadcrumbList";><li class="step-0" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="index.html"><span itemprop="name">Apache FreeMarker Manual</span></a></li><li class="step-1" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="app.html"><span itemprop="name">Appendixes</span></a></li><li class="step-2" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="app_versions.html"><span itemprop="name">Version history</span></a></li><li class="step-3" itemprop="itemListEl ement" itemscope itemtype="http://schema.org/ListItem";><a class="label" itemprop="item" href="versions_2_2_2.html"><span itemprop="name">2.2.2</span></a></li></ul><div class="bookmarks" title="Bookmarks"><span class="sr-only">Bookmarks:</span><ul class="bookmark-list"><li><a href="alphaidx.html">Alpha. index</a></li><li><a href="gloss.html">Glossary</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions</a></li><li><a href="ref_builtins_alphaidx.html">?builtins</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_specvar.html">.spec_vars</a></li><li><a href="app_faq.html">FAQ</a></li></ul></div></div></div> <div class="main-content site-width"> + <div class="content-wrapper"> + <div id="table-of-contents-wrapper" class="col-left"> + <script>var breadcrumb = ["Apache FreeMarker Manual","Appendixes","Version history","2.2.2"];</script> + <script src="toc.js?1489402528979"></script> + <script src="docgen-resources/main.min.js?1489402528979"></script> + </div> +<div class="col-right"><div class="page-content"><div class="page-title"><div class="pagers top"><a class="paging-arrow previous" href="versions_2_2_3.html"><span>Previous</span></a><a class="paging-arrow next" href="versions_2_2_1.html"><span>Next</span></a></div><div class="title-wrapper"> +<h1 class="content-header header-section1" id="versions_2_2_2" itemprop="headline">2.2.2</h1> +</div></div><p>Date of release: 2003-05-02</p><p>Bugfix release.</p> + + + + +<h2 class="content-header header-section2" id="autoid_257">Changes on the Java side</h2> + + + <ul> + <li> + <p>Bugfix: The <code class="inline-code">_text</code> key of the + <code class="inline-code">freemarker.ext.xml.NodeListModel</code> was not + returning the text of the element when used with W3C DOM + trees.</p> + </li> + + <li> + <p>The classes are now built against JDK 1.2.2 classes, + ensuring the binary compatibility of FreeMarker distribution + with JDK 1.2.</p> + </li> + </ul> + <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="versions_2_2_3.html"><span>Previous</span></a><a class="paging-arrow next" href="versions_2_2_1.html"><span>Next</span></a></div></div></div></div> </div> + </div> +<div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="http://freemarker.org/";>What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html";>Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.org/history.html";>About us</a></li><li><a itemprop="license" href="app_license.html">License</a></li></ul></div><div class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a href="http://freemarker-online.kenshoo.com/";>Try template online</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions cheatsheet</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a href="ref_specvar.html">.special_vars</a></li></ul></div><div class="column"><h3 class="column-header">Community</h3><ul><li><a href ="https://github.com/freemarker/freemarker";>FreeMarker on Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on Twitter</a></li><li><a href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker";>Ask a question</a></li><li><a href="http://freemarker.org/mailing-lists.html";>Mailing lists</a></li></ul></div></div><div class="col-right"><ul class="social-icons"><li><a class="github" href="https://github.com/freemarker/freemarker";>Github</a></li><li><a class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a class="stack-overflow" href="http://stackoverflow.com/questions/ask?tags=freemarker";>Stack Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind XML Editor</span></a></div></div><div class="footer-bottom"> <p class="last-generated"> +Last generated: +<time itemprop="dateModified" datetime="2017-03-13T10:55:28Z" title="Monday, March 13, 2017 10:55:28 AM GMT">2017-03-13 10:55:28 GMT</time>, for Freemarker 2.3.26 </p> +<p class="copyright"> +© <span itemprop="copyrightYear">1999</span>â2017 +<a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" href="http://apache.org/";>The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. </p> +</div></div></div></body> +</html>
