Document version deprecated for toJavaArray methods. Fix functionaljava#264

jbgi · jbgi · commit 7a9f3d98c6f7 · 2016-06-14T08:17:12.000+02:00
Also suppress unchecked warnings (functionaljava#269) for them.
diff --git a/core/src/main/java/fj/data/Array.java b/core/src/main/java/fj/data/Array.java
@@ -135,8 +135,9 @@ public Object[] array() {
    * affectation of the result of this method to a non generic array
    * will result in runtime error (ClassCastException).
    *
-   * @deprecated use {@link #array(Class)}
+   * @deprecated As of release 4.6, use {@link #array(Class)}.
    */
+  @SuppressWarnings("unchecked")
   @Deprecated
   public A[] toJavaArray() {
     return (A[]) array();
diff --git a/core/src/main/java/fj/data/List.java b/core/src/main/java/fj/data/List.java
@@ -216,8 +216,9 @@ public final Object[] toArrayObject() {
    * affectation of the result of this method to a non generic array
    * will result in runtime error (ClassCastException).
    *
-   * @deprecated use {@link #array(Class)}
+   * @deprecated As of release 4.6, use {@link #array(Class)}.
    */
+  @SuppressWarnings("unchecked")
   @Deprecated
   public final A[] toJavaArray() {
     return (A[]) toArrayObject();
diff --git a/core/src/main/java/fj/data/Stream.java b/core/src/main/java/fj/data/Stream.java
@@ -922,10 +922,11 @@ public final Option<A> toOption() {
    * affectation of the result of this method to a non generic array
    * will result in runtime error (ClassCastException).
    *
-   * @deprecated use {@link #array(Class)}
+   * @deprecated As of release 4.6, use {@link #array(Class)}.
    */
   @Deprecated
   public final A[] toJavaArray() {
+    @SuppressWarnings("unchecked")
     final A[] array = (A[]) new Object[length()];
     int i = 0;
     for (A a: this) {
