Updated Branches: refs/heads/master 2351cc1bb -> 82eba2a03
improved javadoc Project: http://git-wip-us.apache.org/repos/asf/maven/repo Commit: http://git-wip-us.apache.org/repos/asf/maven/commit/82eba2a0 Tree: http://git-wip-us.apache.org/repos/asf/maven/tree/82eba2a0 Diff: http://git-wip-us.apache.org/repos/asf/maven/diff/82eba2a0 Branch: refs/heads/master Commit: 82eba2a03f90ce9b38bc1fb2b58b9b515ecd53a9 Parents: 2351cc1 Author: Hervé Boutemy <hbout...@apache.org> Authored: Sun Jul 28 14:08:13 2013 +0200 Committer: Hervé Boutemy <hbout...@apache.org> Committed: Sun Jul 28 14:08:13 2013 +0200 ---------------------------------------------------------------------- .../apache/maven/exception/ExceptionHandler.java | 5 +++++ .../apache/maven/exception/ExceptionSummary.java | 17 ++++++++++------- 2 files changed, 15 insertions(+), 7 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/maven/blob/82eba2a0/maven-core/src/main/java/org/apache/maven/exception/ExceptionHandler.java ---------------------------------------------------------------------- diff --git a/maven-core/src/main/java/org/apache/maven/exception/ExceptionHandler.java b/maven-core/src/main/java/org/apache/maven/exception/ExceptionHandler.java index 4dec0ee..945edf6 100644 --- a/maven-core/src/main/java/org/apache/maven/exception/ExceptionHandler.java +++ b/maven-core/src/main/java/org/apache/maven/exception/ExceptionHandler.java @@ -19,6 +19,11 @@ package org.apache.maven.exception; * under the License. */ +/** + * Transform an exception into useful end-user message. + * + * @since 3.0-alpha-3 + */ public interface ExceptionHandler { ExceptionSummary handleException( Throwable e ); http://git-wip-us.apache.org/repos/asf/maven/blob/82eba2a0/maven-core/src/main/java/org/apache/maven/exception/ExceptionSummary.java ---------------------------------------------------------------------- diff --git a/maven-core/src/main/java/org/apache/maven/exception/ExceptionSummary.java b/maven-core/src/main/java/org/apache/maven/exception/ExceptionSummary.java index 048698e..2b7f27b 100644 --- a/maven-core/src/main/java/org/apache/maven/exception/ExceptionSummary.java +++ b/maven-core/src/main/java/org/apache/maven/exception/ExceptionSummary.java @@ -22,13 +22,16 @@ package org.apache.maven.exception; import java.util.Collections; import java.util.List; -// provide a -// - the exception -// - useful message -// - useful reference to a solution, or set of solutions -// - the configuration gleaned for examination -// - plugin repositories - +/** + * Provide a summary of the exception, containing:<ul> + * <li>the exception itself,</li> + * <li>useful end-user message,</li> + * <li>useful reference to a solution, or set of solutions: this is usually a wiki page url in + * <a href="http://cwiki.apache.org/confluence/display/MAVEN/";>http://cwiki.apache.org/confluence/display/MAVEN/</a>, + * </li> + * <li>child exception summaries.</li> + * </ul> + */ public class ExceptionSummary {
