SI-5949 updates documentation of staticClass

1 files changed, 18 insertions, 0 deletions

diff --git a/src/library/scala/reflect/base/MirrorOf.scala b/src/library/scala/reflect/base/MirrorOf.scala
index 03e035cd81..d030ace96c 100644
--- a/src/library/scala/reflect/base/MirrorOf.scala
+++ b/src/library/scala/reflect/base/MirrorOf.scala
@@ -15,6 +15,24 @@ abstract class MirrorOf[U <: base.Universe with Singleton] {
 
   /** The symbol corresponding to the globally accessible class with the
    *  given fully qualified name `fullName`.
+   *
+   *  If the name points to a type alias, it's recursively dealiased and its target is returned.
+   *  If you need a symbol that corresponds to the type alias itself, load it directly from the package class:
+   *
+   *    scala> cm.staticClass("scala.List")
+   *    res0: reflect.runtime.universe.ClassSymbol = class List
+   *
+   *    scala> res0.fullName
+   *    res1: String = scala.collection.immutable.List
+   *
+   *    scala> cm.staticModule("scala")
+   *    res2: reflect.runtime.universe.ModuleSymbol = package scala
+   *
+   *    scala> res2.moduleClass.typeSignature member newTypeName("List")
+   *    res3: reflect.runtime.universe.Symbol = type List
+   *
+   *    scala> res3.fullName
+   *    res4: String = scala.List
    */
   def staticClass(fullName: String): U#ClassSymbol