(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 <[email protected]> Authored: Sat Feb 11 18:50:35 2017 +0100 Committer: ddekany <[email protected]> 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);
