summaryrefslogtreecommitdiff
path: root/src/reflect/scala/reflect/api/Annotations.scala
diff options
context:
space:
mode:
authorHeather Miller <heather.miller@epfl.ch>2012-11-02 02:32:07 +0100
committerHeather Miller <heather.miller@epfl.ch>2012-11-02 15:00:21 +0100
commit06c71e7743259b0bc4670590dcdf3273d04d0953 (patch)
tree4a09c32666c5e18270439788c4867ead19bca720 /src/reflect/scala/reflect/api/Annotations.scala
parentebf5c2296bcb317748913ac37a03615c98f75a7e (diff)
downloadscala-06c71e7743259b0bc4670590dcdf3273d04d0953.tar.gz
scala-06c71e7743259b0bc4670590dcdf3273d04d0953.tar.bz2
scala-06c71e7743259b0bc4670590dcdf3273d04d0953.zip
SI-6132 Revisited, cleaned-up, links fixed, spelling errors fixed, rewordings
Diffstat (limited to 'src/reflect/scala/reflect/api/Annotations.scala')
-rw-r--r--src/reflect/scala/reflect/api/Annotations.scala17
1 files changed, 10 insertions, 7 deletions
diff --git a/src/reflect/scala/reflect/api/Annotations.scala b/src/reflect/scala/reflect/api/Annotations.scala
index ebfd57038c..09eaf7afb4 100644
--- a/src/reflect/scala/reflect/api/Annotations.scala
+++ b/src/reflect/scala/reflect/api/Annotations.scala
@@ -16,9 +16,9 @@ import scala.collection.immutable.ListMap
* is automatically added as a subclass to every Java annotation.</li>
* <li>''Scala annotations'': annotations on definitions or types produced by the Scala compiler.</li>
* </ul>
- *
- * When a Scala annotation that inherits from [[scala.annotation.StaticAnnotation]] or [[scala.annotation.ClassfileAnnotation]] is compiled,
- * it is stored as special attributes in the corresponding classfile, and not as a Java annotation. Note that subclassing
+ *
+ * When a Scala annotation that inherits from [[scala.annotation.StaticAnnotation]] or [[scala.annotation.ClassfileAnnotation]] is compiled,
+ * it is stored as special attributes in the corresponding classfile, and not as a Java annotation. Note that subclassing
* just [[scala.annotation.Annotation]] is not enough to have the corresponding metadata persisted for runtime reflection.
*
* The distinction between Java and Scala annotations is manifested in the contract of [[scala.reflect.api.Annotations#Annotation]], which exposes
@@ -32,7 +32,10 @@ import scala.collection.immutable.ListMap
* - arrays and
* - nested annotations.
*
+ * For more information about `Annotation`s, see the [[http://docs.scala-lang.org/overviews/reflection/annotations-names-scopes.html Reflection Guide: Annotations, Names, Scopes, and More]]
+ *
* @contentDiagram hideNodes "*Api"
+ * @group ReflectionAPI
*/
trait Annotations { self: Universe =>
@@ -48,7 +51,7 @@ trait Annotations { self: Universe =>
*/
implicit val AnnotationTag: ClassTag[Annotation]
- /** The constructor/deconstructor for `Annotation` instances.
+ /** The constructor/extractor for `Annotation` instances.
* @group Extractors
*/
val Annotation: AnnotationExtractor
@@ -105,7 +108,7 @@ trait Annotations { self: Universe =>
*/
implicit val LiteralArgumentTag: ClassTag[LiteralArgument]
- /** The constructor/deconstructor for `LiteralArgument` instances.
+ /** The constructor/extractor for `LiteralArgument` instances.
* @group Extractors
*/
val LiteralArgument: LiteralArgumentExtractor
@@ -140,7 +143,7 @@ trait Annotations { self: Universe =>
*/
implicit val ArrayArgumentTag: ClassTag[ArrayArgument]
- /** The constructor/deconstructor for `ArrayArgument` instances.
+ /** The constructor/extractor for `ArrayArgument` instances.
* @group Extractors
*/
val ArrayArgument: ArrayArgumentExtractor
@@ -175,7 +178,7 @@ trait Annotations { self: Universe =>
*/
implicit val NestedArgumentTag: ClassTag[NestedArgument]
- /** The constructor/deconstructor for `NestedArgument` instances.
+ /** The constructor/extractor for `NestedArgument` instances.
* @group Extractors
*/
val NestedArgument: NestedArgumentExtractor