added more explanation about the problems encountered with Maven 3
git-svn-id: https://svn.apache.org/repos/asf/maven/shared/trunk@1469781 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/maven/shared/dependency/tree/DependencyTreeBuilder.java b/src/main/java/org/apache/maven/shared/dependency/tree/DependencyTreeBuilder.java
index f312b83..67055ff 100644
--- a/src/main/java/org/apache/maven/shared/dependency/tree/DependencyTreeBuilder.java
+++ b/src/main/java/org/apache/maven/shared/dependency/tree/DependencyTreeBuilder.java
@@ -27,8 +27,10 @@
import org.apache.maven.project.MavenProject;
/**
- * Builds a tree of dependencies for a given Maven 2 project. Notice that it doesn't fail with Maven 3
- * but the result isn't reliable.
+ * Builds a tree of dependencies for a given Maven 2 project. Notice that it doesn't fail with Maven 3,
+ * but when Maven 2 and Maven 3 don't calculate the same transitive dependency result, the tree calculated
+ * with this component is consistent with Maven 2 even if run with Maven 3 (see
+ * <a href="http://jira.codehaus.org/browse/MSHARED-167">MSHARED-167</a>.
*
* @author <a href="mailto:markhobson@gmail.com">Mark Hobson</a>
* @version $Id$
