@@ -350,6 +350,10 @@ executeMany conn q qs = do
350350
351351-- | Execute @INSERT ... RETURNING@, @UPDATE ... RETURNING@, or other SQL
352352-- query that accepts multi-row input and is expected to return results.
353+-- Note that it is possible to write
354+-- @'query' conn "INSERT ... RETURNING ..." ...@
355+-- in cases where you are only inserting a single row, and do not need
356+-- functionality analogous to 'executeMany'.
353357--
354358-- Throws 'FormatError' if the query could not be formatted correctly.
355359returning :: (ToRow q, FromRow r) => Connection -> Query -> [q] -> IO [r]