Improve Javadoc of ReflectionSupport.tryToGetResources methods

Closes #4791.

Author: marcphilipp

junit-platform-commons/src/main/java/org/junit/platform/commons/support/ReflectionSupport.java

@@ -104,9 +104,10 @@ public static Try<Class<?>> tryToLoadClass(String name, ClassLoader classLoader)
 	 *
 	 * @param classpathResourceName the name of the resource to load; never
 	 * {@code null} or blank
-	 * @return a successful {@code Try} containing the loaded resources or a failed
-	 * {@code Try} containing the exception if no such resources could be loaded;
-	 * never {@code null}
+	 * @return a successful {@code Try} containing the set of loaded resources
+	 * (potentially empty) or a failed {@code Try} containing the exception in
+	 * case a failure occurred while trying to list resources; never
+	 * {@code null}
 	 * @since 1.12
 	 * @see #tryToGetResources(String, ClassLoader)
 	 */
@@ -128,9 +129,10 @@ public static Try<Set<Resource>> tryToGetResources(String classpathResourceName)
 	 * @param classpathResourceName the name of the resource to load; never
 	 * {@code null} or blank
 	 * @param classLoader the {@code ClassLoader} to use; never {@code null}
-	 * @return a successful {@code Try} containing the loaded resources or a failed
-	 * {@code Try} containing the exception if no such resources could be loaded;
-	 * never {@code null}
+	 * @return a successful {@code Try} containing the set of loaded resources
+	 * (potentially empty) or a failed {@code Try} containing the exception in
+	 * case a failure occurred while trying to list resources; never
+	 * {@code null}
 	 * @since 1.12
 	 * @see #tryToGetResources(String)
 	 */

junit-platform-commons/src/main/java/org/junit/platform/commons/util/ReflectionUtils.java

@@ -774,31 +774,15 @@ public static Try<Class<?>> tryToLoadClass(String name, ClassLoader classLoader)
 	}
 
 	/**
-	 * Try to get {@linkplain Resource resources} by their name, using the
-	 * {@link ClassLoaderUtils#getDefaultClassLoader()}.
-	 *
-	 * <p>See {@link org.junit.platform.commons.support.ReflectionSupport#tryToGetResources(String)}
-	 * for details.
-	 *
-	 * @param classpathResourceName the name of the resources to load; never {@code null} or blank
-	 * @since 1.12
-	 * @see org.junit.platform.commons.support.ReflectionSupport#tryToGetResources(String, ClassLoader)
+	 * @see org.junit.platform.commons.support.ReflectionSupport#tryToGetResources(String)
 	 */
 	@API(status = INTERNAL, since = "1.12")
 	public static Try<Set<Resource>> tryToGetResources(String classpathResourceName) {
 		return tryToGetResources(classpathResourceName, ClassLoaderUtils.getDefaultClassLoader());
 	}
 
 	/**
-	 * Try to get {@linkplain Resource resources} by their name, using the
-	 * supplied {@link ClassLoader}.
-	 *
-	 * <p>See {@link org.junit.platform.commons.support.ReflectionSupport#tryToGetResources(String, ClassLoader)}
-	 * for details.
-	 *
-	 * @param classpathResourceName the name of the resources to load; never {@code null} or blank
-	 * @param classLoader the {@code ClassLoader} to use; never {@code null}
-	 * @since 1.12
+	 * @see org.junit.platform.commons.support.ReflectionSupport#tryToGetResources(String, ClassLoader)
 	 */
 	@API(status = INTERNAL, since = "1.12")
 	public static Try<Set<Resource>> tryToGetResources(String classpathResourceName, ClassLoader classLoader) {