freemarker-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ddek...@apache.org
Subject [2/4] incubator-freemarker-site git commit: Updated 2.3.28 nightly JavaDocs
Date Tue, 20 Mar 2018 22:03:16 GMT
http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/1d301529/builds/fm2.3.28/api/freemarker/template/Configuration.html
----------------------------------------------------------------------
diff --git a/builds/fm2.3.28/api/freemarker/template/Configuration.html b/builds/fm2.3.28/api/freemarker/template/Configuration.html
index 19a23d2..37f8e7c 100644
--- a/builds/fm2.3.28/api/freemarker/template/Configuration.html
+++ b/builds/fm2.3.28/api/freemarker/template/Configuration.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Sat Mar 10 20:54:59 CET 2018 -->
+<!-- Generated by javadoc (1.8.0_144) on Sat Mar 10 20:54:57 CET 2018 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Configuration (FreeMarker 2.3.28-nightly_20180310T195428Z-incubating API)</title>
 <meta name="date" content="2018-03-10">
@@ -19,7 +19,7 @@
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":41,"i9":10,"i10":9,"i11":10,"i12":42,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":42,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":9,"i44":41,"i45":10,"i46":10,"i47":10,"i48":10,"i49":10,"i50":10,"i51":10,"i52":10,"i53":10,"i54":10,"i55":10,"i56":10,"i57":10,"i58":10,"i59":10,"i60":10,"i61":10,"i62":10,"i63":10,"i64":10,"i65":10,"i66":10,"i67":10,"i68":10,"i69":10,"i70":10,"i71":10,"i72":41,"i73":10,"i74":10,"i75":10,"i76":42,"i77":10,"i78":10,"i79":10,"i80":10,"i81":10,"i82":10,"i83":10,"i84":10,"i85":10,"i86":10,"i87":10,"i88":10,"i89":10,"i90":10,"i91":42,"i92":10,"i93":10,"i94":10,"i95":10,"i96":10,"i97":10,"i98":10,"i99":42,"i100":10,"i101":10,"i102":10,"i103":10,"i104":10,"i105":10,"i106":10,"i107":10,"i108":10,"i10
 9":10,"i110":10,"i111":10,"i112":10,"i113":10,"i114":10,"i115":10,"i116":10,"i117":10};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":41,"i9":10,"i10":9,"i11":10,"i12":42,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":42,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":9,"i45":41,"i46":10,"i47":10,"i48":10,"i49":10,"i50":10,"i51":10,"i52":10,"i53":10,"i54":10,"i55":10,"i56":10,"i57":10,"i58":10,"i59":10,"i60":10,"i61":10,"i62":10,"i63":10,"i64":10,"i65":10,"i66":10,"i67":10,"i68":10,"i69":10,"i70":10,"i71":10,"i72":10,"i73":10,"i74":41,"i75":10,"i76":10,"i77":10,"i78":42,"i79":10,"i80":10,"i81":10,"i82":10,"i83":10,"i84":10,"i85":10,"i86":10,"i87":10,"i88":10,"i89":10,"i90":10,"i91":10,"i92":10,"i93":10,"i94":42,"i95":10,"i96":10,"i97":10,"i98":10,"i99":10,"i100":10,"i101":10,"i102":42,"i103":10,"i104":10,"i105":10,"i106":10,"i107":10,"i108":10,"i10
 9":10,"i110":10,"i111":10,"i112":10,"i113":10,"i114":10,"i115":10,"i116":10,"i117":10,"i118":10,"i119":10,"i120":10};
 var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -334,18 +334,24 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </tr>
 <tr class="altColor">
 <td class="colFirst"><code>static int</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#DOLLAR_INTERPOLATION_SYNTAX">DOLLAR_INTERPOLATION_SYNTAX</a></span></code>
+<div class="block"><code>${expression}</code> only (not <code>#{expression; numFormat}</code>) @since 2.3.28</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>static int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#ENABLE_IF_DEFAULT_AUTO_ESCAPING_POLICY">ENABLE_IF_DEFAULT_AUTO_ESCAPING_POLICY</a></span></code>
 <div class="block">Enable auto-escaping if the output format supports it and <a href="../../freemarker/core/MarkupOutputFormat.html#isAutoEscapedByDefault--"><code>MarkupOutputFormat.isAutoEscapedByDefault()</code></a> is
  <code>true</code>.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#ENABLE_IF_SUPPORTED_AUTO_ESCAPING_POLICY">ENABLE_IF_SUPPORTED_AUTO_ESCAPING_POLICY</a></span></code>
 <div class="block">Enable auto-escaping if the <a href="../../freemarker/core/OutputFormat.html" title="class in freemarker.core"><code>OutputFormat</code></a> supports it.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#INCOMPATIBLE_ENHANCEMENTS">INCOMPATIBLE_ENHANCEMENTS</a></span></code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -353,7 +359,7 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#INCOMPATIBLE_IMPROVEMENTS">INCOMPATIBLE_IMPROVEMENTS</a></span></code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -361,83 +367,107 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#INCOMPATIBLE_IMPROVEMENTS_KEY">INCOMPATIBLE_IMPROVEMENTS_KEY</a></span></code>
 <div class="block">Alias to the <code>..._SNAKE_CASE</code> variation due to backward compatibility constraints.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#INCOMPATIBLE_IMPROVEMENTS_KEY_CAMEL_CASE">INCOMPATIBLE_IMPROVEMENTS_KEY_CAMEL_CASE</a></span></code>
 <div class="block">Modern, camel case (<code>likeThis</code>) variation of the setting name.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#INCOMPATIBLE_IMPROVEMENTS_KEY_SNAKE_CASE">INCOMPATIBLE_IMPROVEMENTS_KEY_SNAKE_CASE</a></span></code>
 <div class="block">Legacy, snake case (<code>like_this</code>) variation of the setting name.</div>
 </td>
 </tr>
+<tr class="altColor">
+<td class="colFirst"><code>static java.lang.String</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#INTERPOLATION_SYNTAX_KEY">INTERPOLATION_SYNTAX_KEY</a></span></code>
+<div class="block">Alias to the <code>..._SNAKE_CASE</code> variation due to backward compatibility constraints.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>static java.lang.String</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#INTERPOLATION_SYNTAX_KEY_CAMEL_CASE">INTERPOLATION_SYNTAX_KEY_CAMEL_CASE</a></span></code>
+<div class="block">Modern, camel case (<code>likeThis</code>) variation of the setting name.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>static java.lang.String</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#INTERPOLATION_SYNTAX_KEY_SNAKE_CASE">INTERPOLATION_SYNTAX_KEY_SNAKE_CASE</a></span></code>
+<div class="block">Legacy, snake case (<code>like_this</code>) variation of the setting name.</div>
+</td>
+</tr>
 <tr class="rowColor">
 <td class="colFirst"><code>static int</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#LEGACY_NAMING_CONVENTION">LEGACY_NAMING_CONVENTION</a></span></code>&nbsp;</td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#LEGACY_INTERPOLATION_SYNTAX">LEGACY_INTERPOLATION_SYNTAX</a></span></code>
+<div class="block"><code>${expression}</code> and the deprecated <code>#{expression; numFormat}</code> @since 2.3.28</div>
+</td>
 </tr>
 <tr class="altColor">
+<td class="colFirst"><code>static int</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#LEGACY_NAMING_CONVENTION">LEGACY_NAMING_CONVENTION</a></span></code>&nbsp;</td>
+</tr>
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#LOCALIZED_LOOKUP_KEY">LOCALIZED_LOOKUP_KEY</a></span></code>
 <div class="block">Alias to the <code>..._SNAKE_CASE</code> variation due to backward compatibility constraints.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#LOCALIZED_LOOKUP_KEY_CAMEL_CASE">LOCALIZED_LOOKUP_KEY_CAMEL_CASE</a></span></code>
 <div class="block">Modern, camel case (<code>likeThis</code>) variation of the setting name.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#LOCALIZED_LOOKUP_KEY_SNAKE_CASE">LOCALIZED_LOOKUP_KEY_SNAKE_CASE</a></span></code>
 <div class="block">Legacy, snake case (<code>like_this</code>) variation of the setting name.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#NAMING_CONVENTION_KEY">NAMING_CONVENTION_KEY</a></span></code>
 <div class="block">Alias to the <code>..._SNAKE_CASE</code> variation due to backward compatibility constraints.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#NAMING_CONVENTION_KEY_CAMEL_CASE">NAMING_CONVENTION_KEY_CAMEL_CASE</a></span></code>
 <div class="block">Modern, camel case (<code>likeThis</code>) variation of the setting name.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#NAMING_CONVENTION_KEY_SNAKE_CASE">NAMING_CONVENTION_KEY_SNAKE_CASE</a></span></code>
 <div class="block">Legacy, snake case (<code>like_this</code>) variation of the setting name.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#OUTPUT_FORMAT_KEY">OUTPUT_FORMAT_KEY</a></span></code>
 <div class="block">Alias to the <code>..._SNAKE_CASE</code> variation due to backward compatibility constraints.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#OUTPUT_FORMAT_KEY_CAMEL_CASE">OUTPUT_FORMAT_KEY_CAMEL_CASE</a></span></code>
 <div class="block">Modern, camel case (<code>likeThis</code>) variation of the setting name.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#OUTPUT_FORMAT_KEY_SNAKE_CASE">OUTPUT_FORMAT_KEY_SNAKE_CASE</a></span></code>
 <div class="block">Legacy, snake case (<code>like_this</code>) variation of the setting name.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#PARSED_DEFAULT_INCOMPATIBLE_ENHANCEMENTS">PARSED_DEFAULT_INCOMPATIBLE_ENHANCEMENTS</a></span></code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -445,42 +475,48 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#RECOGNIZE_STANDARD_FILE_EXTENSIONS_KEY">RECOGNIZE_STANDARD_FILE_EXTENSIONS_KEY</a></span></code>
 <div class="block">Alias to the <code>..._SNAKE_CASE</code> variation due to backward compatibility constraints.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#RECOGNIZE_STANDARD_FILE_EXTENSIONS_KEY_CAMEL_CASE">RECOGNIZE_STANDARD_FILE_EXTENSIONS_KEY_CAMEL_CASE</a></span></code>
 <div class="block">Modern, camel case (<code>likeThis</code>) variation of the setting name.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#RECOGNIZE_STANDARD_FILE_EXTENSIONS_KEY_SNAKE_CASE">RECOGNIZE_STANDARD_FILE_EXTENSIONS_KEY_SNAKE_CASE</a></span></code>
 <div class="block">Legacy, snake case (<code>like_this</code>) variation of the setting name.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#REGISTERED_CUSTOM_OUTPUT_FORMATS_KEY">REGISTERED_CUSTOM_OUTPUT_FORMATS_KEY</a></span></code>
 <div class="block">Alias to the <code>..._SNAKE_CASE</code> variation due to backward compatibility constraints.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#REGISTERED_CUSTOM_OUTPUT_FORMATS_KEY_CAMEL_CASE">REGISTERED_CUSTOM_OUTPUT_FORMATS_KEY_CAMEL_CASE</a></span></code>
 <div class="block">Modern, camel case (<code>likeThis</code>) variation of the setting name.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#REGISTERED_CUSTOM_OUTPUT_FORMATS_KEY_SNAKE_CASE">REGISTERED_CUSTOM_OUTPUT_FORMATS_KEY_SNAKE_CASE</a></span></code>
 <div class="block">Legacy, snake case (<code>like_this</code>) variation of the setting name.</div>
 </td>
 </tr>
+<tr class="rowColor">
+<td class="colFirst"><code>static int</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#SQUARE_BRACKET_INTERPOLATION_SYNTAX">SQUARE_BRACKET_INTERPOLATION_SYNTAX</a></span></code>
+<div class="block"><code>[=expression]</code> @since 2.3.28</div>
+</td>
+</tr>
 <tr class="altColor">
 <td class="colFirst"><code>static int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#SQUARE_BRACKET_TAG_SYNTAX">SQUARE_BRACKET_TAG_SYNTAX</a></span></code>&nbsp;</td>
@@ -860,30 +896,36 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </td>
 </tr>
 <tr id="i14" class="altColor">
+<td class="colFirst"><code>int</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getInterpolationSyntax--">getInterpolationSyntax</a></span>()</code>
+<div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setInterpolationSyntax-int-"><code>setInterpolationSyntax(int)</code></a>.</div>
+</td>
+</tr>
+<tr id="i15" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getLocalizedLookup--">getLocalizedLookup</a></span>()</code>
 <div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setLocalizedLookup-boolean-"><code>setLocalizedLookup(boolean)</code></a>.</div>
 </td>
 </tr>
-<tr id="i15" class="rowColor">
+<tr id="i16" class="altColor">
 <td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getNamingConvention--">getNamingConvention</a></span>()</code>
 <div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setNamingConvention-int-"><code>setNamingConvention(int)</code></a>.</div>
 </td>
 </tr>
-<tr id="i16" class="altColor">
+<tr id="i17" class="rowColor">
 <td class="colFirst"><code><a href="../../freemarker/core/OutputFormat.html" title="class in freemarker.core">OutputFormat</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getOutputFormat--">getOutputFormat</a></span>()</code>
 <div class="block">Getter pair of <a href="../../freemarker/template/Configuration.html#setOutputFormat-freemarker.core.OutputFormat-"><code>setOutputFormat(OutputFormat)</code></a></div>
 </td>
 </tr>
-<tr id="i17" class="rowColor">
+<tr id="i18" class="altColor">
 <td class="colFirst"><code><a href="../../freemarker/core/OutputFormat.html" title="class in freemarker.core">OutputFormat</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getOutputFormat-java.lang.String-">getOutputFormat</a></span>(java.lang.String&nbsp;name)</code>
 <div class="block">Returns the output format for a name.</div>
 </td>
 </tr>
-<tr id="i18" class="altColor">
+<tr id="i19" class="rowColor">
 <td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getParsedIncompatibleEnhancements--">getParsedIncompatibleEnhancements</a></span>()</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -891,93 +933,93 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </div>
 </td>
 </tr>
-<tr id="i19" class="rowColor">
+<tr id="i20" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getRecognizeStandardFileExtensions--">getRecognizeStandardFileExtensions</a></span>()</code>
 <div class="block">Getter pair of <a href="../../freemarker/template/Configuration.html#setRecognizeStandardFileExtensions-boolean-"><code>setRecognizeStandardFileExtensions(boolean)</code></a>.</div>
 </td>
 </tr>
-<tr id="i20" class="altColor">
+<tr id="i21" class="rowColor">
 <td class="colFirst"><code>java.util.Collection&lt;? extends <a href="../../freemarker/core/OutputFormat.html" title="class in freemarker.core">OutputFormat</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getRegisteredCustomOutputFormats--">getRegisteredCustomOutputFormats</a></span>()</code>
 <div class="block">Getter pair of <a href="../../freemarker/template/Configuration.html#setRegisteredCustomOutputFormats-java.util.Collection-"><code>setRegisteredCustomOutputFormats(Collection)</code></a>.</div>
 </td>
 </tr>
-<tr id="i21" class="rowColor">
+<tr id="i22" class="altColor">
 <td class="colFirst"><code>java.util.Set&lt;java.lang.String&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getSettingNames-boolean-">getSettingNames</a></span>(boolean&nbsp;camelCase)</code>
 <div class="block">Returns the valid <a href="../../freemarker/template/Configuration.html" title="class in freemarker.template"><code>Configuration</code></a> setting names.</div>
 </td>
 </tr>
-<tr id="i22" class="altColor">
+<tr id="i23" class="rowColor">
 <td class="colFirst"><code><a href="../../freemarker/template/TemplateModel.html" title="interface in freemarker.template">TemplateModel</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getSharedVariable-java.lang.String-">getSharedVariable</a></span>(java.lang.String&nbsp;name)</code>
 <div class="block">Gets a shared variable.</div>
 </td>
 </tr>
-<tr id="i23" class="rowColor">
+<tr id="i24" class="altColor">
 <td class="colFirst"><code>java.util.Set</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getSharedVariableNames--">getSharedVariableNames</a></span>()</code>
 <div class="block">Returns the set containing the names of all defined shared sharedVariables.</div>
 </td>
 </tr>
-<tr id="i24" class="altColor">
+<tr id="i25" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getStrictSyntaxMode--">getStrictSyntaxMode</a></span>()</code>
 <div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setStrictSyntaxMode-boolean-"><code>setStrictSyntaxMode(boolean)</code></a>.</div>
 </td>
 </tr>
-<tr id="i25" class="rowColor">
+<tr id="i26" class="altColor">
 <td class="colFirst"><code>java.util.Set</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getSupportedBuiltInDirectiveNames--">getSupportedBuiltInDirectiveNames</a></span>()</code>
 <div class="block">Same as <a href="../../freemarker/template/Configuration.html#getSupportedBuiltInDirectiveNames-int-"><code>getSupportedBuiltInDirectiveNames(int)</code></a> with argument <a href="../../freemarker/template/Configuration.html#getNamingConvention--"><code>getNamingConvention()</code></a>.</div>
 </td>
 </tr>
-<tr id="i26" class="altColor">
+<tr id="i27" class="rowColor">
 <td class="colFirst"><code>java.util.Set&lt;java.lang.String&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getSupportedBuiltInDirectiveNames-int-">getSupportedBuiltInDirectiveNames</a></span>(int&nbsp;namingConvention)</code>
 <div class="block">Returns the names of the directives that are predefined by FreeMarker.</div>
 </td>
 </tr>
-<tr id="i27" class="rowColor">
+<tr id="i28" class="altColor">
 <td class="colFirst"><code>java.util.Set</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getSupportedBuiltInNames--">getSupportedBuiltInNames</a></span>()</code>
 <div class="block">Same as <a href="../../freemarker/template/Configuration.html#getSupportedBuiltInNames-int-"><code>getSupportedBuiltInNames(int)</code></a> with argument <a href="../../freemarker/template/Configuration.html#getNamingConvention--"><code>getNamingConvention()</code></a>.</div>
 </td>
 </tr>
-<tr id="i28" class="altColor">
+<tr id="i29" class="rowColor">
 <td class="colFirst"><code>java.util.Set&lt;java.lang.String&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getSupportedBuiltInNames-int-">getSupportedBuiltInNames</a></span>(int&nbsp;namingConvention)</code>
 <div class="block">Returns the names of the supported "built-ins".</div>
 </td>
 </tr>
-<tr id="i29" class="rowColor">
+<tr id="i30" class="altColor">
 <td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTabSize--">getTabSize</a></span>()</code>
 <div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setTabSize-int-"><code>setTabSize(int)</code></a>.</div>
 </td>
 </tr>
-<tr id="i30" class="altColor">
+<tr id="i31" class="rowColor">
 <td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTagSyntax--">getTagSyntax</a></span>()</code>
 <div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setTagSyntax-int-"><code>setTagSyntax(int)</code></a>.</div>
 </td>
 </tr>
-<tr id="i31" class="rowColor">
+<tr id="i32" class="altColor">
 <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-">getTemplate</a></span>(java.lang.String&nbsp;name)</code>
 <div class="block">Retrieves the template with the given name from the template cache, loading it into the cache first if it's
  missing/staled.</div>
 </td>
 </tr>
-<tr id="i32" class="altColor">
+<tr id="i33" class="rowColor">
 <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.util.Locale-">getTemplate</a></span>(java.lang.String&nbsp;name,
            java.util.Locale&nbsp;locale)</code>
 <div class="block">Shorthand for <a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-boolean-"><code>getTemplate(name, locale, null, null, true, false)</code></a>.</div>
 </td>
 </tr>
-<tr id="i33" class="rowColor">
+<tr id="i34" class="altColor">
 <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-boolean-">getTemplate</a></span>(java.lang.String&nbsp;name,
            java.util.Locale&nbsp;locale,
@@ -989,7 +1031,7 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
  cache, loading it into the cache first if it's missing/staled.</div>
 </td>
 </tr>
-<tr id="i34" class="altColor">
+<tr id="i35" class="rowColor">
 <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.util.Locale-java.lang.String-">getTemplate</a></span>(java.lang.String&nbsp;name,
            java.util.Locale&nbsp;locale,
@@ -997,7 +1039,7 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 <div class="block">Shorthand for <a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-boolean-"><code>getTemplate(name, locale, null, encoding, true, false)</code></a>.</div>
 </td>
 </tr>
-<tr id="i35" class="rowColor">
+<tr id="i36" class="altColor">
 <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.util.Locale-java.lang.String-boolean-">getTemplate</a></span>(java.lang.String&nbsp;name,
            java.util.Locale&nbsp;locale,
@@ -1006,7 +1048,7 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 <div class="block">Shorthand for <a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-boolean-"><code>getTemplate(name, locale, null, encoding, parseAsFTL, false)</code></a>.</div>
 </td>
 </tr>
-<tr id="i36" class="altColor">
+<tr id="i37" class="rowColor">
 <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.util.Locale-java.lang.String-boolean-boolean-">getTemplate</a></span>(java.lang.String&nbsp;name,
            java.util.Locale&nbsp;locale,
@@ -1016,50 +1058,54 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 <div class="block">Shorthand for <a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-boolean-"><code>getTemplate(name, locale, null, encoding, parseAsFTL, ignoreMissing)</code></a>.</div>
 </td>
 </tr>
-<tr id="i37" class="rowColor">
+<tr id="i38" class="altColor">
 <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.lang.String-">getTemplate</a></span>(java.lang.String&nbsp;name,
            java.lang.String&nbsp;encoding)</code>
 <div class="block">Shorthand for <a href="../../freemarker/template/Configuration.html#getTemplate-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-boolean-"><code>getTemplate(name, null, null, encoding, true, false)</code></a>.</div>
 </td>
 </tr>
-<tr id="i38" class="altColor">
+<tr id="i39" class="rowColor">
 <td class="colFirst"><code><a href="../../freemarker/cache/TemplateConfigurationFactory.html" title="class in freemarker.cache">TemplateConfigurationFactory</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplateConfigurations--">getTemplateConfigurations</a></span>()</code>
 <div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setTemplateConfigurations-freemarker.cache.TemplateConfigurationFactory-"><code>setTemplateConfigurations(TemplateConfigurationFactory)</code></a>.</div>
 </td>
 </tr>
-<tr id="i39" class="rowColor">
+<tr id="i40" class="altColor">
 <td class="colFirst"><code><a href="../../freemarker/cache/TemplateLoader.html" title="interface in freemarker.cache">TemplateLoader</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplateLoader--">getTemplateLoader</a></span>()</code>
 <div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setTemplateLoader-freemarker.cache.TemplateLoader-"><code>setTemplateLoader(TemplateLoader)</code></a>.</div>
 </td>
 </tr>
-<tr id="i40" class="altColor">
+<tr id="i41" class="rowColor">
 <td class="colFirst"><code><a href="../../freemarker/cache/TemplateLookupStrategy.html" title="class in freemarker.cache">TemplateLookupStrategy</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplateLookupStrategy--">getTemplateLookupStrategy</a></span>()</code>
 <div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setTemplateLookupStrategy-freemarker.cache.TemplateLookupStrategy-"><code>setTemplateLookupStrategy(TemplateLookupStrategy)</code></a>.</div>
 </td>
 </tr>
-<tr id="i41" class="rowColor">
+<tr id="i42" class="altColor">
 <td class="colFirst"><code><a href="../../freemarker/cache/TemplateNameFormat.html" title="class in freemarker.cache">TemplateNameFormat</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplateNameFormat--">getTemplateNameFormat</a></span>()</code>
 <div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setTemplateNameFormat-freemarker.cache.TemplateNameFormat-"><code>setTemplateNameFormat(TemplateNameFormat)</code></a>.</div>
 </td>
 </tr>
-<tr id="i42" class="altColor">
+<tr id="i43" class="rowColor">
 <td class="colFirst"><code>long</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getTemplateUpdateDelayMilliseconds--">getTemplateUpdateDelayMilliseconds</a></span>()</code>
 <div class="block">The getter pair of <a href="../../freemarker/template/Configuration.html#setTemplateUpdateDelayMilliseconds-long-"><code>setTemplateUpdateDelayMilliseconds(long)</code></a>.</div>
 </td>
 </tr>
-<tr id="i43" class="rowColor">
+<tr id="i44" class="altColor">
 <td class="colFirst"><code>static <a href="../../freemarker/template/Version.html" title="class in freemarker.template">Version</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getVersion--">getVersion</a></span>()</code>
-<div class="block">Returns the FreeMarker version information, most importantly the major.minor.micro version numbers.</div>
+<div class="block">Returns FreeMarker version information, most importantly the major.minor.micro version numbers;
+ do NOT use this as the value of the <code>incompatible_improvements</code> setting (as the parameter to
+ <a href="../../freemarker/template/Configuration.html#Configuration-freemarker.template.Version-"><code>Configuration(Version)</code></a>), as then your application can break when you upgrade FreeMarker!
+ Use a constant value, like <a href="../../freemarker/template/Configuration.html#VERSION_2_3_28"><code>VERSION_2_3_28</code></a>, to protect your application from fixes/changes that aren't
+ entirely backward compatible.</div>
 </td>
 </tr>
-<tr id="i44" class="altColor">
+<tr id="i45" class="rowColor">
 <td class="colFirst"><code>static java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getVersionNumber--">getVersionNumber</a></span>()</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -1067,178 +1113,188 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </div>
 </td>
 </tr>
-<tr id="i45" class="rowColor">
+<tr id="i46" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#getWhitespaceStripping--">getWhitespaceStripping</a></span>()</code>
 <div class="block">Gets whether the FTL parser will try to remove
  superfluous white-space around certain FTL tags.</div>
 </td>
 </tr>
-<tr id="i46" class="altColor">
+<tr id="i47" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isAttemptExceptionReporterExplicitlySet--">isAttemptExceptionReporterExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setAttemptExceptionReporter-freemarker.template.AttemptExceptionReporter-"><code>setAttemptExceptionReporter(AttemptExceptionReporter)</code></a> (or equivalent) was already called on
  this instance.</div>
 </td>
 </tr>
-<tr id="i47" class="rowColor">
+<tr id="i48" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isCacheStorageExplicitlySet--">isCacheStorageExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setCacheStorage-freemarker.cache.CacheStorage-"><code>setCacheStorage(CacheStorage)</code></a> (or equivalent) was already called on this instance.</div>
 </td>
 </tr>
-<tr id="i48" class="altColor">
+<tr id="i49" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isDefaultEncodingExplicitlySet--">isDefaultEncodingExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setDefaultEncoding-java.lang.String-"><code>setDefaultEncoding(String)</code></a> (or equivalent) was already called on this instance, or it just holds the
  default value.</div>
 </td>
 </tr>
-<tr id="i49" class="rowColor">
+<tr id="i50" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isLocaleExplicitlySet--">isLocaleExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setLocale-java.util.Locale-"><code>setLocale(Locale)</code></a> (or equivalent) was already called on this instance, or it just holds the
  default value.</div>
 </td>
 </tr>
-<tr id="i50" class="altColor">
+<tr id="i51" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isLogTemplateExceptionsExplicitlySet--">isLogTemplateExceptionsExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setLogTemplateExceptions-boolean-"><code>setLogTemplateExceptions(boolean)</code></a> (or equivalent) was already called on this instance.</div>
 </td>
 </tr>
-<tr id="i51" class="rowColor">
+<tr id="i52" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isObjectWrapperExplicitlySet--">isObjectWrapperExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setObjectWrapper-freemarker.template.ObjectWrapper-"><code>setObjectWrapper(ObjectWrapper)</code></a> (or equivalent) was already called on this instance.</div>
 </td>
 </tr>
-<tr id="i52" class="altColor">
+<tr id="i53" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isOutputFormatExplicitlySet--">isOutputFormatExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setOutputFormat-freemarker.core.OutputFormat-"><code>setOutputFormat(OutputFormat)</code></a> (or equivalent) was already called on this instance.</div>
 </td>
 </tr>
-<tr id="i53" class="rowColor">
+<tr id="i54" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isRecognizeStandardFileExtensionsExplicitlySet--">isRecognizeStandardFileExtensionsExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setRecognizeStandardFileExtensions-boolean-"><code>setRecognizeStandardFileExtensions(boolean)</code></a> (or equivalent) was already called on this
  instance.</div>
 </td>
 </tr>
-<tr id="i54" class="altColor">
+<tr id="i55" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isTemplateExceptionHandlerExplicitlySet--">isTemplateExceptionHandlerExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setTemplateExceptionHandler-freemarker.template.TemplateExceptionHandler-"><code>setTemplateExceptionHandler(TemplateExceptionHandler)</code></a> (or equivalent) was already called on
  this instance.</div>
 </td>
 </tr>
-<tr id="i55" class="rowColor">
+<tr id="i56" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isTemplateLoaderExplicitlySet--">isTemplateLoaderExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setTemplateLoader-freemarker.cache.TemplateLoader-"><code>setTemplateLoader(TemplateLoader)</code></a> (or equivalent) was already called on this instance.</div>
 </td>
 </tr>
-<tr id="i56" class="altColor">
+<tr id="i57" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isTemplateLookupStrategyExplicitlySet--">isTemplateLookupStrategyExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setTemplateLookupStrategy-freemarker.cache.TemplateLookupStrategy-"><code>setTemplateLookupStrategy(TemplateLookupStrategy)</code></a> (or equivalent) was already called on this
  instance.</div>
 </td>
 </tr>
-<tr id="i57" class="rowColor">
+<tr id="i58" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isTemplateNameFormatExplicitlySet--">isTemplateNameFormatExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setTemplateNameFormat-freemarker.cache.TemplateNameFormat-"><code>setTemplateNameFormat(TemplateNameFormat)</code></a> (or equivalent) was already called on this instance.</div>
 </td>
 </tr>
-<tr id="i58" class="altColor">
+<tr id="i59" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isTimeZoneExplicitlySet--">isTimeZoneExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setTimeZone-java.util.TimeZone-"><code>setTimeZone(TimeZone)</code></a> (or equivalent) was already called on this instance, or it just holds the
  default value.</div>
 </td>
 </tr>
-<tr id="i59" class="rowColor">
+<tr id="i60" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#isWrapUncheckedExceptionsExplicitlySet--">isWrapUncheckedExceptionsExplicitlySet</a></span>()</code>
 <div class="block">Tells if <a href="../../freemarker/template/Configuration.html#setWrapUncheckedExceptions-boolean-"><code>setWrapUncheckedExceptions(boolean)</code></a> (or equivalent) was already called on this instance.</div>
 </td>
 </tr>
-<tr id="i60" class="altColor">
+<tr id="i61" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#loadBuiltInEncodingMap--">loadBuiltInEncodingMap</a></span>()</code>
 <div class="block">Loads a preset language-to-encoding map, similarly as if you have called
  <a href="../../freemarker/template/Configuration.html#clearEncodingMap--"><code>clearEncodingMap()</code></a> and then did multiple <a href="../../freemarker/template/Configuration.html#setEncoding-java.util.Locale-java.lang.String-"><code>setEncoding(Locale, String)</code></a> calls.</div>
 </td>
 </tr>
-<tr id="i61" class="rowColor">
+<tr id="i62" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-">removeTemplateFromCache</a></span>(java.lang.String&nbsp;name)</code>
-<div class="block">Equivalent to <tt>removeTemplateFromCache(name, thisCfg.getLocale(), thisCfg.getEncoding(thisCfg.getLocale()), true)</tt>.</div>
+<div class="block">Equivalent to <a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-"><code>removeTemplateFromCache(name, thisCfg.getLocale(), null, thisCfg.getEncoding(thisCfg.getLocale()), true)</code></a>.</div>
 </td>
 </tr>
-<tr id="i62" class="altColor">
+<tr id="i63" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-java.util.Locale-">removeTemplateFromCache</a></span>(java.lang.String&nbsp;name,
                        java.util.Locale&nbsp;locale)</code>
-<div class="block">Equivalent to <tt>removeTemplateFromCache(name, locale, thisCfg.getEncoding(locale), true)</tt>.</div>
+<div class="block">Equivalent to <a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-"><code>removeTemplateFromCache(name, locale, null, thisCfg.getEncoding(locale), true)</code></a>.</div>
 </td>
 </tr>
-<tr id="i63" class="rowColor">
+<tr id="i64" class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-">removeTemplateFromCache</a></span>(java.lang.String&nbsp;name,
+                       java.util.Locale&nbsp;locale,
+                       java.lang.Object&nbsp;customLookupCondition,
+                       java.lang.String&nbsp;encoding,
+                       boolean&nbsp;parse)</code>
+<div class="block">Removes a template from the template cache, hence forcing the re-loading
+ of it when it's next time requested.</div>
+</td>
+</tr>
+<tr id="i65" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-java.util.Locale-java.lang.String-">removeTemplateFromCache</a></span>(java.lang.String&nbsp;name,
                        java.util.Locale&nbsp;locale,
                        java.lang.String&nbsp;encoding)</code>
-<div class="block">Equivalent to <tt>removeTemplateFromCache(name, locale, encoding, true)</tt>.</div>
+<div class="block">Equivalent to <a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-"><code>removeTemplateFromCache(name, locale, null, encoding, true)</code></a>.</div>
 </td>
 </tr>
-<tr id="i64" class="altColor">
+<tr id="i66" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-java.util.Locale-java.lang.String-boolean-">removeTemplateFromCache</a></span>(java.lang.String&nbsp;name,
                        java.util.Locale&nbsp;locale,
                        java.lang.String&nbsp;encoding,
                        boolean&nbsp;parse)</code>
-<div class="block">Removes a template from the template cache, hence forcing the re-loading
- of it when it's next time requested.</div>
+<div class="block">Equivalent to <a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-"><code>removeTemplateFromCache(name, locale, null, encoding, parse)</code></a>.</div>
 </td>
 </tr>
-<tr id="i65" class="rowColor">
+<tr id="i67" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-java.lang.String-">removeTemplateFromCache</a></span>(java.lang.String&nbsp;name,
                        java.lang.String&nbsp;encoding)</code>
-<div class="block">Equivalent to <tt>removeTemplateFromCache(name, thisCfg.getLocale(), encoding, true)</tt>.</div>
+<div class="block">Equivalent to <a href="../../freemarker/template/Configuration.html#removeTemplateFromCache-java.lang.String-java.util.Locale-java.lang.Object-java.lang.String-boolean-"><code>removeTemplateFromCache(name, thisCfg.getLocale(), null, encoding, true)</code></a>.</div>
 </td>
 </tr>
-<tr id="i66" class="altColor">
+<tr id="i68" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setAllSharedVariables-freemarker.template.TemplateHashModelEx-">setAllSharedVariables</a></span>(<a href="../../freemarker/template/TemplateHashModelEx.html" title="interface in freemarker.template">TemplateHashModelEx</a>&nbsp;hash)</code>
 <div class="block">Adds all object in the hash as shared variable to the configuration; it's like doing several
  <a href="../../freemarker/template/Configuration.html#setSharedVariable-java.lang.String-java.lang.Object-"><code>setSharedVariable(String, Object)</code></a> calls, one for each hash entry.</div>
 </td>
 </tr>
-<tr id="i67" class="rowColor">
+<tr id="i69" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setAttemptExceptionReporter-freemarker.template.AttemptExceptionReporter-">setAttemptExceptionReporter</a></span>(<a href="../../freemarker/template/AttemptExceptionReporter.html" title="interface in freemarker.template">AttemptExceptionReporter</a>&nbsp;attemptExceptionReporter)</code>
 <div class="block">Specifies how exceptions handled (and hence suppressed) by an <code>#attempt</code> blocks will be logged or otherwise
  reported.</div>
 </td>
 </tr>
-<tr id="i68" class="altColor">
+<tr id="i70" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setAutoEscapingPolicy-int-">setAutoEscapingPolicy</a></span>(int&nbsp;autoEscapingPolicy)</code>
 <div class="block">Sets when auto-escaping should be enabled depending on the current <a href="../../freemarker/core/OutputFormat.html" title="class in freemarker.core">output format</a>;
  default is <a href="../../freemarker/template/Configuration.html#ENABLE_IF_DEFAULT_AUTO_ESCAPING_POLICY"><code>ENABLE_IF_DEFAULT_AUTO_ESCAPING_POLICY</code></a>.</div>
 </td>
 </tr>
-<tr id="i69" class="rowColor">
+<tr id="i71" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setCacheStorage-freemarker.cache.CacheStorage-">setCacheStorage</a></span>(<a href="../../freemarker/cache/CacheStorage.html" title="interface in freemarker.cache">CacheStorage</a>&nbsp;cacheStorage)</code>
 <div class="block">Sets the <a href="../../freemarker/cache/CacheStorage.html" title="interface in freemarker.cache"><code>CacheStorage</code></a> used for caching <a href="../../freemarker/template/Template.html" title="class in freemarker.template"><code>Template</code></a>-s;
  the earlier content of the template cache will be dropt.</div>
 </td>
 </tr>
-<tr id="i70" class="altColor">
+<tr id="i72" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setClassForTemplateLoading-java.lang.Class-java.lang.String-">setClassForTemplateLoading</a></span>(java.lang.Class&nbsp;resourceLoaderClass,
                           java.lang.String&nbsp;basePackagePath)</code>
@@ -1246,7 +1302,7 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
  package specified.</div>
 </td>
 </tr>
-<tr id="i71" class="rowColor">
+<tr id="i73" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setClassLoaderForTemplateLoading-java.lang.ClassLoader-java.lang.String-">setClassLoaderForTemplateLoading</a></span>(java.lang.ClassLoader&nbsp;classLoader,
                                 java.lang.String&nbsp;basePackagePath)</code>
@@ -1254,7 +1310,7 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
  from the inside the package specified.</div>
 </td>
 </tr>
-<tr id="i72" class="altColor">
+<tr id="i74" class="altColor">
 <td class="colFirst"><code>static void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setDefaultConfiguration-freemarker.template.Configuration-">setDefaultConfiguration</a></span>(<a href="../../freemarker/template/Configuration.html" title="class in freemarker.template">Configuration</a>&nbsp;config)</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -1264,7 +1320,7 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </div>
 </td>
 </tr>
-<tr id="i73" class="rowColor">
+<tr id="i75" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setDefaultEncoding-java.lang.String-">setDefaultEncoding</a></span>(java.lang.String&nbsp;encoding)</code>
 <div class="block">Sets the charset used for decoding byte sequences to character sequences when
@@ -1272,13 +1328,13 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
  was specified via <a href="../../freemarker/template/Configuration.html#setEncoding-java.util.Locale-java.lang.String-"><code>setEncoding(Locale, String)</code></a>.</div>
 </td>
 </tr>
-<tr id="i74" class="altColor">
+<tr id="i76" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setDirectoryForTemplateLoading-java.io.File-">setDirectoryForTemplateLoading</a></span>(java.io.File&nbsp;dir)</code>
 <div class="block">Sets the file system directory from which to load templates.</div>
 </td>
 </tr>
-<tr id="i75" class="rowColor">
+<tr id="i77" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setEncoding-java.util.Locale-java.lang.String-">setEncoding</a></span>(java.util.Locale&nbsp;locale,
            java.lang.String&nbsp;encoding)</code>
@@ -1286,7 +1342,7 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
  a given locale.</div>
 </td>
 </tr>
-<tr id="i76" class="altColor">
+<tr id="i78" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setIncompatibleEnhancements-java.lang.String-">setIncompatibleEnhancements</a></span>(java.lang.String&nbsp;version)</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -1295,78 +1351,84 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </div>
 </td>
 </tr>
-<tr id="i77" class="rowColor">
+<tr id="i79" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setIncompatibleImprovements-freemarker.template.Version-">setIncompatibleImprovements</a></span>(<a href="../../freemarker/template/Version.html" title="class in freemarker.template">Version</a>&nbsp;incompatibleImprovements)</code>
 <div class="block">Use <a href="../../freemarker/template/Configuration.html#Configuration-freemarker.template.Version-"><code>Configuration(Version)</code></a> instead if possible; see the meaning of the parameter there.</div>
 </td>
 </tr>
-<tr id="i78" class="altColor">
+<tr id="i80" class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setInterpolationSyntax-int-">setInterpolationSyntax</a></span>(int&nbsp;interpolationSyntax)</code>
+<div class="block">Determines the interpolation syntax (like <code>${x}</code> VS <code>[=x]</code>) of the template files.</div>
+</td>
+</tr>
+<tr id="i81" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setLocale-java.util.Locale-">setLocale</a></span>(java.util.Locale&nbsp;locale)</code>
 <div class="block">Sets the locale used for number and date formatting (among others), also the locale used for searching
  localized template variations when no locale was explicitly requested.</div>
 </td>
 </tr>
-<tr id="i79" class="rowColor">
+<tr id="i82" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setLocalizedLookup-boolean-">setLocalizedLookup</a></span>(boolean&nbsp;localizedLookup)</code>
 <div class="block">Enables/disables localized template lookup.</div>
 </td>
 </tr>
-<tr id="i80" class="altColor">
+<tr id="i83" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setLogTemplateExceptions-boolean-">setLogTemplateExceptions</a></span>(boolean&nbsp;value)</code>
 <div class="block">Specifies if <a href="../../freemarker/template/TemplateException.html" title="class in freemarker.template"><code>TemplateException</code></a>-s thrown by template processing are logged by FreeMarker or not.</div>
 </td>
 </tr>
-<tr id="i81" class="rowColor">
+<tr id="i84" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setNamingConvention-int-">setNamingConvention</a></span>(int&nbsp;namingConvention)</code>
 <div class="block">Sets the naming convention used for the identifiers that are part of the template language.</div>
 </td>
 </tr>
-<tr id="i82" class="altColor">
+<tr id="i85" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setObjectWrapper-freemarker.template.ObjectWrapper-">setObjectWrapper</a></span>(<a href="../../freemarker/template/ObjectWrapper.html" title="interface in freemarker.template">ObjectWrapper</a>&nbsp;objectWrapper)</code>
 <div class="block">Sets the object wrapper used to wrap objects to <a href="../../freemarker/template/TemplateModel.html" title="interface in freemarker.template"><code>TemplateModel</code></a>-s.</div>
 </td>
 </tr>
-<tr id="i83" class="rowColor">
+<tr id="i86" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setOutputFormat-freemarker.core.OutputFormat-">setOutputFormat</a></span>(<a href="../../freemarker/core/OutputFormat.html" title="class in freemarker.core">OutputFormat</a>&nbsp;outputFormat)</code>
 <div class="block">Sets the default output format.</div>
 </td>
 </tr>
-<tr id="i84" class="altColor">
+<tr id="i87" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setRecognizeStandardFileExtensions-boolean-">setRecognizeStandardFileExtensions</a></span>(boolean&nbsp;recognizeStandardFileExtensions)</code>
 <div class="block">Sets if the "file" extension part of the source name (<a href="../../freemarker/template/Template.html#getSourceName--"><code>Template.getSourceName()</code></a>) will influence certain
  parsing settings.</div>
 </td>
 </tr>
-<tr id="i85" class="rowColor">
+<tr id="i88" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setRegisteredCustomOutputFormats-java.util.Collection-">setRegisteredCustomOutputFormats</a></span>(java.util.Collection&lt;? extends <a href="../../freemarker/core/OutputFormat.html" title="class in freemarker.core">OutputFormat</a>&gt;&nbsp;registeredCustomOutputFormats)</code>
 <div class="block">Sets the custom output formats that can be referred by their unique name (<a href="../../freemarker/core/OutputFormat.html#getName--"><code>OutputFormat.getName()</code></a>) from
  templates.</div>
 </td>
 </tr>
-<tr id="i86" class="altColor">
+<tr id="i89" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setServletContextForTemplateLoading-java.lang.Object-java.lang.String-">setServletContextForTemplateLoading</a></span>(java.lang.Object&nbsp;servletContext,
                                    java.lang.String&nbsp;path)</code>
 <div class="block">Sets the servlet context from which to load templates.</div>
 </td>
 </tr>
-<tr id="i87" class="rowColor">
+<tr id="i90" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setSetting-java.lang.String-java.lang.String-">setSetting</a></span>(java.lang.String&nbsp;name,
           java.lang.String&nbsp;value)</code>
 <div class="block">Sets a FreeMarker setting by a name and string value.</div>
 </td>
 </tr>
-<tr id="i88" class="altColor">
+<tr id="i91" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setSharedVariable-java.lang.String-java.lang.Object-">setSharedVariable</a></span>(java.lang.String&nbsp;name,
                  java.lang.Object&nbsp;value)</code>
@@ -1374,20 +1436,20 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
  <code>value</code>, so it's important that the object wrapper is set before this.</div>
 </td>
 </tr>
-<tr id="i89" class="rowColor">
+<tr id="i92" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setSharedVariable-java.lang.String-freemarker.template.TemplateModel-">setSharedVariable</a></span>(java.lang.String&nbsp;name,
                  <a href="../../freemarker/template/TemplateModel.html" title="interface in freemarker.template">TemplateModel</a>&nbsp;tm)</code>
 <div class="block">Adds a shared variable to the configuration.</div>
 </td>
 </tr>
-<tr id="i90" class="altColor">
+<tr id="i93" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setSharedVaribles-java.util.Map-">setSharedVaribles</a></span>(java.util.Map&nbsp;map)</code>
 <div class="block">Replaces all shared variables (removes all previously added ones).</div>
 </td>
 </tr>
-<tr id="i91" class="rowColor">
+<tr id="i94" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setStrictSyntaxMode-boolean-">setStrictSyntaxMode</a></span>(boolean&nbsp;b)</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -1395,54 +1457,54 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </div>
 </td>
 </tr>
-<tr id="i92" class="altColor">
+<tr id="i95" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setTabSize-int-">setTabSize</a></span>(int&nbsp;tabSize)</code>
 <div class="block">Sets the assumed display width of the tab character (ASCII 9), which influences the column number shown in error
  messages (or the column number you get through other API-s).</div>
 </td>
 </tr>
-<tr id="i93" class="rowColor">
+<tr id="i96" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setTagSyntax-int-">setTagSyntax</a></span>(int&nbsp;tagSyntax)</code>
-<div class="block">Determines the syntax of the template files (angle bracket VS square bracket)
- that has no <code>#ftl</code> in it.</div>
+<div class="block">Determines the tag syntax (like <code>&lt;#if x&gt;</code> VS <code>[#if x]</code>) of the template files 
+ that has no <code>#ftl</code> header to decide that.</div>
 </td>
 </tr>
-<tr id="i94" class="altColor">
+<tr id="i97" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setTemplateConfigurations-freemarker.cache.TemplateConfigurationFactory-">setTemplateConfigurations</a></span>(<a href="../../freemarker/cache/TemplateConfigurationFactory.html" title="class in freemarker.cache">TemplateConfigurationFactory</a>&nbsp;templateConfigurations)</code>
 <div class="block">Sets a <a href="../../freemarker/cache/TemplateConfigurationFactory.html" title="class in freemarker.cache"><code>TemplateConfigurationFactory</code></a> that will configure individual templates where their settings differ
  from those coming from the common <a href="../../freemarker/template/Configuration.html" title="class in freemarker.template"><code>Configuration</code></a> object.</div>
 </td>
 </tr>
-<tr id="i95" class="rowColor">
+<tr id="i98" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setTemplateExceptionHandler-freemarker.template.TemplateExceptionHandler-">setTemplateExceptionHandler</a></span>(<a href="../../freemarker/template/TemplateExceptionHandler.html" title="interface in freemarker.template">TemplateExceptionHandler</a>&nbsp;templateExceptionHandler)</code>
 <div class="block">Sets the exception handler used to handle exceptions occurring inside templates.</div>
 </td>
 </tr>
-<tr id="i96" class="altColor">
+<tr id="i99" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setTemplateLoader-freemarker.cache.TemplateLoader-">setTemplateLoader</a></span>(<a href="../../freemarker/cache/TemplateLoader.html" title="interface in freemarker.cache">TemplateLoader</a>&nbsp;templateLoader)</code>
 <div class="block">Sets a <a href="../../freemarker/cache/TemplateLoader.html" title="interface in freemarker.cache"><code>TemplateLoader</code></a> that is used to look up and load templates;
  as a side effect the template cache will be emptied (unless the new and the old values are the same).</div>
 </td>
 </tr>
-<tr id="i97" class="rowColor">
+<tr id="i100" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setTemplateLookupStrategy-freemarker.cache.TemplateLookupStrategy-">setTemplateLookupStrategy</a></span>(<a href="../../freemarker/cache/TemplateLookupStrategy.html" title="class in freemarker.cache">TemplateLookupStrategy</a>&nbsp;templateLookupStrategy)</code>
 <div class="block">Sets the <a href="../../freemarker/cache/TemplateLookupStrategy.html" title="class in freemarker.cache"><code>TemplateLookupStrategy</code></a> that is used to look up templates based on the requested name; as a side
  effect the template cache will be emptied.</div>
 </td>
 </tr>
-<tr id="i98" class="altColor">
+<tr id="i101" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setTemplateNameFormat-freemarker.cache.TemplateNameFormat-">setTemplateNameFormat</a></span>(<a href="../../freemarker/cache/TemplateNameFormat.html" title="class in freemarker.cache">TemplateNameFormat</a>&nbsp;templateNameFormat)</code>
 <div class="block">Sets the template name format used.</div>
 </td>
 </tr>
-<tr id="i99" class="rowColor">
+<tr id="i102" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setTemplateUpdateDelay-int-">setTemplateUpdateDelay</a></span>(int&nbsp;seconds)</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -1451,27 +1513,27 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </div>
 </td>
 </tr>
-<tr id="i100" class="altColor">
+<tr id="i103" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setTemplateUpdateDelayMilliseconds-long-">setTemplateUpdateDelayMilliseconds</a></span>(long&nbsp;millis)</code>
 <div class="block">Sets the time in milliseconds that must elapse before checking whether there is a newer version of a template
  "file" than the cached one.</div>
 </td>
 </tr>
-<tr id="i101" class="rowColor">
+<tr id="i104" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setTimeZone-java.util.TimeZone-">setTimeZone</a></span>(java.util.TimeZone&nbsp;timeZone)</code>
 <div class="block">Sets the time zone to use when formatting date/time values.</div>
 </td>
 </tr>
-<tr id="i102" class="altColor">
+<tr id="i105" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setWhitespaceStripping-boolean-">setWhitespaceStripping</a></span>(boolean&nbsp;b)</code>
 <div class="block">Sets whether the FTL parser will try to remove
  superfluous white-space around certain FTL tags.</div>
 </td>
 </tr>
-<tr id="i103" class="rowColor">
+<tr id="i106" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#setWrapUncheckedExceptions-boolean-">setWrapUncheckedExceptions</a></span>(boolean&nbsp;value)</code>
 <div class="block">Specifies if unchecked exceptions thrown during expression evaluation or during executing custom directives (and
@@ -1479,85 +1541,85 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
  <a href="../../freemarker/template/Template.html#process-java.lang.Object-java.io.Writer-freemarker.template.ObjectWrapper-"><code>Template.process(Object, Writer, ObjectWrapper)</code></a> as is.</div>
 </td>
 </tr>
-<tr id="i104" class="altColor">
+<tr id="i107" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetAttemptExceptionReporter--">unsetAttemptExceptionReporter</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i105" class="rowColor">
+<tr id="i108" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetCacheStorage--">unsetCacheStorage</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i106" class="altColor">
+<tr id="i109" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetDefaultEncoding--">unsetDefaultEncoding</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i107" class="rowColor">
+<tr id="i110" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetLocale--">unsetLocale</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i108" class="altColor">
+<tr id="i111" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetLogTemplateExceptions--">unsetLogTemplateExceptions</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i109" class="rowColor">
+<tr id="i112" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetObjectWrapper--">unsetObjectWrapper</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i110" class="altColor">
+<tr id="i113" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetOutputFormat--">unsetOutputFormat</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i111" class="rowColor">
+<tr id="i114" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetRecognizeStandardFileExtensions--">unsetRecognizeStandardFileExtensions</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i112" class="altColor">
+<tr id="i115" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetTemplateExceptionHandler--">unsetTemplateExceptionHandler</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i113" class="rowColor">
+<tr id="i116" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetTemplateLoader--">unsetTemplateLoader</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i114" class="altColor">
+<tr id="i117" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetTemplateLookupStrategy--">unsetTemplateLookupStrategy</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i115" class="rowColor">
+<tr id="i118" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetTemplateNameFormat--">unsetTemplateNameFormat</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i116" class="altColor">
+<tr id="i119" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetTimeZone--">unsetTimeZone</a></span>()</code>
 <div class="block">Resets the setting to its default, as if it was never set.</div>
 </td>
 </tr>
-<tr id="i117" class="rowColor">
+<tr id="i120" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/template/Configuration.html#unsetWrapUncheckedExceptions--">unsetWrapUncheckedExceptions</a></span>()</code>&nbsp;</td>
 </tr>
@@ -2146,6 +2208,48 @@ implements java.lang.Cloneable, <a href="../../freemarker/core/ParserConfigurati
 </dl>
 </li>
 </ul>
+<a name="INTERPOLATION_SYNTAX_KEY_SNAKE_CASE">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>INTERPOLATION_SYNTAX_KEY_SNAKE_CASE</h4>
+<pre>public static final&nbsp;java.lang.String INTERPOLATION_SYNTAX_KEY_SNAKE_CASE</pre>
+<div class="block">Legacy, snake case (<code>like_this</code>) variation of the setting name. @since 2.3.28</div>
+<dl>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../../constant-values.html#freemarker.template.Configuration.INTERPOLATION_SYNTAX_KEY_SNAKE_CASE">Constant Field Values</a></dd>
+</dl>
+</li>
+</ul>
+<a name="INTERPOLATION_SYNTAX_KEY_CAMEL_CASE">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>INTERPOLATION_SYNTAX_KEY_CAMEL_CASE</h4>
+<pre>public static final&nbsp;java.lang.String INTERPOLATION_SYNTAX_KEY_CAMEL_CASE</pre>
+<div class="block">Modern, camel case (<code>likeThis</code>) variation of the setting name. @since 2.3.28</div>
+<dl>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../../constant-values.html#freemarker.template.Configuration.INTERPOLATION_SYNTAX_KEY_CAMEL_CASE">Constant Field Values</a></dd>
+</dl>
+</li>
+</ul>
+<a name="INTERPOLATION_SYNTAX_KEY">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>INTERPOLATION_SYNTAX_KEY</h4>
+<pre>public static final&nbsp;java.lang.String INTERPOLATION_SYNTAX_KEY</pre>
+<div class="block">Alias to the <code>..._SNAKE_CASE</code> variation due to backward compatibility constraints.</div>
+<dl>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../../constant-values.html#freemarker.template.Configuration.INTERPOLATION_SYNTAX_KEY">Constant Field Values</a></dd>
+</dl>
+</li>
+</ul>
 <a name="NAMING_CONVENTION_KEY_SNAKE_CASE">
 <!--   -->
 </a>
@@ -2509,6 +2613,48 @@ public static final&nbsp;java.lang.String INCOMPATIBLE_ENHANCEMENTS</pre>
 </dl>
 </li>
 </ul>
+<a name="LEGACY_INTERPOLATION_SYNTAX">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>LEGACY_INTERPOLATION_SYNTAX</h4>
+<pre>public static final&nbsp;int LEGACY_INTERPOLATION_SYNTAX</pre>
+<div class="block"><code>${expression}</code> and the deprecated <code>#{expression; numFormat}</code> @since 2.3.28</div>
+<dl>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../../constant-values.html#freemarker.template.Configuration.LEGACY_INTERPOLATION_SYNTAX">Constant Field Values</a></dd>
+</dl>
+</li>
+</ul>
+<a name="DOLLAR_INTERPOLATION_SYNTAX">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>DOLLAR_INTERPOLATION_SYNTAX</h4>
+<pre>public static final&nbsp;int DOLLAR_INTERPOLATION_SYNTAX</pre>
+<div class="block"><code>${expression}</code> only (not <code>#{expression; numFormat}</code>) @since 2.3.28</div>
+<dl>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../../constant-values.html#freemarker.template.Configuration.DOLLAR_INTERPOLATION_SYNTAX">Constant Field Values</a></dd>
+</dl>
+</li>
+</ul>
+<a name="SQUARE_BRACKET_INTERPOLATION_SYNTAX">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>SQUARE_BRACKET_INTERPOLATION_SYNTAX</h4>
+<pre>public static final&nbsp;int SQUARE_BRACKET_INTERPOLATION_SYNTAX</pre>
+<div class="block"><code>[=expression]</code> @since 2.3.28</div>
+<dl>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../../constant-values.html#freemarker.template.Configuration.SQUARE_BRACKET_INTERPOLATION_SYNTAX">Constant Field Values</a></dd>
+</dl>
+</li>
+</ul>
 <a name="AUTO_DETECT_NAMING_CONVENTION">
 <!--   -->
 </a>
@@ -2769,8 +2915,8 @@ public&nbsp;Configuration()</pre>
  <p><b>About the "incompatible improvements" setting</b>
 
  <p>This setting value is the FreeMarker version number where the not 100% backward compatible bug fixes and
- improvements that you want to enable were already implemented. In new projects you should set this to the
- version of FreeMarker that you start the development with. In older projects it's also usually better to keep
+ improvements that you want to enable were already implemented. In new projects you should set this to the fixed
+ FreeMarker version that you start the development with. In older projects it's also usually better to keep
  this high, however you should check the changes activated (find them below), especially if not only the 3rd
  version number (the micro version) of <code>incompatibleImprovements</code> is increased. Generally, as far as you
  only increase the last version number of this setting, the changes are low risk. The default value is 2.3.0 to
@@ -2779,6 +2925,9 @@ public&nbsp;Configuration()</pre>
  <p>Bugfixes and improvements that are fully backward compatible, also those that are important security fixes,
  are enabled regardless of the incompatible improvements setting.
  
+ <p>Do NOT ever use <a href="../../freemarker/template/Configuration.html#getVersion--"><code>getVersion()</code></a> to set the "incompatible improvements". Always use a fixed value, like
+ <a href="../../freemarker/template/Configuration.html#VERSION_2_3_28"><code>VERSION_2_3_28</code></a>. Otherwise your application can break as you upgrade FreeMarker. 
+ 
  <p>An important consequence of setting this setting is that now your application will check if the stated minimum
  FreeMarker version requirement is met. Like if you set this setting to 2.3.22, but accidentally the application
  is deployed with FreeMarker 2.3.21, then FreeMarker will fail, telling that a higher version is required. After
@@ -3087,6 +3236,10 @@ public&nbsp;Configuration()</pre>
            (Of course, the parameter default value expression is still evaluated in the context of the called
            macro or function.) Similarly, <code>.macro_caller_template_name</code> (which itself was added in 2.3.28),
            when used in a macro call argument, won't be incorrectly evaluated in the context of the called macro.
+       <li><p>Fixed legacy parser glitch where a tag can be closed with an illegal <code>]</code> (when it's not part
+           of an expression) despite that the tag syntax is set to angle brackets. For example <code>&lt;#if x]</code>
+           worked just like <code>&lt;#if x&gt;</code>. Note that it doesn't affect the legal usage of <code>]</code>, like
+           <code>&lt;#if x[0]&gt;</code> works correctly without this fix as well. 
      </ul>
    </li>
  </ul></div>
@@ -4077,7 +4230,11 @@ public&nbsp;void&nbsp;setStrictSyntaxMode(boolean&nbsp;b)</pre>
 <h4>setIncompatibleImprovements</h4>
 <pre>public&nbsp;void&nbsp;setIncompatibleImprovements(<a href="../../freemarker/template/Version.html" title="class in freemarker.template">Version</a>&nbsp;incompatibleImprovements)</pre>
 <div class="block">Use <a href="../../freemarker/template/Configuration.html#Configuration-freemarker.template.Version-"><code>Configuration(Version)</code></a> instead if possible; see the meaning of the parameter there.
- If the default value of a setting depends on the <code>incompatibleImprovements</code> and the value of that setting
+ 
+ <p>Do NOT ever use <a href="../../freemarker/template/Configuration.html#getVersion--"><code>getVersion()</code></a> to set the "incompatible improvements". Always use a fixed value, like
+ <a href="../../freemarker/template/Configuration.html#VERSION_2_3_28"><code>VERSION_2_3_28</code></a>. Otherwise your application can break as you upgrade FreeMarker. 
+ 
+ <p>If the default value of a setting depends on the <code>incompatibleImprovements</code> and the value of that setting
  was never set in this <a href="../../freemarker/template/Configuration.html" title="class in freemarker.template"><code>Configuration</code></a> object through the public API, its value will be set to the default
  value appropriate for the new <code>incompatibleImprovements</code>. (This adjustment of a setting value doesn't
  count as setting that setting, so setting <code>incompatibleImprovements</code> for multiple times also works as
@@ -4482,9 +4639,8 @@ public&nbsp;int&nbsp;getParsedIncompatibleEnhancements()</pre>
 <li class="blockList">
 <h4>setTagSyntax</h4>
 <pre>public&nbsp;void&nbsp;setTagSyntax(int&nbsp;tagSyntax)</pre>
-<div class="block">Determines the syntax of the template files (angle bracket VS square bracket)
- that has no <code>#ftl</code> in it. The <code>tagSyntax</code>
- parameter must be one of:
+<div class="block">Determines the tag syntax (like <code>&lt;#if x&gt;</code> VS <code>[#if x]</code>) of the template files 
+ that has no <code>#ftl</code> header to decide that. The <code>tagSyntax</code> parameter must be one of:
  <ul>
    <li><a href="../../freemarker/template/Configuration.html#AUTO_DETECT_TAG_SYNTAX"><code>AUTO_DETECT_TAG_SYNTAX</code></a>:
      use the syntax of the first FreeMarker tag (can be anything, like <tt>#list</tt>,
@@ -4502,6 +4658,10 @@ public&nbsp;int&nbsp;getParsedIncompatibleEnhancements()</pre>
  <p>This setting is ignored for the templates that have <code>ftl</code> directive in
  it. For those templates the syntax used for the <code>ftl</code> directive determines
  the syntax.</div>
+<dl>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../../freemarker/template/Configuration.html#setInterpolationSyntax-int-"><code>setInterpolationSyntax(int)</code></a></dd>
+</dl>
 </li>
 </ul>
 <a name="getTagSyntax--">
@@ -4518,6 +4678,40 @@ public&nbsp;int&nbsp;getParsedIncompatibleEnhancements()</pre>
 </dl>
 </li>
 </ul>
+<a name="setInterpolationSyntax-int-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setInterpolationSyntax</h4>
+<pre>public&nbsp;void&nbsp;setInterpolationSyntax(int&nbsp;interpolationSyntax)</pre>
+<div class="block">Determines the interpolation syntax (like <code>${x}</code> VS <code>[=x]</code>) of the template files. The
+ <code>interpolationSyntax</code> parameter must be one of <a href="../../freemarker/template/Configuration.html#LEGACY_INTERPOLATION_SYNTAX"><code>LEGACY_INTERPOLATION_SYNTAX</code></a>,
+ <a href="../../freemarker/template/Configuration.html#DOLLAR_INTERPOLATION_SYNTAX"><code>DOLLAR_INTERPOLATION_SYNTAX</code></a>, and <a href="../../freemarker/template/Configuration.html#SQUARE_BRACKET_INTERPOLATION_SYNTAX"><code>SQUARE_BRACKET_INTERPOLATION_SYNTAX</code></a>.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>2.3.28</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../../freemarker/template/Configuration.html#setTagSyntax-int-"><code>setTagSyntax(int

<TRUNCATED>


Mime
View raw message