Add comment by Mark Hobson for getDepth deprecation
git-svn-id: https://svn.apache.org/repos/asf/maven/shared/trunk@570740 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/maven/shared/dependency/tree/DependencyNode.java b/src/main/java/org/apache/maven/shared/dependency/tree/DependencyNode.java
index 6442d96..79cf8c0 100644
--- a/src/main/java/org/apache/maven/shared/dependency/tree/DependencyNode.java
+++ b/src/main/java/org/apache/maven/shared/dependency/tree/DependencyNode.java
@@ -360,9 +360,13 @@
/**
* Gets the depth of this dependency node within its hierarchy.
- *
+ *
* @return the depth
- * @deprecated As of 1.1, depth is computed by node hierarchy
+ * @deprecated As of 1.1, depth is computed by node hierarchy. With the introduction of node
+ * visitors and filters since it can give misleading results. For example, consider
+ * serialising a tree with a filter using a visitor: getDepth would return the
+ * unfiltered depth of a node, whereas the correct depth would be calculated by the
+ * visitor.
*/
public int getDepth()
{
