javadoc fixes

Author: tpietzsch

src/main/java/net/imglib2/IterableRealInterval.java

@@ -118,9 +118,17 @@ default T firstElement() // TODO: fix places where it is not necessary to implem
 		return iterator().next();
 	}
 
-	/*
-	 * NB: We cannot have a default implementation here because of
-	 * https://bugs.openjdk.org/browse/JDK-7120669
+	/**
+	 * Get an instance of {@code T}.
+	 * <p>
+	 * It should not be assumed that the returned {@code T} instance is an
+	 * independent copy. In particular, repeated calls to {@code getType()} may
+	 * return the same instance.
+	 * <p>
+	 * The default implementation returns {@link #firstElement}. Derived classes
+	 * may choose different implementations for improved performance.
+	 *
+	 * @return an instance of {@code T}
 	 */
 	@Override
 	default T getType()

src/main/java/net/imglib2/RandomAccessible.java

@@ -182,17 +182,8 @@ default T getAt( final Localizable position )
 	}
 
 	/*
-	 * Get an instance of {@code T}.
-	 * <p>
-	 * It should not be assumed that the returned {@code T} instance is an
-	 * independent copy. In particular, repeated calls to {@code getType()} may
-	 * return the same instance.
-	 * <p>
-	 * The default implementation queries the value at the default coordinate of
-	 * {@link RandomAccessible#randomAccess()}. Derived classes may choose
-	 * different implementations for improved performance.
-	 *
-	 * @return an instance of {@code T}
+	 * NB: We cannot have a default implementation here because of
+	 * https://bugs.openjdk.org/browse/JDK-7120669
 	 */
 //	@Override
 //	default T getType()

src/main/java/net/imglib2/RandomAccessibleInterval.java

@@ -65,17 +65,8 @@
 public interface RandomAccessibleInterval< T > extends RandomAccessible< T >, Interval
 {
 	/*
-	 * Get an instance of {@code T}.
-	 * <p>
-	 * It should not be assumed that the returned {@code T} instance is an
-	 * independent copy. In particular, repeated calls to {@code getType()} may
-	 * return the same instance.
-	 * <p>
-	 * The default implementation queries the value at the min coordinate of
-	 * this interval. Derived classes may choose different implementations for
-	 * improved performance.
-	 *
-	 * @return an instance of {@code T}
+	 * NB: We cannot have a default implementation here because of
+	 * https://bugs.openjdk.org/browse/JDK-7120669
 	 */
 //	@Override
 //	default T getType()

src/main/java/net/imglib2/RealRandomAccessible.java

@@ -120,18 +120,9 @@ default T getAt( final RealLocalizable position )
 		return realRandomAccess().setPositionAndGet( position );
 	}
 
-	/**
-	 * Get an instance of {@code T}.
-	 * <p>
-	 * It should not be assumed that the returned {@code T} instance is an
-	 * independent copy. In particular, repeated calls to {@code getType()} may
-	 * return the same instance.
-	 * <p>
-	 * The default implementation queries the value at the default coordinate of
-	 * {@link RealRandomAccessible#realRandomAccess()}. Derived classes
-	 * may choose different implementations for improved performance.
-	 *
-	 * @return an instance of {@code T}
+	/*
+	 * NB: We cannot have a default implementation here because of
+	 * https://bugs.openjdk.org/browse/JDK-7120669
 	 */
 //	@Override
 //	default T getType()

src/main/java/net/imglib2/RealRandomAccessibleRealInterval.java

@@ -63,18 +63,9 @@
  */
 public interface RealRandomAccessibleRealInterval< T > extends RealRandomAccessible< T >, RealInterval
 {
-	/**
-	 * Get an instance of {@code T}.
-	 * <p>
-	 * It should not be assumed that the returned {@code T} instance is an
-	 * independent copy. In particular, repeated calls to {@code getType()} may
-	 * return the same instance.
-	 * <p>
-	 * The default implementation queries the value at the min coordinate of
-	 * this interval. Derived classes may choose different implementations for
-	 * improved performance.
-	 *
-	 * @return an instance of {@code T}
+	/*
+	 * NB: We cannot have a default implementation here because of
+	 * https://bugs.openjdk.org/browse/JDK-7120669
 	 */
 //	@Override
 //	default T getType()