@@ -154,7 +154,8 @@ type Streaming = IsStream
154154nil :: IsStream t => t m a
155155nil = fromStream S.nil
156156
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.
158159--
159160-- @
160161-- > toList $ once getLine
@@ -193,8 +194,8 @@ infixr 5 |:
193194
194195infixr 5 `cons`
195196
196−-- | Same as @consM . return@. Constructs a stream by adding a pure value at
197−-- the head of an existing stream. For example:
197+-- | Construct a stream by adding a pure value at the head of an existing
198+-- stream. Same as @consM . return@. For example:
198199--
199200-- @
200201-- > toList $ 1 \`cons` 2 \`cons` 3 \`cons` nil