docs

Author: novacrazy

CHANGELOG.md

@@ -1,7 +1,10 @@
-* **`1.3.5`**
-    * Add `subtle`, `arbitrary`, and `bytemuck` implementations for `GenericArray` when the inner type supports them.
-    * Add `FallibleGenericSequence` with `try_generate` for fallible generation of sequences/arrays.
-    * Add `try_fold` to `FunctionalSequence` for fallible folding of sequences/arrays.
+* **`1.3.5` (unreleased)**
+    * Add `subtle`, `arbitrary`, `bytemuck`, and `as-slice` implementations for `GenericArray`.
+    * Add `GenericSequence::repeat` for creating sequences/arrays with repeated elements.
+    * Add `FallibleGenericSequence` with `try_generate` and `from_fallible_iter` for fallible generation of sequences/arrays.
+    * Add `try_fold` and `try_map` to `FunctionalSequence` for fallible folding/mapping of sequences/arrays.
+    * Add `try_from_fallible_iter` to `GenericArray` for fallible construction from fallible iterators.
+    * Add `each_ref`/`each_mut` methods to `GenericArray` for creating arrays of references to the elements.
 
 * **`1.3.4`**
     * Significantly improve stack usage of `GenericArray` methods in unoptimized (`-C opt-level=0`) build modes.

src/functional.rs

@@ -33,6 +33,11 @@ where
 pub type Mapped<S, T, U> = <S as MappedGenericSequence<T, U>>::Mapped;
 
 /// Accessor type for a mapped generic sequence
+///
+/// NOTE: The choice to use the `Sequence` associated type here instead of `Mapped`
+/// is due to only the `Sequence` type being guaranteed to implement `FromIterator`.
+/// However, this does lead to some oddity where `FallibleGenericSequence::from_fallible_iter`
+/// is implemented on `Mapped`, but returns the `Sequence`/`MappedSequence` type. Same difference, though.
 pub type MappedSequence<S, T, U> = <Mapped<S, T, U> as GenericSequence<U>>::Sequence;
 
 /// Defines functional programming methods for generic sequences