More corrections in documentation.

Author: desruisseaux

api/maven-api-core/src/main/java/org/apache/maven/api/SourceRoot.java

@@ -55,6 +55,8 @@ default Path directory() {
      * <p>
      * The default implementation returns an empty list, which means to apply a language-dependent pattern.
      * For example, for the Java language, the pattern includes all files with the {@code .java} suffix.
+     *
+     * @see java.nio.file.FileSystem#getPathMatcher(String)
      */
     default List<String> includes() {
         return List.of();

impl/maven-impl/src/main/java/org/apache/maven/impl/DefaultSourceRoot.java

@@ -153,8 +153,8 @@ public DefaultSourceRoot(final ProjectScope scope, final Language language, fina
      * @param scope scope of source code (main or test)
      * @param language language of the source code
      * @param directory directory of the source code
-     * @param includes list of patterns for the files to include, or {@code null} if unspecified
-     * @param excludes list of patterns for the files to exclude, or {@code null} if nothing to exclude
+     * @param includes patterns for the files to include, or {@code null} or empty if unspecified
+     * @param excludes patterns for the files to exclude, or {@code null} or empty if nothing to exclude
      */
     public DefaultSourceRoot(
             final ProjectScope scope,
@@ -196,7 +196,7 @@ public Path directory() {
     }
 
     /**
-     * {@return the list of patterns for the files to include}.
+     * {@return the patterns for the files to include}.
      */
     @Override
     @SuppressWarnings("ReturnOfCollectionOrArrayField") // Safe because unmodifiable
@@ -205,7 +205,7 @@ public List<String> includes() {
     }
 
     /**
-     * {@return the list of patterns for the files to exclude}.
+     * {@return the patterns for the files to exclude}.
      */
     @Override
     @SuppressWarnings("ReturnOfCollectionOrArrayField") // Safe because unmodifiable

impl/maven-impl/src/main/java/org/apache/maven/impl/PathSelector.java

@@ -30,7 +30,7 @@
 import java.util.Set;
 
 /**
- * Determines whether a path is selected according include/exclude patterns.
+ * Determines whether a path is selected according to include/exclude patterns.
  * The pathnames used for method parameters will be relative to some base directory
  * and use {@code '/'} as separator, regardless the hosting operating system.
  *
@@ -463,7 +463,6 @@ private static void append(StringBuilder buffer, String label, String[] patterns
 
     /**
      * {@return a string representation for logging purposes}.
-     * This string representation is reported logged when {@link Cleaner} is executed.
      */
     @Override
     public String toString() {