http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_macro.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_macro.html b/docs/ref_directive_macro.html
index 9c385ce..1f3d359 100644
--- a/docs/ref_directive_macro.html
+++ b/docs/ref_directive_macro.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_macro.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","macro, nested, return"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_local.html"><span>Previous</span></a><a class="paging-arrow 
next" href="ref_directive_noautoesc.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_macro" 
itemprop="headline">macro, nested, return</h1>
@@ -447,9 +442,9 @@ ga('send', 'pageview');
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_noautoesc.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_noautoesc.html 
b/docs/ref_directive_noautoesc.html
index 484ba8a..0cd8f2e 100644
--- a/docs/ref_directive_noautoesc.html
+++ b/docs/ref_directive_noautoesc.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_noautoesc.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","noautoesc"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_macro.html"><span>Previous</span></a><a class="paging-arrow 
next" href="ref_directive_noparse.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_noautoesc" 
itemprop="headline">noautoesc</h1>
@@ -120,9 +115,9 @@ ${&quot;&amp;&quot;}</pre></div>
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_noparse.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_noparse.html b/docs/ref_directive_noparse.html
index 1dbd3b4..508659f 100644
--- a/docs/ref_directive_noparse.html
+++ b/docs/ref_directive_noparse.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_noparse.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","noparse"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_noautoesc.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="ref_directive_nt.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_noparse" 
itemprop="headline">noparse</h1>
@@ -102,9 +97,9 @@ ga('send', 'pageview');
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_nt.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_nt.html b/docs/ref_directive_nt.html
index ba9880f..e03b6e1 100644
--- a/docs/ref_directive_nt.html
+++ b/docs/ref_directive_nt.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_nt.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","nt"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_noparse.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="ref_directive_outputformat.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_nt" 
itemprop="headline">nt</h1>
@@ -77,9 +72,9 @@ ga('send', 'pageview');
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_outputformat.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_outputformat.html 
b/docs/ref_directive_outputformat.html
index 96e568a..e172b59 100644
--- a/docs/ref_directive_outputformat.html
+++ b/docs/ref_directive_outputformat.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_outputformat.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","outputformat"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_nt.html"><span>Previous</span></a><a class="paging-arrow 
next" href="ref_directive_setting.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_outputformat" 
itemprop="headline">outputformat</h1>
@@ -191,9 +186,9 @@ ${&quot;&#39;{}&quot;}
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_setting.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_setting.html b/docs/ref_directive_setting.html
index 32fc9d4..04472ae 100644
--- a/docs/ref_directive_setting.html
+++ b/docs/ref_directive_setting.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_setting.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","setting"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_outputformat.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="ref_directive_stop.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_setting" 
itemprop="headline">setting</h1>
@@ -207,6 +202,19 @@ ga('send', 'pageview');
                   <code class="inline-code">&quot;MM/dd/yyyy hh:mm:ss 
a&quot;</code> (where
                   <code class="inline-code">&quot;a&quot;</code> prints AM or 
PM, if the current
                   language is English).</p>
+
+                    <div class="callout warning">
+    <strong class="callout-label">Warning!</strong>
+
+                    <p>Be careful <em>not</em> to use
+                    <code class="inline-code">YYYY</code> (upper case, means 
"week
+                    year") instead of <code class="inline-code">yyyy</code> 
(lower
+                    case, means year)! It&#39;s an easy mistake to do, and 
hard to
+                    notice during testing, as "week year" only
+                    differs from "year" near the edge of
+                    years.</p>
+                    </div>
+
                 </li>
 
                 <li>
@@ -388,9 +396,12 @@ ga('send', 'pageview');
 
             <li>
               <p><code class="inline-code">time_zone</code>: The name of the 
time
-              zone used to format times for display. By default, the default
-              time zone of the JVM is used. Can be any value that is accepted
-              by <a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/TimeZone.html";>Java
+              zone used to format times for display. As with all settings, the
+              default is chosen by the programmers when they set up FreeMarker
+              (<span class="marked-for-programmers">via the
+              <code class="inline-code">Configuration</code> class</span>), 
but it&#39;s most
+              often the default time zone of the JVM. Can be any value that is
+              accepted by <a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/TimeZone.html";>Java
               TimeZone API</a>, or <code class="inline-code">&quot;JVM 
default&quot;</code> (since
               FreeMarker 2.3.21) to use the JVM default time zone. Examples:
               <code class="inline-code">&quot;GMT&quot;</code>, <code 
class="inline-code">&quot;GMT+2&quot;</code>,
@@ -442,14 +453,15 @@ ga('send', 'pageview');
               outputs a stream of UNICODE characters (<span 
class="marked-for-programmers">it writes into a
               <code class="inline-code">java.io.Writer</code></span>), 
it&#39;s not affected
               by the output encoding, but some macros/functions and built-ins
-              may want to used this information.</p>
+              may want to use this information.</p>
             </li>
 
             <li>
-              <p><code class="inline-code">classic_compatible</code>: This is 
for
-              experts. Its value should be a boolean. See the documentation of
-              <code 
class="inline-code">freemarker.template.Configurable</code> for more
-              information.</p>
+              <p><code class="inline-code">classic_compatible</code>: Used for
+              better compatibility with very old FreeMarker versions (mostly
+              1.7.x). See the documentation of
+              <code 
class="inline-code">freemarker.template.Configurable.isClassicCompatible()</code>
+              for more information.</p>
             </li>
           </ul>
 
@@ -475,9 +487,9 @@ ${1.2}</pre></div>
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_stop.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_stop.html b/docs/ref_directive_stop.html
index 7286c7b..a1f5ea1 100644
--- a/docs/ref_directive_stop.html
+++ b/docs/ref_directive_stop.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_stop.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","stop"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_setting.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="ref_directive_switch.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_stop" 
itemprop="headline">stop</h1>
@@ -93,9 +88,9 @@ or
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_switch.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_switch.html b/docs/ref_directive_switch.html
index 95ec077..24994b2 100644
--- a/docs/ref_directive_switch.html
+++ b/docs/ref_directive_switch.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_switch.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","switch, case, default, break"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_stop.html"><span>Previous</span></a><a class="paging-arrow 
next" href="ref_directive_t.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_switch" 
itemprop="headline">switch, case, default, break</h1>
@@ -159,9 +154,9 @@ ga('send', 'pageview');
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_t.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_t.html b/docs/ref_directive_t.html
index 8499259..156c643 100644
--- a/docs/ref_directive_t.html
+++ b/docs/ref_directive_t.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_t.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","t, lt, rt"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_switch.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="ref_directive_userDefined.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_t" 
itemprop="headline">t, lt, rt</h1>
@@ -146,9 +141,9 @@ ga('send', 'pageview');
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_userDefined.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_userDefined.html 
b/docs/ref_directive_userDefined.html
index 133f58e..b65878f 100644
--- a/docs/ref_directive_userDefined.html
+++ b/docs/ref_directive_userDefined.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_userDefined.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","User-defined directive (<@...>)"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_t.html"><span>Previous</span></a><a class="paging-arrow 
next" href="ref_directive_visit.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_userDefined" 
itemprop="headline">User-defined directive (&lt;@...&gt;)</h1>
@@ -294,9 +289,9 @@ Or all above but with positional parameter passing (<a 
href="#ref_directive_user
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directive_visit.html
----------------------------------------------------------------------
diff --git a/docs/ref_directive_visit.html b/docs/ref_directive_visit.html
index 1c4081a..636930f 100644
--- a/docs/ref_directive_visit.html
+++ b/docs/ref_directive_visit.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directive_visit.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference","visit, recurse, fallback"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_userDefined.html"><span>Previous</span></a><a 
class="paging-arrow next" 
href="ref_specvar.html"><span>Next</span></a></div><div class="title-wrapper">
 <h1 class="content-header header-section1" id="ref_directive_visit" 
itemprop="headline">visit, recurse, fallback</h1>
@@ -381,9 +376,9 @@ There was no specific handler for node y
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_directives.html
----------------------------------------------------------------------
diff --git a/docs/ref_directives.html b/docs/ref_directives.html
index cace803..d771cde 100644
--- a/docs/ref_directives.html
+++ b/docs/ref_directives.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_directives.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Directive Reference"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_builtins_expert.html"><span>Previous</span></a><a class="paging-arrow 
next" href="ref_directive_alphaidx.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-chapter" id="ref_directives" 
itemprop="headline">Directive Reference</h1>
@@ -51,9 +46,9 @@ ga('send', 'pageview');
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_reservednames.html
----------------------------------------------------------------------
diff --git a/docs/ref_reservednames.html b/docs/ref_reservednames.html
index 233296b..ef716db 100644
--- a/docs/ref_reservednames.html
+++ b/docs/ref_reservednames.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_reservednames.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Reserved names in FTL"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_specvar.html"><span>Previous</span></a><a class="paging-arrow next" 
href="ref_deprecated.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-chapter" id="ref_reservednames" 
itemprop="headline">Reserved names in FTL</h1>
@@ -93,9 +88,9 @@ ga('send', 'pageview');
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

http://git-wip-us.apache.org/repos/asf/freemarker-site/blob/e3ae7133/docs/ref_specvar.html
----------------------------------------------------------------------
diff --git a/docs/ref_specvar.html b/docs/ref_specvar.html
index da4fce0..7b7ba32 100644
--- a/docs/ref_specvar.html
+++ b/docs/ref_specvar.html
@@ -14,7 +14,7 @@
 <link rel="canonical" 
href="https://freemarker.apache.org/docs/ref_specvar.html";>
 <link rel="icon" href="favicon.png" type="image/png">
 <link rel="stylesheet" type="text/css" 
href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1510568240191">
+<link rel="stylesheet" type="text/css" 
href="docgen-resources/docgen.min.css?1522915944172">
 <script>
 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,13 +35,8 @@ ga('send', 'pageview');
       <div class="content-wrapper">
   <div id="table-of-contents-wrapper" class="col-left">
       <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language 
Reference","Special Variable Reference"];</script>
-      <script src="toc.js?1510568240191"></script>
-      <script src="docgen-resources/main.min.js?1510568240191"></script>
-      <div class="side-toc-logos">
-          <div class="side-toc-logo">
-            <a href="http://incubator.apache.org/"; target="_blank"><img 
src="apache-incubator.png" alt="Apache Incubator" /></a>
-          </div>
-      </div>
+      <script src="toc.js?1522915944172"></script>
+      <script src="docgen-resources/main.min.js?1522915944172"></script>
   </div>
 <div class="col-right"><div class="page-content"><div class="page-title"><div 
class="pagers top"><a class="paging-arrow previous" 
href="ref_directive_visit.html"><span>Previous</span></a><a class="paging-arrow 
next" href="ref_reservednames.html"><span>Next</span></a></div><div 
class="title-wrapper">
 <h1 class="content-header header-chapter" id="ref_specvar" 
itemprop="headline">Special Variable Reference</h1>
@@ -70,6 +65,24 @@ ga('send', 'pageview');
         </li>
 
         <li>
+          <a name="ref_specvar_caller_template_name"></a><code 
class="inline-code">caller_template_name</code> (available
+          since FreeMarker 2.3.28): Returns the name (path) of the template
+          from which the current <a 
href="ref_directive_macro.html#ref.directive.macro">macro</a> or <a 
href="ref_directive_function.html#ref.directive.function">function</a> was 
called. It&#39;s
+          mostly useful if you want to resolve paths relative to the caller
+          template (<a 
href="ref_builtins_expert.html#ref_builtin_absolute_template_name">see an
+          example here</a>). To serve that purpose better, if the caller
+          template is nameless, this will be an empty string (not a missing
+          value). Reading this variable will cause error if you aren&#39;t 
inside
+          a macro or function call. In particular, directives and
+          "methods" implemented in Java will not influence the
+          value of this variable; it&#39;s only for macros and functions
+          implemented in templates. (<span 
class="marked-for-programmers"><code 
class="inline-code">TemplateDirectiveModel</code>
+          implementations can get similar information via the
+          <code class="inline-code">freemarker.core.DirectiveCallPlace</code>
+          object.</span>)
+        </li>
+
+        <li>
           <code class="inline-code">current_template_name</code>: The name of
           the template where we are now (available since FreeMarker 2.3.23).
           This can be missing (<code class="inline-code">null</code>) if the 
template was
@@ -215,6 +228,14 @@ ga('send', 'pageview');
         </li>
 
         <li>
+          <code class="inline-code">get_optional_template</code>: This is a 
method
+          that&#39;s used when you need to include or import a template 
that&#39;s
+          possibly missing, and you need to handle that case on some special
+          way. <a href="#ref_specvar_get_optional_template">More
+          details...</a>
+        </li>
+
+        <li>
           <code class="inline-code">pass</code>: This is a macro that does 
nothing. It
           has no parameters. Mostly used as no-op node handler in XML
           processing.
@@ -283,13 +304,164 @@ ga('send', 'pageview');
           contains dash and further info after the numbers, like in
           2.3.21-nightly_20140726T151800Z.
         </li>
-      </ul><div class="bottom-pagers-wrapper"><div class="pagers bottom"><a 
class="paging-arrow previous" 
href="ref_directive_visit.html"><span>Previous</span></a><a class="paging-arrow 
next" 
href="ref_reservednames.html"><span>Next</span></a></div></div></div></div>     
 </div>
+      </ul>
+        
+
+
+
+<h2 class="content-header header-simplesect" 
id="ref_specvar_get_optional_template">Using get_optional_template</h2>
+
+
+        
+
+        
+
+        
+
+        <p>This special variable is used when you need to include or import
+        a template that&#39;s possibly missing, and you need to handle that 
case
+        on some special way. It a method (so you meant to call it) that has
+        the following parameters:</p>
+
+        <div class="orderedlist"><ol type="1">
+          <li>
+            <p>The name of the template (can be relative or absolute), like
+            <code class="inline-code">&quot;/commonds/footer.ftl&quot;</code>; 
similar to the first
+            parameter of the <a 
href="ref_directive_include.html#ref.directive.include"><code>include</code>
+            directive</a>. Required, string.</p>
+          </li>
+
+          <li>
+            <p>An optional hash of options, like <code class="inline-code">{ 
&#39;parse&#39;: false,
+            &#39;encoding&#39;: &#39;UTF-16BE&#39; }</code>. The valid keys are
+            <code class="inline-code">encoding</code> and <code 
class="inline-code">parse</code>. The
+            meaning of these are the same as of the similarly named <a 
href="ref_directive_include.html#ref.directive.include"><code>include</code>
+            directive</a> parameters.</p>
+          </li>
+        </ol></div>
+
+        <p>This method returns a hash that contains the following
+        entries:</p>
+
+        <ul>
+          <li>
+            <p><code class="inline-code">exists</code>: A boolean that tells 
if the
+            template was found.</p>
+          </li>
+
+          <li>
+            <p><code class="inline-code">include</code>: A directive that, 
when called,
+            includes the template. Calling this directive is similar to
+            calling the <a 
href="ref_directive_include.html#ref.directive.include"><code>include</code>
+            directive</a>, but of course with this you spare looking up the
+            template again. This directive has no parameters, nor nested
+            content. If <code class="inline-code">exists</code> is <code 
class="inline-code">false</code>,
+            this key will be missing; see later how can this be utilized with
+            <a 
href="dgui_template_exp.html#dgui_template_exp_missing_default">the
+            <code><em>exp</em>!<em>default</em></code>
+            operator</a>.</p>
+          </li>
+
+          <li>
+            <p><code class="inline-code">import</code>: A method that, when 
called,
+            imports the template, and returns the namespace of the imported
+            template. Calling this method is similar to calling the
+            <code class="inline-code">import</code> directive, but of course 
with this you
+            spare looking up the template again, also, it doesn&#39;t assign 
the
+            namespace to anything, just returns it. The method has no
+            parameters. If <code class="inline-code">exists</code> is
+            <code class="inline-code">false</code>, this key will be missing; 
see later how
+            can this be utilized with <a 
href="dgui_template_exp.html#dgui_template_exp_missing_default">the
+            <code><em>exp</em>!<em>default</em></code>
+            operator</a>.</p>
+          </li>
+        </ul>
+
+        <p>When this method is called (like
+        <code 
class="inline-code">.get_optional_template(&#39;some.ftl&#39;)</code>), it 
immediately
+        loads the template if it exists, but doesn&#39;t yet process it, so it
+        doesn&#39;t have any visible effect yet. The template will be processed
+        only when <code class="inline-code">include</code> or <code 
class="inline-code">import</code>
+        members of the returned structure is called. (Of course, when we say
+        that it loads the template, it actually looks it up in the template
+        cache, just like the <a 
href="ref_directive_include.html#ref.directive.include"><code>include</code>
+        directive</a> does.)</p>
+
+        <p>While it&#39;s not an error if the template is missing, it&#39;s an
+        error if it does exist but still can&#39;t be loaded due to syntactical
+        errors in it, or due to some I/O error.</p>
+
+          <div class="callout note">
+    <strong class="callout-label">Note:</strong>
+
+          <p>If the template fails with "I/O error when trying to
+          load optional template" when the template is missing, that&#39;s
+          often because your application uses a custom
+          <code class="inline-code">freemarker.cache.TemplateLoader</code> 
implementation,
+          which incorrectly (against the API documentation) throws an
+          <code class="inline-code">IOException</code> in the
+          <code class="inline-code">findTemplateSource</code> method instead 
of returning
+          <code class="inline-code">null</code> if a template is not found. If 
it&#39;s so, the
+          Java programmers need to fix that. Another possibility is of course
+          that it was indeed not possible to tell if the template exists or
+          not due to some technical issues, in which case stopping with error
+          is the correct behavior. See the cause
+          <code class="inline-code">IOException</code> in the Java stack trace 
to figure out
+          which case it is.</p>
+          </div>
+
+
+        <p>Example, in which depending on if <code 
class="inline-code">some.ftl</code>
+        exists, we either print "Template was found:" and the
+        include the template as <code class="inline-code">&lt;#include 
&#39;some.ftl&#39;&gt;</code>
+        would, otherwise it we print "Template was
+        missing.":</p>
+
+        
+
+<div class="code-wrapper"><pre class="code-block code-template">&lt;#assign 
optTemp = .get_optional_template(&#39;some.ftl&#39;)&gt;
+&lt;#if optTemp.exists&gt;
+  Template was found:
+  &lt;@optTemp.include /&gt;
+&lt;#else&gt;
+  Template was missing.
+&lt;/#if&gt;</pre></div>
+
+        <p>Example, in which we try to include <code 
class="inline-code">some.ftl</code>,
+        but if that&#39;s missing then we try to include
+        <code class="inline-code">some-fallback.ftl</code>, and if that&#39;s 
missing too then
+        we call the <code class="inline-code">ultimateFallback</code> macro 
instead of
+        including anything (note the <code class="inline-code">!</code>-s 
after the
+        <code class="inline-code">include</code>-s; they belong to <a 
href="dgui_template_exp.html#dgui_template_exp_missing_default">the
+        <code><em>exp</em>!<em>default</em></code>
+        operator</a>):</p>
+
+        
+
+<div class="code-wrapper"><pre class="code-block code-template">&lt;#macro 
ultimateFallback&gt;
+  Something
+&lt;/#macro&gt;
+
+&lt;@(
+  .get_optional_template(&#39;some.ftl&#39;).include!
+  .get_optional_template(&#39;some-fallback.ftl&#39;).include!
+  ultimateFallback
+) /&gt;</pre></div>
+
+        <p>Example, which behaves like <code class="inline-code">&lt;#import 
&#39;tags.ftl&#39; as
+        tags&gt;</code>, except that if <code 
class="inline-code">tags.ftl</code> is
+        missing, then it creates an empty <code 
class="inline-code">tags</code> hash:</p>
+
+        
+
+<div class="code-wrapper"><pre class="code-block code-template">&lt;#assign 
tags = (.get_optional_template(&#39;tags.ftl&#39;).import())!{}&gt;</pre></div>
+      <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a 
class="paging-arrow previous" 
href="ref_directive_visit.html"><span>Previous</span></a><a class="paging-arrow 
next" 
href="ref_reservednames.html"><span>Next</span></a></div></div></div></div>     
 </div>
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div 
class="col-left sitemap"><div class="column"><h3 
class="column-header">Overview</h3><ul><li><a 
href="https://freemarker.apache.org/";>What is FreeMarker?</a></li><li><a 
href="https://freemarker.apache.org/freemarkerdownload.html";>Download</a></li><li><a
 href="app_versions.html">Version history</a></li><li><a 
href="https://freemarker.apache.org/history.html";>About us</a></li><li><a 
itemprop="license" href="app_license.html">License</a></li></ul></div><div 
class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a 
href="http://try.freemarker.org/";>Try template online</a></li><li><a 
href="dgui_template_exp.html#exp_cheatsheet">Expressions 
cheatsheet</a></li><li><a 
href="ref_directive_alphaidx.html">#directives</a></li><li><a 
href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a 
href="ref_specvar.html">.special_vars</a></li></ul></div><div 
class="column"><h3 class="column-header">Community</h3><u
 l><li><a href="https://github.com/freemarker/freemarker";>FreeMarker on 
Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on 
Twitter</a></li><li><a 
href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a 
bug</a></li><li><a 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Ask a 
question</a></li><li><a 
href="https://freemarker.apache.org/mailing-lists.html";>Mailing 
lists</a></li></ul></div></div><div class="col-right"><ul 
class="social-icons"><li><a class="github" 
href="https://github.com/freemarker/freemarker";>Github</a></li><li><a 
class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a 
class="stack-overflow" 
href="https://stackoverflow.com/questions/ask?tags=freemarker";>Stack 
Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; 
rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind 
XML Editor</span></a></div></div><div class="footer-bottom"> <p 
class="last-generated">
 Last generated:
-<time itemprop="dateModified" datetime="2017-11-13T10:17:20Z" title="Monday, 
November 13, 2017 10:17:20 AM GMT">2017-11-13 10:17:20 GMT</time>, for 
Freemarker 2.3.27 </p>
+<time itemprop="dateModified" datetime="2018-04-05T08:12:24Z" title="Thursday, 
April 5, 2018 8:12:24 AM GMT">2018-04-05 08:12:24 GMT</time>, for Freemarker 
2.3.28 </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2017
+© <span itemprop="copyrightYear">1999</span>–2018
 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" 
href="https://apache.org/";>The Apache Software Foundation</a>. Apache 
FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo 
are trademarks of The Apache Software Foundation. All other marks mentioned may 
be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>

Reply via email to