[MWAR-379] manifest goal violates general Maven principle and creates file into src/main/..
 o Followup to add appropriate hint about removing of the goal.
 o Cleaned up site generation and get site generation working
   removed explicit configuration in site descriptor using inheritance
   instead.
 o Fixed several JavaDoc warnings.


git-svn-id: https://svn.apache.org/repos/asf/maven/plugins/trunk@1756988 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/maven/plugins/war/AbstractWarMojo.java b/src/main/java/org/apache/maven/plugins/war/AbstractWarMojo.java
index 707d803..9336c13 100644
--- a/src/main/java/org/apache/maven/plugins/war/AbstractWarMojo.java
+++ b/src/main/java/org/apache/maven/plugins/war/AbstractWarMojo.java
@@ -412,8 +412,7 @@
     }
 
     /**
-     * Builds the webapp for the specified project with the new packaging task thingy
-     * <p/>
+     * Builds the webapp for the specified project with the new packaging task thingy.
      * Classes, libraries and tld files are copied to the <tt>webappDirectory</tt> during this phase.
      *
      * @param mavenProject the maven project
diff --git a/src/main/java/org/apache/maven/plugins/war/Overlay.java b/src/main/java/org/apache/maven/plugins/war/Overlay.java
index 82f8f7f..43e3292 100644
--- a/src/main/java/org/apache/maven/plugins/war/Overlay.java
+++ b/src/main/java/org/apache/maven/plugins/war/Overlay.java
@@ -26,14 +26,15 @@
 import java.util.List;
 
 /**
+ * <p>
  * An overlay is a skeleton WAR added to another WAR project in order to inject a functionality, resources or any other
- * shared component.
- * <p/>
- * Note that a particular WAR dependency can be added multiple times as an overlay with different includes/excludes
- * filter; this allows building a fine grained overwriting policy.
- * <p/>
- * The current project can also be described as an overlay and can not be specified twice. An overlay with no groupId
- * and no artifactId represents the current project.
+ * shared component.</p>
+ * 
+ * <p>Note that a particular WAR dependency can be added multiple times as an overlay with different includes/excludes
+ * filter; this allows building a fine grained overwriting policy.</p>
+ * 
+ * <p>The current project can also be described as an overlay and can not be specified twice. An overlay with no groupId
+ * and no artifactId represents the current project.</p>
  *
  * @author Stephane Nicoll
  * @version $Id$
diff --git a/src/main/java/org/apache/maven/plugins/war/overlay/OverlayManager.java b/src/main/java/org/apache/maven/plugins/war/overlay/OverlayManager.java
index 5a97a10..eb266c4 100644
--- a/src/main/java/org/apache/maven/plugins/war/overlay/OverlayManager.java
+++ b/src/main/java/org/apache/maven/plugins/war/overlay/OverlayManager.java
@@ -46,7 +46,7 @@
 
     /**
      * Creates a manager with the specified overlays.
-     * <p/>
+     * 
      * Note that the list is potentially updated by the manager so a new list is created based on the overlays.
      *
      * @param overlays the overlays
@@ -157,7 +157,7 @@
 
     /**
      * Returns the Artifact associated to the specified overlay.
-     * <p/>
+     * 
      * If the overlay defines the current project, <tt>null</tt> is returned. If no artifact could not be found for the
      * overlay a InvalidOverlayConfigurationException is thrown.
      *
diff --git a/src/main/java/org/apache/maven/plugins/war/packaging/AbstractWarPackagingTask.java b/src/main/java/org/apache/maven/plugins/war/packaging/AbstractWarPackagingTask.java
index 31aca58..9275f32 100644
--- a/src/main/java/org/apache/maven/plugins/war/packaging/AbstractWarPackagingTask.java
+++ b/src/main/java/org/apache/maven/plugins/war/packaging/AbstractWarPackagingTask.java
@@ -72,10 +72,10 @@
 
     /**
      * Copies the files if possible with an optional target prefix.
-     * <p/>
+     * 
      * Copy uses a first-win strategy: files that have already been copied by previous tasks are ignored. This method
      * makes sure to update the list of protected files which gives the list of files that have already been copied.
-     * <p/>
+     * 
      * If the structure of the source directory is not the same as the root of the webapp, use the <tt>targetPrefix</tt>
      * parameter to specify in which particular directory the files should be copied. Use <tt>null</tt> to copy the
      * files with the same structure
@@ -120,7 +120,7 @@
 
     /**
      * Copies the files if possible as is.
-     * <p/>
+     * 
      * Copy uses a first-win strategy: files that have already been copied by previous tasks are ignored. This method
      * makes sure to update the list of protected files which gives the list of files that have already been copied.
      *
@@ -141,7 +141,7 @@
 
     /**
      * Copy the specified file if the target location has not yet already been used.
-     * <p/>
+     * 
      * The <tt>targetFileName</tt> is the relative path according to the root of the generated web application.
      *
      * @param sourceId the source id
@@ -229,7 +229,7 @@
     /**
      * Copy the specified file if the target location has not yet already been used and filter its content with the
      * configured filter properties.
-     * <p/>
+     * 
      * The <tt>targetFileName</tt> is the relative path according to the root of the generated web application.
      *
      * @param sourceId the source id
@@ -323,7 +323,6 @@
      * don't already exist. if the <code>onlyIfModified</code> flag is <tt>false</tt>, <code>destination</code> will be
      * overwritten if it already exists. If the flag is <tt>true</tt> destination will be overwritten if it's not up to
      * date.
-     * <p/>
      *
      * @param context the packaging context
      * @param source an existing non-directory <code>File</code> to copy bytes from
@@ -455,7 +454,7 @@
 
     /**
      * Returns the final name of the specified artifact.
-     * <p/>
+     * 
      * If the <tt>outputFileNameMapping</tt> is set, it is used, otherwise the standard naming scheme is used.
      *
      * @param context the packaging context
diff --git a/src/main/java/org/apache/maven/plugins/war/packaging/ClassesPackagingTask.java b/src/main/java/org/apache/maven/plugins/war/packaging/ClassesPackagingTask.java
index 42db504..12aa782 100644
--- a/src/main/java/org/apache/maven/plugins/war/packaging/ClassesPackagingTask.java
+++ b/src/main/java/org/apache/maven/plugins/war/packaging/ClassesPackagingTask.java
@@ -33,7 +33,7 @@
 
 /**
  * Handles the classes directory that needs to be packaged in the web application.
- * <p/>
+ * 
  * Based on the {@link WarPackagingContext#archiveClasses()} flag the resources either copied into to
  * <tt>WEB-INF/classes</tt> directory or archived in a jar within the <tt>WEB-INF/lib</tt> directory.
  *
diff --git a/src/main/java/org/apache/maven/plugins/war/packaging/OverlayPackagingTask.java b/src/main/java/org/apache/maven/plugins/war/packaging/OverlayPackagingTask.java
index 057b868..e045bd1 100644
--- a/src/main/java/org/apache/maven/plugins/war/packaging/OverlayPackagingTask.java
+++ b/src/main/java/org/apache/maven/plugins/war/packaging/OverlayPackagingTask.java
@@ -105,7 +105,7 @@
 
     /**
      * Unpacks the specified overlay.
-     * <p/>
+     * 
      * Makes sure to skip the unpack process if the overlay has already been unpacked.
      *
      * @param context the packaging context
diff --git a/src/main/java/org/apache/maven/plugins/war/packaging/WarPackagingTask.java b/src/main/java/org/apache/maven/plugins/war/packaging/WarPackagingTask.java
index f00ae44..d2c0da7 100644
--- a/src/main/java/org/apache/maven/plugins/war/packaging/WarPackagingTask.java
+++ b/src/main/java/org/apache/maven/plugins/war/packaging/WarPackagingTask.java
@@ -33,7 +33,7 @@
 
     /**
      * Performs the packaging for the specified task.
-     * <p/>
+     * 
      * The task is responsible to update the packaging context, namely with the files that have been copied.
      *
      * @param context the packaging context
diff --git a/src/main/java/org/apache/maven/plugins/war/packaging/WarPostPackagingTask.java b/src/main/java/org/apache/maven/plugins/war/packaging/WarPostPackagingTask.java
index f100032..8723049 100644
--- a/src/main/java/org/apache/maven/plugins/war/packaging/WarPostPackagingTask.java
+++ b/src/main/java/org/apache/maven/plugins/war/packaging/WarPostPackagingTask.java
@@ -33,7 +33,7 @@
 
     /**
      * Executes the post packaging task.
-     * <p/>
+     * 
      * The packaging context hold all information regarding the webapp that has been packaged.
      *
      * @param context the packaging context
diff --git a/src/main/java/org/apache/maven/plugins/war/packaging/WarProjectPackagingTask.java b/src/main/java/org/apache/maven/plugins/war/packaging/WarProjectPackagingTask.java
index 2c6cf88..7e0b03e 100644
--- a/src/main/java/org/apache/maven/plugins/war/packaging/WarProjectPackagingTask.java
+++ b/src/main/java/org/apache/maven/plugins/war/packaging/WarProjectPackagingTask.java
@@ -32,9 +32,14 @@
 import org.codehaus.plexus.util.StringUtils;
 
 /**
- * Handles the project own resources, that is: <ul <li>The list of web resources, if any</li> <li>The content of the
- * webapp directory if it exists</li> <li>The custom deployment descriptor(s), if any</li> <li>The content of the
- * classes directory if it exists</li> <li>The dependencies of the project</li> </ul>
+ * Handles the project own resources, that is: 
+ * <ul>
+ * <li>The list of web resources, if any</li>
+ * <li>The content of the webapp directory if it exists</li>
+ * <li>The custom deployment descriptor(s), if any</li>
+ * <li>The content of the classes directory if it exists</li>
+ * <li>The dependencies of the project</li>
+ * </ul>
  *
  * @author Stephane Nicoll
  * @version $Id$
diff --git a/src/main/java/org/apache/maven/plugins/war/util/PathSet.java b/src/main/java/org/apache/maven/plugins/war/util/PathSet.java
index ab64680..ebf5469 100644
--- a/src/main/java/org/apache/maven/plugins/war/util/PathSet.java
+++ b/src/main/java/org/apache/maven/plugins/war/util/PathSet.java
@@ -31,7 +31,7 @@
 
 /**
  * Set of file's paths.
- * <p/>
+ * 
  * The class extends functionality of a "normal" set of strings by a process of the paths normalization. All paths are
  * converted to unix form (slashes) and they don't start with starting /.
  *
@@ -50,7 +50,6 @@
 
     /**
      * The method normalizes the path.
-     * <p/>
      * <ul>
      * <li>changes directory separator to unix's separator(/)</li>
      * <li>deletes all trailing slashes</li>
@@ -220,7 +219,7 @@
 
     /**
      * Adds given prefix to all paths in the set.
-     * <p/>
+     * 
      * The prefix should be ended by '/'. The generated paths are normalized.
      *
      * @param prefix to be added to all items
@@ -262,7 +261,7 @@
     /*-------------------- Universal static mathods ------------------------*/
     /**
      * The method normalizes the path.
-     * <p/>
+     * 
      * <ul>
      * <li>changes directory separator to unix's separator(/)</li>
      * <li>deletes all trailing slashes</li>
diff --git a/src/main/java/org/apache/maven/plugins/war/util/WebappStructure.java b/src/main/java/org/apache/maven/plugins/war/util/WebappStructure.java
index 13e20f8..5d9a4f9 100644
--- a/src/main/java/org/apache/maven/plugins/war/util/WebappStructure.java
+++ b/src/main/java/org/apache/maven/plugins/war/util/WebappStructure.java
@@ -35,7 +35,7 @@
 /**
  * Represents the structure of a web application composed of multiple overlays. Each overlay is registered within this
  * structure with the set of files it holds.
- * <p/>
+ * 
  * Note that this structure is persisted to disk at each invocation to store which owner holds which path (file).
  *
  * @author Stephane Nicoll
@@ -149,10 +149,10 @@
     /**
      * Forces the registration of the specified path for the specified owner. If the file is not registered yet, a
      * simple registration is performed. If the file already exists, the owner changes to the specified one.
-     * <p/>
+     * <p>
      * Beware that the semantic of the return boolean is different than the one from
      * {@link #registerFile(String, String)}; returns <tt>true</tt> if an owner replacement was made and <tt>false</tt>
-     * if the file was simply registered for the first time.
+     * if the file was simply registered for the first time.</p>
      *
      * @param id the owner of the path
      * @param path the relative path from the webapp root directory
@@ -249,9 +249,10 @@
     /**
      * Returns the owners. Note that this the returned {@link Set} may be inconsistent since it represents a persistent
      * cache across multiple invocations.
-     * <p/>
+     * <p>
      * For instance, if an overlay was removed in this execution, it will be still be there till the cache is cleaned.
      * This happens when the clean mojo is invoked.
+     * </p>
      *
      * @return the list of owners
      */
@@ -384,8 +385,9 @@
     /**
      * Returns the cached target file name that matches the specified dependency, that is the target file name of the
      * previous run.
-     * <p/>
+     * <p>
      * The dependency object may have changed so the comparison is based on basic attributes of the dependency.
+     * </p>
      *
      * @param dependency a dependency
      * @return the target file name of the last run for this dependency
@@ -492,7 +494,7 @@
 
         /**
          * Called if the <tt>targetFilename</tt> for the specified <tt>ownerId</tt> has been registered successfully.
-         * <p/>
+         * 
          * This means that the <tt>targetFilename</tt> was unknown and has been registered successfully.
          *
          * @param ownerId the ownerId
@@ -504,7 +506,7 @@
 
         /**
          * Called if the <tt>targetFilename</tt> for the specified <tt>ownerId</tt> has already been registered.
-         * <p/>
+         * 
          * This means that the <tt>targetFilename</tt> was known and belongs to the specified owner.
          *
          * @param ownerId the ownerId
@@ -515,9 +517,10 @@
             throws IOException;
 
         /**
+         * <p>
          * Called if the registration of the <tt>targetFilename</tt> for the specified <tt>ownerId</tt> has been refused
          * since the path already belongs to the <tt>actualOwnerId</tt>.
-         * <p/>
+         * </p> 
          * This means that the <tt>targetFilename</tt> was known and does not belong to the specified owner.
          *
          * @param ownerId the ownerId
@@ -531,7 +534,7 @@
         /**
          * Called if the <tt>targetFilename</tt> for the specified <tt>ownerId</tt> has been registered successfully by
          * superseding a <tt>deprecatedOwnerId</tt>, that is the previous owner of the file.
-         * <p/>
+         * 
          * This means that the <tt>targetFilename</tt> was known but for another owner. This usually happens after a
          * project's configuration change. As a result, the file has been registered successfully to the new owner.
          *
@@ -546,7 +549,7 @@
         /**
          * Called if the <tt>targetFilename</tt> for the specified <tt>ownerId</tt> has been registered successfully by
          * superseding a <tt>unknownOwnerId</tt>, that is an owner that does not exist anymore in the current project.
-         * <p/>
+         * 
          * This means that the <tt>targetFilename</tt> was known but for an owner that does not exist anymore. Hence the
          * file has been registered successfully to the new owner.
          *
diff --git a/src/site/apt/index.apt.vm b/src/site/apt/index.apt.vm
index b0f1e98..713db3e 100644
--- a/src/site/apt/index.apt.vm
+++ b/src/site/apt/index.apt.vm
@@ -29,49 +29,59 @@
 ${project.name}
 
  The WAR Plugin is responsible for collecting all artifact dependencies, classes
- and resources of the web application and packaging them into a web application archive.
+ and resources of the web application and packaging them into a web application 
+ archive.
 
 * Goals Overview
 
- * {{{./war-mojo.html}war:war}} is the default goal invoked during the <<<package>>> phase for projects with a packaging
-   type of <<<war>>>. It builds a WAR file.
+ * {{{./war-mojo.html}war:war}} is the default goal invoked during the 
+   <<<package>>> phase for projects with a packaging type of <<<war>>>. 
+   It builds a WAR file.
 
- * {{{./exploded-mojo.html}war:exploded}} is generally used to speed up testing during the developement phase by creating
-   an exploded webapp in a specified directory.
+ * {{{./exploded-mojo.html}war:exploded}} is generally used to speed up 
+   testing during the developement phase by creating an exploded webapp 
+   in a specified directory.
 
- * {{{./inplace-mojo.html}war:inplace}} another variation of <<<war:explode>>> where the webapp is instead generated in the
-   web application source directory, which is <<<src/main/webapp>>> by default.
-
- * {{{./manifest-mojo.html}war:manifest}} generates a manifest for this webapp. The manifest file is created in the
-   web application source directory.
+ * {{{./inplace-mojo.html}war:inplace}} another variation of <<<war:explode>>> 
+   where the webapp is instead generated in the web application source directory, 
+   which is <<<src/main/webapp>>> by default.
 
  []
 
+ Hint for release 3.0.0: The goal <<<war:manifest>>> has been removed
+ cause it violated the principle generating files into <<<src/>>> folder.
+ Furthermore everything can be done by using an appropriate configuration
+ for the {{{./war-mojo.html#archive}war:war archive}}.
+
+
 * Usage
 
-  General instructions on how to use the WAR Plugin can be found on the {{{./usage.html}usage page}}. Some more
-  specific use cases are described in the examples given below. To share common resources across multiple web
-  applications, see the documentation about using {{{./overlays.html}overlays}}. Last but not least, users occasionally
-  contribute additional examples, tips or errata to the
-  {{{http://docs.codehaus.org/display/MAVENUSER/WAR+Plugin}plugin's wiki page}}.
+  General instructions on how to use the WAR Plugin can be found on the 
+  {{{./usage.html}usage page}}. Some more specific use cases are described in the 
+  examples given below. To share common resources across multiple web applications, 
+  see the documentation about using {{{./overlays.html}overlays}}.
 
-  In case you still have questions regarding the plugin's usage, please have a look at the {{{./faq.html}FAQ}} and feel
-  free to contact the {{{./mail-lists.html}user mailing list}}. The posts to the mailing list are archived and could
-  already contain the answer to your question as part of an older thread. Hence, it is also worth browsing/searching
+  In case you still have questions regarding the plugin's usage, please have a look at the 
+  {{{./faq.html}FAQ}} and feel free to contact the {{{./mail-lists.html}user mailing list}}. 
+  The posts to the mailing list are archived and could already contain the answer to your 
+  question as part of an older thread. Hence, it is also worth browsing/searching
   the {{{./mail-lists.html}mail archive}}.
 
-  If you feel like the plugin is missing a feature or has a defect, you can fill a feature request or bug report in our
-  {{{./issue-tracking.html}issue tracker}}. When creating a new issue, please provide a comprehensive description of your
-  concern. Especially for fixing bugs it is crucial that the developers can reproduce your problem. For this reason,
-  entire debug logs, POMs or most preferably little demo projects attached to the issue are very much appreciated.
-  Of course, patches are welcome, too. Contributors can check out the project from our
-  {{{./source-repository.html}source repository}} and will find supplementary information in the
+  If you feel like the plugin is missing a feature or has a defect, you can fill a 
+  feature request or bug report in our {{{./issue-tracking.html}issue tracker}}. 
+  When creating a new issue, please provide a comprehensive description of your
+  concern. Especially for fixing bugs it is crucial that the developers can 
+  reproduce your problem. For this reason, entire debug logs, POMs or most 
+  preferably little demo projects attached to the issue are very much appreciated.
+  Of course, patches are welcome, too. Contributors can check out the project from 
+  our {{{./source-repository.html}source repository}} and will find supplementary 
+  information in the
   {{{http://maven.apache.org/guides/development/guide-helping.html}guide to helping with Maven}}.
 
 * Examples
 
- To provide you with better understanding on some usages of the Maven WAR Plugin,
- you can take a look into the following examples:
+  To provide you with better understanding on some usages of the Maven WAR Plugin,
+  you can take a look into the following examples:
 
  * {{{./examples/adding-filtering-webresources.html}Adding and Filtering External Web Resources}}
 
diff --git a/src/site/site.xml b/src/site/site.xml
index 00a5559..2f81f26 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -23,31 +23,6 @@
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/DECORATION/1.0.0 http://maven.apache.org/xsd/decoration-1.0.0.xsd">
 
-  <bannerLeft>
-    <src>http://maven.apache.org/images/apache-maven-project.png</src>
-    <href>http://www.apache.org/</href>
-  </bannerLeft>
-
-  <bannerRight>
-    <src>http://maven.apache.org/images/maven-logo-black-on-white.png</src>
-    <href>http://maven.apache.org/</href>
-  </bannerRight>
-  <skin>
-    <groupId>org.apache.maven.skins</groupId>
-    <artifactId>maven-fluido-skin</artifactId>
-    <version>1.4</version>
-  </skin>
-
-  <custom>
-    <fluidoSkin>
-      <sourceLineNumbersEnabled>true</sourceLineNumbersEnabled>
-      <googlePlusOne />
-      <googleSearch>
-        <sitesearch/>
-      </googleSearch>
-    </fluidoSkin>
-  </custom>
-
   <body>
     <menu name="Overview">
       <item name="Introduction" href="index.html"/>
diff --git a/src/test/java/org/apache/maven/plugins/war/AbstractWarExplodedMojoTest.java b/src/test/java/org/apache/maven/plugins/war/AbstractWarExplodedMojoTest.java
index ec0f43b..0372511 100644
--- a/src/test/java/org/apache/maven/plugins/war/AbstractWarExplodedMojoTest.java
+++ b/src/test/java/org/apache/maven/plugins/war/AbstractWarExplodedMojoTest.java
@@ -65,7 +65,7 @@
 
     /**
      * Configures the exploded mojo for the specified test.
-     * <p/>
+     * 
      * If the <tt>sourceFiles</tt> parameter is <tt>null</tt>, sample JSPs are created by default.
      *
      * @param testId the id of the test
@@ -239,7 +239,7 @@
 
     /**
      * Builds the list of files and directories from the specified dir.
-     * <p/>
+     * 
      * Note that the filter is not used the usual way. If the filter does not accept the current file, it's not added
      * but yet the subdirectories are added if any.
      *
diff --git a/src/test/java/org/apache/maven/plugins/war/AbstractWarMojoTest.java b/src/test/java/org/apache/maven/plugins/war/AbstractWarMojoTest.java
index 30ec2e2..2afe122 100644
--- a/src/test/java/org/apache/maven/plugins/war/AbstractWarMojoTest.java
+++ b/src/test/java/org/apache/maven/plugins/war/AbstractWarMojoTest.java
@@ -55,13 +55,13 @@
     /**
      * initialize required parameters
      *
-     * @param mojo
-     * @param filters
-     * @param classesDir
-     * @param webAppSource
-     * @param webAppDir
-     * @param project
-     * @throws Exception
+     * @param mojo The mojo to be tested.
+     * @param filters The list of filters.
+     * @param classesDir The classes directory.
+     * @param webAppSource The webAppSource.
+     * @param webAppDir The webAppDir folder.
+     * @param project The Maven project.
+     * @throws Exception in case of errors
      */
     protected void configureMojo( AbstractWarMojo mojo, List<String> filters, File classesDir, File webAppSource,
                                   File webAppDir, MavenProjectBasicStub project )
@@ -87,10 +87,10 @@
     /**
      * create an isolated xml dir
      *
-     * @param id
-     * @param xmlFiles
-     * @return
-     * @throws Exception
+     * @param id The id.
+     * @param xmlFiles array of xml files.
+     * @return The created file.
+     * @throws Exception in case of errors.
      */
     protected File createXMLConfigDir( String id, String[] xmlFiles )
         throws Exception
@@ -128,9 +128,10 @@
     /**
      * create an isolated web source with a sample jsp file
      *
-     * @param id
-     * @return
-     * @throws Exception
+     * @param id The id.
+     * @param createSamples Create example files yes or no.
+     * @return The created file.
+     * @throws Exception in case of errors.
      */
     protected File createWebAppSource( String id, boolean createSamples )
         throws Exception
@@ -156,10 +157,10 @@
     /**
      * create a class directory with or without a sample class
      *
-     * @param id
-     * @param empty
-     * @return
-     * @throws Exception
+     * @param id The id.
+     * @param empty true to create a class files false otherwise.
+     * @return The created class file.
+     * @throws Exception in case of errors.
      */
     protected File createClassesDir( String id, boolean empty )
         throws Exception
@@ -200,8 +201,7 @@
     }
 
     /**
-     * Generates test war
-     * <p/>
+     * Generates test war.
      * Generates war with such a structure:
      * <ul>
      * <li>jsp
@@ -238,7 +238,6 @@
      * </ul>
      * </li>
      * </ul>
-     * <p/>
      * Each of the files will contain: id+'-'+path
      *
      * @param id the id of the overlay containing the full structure
diff --git a/src/test/java/org/apache/maven/plugins/war/WarExplodedMojoFilteringTest.java b/src/test/java/org/apache/maven/plugins/war/WarExplodedMojoFilteringTest.java
index 554e7d5..e68563f 100644
--- a/src/test/java/org/apache/maven/plugins/war/WarExplodedMojoFilteringTest.java
+++ b/src/test/java/org/apache/maven/plugins/war/WarExplodedMojoFilteringTest.java
@@ -49,7 +49,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_WithResourceFiltering()
         throws Exception
diff --git a/src/test/java/org/apache/maven/plugins/war/WarExplodedMojoTest.java b/src/test/java/org/apache/maven/plugins/war/WarExplodedMojoTest.java
index 8d8525b..5785804 100644
--- a/src/test/java/org/apache/maven/plugins/war/WarExplodedMojoTest.java
+++ b/src/test/java/org/apache/maven/plugins/war/WarExplodedMojoTest.java
@@ -58,7 +58,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testSimpleExplodedWar()
         throws Exception
@@ -103,7 +103,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testSimpleExplodedWarWTargetPath()
         throws Exception
@@ -147,7 +147,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_WithCustomWebXML()
         throws Exception
@@ -185,7 +185,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_WithContainerConfigXML()
         throws Exception
@@ -223,7 +223,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_WithSimpleExternalWARFile()
         throws Exception
@@ -270,6 +270,7 @@
 
     /**
      * Merge a dependent WAR when a file in the war source directory overrides one found in the WAR.
+     * @throws Exception in case of an error.
      */
     public void testExplodedWarMergeWarLocalFileOverride()
         throws Exception
@@ -374,7 +375,7 @@
     // }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_WithEJB()
         throws Exception
@@ -449,7 +450,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_WithEJBClient()
         throws Exception
@@ -487,7 +488,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_WithTLD()
         throws Exception
@@ -525,7 +526,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_WithPAR()
         throws Exception
@@ -562,6 +563,9 @@
         expectedPARArtifact.delete();
     }
 
+    /**
+     * @throws Exception in case of an error.
+     */
     public void testExplodedWarWithAar()
         throws Exception
     {
@@ -599,6 +603,9 @@
         expectedJarArtifact.delete();
     }
 
+    /**
+     * @throws Exception in case of an error.
+     */
     public void testExplodedWarWithMar()
         throws Exception
     {
@@ -636,6 +643,9 @@
         expectedJarArtifact.delete();
     }
 
+    /**
+     * @throws Exception in case of an error.
+     */
     public void testExplodedWarWithXar()
         throws Exception
     {
@@ -674,7 +684,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_WithDuplicateDependencies()
         throws Exception
@@ -720,7 +730,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_DuplicateWithClassifier()
         throws Exception
@@ -772,7 +782,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWar_WithClasses()
         throws Exception
@@ -804,6 +814,9 @@
         expectedClass.delete();
     }
 
+    /**
+     * @throws Exception in case of an error.
+     */
     public void testExplodedWar_WithSourceIncludeExclude()
         throws Exception
     {
@@ -838,6 +851,9 @@
         expectedMETAINFDir.delete();
     }
 
+    /**
+     * @throws Exception in case of an error.
+     */
     public void testExplodedWar_WithWarDependencyIncludeExclude()
         throws Exception
     {
@@ -892,6 +908,9 @@
         expectedExcludedWarfile.delete();
     }
 
+    /**
+     * @throws Exception in case of an error.
+     */
     public void testExplodedWarWithSourceModificationCheck()
         throws Exception
     {
@@ -945,6 +964,9 @@
         expectedWebSource2File.delete();
     }
 
+    /**
+     * @throws Exception in case of an error.
+     */
     public void testExplodedWarWithOutputFileNameMapping()
         throws Exception
     {
@@ -983,7 +1005,7 @@
     }
 
     /**
-     * @throws Exception
+     * @throws Exception in case of an error.
      */
     public void testExplodedWarWithOutputFileNameMappingAndDuplicateDependencies()
         throws Exception
diff --git a/src/test/java/org/apache/maven/plugins/war/WarInPlaceMojoTest.java b/src/test/java/org/apache/maven/plugins/war/WarInPlaceMojoTest.java
index 4672332..048dc1e 100644
--- a/src/test/java/org/apache/maven/plugins/war/WarInPlaceMojoTest.java
+++ b/src/test/java/org/apache/maven/plugins/war/WarInPlaceMojoTest.java
@@ -55,9 +55,6 @@
         // see setUp
     }
 
-    /**
-     * @throws Exception
-     */
     public void testSimpleExplodedInplaceWar()
         throws Exception
     {
diff --git a/src/test/java/org/apache/maven/plugins/war/WarOverlaysTest.java b/src/test/java/org/apache/maven/plugins/war/WarOverlaysTest.java
index 869b027..25768da 100644
--- a/src/test/java/org/apache/maven/plugins/war/WarOverlaysTest.java
+++ b/src/test/java/org/apache/maven/plugins/war/WarOverlaysTest.java
@@ -161,7 +161,7 @@
 
     /**
      * Merge a dependent WAR when a file in the war source directory overrides one found in the WAR.
-     * <p/>
+     * 
      * It also tests completeness of the resulting war as well as the proper order of dependencies.
      *
      * @throws Exception if any error occurs
@@ -186,7 +186,7 @@
 
     /**
      * Tests that specifying the overlay explicitely has the same behavior as the default (i.e. order, etc).
-     * <p/>
+     * 
      * The default project is not specified in this case so it is processed first by default
      *
      * @throws Exception if an error occurs
@@ -219,7 +219,7 @@
 
     /**
      * Tests that specifying the overlay explicitely has the same behavior as the default (i.e. order, etc).
-     * <p/>
+     * 
      * The default project is explicitely specified so this should match the default.
      *
      * @throws Exception if an error occurs
@@ -555,7 +555,7 @@
 
     /**
      * Asserts that the content of an overlayed file is correct.
-     * <p/>
+     * 
      * Note that the <tt>filePath</tt> is relative to both the webapp directory and the overlayed directory, defined by
      * the <tt>overlayId</tt>.
      *
@@ -576,7 +576,7 @@
 
     /**
      * Asserts that the content of an overlayed file is correct.
-     * <p/>
+     * 
      * Note that the <tt>filePath</tt> is relative to both the webapp directory and the overlayed directory, defined by
      * the <tt>overlayId</tt>.
      *