@@ -154,7 +154,8 @@ type Streaming = IsStream
154nil :: IsStream t => t m a
154nil :: IsStream t => t m a
155nil = fromStream S.nil
155nil = fromStream S.nil
157−-- | Create a single element (singleton) stream from a monadic action.
157+-- | Create a singleton stream from a monadic action. Same as @m \`consM` nil@
158+-- but more efficient.
160-- > toList $ once getLine
161-- > toList $ once getLine
@@ -193,8 +194,8 @@ infixr 5 |:
194infixr 5 `cons`
195infixr 5 `cons`
196−-- | Same as @consM . return@. Constructs a stream by adding a pure value at
197+-- | Construct a stream by adding a pure value at the head of an existing
197−-- the head of an existing stream. For example:
198+-- stream. Same as @consM . return@. For example:
200-- > toList $ 1 \`cons` 2 \`cons` 3 \`cons` nil
201-- > toList $ 1 \`cons` 2 \`cons` 3 \`cons` nil