diff --git a/CHANGELOG.md b/CHANGELOG.md
index 405c9ee..192fbae 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,9 @@
 
+# 1.8
+
+- add `Iter.map_while`
+- fix bug in `map_by_2`, add tests
+
 # 1.7
 
 - add let operators in Infix
diff --git a/iter.opam b/iter.opam
index 410f54a..0ad3109 100644
--- a/iter.opam
+++ b/iter.opam
@@ -1,6 +1,6 @@
 opam-version: "2.0"
 name: "iter"
-version: "1.7"
+version: "1.8"
 authors: ["Simon Cruanes" "Gabriel Radanne"]
 maintainer: "simon.cruanes.2007@m4x.org"
 license: "BSD-2-clause"
diff --git a/src/Iter.mli b/src/Iter.mli
index 7e64297..0fddf3d 100644
--- a/src/Iter.mli
+++ b/src/Iter.mli
@@ -496,7 +496,8 @@ val map_while : ('a -> [ `Yield of 'b | `Return of 'b | `Stop ]) -> 'a t -> 'b t
       {- If [f] returns [`Stop], nothing is added to the sequence and the
          iteration stops.}
       {- If [f] returns [`Return y], [y] is added to the sequence and the
-         iteration stops.}} *)
+         iteration stops.}}
+    @since 1.8 *)
 
 val fold_while : ('a -> 'b -> 'a * [ `Stop | `Continue ]) -> 'a -> 'b t -> 'a
 (** Folds over elements of the iterator, stopping early if the accumulator