Unmodifiable, UnmodifiableView: wording

Author: amaembo

java8/src/main/java/org/jetbrains/annotations/Unmodifiable.java

@@ -20,8 +20,10 @@
 /**
  * An annotation which marks a {@link java.util.Collection} or {@link java.util.Map} type
  * as unmodifiable. A collection or a map is unmodifiable if any mutator methods
- * throw exception or have no effect, and the objects stored as collection elements,
- * map keys, and map values are never changed.
+ * (e.g. {@link java.util.Collection#add(Object)}) throw exception or have no effect,
+ * and the object references stored as collection elements, map keys, and map values 
+ * are never changed. The referenced objects themselves still could be changed if they
+ * are mutable. 
  * 
  * @see UnmodifiableView
  * @since 19.0.0

java8/src/main/java/org/jetbrains/annotations/UnmodifiableView.java

@@ -19,7 +19,7 @@
 
 /**
  * An annotation which marks a {@link java.util.Collection} or {@link java.util.Map} type
- * as unmodifiable. A collection or a map is unmodifiable if any mutator methods
+ * as unmodifiable view. A collection or a map is unmodifiable view if any mutator methods
  * (e.g. {@link java.util.Collection#add(Object)}) throw exception or have no effect. 
  * However, the content of the collection or the map may still be updated by other code. 
  *