You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@freemarker.apache.org by dd...@apache.org on 2016/07/05 20:11:38 UTC

[16/42] incubator-freemarker-site git commit: Update site for 2.3.25 (with Maven Central Repository problem warning)

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/bd8b9839/docs/dgui.html
----------------------------------------------------------------------
diff --git a/docs/dgui.html b/docs/dgui.html
index a6a15b4..4fbf209 100644
--- a/docs/dgui.html
+++ b/docs/dgui.html
@@ -44,8 +44,8 @@ ga('send', 'pageview');
 <div class="page-menu-title">Section Contents</div>
 <ul><li><a class="page-menu-link" href="dgui_quickstart.html" data-menu-target="dgui_quickstart">Getting Started</a><ul><li><a class="page-menu-link" href="dgui_quickstart_basics.html" data-menu-target="dgui_quickstart_basics">Template + data-model = output</a></li><li><a class="page-menu-link" href="dgui_quickstart_datamodel.html" data-menu-target="dgui_quickstart_datamodel">The data-model at a glance</a></li><li><a class="page-menu-link" href="dgui_quickstart_template.html" data-menu-target="dgui_quickstart_template">The template at a glance</a></li></ul></li><li><a class="page-menu-link" href="dgui_datamodel.html" data-menu-target="dgui_datamodel">Values, Types</a><ul><li><a class="page-menu-link" href="dgui_datamodel_basics.html" data-menu-target="dgui_datamodel_basics">Basics</a></li><li><a class="page-menu-link" href="dgui_datamodel_types.html" data-menu-target="dgui_datamodel_types">The types</a></li></ul></li><li><a class="page-menu-link" href="dgui_template.html" data-menu-
 target="dgui_template">The Template</a><ul><li><a class="page-menu-link" href="dgui_template_overallstructure.html" data-menu-target="dgui_template_overallstructure">Overall structure</a></li><li><a class="page-menu-link" href="dgui_template_directives.html" data-menu-target="dgui_template_directives">Directives</a></li><li><a class="page-menu-link" href="dgui_template_exp.html" data-menu-target="dgui_template_exp">Expressions</a></li><li><a class="page-menu-link" href="dgui_template_valueinsertion.html" data-menu-target="dgui_template_valueinsertion">Interpolations</a></li></ul></li><li><a class="page-menu-link" href="dgui_misc.html" data-menu-target="dgui_misc">Miscellaneous</a><ul><li><a class="page-menu-link" href="dgui_misc_userdefdir.html" data-menu-target="dgui_misc_userdefdir">Defining your own directives</a></li><li><a class="page-menu-link" href="dgui_misc_var.html" data-menu-target="dgui_misc_var">Defining variables in the template</a></li><li><a class="page-menu-link" hr
 ef="dgui_misc_namespace.html" data-menu-target="dgui_misc_namespace">Namespaces</a></li><li><a class="page-menu-link" href="dgui_misc_autoescaping.html" data-menu-target="dgui_misc_autoescaping">Auto-escaping and output formats</a></li><li><a class="page-menu-link" href="dgui_misc_whitespace.html" data-menu-target="dgui_misc_whitespace">White-space handling</a></li><li><a class="page-menu-link" href="dgui_misc_alternativesyntax.html" data-menu-target="dgui_misc_alternativesyntax">Alternative (square bracket) syntax</a></li></ul></li></ul> </div><div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="index.html"><span>Previous</span></a><a class="paging-arrow next" href="dgui_quickstart.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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.24</span><span class="last-updated"> Last generated:
-<time itemprop="dateModified" datetime="2016-03-28T15:17:13Z" title="Monday, March 28, 2016 3:17:13 PM GMT">2016-03-28 15:17:13 GMT</time></span></p> <p class="copyright">
+<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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.25</span><span class="last-updated"> Last generated:
+<time itemprop="dateModified" datetime="2016-07-05T19:17:27Z" title="Tuesday, July 5, 2016 7:17:27 PM GMT">2016-07-05 19:17:27 GMT</time></span></p> <p class="copyright">
 � <span itemprop="copyrightYear">1999</span>\u20132016
 <a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://freemarker.org">The Apache Software Foundation</a>. All rights reserved. </p>
 </div></div></div></body>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/bd8b9839/docs/dgui_datamodel.html
----------------------------------------------------------------------
diff --git a/docs/dgui_datamodel.html b/docs/dgui_datamodel.html
index 42e5ebc..8467fb0 100644
--- a/docs/dgui_datamodel.html
+++ b/docs/dgui_datamodel.html
@@ -44,8 +44,8 @@ ga('send', 'pageview');
 <div class="page-menu-title">Section Contents</div>
 <ul><li><a class="page-menu-link" href="dgui_datamodel_basics.html" data-menu-target="dgui_datamodel_basics">Basics</a></li><li><a class="page-menu-link" href="dgui_datamodel_types.html" data-menu-target="dgui_datamodel_types">The types</a></li></ul> </div><div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="dgui_quickstart_template.html"><span>Previous</span></a><a class="paging-arrow next" href="dgui_datamodel_basics.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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.24</span><span class="last-updated"> Last generated:
-<time itemprop="dateModified" datetime="2016-03-28T15:17:13Z" title="Monday, March 28, 2016 3:17:13 PM GMT">2016-03-28 15:17:13 GMT</time></span></p> <p class="copyright">
+<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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.25</span><span class="last-updated"> Last generated:
+<time itemprop="dateModified" datetime="2016-07-05T19:17:27Z" title="Tuesday, July 5, 2016 7:17:27 PM GMT">2016-07-05 19:17:27 GMT</time></span></p> <p class="copyright">
 � <span itemprop="copyrightYear">1999</span>\u20132016
 <a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://freemarker.org">The Apache Software Foundation</a>. All rights reserved. </p>
 </div></div></div></body>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/bd8b9839/docs/dgui_datamodel_basics.html
----------------------------------------------------------------------
diff --git a/docs/dgui_datamodel_basics.html b/docs/dgui_datamodel_basics.html
index 3698453..b39acb5 100644
--- a/docs/dgui_datamodel_basics.html
+++ b/docs/dgui_datamodel_basics.html
@@ -220,8 +220,8 @@ brown</pre></div>
           like a string or a number is.</p>
         <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="dgui_datamodel.html"><span>Previous</span></a><a class="paging-arrow next" href="dgui_datamodel_types.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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.24</span><span class="last-updated"> Last generated:
-<time itemprop="dateModified" datetime="2016-03-28T15:17:13Z" title="Monday, March 28, 2016 3:17:13 PM GMT">2016-03-28 15:17:13 GMT</time></span></p> <p class="copyright">
+<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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.25</span><span class="last-updated"> Last generated:
+<time itemprop="dateModified" datetime="2016-07-05T19:17:27Z" title="Tuesday, July 5, 2016 7:17:27 PM GMT">2016-07-05 19:17:27 GMT</time></span></p> <p class="copyright">
 � <span itemprop="copyrightYear">1999</span>\u20132016
 <a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://freemarker.org">The Apache Software Foundation</a>. All rights reserved. </p>
 </div></div></div></body>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/bd8b9839/docs/dgui_datamodel_types.html
----------------------------------------------------------------------
diff --git a/docs/dgui_datamodel_types.html b/docs/dgui_datamodel_types.html
index 5ca27b0..c3ad5ba 100644
--- a/docs/dgui_datamodel_types.html
+++ b/docs/dgui_datamodel_types.html
@@ -502,8 +502,8 @@ The average of the price of a python and an elephant is:
           
         <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="dgui_datamodel_basics.html"><span>Previous</span></a><a class="paging-arrow next" href="dgui_template.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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.24</span><span class="last-updated"> Last generated:
-<time itemprop="dateModified" datetime="2016-03-28T15:17:13Z" title="Monday, March 28, 2016 3:17:13 PM GMT">2016-03-28 15:17:13 GMT</time></span></p> <p class="copyright">
+<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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.25</span><span class="last-updated"> Last generated:
+<time itemprop="dateModified" datetime="2016-07-05T19:17:27Z" title="Tuesday, July 5, 2016 7:17:27 PM GMT">2016-07-05 19:17:27 GMT</time></span></p> <p class="copyright">
 � <span itemprop="copyrightYear">1999</span>\u20132016
 <a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://freemarker.org">The Apache Software Foundation</a>. All rights reserved. </p>
 </div></div></div></body>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/bd8b9839/docs/dgui_misc.html
----------------------------------------------------------------------
diff --git a/docs/dgui_misc.html b/docs/dgui_misc.html
index 2fad389..9baabf4 100644
--- a/docs/dgui_misc.html
+++ b/docs/dgui_misc.html
@@ -44,8 +44,8 @@ ga('send', 'pageview');
 <div class="page-menu-title">Section Contents</div>
 <ul><li><a class="page-menu-link" href="dgui_misc_userdefdir.html" data-menu-target="dgui_misc_userdefdir">Defining your own directives</a></li><li><a class="page-menu-link" href="dgui_misc_var.html" data-menu-target="dgui_misc_var">Defining variables in the template</a></li><li><a class="page-menu-link" href="dgui_misc_namespace.html" data-menu-target="dgui_misc_namespace">Namespaces</a></li><li><a class="page-menu-link" href="dgui_misc_autoescaping.html" data-menu-target="dgui_misc_autoescaping">Auto-escaping and output formats</a></li><li><a class="page-menu-link" href="dgui_misc_whitespace.html" data-menu-target="dgui_misc_whitespace">White-space handling</a></li><li><a class="page-menu-link" href="dgui_misc_alternativesyntax.html" data-menu-target="dgui_misc_alternativesyntax">Alternative (square bracket) syntax</a></li></ul> </div><div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="dgui_template_valueinsertion.html"><span>Previo
 us</span></a><a class="paging-arrow next" href="dgui_misc_userdefdir.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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.24</span><span class="last-updated"> Last generated:
-<time itemprop="dateModified" datetime="2016-03-28T15:17:13Z" title="Monday, March 28, 2016 3:17:13 PM GMT">2016-03-28 15:17:13 GMT</time></span></p> <p class="copyright">
+<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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.25</span><span class="last-updated"> Last generated:
+<time itemprop="dateModified" datetime="2016-07-05T19:17:27Z" title="Tuesday, July 5, 2016 7:17:27 PM GMT">2016-07-05 19:17:27 GMT</time></span></p> <p class="copyright">
 � <span itemprop="copyrightYear">1999</span>\u20132016
 <a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://freemarker.org">The Apache Software Foundation</a>. All rights reserved. </p>
 </div></div></div></body>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/bd8b9839/docs/dgui_misc_alternativesyntax.html
----------------------------------------------------------------------
diff --git a/docs/dgui_misc_alternativesyntax.html b/docs/dgui_misc_alternativesyntax.html
index 0bc9576..64be874 100644
--- a/docs/dgui_misc_alternativesyntax.html
+++ b/docs/dgui_misc_alternativesyntax.html
@@ -109,8 +109,8 @@ ga('send', 'pageview');
         means that the first FreeMarker tag determines the syntax (it can be
         anything, not just <code class="inline-code">ftl</code>).</p><div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="dgui_misc_whitespace.html"><span>Previous</span></a><a class="paging-arrow next" href="pgui.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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.24</span><span class="last-updated"> Last generated:
-<time itemprop="dateModified" datetime="2016-03-28T15:17:13Z" title="Monday, March 28, 2016 3:17:13 PM GMT">2016-03-28 15:17:13 GMT</time></span></p> <p class="copyright">
+<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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.25</span><span class="last-updated"> Last generated:
+<time itemprop="dateModified" datetime="2016-07-05T19:17:27Z" title="Tuesday, July 5, 2016 7:17:27 PM GMT">2016-07-05 19:17:27 GMT</time></span></p> <p class="copyright">
 � <span itemprop="copyrightYear">1999</span>\u20132016
 <a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://freemarker.org">The Apache Software Foundation</a>. All rights reserved. </p>
 </div></div></div></body>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/bd8b9839/docs/dgui_misc_autoescaping.html
----------------------------------------------------------------------
diff --git a/docs/dgui_misc_autoescaping.html b/docs/dgui_misc_autoescaping.html
index 3f77972..66b9c39 100644
--- a/docs/dgui_misc_autoescaping.html
+++ b/docs/dgui_misc_autoescaping.html
@@ -281,10 +281,10 @@ operator</a></li><li><a class="page-menu-link" href="#dgui_misc_autoescaping_str
           the output format is <code class="inline-code">undefined</code> (you can check
           that with <code class="inline-code">${.output_format}</code>), and so no automatic
           escaping is happening. In other cases, a common output format (like
-          HTML) is set for all templates, but a few templates needs a
-          different output format. In any case, the output format of a
-          template can be enforced in the <a href="ref_directive_ftl.html">the <code>ftl</code>
-          header</a>:</p>
+          HTML) is set for all templates, but a few templates need a different
+          output format. In any case, the output format of a template can be
+          enforced in the <a href="ref_directive_ftl.html">the
+          <code>ftl</code> header</a>:</p>
 
           
 
@@ -705,8 +705,8 @@ To prove that &quot;s&quot; didn&#39;t contain the value in escaped form:
           
         <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="dgui_misc_namespace.html"><span>Previous</span></a><a class="paging-arrow next" href="dgui_misc_whitespace.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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.24</span><span class="last-updated"> Last generated:
-<time itemprop="dateModified" datetime="2016-03-28T15:17:13Z" title="Monday, March 28, 2016 3:17:13 PM GMT">2016-03-28 15:17:13 GMT</time></span></p> <p class="copyright">
+<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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.25</span><span class="last-updated"> Last generated:
+<time itemprop="dateModified" datetime="2016-07-05T19:17:27Z" title="Tuesday, July 5, 2016 7:17:27 PM GMT">2016-07-05 19:17:27 GMT</time></span></p> <p class="copyright">
 � <span itemprop="copyrightYear">1999</span>\u20132016
 <a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://freemarker.org">The Apache Software Foundation</a>. All rights reserved. </p>
 </div></div></div></body>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/bd8b9839/docs/dgui_misc_namespace.html
----------------------------------------------------------------------
diff --git a/docs/dgui_misc_namespace.html b/docs/dgui_misc_namespace.html
index 2fe27f1..3348daa 100644
--- a/docs/dgui_misc_namespace.html
+++ b/docs/dgui_misc_namespace.html
@@ -42,22 +42,28 @@ ga('send', 'pageview');
 <h1 class="content-header header-section1" id="dgui_misc_namespace" itemprop="headline">Namespaces</h1>
 </div></div><div class="page-menu">
 <div class="page-menu-title">Page Contents</div>
-<ul><li><a class="page-menu-link" href="#autoid_23" data-menu-target="autoid_23">Creating a library</a></li><li><a class="page-menu-link" href="#autoid_24" data-menu-target="autoid_24">Writing the variables of imported namespaces</a></li><li><a class="page-menu-link" href="#autoid_25" data-menu-target="autoid_25">Namespaces and data-model</a></li><li><a class="page-menu-link" href="#autoid_26" data-menu-target="autoid_26">The life-cycle of namespaces</a></li><li><a class="page-menu-link" href="#autoid_27" data-menu-target="autoid_27">Writing libraries for other people</a></li></ul> </div><p>When you run FTL templates, you have a (possibly empty) set of
+<ul><li><a class="page-menu-link" href="#autoid_23" data-menu-target="autoid_23">Creating a library</a></li><li><a class="page-menu-link" href="#autoid_24" data-menu-target="autoid_24">Writing the variables of imported namespaces</a></li><li><a class="page-menu-link" href="#autoid_25" data-menu-target="autoid_25">Namespaces and data-model</a></li><li><a class="page-menu-link" href="#autoid_26" data-menu-target="autoid_26">The life-cycle of namespaces</a></li><li><a class="page-menu-link" href="#autoid_27" data-menu-target="autoid_27">Auto-importing</a></li></ul> </div><p>When you run templates, you have a (possibly empty) set of
         variables that you have created with <code class="inline-code">assign</code> and
-        <code class="inline-code">macro</code> directives, as can be seen from the <a href="dgui_misc_var.html">previous chapter</a>. A set of variables
-        like this is called a <strong>namespace</strong>. In
-        simple cases you use only one namespace, the so-called <strong>main namespace</strong>. You don&#39;t realize this, since
-        normally you use only this namespace.</p><p>But if you want to build reusable collection of macros,
-        functions and other variables -- usually referred as <strong>library</strong> by lingo -- the usage of multiple
-        namespaces becomes inevitable. Just consider if you have a big
-        collection of macros, that you use in several projects, or even you
-        want to share it with other people. It becomes impossible to be sure
-        that the library does not have a macro (or other variable) with the
-        same name as the name of a variable in the data-model, or with the
-        same name as a the name of a variable in another library used in the
-        template. In general, variables can clobber each other because of the
-        name clashes. So you should use a separate namespace for the variables
-        of each library.</p>
+        <code class="inline-code">macro</code> and <code class="inline-code">function</code> directives
+        (see in the <a href="dgui_misc_var.html">previous chapter</a>). A
+        set of template-made variables like that is called a <strong>namespace</strong>. In simple cases you use only one
+        namespace, the <strong>main namespace</strong>.
+        Whenever you define a variable in the main template (macros and
+        functions are also variables, mind you), or in templates <a href="ref_directive_include.html#ref.directive.include"><code>include</code>-d</a> in
+        it, that&#39;s where the variable are created. The key property of a
+        namespace is that the variable name uniquely identifies a value in it
+        (i.e, you can&#39;t have multiple variables in it with the same name in
+        the same namespace).</p><p>Sometimes you want to build reusable collection of macros,
+        functions, and other variables, which we call a <strong>library</strong>. It&#39;s important that a library can use
+        its own namespace, to avoid accidental name clashes. Consider, you may
+        have many names in that library, and you intend to use the library in
+        many templates, maybe even reuse it in several projects. It becomes
+        impractical to keep track of where the library used in another
+        template accidentally hides variables from the data-model, or what
+        names you shouldn&#39;t assign to in the template to avoid overwriting the
+        variables of the library. If you have multiple libraries used in the
+        same template, this becomes even harder to track. So you should use a
+        separate namespace for the variables of each library.</p>
           
 
 
@@ -65,101 +71,90 @@ ga('send', 'pageview');
 <h2 class="content-header header-section2" id="autoid_23">Creating a library</h2>
 
 
-          <p>Let&#39;s create a simple library. Assume you commonly need the
-          variables <code class="inline-code">copyright</code> and <code class="inline-code">mail</code>
-          (before you ask, macros <em>are</em> variables):</p>
+          <p>Here&#39;s a simple library, which contains a
+          <code class="inline-code">copyright</code> macro and a <code class="inline-code">mail</code>
+          string:</p>
 
           
 
 <div class="code-wrapper"><pre class="code-block code-template">&lt;#macro copyright date&gt;
-  &lt;p&gt;Copyright (C) ${date} Julia Smith. All rights reserved.&lt;/p&gt;
+  &lt;p&gt;Copyright (C) ${date} Someone. All rights reserved.&lt;/p&gt;
 &lt;/#macro&gt;
 
-&lt;#assign mail = &quot;jsmith@acme.com&quot;&gt;</pre></div>
-
-          <p>Store the above in the file <code class="inline-code">lib/my_test.ftl</code>
-          (in the directory where you store the templates). Assume you want to
-          use this in <code class="inline-code">aWebPage.ftl</code>. If you use
-          <code class="inline-code">&lt;#include &quot;/lib/my_test.ftl&quot;&gt;</code> in the
-          <code class="inline-code">aWebPage.ftl</code>, then it will create the two
-          variables in the main namespace, and it is not good now, since you
-          want them to be in a namespace that is used exclusively by the ``My
-          Test Library&#39;&#39;. Instead of <code class="inline-code">include</code> you have to
-          use <a href="ref_directive_import.html#ref.directive.import"><code>import</code>
-          directive</a>. This directive is, at the first glance, similar to
-          <code class="inline-code">include</code>, but it will create an empty namespace
-          for <code class="inline-code">lib/my_test.ftl</code> and will execute that there.
-          <code class="inline-code">lib/my_test.ftl</code> will find itself in an clean new
-          world, where only the variables of data-model are present (since
-          they are visible from everywhere), and will create the two variables
-          in this new world. That&#39;s fine for now, but you want to access the
-          two variables from <code class="inline-code">aWebPage.ftl</code>, and that uses
-          the main namespace, so it can&#39;t see the variables of the other
-          namespace. The solution is that the <code class="inline-code">import</code>
-          directive not only creates the new namespace, but a new hash
-          variable in the namespace used by the caller of
-          <code class="inline-code">import</code> (the main namespace in this case), that
-          will act as a gate into the newly created namespace. So this is how
-          <code class="inline-code">aWebPage.ftl</code> will look like:</p>
+&lt;#assign mail = &quot;user@example.com&quot;&gt;</pre></div>
+
+          <p>Save this into the <code class="inline-code">lib/example.ftl</code> file
+          (inside the directory where you store the templates). Then create a
+          template, let&#39;s say, <code class="inline-code">some_web_page.ftl</code>, and use
+          the library in it:</p>
 
           
 
-<div class="code-wrapper"><pre class="code-block code-template">&lt;#import &quot;/lib/my_test.ftl&quot; as <strong>my</strong>&gt; &lt;#-- the hash called &quot;my&quot; will be the &quot;gate&quot; --&gt;
-&lt;@<strong>my</strong>.copyright date=&quot;1999-2002&quot;/&gt;
-${<strong>my</strong>.mail}</pre></div>
+<div class="code-wrapper"><pre class="code-block code-template">&lt;#<strong>import</strong> &quot;/lib/example.ftl&quot; as <strong>e</strong>&gt;
 
-          <p>Note how it accesses the variables in the namespace created
-          for <code class="inline-code">/lib/my_test.ftl</code> using the newly created
-          namespace accessing hash, <code class="inline-code">my</code>. This will
-          print:</p>
+Some Web page...
+&lt;@<strong>e</strong>.copyright date=&quot;1999-2002&quot;/&gt;
+${<strong>e</strong>.mail}</pre></div>
 
           
 
-<div class="code-wrapper"><pre class="code-block code-output">  &lt;p&gt;Copyright (C) 1999-2002 Julia Smith. All rights reserved.&lt;/p&gt;
-jsmith@acme.com</pre></div>
-
-          <p>If you would have a variable called <code class="inline-code">mail</code> or
-          <code class="inline-code">copyright</code> in the main namespace, that would not
-          cause any confusion, since the two templates use separated
-          namespaces. For example, modify the <code class="inline-code">copyright</code>
-          macro in <code class="inline-code">lib/my_test.ftl</code> to this:</p>
+<div class="code-wrapper"><pre class="code-block code-output">Some Web page...
+  &lt;p&gt;Copyright (C) 1999-2002 Someone. All rights reserved.&lt;/p&gt;
+user@example.com</pre></div>
+
+          <p>Note the <a href="ref_directive_import.html#ref.directive.import"><code>import</code>
+          directive</a> above, and the subsequent usage of the
+          "<code class="inline-code">e</code>" variable.
+          <code class="inline-code">import</code> is similar to the perhaps already familiar
+          <a href="ref_directive_include.html#ref.directive.include"><code>include</code>
+          directive</a>, but it will create an empty namespace and will run
+          <code class="inline-code">lib/example.ftl</code> in that namespace. So
+          <code class="inline-code">lib/example.ftl</code> will find itself in a clean
+          world, where only the variables of the data-models are visible (and
+          the globals), and will create its two variables
+          (<code class="inline-code">copyright</code> and <code class="inline-code">mail</code>) in this
+          clean namespace. But you will need to access those two variables
+          from another namespace (the main namespace), thus, the
+          <code class="inline-code">import</code> directive creates a hash variable
+          (<code class="inline-code">e</code> in this case) to access the namespace it has
+          created . That variable is in the namespace that the
+          <code class="inline-code">import</code>-ing template uses, and acts as a window to
+          the namespace of the imported library.</p>
+
+          <p>To demonstrate that the two namespaces are separate, consider
+          the example below. Replace <code class="inline-code">lib/example.ftl</code> with
+          this:</p>
 
           
 
 <div class="code-wrapper"><pre class="code-block code-template">&lt;#macro copyright date&gt;
-  &lt;p&gt;Copyright (C) ${date} Julia Smith. All rights reserved.
+  &lt;p&gt;Copyright (C) ${date} Someone. All rights reserved.
   &lt;br&gt;Email: <strong>${mail}</strong>&lt;/p&gt;
-&lt;/#macro&gt;</pre></div>
+&lt;/#macro&gt;
 
-          <p>and then replace <code class="inline-code">aWebPage.ftl</code> with
-          this:</p>
+&lt;#assign mail = &quot;user@example.com&quot;&gt;</pre></div>
+
+          <p>and <code class="inline-code">some_web_page.ftl</code> with this:</p>
 
           
 
-<div class="code-wrapper"><pre class="code-block code-template">&lt;#import &quot;/lib/my_test.ftl&quot; as my&gt;
-<strong>&lt;#assign mail=&quot;fred@acme.com&quot;&gt;</strong>
-&lt;@my.copyright date=&quot;1999-2002&quot;/&gt;
-${my.mail}
+<div class="code-wrapper"><pre class="code-block code-template">&lt;#import &quot;/lib/example.ftl&quot; as e&gt;
+<strong>&lt;#assign mail=&quot;other@example.com&quot;&gt;</strong>
+&lt;@e.copyright date=&quot;1999-2002&quot;/&gt;
+${e.mail}
 ${mail}</pre></div>
 
-          <p>and the output will be this:</p>
-
           
 
-<div class="code-wrapper"><pre class="code-block code-output">  &lt;p&gt;Copyright (C) 1999-2002 Julia Smith. All rights reserved.
-  &lt;br&gt;Email: <strong>jsmith@acme.com</strong>&lt;/p&gt;
-jsmith@acme.com
-fred@acme.com</pre></div>
-
-          <p>This is like that because when you have called the
-          <code class="inline-code">copyright</code> macro, FreeMarker has temporarily
-          switch to the namespace that was created by the
-          <code class="inline-code">import</code> directive for
-          <code class="inline-code">/lib/my_test.ftl</code>. Thus, the
-          <code class="inline-code">copyright</code> macro always sees the
-          <code class="inline-code">mail</code> variable that exists there, and not the
-          other <code class="inline-code">mail</code> that exists in the main
-          namespace.</p>
+<div class="code-wrapper"><pre class="code-block code-output">  &lt;p&gt;Copyright (C) 1999-2002 Someone. All rights reserved.
+  &lt;br&gt;Email: <strong>user@example.com</strong>&lt;/p&gt;
+user@example.com
+other@example.com</pre></div>
+
+          <p>As you can see, the <code class="inline-code">mail</code> variable assigned
+          in <code class="inline-code">some_web_page.ftl</code> is separate from the
+          <code class="inline-code">mail</code> variable assigned in the imported
+          library.</p>
         
           
 
@@ -168,24 +163,22 @@ fred@acme.com</pre></div>
 <h2 class="content-header header-section2" id="autoid_24">Writing the variables of imported namespaces</h2>
 
 
-          <p>Occasionally you may want to create or replace a variable in
-          an imported namespace. You can do this with the
-          <code class="inline-code">assign</code> directive, if you use its
-          <code class="inline-code">namespace</code> parameter. For example, this:</p>
+          <p>Sometimes you want to create or replace a variable in an
+          imported namespace. You can do that with the
+          <code class="inline-code">assign</code> directive and its
+          <code class="inline-code">namespace</code> parameter:</p>
 
           
 
-<div class="code-wrapper"><pre class="code-block code-template">&lt;#import &quot;/lib/my_test.ftl&quot; as my&gt;
+<div class="code-wrapper"><pre class="code-block code-template">&lt;#import &quot;/lib/example.ftl&quot; as e&gt;
 ${my.mail}
-&lt;#assign mail=&quot;jsmith@other.com&quot; <strong>in my</strong>&gt;
+&lt;#assign mail=&quot;other@example.com&quot; <strong>in e</strong>&gt;
 ${my.mail}</pre></div>
 
-          <p>will output this:</p>
-
           
 
-<div class="code-wrapper"><pre class="code-block code-output">jsmith@acme.com
-jsmith@other.com</pre></div>
+<div class="code-wrapper"><pre class="code-block code-output">user@example.com
+other@example.com</pre></div>
         
           
 
@@ -196,50 +189,45 @@ jsmith@other.com</pre></div>
 
           <p>The variables of the data-model are visible from everywhere.
           For example, if you have a variable called <code class="inline-code">user</code>
-          in the data-model, <code class="inline-code">lib/my_test.ftl</code> will access
-          that, exactly as <code class="inline-code">aWebPage.ftl</code> does:</p>
+          in the data-model, <code class="inline-code">lib/example.ftl</code> will access
+          that, exactly like <code class="inline-code">some_web_page.ftl</code> does:</p>
 
           
 
 <div class="code-wrapper"><pre class="code-block code-template">&lt;#macro copyright date&gt;
   &lt;p&gt;Copyright (C) ${date} <strong>${user}</strong>. All rights reserved.&lt;/p&gt;
-&lt;/#macro&gt;
-
-&lt;#assign mail = &quot;<strong>${user}</strong>@acme.com&quot;&gt;</pre></div>
+&lt;/#macro&gt;</pre></div>
 
-          <p>If <code class="inline-code">user</code> is ``Fred&#39;&#39;, then the usual
-          example:</p>
+          <p>Assuming <code class="inline-code">user</code> is "John
+          Doe":</p>
 
           
 
 <div class="code-wrapper"><pre class="code-block code-template">&lt;#import &quot;/lib/my_test.ftl&quot; as my&gt;
-&lt;@my.copyright date=&quot;1999-2002&quot;/&gt;
-${my.mail}</pre></div>
-
-          <p>will print this:</p>
+User is: ${user}
+&lt;@my.copyright date=&quot;1999-2002&quot;/&gt;</pre></div>
 
           
 
-<div class="code-wrapper"><pre class="code-block code-output">  &lt;p&gt;Copyright (C) 1999-2002 Fred. All rights reserved.&lt;/p&gt;
-Fred@acme.com</pre></div>
+<div class="code-wrapper"><pre class="code-block code-output">User is: John Doe
+  &lt;p&gt;Copyright (C) 1999-2002 John Doe. All rights reserved.&lt;/p&gt;</pre></div>
 
           <p>Don&#39;t forget that the variables in the namespace (the
-          variables you create with <code class="inline-code">assign</code> or
-          <code class="inline-code">macro</code> directives) have precedence over the
-          variables of the data-model when you are in that namespace. Thus,
-          the contents of data-model does not interfere with the variables
-          created by the library.</p>
+          variables you create with <code class="inline-code">assign</code>,
+          <code class="inline-code">macro</code>, and <code class="inline-code">function</code>
+          directives) have precedence over the variables of the data-model
+          when you are in that namespace. So generally, if a library is
+          interested in a data-model variable, it doesn&#39;t assign to the same
+          name.</p>
 
             <div class="callout note">
     <strong class="callout-label">Note:</strong>
 
             <p>In some unusual applications you want to create variables in
-            the template those are visible from all namespaces, exactly like
-            the variables of the data-model. But you can&#39;t change the
-            data-model with templates. Still, it is possible to achieve
-            similar result with the <code class="inline-code">global</code> directive; read
-            the <a href="ref_directive_global.html#ref.directive.global">reference</a> for more
-            details.</p>
+            the template that are visible from all namespaces, exactly like
+            the variables of the data-model. While templates can&#39;t change the
+            data-model, it&#39;s possible to achieve similar effect with the
+            <code class="inline-code">global</code> directive; see the <a href="ref_directive_global.html#ref.directive.global">reference</a>.</p>
             </div>
 
         
@@ -250,97 +238,75 @@ Fred@acme.com</pre></div>
 <h2 class="content-header header-section2" id="autoid_26">The life-cycle of namespaces</h2>
 
 
-          <p>A namespace is identified by the path that was used with the
-          <code class="inline-code">import</code> directive. If you try to
-          <code class="inline-code">import</code> with the same path for multiple times, it
-          will create the namespace and run the template specified by the path
-          for the very first invocation of <code class="inline-code">import</code> only. The
-          later <code class="inline-code">import</code>s with the same path will just create
-          a ``gate&#39;&#39; hash to the same namespace. For example, let this be the
-          <code class="inline-code">aWebPage.ftl</code>:</p>
+          <p>A namespace is identified by the path used in the
+          <code class="inline-code">import</code> directive (after it was normalized to an
+          absolute path). If you try to <code class="inline-code">import</code> with
+          equivalent paths for multiple times, it will create the namespace
+          and run the template for only the first invocation of
+          <code class="inline-code">import</code>. The later <code class="inline-code">import</code>-s
+          with equivalent paths will just assign the same namespace to the
+          variable specified after the <code class="inline-code">as</code> keyword. For
+          example:</p>
 
           
 
-<div class="code-wrapper"><pre class="code-block code-template">&lt;#import &quot;/lib/my_test.ftl&quot; as my&gt;
-&lt;#import &quot;/lib/my_test.ftl&quot; as foo&gt;
-&lt;#import &quot;/lib/my_test.ftl&quot; as bar&gt;
-${my.mail}, ${foo.mail}, ${bar.mail}
-&lt;#assign mail=&quot;jsmith@other.com&quot; in my&gt;
-${my.mail}, ${foo.mail}, ${bar.mail}</pre></div>
-
-          <p>The output will be:</p>
+<div class="code-wrapper"><pre class="code-block code-template">&lt;#import &quot;/lib/example.ftl&quot; as e&gt;
+&lt;#import &quot;/lib/example.ftl&quot; as e2&gt;
+&lt;#import &quot;/lib/example.ftl&quot; as e3&gt;
+${e.mail}, ${e2.mail}, ${e3.mail}
+&lt;#assign mail=&quot;other@example.com&quot; in my&gt;
+${e.mail}, ${e2.mail}, ${e3.mail}</pre></div>
 
           
 
-<div class="code-wrapper"><pre class="code-block code-output">jsmith@acme.com, jsmith@acme.com, jsmith@acme.com
-jsmith@other.com, jsmith@other.com, jsmith@other.com</pre></div>
-
-          <p>since you see the same namespace through
-          <code class="inline-code">my</code>, <code class="inline-code">foo</code> and
-          <code class="inline-code">bar</code>.</p>
-
-          <p>Note that namespaces are not hierarchical, they exist
-          independently of each other. That is, if you
-          <code class="inline-code">import</code> namespace N2 while you are in name space
-          N1, N2 will not be inside N1. N1 just gets a hash by which it can
-          access N2. This is the same N2 namespace that you would access if,
-          say, you <code class="inline-code">import</code> N2 when you are in the main
+<div class="code-wrapper"><pre class="code-block code-output">user@example.com, user@example.com, user@example.com
+other@example.com, other@example.com, other@example.com</pre></div>
+
+          <p>As you access the same namespace through <code class="inline-code">e</code>,
+          <code class="inline-code">e2</code>, and <code class="inline-code">e3</code>, the
+          <code class="inline-code">email</code> has changed in all of them at once. The
+          practical importance of this is that when you import the same
+          library in multiple templates, only one namespace will be
+          initialized and created for the library, which will be shared by all
+          the importing templates.</p>
+
+          <p>Note that namespaces are not hierarchical; it doesn&#39;t mater
+          what namespace are you in when <code class="inline-code">import</code> creates
+          another namespace. For example, when you <code class="inline-code">import</code>
+          namespace N2 while you are in name space N1, N2 will not be inside
+          N1. N1 just gets the same N2 that you get if you
+          <code class="inline-code">import</code> N2 when you are in the main
           namespace.</p>
 
           <p>Each <a href="gloss.html#gloss.templateProcessingJob">template
           processing job</a> has its own private set of namespaces. Each
-          template-processing job is a separated cosmos that exists only for
-          the short period of time while the given page is rendered, and then
-          it vanishes with all its populated namespaces. Thus, whenever we say
-          that ``<code class="inline-code">import</code> is called for the first time&#39;&#39; and
-          such, we are always talking in the context of a single template
-          processing job.</p>
+          template processing job is a separate universe that exists only for
+          the short period while the main template is rendered, and then it
+          vanishes with all its populated namespaces. Thus, whenever we say
+          that "<code class="inline-code">import</code> is called for the first
+          time", we always mean the first time within the lifespan of a
+          single template processing job.</p>
         
           
 
 
 
-<h2 class="content-header header-section2" id="autoid_27">Writing libraries for other people</h2>
-
-
-          
-
-          <p>If you have written a good quality library that can be useful
-          for other people, you may want to make it available on the Internet
-          (like on <a href="http://freemarker.org/libraries.html">http://freemarker.org/libraries.html</a>).
-          To prevent clashes with the names of libraries used by other
-          authors, and to make it easy to write libraries that import other
-          published libraries, there is a de-facto standard that specifies the
-          format of library paths. The standard is that the library must be
-          available (importable) for templates and other libraries with a path
-          like this:</p>
-
-          <p><code class="inline-code">/lib/<em class="code-color">yourcompany.com</em>/<em class="code-color">your_library</em>.ftl</code></p>
-
-          <p>For example if you work for Example Inc. that owns the
-          www.example.com homepage, and you develop a widget library, then the
-          path of the FTL file to import should be:</p>
-
-          <p><code class="inline-code">/lib/example.com/widget.ftl</code></p>
-
-          <p>Note that the www is omitted. The part after the 3rd slash can
-          contain subdirectories such as:</p>
-
-          <p><code class="inline-code">/lib/example.com/commons/string.ftl</code></p>
+<h2 class="content-header header-section2" id="autoid_27">Auto-importing</h2>
 
-          <p>An important rule is that the path should not contain
-          upper-case letters. To separate words, use <code class="inline-code">_</code>, as
-          in <code class="inline-code">wml_form</code> (not
-          <code class="inline-code">wmlForm</code>).</p>
 
-          <p>Note that if you do not develop the library for a company or
-          organization, you should use the URL of the project homepage, such
-          as <code class="inline-code">/lib/example.sourceforge.net/example.ftl</code>, or
-          <code class="inline-code">/lib/geocities.com/jsmith/example.ftl</code>.</p>
+          <p>When you have to import the same libraries again and again in
+          many templates, know that the Java programmers (or whoever is
+          responsible for configuring FreeMarker) can specify auto-imports,
+          which are imports that are automatically done in all templates. Auto
+          imports can also be configured to be "lazy" (since
+          FreeMarker 2.3.25), which means that they are only done when the
+          imported library is actually used in the template. See the Java API
+          documentation for more details: <a href="http://freemarker.org/docs/api/freemarker/template/Configuration.html#setAutoImports-java.util.Map-">Configuration.setAutoImports</a>,
+          <a href="http://freemarker.org/docs/api/freemarker/template/Configuration.html#setLazyAutoImports-java.lang.Boolean-">Configuration.setLazyAutoImports</a>.</p>
         <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="dgui_misc_var.html"><span>Previous</span></a><a class="paging-arrow next" href="dgui_misc_autoescaping.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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.24</span><span class="last-updated"> Last generated:
-<time itemprop="dateModified" datetime="2016-03-28T15:17:13Z" title="Monday, March 28, 2016 3:17:13 PM GMT">2016-03-28 15:17:13 GMT</time></span></p> <p class="copyright">
+<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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.25</span><span class="last-updated"> Last generated:
+<time itemprop="dateModified" datetime="2016-07-05T19:17:27Z" title="Tuesday, July 5, 2016 7:17:27 PM GMT">2016-07-05 19:17:27 GMT</time></span></p> <p class="copyright">
 � <span itemprop="copyrightYear">1999</span>\u20132016
 <a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://freemarker.org">The Apache Software Foundation</a>. All rights reserved. </p>
 </div></div></div></body>

http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/bd8b9839/docs/dgui_misc_userdefdir.html
----------------------------------------------------------------------
diff --git a/docs/dgui_misc_userdefdir.html b/docs/dgui_misc_userdefdir.html
index 0d88134..323d608 100644
--- a/docs/dgui_misc_userdefdir.html
+++ b/docs/dgui_misc_userdefdir.html
@@ -527,10 +527,25 @@ ga('send', 'pageview');
 
           <p>Also, you may interested in namespaces: <a href="dgui_misc_namespace.html">Namespaces</a>. Namespaces help you to organize and
           reuse your commonly used macros.</p>
+
+          <p>Java programmers might want to know that directives (macros
+          are directives) and methods (function-like things) can also be
+          written in Java language, by<a href="pgui_datamodel_directive.html"> implementing the
+          <code>TemplateDirectiveModel</code></a> or
+          <code class="inline-code">TemplateMethodModelEx</code> interfaces, respectively.
+          Then you can pull in the Java implementations into the template like
+          <code class="inline-code">&lt;#assign foo =
+          &quot;com.example.FooDirective&quot;?new()&gt;</code> or
+          <code class="inline-code">&lt;#assign foo =
+          &quot;com.example.FooMethod&quot;?new()&gt;</code> on the same place where
+          you would have <code class="inline-code">&lt;#macro foo
+          <em class="code-color">...</em>&gt;</code> or
+          <code class="inline-code">&lt;#function foo
+          <em class="code-color">...</em>&gt;</code> otherwise.</p>
         <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="dgui_misc.html"><span>Previous</span></a><a class="paging-arrow next" href="dgui_misc_var.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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.24</span><span class="last-updated"> Last generated:
-<time itemprop="dateModified" datetime="2016-03-28T15:17:13Z" title="Monday, March 28, 2016 3:17:13 PM GMT">2016-03-28 15:17:13 GMT</time></span></p> <p class="copyright">
+<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="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.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://freemarker-online.kenshoo.com/">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><ul><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://sourceforge.net/p/freemarker/bugs/new/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.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="http://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><span class="generated-for-product">Generated for: Fr
 eemarker 2.3.25</span><span class="last-updated"> Last generated:
+<time itemprop="dateModified" datetime="2016-07-05T19:17:27Z" title="Tuesday, July 5, 2016 7:17:27 PM GMT">2016-07-05 19:17:27 GMT</time></span></p> <p class="copyright">
 � <span itemprop="copyrightYear">1999</span>\u20132016
 <a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://freemarker.org">The Apache Software Foundation</a>. All rights reserved. </p>
 </div></div></div></body>