http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/index.html
----------------------------------------------------------------------
diff --git a/docs/index.html b/docs/index.html
index 187418d..de02c81 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -14,7 +14,7 @@
 <link rel="canonical" href="https://freemarker.apache.org/docs/index.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://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?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <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),
@@ -35,26 +35,21 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = [];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><span class="paging-arrow disabled 
previous"><span>Previous</span></span><a class="paging-arrow next" 
href="dgui.html"><span>Next</span></a></div><div class="title-wrapper">
-<h1 class="content-header header-book" id="autoid_1" 
itemprop="headline">Apache FreeMarker Manual <span class="subtitle 
productname">For Freemarker 2.3.27</span>
+<h1 class="content-header header-book" id="autoid_1" 
itemprop="headline">Apache FreeMarker Manual <span class="subtitle 
productname">For Freemarker 2.3.28</span>
 </h1>
 </div></div><div class="page-menu">
 <div class="page-menu-title">Table of Contents</div>
-<ul><li><a class="page-menu-link" href="dgui.html" 
data-menu-target="dgui">Template Author&#39;s Guide</a><ul><li><a 
class="page-menu-link" href="dgui_quickstart.html" 
data-menu-target="dgui_quickstart">Getting Started</a><ul><li><a 
class="page-menu-link" href="dgui_quickstart_basics.html" 
data-menu-target="dgui_quickstart_basics">Template + data-model = 
output</a></li><li><a class="page-menu-link" 
href="dgui_quickstart_datamodel.html" 
data-menu-target="dgui_quickstart_datamodel">The data-model at a 
glance</a></li><li><a class="page-menu-link" 
href="dgui_quickstart_template.html" 
data-menu-target="dgui_quickstart_template">The template at a 
glance</a></li></ul></li><li><a class="page-menu-link" 
href="dgui_datamodel.html" data-menu-target="dgui_datamodel">Values, 
Types</a><ul><li><a class="page-menu-link" href="dgui_datamodel_basics.html" 
data-menu-target="dgui_datamodel_basics">Basics</a></li><li><a 
class="page-menu-link" href="dgui_datamodel_types.html" 
data-menu-target="dgui_datam
 odel_types">The types</a></li></ul></li><li><a class="page-menu-link" 
href="dgui_template.html" data-menu-target="dgui_template">The 
Template</a><ul><li><a class="page-menu-link" 
href="dgui_template_overallstructure.html" 
data-menu-target="dgui_template_overallstructure">Overall 
structure</a></li><li><a class="page-menu-link" 
href="dgui_template_directives.html" 
data-menu-target="dgui_template_directives">Directives</a></li><li><a 
class="page-menu-link" href="dgui_template_exp.html" 
data-menu-target="dgui_template_exp">Expressions</a></li><li><a 
class="page-menu-link" href="dgui_template_valueinsertion.html" 
data-menu-target="dgui_template_valueinsertion">Interpolations</a></li></ul></li><li><a
 class="page-menu-link" href="dgui_misc.html" 
data-menu-target="dgui_misc">Miscellaneous</a><ul><li><a class="page-menu-link" 
href="dgui_misc_userdefdir.html" 
data-menu-target="dgui_misc_userdefdir">Defining your own 
directives</a></li><li><a class="page-menu-link" href="dgui_misc_var.html" da
 ta-menu-target="dgui_misc_var">Defining variables in the 
template</a></li><li><a class="page-menu-link" href="dgui_misc_namespace.html" 
data-menu-target="dgui_misc_namespace">Namespaces</a></li><li><a 
class="page-menu-link" href="dgui_misc_autoescaping.html" 
data-menu-target="dgui_misc_autoescaping">Auto-escaping and output 
formats</a></li><li><a class="page-menu-link" href="dgui_misc_whitespace.html" 
data-menu-target="dgui_misc_whitespace">White-space handling</a></li><li><a 
class="page-menu-link" href="dgui_misc_alternativesyntax.html" 
data-menu-target="dgui_misc_alternativesyntax">Alternative (square bracket) 
syntax</a></li></ul></li></ul></li><li><a class="page-menu-link" 
href="pgui.html" data-menu-target="pgui">Programmer&#39;s Guide</a><ul><li><a 
class="page-menu-link" href="pgui_quickstart.html" 
data-menu-target="pgui_quickstart">Getting Started</a><ul><li><a 
class="page-menu-link" href="pgui_quickstart_createconfiguration.html" 
data-menu-target="pgui_quickstart_createconfigu
 ration">Create a configuration instance</a></li><li><a class="page-menu-link" 
href="pgui_quickstart_createdatamodel.html" 
data-menu-target="pgui_quickstart_createdatamodel">Create a 
data-model</a></li><li><a class="page-menu-link" 
href="pgui_quickstart_gettemplate.html" 
data-menu-target="pgui_quickstart_gettemplate">Get the template</a></li><li><a 
class="page-menu-link" href="pgui_quickstart_merge.html" 
data-menu-target="pgui_quickstart_merge">Merging the template with the 
data-model</a></li><li><a class="page-menu-link" 
href="pgui_quickstart_all.html" data-menu-target="pgui_quickstart_all">Putting 
all together</a></li></ul></li><li><a class="page-menu-link" 
href="pgui_datamodel.html" data-menu-target="pgui_datamodel">The Data 
Model</a><ul><li><a class="page-menu-link" href="pgui_datamodel_basics.html" 
data-menu-target="pgui_datamodel_basics">Basics</a></li><li><a 
class="page-menu-link" href="pgui_datamodel_scalar.html" 
data-menu-target="pgui_datamodel_scalar">Scalars</a></li><li><a
  class="page-menu-link" href="pgui_datamodel_parent.html" 
data-menu-target="pgui_datamodel_parent">Containers</a></li><li><a 
class="page-menu-link" href="pgui_datamodel_method.html" 
data-menu-target="pgui_datamodel_method">Methods</a></li><li><a 
class="page-menu-link" href="pgui_datamodel_directive.html" 
data-menu-target="pgui_datamodel_directive">Directives</a></li><li><a 
class="page-menu-link" href="pgui_datamodel_node.html" 
data-menu-target="pgui_datamodel_node">Node variables</a></li><li><a 
class="page-menu-link" href="pgui_datamodel_objectWrapper.html" 
data-menu-target="pgui_datamodel_objectWrapper">Object 
wrappers</a></li></ul></li><li><a class="page-menu-link" 
href="pgui_config.html" data-menu-target="pgui_config">The 
Configuration</a><ul><li><a class="page-menu-link" 
href="pgui_config_basics.html" 
data-menu-target="pgui_config_basics">Basics</a></li><li><a 
class="page-menu-link" href="pgui_config_sharedvariables.html" 
data-menu-target="pgui_config_sharedvariables">Shared var
 iables</a></li><li><a class="page-menu-link" href="pgui_config_settings.html" 
data-menu-target="pgui_config_settings">Settings</a></li><li><a 
class="page-menu-link" href="pgui_config_templateloading.html" 
data-menu-target="pgui_config_templateloading">Template loading</a></li><li><a 
class="page-menu-link" href="pgui_config_errorhandling.html" 
data-menu-target="pgui_config_errorhandling">Error handling</a></li><li><a 
class="page-menu-link" href="pgui_config_templateconfigurations.html" 
data-menu-target="pgui_config_templateconfigurations">Template 
configurations</a></li><li><a class="page-menu-link" 
href="pgui_config_outputformatsautoesc.html" 
data-menu-target="pgui_config_outputformatsautoesc">Associating output formats 
with templates</a></li><li><a class="page-menu-link" 
href="pgui_config_custom_formats.html" 
data-menu-target="pgui_config_custom_formats">Custom number and date/time 
formats</a></li><li><a class="page-menu-link" 
href="pgui_config_incompatible_improvements.html" data-
 menu-target="pgui_config_incompatible_improvements">The &quot;incompatible 
improvements&quot; setting</a></li></ul></li><li><a class="page-menu-link" 
href="pgui_misc.html" data-menu-target="pgui_misc">Miscellaneous</a><ul><li><a 
class="page-menu-link" href="pgui_misc_var.html" 
data-menu-target="pgui_misc_var">Variables, scopes</a></li><li><a 
class="page-menu-link" href="pgui_misc_charset.html" 
data-menu-target="pgui_misc_charset">Charset issues</a></li><li><a 
class="page-menu-link" href="pgui_misc_multithreading.html" 
data-menu-target="pgui_misc_multithreading">Multithreading</a></li><li><a 
class="page-menu-link" href="pgui_misc_beanwrapper.html" 
data-menu-target="pgui_misc_beanwrapper">Bean wrapper</a></li><li><a 
class="page-menu-link" href="pgui_misc_logging.html" 
data-menu-target="pgui_misc_logging">Logging</a></li><li><a 
class="page-menu-link" href="pgui_misc_servlet.html" 
data-menu-target="pgui_misc_servlet">Using FreeMarker with 
servlets</a></li><li><a class="page-menu-link" h
 ref="pgui_misc_secureenv.html" 
data-menu-target="pgui_misc_secureenv">Configuring security policy for 
FreeMarker</a></li><li><a class="page-menu-link" 
href="pgui_misc_xml_legacy.html" data-menu-target="pgui_misc_xml_legacy">Legacy 
XML wrapper implementation</a></li><li><a class="page-menu-link" 
href="pgui_misc_ant.html" data-menu-target="pgui_misc_ant">Using FreeMarker 
with Ant</a></li><li><a class="page-menu-link" 
href="pgui_misc_jythonwrapper.html" 
data-menu-target="pgui_misc_jythonwrapper">Jython 
wrapper</a></li></ul></li></ul></li><li><a class="page-menu-link" 
href="ref.html" data-menu-target="ref">Template Language 
Reference</a><ul><li><a class="page-menu-link" href="ref_builtins.html" 
data-menu-target="ref_builtins">Built-in Reference</a><ul><li><a 
class="page-menu-link" href="ref_builtins_alphaidx.html" 
data-menu-target="ref_builtins_alphaidx">Alphabetical index</a></li><li><a 
class="page-menu-link" href="ref_builtins_string.html" 
data-menu-target="ref_builtins_string">Built-
 ins for strings</a></li><li><a class="page-menu-link" 
href="ref_builtins_number.html" 
data-menu-target="ref_builtins_number">Built-ins for numbers</a></li><li><a 
class="page-menu-link" href="ref_builtins_date.html" 
data-menu-target="ref_builtins_date">Built-ins for date/time/date-time 
values</a></li><li><a class="page-menu-link" href="ref_builtins_boolean.html" 
data-menu-target="ref_builtins_boolean">Built-ins for booleans</a></li><li><a 
class="page-menu-link" href="ref_builtins_sequence.html" 
data-menu-target="ref_builtins_sequence">Built-ins for sequences</a></li><li><a 
class="page-menu-link" href="ref_builtins_hash.html" 
data-menu-target="ref_builtins_hash">Built-ins for hashes</a></li><li><a 
class="page-menu-link" href="ref_builtins_node.html" 
data-menu-target="ref_builtins_node">Built-ins for nodes (for 
XML)</a></li><li><a class="page-menu-link" href="ref_builtins_loop_var.html" 
data-menu-target="ref_builtins_loop_var">Loop variable built-ins</a></li><li><a 
class="page-menu-lin
 k" href="ref_builtins_type_independent.html" 
data-menu-target="ref_builtins_type_independent">Type independent 
built-ins</a></li><li><a class="page-menu-link" href="ref_builtins_expert.html" 
data-menu-target="ref_builtins_expert">Seldom used and expert 
built-ins</a></li></ul></li><li><a class="page-menu-link" 
href="ref_directives.html" data-menu-target="ref_directives">Directive 
Reference</a><ul><li><a class="page-menu-link" 
href="ref_directive_alphaidx.html" 
data-menu-target="ref_directive_alphaidx">Alphabetical index</a></li><li><a 
class="page-menu-link" href="ref_directive_assign.html" 
data-menu-target="ref_directive_assign">assign</a></li><li><a 
class="page-menu-link" href="ref_directive_attempt.html" 
data-menu-target="ref_directive_attempt">attempt, recover</a></li><li><a 
class="page-menu-link" href="ref_directive_autoesc.html" 
data-menu-target="ref_directive_autoesc">autoesc</a></li><li><a 
class="page-menu-link" href="ref_directive_compress.html" 
data-menu-target="ref_directiv
 e_compress">compress</a></li><li><a class="page-menu-link" 
href="ref_directive_escape.html" 
data-menu-target="ref_directive_escape">escape, noescape 
(deprecated)</a></li><li><a class="page-menu-link" 
href="ref_directive_flush.html" 
data-menu-target="ref_directive_flush">flush</a></li><li><a 
class="page-menu-link" href="ref_directive_ftl.html" 
data-menu-target="ref_directive_ftl">ftl</a></li><li><a class="page-menu-link" 
href="ref_directive_function.html" 
data-menu-target="ref_directive_function">function, return</a></li><li><a 
class="page-menu-link" href="ref_directive_global.html" 
data-menu-target="ref_directive_global">global</a></li><li><a 
class="page-menu-link" href="ref_directive_if.html" 
data-menu-target="ref_directive_if">if, else, elseif</a></li><li><a 
class="page-menu-link" href="ref_directive_import.html" 
data-menu-target="ref_directive_import">import</a></li><li><a 
class="page-menu-link" href="ref_directive_include.html" 
data-menu-target="ref_directive_include">include</a
 ></li><li><a class="page-menu-link" href="ref_directive_list.html" 
 >data-menu-target="ref_directive_list">list, else, items, sep, break, 
 >continue</a></li><li><a class="page-menu-link" 
 >href="ref_directive_local.html" 
 >data-menu-target="ref_directive_local">local</a></li><li><a 
 >class="page-menu-link" href="ref_directive_macro.html" 
 >data-menu-target="ref_directive_macro">macro, nested, return</a></li><li><a 
 >class="page-menu-link" href="ref_directive_noautoesc.html" 
 >data-menu-target="ref_directive_noautoesc">noautoesc</a></li><li><a 
 >class="page-menu-link" href="ref_directive_noparse.html" 
 >data-menu-target="ref_directive_noparse">noparse</a></li><li><a 
 >class="page-menu-link" href="ref_directive_nt.html" 
 >data-menu-target="ref_directive_nt">nt</a></li><li><a class="page-menu-link" 
 >href="ref_directive_outputformat.html" 
 >data-menu-target="ref_directive_outputformat">outputformat</a></li><li><a 
 >class="page-menu-link" href="ref_directive_setting.html" 
 >data-menu-target="ref_directive_setting">set
 ting</a></li><li><a class="page-menu-link" href="ref_directive_stop.html" 
data-menu-target="ref_directive_stop">stop</a></li><li><a 
class="page-menu-link" href="ref_directive_switch.html" 
data-menu-target="ref_directive_switch">switch, case, default, 
break</a></li><li><a class="page-menu-link" href="ref_directive_t.html" 
data-menu-target="ref_directive_t">t, lt, rt</a></li><li><a 
class="page-menu-link" href="ref_directive_userDefined.html" 
data-menu-target="ref_directive_userDefined">User-defined directive 
(&lt;@...&gt;)</a></li><li><a class="page-menu-link" 
href="ref_directive_visit.html" data-menu-target="ref_directive_visit">visit, 
recurse, fallback</a></li></ul></li><li><a class="page-menu-link" 
href="ref_specvar.html" data-menu-target="ref_specvar">Special Variable 
Reference</a></li><li><a class="page-menu-link" href="ref_reservednames.html" 
data-menu-target="ref_reservednames">Reserved names in FTL</a></li><li><a 
class="page-menu-link" href="ref_deprecated.html" data-menu-targ
 et="ref_deprecated">Deprecated FTL constructs</a><ul><li><a 
class="page-menu-link" href="ref_depr_directive.html" 
data-menu-target="ref_depr_directive">List of deprecated 
directives</a></li><li><a class="page-menu-link" href="ref_depr_builtin.html" 
data-menu-target="ref_depr_builtin">List of deprecated built-ins</a></li><li><a 
class="page-menu-link" href="ref_depr_oldmacro.html" 
data-menu-target="ref_depr_oldmacro">Old-style macro and call 
directives</a></li><li><a class="page-menu-link" href="ref_depr_transform.html" 
data-menu-target="ref_depr_transform">Transform directive</a></li><li><a 
class="page-menu-link" href="ref_depr_oldsyntax.html" 
data-menu-target="ref_depr_oldsyntax">Old FTL syntax</a></li><li><a 
class="page-menu-link" href="ref_depr_numerical_interpolation.html" 
data-menu-target="ref_depr_numerical_interpolation">#{...}: Numerical 
interpolation</a></li></ul></li></ul></li><li><a class="page-menu-link" 
href="xgui.html" data-menu-target="xgui">XML Processing Guide</a><ul
 ><li><a class="page-menu-link" href="xgui_preface.html" 
 >data-menu-target="xgui_preface">Preface</a></li><li><a class="page-menu-link" 
 >href="xgui_expose.html" data-menu-target="xgui_expose">Exposing XML 
 >documents</a><ul><li><a class="page-menu-link" href="xgui_expose_dom.html" 
 >data-menu-target="xgui_expose_dom">The DOM tree</a></li><li><a 
 >class="page-menu-link" href="xgui_expose_put.html" 
 >data-menu-target="xgui_expose_put">Putting the XML into the 
 >data-model</a></li></ul></li><li><a class="page-menu-link" 
 >href="xgui_imperative.html" data-menu-target="xgui_imperative">Imperative XML 
 >processing</a><ul><li><a class="page-menu-link" 
 >href="xgui_imperative_learn.html" 
 >data-menu-target="xgui_imperative_learn">Basics</a></li><li><a 
 >class="page-menu-link" href="xgui_imperative_formal.html" 
 >data-menu-target="xgui_imperative_formal">Details</a></li></ul></li><li><a 
 >class="page-menu-link" href="xgui_declarative.html" 
 >data-menu-target="xgui_declarative">Declarative XML processing</a><ul><li><a 
 >cl
 ass="page-menu-link" href="xgui_declarative_basics.html" 
data-menu-target="xgui_declarative_basics">Basics</a></li><li><a 
class="page-menu-link" href="xgui_declarative_details.html" 
data-menu-target="xgui_declarative_details">Details</a></li></ul></li></ul></li><li><a
 class="page-menu-link" href="app.html" 
data-menu-target="app">Appendixes</a><ul><li><a class="page-menu-link" 
href="app_faq.html" data-menu-target="app_faq">FAQ</a></li><li><a 
class="page-menu-link" href="app_versions.html" 
data-menu-target="app_versions">Version history</a><ul><li><a 
class="page-menu-link" href="versions_2_3_27.html" 
data-menu-target="versions_2_3_27">2.3.27 (incubating at Apache)</a></li><li><a 
class="page-menu-link" href="versions_2_3_26.html" 
data-menu-target="versions_2_3_26">2.3.26 (incubating at Apache)</a></li><li><a 
class="page-menu-link" href="versions_2_3_25.html" 
data-menu-target="versions_2_3_25">2.3.25 (incubating at Apache)</a></li><li><a 
class="page-menu-link" href="versions_2_3_24.html
 " data-menu-target="versions_2_3_24">2.3.24 (incubating at 
Apache)</a></li><li><a class="page-menu-link" href="versions_2_3_23.html" 
data-menu-target="versions_2_3_23">2.3.23</a></li><li><a class="page-menu-link" 
href="versions_2_3_22.html" 
data-menu-target="versions_2_3_22">2.3.22</a></li><li><a class="page-menu-link" 
href="versions_2_3_21.html" 
data-menu-target="versions_2_3_21">2.3.21</a></li><li><a class="page-menu-link" 
href="versions_2_3_20.html" 
data-menu-target="versions_2_3_20">2.3.20</a></li><li><a class="page-menu-link" 
href="versions_2_3_19.html" 
data-menu-target="versions_2_3_19">2.3.19</a></li><li><a class="page-menu-link" 
href="versions_2_3_18.html" 
data-menu-target="versions_2_3_18">2.3.18</a></li><li><a class="page-menu-link" 
href="versions_2_3_17.html" 
data-menu-target="versions_2_3_17">2.3.17</a></li><li><a class="page-menu-link" 
href="versions_2_3_16.html" 
data-menu-target="versions_2_3_16">2.3.16</a></li><li><a class="page-menu-link" 
href="versions_2_3_15.html" 
 data-menu-target="versions_2_3_15">2.3.15</a></li><li><a 
class="page-menu-link" href="versions_2_3_14.html" 
data-menu-target="versions_2_3_14">2.3.14</a></li><li><a class="page-menu-link" 
href="versions_2_3_13.html" 
data-menu-target="versions_2_3_13">2.3.13</a></li><li><a class="page-menu-link" 
href="versions_2_3_12.html" 
data-menu-target="versions_2_3_12">2.3.12</a></li><li><a class="page-menu-link" 
href="versions_2_3_11.html" 
data-menu-target="versions_2_3_11">2.3.11</a></li><li><a class="page-menu-link" 
href="versions_2_3_10.html" 
data-menu-target="versions_2_3_10">2.3.10</a></li><li><a class="page-menu-link" 
href="versions_2_3_9.html" 
data-menu-target="versions_2_3_9">2.3.9</a></li><li><a class="page-menu-link" 
href="versions_2_3_8.html" 
data-menu-target="versions_2_3_8">2.3.8</a></li><li><a class="page-menu-link" 
href="versions_2_3_7.html" 
data-menu-target="versions_2_3_7">2.3.7</a></li><li><a class="page-menu-link" 
href="versions_2_3_7rc1.html" data-menu-target="versions_2_3_7
 rc1">2.3.7 RC1</a></li><li><a class="page-menu-link" 
href="versions_2_3_6.html" 
data-menu-target="versions_2_3_6">2.3.6</a></li><li><a class="page-menu-link" 
href="versions_2_3_5.html" 
data-menu-target="versions_2_3_5">2.3.5</a></li><li><a class="page-menu-link" 
href="versions_2_3_4.html" 
data-menu-target="versions_2_3_4">2.3.4</a></li><li><a class="page-menu-link" 
href="versions_2_3_3.html" 
data-menu-target="versions_2_3_3">2.3.3</a></li><li><a class="page-menu-link" 
href="versions_2_3_2.html" 
data-menu-target="versions_2_3_2">2.3.2</a></li><li><a class="page-menu-link" 
href="versions_2_3_1.html" 
data-menu-target="versions_2_3_1">2.3.1</a></li><li><a class="page-menu-link" 
href="versions_2_3.html" data-menu-target="versions_2_3">2.3</a></li><li><a 
class="page-menu-link" href="versions_2_2_8.html" 
data-menu-target="versions_2_2_8">2.2.8</a></li><li><a class="page-menu-link" 
href="versions_2_2_7.html" 
data-menu-target="versions_2_2_7">2.2.7</a></li><li><a class="page-menu-link" 
href=
 "versions_2_2_6.html" data-menu-target="versions_2_2_6">2.2.6</a></li><li><a 
class="page-menu-link" href="versions_2_2_5.html" 
data-menu-target="versions_2_2_5">2.2.5</a></li><li><a class="page-menu-link" 
href="versions_2_2_4.html" 
data-menu-target="versions_2_2_4">2.2.4</a></li><li><a class="page-menu-link" 
href="versions_2_2_3.html" 
data-menu-target="versions_2_2_3">2.2.3</a></li><li><a class="page-menu-link" 
href="versions_2_2_2.html" 
data-menu-target="versions_2_2_2">2.2.2</a></li><li><a class="page-menu-link" 
href="versions_2_2_1.html" 
data-menu-target="versions_2_2_1">2.2.1</a></li><li><a class="page-menu-link" 
href="versions_2_2.html" data-menu-target="versions_2_2">2.2</a></li><li><a 
class="page-menu-link" href="versions_2_1_5.html" 
data-menu-target="versions_2_1_5">2.1.5</a></li><li><a class="page-menu-link" 
href="versions_2_1_4.html" 
data-menu-target="versions_2_1_4">2.1.4</a></li><li><a class="page-menu-link" 
href="versions_2_1_3.html" data-menu-target="versions_2_1_3">2.
 1.3</a></li><li><a class="page-menu-link" href="versions_2_1_2.html" 
data-menu-target="versions_2_1_2">2.1.2</a></li><li><a class="page-menu-link" 
href="versions_2_1_1.html" 
data-menu-target="versions_2_1_1">2.1.1</a></li><li><a class="page-menu-link" 
href="versions_2_1.html" data-menu-target="versions_2_1">2.1</a></li><li><a 
class="page-menu-link" href="versions_2_01.html" 
data-menu-target="versions_2_01">2.01</a></li><li><a class="page-menu-link" 
href="versions_2_0.html" data-menu-target="versions_2_0">2.0</a></li><li><a 
class="page-menu-link" href="versions_2_0RC3.html" 
data-menu-target="versions_2_0RC3">2.0 RC3</a></li><li><a 
class="page-menu-link" href="versions_2_0RC2.html" 
data-menu-target="versions_2_0RC2">2.0 RC2</a></li><li><a 
class="page-menu-link" href="versions_2_0RC1.html" 
data-menu-target="versions_2_0RC1">2.0 RC1</a></li></ul></li><li><a 
class="page-menu-link" href="app_install.html" 
data-menu-target="app_install">Installing FreeMarker</a></li><li><a 
class="page-menu
 -link" href="app_legal.html" data-menu-target="app_legal">Legal</a><ul><li><a 
class="page-menu-link" href="app_license.html" 
data-menu-target="app_license">License</a></li><li><a class="page-menu-link" 
href="app_eccn.html" data-menu-target="app_eccn">Export 
Control</a></li></ul></li></ul></li><li><a class="page-menu-link" 
href="gloss.html" data-menu-target="gloss">Glossary</a></li><li><a 
class="page-menu-link" href="alphaidx.html" 
data-menu-target="alphaidx">Alphabetical Index</a></li></ul> </div><div 
class="bottom-pagers-wrapper"><div class="pagers bottom"><span 
class="paging-arrow disabled previous"><span>Previous</span></span><a 
class="paging-arrow next" 
href="dgui.html"><span>Next</span></a></div></div></div></div>      </div>
+<ul><li><a class="page-menu-link" href="dgui.html" 
data-menu-target="dgui">Template Author&#39;s Guide</a><ul><li><a 
class="page-menu-link" href="dgui_quickstart.html" 
data-menu-target="dgui_quickstart">Getting Started</a><ul><li><a 
class="page-menu-link" href="dgui_quickstart_basics.html" 
data-menu-target="dgui_quickstart_basics">Template + data-model = 
output</a></li><li><a class="page-menu-link" 
href="dgui_quickstart_datamodel.html" 
data-menu-target="dgui_quickstart_datamodel">The data-model at a 
glance</a></li><li><a class="page-menu-link" 
href="dgui_quickstart_template.html" 
data-menu-target="dgui_quickstart_template">The template at a 
glance</a></li></ul></li><li><a class="page-menu-link" 
href="dgui_datamodel.html" data-menu-target="dgui_datamodel">Values, 
Types</a><ul><li><a class="page-menu-link" href="dgui_datamodel_basics.html" 
data-menu-target="dgui_datamodel_basics">Basics</a></li><li><a 
class="page-menu-link" href="dgui_datamodel_types.html" 
data-menu-target="dgui_datam
 odel_types">The types</a></li></ul></li><li><a class="page-menu-link" 
href="dgui_template.html" data-menu-target="dgui_template">The 
Template</a><ul><li><a class="page-menu-link" 
href="dgui_template_overallstructure.html" 
data-menu-target="dgui_template_overallstructure">Overall 
structure</a></li><li><a class="page-menu-link" 
href="dgui_template_directives.html" 
data-menu-target="dgui_template_directives">Directives</a></li><li><a 
class="page-menu-link" href="dgui_template_exp.html" 
data-menu-target="dgui_template_exp">Expressions</a></li><li><a 
class="page-menu-link" href="dgui_template_valueinsertion.html" 
data-menu-target="dgui_template_valueinsertion">Interpolations</a></li></ul></li><li><a
 class="page-menu-link" href="dgui_misc.html" 
data-menu-target="dgui_misc">Miscellaneous</a><ul><li><a class="page-menu-link" 
href="dgui_misc_userdefdir.html" 
data-menu-target="dgui_misc_userdefdir">Defining your own 
directives</a></li><li><a class="page-menu-link" href="dgui_misc_var.html" da
 ta-menu-target="dgui_misc_var">Defining variables in the 
template</a></li><li><a class="page-menu-link" href="dgui_misc_namespace.html" 
data-menu-target="dgui_misc_namespace">Namespaces</a></li><li><a 
class="page-menu-link" href="dgui_misc_autoescaping.html" 
data-menu-target="dgui_misc_autoescaping">Auto-escaping and output 
formats</a></li><li><a class="page-menu-link" href="dgui_misc_whitespace.html" 
data-menu-target="dgui_misc_whitespace">White-space handling</a></li><li><a 
class="page-menu-link" href="dgui_misc_alternativesyntax.html" 
data-menu-target="dgui_misc_alternativesyntax">Alternative (square bracket) 
syntax</a></li></ul></li></ul></li><li><a class="page-menu-link" 
href="pgui.html" data-menu-target="pgui">Programmer&#39;s Guide</a><ul><li><a 
class="page-menu-link" href="pgui_quickstart.html" 
data-menu-target="pgui_quickstart">Getting Started</a><ul><li><a 
class="page-menu-link" href="pgui_quickstart_createconfiguration.html" 
data-menu-target="pgui_quickstart_createconfigu
 ration">Create a configuration instance</a></li><li><a class="page-menu-link" 
href="pgui_quickstart_createdatamodel.html" 
data-menu-target="pgui_quickstart_createdatamodel">Create a 
data-model</a></li><li><a class="page-menu-link" 
href="pgui_quickstart_gettemplate.html" 
data-menu-target="pgui_quickstart_gettemplate">Get the template</a></li><li><a 
class="page-menu-link" href="pgui_quickstart_merge.html" 
data-menu-target="pgui_quickstart_merge">Merging the template with the 
data-model</a></li><li><a class="page-menu-link" 
href="pgui_quickstart_all.html" data-menu-target="pgui_quickstart_all">Putting 
all together</a></li></ul></li><li><a class="page-menu-link" 
href="pgui_datamodel.html" data-menu-target="pgui_datamodel">The Data 
Model</a><ul><li><a class="page-menu-link" href="pgui_datamodel_basics.html" 
data-menu-target="pgui_datamodel_basics">Basics</a></li><li><a 
class="page-menu-link" href="pgui_datamodel_scalar.html" 
data-menu-target="pgui_datamodel_scalar">Scalars</a></li><li><a
  class="page-menu-link" href="pgui_datamodel_parent.html" 
data-menu-target="pgui_datamodel_parent">Containers</a></li><li><a 
class="page-menu-link" href="pgui_datamodel_method.html" 
data-menu-target="pgui_datamodel_method">Methods</a></li><li><a 
class="page-menu-link" href="pgui_datamodel_directive.html" 
data-menu-target="pgui_datamodel_directive">Directives</a></li><li><a 
class="page-menu-link" href="pgui_datamodel_node.html" 
data-menu-target="pgui_datamodel_node">Node variables</a></li><li><a 
class="page-menu-link" href="pgui_datamodel_objectWrapper.html" 
data-menu-target="pgui_datamodel_objectWrapper">Object 
wrappers</a></li></ul></li><li><a class="page-menu-link" 
href="pgui_config.html" data-menu-target="pgui_config">The 
Configuration</a><ul><li><a class="page-menu-link" 
href="pgui_config_basics.html" 
data-menu-target="pgui_config_basics">Basics</a></li><li><a 
class="page-menu-link" href="pgui_config_sharedvariables.html" 
data-menu-target="pgui_config_sharedvariables">Shared var
 iables</a></li><li><a class="page-menu-link" href="pgui_config_settings.html" 
data-menu-target="pgui_config_settings">Settings</a></li><li><a 
class="page-menu-link" href="pgui_config_templateloading.html" 
data-menu-target="pgui_config_templateloading">Template loading</a></li><li><a 
class="page-menu-link" href="pgui_config_errorhandling.html" 
data-menu-target="pgui_config_errorhandling">Error handling</a></li><li><a 
class="page-menu-link" href="pgui_config_templateconfigurations.html" 
data-menu-target="pgui_config_templateconfigurations">Template 
configurations</a></li><li><a class="page-menu-link" 
href="pgui_config_outputformatsautoesc.html" 
data-menu-target="pgui_config_outputformatsautoesc">Associating output formats 
with templates</a></li><li><a class="page-menu-link" 
href="pgui_config_custom_formats.html" 
data-menu-target="pgui_config_custom_formats">Custom number and date/time 
formats</a></li><li><a class="page-menu-link" 
href="pgui_config_incompatible_improvements.html" data-
 menu-target="pgui_config_incompatible_improvements">The &quot;incompatible 
improvements&quot; setting</a></li></ul></li><li><a class="page-menu-link" 
href="pgui_misc.html" data-menu-target="pgui_misc">Miscellaneous</a><ul><li><a 
class="page-menu-link" href="pgui_misc_var.html" 
data-menu-target="pgui_misc_var">Variables, scopes</a></li><li><a 
class="page-menu-link" href="pgui_misc_charset.html" 
data-menu-target="pgui_misc_charset">Charset issues</a></li><li><a 
class="page-menu-link" href="pgui_misc_multithreading.html" 
data-menu-target="pgui_misc_multithreading">Multithreading</a></li><li><a 
class="page-menu-link" href="pgui_misc_beanwrapper.html" 
data-menu-target="pgui_misc_beanwrapper">Bean wrapper</a></li><li><a 
class="page-menu-link" href="pgui_misc_logging.html" 
data-menu-target="pgui_misc_logging">Logging</a></li><li><a 
class="page-menu-link" href="pgui_misc_servlet.html" 
data-menu-target="pgui_misc_servlet">Using FreeMarker with 
servlets</a></li><li><a class="page-menu-link" h
 ref="pgui_misc_secureenv.html" 
data-menu-target="pgui_misc_secureenv">Configuring security policy for 
FreeMarker</a></li><li><a class="page-menu-link" 
href="pgui_misc_xml_legacy.html" data-menu-target="pgui_misc_xml_legacy">Legacy 
XML wrapper implementation</a></li><li><a class="page-menu-link" 
href="pgui_misc_ant.html" data-menu-target="pgui_misc_ant">Using FreeMarker 
with Ant</a></li><li><a class="page-menu-link" 
href="pgui_misc_jythonwrapper.html" 
data-menu-target="pgui_misc_jythonwrapper">Jython 
wrapper</a></li></ul></li></ul></li><li><a class="page-menu-link" 
href="ref.html" data-menu-target="ref">Template Language 
Reference</a><ul><li><a class="page-menu-link" href="ref_builtins.html" 
data-menu-target="ref_builtins">Built-in Reference</a><ul><li><a 
class="page-menu-link" href="ref_builtins_alphaidx.html" 
data-menu-target="ref_builtins_alphaidx">Alphabetical index</a></li><li><a 
class="page-menu-link" href="ref_builtins_string.html" 
data-menu-target="ref_builtins_string">Built-
 ins for strings</a></li><li><a class="page-menu-link" 
href="ref_builtins_number.html" 
data-menu-target="ref_builtins_number">Built-ins for numbers</a></li><li><a 
class="page-menu-link" href="ref_builtins_date.html" 
data-menu-target="ref_builtins_date">Built-ins for date/time/date-time 
values</a></li><li><a class="page-menu-link" href="ref_builtins_boolean.html" 
data-menu-target="ref_builtins_boolean">Built-ins for booleans</a></li><li><a 
class="page-menu-link" href="ref_builtins_sequence.html" 
data-menu-target="ref_builtins_sequence">Built-ins for sequences</a></li><li><a 
class="page-menu-link" href="ref_builtins_hash.html" 
data-menu-target="ref_builtins_hash">Built-ins for hashes</a></li><li><a 
class="page-menu-link" href="ref_builtins_node.html" 
data-menu-target="ref_builtins_node">Built-ins for nodes (for 
XML)</a></li><li><a class="page-menu-link" href="ref_builtins_loop_var.html" 
data-menu-target="ref_builtins_loop_var">Loop variable built-ins</a></li><li><a 
class="page-menu-lin
 k" href="ref_builtins_type_independent.html" 
data-menu-target="ref_builtins_type_independent">Type independent 
built-ins</a></li><li><a class="page-menu-link" href="ref_builtins_expert.html" 
data-menu-target="ref_builtins_expert">Seldom used and expert 
built-ins</a></li></ul></li><li><a class="page-menu-link" 
href="ref_directives.html" data-menu-target="ref_directives">Directive 
Reference</a><ul><li><a class="page-menu-link" 
href="ref_directive_alphaidx.html" 
data-menu-target="ref_directive_alphaidx">Alphabetical index</a></li><li><a 
class="page-menu-link" href="ref_directive_assign.html" 
data-menu-target="ref_directive_assign">assign</a></li><li><a 
class="page-menu-link" href="ref_directive_attempt.html" 
data-menu-target="ref_directive_attempt">attempt, recover</a></li><li><a 
class="page-menu-link" href="ref_directive_autoesc.html" 
data-menu-target="ref_directive_autoesc">autoesc</a></li><li><a 
class="page-menu-link" href="ref_directive_compress.html" 
data-menu-target="ref_directiv
 e_compress">compress</a></li><li><a class="page-menu-link" 
href="ref_directive_escape.html" 
data-menu-target="ref_directive_escape">escape, noescape 
(deprecated)</a></li><li><a class="page-menu-link" 
href="ref_directive_flush.html" 
data-menu-target="ref_directive_flush">flush</a></li><li><a 
class="page-menu-link" href="ref_directive_ftl.html" 
data-menu-target="ref_directive_ftl">ftl</a></li><li><a class="page-menu-link" 
href="ref_directive_function.html" 
data-menu-target="ref_directive_function">function, return</a></li><li><a 
class="page-menu-link" href="ref_directive_global.html" 
data-menu-target="ref_directive_global">global</a></li><li><a 
class="page-menu-link" href="ref_directive_if.html" 
data-menu-target="ref_directive_if">if, else, elseif</a></li><li><a 
class="page-menu-link" href="ref_directive_import.html" 
data-menu-target="ref_directive_import">import</a></li><li><a 
class="page-menu-link" href="ref_directive_include.html" 
data-menu-target="ref_directive_include">include</a
 ></li><li><a class="page-menu-link" href="ref_directive_list.html" 
 >data-menu-target="ref_directive_list">list, else, items, sep, break, 
 >continue</a></li><li><a class="page-menu-link" 
 >href="ref_directive_local.html" 
 >data-menu-target="ref_directive_local">local</a></li><li><a 
 >class="page-menu-link" href="ref_directive_macro.html" 
 >data-menu-target="ref_directive_macro">macro, nested, return</a></li><li><a 
 >class="page-menu-link" href="ref_directive_noautoesc.html" 
 >data-menu-target="ref_directive_noautoesc">noautoesc</a></li><li><a 
 >class="page-menu-link" href="ref_directive_noparse.html" 
 >data-menu-target="ref_directive_noparse">noparse</a></li><li><a 
 >class="page-menu-link" href="ref_directive_nt.html" 
 >data-menu-target="ref_directive_nt">nt</a></li><li><a class="page-menu-link" 
 >href="ref_directive_outputformat.html" 
 >data-menu-target="ref_directive_outputformat">outputformat</a></li><li><a 
 >class="page-menu-link" href="ref_directive_setting.html" 
 >data-menu-target="ref_directive_setting">set
 ting</a></li><li><a class="page-menu-link" href="ref_directive_stop.html" 
data-menu-target="ref_directive_stop">stop</a></li><li><a 
class="page-menu-link" href="ref_directive_switch.html" 
data-menu-target="ref_directive_switch">switch, case, default, 
break</a></li><li><a class="page-menu-link" href="ref_directive_t.html" 
data-menu-target="ref_directive_t">t, lt, rt</a></li><li><a 
class="page-menu-link" href="ref_directive_userDefined.html" 
data-menu-target="ref_directive_userDefined">User-defined directive 
(&lt;@...&gt;)</a></li><li><a class="page-menu-link" 
href="ref_directive_visit.html" data-menu-target="ref_directive_visit">visit, 
recurse, fallback</a></li></ul></li><li><a class="page-menu-link" 
href="ref_specvar.html" data-menu-target="ref_specvar">Special Variable 
Reference</a></li><li><a class="page-menu-link" href="ref_reservednames.html" 
data-menu-target="ref_reservednames">Reserved names in FTL</a></li><li><a 
class="page-menu-link" href="ref_deprecated.html" data-menu-targ
 et="ref_deprecated">Deprecated FTL constructs</a><ul><li><a 
class="page-menu-link" href="ref_depr_directive.html" 
data-menu-target="ref_depr_directive">List of deprecated 
directives</a></li><li><a class="page-menu-link" href="ref_depr_builtin.html" 
data-menu-target="ref_depr_builtin">List of deprecated built-ins</a></li><li><a 
class="page-menu-link" href="ref_depr_oldmacro.html" 
data-menu-target="ref_depr_oldmacro">Old-style macro and call 
directives</a></li><li><a class="page-menu-link" href="ref_depr_transform.html" 
data-menu-target="ref_depr_transform">Transform directive</a></li><li><a 
class="page-menu-link" href="ref_depr_oldsyntax.html" 
data-menu-target="ref_depr_oldsyntax">Old FTL syntax</a></li><li><a 
class="page-menu-link" href="ref_depr_numerical_interpolation.html" 
data-menu-target="ref_depr_numerical_interpolation">#{...}: Numerical 
interpolation</a></li></ul></li></ul></li><li><a class="page-menu-link" 
href="xgui.html" data-menu-target="xgui">XML Processing Guide</a><ul
 ><li><a class="page-menu-link" href="xgui_preface.html" 
 >data-menu-target="xgui_preface">Preface</a></li><li><a class="page-menu-link" 
 >href="xgui_expose.html" data-menu-target="xgui_expose">Exposing XML 
 >documents</a><ul><li><a class="page-menu-link" href="xgui_expose_dom.html" 
 >data-menu-target="xgui_expose_dom">The DOM tree</a></li><li><a 
 >class="page-menu-link" href="xgui_expose_put.html" 
 >data-menu-target="xgui_expose_put">Putting the XML into the 
 >data-model</a></li></ul></li><li><a class="page-menu-link" 
 >href="xgui_imperative.html" data-menu-target="xgui_imperative">Imperative XML 
 >processing</a><ul><li><a class="page-menu-link" 
 >href="xgui_imperative_learn.html" 
 >data-menu-target="xgui_imperative_learn">Basics</a></li><li><a 
 >class="page-menu-link" href="xgui_imperative_formal.html" 
 >data-menu-target="xgui_imperative_formal">Details</a></li></ul></li><li><a 
 >class="page-menu-link" href="xgui_declarative.html" 
 >data-menu-target="xgui_declarative">Declarative XML processing</a><ul><li><a 
 >cl
 ass="page-menu-link" href="xgui_declarative_basics.html" 
data-menu-target="xgui_declarative_basics">Basics</a></li><li><a 
class="page-menu-link" href="xgui_declarative_details.html" 
data-menu-target="xgui_declarative_details">Details</a></li></ul></li></ul></li><li><a
 class="page-menu-link" href="app.html" 
data-menu-target="app">Appendixes</a><ul><li><a class="page-menu-link" 
href="app_faq.html" data-menu-target="app_faq">FAQ</a></li><li><a 
class="page-menu-link" href="app_versions.html" 
data-menu-target="app_versions">Version history</a><ul><li><a 
class="page-menu-link" href="versions_2_3_28.html" 
data-menu-target="versions_2_3_28">2.3.28</a></li><li><a class="page-menu-link" 
href="versions_2_3_27.html" data-menu-target="versions_2_3_27">2.3.27 
(incubating at Apache)</a></li><li><a class="page-menu-link" 
href="versions_2_3_26.html" data-menu-target="versions_2_3_26">2.3.26 
(incubating at Apache)</a></li><li><a class="page-menu-link" 
href="versions_2_3_25.html" data-menu-target="ver
 sions_2_3_25">2.3.25 (incubating at Apache)</a></li><li><a 
class="page-menu-link" href="versions_2_3_24.html" 
data-menu-target="versions_2_3_24">2.3.24 (incubating at Apache)</a></li><li><a 
class="page-menu-link" href="versions_2_3_23.html" 
data-menu-target="versions_2_3_23">2.3.23</a></li><li><a class="page-menu-link" 
href="versions_2_3_22.html" 
data-menu-target="versions_2_3_22">2.3.22</a></li><li><a class="page-menu-link" 
href="versions_2_3_21.html" 
data-menu-target="versions_2_3_21">2.3.21</a></li><li><a class="page-menu-link" 
href="versions_2_3_20.html" 
data-menu-target="versions_2_3_20">2.3.20</a></li><li><a class="page-menu-link" 
href="versions_2_3_19.html" 
data-menu-target="versions_2_3_19">2.3.19</a></li><li><a class="page-menu-link" 
href="versions_2_3_18.html" 
data-menu-target="versions_2_3_18">2.3.18</a></li><li><a class="page-menu-link" 
href="versions_2_3_17.html" 
data-menu-target="versions_2_3_17">2.3.17</a></li><li><a class="page-menu-link" 
href="versions_2_3_16.html" 
 data-menu-target="versions_2_3_16">2.3.16</a></li><li><a 
class="page-menu-link" href="versions_2_3_15.html" 
data-menu-target="versions_2_3_15">2.3.15</a></li><li><a class="page-menu-link" 
href="versions_2_3_14.html" 
data-menu-target="versions_2_3_14">2.3.14</a></li><li><a class="page-menu-link" 
href="versions_2_3_13.html" 
data-menu-target="versions_2_3_13">2.3.13</a></li><li><a class="page-menu-link" 
href="versions_2_3_12.html" 
data-menu-target="versions_2_3_12">2.3.12</a></li><li><a class="page-menu-link" 
href="versions_2_3_11.html" 
data-menu-target="versions_2_3_11">2.3.11</a></li><li><a class="page-menu-link" 
href="versions_2_3_10.html" 
data-menu-target="versions_2_3_10">2.3.10</a></li><li><a class="page-menu-link" 
href="versions_2_3_9.html" 
data-menu-target="versions_2_3_9">2.3.9</a></li><li><a class="page-menu-link" 
href="versions_2_3_8.html" 
data-menu-target="versions_2_3_8">2.3.8</a></li><li><a class="page-menu-link" 
href="versions_2_3_7.html" data-menu-target="versions_2_3_7
 ">2.3.7</a></li><li><a class="page-menu-link" href="versions_2_3_7rc1.html" 
data-menu-target="versions_2_3_7rc1">2.3.7 RC1</a></li><li><a 
class="page-menu-link" href="versions_2_3_6.html" 
data-menu-target="versions_2_3_6">2.3.6</a></li><li><a class="page-menu-link" 
href="versions_2_3_5.html" 
data-menu-target="versions_2_3_5">2.3.5</a></li><li><a class="page-menu-link" 
href="versions_2_3_4.html" 
data-menu-target="versions_2_3_4">2.3.4</a></li><li><a class="page-menu-link" 
href="versions_2_3_3.html" 
data-menu-target="versions_2_3_3">2.3.3</a></li><li><a class="page-menu-link" 
href="versions_2_3_2.html" 
data-menu-target="versions_2_3_2">2.3.2</a></li><li><a class="page-menu-link" 
href="versions_2_3_1.html" 
data-menu-target="versions_2_3_1">2.3.1</a></li><li><a class="page-menu-link" 
href="versions_2_3.html" data-menu-target="versions_2_3">2.3</a></li><li><a 
class="page-menu-link" href="versions_2_2_8.html" 
data-menu-target="versions_2_2_8">2.2.8</a></li><li><a class="page-menu-link" hr
 ef="versions_2_2_7.html" 
data-menu-target="versions_2_2_7">2.2.7</a></li><li><a class="page-menu-link" 
href="versions_2_2_6.html" 
data-menu-target="versions_2_2_6">2.2.6</a></li><li><a class="page-menu-link" 
href="versions_2_2_5.html" 
data-menu-target="versions_2_2_5">2.2.5</a></li><li><a class="page-menu-link" 
href="versions_2_2_4.html" 
data-menu-target="versions_2_2_4">2.2.4</a></li><li><a class="page-menu-link" 
href="versions_2_2_3.html" 
data-menu-target="versions_2_2_3">2.2.3</a></li><li><a class="page-menu-link" 
href="versions_2_2_2.html" 
data-menu-target="versions_2_2_2">2.2.2</a></li><li><a class="page-menu-link" 
href="versions_2_2_1.html" 
data-menu-target="versions_2_2_1">2.2.1</a></li><li><a class="page-menu-link" 
href="versions_2_2.html" data-menu-target="versions_2_2">2.2</a></li><li><a 
class="page-menu-link" href="versions_2_1_5.html" 
data-menu-target="versions_2_1_5">2.1.5</a></li><li><a class="page-menu-link" 
href="versions_2_1_4.html" data-menu-target="versions_2_1_4"
 >2.1.4</a></li><li><a class="page-menu-link" href="versions_2_1_3.html" 
 >data-menu-target="versions_2_1_3">2.1.3</a></li><li><a class="page-menu-link" 
 >href="versions_2_1_2.html" 
 >data-menu-target="versions_2_1_2">2.1.2</a></li><li><a class="page-menu-link" 
 >href="versions_2_1_1.html" 
 >data-menu-target="versions_2_1_1">2.1.1</a></li><li><a class="page-menu-link" 
 >href="versions_2_1.html" data-menu-target="versions_2_1">2.1</a></li><li><a 
 >class="page-menu-link" href="versions_2_01.html" 
 >data-menu-target="versions_2_01">2.01</a></li><li><a class="page-menu-link" 
 >href="versions_2_0.html" data-menu-target="versions_2_0">2.0</a></li><li><a 
 >class="page-menu-link" href="versions_2_0RC3.html" 
 >data-menu-target="versions_2_0RC3">2.0 RC3</a></li><li><a 
 >class="page-menu-link" href="versions_2_0RC2.html" 
 >data-menu-target="versions_2_0RC2">2.0 RC2</a></li><li><a 
 >class="page-menu-link" href="versions_2_0RC1.html" 
 >data-menu-target="versions_2_0RC1">2.0 RC1</a></li></ul></li><li><a 
 >class="page-menu-link" 
 href="app_install.html" data-menu-target="app_install">Installing 
FreeMarker</a></li><li><a class="page-menu-link" href="app_legal.html" 
data-menu-target="app_legal">Legal</a><ul><li><a class="page-menu-link" 
href="app_license.html" data-menu-target="app_license">License</a></li><li><a 
class="page-menu-link" href="app_eccn.html" data-menu-target="app_eccn">Export 
Control</a></li></ul></li></ul></li><li><a class="page-menu-link" 
href="gloss.html" data-menu-target="gloss">Glossary</a></li><li><a 
class="page-menu-link" href="alphaidx.html" 
data-menu-target="alphaidx">Alphabetical Index</a></li></ul> </div><div 
class="bottom-pagers-wrapper"><div class="pagers bottom"><span 
class="paging-arrow disabled previous"><span>Previous</span></span><a 
class="paging-arrow next" 
href="dgui.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="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.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://try.freemarker.org/";>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><u
 l><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="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.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="https://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-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/pgui.html
----------------------------------------------------------------------
diff --git a/docs/pgui.html b/docs/pgui.html
index 558a321..98ccc9f 100644
--- a/docs/pgui.html
+++ b/docs/pgui.html
@@ -14,7 +14,7 @@
 <link rel="canonical" href="https://freemarker.apache.org/docs/pgui.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://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?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <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),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Programmer\'s 
Guide"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="dgui_misc_alternativesyntax.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="pgui_quickstart.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-part" id="pgui" 
itemprop="headline">Programmer&#39;s Guide</h1>
@@ -51,9 +46,9 @@ ga('send', 'pageview');
     </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="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.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://try.freemarker.org/";>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><u
 l><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="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.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="https://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-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/pgui_config.html
----------------------------------------------------------------------
diff --git a/docs/pgui_config.html b/docs/pgui_config.html
index 53c4450..4faa966 100644
--- a/docs/pgui_config.html
+++ b/docs/pgui_config.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/pgui_config.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://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?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <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),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Programmer\'s 
Guide","The Configuration"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="pgui_datamodel_objectWrapper.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="pgui_config_basics.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-chapter" id="pgui_config" 
itemprop="headline">The Configuration</h1>
@@ -52,9 +47,9 @@ ga('send', 'pageview');
     </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="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.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://try.freemarker.org/";>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><u
 l><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="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.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="https://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-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/pgui_config_basics.html
----------------------------------------------------------------------
diff --git a/docs/pgui_config_basics.html b/docs/pgui_config_basics.html
index 4d35229..65efee7 100644
--- a/docs/pgui_config_basics.html
+++ b/docs/pgui_config_basics.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/pgui_config_basics.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://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?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <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),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Programmer\'s 
Guide","The Configuration","Basics"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="pgui_config.html"><span>Previous</span></a><a class="paging-arrow next" 
href="pgui_config_sharedvariables.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="pgui_config_basics" 
itemprop="headline">Basics</h1>
@@ -72,9 +67,9 @@ ga('send', 'pageview');
     </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="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.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://try.freemarker.org/";>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><u
 l><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="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.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="https://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-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/pgui_config_custom_formats.html
----------------------------------------------------------------------
diff --git a/docs/pgui_config_custom_formats.html 
b/docs/pgui_config_custom_formats.html
index feadeb4..8dd786d 100644
--- a/docs/pgui_config_custom_formats.html
+++ b/docs/pgui_config_custom_formats.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/pgui_config_custom_formats.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://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?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <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),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Programmer\'s 
Guide","The Configuration","Custom number and date/time formats"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="pgui_config_outputformatsautoesc.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="pgui_config_incompatible_improvements.html"><span>Next</span></a></div><div
 class="title-wrapper">
 <h1 class="content-header header-section1" id="pgui_config_custom_formats" 
itemprop="headline">Custom number and date/time formats</h1>
@@ -55,6 +50,14 @@ ga('send', 'pageview');
 <h2 class="content-header header-section2" id="autoid_50">Overview</h2>
 
 
+            <div class="callout note">
+    <strong class="callout-label">Note:</strong>
+
+            <p>Custom formats (of the kind described here) exists since
+            FreeMarker 2.3.24.</p>
+            </div>
+
+
           <p>FreeMarker allows you to define your own number and
           date/time/datetime formats, and associate a name to them. This
           mechanism has several applications:</p>
@@ -697,9 +700,9 @@ cfg.setNumberFormat(&quot;@ua 0.####;; 
roundingMode=halfUp&quot;);</pre></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="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.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://try.freemarker.org/";>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><u
 l><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="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.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="https://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-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/pgui_config_errorhandling.html
----------------------------------------------------------------------
diff --git a/docs/pgui_config_errorhandling.html 
b/docs/pgui_config_errorhandling.html
index 1bd1b62..6069e80 100644
--- a/docs/pgui_config_errorhandling.html
+++ b/docs/pgui_config_errorhandling.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/pgui_config_errorhandling.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://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?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <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),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Programmer\'s 
Guide","The Configuration","Error handling"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="pgui_config_templateloading.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="pgui_config_templateconfigurations.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="pgui_config_errorhandling" 
itemprop="headline">Error handling</h1>
@@ -388,9 +383,9 @@ c</pre></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="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.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://try.freemarker.org/";>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><u
 l><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="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.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="https://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-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/pgui_config_incompatible_improvements.html
----------------------------------------------------------------------
diff --git a/docs/pgui_config_incompatible_improvements.html 
b/docs/pgui_config_incompatible_improvements.html
index 877fa75..2ceef7a 100644
--- a/docs/pgui_config_incompatible_improvements.html
+++ b/docs/pgui_config_incompatible_improvements.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/pgui_config_incompatible_improvements.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://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?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <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),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Programmer\'s 
Guide","The Configuration","The \"incompatible improvements\" 
setting"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="pgui_config_custom_formats.html"><span>Previous</span></a><a 
class="paging-arrow next" href="pgui_misc.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" 
id="pgui_config_incompatible_improvements" itemprop="headline">The 
&quot;incompatible improvements&quot; setting</h1>
@@ -61,16 +56,20 @@ ga('send', 'pageview');
           implemented. Usually, it&#39;s a bad idea to left it on its default,
           which is 2.3.0 (maximum backward compatibility).</p>
 
-          <p>In new projects you should set this to the FreeMarker version
-          that you are actually using. In older projects it&#39;s also usually
-          better to keep this high, however you better check the changes
-          activated (find them in <a 
href="https://freemarker.apache.org/docs/api/freemarker/template/Configuration.html#Configuration-freemarker.template.Version-";>the
+          <p>In new projects you should set this to the fixed FreeMarker
+          version (like <code 
class="inline-code">Configuration.VERSION_2_3_28</code>) that
+          you are actually using when starting the project. In older projects
+          it&#39;s also usually better to keep this high , however you should
+          check the changes activated (find them in <a 
href="https://freemarker.apache.org/docs/api/freemarker/template/Configuration.html#Configuration-freemarker.template.Version-";>the
           API JavaDoc of the <code>Configuration(Version)</code>
-          constructor</a>), at least if not only the 3rd version number
+          constructor</a>), especially if not only the 3rd version number
           (the micro version) of "incompatible improvements"
           setting is increased. Generally, as far as you only increase the
-          last version number of this setting, the changes are low
-          risk.</p>
+          last (3rd) version number of this setting, the changes are low risk,
+          and whether you can afford that risk depends on the concrete
+          application. Never use a dynamic value like
+          <code class="inline-code">Configuration.getVersion()</code> though, 
as that way
+          upgrading FreeMarker can break your application!</p>
 
           <p>Bug fixes and improvements that are fully backward compatible,
           also those that are important security fixes, are enabled regardless
@@ -103,7 +102,7 @@ ga('send', 'pageview');
 
               
 
-<div class="code-wrapper"><pre class="code-block code-unspecified">... = new 
Configuration(Configuration.VERSION_2_3_27)</pre></div>
+<div class="code-wrapper"><pre class="code-block code-unspecified">... = new 
Configuration(Configuration.VERSION_2_3_28)</pre></div>
             </li>
 
             <li>
@@ -112,7 +111,7 @@ ga('send', 'pageview');
 
               
 
-<div class="code-wrapper"><pre class="code-block 
code-unspecified">cfg.setIncompatibleImprovements(Configuration.VERSION_2_3_27)</pre></div>
+<div class="code-wrapper"><pre class="code-block 
code-unspecified">cfg.setIncompatibleImprovements(Configuration.VERSION_2_3_28)</pre></div>
             </li>
 
             <li>
@@ -122,7 +121,7 @@ ga('send', 'pageview');
 
               
 
-<div class="code-wrapper"><pre class="code-block 
code-unspecified">incompatible_improvements=2.3.27</pre></div>
+<div class="code-wrapper"><pre class="code-block 
code-unspecified">incompatible_improvements=2.3.28</pre></div>
             </li>
 
             <li>
@@ -135,7 +134,7 @@ ga('send', 'pageview');
 
 <div class="code-wrapper"><pre class="code-block 
code-unspecified">&lt;init-param&gt;
     &lt;param-name&gt;incompatible_improvements&lt;/param-name&gt;
-    &lt;param-value&gt;2.3.27&lt;/param-value&gt;
+    &lt;param-value&gt;2.3.28&lt;/param-value&gt;
 &lt;/init-param&gt;</pre></div>
             </li>
           </ul>
@@ -166,13 +165,27 @@ ga('send', 'pageview');
           <code class="inline-code">DefaultObjectWrapper</code> (for
           <code class="inline-code">BeansWrapper</code> it&#39;s the same, 
only with different
           class name of course).</p>
+
+            <div class="callout warning">
+    <strong class="callout-label">Warning!</strong>
+
+            <p>Do not ever use
+            <code class="inline-code">Configuration.getVersion()</code> to set 
the
+            "incompatible improvements" setting. Always use a
+            fixed value, like <code 
class="inline-code">Configuration.VERSION_2_3_28</code>.
+            Otherwise your application can break as you upgrade FreeMarker.
+            The whole point of "incompatible improvements" is to
+            protect you from that, while you still always get the
+            fixes/improvements that are backward compatible.</p>
+            </div>
+
         <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a 
class="paging-arrow previous" 
href="pgui_config_custom_formats.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="pgui_misc.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="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.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://try.freemarker.org/";>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><u
 l><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="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.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="https://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-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

Reply via email to