freemarker-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ddek...@apache.org
Subject [12/29] incubator-freemarker-site git commit: Updted 2.3.27 nightly docs
Date Mon, 02 Oct 2017 09:18:51 GMT
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) {


Mime
View raw message