UNITSOFMEASUREMENT-194: JavaDoc

Task-Url: https://java.net/jira/browse/UNITSOFMEASUREMENT-194

Author: keilw

src/main/java/javax/measure/spi/ServiceProvider.java

@@ -133,15 +133,19 @@ public int compare(ServiceProvider p1, ServiceProvider p2) {
    * @return all available service providers.
    */
   public static List<ServiceProvider> available() {
-    return Arrays.asList(getProviders()); // .clone();
+    return Arrays.asList(getProviders());
   }
 
   /**
    * Returns the current {@link ServiceProvider}. If necessary the {@link ServiceProvider} will be lazily loaded.
-   *
+   * <p>
+   * If there are no providers available, an {@linkplain IllegalStateException} is thrown, otherwise the provider with the highest priority is used or the one explicitly designated via {@link setCurrent()} .
+   * </p>
    * @return the {@link ServiceProvider} used.
    * @throws IllegalStateException
    *           if no {@link ServiceProvider} has been found.
+   * @see #getPriority()
+   * @see #setCurrent()
    */
   public static ServiceProvider current() {
     ServiceProvider[] p = getProviders();