@@ -694,6 +694,24 @@ eqBy cmp = K.toParserK . D.eqBy cmp
694-- operations and can be faster than 'Applicative' instance for small number
694-- operations and can be faster than 'Applicative' instance for small number
695-- (less than 8) of compositions.
695-- (less than 8) of compositions.
697+-- Many combinators can be expressed using @splitWith@ and other parser
698+-- primitives. Some common idioms are described below,
701+-- span :: (a -> Bool) -> Fold m a b -> Fold m a b -> Parser m a b
702+-- span pred f1 f2 = splitWith (,) ('takeWhile' pred f1) ('fromFold' f2)
706+-- spanBy :: (a -> a -> Bool) -> Fold m a b -> Fold m a b -> Parser m a b
707+-- spanBy eq f1 f2 = splitWith (,) ('groupBy' eq f1) ('fromFold' f2)
711+-- spanByRolling :: (a -> a -> Bool) -> Fold m a b -> Fold m a b -> Parser m a b
712+-- spanByRolling eq f1 f2 = splitWith (,) ('groupByRolling' eq f1) ('fromFold' f2)
697-- /Internal/
715-- /Internal/
699{-# INLINE splitWith #-}
717{-# INLINE splitWith #-}