From f3eec9f52cc7a1f397ade8279a910e2b3153fd72 Mon Sep 17 00:00:00 2001
From: Artur Signell <artur.signell@itmill.com>
Date: Tue, 25 May 2010 10:21:21 +0000
Subject: [PATCH] Javadoc #4922

svn changeset:13347/svn branch:6.4
---
 src/com/vaadin/terminal/URIHandler.java | 27 +++++++++++--------------
 1 file changed, 12 insertions(+), 15 deletions(-)

diff --git a/src/com/vaadin/terminal/URIHandler.java b/src/com/vaadin/terminal/URIHandler.java
index fe1746201e..2d5facb28e 100644
--- a/src/com/vaadin/terminal/URIHandler.java
+++ b/src/com/vaadin/terminal/URIHandler.java
@@ -8,12 +8,10 @@ import java.io.Serializable;
 import java.net.URL;
 
 /**
- * Interface implemented by all the classes capable of handling URI:s.
- * 
- * <p>
- * <code>URIHandler</code> can provide <code>DownloadStream</code> for
- * transferring data for client.
- * </p>
+ * A URIHandler is used for handling URI:s requested by the user and can
+ * optionally provide a {@link DownloadStream}. If a {@link DownloadStream} is
+ * returned by {@link #handleURI(URL, String)}, the stream is sent to the
+ * client.
  * 
  * @author IT Mill Ltd.
  * @version
@@ -23,27 +21,26 @@ import java.net.URL;
 public interface URIHandler extends Serializable {
 
     /**
-     * Handles a given relative URI. If the URI handling wants to emit a
-     * downloadable stream it can return download stream object. If no emitting
-     * stream is necessary, null should be returned instead.
+     * Handles a given URI. If the URI handler to emit a downloadable stream it
+     * should return a {@code DownloadStream} object.
      * 
      * @param context
-     *            the URl.
+     *            the base URL
      * @param relativeUri
-     *            the relative uri.
-     * @return the download stream object.
+     *            a URI relative to {@code context}
+     * @return A downloadable stream or null if no stream is provided
      */
     public DownloadStream handleURI(URL context, String relativeUri);
 
     /**
-     * URIHandler error event.
+     * An {@code ErrorEvent} implementation for URIHandler.
      */
     public interface ErrorEvent extends Terminal.ErrorEvent {
 
         /**
-         * Gets the source URIHandler.
+         * Gets the URIHandler that caused this error.
          * 
-         * @return the URIHandler.
+         * @return the URIHandler that caused the error
          */
         public URIHandler getURIHandler();
 
-- 
2.39.5