freemarker-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ddek...@apache.org
Subject [03/16] freemarker git commit: Manual: Further clarified note about custom TemplateLoader.findTemplateSource incorrectly throwing IOException at a missing template
Date Fri, 30 Mar 2018 20:50:31 GMT
Manual: Further clarified note about custom TemplateLoader.findTemplateSource incorrectly throwing
IOException at a missing template


Project: http://git-wip-us.apache.org/repos/asf/freemarker/repo
Commit: http://git-wip-us.apache.org/repos/asf/freemarker/commit/84132a19
Tree: http://git-wip-us.apache.org/repos/asf/freemarker/tree/84132a19
Diff: http://git-wip-us.apache.org/repos/asf/freemarker/diff/84132a19

Branch: refs/heads/2.3
Commit: 84132a19fb169301f329889dde599d95524e9c1b
Parents: b7410b9
Author: ddekany <ddekany@apache.org>
Authored: Wed Mar 28 00:00:39 2018 +0200
Committer: ddekany <ddekany@apache.org>
Committed: Wed Mar 28 00:00:39 2018 +0200

----------------------------------------------------------------------
 src/manual/en_US/book.xml | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/freemarker/blob/84132a19/src/manual/en_US/book.xml
----------------------------------------------------------------------
diff --git a/src/manual/en_US/book.xml b/src/manual/en_US/book.xml
index 3fcef11..32685cf 100644
--- a/src/manual/en_US/book.xml
+++ b/src/manual/en_US/book.xml
@@ -20607,14 +20607,15 @@ All rights reserved.</emphasis></programlisting>
                 application uses a custom
                 <literal>freemarker.cache.TemplateLoader</literal>
                 implementation, which incorrectly (against the API
-                documentation) throws an <literal>IOException</literal>
-                instead of returning <literal>null</literal> if a template is
-                not found. If it'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 <literal>IOException</literal>
-                in the Java stack trace to figure out which case it is.</para>
+                documentation) throws an <literal>IOException</literal> in the
+                <literal>findTemplateSource</literal> method instead of
+                returning <literal>null</literal> if a template is not found.
+                If it'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 <literal>IOException</literal> in the
+                Java stack trace to figure out which case it is.</para>
               </note>
             </listitem>
           </itemizedlist>
@@ -23894,7 +23895,8 @@ There was no specific handler for node y
           often because your application uses a custom
           <literal>freemarker.cache.TemplateLoader</literal> implementation,
           which incorrectly (against the API documentation) throws an
-          <literal>IOException</literal> instead of returning
+          <literal>IOException</literal> in the
+          <literal>findTemplateSource</literal> method instead of returning
           <literal>null</literal> if a template is not found. If it'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


Mime
View raw message