improved documentation

5 files changed, 20 insertions, 15 deletions

diff --git a/src/library/scala/annotation/target/beanGetter.scala b/src/library/scala/annotation/target/beanGetter.scala
index 2490dd871e..cc39a32874 100644
--- a/src/library/scala/annotation/target/beanGetter.scala
+++ b/src/library/scala/annotation/target/beanGetter.scala
@@ -18,7 +18,8 @@ package scala.annotation.target
  * behavior can be changed.
  *
  * In the following example, the annotation {{{@Id}}} will be added
- * to the bean getter {{{getX}}}
+ * only to the bean getter {{{getX}}}. In order to annotate the field
+ * as well, the meta-annotation {{{@field}}} would need to be added.
  *
  * {{{
  * import javax.persistence.Id
@@ -30,10 +31,10 @@ package scala.annotation.target
  * The syntax can be improved using a type alias:
  *
  * {{{
- * object myAnnotations {
+ * object ScalaJPA {
  *   type Id = javax.persistence.Id @beanGetter
  * }
- * import myAnnotations.Id
+ * import ScalaJPA.Id
  * class A {
  *   @Id @BeanProperty val x = 0
  * }
diff --git a/src/library/scala/annotation/target/beanSetter.scala b/src/library/scala/annotation/target/beanSetter.scala
index 57c62ee764..5f1513fd51 100644
--- a/src/library/scala/annotation/target/beanSetter.scala
+++ b/src/library/scala/annotation/target/beanSetter.scala
@@ -18,7 +18,8 @@ package scala.annotation.target
  * behavior can be changed.
  *
  * In the following example, the annotation {{{@Id}}} will be added
- * to the bean getter {{{getX}}}
+ * only to the bean getter {{{getX}}}. In order to annotate the field
+ * as well, the meta-annotation {{{@field}}} would need to be added.
  *
  * {{{
  * import javax.persistence.Id
@@ -30,10 +31,10 @@ package scala.annotation.target
  * The syntax can be improved using a type alias:
  *
  * {{{
- * object myAnnotations {
+ * object ScalaJPA {
  *   type Id = javax.persistence.Id @beanGetter
  * }
- * import myAnnotations.Id
+ * import ScalaJPA.Id
  * class A {
  *   @Id @BeanProperty val x = 0
  * }
diff --git a/src/library/scala/annotation/target/field.scala b/src/library/scala/annotation/target/field.scala
index 5d0277fade..19533c6908 100644
--- a/src/library/scala/annotation/target/field.scala
+++ b/src/library/scala/annotation/target/field.scala
@@ -18,7 +18,8 @@ package scala.annotation.target
  * behavior can be changed.
  *
  * In the following example, the annotation {{{@Id}}} will be added
- * to the bean getter {{{getX}}}
+ * only to the bean getter {{{getX}}}. In order to annotate the field
+ * as well, the meta-annotation {{{@field}}} would need to be added.
  *
  * {{{
  * import javax.persistence.Id
@@ -30,10 +31,10 @@ package scala.annotation.target
  * The syntax can be improved using a type alias:
  *
  * {{{
- * object myAnnotations {
+ * object ScalaJPA {
  *   type Id = javax.persistence.Id @beanGetter
  * }
- * import myAnnotations.Id
+ * import ScalaJPA.Id
  * class A {
  *   @Id @BeanProperty val x = 0
  * }
diff --git a/src/library/scala/annotation/target/getter.scala b/src/library/scala/annotation/target/getter.scala
index ed9ed89f07..45e2a8ac4b 100644
--- a/src/library/scala/annotation/target/getter.scala
+++ b/src/library/scala/annotation/target/getter.scala
@@ -18,7 +18,8 @@ package scala.annotation.target
  * behavior can be changed.
  *
  * In the following example, the annotation {{{@Id}}} will be added
- * to the bean getter {{{getX}}}
+ * only to the bean getter {{{getX}}}. In order to annotate the field
+ * as well, the meta-annotation {{{@field}}} would need to be added.
  *
  * {{{
  * import javax.persistence.Id
@@ -30,10 +31,10 @@ package scala.annotation.target
  * The syntax can be improved using a type alias:
  *
  * {{{
- * object myAnnotations {
+ * object ScalaJPA {
  *   type Id = javax.persistence.Id @beanGetter
  * }
- * import myAnnotations.Id
+ * import ScalaJPA.Id
  * class A {
  *   @Id @BeanProperty val x = 0
  * }
diff --git a/src/library/scala/annotation/target/setter.scala b/src/library/scala/annotation/target/setter.scala
index e4eae905b7..6f270a6116 100644
--- a/src/library/scala/annotation/target/setter.scala
+++ b/src/library/scala/annotation/target/setter.scala
@@ -18,7 +18,8 @@ package scala.annotation.target
  * behavior can be changed.
  *
  * In the following example, the annotation {{{@Id}}} will be added
- * to the bean getter {{{getX}}}
+ * only to the bean getter {{{getX}}}. In order to annotate the field
+ * as well, the meta-annotation {{{@field}}} would need to be added.
  *
  * {{{
  * import javax.persistence.Id
@@ -30,10 +31,10 @@ package scala.annotation.target
  * The syntax can be improved using a type alias:
  *
  * {{{
- * object myAnnotations {
+ * object ScalaJPA {
  *   type Id = javax.persistence.Id @beanGetter
  * }
- * import myAnnotations.Id
+ * import ScalaJPA.Id
  * class A {
  *   @Id @BeanProperty val x = 0
  * }