Add some javadoc

Author: cstamas

compat/maven-resolver-provider/src/main/java/org/apache/maven/repository/internal/type/TypeDeriver.java

@@ -44,7 +44,9 @@
  * children need to be remapped to certain processor type as well, to end up on proper path type.
  *
  * @since 4.0.0
+ * @deprecated since 4.0.0, this is internal detail of Maven.
  */
+@Deprecated(since = "4.0.0")
 public class TypeDeriver implements DependencyGraphTransformer {
     private final Logger logger = LoggerFactory.getLogger(getClass());
 

impl/maven-impl/src/main/java/org/apache/maven/impl/resolver/type/DefaultType.java

@@ -36,7 +36,7 @@
 import static java.util.Objects.requireNonNull;
 
 /**
- * Default implementation of {@link Type} and Resolver {@link ArtifactType}.
+ * Default implementation of {@link Type} and adapter for Resolver {@link ArtifactType}.
  *
  * @since 4.0.0
  */
@@ -119,6 +119,12 @@ public String toString() {
                 + properties + ']';
     }
 
+    /**
+     * Adapts this instance to Resolver {@link ArtifactType}.
+     * <p>
+     * Note: one notable difference exists, the {@link #getClassifier()} method behavior.
+     * Once that harmonized, this adapting can go away.
+     */
     public ArtifactType toArtifactType() {
         return new ArtifactTypeAdapter(this);
     }

impl/maven-impl/src/main/java/org/apache/maven/impl/resolver/type/DefaultTypeProvider.java

@@ -27,6 +27,9 @@
 import org.apache.maven.api.di.Named;
 import org.apache.maven.api.spi.TypeProvider;
 
+/**
+ * Maven 4 default {@link TypeProvider} implementation.
+ */
 @Named
 public class DefaultTypeProvider implements TypeProvider {
     @SuppressWarnings({"rawtypes", "unchecked"})

impl/maven-impl/src/main/java/org/apache/maven/impl/resolver/type/TypeDeriver.java

@@ -40,8 +40,16 @@
 import static java.util.Objects.requireNonNull;
 
 /**
- * Type deriver, that handles special case of "processor" type: if a dependency node is of this type, all of its
- * children need to be remapped to certain processor type as well, to end up on proper path type.
+ * Type deriver, that handles special cases of "processor" (annotation processor) node transitive dependencies: all
+ * children of "processor" type are "redirected" to corresponding processor subtypes:
+ * <ul>
+ *     <li>{@code jar -> processor}</li>
+ *     <li>{@code classpathJar -> classpathProcessor}</li>
+ *     <li>{@code modularJar -> modularProcessor}</li>
+ * </ul>
+ *
+ * Maven 4 introduces new types to describe intent of dependencies, and the "processor" new type (and it's subtypes)
+ * will add processors and their dependencies to proper processor paths, as modern Java versions require.
  *
  * @since 4.0.0
  */

impl/maven-impl/src/main/java/org/apache/maven/impl/resolver/type/TypeRegistryAdapter.java

@@ -26,6 +26,9 @@
 
 import static java.util.Objects.requireNonNull;
 
+/**
+ * Adapter between Maven {@link TypeRegistry} and Resolver {@link ArtifactTypeRegistry}.
+ */
 public class TypeRegistryAdapter implements ArtifactTypeRegistry {
     private final TypeRegistry typeRegistry;