python-postgres
diff --git a/‎postgresql/api.py‎
Lines changed: 4 additions & 2 deletions b/‎postgresql/api.py‎
Lines changed: 4 additions & 2 deletions
diff --git a/‎postgresql/documentation/changes.txt‎
Lines changed: 3 additions & 1 deletion b/‎postgresql/documentation/changes.txt‎
Lines changed: 3 additions & 1 deletion
diff --git a/‎postgresql/documentation/driver.txt‎
Lines changed: 2 additions & 2 deletions b/‎postgresql/documentation/driver.txt‎
Lines changed: 2 additions & 2 deletions
@@ -498,11 +498,13 @@ def chunks(self, *parameters) -> collections.Iterable:
 
 		Supporting cursors will be WITH HOLD when outside of a transaction.
 
-		`chunks` is designed for the situations involving large data sets.
+		`chunks` is designed for moving large data sets efficiently.
 
 		Each iteration returns sequences of rows *normally* of length(seq) ==
 		chunksize. If chunksize is unspecified, a default, positive integer will
-		be filled in.
+		be filled in. The rows contained in the sequences are only required to
+		support the basic `collections.Sequence` interfaces; simple and quick
+		sequence types should be used.
 		"""
 
 	@abstractmethod
 
@@ -4,10 +4,10 @@ Changes
 1.0 in development
 ------------------
 
- * Added db.do() method for DO-statement support(convenience method).
  * **DEPRECATION**: Removed 2PC support documentation.
  * **DEPRECATION**: Removed pg_python and pg_dotconf 'scripts'.
    They are still accessible by python3 -m postgresql.bin.pg_*
+ * Added db.do() method for DO-statement support(convenience method).
  * Fix handling of unix domain sockets by pg.open and driver.connect.
    [Reported by twitter.com/rintavarustus]
  * Set the default client_min_messages level to WARNING.
@@ -19,3 +19,5 @@ Changes
  * Increased default recvsize and chunksize for improved performance.
  * 'D' messages are special cased as builtins.tuples instead of
    protocol.element3.Tuple
+ * Alter Statement.chunks() to return chunks of builtins.tuple. Being
+   an interface intended for speed, types.Row() impedes its performance.
@@ -511,7 +511,7 @@ Prepared statement objects have a few execution methods:
   This access point is designed for situations where rows are being streamed out
   quickly. It is a method that returns a ``collections.Iterator`` that produces
   *sequences* of rows. This is the most efficient way to get rows from the
-  database.
+  database. The rows in the sequences are ``builtins.tuple`` objects.
 
  ``ps.declare(*parameters)``
   Create a scrollable cursor with hold. This returns a `postgresql.api.Cursor`
@@ -762,7 +762,7 @@ made the caller. This is done to avoid any unnecessary overhead by default::
 
 Of course, invoking a statement that way will read the entire result-set into
 memory, which is not usually desirable for COPY. Using the ``chunks(...)``
-iterator is the fastest way to move data::
+iterator is the *fastest* way to move data::
 
 	>>> ci = ps.chunks()
 	>>> import sys