@@ -883,6 +883,14 @@ bindWith par m1 f = go m1
883883-- XXX do we need specialize to IO?
884884-- XXX can we optimize when c and a are same, by removing the forall using
885885-- rewrite rules with type applications?
886+
887+-- | Perform a 'concatMap' using a specified concat strategy. The first
888+-- argument specifies a merge or concat function that is used to merge the
889+-- streams generated by the map function. For example, the concat function
890+-- could be 'serial', 'parallel', 'async', 'ahead' or any other zip or merge
891+-- function.
892+--
893+-- @since 0.7.0
886894{-# INLINE concatMapBy #-}
887895concatMapBy
888896 :: IsStream t