http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/HtmlEscape.html
----------------------------------------------------------------------
diff --git a/builds/fm2.3.27/api/freemarker/template/utility/HtmlEscape.html 
b/builds/fm2.3.27/api/freemarker/template/utility/HtmlEscape.html
index 055ad0b..0204dad 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/HtmlEscape.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/HtmlEscape.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:02 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>HtmlEscape (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>HtmlEscape (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="HtmlEscape (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="HtmlEscape (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {
@@ -198,8 +198,7 @@ implements <a 
href="../../../freemarker/template/TemplateTransformModel.html" ti
 <td class="colFirst"><code><a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a 
href="../../../freemarker/template/utility/HtmlEscape.html#getWriter-java.io.Writer-java.util.Map-">getWriter</a></span>(<a
 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;out,
          <a 
href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&nbsp;args)</code>
-<div class="block">Returns a writer that will be used by the engine to feed the
- transformation input to the transform.</div>
+<div class="block">Returns a writer that will be used by the engine to feed 
the transformation input to the transform.</div>
 </td>
 </tr>
 </table>
@@ -250,26 +249,31 @@ implements <a 
href="../../../freemarker/template/TemplateTransformModel.html" ti
 <pre>public&nbsp;<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;getWriter(<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;out,
                         <a 
href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&nbsp;args)</pre>
 <div class="block"><span class="descfrmTypeLabel">Description copied from 
interface:&nbsp;<code><a 
href="../../../freemarker/template/TemplateTransformModel.html#getWriter-java.io.Writer-java.util.Map-">TemplateTransformModel</a></code></span></div>
-<div class="block">Returns a writer that will be used by the engine to feed the
- transformation input to the transform. Each call to this method
- must return a new instance of the writer so that the transformation
- is thread-safe.</div>
+<div class="block">Returns a writer that will be used by the engine to feed 
the transformation input to the transform. Each call to
+ this method must return a new instance of the writer so that the 
transformation is thread-safe.
+ <p>
+ This method should not throw <a 
href="http://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html?is-external=true";
 title="class or interface in java.lang"><code>RuntimeException</code></a>, nor 
<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true";
 title="class or interface in java.io"><code>IOException</code></a> that wasn't 
caused by writing to
+ the output. Such exceptions should be catched inside the method and wrapped 
inside a
+ <a href="../../../freemarker/template/TemplateModelException.html" 
title="class in freemarker.template"><code>TemplateModelException</code></a>. 
(Note that setting <a 
href="../../../freemarker/template/Configuration.html#setWrapUncheckedExceptions-boolean-"><code>Configuration.setWrapUncheckedExceptions(boolean)</code></a>
 to
+ <code>true</code> can mitigate the negative effects of implementations that 
throw <a 
href="http://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html?is-external=true";
 title="class or interface in 
java.lang"><code>RuntimeException</code></a>-s.)</div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
 <dd><code><a 
href="../../../freemarker/template/TemplateTransformModel.html#getWriter-java.io.Writer-java.util.Map-">getWriter</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../freemarker/template/TemplateTransformModel.html" 
title="interface in freemarker.template">TemplateTransformModel</a></code></dd>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>out</code> - the character stream to which to write the transformed 
output</dd>
-<dd><code>args</code> - the arguments (if any) passed to the transformation as 
a 
- map of key/value pairs where the keys are strings and the arguments are
- TemplateModel instances. This is never null. If you need to convert the
- template models to POJOs, you can use the utility methods in the 
- <a href="../../../freemarker/template/utility/DeepUnwrap.html" title="class 
in freemarker.template.utility"><code>DeepUnwrap</code></a> class.</dd>
+<dd><code>args</code> - the arguments (if any) passed to the transformation as 
a map of key/value pairs where the keys are
+            strings and the arguments are <a 
href="../../../freemarker/template/TemplateModel.html" title="interface in 
freemarker.template"><code>TemplateModel</code></a> instances. This is never 
<code>null</code>. (If you
+            need to convert the template models to POJOs, you can use the 
utility methods in the
+            <a href="../../../freemarker/template/utility/DeepUnwrap.html" 
title="class in freemarker.template.utility"><code>DeepUnwrap</code></a> class. 
Though it's recommended to work with <a 
href="../../../freemarker/template/TemplateModel.html" title="interface in 
freemarker.template"><code>TemplateModel</code></a>-s directly.)</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
-<dd>a writer to which the engine will feed the transformation 
- input, or null if the transform does not support nested content (body).
- The returned writer can implement the <a 
href="../../../freemarker/template/TransformControl.html" title="interface in 
freemarker.template"><code>TransformControl</code></a>
- interface if it needs advanced control over the evaluation of the 
- transformation body.</dd>
+<dd>The <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> to which the 
engine will write the content to transform, or <code>null</code> if the
+         transform does not support nested content (body). The returned <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> may implements 
the
+         <a href="../../../freemarker/template/TransformControl.html" 
title="interface in freemarker.template"><code>TransformControl</code></a> 
interface if it needs advanced control over the evaluation of the nested
+         content. FreeMarker will call <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true#close--";
 title="class or interface in java.io"><code>Writer.close()</code></a> after 
the transform end-tag. <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true#close--";
 title="class or interface in java.io"><code>Writer.close()</code></a>
+         must not close the <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> received as the 
<code>out</code> parameter (so if you are using a
+         <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/FilterWriter.html?is-external=true";
 title="class or interface in java.io"><code>FilterWriter</code></a>, you must 
override <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/FilterWriter.html?is-external=true#close--";
 title="class or interface in java.io"><code>FilterWriter.close()</code></a>, 
as by default that closes the
+         wrapped <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a>). Since 2.3.27 
its also allowed to return the <code>out</code> writer as is, in which
+         case it won't be closed.</dd>
 </dl>
 </li>
 </ul>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/JythonRuntime.html
----------------------------------------------------------------------
diff --git a/builds/fm2.3.27/api/freemarker/template/utility/JythonRuntime.html 
b/builds/fm2.3.27/api/freemarker/template/utility/JythonRuntime.html
index e60d827..604bb5d 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/JythonRuntime.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/JythonRuntime.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:02 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>JythonRuntime (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>JythonRuntime (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="JythonRuntime (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="JythonRuntime (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {
@@ -184,8 +184,7 @@ implements <a 
href="../../../freemarker/template/TemplateTransformModel.html" ti
 <td class="colFirst"><code><a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a 
href="../../../freemarker/template/utility/JythonRuntime.html#getWriter-java.io.Writer-java.util.Map-">getWriter</a></span>(<a
 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;out,
          <a 
href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&nbsp;args)</code>
-<div class="block">Returns a writer that will be used by the engine to feed the
- transformation input to the transform.</div>
+<div class="block">Returns a writer that will be used by the engine to feed 
the transformation input to the transform.</div>
 </td>
 </tr>
 </table>
@@ -243,26 +242,31 @@ implements <a 
href="../../../freemarker/template/TemplateTransformModel.html" ti
 <pre>public&nbsp;<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;getWriter(<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;out,
                         <a 
href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&nbsp;args)</pre>
 <div class="block"><span class="descfrmTypeLabel">Description copied from 
interface:&nbsp;<code><a 
href="../../../freemarker/template/TemplateTransformModel.html#getWriter-java.io.Writer-java.util.Map-">TemplateTransformModel</a></code></span></div>
-<div class="block">Returns a writer that will be used by the engine to feed the
- transformation input to the transform. Each call to this method
- must return a new instance of the writer so that the transformation
- is thread-safe.</div>
+<div class="block">Returns a writer that will be used by the engine to feed 
the transformation input to the transform. Each call to
+ this method must return a new instance of the writer so that the 
transformation is thread-safe.
+ <p>
+ This method should not throw <a 
href="http://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html?is-external=true";
 title="class or interface in java.lang"><code>RuntimeException</code></a>, nor 
<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true";
 title="class or interface in java.io"><code>IOException</code></a> that wasn't 
caused by writing to
+ the output. Such exceptions should be catched inside the method and wrapped 
inside a
+ <a href="../../../freemarker/template/TemplateModelException.html" 
title="class in freemarker.template"><code>TemplateModelException</code></a>. 
(Note that setting <a 
href="../../../freemarker/template/Configuration.html#setWrapUncheckedExceptions-boolean-"><code>Configuration.setWrapUncheckedExceptions(boolean)</code></a>
 to
+ <code>true</code> can mitigate the negative effects of implementations that 
throw <a 
href="http://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html?is-external=true";
 title="class or interface in 
java.lang"><code>RuntimeException</code></a>-s.)</div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
 <dd><code><a 
href="../../../freemarker/template/TemplateTransformModel.html#getWriter-java.io.Writer-java.util.Map-">getWriter</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../freemarker/template/TemplateTransformModel.html" 
title="interface in freemarker.template">TemplateTransformModel</a></code></dd>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>out</code> - the character stream to which to write the transformed 
output</dd>
-<dd><code>args</code> - the arguments (if any) passed to the transformation as 
a 
- map of key/value pairs where the keys are strings and the arguments are
- TemplateModel instances. This is never null. If you need to convert the
- template models to POJOs, you can use the utility methods in the 
- <a href="../../../freemarker/template/utility/DeepUnwrap.html" title="class 
in freemarker.template.utility"><code>DeepUnwrap</code></a> class.</dd>
+<dd><code>args</code> - the arguments (if any) passed to the transformation as 
a map of key/value pairs where the keys are
+            strings and the arguments are <a 
href="../../../freemarker/template/TemplateModel.html" title="interface in 
freemarker.template"><code>TemplateModel</code></a> instances. This is never 
<code>null</code>. (If you
+            need to convert the template models to POJOs, you can use the 
utility methods in the
+            <a href="../../../freemarker/template/utility/DeepUnwrap.html" 
title="class in freemarker.template.utility"><code>DeepUnwrap</code></a> class. 
Though it's recommended to work with <a 
href="../../../freemarker/template/TemplateModel.html" title="interface in 
freemarker.template"><code>TemplateModel</code></a>-s directly.)</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
-<dd>a writer to which the engine will feed the transformation 
- input, or null if the transform does not support nested content (body).
- The returned writer can implement the <a 
href="../../../freemarker/template/TransformControl.html" title="interface in 
freemarker.template"><code>TransformControl</code></a>
- interface if it needs advanced control over the evaluation of the 
- transformation body.</dd>
+<dd>The <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> to which the 
engine will write the content to transform, or <code>null</code> if the
+         transform does not support nested content (body). The returned <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> may implements 
the
+         <a href="../../../freemarker/template/TransformControl.html" 
title="interface in freemarker.template"><code>TransformControl</code></a> 
interface if it needs advanced control over the evaluation of the nested
+         content. FreeMarker will call <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true#close--";
 title="class or interface in java.io"><code>Writer.close()</code></a> after 
the transform end-tag. <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true#close--";
 title="class or interface in java.io"><code>Writer.close()</code></a>
+         must not close the <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> received as the 
<code>out</code> parameter (so if you are using a
+         <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/FilterWriter.html?is-external=true";
 title="class or interface in java.io"><code>FilterWriter</code></a>, you must 
override <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/FilterWriter.html?is-external=true#close--";
 title="class or interface in java.io"><code>FilterWriter.close()</code></a>, 
as by default that closes the
+         wrapped <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a>). Since 2.3.27 
its also allowed to return the <code>out</code> writer as is, in which
+         case it won't be closed.</dd>
 </dl>
 </li>
 </ul>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/NormalizeNewlines.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/NormalizeNewlines.html 
b/builds/fm2.3.27/api/freemarker/template/utility/NormalizeNewlines.html
index d2d58b9..efcf5c4 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/NormalizeNewlines.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/NormalizeNewlines.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:02 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>NormalizeNewlines (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>NormalizeNewlines (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="NormalizeNewlines (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="NormalizeNewlines (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {
@@ -200,8 +200,7 @@ implements <a 
href="../../../freemarker/template/TemplateTransformModel.html" ti
 <td class="colFirst"><code><a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a 
href="../../../freemarker/template/utility/NormalizeNewlines.html#getWriter-java.io.Writer-java.util.Map-">getWriter</a></span>(<a
 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;out,
          <a 
href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&nbsp;args)</code>
-<div class="block">Returns a writer that will be used by the engine to feed the
- transformation input to the transform.</div>
+<div class="block">Returns a writer that will be used by the engine to feed 
the transformation input to the transform.</div>
 </td>
 </tr>
 <tr id="i1" class="rowColor">
@@ -259,26 +258,31 @@ implements <a 
href="../../../freemarker/template/TemplateTransformModel.html" ti
 <pre>public&nbsp;<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;getWriter(<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;out,
                         <a 
href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&nbsp;args)</pre>
 <div class="block"><span class="descfrmTypeLabel">Description copied from 
interface:&nbsp;<code><a 
href="../../../freemarker/template/TemplateTransformModel.html#getWriter-java.io.Writer-java.util.Map-">TemplateTransformModel</a></code></span></div>
-<div class="block">Returns a writer that will be used by the engine to feed the
- transformation input to the transform. Each call to this method
- must return a new instance of the writer so that the transformation
- is thread-safe.</div>
+<div class="block">Returns a writer that will be used by the engine to feed 
the transformation input to the transform. Each call to
+ this method must return a new instance of the writer so that the 
transformation is thread-safe.
+ <p>
+ This method should not throw <a 
href="http://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html?is-external=true";
 title="class or interface in java.lang"><code>RuntimeException</code></a>, nor 
<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true";
 title="class or interface in java.io"><code>IOException</code></a> that wasn't 
caused by writing to
+ the output. Such exceptions should be catched inside the method and wrapped 
inside a
+ <a href="../../../freemarker/template/TemplateModelException.html" 
title="class in freemarker.template"><code>TemplateModelException</code></a>. 
(Note that setting <a 
href="../../../freemarker/template/Configuration.html#setWrapUncheckedExceptions-boolean-"><code>Configuration.setWrapUncheckedExceptions(boolean)</code></a>
 to
+ <code>true</code> can mitigate the negative effects of implementations that 
throw <a 
href="http://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html?is-external=true";
 title="class or interface in 
java.lang"><code>RuntimeException</code></a>-s.)</div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
 <dd><code><a 
href="../../../freemarker/template/TemplateTransformModel.html#getWriter-java.io.Writer-java.util.Map-">getWriter</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../freemarker/template/TemplateTransformModel.html" 
title="interface in freemarker.template">TemplateTransformModel</a></code></dd>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>out</code> - the character stream to which to write the transformed 
output</dd>
-<dd><code>args</code> - the arguments (if any) passed to the transformation as 
a 
- map of key/value pairs where the keys are strings and the arguments are
- TemplateModel instances. This is never null. If you need to convert the
- template models to POJOs, you can use the utility methods in the 
- <a href="../../../freemarker/template/utility/DeepUnwrap.html" title="class 
in freemarker.template.utility"><code>DeepUnwrap</code></a> class.</dd>
+<dd><code>args</code> - the arguments (if any) passed to the transformation as 
a map of key/value pairs where the keys are
+            strings and the arguments are <a 
href="../../../freemarker/template/TemplateModel.html" title="interface in 
freemarker.template"><code>TemplateModel</code></a> instances. This is never 
<code>null</code>. (If you
+            need to convert the template models to POJOs, you can use the 
utility methods in the
+            <a href="../../../freemarker/template/utility/DeepUnwrap.html" 
title="class in freemarker.template.utility"><code>DeepUnwrap</code></a> class. 
Though it's recommended to work with <a 
href="../../../freemarker/template/TemplateModel.html" title="interface in 
freemarker.template"><code>TemplateModel</code></a>-s directly.)</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
-<dd>a writer to which the engine will feed the transformation 
- input, or null if the transform does not support nested content (body).
- The returned writer can implement the <a 
href="../../../freemarker/template/TransformControl.html" title="interface in 
freemarker.template"><code>TransformControl</code></a>
- interface if it needs advanced control over the evaluation of the 
- transformation body.</dd>
+<dd>The <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> to which the 
engine will write the content to transform, or <code>null</code> if the
+         transform does not support nested content (body). The returned <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> may implements 
the
+         <a href="../../../freemarker/template/TransformControl.html" 
title="interface in freemarker.template"><code>TransformControl</code></a> 
interface if it needs advanced control over the evaluation of the nested
+         content. FreeMarker will call <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true#close--";
 title="class or interface in java.io"><code>Writer.close()</code></a> after 
the transform end-tag. <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true#close--";
 title="class or interface in java.io"><code>Writer.close()</code></a>
+         must not close the <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> received as the 
<code>out</code> parameter (so if you are using a
+         <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/FilterWriter.html?is-external=true";
 title="class or interface in java.io"><code>FilterWriter</code></a>, you must 
override <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/FilterWriter.html?is-external=true#close--";
 title="class or interface in java.io"><code>FilterWriter.close()</code></a>, 
as by default that closes the
+         wrapped <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a>). Since 2.3.27 
its also allowed to return the <code>out</code> writer as is, in which
+         case it won't be closed.</dd>
 </dl>
 </li>
 </ul>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/NullArgumentException.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/NullArgumentException.html 
b/builds/fm2.3.27/api/freemarker/template/utility/NullArgumentException.html
index 6a01d0d..4b67ecb 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/NullArgumentException.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/NullArgumentException.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:02 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>NullArgumentException (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>NullArgumentException (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="NullArgumentException (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="NullArgumentException (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/NullWriter.html
----------------------------------------------------------------------
diff --git a/builds/fm2.3.27/api/freemarker/template/utility/NullWriter.html 
b/builds/fm2.3.27/api/freemarker/template/utility/NullWriter.html
index b9e3c43..d3aaebc 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/NullWriter.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/NullWriter.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>NullWriter (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>NullWriter (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="NullWriter (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="NullWriter (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/NumberUtil.html
----------------------------------------------------------------------
diff --git a/builds/fm2.3.27/api/freemarker/template/utility/NumberUtil.html 
b/builds/fm2.3.27/api/freemarker/template/utility/NumberUtil.html
index 82aa53e..72e6826 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/NumberUtil.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/NumberUtil.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>NumberUtil (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>NumberUtil (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="NumberUtil (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="NumberUtil (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/ObjectConstructor.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/ObjectConstructor.html 
b/builds/fm2.3.27/api/freemarker/template/utility/ObjectConstructor.html
index fcc17ea..e483ce7 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/ObjectConstructor.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/ObjectConstructor.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>ObjectConstructor (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>ObjectConstructor (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="ObjectConstructor (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="ObjectConstructor (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/ObjectFactory.html
----------------------------------------------------------------------
diff --git a/builds/fm2.3.27/api/freemarker/template/utility/ObjectFactory.html 
b/builds/fm2.3.27/api/freemarker/template/utility/ObjectFactory.html
index 1a40d98..2b23b89 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/ObjectFactory.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/ObjectFactory.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>ObjectFactory (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>ObjectFactory (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="ObjectFactory (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="ObjectFactory (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/ObjectWrapperWithAPISupport.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/ObjectWrapperWithAPISupport.html
 
b/builds/fm2.3.27/api/freemarker/template/utility/ObjectWrapperWithAPISupport.html
index 89274d7..cc9632f 100644
--- 
a/builds/fm2.3.27/api/freemarker/template/utility/ObjectWrapperWithAPISupport.html
+++ 
b/builds/fm2.3.27/api/freemarker/template/utility/ObjectWrapperWithAPISupport.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>ObjectWrapperWithAPISupport (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>ObjectWrapperWithAPISupport (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="ObjectWrapperWithAPISupport (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="ObjectWrapperWithAPISupport (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/OptimizerUtil.html
----------------------------------------------------------------------
diff --git a/builds/fm2.3.27/api/freemarker/template/utility/OptimizerUtil.html 
b/builds/fm2.3.27/api/freemarker/template/utility/OptimizerUtil.html
index b7d3122..a05734d 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/OptimizerUtil.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/OptimizerUtil.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>OptimizerUtil (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>OptimizerUtil (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="OptimizerUtil (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="OptimizerUtil (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/RichObjectWrapper.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/RichObjectWrapper.html 
b/builds/fm2.3.27/api/freemarker/template/utility/RichObjectWrapper.html
index e7dc600..4e46798 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/RichObjectWrapper.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/RichObjectWrapper.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>RichObjectWrapper (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>RichObjectWrapper (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="RichObjectWrapper (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="RichObjectWrapper (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/SecurityUtilities.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/SecurityUtilities.html 
b/builds/fm2.3.27/api/freemarker/template/utility/SecurityUtilities.html
index 3836572..5b3e797 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/SecurityUtilities.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/SecurityUtilities.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>SecurityUtilities (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>SecurityUtilities (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="SecurityUtilities (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="SecurityUtilities (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/StandardCompress.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/StandardCompress.html 
b/builds/fm2.3.27/api/freemarker/template/utility/StandardCompress.html
index 5207acd..03ff408 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/StandardCompress.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/StandardCompress.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>StandardCompress (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>StandardCompress (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="StandardCompress (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="StandardCompress (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {
@@ -224,8 +224,7 @@ implements <a 
href="../../../freemarker/template/TemplateTransformModel.html" ti
 <td class="colFirst"><code><a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a 
href="../../../freemarker/template/utility/StandardCompress.html#getWriter-java.io.Writer-java.util.Map-">getWriter</a></span>(<a
 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;out,
          <a 
href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&nbsp;args)</code>
-<div class="block">Returns a writer that will be used by the engine to feed the
- transformation input to the transform.</div>
+<div class="block">Returns a writer that will be used by the engine to feed 
the transformation input to the transform.</div>
 </td>
 </tr>
 </table>
@@ -307,28 +306,33 @@ implements <a 
href="../../../freemarker/template/TemplateTransformModel.html" ti
                         <a 
href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&nbsp;args)
                  throws <a 
href="../../../freemarker/template/TemplateModelException.html" title="class in 
freemarker.template">TemplateModelException</a></pre>
 <div class="block"><span class="descfrmTypeLabel">Description copied from 
interface:&nbsp;<code><a 
href="../../../freemarker/template/TemplateTransformModel.html#getWriter-java.io.Writer-java.util.Map-">TemplateTransformModel</a></code></span></div>
-<div class="block">Returns a writer that will be used by the engine to feed the
- transformation input to the transform. Each call to this method
- must return a new instance of the writer so that the transformation
- is thread-safe.</div>
+<div class="block">Returns a writer that will be used by the engine to feed 
the transformation input to the transform. Each call to
+ this method must return a new instance of the writer so that the 
transformation is thread-safe.
+ <p>
+ This method should not throw <a 
href="http://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html?is-external=true";
 title="class or interface in java.lang"><code>RuntimeException</code></a>, nor 
<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true";
 title="class or interface in java.io"><code>IOException</code></a> that wasn't 
caused by writing to
+ the output. Such exceptions should be catched inside the method and wrapped 
inside a
+ <a href="../../../freemarker/template/TemplateModelException.html" 
title="class in freemarker.template"><code>TemplateModelException</code></a>. 
(Note that setting <a 
href="../../../freemarker/template/Configuration.html#setWrapUncheckedExceptions-boolean-"><code>Configuration.setWrapUncheckedExceptions(boolean)</code></a>
 to
+ <code>true</code> can mitigate the negative effects of implementations that 
throw <a 
href="http://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html?is-external=true";
 title="class or interface in 
java.lang"><code>RuntimeException</code></a>-s.)</div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
 <dd><code><a 
href="../../../freemarker/template/TemplateTransformModel.html#getWriter-java.io.Writer-java.util.Map-">getWriter</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../freemarker/template/TemplateTransformModel.html" 
title="interface in freemarker.template">TemplateTransformModel</a></code></dd>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>out</code> - the character stream to which to write the transformed 
output</dd>
-<dd><code>args</code> - the arguments (if any) passed to the transformation as 
a 
- map of key/value pairs where the keys are strings and the arguments are
- TemplateModel instances. This is never null. If you need to convert the
- template models to POJOs, you can use the utility methods in the 
- <a href="../../../freemarker/template/utility/DeepUnwrap.html" title="class 
in freemarker.template.utility"><code>DeepUnwrap</code></a> class.</dd>
+<dd><code>args</code> - the arguments (if any) passed to the transformation as 
a map of key/value pairs where the keys are
+            strings and the arguments are <a 
href="../../../freemarker/template/TemplateModel.html" title="interface in 
freemarker.template"><code>TemplateModel</code></a> instances. This is never 
<code>null</code>. (If you
+            need to convert the template models to POJOs, you can use the 
utility methods in the
+            <a href="../../../freemarker/template/utility/DeepUnwrap.html" 
title="class in freemarker.template.utility"><code>DeepUnwrap</code></a> class. 
Though it's recommended to work with <a 
href="../../../freemarker/template/TemplateModel.html" title="interface in 
freemarker.template"><code>TemplateModel</code></a>-s directly.)</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
-<dd>a writer to which the engine will feed the transformation 
- input, or null if the transform does not support nested content (body).
- The returned writer can implement the <a 
href="../../../freemarker/template/TransformControl.html" title="interface in 
freemarker.template"><code>TransformControl</code></a>
- interface if it needs advanced control over the evaluation of the 
- transformation body.</dd>
+<dd>The <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> to which the 
engine will write the content to transform, or <code>null</code> if the
+         transform does not support nested content (body). The returned <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> may implements 
the
+         <a href="../../../freemarker/template/TransformControl.html" 
title="interface in freemarker.template"><code>TransformControl</code></a> 
interface if it needs advanced control over the evaluation of the nested
+         content. FreeMarker will call <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true#close--";
 title="class or interface in java.io"><code>Writer.close()</code></a> after 
the transform end-tag. <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true#close--";
 title="class or interface in java.io"><code>Writer.close()</code></a>
+         must not close the <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> received as the 
<code>out</code> parameter (so if you are using a
+         <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/FilterWriter.html?is-external=true";
 title="class or interface in java.io"><code>FilterWriter</code></a>, you must 
override <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/FilterWriter.html?is-external=true#close--";
 title="class or interface in java.io"><code>FilterWriter.close()</code></a>, 
as by default that closes the
+         wrapped <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a>). Since 2.3.27 
its also allowed to return the <code>out</code> writer as is, in which
+         case it won't be closed.</dd>
 <dt><span class="throwsLabel">Throws:</span></dt>
-<dd><code><a href="../../../freemarker/template/TemplateModelException.html" 
title="class in freemarker.template">TemplateModelException</a></code></dd>
+<dd><code><a href="../../../freemarker/template/TemplateModelException.html" 
title="class in freemarker.template">TemplateModelException</a></code> - If any 
problem occurs that's not an <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true";
 title="class or interface in java.io"><code>IOException</code></a> during 
writing the template output.</dd>
 </dl>
 </li>
 </ul>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/StringUtil.html
----------------------------------------------------------------------
diff --git a/builds/fm2.3.27/api/freemarker/template/utility/StringUtil.html 
b/builds/fm2.3.27/api/freemarker/template/utility/StringUtil.html
index b691b8a..63bd623 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/StringUtil.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/StringUtil.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>StringUtil (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>StringUtil (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="StringUtil (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="StringUtil (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/ToCanonical.html
----------------------------------------------------------------------
diff --git a/builds/fm2.3.27/api/freemarker/template/utility/ToCanonical.html 
b/builds/fm2.3.27/api/freemarker/template/utility/ToCanonical.html
index 35718c3..020359c 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/ToCanonical.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/ToCanonical.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>ToCanonical (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>ToCanonical (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="ToCanonical (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="ToCanonical (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/UndeclaredThrowableException.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/UndeclaredThrowableException.html
 
b/builds/fm2.3.27/api/freemarker/template/utility/UndeclaredThrowableException.html
index ea06e7b..ffb5498 100644
--- 
a/builds/fm2.3.27/api/freemarker/template/utility/UndeclaredThrowableException.html
+++ 
b/builds/fm2.3.27/api/freemarker/template/utility/UndeclaredThrowableException.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>UndeclaredThrowableException (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>UndeclaredThrowableException (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="UndeclaredThrowableException (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="UndeclaredThrowableException (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/UnrecognizedTimeZoneException.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/UnrecognizedTimeZoneException.html
 
b/builds/fm2.3.27/api/freemarker/template/utility/UnrecognizedTimeZoneException.html
index 835590c..d3a8309 100644
--- 
a/builds/fm2.3.27/api/freemarker/template/utility/UnrecognizedTimeZoneException.html
+++ 
b/builds/fm2.3.27/api/freemarker/template/utility/UnrecognizedTimeZoneException.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>UnrecognizedTimeZoneException (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>UnrecognizedTimeZoneException (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="UnrecognizedTimeZoneException (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="UnrecognizedTimeZoneException (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/UnsupportedNumberClassException.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/UnsupportedNumberClassException.html
 
b/builds/fm2.3.27/api/freemarker/template/utility/UnsupportedNumberClassException.html
index 835b0b9..27fb1e5 100644
--- 
a/builds/fm2.3.27/api/freemarker/template/utility/UnsupportedNumberClassException.html
+++ 
b/builds/fm2.3.27/api/freemarker/template/utility/UnsupportedNumberClassException.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>UnsupportedNumberClassException (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>UnsupportedNumberClassException (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="UnsupportedNumberClassException (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="UnsupportedNumberClassException (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/WriteProtectable.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/WriteProtectable.html 
b/builds/fm2.3.27/api/freemarker/template/utility/WriteProtectable.html
index 663e2ef..07b5104 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/WriteProtectable.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/WriteProtectable.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>WriteProtectable (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>WriteProtectable (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="WriteProtectable (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="WriteProtectable (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/XmlEscape.html
----------------------------------------------------------------------
diff --git a/builds/fm2.3.27/api/freemarker/template/utility/XmlEscape.html 
b/builds/fm2.3.27/api/freemarker/template/utility/XmlEscape.html
index 73ec802..f244cad 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/XmlEscape.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/XmlEscape.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:11 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>XmlEscape (FreeMarker 2.3.27-nightly_20170920T164139Z-incubating 
API)</title>
-<meta name="date" content="2017-09-20">
+<title>XmlEscape (FreeMarker 2.3.27-nightly_20171002T091443Z-incubating 
API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="XmlEscape (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="XmlEscape (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {
@@ -176,8 +176,7 @@ implements <a 
href="../../../freemarker/template/TemplateTransformModel.html" ti
 <td class="colFirst"><code><a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a 
href="../../../freemarker/template/utility/XmlEscape.html#getWriter-java.io.Writer-java.util.Map-">getWriter</a></span>(<a
 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;out,
          <a 
href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&nbsp;args)</code>
-<div class="block">Returns a writer that will be used by the engine to feed the
- transformation input to the transform.</div>
+<div class="block">Returns a writer that will be used by the engine to feed 
the transformation input to the transform.</div>
 </td>
 </tr>
 </table>
@@ -228,26 +227,31 @@ implements <a 
href="../../../freemarker/template/TemplateTransformModel.html" ti
 <pre>public&nbsp;<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;getWriter(<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io">Writer</a>&nbsp;out,
                         <a 
href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&nbsp;args)</pre>
 <div class="block"><span class="descfrmTypeLabel">Description copied from 
interface:&nbsp;<code><a 
href="../../../freemarker/template/TemplateTransformModel.html#getWriter-java.io.Writer-java.util.Map-">TemplateTransformModel</a></code></span></div>
-<div class="block">Returns a writer that will be used by the engine to feed the
- transformation input to the transform. Each call to this method
- must return a new instance of the writer so that the transformation
- is thread-safe.</div>
+<div class="block">Returns a writer that will be used by the engine to feed 
the transformation input to the transform. Each call to
+ this method must return a new instance of the writer so that the 
transformation is thread-safe.
+ <p>
+ This method should not throw <a 
href="http://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html?is-external=true";
 title="class or interface in java.lang"><code>RuntimeException</code></a>, nor 
<a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true";
 title="class or interface in java.io"><code>IOException</code></a> that wasn't 
caused by writing to
+ the output. Such exceptions should be catched inside the method and wrapped 
inside a
+ <a href="../../../freemarker/template/TemplateModelException.html" 
title="class in freemarker.template"><code>TemplateModelException</code></a>. 
(Note that setting <a 
href="../../../freemarker/template/Configuration.html#setWrapUncheckedExceptions-boolean-"><code>Configuration.setWrapUncheckedExceptions(boolean)</code></a>
 to
+ <code>true</code> can mitigate the negative effects of implementations that 
throw <a 
href="http://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html?is-external=true";
 title="class or interface in 
java.lang"><code>RuntimeException</code></a>-s.)</div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
 <dd><code><a 
href="../../../freemarker/template/TemplateTransformModel.html#getWriter-java.io.Writer-java.util.Map-">getWriter</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../freemarker/template/TemplateTransformModel.html" 
title="interface in freemarker.template">TemplateTransformModel</a></code></dd>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>out</code> - the character stream to which to write the transformed 
output</dd>
-<dd><code>args</code> - the arguments (if any) passed to the transformation as 
a 
- map of key/value pairs where the keys are strings and the arguments are
- TemplateModel instances. This is never null. If you need to convert the
- template models to POJOs, you can use the utility methods in the 
- <a href="../../../freemarker/template/utility/DeepUnwrap.html" title="class 
in freemarker.template.utility"><code>DeepUnwrap</code></a> class.</dd>
+<dd><code>args</code> - the arguments (if any) passed to the transformation as 
a map of key/value pairs where the keys are
+            strings and the arguments are <a 
href="../../../freemarker/template/TemplateModel.html" title="interface in 
freemarker.template"><code>TemplateModel</code></a> instances. This is never 
<code>null</code>. (If you
+            need to convert the template models to POJOs, you can use the 
utility methods in the
+            <a href="../../../freemarker/template/utility/DeepUnwrap.html" 
title="class in freemarker.template.utility"><code>DeepUnwrap</code></a> class. 
Though it's recommended to work with <a 
href="../../../freemarker/template/TemplateModel.html" title="interface in 
freemarker.template"><code>TemplateModel</code></a>-s directly.)</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
-<dd>a writer to which the engine will feed the transformation 
- input, or null if the transform does not support nested content (body).
- The returned writer can implement the <a 
href="../../../freemarker/template/TransformControl.html" title="interface in 
freemarker.template"><code>TransformControl</code></a>
- interface if it needs advanced control over the evaluation of the 
- transformation body.</dd>
+<dd>The <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> to which the 
engine will write the content to transform, or <code>null</code> if the
+         transform does not support nested content (body). The returned <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> may implements 
the
+         <a href="../../../freemarker/template/TransformControl.html" 
title="interface in freemarker.template"><code>TransformControl</code></a> 
interface if it needs advanced control over the evaluation of the nested
+         content. FreeMarker will call <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true#close--";
 title="class or interface in java.io"><code>Writer.close()</code></a> after 
the transform end-tag. <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true#close--";
 title="class or interface in java.io"><code>Writer.close()</code></a>
+         must not close the <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a> received as the 
<code>out</code> parameter (so if you are using a
+         <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/FilterWriter.html?is-external=true";
 title="class or interface in java.io"><code>FilterWriter</code></a>, you must 
override <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/FilterWriter.html?is-external=true#close--";
 title="class or interface in java.io"><code>FilterWriter.close()</code></a>, 
as by default that closes the
+         wrapped <a 
href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true";
 title="class or interface in java.io"><code>Writer</code></a>). Since 2.3.27 
its also allowed to return the <code>out</code> writer as is, in which
+         case it won't be closed.</dd>
 </dl>
 </li>
 </ul>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/class-use/CaptureOutput.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/CaptureOutput.html 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/CaptureOutput.html
index c153ee5..00373ce 100644
--- 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/CaptureOutput.html
+++ 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/CaptureOutput.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:04 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:12 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Uses of Class freemarker.template.utility.CaptureOutput (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>Uses of Class freemarker.template.utility.CaptureOutput (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Uses of Class 
freemarker.template.utility.CaptureOutput (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="Uses of Class 
freemarker.template.utility.CaptureOutput (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/class-use/ClassUtil.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/ClassUtil.html 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/ClassUtil.html
index d738be0..7d60576 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/class-use/ClassUtil.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/class-use/ClassUtil.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:04 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:12 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Uses of Class freemarker.template.utility.ClassUtil (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>Uses of Class freemarker.template.utility.ClassUtil (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Uses of Class 
freemarker.template.utility.ClassUtil (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="Uses of Class 
freemarker.template.utility.ClassUtil (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/class-use/CollectionUtils.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/CollectionUtils.html
 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/CollectionUtils.html
index c8d8421..6e42924 100644
--- 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/CollectionUtils.html
+++ 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/CollectionUtils.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:04 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:12 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Uses of Class freemarker.template.utility.CollectionUtils (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>Uses of Class freemarker.template.utility.CollectionUtils (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Uses of Class 
freemarker.template.utility.CollectionUtils (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="Uses of Class 
freemarker.template.utility.CollectionUtils (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/class-use/Collections12.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/Collections12.html 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/Collections12.html
index 2e7f487..9a4a97f 100644
--- 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/Collections12.html
+++ 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/Collections12.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:04 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:12 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Uses of Class freemarker.template.utility.Collections12 (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>Uses of Class freemarker.template.utility.Collections12 (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Uses of Class 
freemarker.template.utility.Collections12 (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="Uses of Class 
freemarker.template.utility.Collections12 (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/class-use/Constants.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/Constants.html 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/Constants.html
index ca59268..bcf802c 100644
--- a/builds/fm2.3.27/api/freemarker/template/utility/class-use/Constants.html
+++ b/builds/fm2.3.27/api/freemarker/template/utility/class-use/Constants.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:04 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:12 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Uses of Class freemarker.template.utility.Constants (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>Uses of Class freemarker.template.utility.Constants (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Uses of Class 
freemarker.template.utility.Constants (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="Uses of Class 
freemarker.template.utility.Constants (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/class-use/DOMNodeModel.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/DOMNodeModel.html 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/DOMNodeModel.html
index 432309b..7af134c 100644
--- 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/DOMNodeModel.html
+++ 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/DOMNodeModel.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:12 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Uses of Class freemarker.template.utility.DOMNodeModel (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>Uses of Class freemarker.template.utility.DOMNodeModel (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Uses of Class 
freemarker.template.utility.DOMNodeModel (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="Uses of Class 
freemarker.template.utility.DOMNodeModel (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/class-use/DateUtil.CalendarFieldsToDateConverter.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/DateUtil.CalendarFieldsToDateConverter.html
 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/DateUtil.CalendarFieldsToDateConverter.html
index 604e0b6..c63b4e0 100644
--- 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/DateUtil.CalendarFieldsToDateConverter.html
+++ 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/DateUtil.CalendarFieldsToDateConverter.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:03 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:12 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Uses of Interface 
freemarker.template.utility.DateUtil.CalendarFieldsToDateConverter (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>Uses of Interface 
freemarker.template.utility.DateUtil.CalendarFieldsToDateConverter (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Uses of Interface 
freemarker.template.utility.DateUtil.CalendarFieldsToDateConverter (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="Uses of Interface 
freemarker.template.utility.DateUtil.CalendarFieldsToDateConverter (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/adf1918e/builds/fm2.3.27/api/freemarker/template/utility/class-use/DateUtil.DateParseException.html
----------------------------------------------------------------------
diff --git 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/DateUtil.DateParseException.html
 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/DateUtil.DateParseException.html
index f53c5da..375da84 100644
--- 
a/builds/fm2.3.27/api/freemarker/template/utility/class-use/DateUtil.DateParseException.html
+++ 
b/builds/fm2.3.27/api/freemarker/template/utility/class-use/DateUtil.DateParseException.html
@@ -2,10 +2,10 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_144) on Wed Sep 20 18:42:04 CEST 2017 -->
+<!-- Generated by javadoc (1.8.0_144) on Mon Oct 02 11:15:12 CEST 2017 -->
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Uses of Class freemarker.template.utility.DateUtil.DateParseException 
(FreeMarker 2.3.27-nightly_20170920T164139Z-incubating API)</title>
-<meta name="date" content="2017-09-20">
+<title>Uses of Class freemarker.template.utility.DateUtil.DateParseException 
(FreeMarker 2.3.27-nightly_20171002T091443Z-incubating API)</title>
+<meta name="date" content="2017-10-02">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" 
title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>
@@ -13,7 +13,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Uses of Class 
freemarker.template.utility.DateUtil.DateParseException (FreeMarker 
2.3.27-nightly_20170920T164139Z-incubating API)";
+            parent.document.title="Uses of Class 
freemarker.template.utility.DateUtil.DateParseException (FreeMarker 
2.3.27-nightly_20171002T091443Z-incubating API)";
         }
     }
     catch(err) {

Reply via email to