freemarker-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ddek...@apache.org
Subject incubator-freemarker git commit: Manual: Further clarified note about custom TemplateLoader.findTemplateSource incorrectly throwing IOException at a missing template
Date Tue, 27 Mar 2018 22:00:55 GMT
Repository: incubator-freemarker
Updated Branches:
  refs/heads/2.3-gae b7410b921 -> 84132a19f


Manual: Further clarified note about custom TemplateLoader.findTemplateSource incorrectly
throwing IOException at a missing template


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

Branch: refs/heads/2.3-gae
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/incubator-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