improve javadoc

Author: hboutemy

src/main/java/org/apache/maven/plugins/assembly/filter/ComponentsXmlArchiverFileFilter.java

@@ -45,7 +45,7 @@
 import java.util.Map;
 
 /**
- * Components XML file filter.
+ * <code>plexus</code>: Plexus Components XML file filter <code>META-INF/plexus/components.xml</code>.
  *
  * @author <a href="mailto:brett@apache.org">Brett Porter</a>
  *

src/main/java/org/apache/maven/plugins/assembly/filter/MetaInfServicesHandler.java

@@ -26,7 +26,7 @@
 import org.codehaus.plexus.components.io.fileselectors.FileInfo;
 
 /**
- *
+ * <code>metaInf-services</code>: <code>META-INF/services/*</code> aggregating handler.
  */
 @Named( "metaInf-services" )
 public class MetaInfServicesHandler

src/main/java/org/apache/maven/plugins/assembly/filter/MetaInfSpringHandler.java

@@ -24,7 +24,7 @@
 import org.codehaus.plexus.components.io.fileselectors.FileInfo;
 
 /**
- *
+ * <code>metaInf-spring</code>: Spring's <code>META-INF/spring.*</code> aggregating handler.
  */
 @Named( "metaInf-spring" )
 public class MetaInfSpringHandler

src/main/java/org/apache/maven/plugins/assembly/filter/SimpleAggregatingDescriptorHandler.java

@@ -44,7 +44,7 @@
 import java.util.List;
 
 /**
- *
+ * <code>file-aggregator</code>: Generic aggregating handler, configured with filePattern and outputPath.
  */
 @Named( "file-aggregator" )
 public class SimpleAggregatingDescriptorHandler implements ContainerDescriptorHandler

src/main/java/org/apache/maven/plugins/assembly/io/URLLocation.java

@@ -26,7 +26,7 @@
 import org.apache.commons.io.IOUtils;
 
 /**
- * The URL Location.
+ * The URL Location, storing the URL content to a temporary local file.
  *
  */
 class URLLocation