Google Git
Sign in
apache / freemarker-docgen / 0465760014522eb4a12ba94f32f17fe4f3ce168a / . / legacy-tests / build / test / 1 / versions_2_3_11.html
blob: 854e0829d3437b874e8b298e31df8eb491b481a4 [file] [log] [blame]
<!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.3.11 - 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="FreeMarker Manual">
<meta property="og:title" content="2.3.11">
<meta property="og:locale" content="en_US">
<meta property="og:url" content="http://example.com/versions_2_3_11.html">
<link rel="canonical" href="http://example.com/versions_2_3_11.html">
<link rel="icon" href="favicon.png" type="image/png">
<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1594338519184">
</head>
<body itemscope itemtype="https://schema.org/Code">
<meta itemprop="url" content="http://example.com/">
<meta itemprop="name" content="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://example.com" role="banner"> <img itemprop="image" src="logo.png" alt="My Logo">
</a></div></div><div class="header-bottom-bg"><div class="site-width search-row"><a href="index.html" class="navigation-header">FreeMarker Manual</a><div class="navigation-header"></div></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">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">Versions</span></a></li><li class="step-3" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="versions_2_3_11.html"><span itemprop="name">2.3.11</span></a></li></ul><div class="bookmarks" title="Bookmarks"><span class="sr-only">Bookmarks:</span><ul class="bookmark-list"><li><a href="alphaidx.html">Index</a></li><li><a href="gloss.html">Glossary</a></li><li><a href="ref.html">Reference</a></li><li><a href="app_faq.html">FAQ</a></li><li><a href="preface.html#test_target">Bőregér</a></li><li><a href="api/index.html">API</a></li><li><a href="../index.html">Home</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 = ["FreeMarker Manual","Appendixes","Versions","2.3.11"];</script>
<script src="toc.js?1594338519184"></script>
<script src="docgen-resources/main.min.js?1594338519184"></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_3_12.html"><span>Previous</span></a><a class="paging-arrow next" href="versions_2_3_10.html"><span>Next</span></a></div><div class="title-wrapper">
<h1 class="content-header header-section1" id="versions_2_3_11" itemprop="headline">2.3.11</h1>
</div></div><div class="page-menu">
<div class="page-menu-title">Page Contents</div>
<ul><li><a class="page-menu-link" href="#autoid_141" data-menu-target="autoid_141">Changes on the FTL side</a></li><li><a class="page-menu-link" href="#autoid_142" data-menu-target="autoid_142">Changes on the Java side</a></li><li><a class="page-menu-link" href="#autoid_143" data-menu-target="autoid_143">Documentation changes</a></li></ul> </div><p>Date of release: 2007-12-04</p><p>This release contains several performance and usability
improvements.</p>
<h2 class="content-header header-section2" id="autoid_141">Changes on the FTL side</h2>
<ul>
<li>
<p>Bug fixed: <a href="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=1687248&amp;group_id=794&amp;atid=100794">[1687248]</a>
<strong>Warning! This bugfix may breaks some
templates!</strong> Fixed the bugs of the <a href="ref_builtins_number.html#ref_builtin_c"><code>c</code> built-in</a>
(<code class="inline-code">?c</code>) that sometimes caused whole numbers to
be formatted with ``.0&#39;&#39; at the end (like: 1.0), and caused
numbers sometimes formatted to exponential form (like 4E-20).
From now whole numbers will never use decimal dot (not even if
the wrapped number is a <code class="inline-code">double</code>; remember, the
template language knows only a single numerical type), and
exponential form will never be used either. Also, the maximum
number of digits after the decimal dot was limited to 16, so
numbers smaller than 1E-16 will be shown as 0.</p>
</li>
</ul>
<h2 class="content-header header-section2" id="autoid_142">Changes on the Java side</h2>
<ul>
<li>
<p>FreeMarker now has much better JSP 2.0 and JSP 2.1
compliance. Most notably, the JSP 2.0
<code class="inline-code">SimpleTag</code> interface is now supported.
Additionally, even when run in an environment that doesn&#39;t have
its own JSP implementation, the FreeMarker JSP runtime will make
available its own implementation of
<code class="inline-code">JspFactory</code> and
<code class="inline-code">JspEngineInfo</code> to tags when JSP 2.0 API JAR is
available in classpath, as well as an implementation of
<code class="inline-code">JspApplicationContext</code> when JSP 2.1 API JAR is
available in classpath.</p>
</li>
<li>
<p>A new model interface,
<code class="inline-code">TemplateDirectiveModel</code> provides an easier
paradigm for implementing user-defined directives than
<code class="inline-code">TemplateTransformModel</code> did previously.
<code class="inline-code">TemplateTransformModel</code> will be
deprecated.</p>
</li>
<li>
<p>FreeMarker now finds the Xalan-based XPath support
included in Sun JRE/JDK 5 and 6, so no separate Xalan jar is
required for the XPath support to work. (However, we recommend
Jaxen over Xalan, as the FreeMarker XPath support is more
complete with that. Of course for that the Jaxen jar is still
needed.)</p>
</li>
<li>
<p>Wrapping performance of <code class="inline-code">BeansWrapper</code>
has been significantly improved by eliminating repetitive
execution of various class tests.</p>
<p><strong>Note for
<code class="inline-code">BeansWrapper</code> customizers:</strong>
subclasses of <code class="inline-code">BeansWrapper</code> that previously
overrode <code class="inline-code">getInstance(Object, ModelFactory)</code>
method should now instead override
<code class="inline-code">getModelFactory(Class)</code> to take advantage of
this improvement. Overriding the old method still works, but it
will not take advantage of the performance improvement.</p>
</li>
<li>
<p>Memory footprint of a wrapper created by
<code class="inline-code">BeansWrapper</code> has been reduced (by a size of
one default-sized <code class="inline-code">HashMap</code>) until methods or
indexed properties are accessed on it (simple properties can be
accessed without increasing memory footprint).</p>
</li>
<li>
<p>Rhino objects can be used in templates as scalars,
numbers, and booleans, following the JavaScript conversion
semantics for these types.</p>
</li>
<li>
<p><code class="inline-code">.data_model</code> is now a
<code class="inline-code">TemplatHashModelEx</code> when possible. This means
that the list of the data-model variable names usually can be
get with <code class="inline-code">.data_model?keys</code>.</p>
</li>
<li>
<p><code class="inline-code">FileTemplateLoader</code> can now optionally
allow following symlinks that point out of the base directory.
It is disabled by default for backward compatibility.</p>
</li>
<li>
<p>Bug fixed: <a href="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=1670887&amp;group_id=794&amp;atid=100794">[1670887]</a>
<code class="inline-code">TaglibFactory</code> taglib matching did not follow
JSP 1.2 FCS.</p>
</li>
<li>
<p>Bug fixed: <a href="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=1754320&amp;group_id=794&amp;atid=100794">[1754320]</a>
Bug in <code class="inline-code">setXPathSupportClass</code> prevented
plugging in a user-supplied <code class="inline-code">XPathSupport</code>
implementation.</p>
</li>
<li>
<p>Bug fixed: <a href="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=1803298&amp;group_id=794&amp;atid=100794">[1803298]</a>
Parser error while parsing macro with loop variables</p>
</li>
<li>
<p>Bug fixed: <a href="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=1824122&amp;group_id=794&amp;atid=100794">[1824122]</a>
Loading templates from JAR files could lead to leaking of file
handles (due to a bug in the Java API implementation of
Sun).</p>
</li>
<li>
<p>Bug fixed: Cached template is now removed from the cache
if the re-loading of the modified template file fails, so no
staled template is served.</p>
</li>
</ul>
<h2 class="content-header header-section2" id="autoid_143">Documentation changes</h2>
<ul>
<li>
<p>Substantial reworkings in the Template Authors&#39;s Guide
(which was previously called Designer&#39;s Guide), especially in
the Getting Started section.</p>
</li>
<li>
<p><code class="inline-code">#{...}</code> is documented as deprected
construct from now.</p>
</li>
<li>
<p>The &quot;transform&quot; term is now removed from the
documentation. Instead the more general &quot;user-defined directive&quot;
term is used, which encompasses macros,
<code class="inline-code">TemplateTransformModel</code>-s and the new
<code class="inline-code">TemplateDirectiveModel</code>-s, which are just
different ways of implementing user-defined directives.</p>
</li>
<li>
<p>Some more minor improvements in the Manual.</p>
</li>
</ul>
<div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="versions_2_3_12.html"><span>Previous</span></a><a class="paging-arrow next" href="versions_2_3_10.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><div class="col-right"><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="2020-07-09T23:48:39Z" title="Thursday, July 9, 2020 11:48:39 PM GMT">2020-07-09 23:48:39 GMT</time> </p>
<p class="copyright">
© <span itemprop="copyrightYear">1999</span>–2020
<a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="https://apache.org/">The Apache Software Foundation</a> </p>
</div></div></div></body>
</html>