diff --git a/ivy/src/main/scala/sbt/UpdateReport.scala b/ivy/src/main/scala/sbt/UpdateReport.scala
index 41ea4fd80..f26f3fc10 100644
--- a/ivy/src/main/scala/sbt/UpdateReport.scala
+++ b/ivy/src/main/scala/sbt/UpdateReport.scala
@@ -47,6 +47,7 @@ final class ConfigurationReport(
     val configuration: String,
     val modules: Seq[ModuleReport],
     val details: Seq[ModuleDetailReport],
+    @deprecated("Use details instead to get better eviction info.", "0.13.6")
     val evicted: Seq[ModuleID]) {
   def this(configuration: String, modules: Seq[ModuleReport], evicted: Seq[ModuleID]) =
     this(configuration, modules, Nil, evicted)
@@ -67,9 +68,15 @@ final class ConfigurationReport(
 }
 
 /**
+ * ModuleDetailReport represents an organization+name entry in Ivy resolution report.
  * In sbt's terminology, "module" consists of organization, name, and version.
  * In Ivy's, "module" means just organization and name, and the one including version numbers
  * are called revisions.
+ *
+ * A sequence of ModuleDetailReport called details is newly added to ConfigurationReport, replacing evicted.
+ * (Note old evicted was just a seq of ModuleIDs).
+ * ModuleDetailReport groups the ModuleReport of both winners and evicted reports by their organization and name,
+ * which can be used to calculate detailed evction warning etc.
  */
 final class ModuleDetailReport(
     val organization: String,