Push the explanation about forwarding into the package comment

Author: nicolaiparlog

src/main/java/org/codefx/libfx/collection/transform/TransformingCollection.java

@@ -18,10 +18,6 @@
  * the transformation {@code null -> null}. The transforming functions specified during construction neither have to
  * handle that case nor are they allowed to produce null elements.
  * <p>
- * All method calls (of abstract and default methods existing in JDK 8) are forwarded to <b>the same method</b> on the
- * wrapped collection. This implies that all guarantees made by such methods (e.g. regarding atomicity) are upheld by
- * the transformation.
- * <p>
  * If the {@link #stream() stream} returned by this collection is told to {@link java.util.stream.Stream#sorted() sort}
  * itself, it will do so on the base of the comparator returned by the inner collection's spliterator (e.g. based on the
  * natural order of {@code I} if it has one).

src/main/java/org/codefx/libfx/collection/transform/TransformingList.java

@@ -18,10 +18,6 @@
  * transformation {@code null -> null}. The transforming functions specified during construction neither have to handle
  * that case nor are they allowed to produce null elements.
  * <p>
- * All method calls (of abstract and default methods existing in JDK 8) are forwarded to <b>the same method</b> on the
- * wrapped list. This implies that all guarantees made by such methods (e.g. regarding atomicity) are upheld by the
- * transformation.
- * <p>
  * If the {@link #stream() stream} returned by this list is told to {@link java.util.stream.Stream#sorted() sort}
  * itself, it will do so on the base of the comparator returned by the inner list's spliterator (e.g. based on the
  * natural order of {@code O} if it has one).

src/main/java/org/codefx/libfx/collection/transform/TransformingMap.java

@@ -18,10 +18,6 @@
  * the transformation {@code null -> null}. The transforming functions specified during construction neither have to
  * handle that case nor are they allowed to produce null elements.
  * <p>
- * All method calls (of abstract and default methods existing in JDK 8) are forwarded to <b>the same method</b> on the
- * wrapped map. This implies that all guarantees made by such methods (e.g. regarding atomicity) are upheld by the
- * transformation.
- * <p>
  * If the {@link java.util.stream.Stream streams} returned by this map's views are told to
  * {@link java.util.stream.Stream#sorted() sort} themself, they will do so on the base of the comparator returned by the
  * inner map view's spliterator (e.g. based on the natural order of {@code IK} or {@code IV} if it has one).

src/main/java/org/codefx/libfx/collection/transform/TransformingSet.java

@@ -18,10 +18,6 @@
  * transformation {@code null -> null}. The transforming functions specified during construction neither have to handle
  * that case nor are they allowed to produce null elements.
  * <p>
- * All method calls (of abstract and default methods existing in JDK 8) are forwarded to <b>the same method</b> on the
- * wrapped set. This implies that all guarantees made by such methods (e.g. regarding atomicity) are upheld by the
- * transformation.
- * <p>
  * If the {@link #stream() stream} returned by this set is told to {@link java.util.stream.Stream#sorted() sort} itself,
  * it will do so on the base of the comparator returned by the inner sets's spliterator (e.g. based on the natural order
  * of {@code I} if it has one).

src/main/java/org/codefx/libfx/collection/transform/package-info.java

@@ -12,7 +12,17 @@
  * the <i>inner type</i>. The transforming collection and its generic type are referred to as <i>outer collection</i>
  * and <i>outer type</i>, respectively.
  * </p>
- * <h2>Details</h2> <h3>Transformation</h3>
+ * <h2>Details</h2>
+ * <p>
+ * The following details are important to use transforming collections without unexpected problems.
+ * </p>
+ * <h3>Forwarding</h3>
+ * <p>
+ * Unless otherwise noted the views forward all method calls (of abstract and default methods existing in JDK 8) to
+ * <b>the same method</b> on the inner collection. This implies that all guarantees made by such methods (e.g. regarding
+ * atomicity) are upheld by the transformation.
+ * </p>
+ * <h3>Transformation</h3>
  * <p>
  * The transformation is computed with a pair of functions. One is used to transform outer elements to inner elements
  * and another one for the other direction. In the case of a {@link java.util.Map Map} two such pairs exist: one for