Index: /home/tverhagen/dev_ext/ivy/src/java/org/apache/ivy/util/url/URLHandler.java
===================================================================
--- /home/tverhagen/dev_ext/ivy/src/java/org/apache/ivy/util/url/URLHandler.java	(revision 552422)
+++ /home/tverhagen/dev_ext/ivy/src/java/org/apache/ivy/util/url/URLHandler.java	(working copy)
@@ -117,10 +117,12 @@
     public long getLastModified(URL url, int timeout);
 
     /**
-     * never returns null, return UNAVAILABLE when url is not reachable
+     * Returns the URLInfo of the given url or a {@link #UNAVAILABLE} instance,
+     * if the url is not reachable.
      * 
-     * @param url
-     * @return
+     * @param  url  The url from which information is retrieved.
+     * @return  The URLInfo extracted from the given url, or {@link #UNAVAILABLE} when
+     *          the url is not available.
      */
     public URLInfo getURLInfo(URL url);
 
@@ -127,8 +129,10 @@
     /**
      * never returns null, return UNAVAILABLE when url is not reachable
      * 
-     * @param url
-     * @return
+     * @param  url  The url from which information is retrieved.
+     * @param  timeout  The timeout in milliseconds.
+     * @return  The URLInfo extracted from the given url, or {@link #UNAVAILABLE} when
+     *          the url is not available.
      */
     public URLInfo getURLInfo(URL url, int timeout);