docs for reflection and macros

1 files changed, 8 insertions, 3 deletions

diff --git a/src/reflect/scala/reflect/macros/Names.scala b/src/reflect/scala/reflect/macros/Names.scala
index fab9bbbca5..20e750b225 100644
--- a/src/reflect/scala/reflect/macros/Names.scala
+++ b/src/reflect/scala/reflect/macros/Names.scala
@@ -1,15 +1,20 @@
 package scala.reflect
 package macros
 
+/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that
+ *  provides functions that generate unique names.
+ */
 trait Names {
   self: Context =>
 
-  /** Creates a fresh string */
+  /** Creates a unique string. */
   def fresh(): String
 
-  /** Creates a fresh string from the provided string */
+  /** Creates a unique string having a given prefix. */
   def fresh(name: String): String
 
-  /** Creates a fresh name from the provided name */
+  /** Creates a unique name having a given name as a prefix and
+   *  having the same flavor (term name or type name) as the given name.
+   */
   def fresh[NameType <: Name](name: NameType): NameType
 }