[18/50] [abbrv] incubator-freemarker git commit: (JavaDoc improvement)

[dd...@apache.org]

(JavaDoc improvement)


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

Branch: refs/heads/2.3
Commit: 272008e33fea0cb2369b9ed6a29a310e3a1f390f
Parents: 6a3b926
Author: ddekany <dd...@apache.org>
Authored: Sat Feb 11 18:50:35 2017 +0100
Committer: ddekany <dd...@apache.org>
Committed: Sat Feb 11 18:50:35 2017 +0100

----------------------------------------------------------------------
 src/main/java/freemarker/cache/URLTemplateLoader.java | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/272008e3/src/main/java/freemarker/cache/URLTemplateLoader.java
----------------------------------------------------------------------
diff --git a/src/main/java/freemarker/cache/URLTemplateLoader.java b/src/main/java/freemarker/cache/URLTemplateLoader.java
index d8474dd..816d2c8 100644
--- a/src/main/java/freemarker/cache/URLTemplateLoader.java
+++ b/src/main/java/freemarker/cache/URLTemplateLoader.java
@@ -29,9 +29,10 @@ import java.net.URLConnection;
 import freemarker.template.Configuration;
 
 /**
- * This is an abstract template loader that can load templates whose
- * location can be described by an URL. Subclasses only need to override
- * the {@link #getURL(String)} method.
+ * This is an abstract template loader that can load templates whose location can be described by an URL. This
+ * superclass only works for cases where merely getting the URL immediately tells if the resource exists, not for cases
+ * where for example you had to check response headers to know that. The subclasses only need to override the
+ * {@link #getURL(String)} method.
  */
 public abstract class URLTemplateLoader implements TemplateLoader {
     
@@ -93,8 +94,7 @@ public abstract class URLTemplateLoader implements TemplateLoader {
      * an URL that points the template source.
      * @param name the name of the sought template, including the locale
      * decorations.
-     * @return an URL that points to the template source, or null if it can
-     * determine that the template source does not exist.
+     * @return an URL that points to the template source, or {@code null} if the template does not exist.
      */
     protected abstract URL getURL(String name);